Troubleshooting
This section provides reference information and guidance for resolving common issues with your live integration.
Use this guide to diagnose and resolve common operational issues.
Your system can’t process the booking file
If you receive errors when parsing the booking CSV file, check these things:
- Manually inspect the file. Open the file in a text editor to check for corruption or formatting issues.
- Compare the column headings in the file to the structure outlined in the Receive bookings section.
If these steps don’t resolve the issue, contact your account manager, or Shippit support.
Tracking updates sent using CSV aren’t appearing in Shippit
If you don’t see tracking updates on the Shippit platform, check these things:
- Check the upload location, and make sure you’re uploading to
/inbound/tracking/
on Shippit’s SFTP server. - Check the filename, and confirm it matches the
Tracking_YYYY-MM-DD_HHMMSS.csv
format. - Check the file contents, and verify that the
tracking_number
,status_code
, andevent_timestamp
are correct.
If these steps don’t resolve the issue, contact your account manager, or Shippit support.
The tracking webhook endpoint is returning error codes
There are several error codes that the webhook could return:
HTTP code | Description | Action |
---|---|---|
401 Unauthorized | The authorisation header is missing or the secret token is incorrect | Verify the credentials you are using |
400 Bad Request | The JSON payload is malformed or missing required fields | Compare the column headings in the file to the structure outlined in the Send tracking section. |
5xx Server Error | This could be a temporary issue on Shippit’s side. | Retry with exponential back off. If persistent for over 30 minutes, check the Shippit Status Page or contact Shippit support. |