At this point you have sent us a number of delivery orders that we have shipped from our fulfilment facility... What happens next?
Once those orders are handed over to the carrier and departs from our fulfilment facility, we will make the shipment confirmation details available to you. We will include the details of the box(es) that we used to pack your order, as well as the carrier's tracking number for each box. You can give the tracking number to your client so that they can track the final delivery of the order.
There are 2 ways to retrieve shipment confirmations:
| NextToken |
Required. Every shipment confirmation in our database has an ID.
This ID is a sequential number that is incremented every time a new shipment confirmation record is added. We call them "tokens".
So, this is how it works: You have to send us the token of the last shipment confirmation that you have received,
and we will look up all the new shipment confirmations that we have created (since that token).
For example, let's say that the token of the last shipment confirmation that you received is 82. During the next shift in our fulfilment facility, we create 3 new shipments: 83, 84 and 85. The next time you request this service (using token 82), we will return the shipment confirmation records for 83, 84 and 85. We will also give you a new token, 85, which you have to remember because you have to use this token the next time you request this service. |
{
"NextToken": "85",
"Orders": [
{
"DN": "83024510125",
"DateShipped": "2016-03-17T06:38:20Z",
"Carrier": "UPS-EXP",
"POE": "JFK",
"ShipmentNumber": "V8A49275",
"BoxCount": 1,
"PalletCount": 0,
"ShippingAddress": {
"Name": "John Smith",
"Company": "",
"AddressLine1": "2080 Plaza on the Lake",
"AddressLine2": "Suite 180",
"City": "Austin",
"State": "TX",
"Country": "US",
"PostalCode": "78746",
"Phone": "530 418 4208",
"Email": "john@gmail.com"
},
"Containers": [
{
"Type": "Box",
"Qty": 1,
"Weight": 0.5070,
"TrackingNumber": "V0172587922",
"SSCC": "008520670100000481",
"Lines": [
{
"LN": "1",
"PN": "SK5482-01",
"Qty": 1,
"Weight": 0.2580,
"SN": [
"94071065930"
]
}
]
}
]
}
]
}| NextToken | We will always return the next token to you in the response. You have to store it, because you have to use this token the next time you request this service. |
| Orders |
This is the list of orders that were shipped from our fulfilment facility. If there were no new shipments since your last request,
then the orders array will be empty, for example:
JSON: "Orders": [] XML: <Orders></Orders> |
| DN | This is the number of the delivery order that you sent to us. |
| DateShipped | This is the date and time when the order was shipped from our fulfilment facility. Please note that, because we have fulfilment facilities across the world, this date is in Coordinated Universal Time (UTC), as indicated by the "Z" at the end: 2016-03-17T06:38:20Z |
| Carrier | This is a code that you can use to determine with which carrier we shipped your order, and which service level we used. For example, a value of "UPS-EXP" indicates that the carrier is UPS and the service level is Express. |
| POE | POE stands for Port of Entry. Where possible, we will tell you through which airport (or harbour) the carrier will enter the country of destination. For example, if your order is shipped by air to a location on the east coast of the United States, the POE will most likely be "JFK" (John F. Kennedy Airport in New York). |
| ShipmentNumber |
Depending on the size of your order, we have 2 different ways to pack and ship it:
|
| BoxCount | This is a number that tells you how many boxes are in your order. To reduce shipping costs, we will always try to pack all the items in your order into a single box. |
| PalletCount | This is a number that tells you how many pallets are in your order. |
This is the address where we are shipping your order to. This is a copy of the shipping address that we received from you in the delivery order.
This is a list of all the boxes (or pallets) in your order. We also include the details of the items packed into each box or pallet.
| Type | Type will have a value of "Box" or "Pallet". |
| Qty | This is the total number of items that were packed into this container. |
| Weight |
This is the total weight of the container, in kilogram. Please note that this is a calculated weight, not the actual weight. We calculate it as follows:
|
| TrackingNumber |
If the container is a box, then this is the tracking number of the carrier.
You can give this tracking number to your client so that they can track the delivery of this box.
We recommend that you use the PCH Track & Trace website.
If the container is a pallet, then you can ignore this tracking number. |
| SSCC | SSCC stands for Serial Shipping Container Code and is a unique 18 digit tracking number for this container (separate to the carrier's tracking number). PCH generates an SSCC number for every box and pallet that is shipped. |
This is the list of items (from the lines in your delivery order) that were packed into this box or pallet.
| LN | This is the line number that you sent to us in the delivery order. |
| PN | This is the part number that you sent to us in the delivery order. |
| Qty | This is the number of items that were packed into this box or pallet. |
| Weight | This is the weight of the part, multiplied by the number of items that were packed into this box or pallet. Weight is always in kilogram. |
| SN | SN stands for serial number. If your part has a serial number, then we can scan it during the packing process. All the numbers that were scanned (for this box or pallet) will be included in a list here. |
| shipmentStartDate | Required. This is the start date of the period for which you want to retrieve shipment confirmations. |
| shipmentEndDate |
Required. This is the end date of the period for which you want to retrieve shipment confirmations.
You can use the format "yyyy-mm-dd hh:mm:ss" for both dates, for example 2016-03-28 16:00:00. Please note that this is the local time at the fulfilment facility. |
Same as 'Get new shipment confirmations (token method)'.