API Docs
Home
Home
Developer GuideAPI
StatusWebhooks
Developer GuideAPI
StatusWebhooks
  1. Preview shipping prices
  • Config
    • List Pickup Address
      GET
    • List Box Dimension
      GET
    • List vendor
      GET
    • List store
      GET
  • Online Product
    • Options
      • List category
      • List brand
    • Create Single Product
      POST
    • Create Product From Product Inventory
      POST
    • List product
      GET
    • Product detail
      GET
  • Product Inventory
    • Options
      • List Outbound Strategy
      • List Product Type
      • List Material
      • List Storage Method
    • List product inventory
      GET
    • Product inventory detail
      GET
    • Create single inventory product
      POST
  • Order
    • Shipping Service
      • Preview shipping prices
        • List shipping service
          POST
        • List available courier
          POST
      • List available courier from order
        POST
      • List shipping service of courier
        POST
    • Create order B2C
      POST
    • Create order B2B
      POST
    • List order
      GET
    • Order detail
      GET
    • Cancel order
      PATCH
  • Shipment
    • Create shipment auto
      POST
    • [Retail][Ship by self] Create shipment with item
      POST
    • Cancel shipment
      PATCH
    • List shipment
      GET
    • Shipment detail
      GET
    • List shipment of order
      GET
  • Shipment Inbound
    • Create shipment inbound
    • Cancel shipment inbound
    • List shipment inbound
    • Shipment inbound detail
    • Shipment inbound items
  • Order Return
    • List return order
    • Return order detail
    • Create return order
    • Cancel Return Order
  • Courier
    • List courier service integrated
    • List courier operate
    • List courier integrated
  • Address Directory
    • Province
    • District
    • Ward
  1. Preview shipping prices

List shipping service

POST
/api/v1/public/orders/available-shipping-services
This API returns a list of available shipping services for a given order. It calculates estimated delivery times and total fees based on the shipping address, selected courier, parcel weight, and other details.
Example Returned Services
Chuyển phát đường bộ (Ground shipping)
Fee: 5,400 VND
Time: 3–5 days
Nội tỉnh nhanh (Intra-city express)
Fee: 22,000 VND
Time: 3–5 days
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/public/orders/available-shipping-services' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "store_id": {{store_id}},
  "pickup_address_id": {{pickup_id}},
  "box_id": {{box_id}},
  "courier_id": 9,
  "courier_integration_id": 218,
  "weight": 150,
  "cod_amount": 100000,
  "receiver": {
    "address": "Số 9 trà khúc",
    "country": "VN",
    "district": 766,
    "fullname": "Hoài Thương",
    "phone": "0961557476",
    "province": 79,
    "ward": 26965,
    "zipcode": null
  },
  "items": [
    {
        "sku": "BANHTRANGXIKI",
        "sale_price": 79000,
        "discounted_price": 79000,
        "quantity": 2
    }
  ],
  "config": {
    "preview": 1, 
    "use_insurance": 0
    
  }
}'
Response Response Example
{"status_code":200,"data":[{"service_code":"NH_VNP_EC_FAST","service_name":"Nhanh TMDT đồng giá","service_type_name":"","service_id":26,"courier_id":9,"courier_prefix":"nandh","courier_integration_id":218,"courier_ship_id":10,"courier_ship_name":"Bưu điện (VNP)","courier_ship_logo":"https://oms.boxme.asia/assets/images/courier/vnpost-ems.svg","courier_ship_rating":4,"distance":null,"priority":0,"delivery_time_rank":0,"fee_rank":0,"only_fulfill":false,"require_tracking":false,"is_fulfill_now":false,"support_check_content":true,"support_use_insurance":true,"is_bridge":true,"is_seller_own_fleet":false,"min_estimate_time":3.0,"max_estimate_time":5.0,"estimate_time":"3-5 days","fee_currency":"VND","total_fee":15000.0,"shipping_fee":{"shipping_fee":15000.0,"handling_fee":0,"heavy_weight_fee":0,"stop_fee":0,"remote_fee":0,"vat_fee":0.0,"line_haul_fee":0},"vas_fee":{"vas_fee":0.0,"insurance_fee":0,"exchange_goods_fee":0,"pricing_fee":0,"cod_fee":0},"fulfillment_fee":{"handover_fee":0,"material_fee":0,"bubble_wrap_fee":0},"discount":{"courier_discount":0}},{"service_code":"NH_VNP_EC_STT","service_name":"Tiêu chuẩn TMDT đồng giá","service_type_name":"","service_id":28,"courier_id":9,"courier_prefix":"nandh","courier_integration_id":218,"courier_ship_id":10,"courier_ship_name":"Bưu điện (VNP)","courier_ship_logo":"https://oms.boxme.asia/assets/images/courier/vnpost-ems.svg","courier_ship_rating":4,"distance":null,"priority":0,"delivery_time_rank":0,"fee_rank":0,"only_fulfill":false,"require_tracking":false,"is_fulfill_now":false,"support_check_content":true,"support_use_insurance":true,"is_bridge":true,"is_seller_own_fleet":false,"min_estimate_time":3.0,"max_estimate_time":5.0,"estimate_time":"3-5 days","fee_currency":"VND","total_fee":16000.0,"shipping_fee":{"shipping_fee":16000.0,"handling_fee":0,"heavy_weight_fee":0,"stop_fee":0,"remote_fee":0,"vat_fee":0.0,"line_haul_fee":0},"vas_fee":{"vas_fee":0.0,"insurance_fee":0,"exchange_goods_fee":0,"pricing_fee":0,"cod_fee":0},"fulfillment_fee":{"handover_fee":0,"material_fee":0,"bubble_wrap_fee":0},"discount":{"courier_discount":0}},{"service_code":"NH_VTP_EC_PTN","service_name":"Nội tỉnh nhanh","service_type_name":"","service_id":32,"courier_id":9,"courier_prefix":"nandh","courier_integration_id":218,"courier_ship_id":1,"courier_ship_name":"Viettel Post","courier_ship_logo":"https://storage.googleapis.com/omisell-cloud/logo/courier/viettelpost.svg","courier_ship_rating":4,"distance":null,"priority":0,"delivery_time_rank":0,"fee_rank":0,"only_fulfill":false,"require_tracking":false,"is_fulfill_now":false,"support_check_content":true,"support_use_insurance":true,"is_bridge":true,"is_seller_own_fleet":false,"min_estimate_time":3.0,"max_estimate_time":5.0,"estimate_time":"3-5 days","fee_currency":"VND","total_fee":22000.0,"shipping_fee":{"shipping_fee":20370.0,"handling_fee":0,"heavy_weight_fee":0,"stop_fee":0,"remote_fee":0,"vat_fee":1630.0,"line_haul_fee":0},"vas_fee":{"vas_fee":0.0,"insurance_fee":0,"exchange_goods_fee":0,"pricing_fee":0,"cod_fee":0},"fulfillment_fee":{"handover_fee":0,"material_fee":0,"bubble_wrap_fee":0},"discount":{"courier_discount":0}}],"error":false,"error_code":null,"log_id":null,"messages":"","total":3}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Body

Previous
Create single inventory product
Next
List available courier
Built with