Pricing breakdown
How totalPrice is calculated from the courier price, discount, insurance and PPN.
- Product
- APIShipping Engine API
- Section
- Shipping rates
- Reading time
- 2 min read
In short
totalPriceis what is deducted from your balance: shipping after discount, plus insurance, plus tax.- Every component is listed in
priceDetail, so you can show your customer an itemised price. - All amounts are whole Rupiah.
The formula
fastracPrice = basePrice − discountAmount
totalPrice = fastracPrice + insurance + ppnInsurance + ppnShipment| Field | What it is |
|---|---|
basePrice | The courier's list price for this parcel and route. |
discountBreakdown | Your Fastrac discount, as discountPercentage and discountAmount. |
fastracPrice | Shipping price after discount. |
insuranceBreakdown.insurance | Insurance premium plus admin fee. 0 when insurance is false. |
taxBreakdown.ppnInsurance | PPN on insurance: 11% of insurance. |
taxBreakdown.ppnShipment | PPN on shipping: 1.1% of fastracPrice. |
totalPrice | The sum above. This is the price to show and the amount you pay. |
totalPriceCalculation | The formula that was applied, as text. Handy when debugging. |
Why 1.1% on shipping?
Delivery services in Indonesia carry PPN at a reduced effective rate of 1.1% of the shipping fee. Insurance and COD fees carry the standard 11%.
Try it
Change the numbers to see exactly how Shipping Engine builds the price. The calculator uses the same formulas as the API.
Inputs
What the rate returns
totalPrice: deducted from your balance
Insurance and COD rules vary by courier service. The defaults here are examples.
Worked example
A 1.2 kg parcel worth Rp 500.000, JNE Reguler, with insurance:
| Step | Amount |
|---|---|
basePrice | Rp 10.000 |
| − discount (10%) | − Rp 1.000 |
fastracPrice | Rp 9.000 |
insurance: 0.25% × 500.000 = 1.250, raised to the 1.500 minimum, + 2.000 admin fee | Rp 3.500 |
ppnInsurance: 11% × 3.500 | Rp 385 |
ppnShipment: 1.1% × 9.000 | Rp 99 |
totalPrice | Rp 12.984 |
Insurance
premium = max(insurancePercent% × itemValue, insuranceMinimum)
insurance = premium + insuranceAdminFeeThe rate, minimum and admin fee depend on the courier service, and are returned in
insuranceBreakdown. See Insurance and COD.
When the price can change
The quoted totalPrice is what you pay when you create the order. It can change after pickup in
one case: the courier weighs or measures the parcel and finds it heavier or larger than quoted. Shipping Engine
then deducts the difference from your balance and notifies you. To avoid this, send accurate weights
and dimensions. See Packages.
Was this page helpful?