Discover available services

POST /tms-partner/api/v1/pricing/get-service

Usage and important notes

Call this before get-all and create-order. Supply a complete product and route. Missing fromLocation, toLocation, or product can produce HTTP 500 instead of a clean HTTP 400.

Send weight in grams and dimensions in centimeters. isDomestic defaults to true. customerCode defaults to the token’s customer account. partnerInfo is an alternate discount identity and is normally unnecessary because X-Client-Source already identifies the partner. orderService changes the isShow, isChosen, and isChangeable flags of GTN/NTN/VTT; it does not change the price.

Map mainPrice.code to order service, and selected extraPrices[].code to vas[]. Respect automatically included mainPrice.extraService[] and specialService[]. isShow=false marks an internal service, not a selectable requirement. isCalculated=false means displayed rather than priced. If mainPrice.isCalculatedAutomatically=false, use manualPrice when calling get-all. Use beforeVatPrice, not VAT-inclusive price, for order fee amounts.

Authentication headers

Request fields

Recommended operational inputs; no fields have @NotNull validation. Missing locations/product may cause 500 rather than 400.

Example JSON body

Save as request.json. Replace every ${…} string and example ID with actual environment values before sending. cURL with --data @request.json does not interpolate variables inside JSON files. Identities are synthetic.

{
  "product": {
    "weight": 100,
    "type": "GOODS",
    "price": 50,
    "moneyCollection": 50,
    "length": 10,
    "width": 10,
    "height": 10
  },
  "fromLocation": [
    {
      "name": "Example warehouse, Street A",
      "type": "OTHER",
      "level": 999
    },
    {
      "id": "5025963",
      "code": "120211",
      "name": "Voat Phnum",
      "type": "VILLAGE",
      "level": 3
    },
    {
      "id": "4059553",
      "code": "1202",
      "name": "Doun Penh",
      "type": "DISTRICT",
      "level": 2
    },
    {
      "id": "4025120",
      "code": "PNP",
      "name": "Phnom Penh",
      "type": "PROVINCE",
      "level": 1
    },
    {
      "type": "NATIONAL",
      "name": "Cambodia",
      "code": "KH",
      "level": 0
    }
  ],
  "toLocation": [
    {
      "name": "Example recipient, Street B",
      "type": "OTHER",
      "level": 999
    },
    {
      "id": "5025109",
      "code": "010201",
      "name": "បន្ទាយនាង",
      "type": "VILLAGE",
      "level": 3
    },
    {
      "id": "4059452",
      "code": "0102",
      "name": "មង្គលបូរី",
      "type": "DISTRICT",
      "level": 2
    },
    {
      "id": "4025109",
      "code": "BAN",
      "name": "Banteay Meanchey",
      "type": "PROVINCE",
      "level": 1
    },
    {
      "type": "NATIONAL",
      "name": "Cambodia",
      "code": "KH",
      "level": 0
    }
  ],
  "isDomestic": true,
  "orderService": {
    "senderService": "GTN",
    "receiverService": "NTN"
  }
}

cURL example

BASE_URL must include /tms-partner/api/v1. Load the token and partner code from your private environment; never paste secrets into documentation or AI prompts.

curl --request POST "${BASE_URL}/pricing/get-service" \
  --header "X-Api-Token: ${API_TOKEN}" \
  --header "X-Client-Source: ${PARTNER_CODE}" \
  --header "Accept-Language: en" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data @request.json

Example response

[
  {
    "totalPrice": 20000,
    "totalPriceAfterDiscount": 18000,
    "discount": 2000,
    "totalDiscountAmount": 2000,
    "discountType": "AMOUNT",
    "property": {
      "calculatedWeight": 100,
      "convertedWeight": 200,
      "perimeter": 30,
      "distance": null
    },
    "mainPrice": {
      "code": "CCN",
      "name": "Express",
      "price": 8000,
      "priceAfterDiscount": 6000,
      "discount": 2000,
      "beforeVatPrice": 7273,
      "vatPrice": 727,
      "field": "KL",
      "calculatedWeight": 100,
      "extraService": [
        "GTN"
      ],
      "specialService": [],
      "isCalculatedAutomatically": true
    },
    "extraPrices": [
      {
        "code": "GTN",
        "name": "Delivery to address",
        "price": 8000,
        "beforeVatPrice": 7273,
        "vatPrice": 727,
        "priceAfterDiscount": 8000,
        "discount": 0,
        "field": "CC",
        "isShow": true,
        "isChosen": false,
        "isChangeable": true,
        "isCalculated": true
      },
      {
        "code": "NTN",
        "name": "Pickup at address",
        "price": 2000,
        "beforeVatPrice": 1818,
        "vatPrice": 182,
        "priceAfterDiscount": 2000,
        "discount": 0,
        "field": "CC",
        "isShow": true,
        "isChosen": false,
        "isChangeable": true,
        "isCalculated": true
      }
    ],
    "specialPrices": [],
    "leadTime": 0
  }
]

Response fields

Error handling

See HTTP codes and source limitations. HTTP success does not prove COD, fees, or cancellation are correct; inspect the documented business fields. Do not assume create-order retries are safe.