Create Parcels

Request Method

http

POST /api/parcel/push-parcel-orders

NOTE

Asynchronous creation of orders.

This API allows you to pre-populate parcel data in our database to ensure a faster Get Shipping Label experience. This is the preferred method of manifestation. Steps for this API are as follows:

Create Batch Parcels
Get Tracking No.
Get Shipping Label

If you have any queries, please write in to tech@wmg-group.com attaching your code and error messages. Thank you.

Field	Description
Content-Type	application/json
Authorization	Bearer <token>

Parameter

Orders

Field	Mandatory	Type	Description	Length
OwnerId	N	Numeric	The Company Id representing the originator of the order record. - Use 111 for OwnerId	Numeric (Mandatory)
ServiceCode	Y	String	To be advised by your account manager.	= 5 characters
MAWBNumber	N	String	Air Waybill Number. Your shipping Document Number.	<= 30 characters
TrackingNumber	Y	String	Tracking Number as show on the shipping label on each item.	<= 50 characters
SendingAgentID	N	String	Customer/Manufacturer reference number if any.	<= 50 characters
SenderName	Y	String	The Sender’s Name of the sender	<= 60 characters
SenderCompany	N	String	The Sender’s Company Name if available. Default to “” if not available.	<= 80 characters
SenderAddress1	Y	String	The Sender’s Address	<= 160 characters
SenderAddress2	N	String	Sender’s Address. Default to “” if not use	<= 100 characters
SenderCity	N	String	Sender’s City. Default to “” if not use	<= 50 characters
SenderState	N	String	Sender’s State. Default to “” if not use	<= 50 characters
SenderCountry	Y	String	Sender’s Country Name.	<= 60 characters
SenderPostalCode	Y	String	Sender’s Postal Code To be fill up for those country that has postal code. Otherwise default to “” for those country that do not use post code.	<= 20 characters
SenderContactNo	N	String	Contact Number of the Sender Default to “” if not use.	<= 20 characters
SenderEmail	N	String	Email of the Sender. Default to “” if not use.	<= 100 characters
RecipientName	Y	String	Name of Consignee	<= 60 characters
RecipientCompany	N	String	Company of Consignee Default to “” if not use.	<= 80 characters
RecipientAddress1	Y	String	Address of Consignee,The total length of three address characters cannot exceed 320	<= 160 characters
RecipientAddress2	N	String	Consignee Address Line 2 Default to “” if not use.	<= 160 characters
RecipientAddress3	N	String	Consignee Address Line 3 Default to “” if not use.	<= 100 characters
RecipientCity	Y	String	City of Consignee Default to “” if not use.	<= 50 characters
RecipientState	Y	String	State of Consignee Default to “” if not use.	<= 50 characters
RecipientCountry	Y	String	Country Name of Consignee	<= 60 characters
RecipientPostalCode	Y	String	Postal Code of Consignee To be fill up for those country that use postal code and default to “” for those countries that do not use post code.	<= 20 characters
RecipientContactNo	Y	String	Contact Number of Consignee	<= 20 characters
RecipientEmail	N	String	Email Address of Consignee	<= 100 characters
Commodity	Y	String	A brief description of the Item.	<= 200 characters
OrderNumber	N	String	A text information that refers to your order within your internal system, not required for delivery. Default to “” if not use.	<= 50 characters
Weight	Y	Numeric	The declared weight of the item. If left blank will default to max weight and user is liable for corresponding charges.	3 digit decimal place 9.999
Length	N	Numeric	The length of the item. If left blank will default to max length and user is liable for corresponding charges.	2 digit decimal place 9.99
Width	N	Numeric	The width of the item. If left blank will default to max width and user is liable for corresponding charges.	2 digit decimal place 9.99
Height	N	Numeric	The height of the item. If left blank will default to max height and user is liable for corresponding charges.	2 digit decimal place 9.99
DeclaredCurrency	Y	String	The declared currency used for the item. eg. SGD	= 3 characters
DeclaredValue	Y	Numeric	The declared value of the item. eg. 217.50	2 digit decimal place
Qty	Y	Numeric	Number of Pieces under the same Tracking Number.	Numeric Number
Remark	N	String	If necessary some instruction for the delivery. Default to "" if blank.	<= 50 characters
ETD	N	String	Estimated Time of Departure at Origin eg. 2018-06-14T10:50:00+8:00	Date/Time GMT Time
ETA	N	String	Estimated Time of Arrival at Destination. eg. 2018-06-04T15:30:15+8:00	Date/Time GMT Time
PickUpDate	N	String	Time to pickup the item at sender location eg. 2018-06-14T10:50:00+8:00 (for local delivery only)	Date/Time GMT Time
DeliveryDate	N	String	Date/Time for delivery of item to consignee eg. 2018-06-04T15:30:15+8:00 (current not use)	Date/Time GMT Time
IsDDP	N	String	DDP="Y", DDU="N", Default "N"	= 1 characters
SupplierName	Y / N	String	The Supplier Name Mandatory for destination country Singapore. Default to “” if not use.	Max 100 Char (Mandatory for Singapore)
GSTRegNo	Y / N	String	The Supplier GST Registration Number Mandatory for destination country Singapore Default to “” if not use.	Max 50 Char (Mandatory for Singapore)
GSTAmount	Y / N	Numeric	The Amount of Goods and Service Tax Paid. Mandatory for the destination country Singapore. Default to “0.00” if not use.	2 digit decimal place (Mandatory for Singapore)
GSTCurrency	Y / N	String	The Goods and Services Tax Currency used. Mandatory for the destination country Singapore. Default to “” if not use.	Max 3 Char (Mandatory for Singapore)
GSTStatus	Y / N	String	The status of the Goods and Service Tax Payment. Mandatory for destination country Singapore. Eg: “Paid”, default to “” if not use.	Max 5 Char (Mandatory for Singapore)
Origin	Y	String	ISO2 Character for Origin Country Eg. SG for Singapore, TH for Thailand	= 2 characters
Destination	Y	String	ISO2 Character for Destination Country Eg. SG for Singapore, TH for Thailand	= 2 characters
Dep_Iata	Y	String	IATA Airport Code for Origin Eg. SIN - Singapore Changi Airport LAX - Los Angeles International Airport	= 3 characters
Arr_Iata	Y	String	IATA Airport Code for Destination Eg. SIN - Singapore Changi Airport LAX - Los Angeles International Airport	= 3 characters
ItemListing	Y	Array of objects	Array of Item Listing SKU

ItemListing

Field	Mandatory	Type	Description	Length
SKU	N	String		<= 60 characters
ItemDescription	Y	String		<= 300 characters
ItemWeight	Y	Numeric	KG
NoOfPcs	Y	Integer Numeric
ItemValue	Y	Numeric
ItemCurrency	Y	String	eg: SGD	= 3 characters
ItemOrigin	Y	String	eg: SG	= 2 characters
ItemDestination	Y	String	eg: TH	= 2 characters
HSCode	Y	String	HS Tariff Code of the Line Item.	<= 50 characters

Request

json

{
  "Orders": [
    {
      "OwnerId": 111,
      "ServiceCode": "A0000",
      "MAWBNumber": "PXLUS0000124B000JHDEV",
      "TrackingNumber": "PXLUS0000124B000JHDEV",
      "SendingAgentID": "PXLUS0000124B000JHDEV",
      "SenderName": "iherb",
      "SenderCompany": "",
      "SenderAddress1": "08E Airlines House",
      "SenderAddress2": "",
      "SenderCity": "City",
      "SenderState": "United States",
      "SenderCountry": "Singapore",
      "SenderPostalCode": "238858",
      "SenderContactNo": "",
      "SenderEmail": "",
      "RecipientName": "Somin Jeon",
      "RecipientCompany": "",
      "RecipientAddress1": "Taiwan Taoyuan International Airport",
      "RecipientAddress2": "Hangzhan S Road",
      "RecipientAddress3": "",
      "RecipientCity": "Zhongshan District",
      "RecipientState": "Taipei City",
      "RecipientCountry": "Taiwan",
      "RecipientPostalCode": "51146",
      "RecipientContactNo": "986536",
      "RecipientEmail": "hainn229@gmail.com",
      "Commodity": "Mushrooms",
      "OrderNumber": "",
      "Weight": 1,
      "Length": 10,
      "Width": 10,
      "Height": 10,
      "DeclaredCurrency": "HKD",
      "DeclaredValue": 100,
      "Qty": 2,
      "Remark": "nil",
      "ETD": "2024-02-24 09:00:00",
      "ETA": "2024-02-24 15:00:00",
      "PickUpDate": "",
      "DeliveryDate": "",
      "IsCOD": "N",
      "CODType": 0,
      "CODCurrency": "",
      "CODAmount": 0,
      "SupplierName": "",
      "GSTRegNo": "",
      "GSTAmount": 0,
      "GSTCurrency": "",
      "GSTStatus": "",
      "Origin": "SG",
      "Destination": "TW",
      "Dep_Iata": "SIN",
      "Arr_Iata": "TPE",
      "IsDDP": "Y",
      "ItemListing": [
        {
          "SKU": "222222",
          "ItemDescription": "Mushrooms",
          "ItemWeight": 1,
          "NoOfPcs": 2,
          "ItemValue": 100,
          "ItemCurrency": "HKD",
          "ItemOrigin": "SG",
          "ItemDestination": "TW",
          "HSCode": "482010"
        }
      ]
    }
  ]
}

Response(success)

json

{
  "Code": 0,
  "Message": "Success",
  "Data": {
    "Success": [
      {
        "OwnerId": 1,
        "TrackingNo": "C240129142515376136497",
        "DeliveryId": "",
        "DateTime": "2024-01-29 14:27:06",
        "Status": "Accepted",
        "Error": [
          {
            "Reason": ""
          }
        ]
      },
      {
        "OwnerId": 1,
        "TrackingNo": "C240129142515839830635",
        "DeliveryId": "",
        "DateTime": "2024-01-29 14:27:06",
        "Status": "Accepted",
        "Error": [
          {
            "Reason": ""
          }
        ]
      }
    ],
    "Errors": [
      {
        "OwnerId": 1,
        "TrackingNo": "C240129142514596183997",
        "DeliveryId": "",
        "DateTime": "2024-01-29 14:27:06",
        "Status": "Rejected",
        "Error": [
          {
            "Reason": "The total length of addresses 1, 2, and 3 exceeds the maximum limit of 320 characters"
          }
        ]
      }
    ]
  }
}

Create Parcels ​

Request Method ​

Header ​

Parameter ​

Request ​

Response(success) ​

Create Parcels

Request Method

Header

Parameter

Request

Response(success)