API Docs
Home
Home
Developer GuideAPI
StatusWebhooks
Developer GuideAPI
StatusWebhooks
  1. Shipment
  • 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
        • List available courier
      • List available courier from order
      • List shipping service of courier
    • 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. Shipment

[Retail][Ship by self] Create shipment with item

Developing
POST
/api/v1/public/shipments/create
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/public/shipments/create' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_tracking_code": "NHOV1901344269",
    "pickup_address": 167,
    "config": {
        "preview": 1,
        "use_insurance": 0,
        "fulfill_now": 0,
        "protective_packaging": 0,
        "additional_services": "",
        "box_dimension": 120,
        "courier_integration": 172,
        "courier_service": 15
    },
    "shipping_info": {
        "shipping_fee": 0,
        "courier_tracking_code": "104577519879",
        "courier_ship": 12,
        "label_url": "https://stg-oms.nandh.vn/api/v1/shipments/awb-label/677e04eeb4c14d85fb32645c"
    }
}'
Response Response Example
{
  "status_code": 200,
  "data": {
    "shipment_id": 5875,
    "tracking_code": "NHSV1901810304"
  },
  "error": false,
  "error_code": null,
  "log_id": null,
  "messages": "",
  "total": 1
}

Request

Header Params
Authorization
string 
required
Default:
{{your_api_key_here}}
Body Params application/json
order_tracking_code
string 
required
Order code (Example: nhov1903942018)
pickup_address
integer 
required
config
object 
optional
preview
integer 
optional
use_insurance
integer 
optional
fulfill_now
integer 
optional
Operating order (packaging 45p)
protective_packaging
integer 
optional
additional_services
string 
optional
EXG: Exchange goods
PRS: Pricing service
IGD: Co-inspection of goods upon delivery
box_dimension
integer 
required
courier_integration
integer 
required
courier_service
integer 
required
service_id
shipping_info
object 
optional
This parameter when the order is shipped and used the bill of lading and the separate AWB file
shipping_fee
integer 
optional
If free shipping, the default value 0
courier_tracking_code
string 
optional
AWB Code
courier_ship
integer 
optional
Shipping codes, data taken from https://developers.nandh.vn/api-11878854
label_url
string 
optional
File AWB or Label Transportation
Examples

Responses

🟢200OK
application/json
Body
status_code
integer 
required
data
object 
required
shipment_id
integer 
required
tracking_code
string 
required
error
boolean 
required
error_code
null 
optional
log_id
null 
optional
messages
string 
required
total
integer 
required
Previous
Create shipment auto
Next
Cancel shipment
Built with