Shipment usage
The Safecube webhook monitoring system tracks a shipment from the moment it is added to an endpoint until it is removed, either by you or automatically under the auto-removal policy. Every monitored shipment is charged. Check the list of monitored shipments regularly to avoid overcharging; the practices below help.
Remove old shipments
Monitor a shipment only as long as you need updates for it. Depending on your use case, stop after:
- its arrival at the port of discharge;
- its gate out;
- the moment you are certain no further movement will occur.
To remove shipments from the monitored list, use DELETE /easy-shipment.
Deleting the endpoint itself, with DELETE /endpoint/{endpoint_id}, also removes every shipment attached to it from the monitored list.
Remove useless shipments
Safecube starts monitoring a shipment as soon as it is added to an endpoint, and sends the shipment.added.to.endpoint event when it receives the first tracking information. For some shipments, no information ever arrives: the shipping line cannot be autodetected (retry with the shipping line specified), the number is incorrect, or the shipping line is not supported. As long as these shipments stay in the endpoint list, Safecube keeps trying to monitor them, and they are charged.
Safecube sends the shipment.in.error event when the first attempt to retrieve information for a shipment fails. The Adding shipments page details each error code.
Check the validity of new shipments
Container numbers are reused periodically. After a reuse, the tracking information received may belong to a new voyage instead of the expected one, and be misleading or useless.
Specifying the shipping line makes sure the data comes from the right source. When you receive the shipment.added.to.endpoint event, also check the data against your own records, for example:
- the shipping line is the expected one;
- the date of the first event matches your internal records;
- the port of delivery is the expected one.
Clean up monthly
Shipments are charged by month. A monthly check at the end of each month makes sure you pay only for useful data:
- Retrieve every shipment of every endpoint with
GET /easy-shipment. - Send a Container Tracking API request,
GET /shipment, for each shipment — this incurs no extra charge. Remove the shipments that return an error. - Check that the data of each shipment is still accurate, for example by comparing the date of the first event or the POD location, and remove the shipments that are not.