Calculate Price

Calculate Price

API Configuration

HTTP Request

POST /v1/bill/calc-fee

No.ParameterTypeRequireDescription
1partner_idintID of partner. That registration on https://khachhang.ntlogistics.vn/ (opens in a new tab)
2weightDoubleAlt textEstimated Weight of packages measured by client
3widthDoubleWidth of Package in Total (Measured in cm,Default 0)
4lengthDoubleLength of Package in Total (Measured in cm,Default 0)
5heightDoubleHeight of Package in Total (Measured in cm,Default 0)
6service_idNumberIf yes, return the correct service, if not, return all services
7payment_method_idNumberAlt textPayment Method Id
8cod_amountDoubleAmount of COD to collect when package delivered to receiver
9cargo_valueDoubleBreif value of Package Product Items
10s_provinceStringProvince of sender
11s_districtStringDistrict of sender
12r_provinceStringProvince of receiver
13r_districtStringDistrict of receiver
10s_province_idStringAlt textProvince ID of sender (New)
11s_ward_idStringAlt textWard ID of sender (New)
12r_province_idStringAlt textProvince ID of receiver (New)
13r_ward_idStringAlt textWard ID of receiver (New)

JSON body respone

NameTypeDescription
successbooleanReturn true if calculate success, all other false means error. See message for further description.
messagestringReturn Message of API Respond.
dataobjectData of API response.

Request

//New (after 01-07-2025)
{
   "partner_id": 123736,
   "weight": 1.3,
   "payment_method_id": 10,
   "cod_amount": 120000,
   "cargo_value": 2000000,
   "s_province_id": "79",
   "s_ward_id": "27007",
   "r_province_id": "01",
   "r_ward_id": "000004",
}
//OLD
{
   "partner_id": 123736,
   "weight": 1.3,
   "payment_method_id": 10,
   "cod_amount": 120000,
   "cargo_value": 2000000,
   "s_province": "Hồ Chí Minh",
   "s_district": "Tân Bình",
   "r_province": "Hà Nội",
   "r_district": "Thanh Xuân",
}
 
 
**Response**
 
```js copy
{
   "success": true,
   "messsage": "",
   "data": [
      {
         "weight": 3,
         "total_fee": 109910,
         "main_fee": 109910,
         "insur_fee": 0,
         "remote_fee": 0,
         "cod_fee": 0,
         "service_id": 21,
         "service_name": "MES",
         "lead_time": "31/08/2021 23:10"
      },
      {
         "weight": 3,
         "total_fee": 66152,
         "main_fee": 66152,
         "insur_fee": 0,
         "remote_fee": 0,
         "cod_fee": 0,
         "service_id": 20,
         "service_name": "Đường bộ",
         "lead_time": "02/09/2021 11:10"
      },
      {
         "weight": 3,
         "total_fee": 301158,
         "main_fee": 301158,
         "insur_fee": 0,
         "remote_fee": 0,
         "cod_fee": 0,
         "service_id": 11,
         "service_name": "Hỏa tốc",
         "lead_time": "29/08/2021 09:10"
      },
      {
         "weight": 3,
         "total_fee": 146589,
         "main_fee": 146589,
         "insur_fee": 0,
         "remote_fee": 0,
         "cod_fee": 0,
         "service_id": 10,
         "service_name": "CPN",
         "lead_time": "29/08/2021 11:10"
      }
   ]
}