Development API requirements for Sandbox
The development of some basic API calls is a process of creating and testing essential API functions that are fundamental to the operation of a software application. These initial API calls are typically recommended to handle core functionalities that the software can rely on once it is fully operational.
Intersoft API is a fully RESTful service implemented using JSON messaging. You, as the customer are responsible for sending JSON messages and for maintaining the capability of receiving JSON messages in the format described in this section.
Prior to going live on SAPIENT, first provide a bearer token and make sure, as a minimum, to have the following API calls developed:
- Create Shipment: to generate the delivery labels for your packages.
- Update Status: to cancel/void a current shipping label. This can only be used before a shipment has been confirmed by being manifested.
- Manifest Shipments: to closeout shipments, which produces the collection manifest to be handed over to the driver and triggers electronic pre-advice and billing data to be sent to the carrier. This must be done before your shipment enter Royal Mail network. Not doing it may result in multiple issues such as delays, missing tracking, lack of notifications for your end consumers, surcharges, and others.
Note
At INTERSOFT, we have developed a dedicated API endpoint for servers based in China. To access this domain, kindly change your domain from .net to .cn for all the relevant endpoints you will be using.
For example, when creating a new shipment replace the https://api.intersoftsapient.net/v4/shipments/rm URL with https://api.intersoftsapient.cn/v4/shipments/rm.
As a back-up, please develop .net as well.
See also
Updated about 1 month ago