Handle invalid tracking numbers

Overview

The Sapient's Trackings API processes valid tracking numbers while isolating the invalid ones, providing clear feedback without failing the entire batch.

Handling procedure

Processing Behavior

All tracking numbers in a request are accepted and inserted into the database (max 1000)
Invalid tracking numbers are marked as 'DO NOT TRACK' and not registered with the carrier
Requests does not fail if invalid numbers are present—only invalid entries are marked
Duplicate tracking numbers within the same batch are accepted

Invalid Tracking Events

For each invalid tracking number, a tracking event is created and pushed via webhook.

Event Properties:

Event code: INVD
Event name: Invalid Tracking Number
Event type: Tracking
Milestone: No
Stop the clock: Yes

📘
Note
The webhook payload includes mandatory fields as specified in the push payload example section. Invalid tracking numbers are processed asynchronously to ensure valid shipments continue tracking without interruption.

See also

Add Tracking Account

Establish your tracking account for seamless integration.

Track Events and Milestones

Understand tracking events and milestone data.

Handle Webhook Suspension

Manage and resolve webhook suspension scenarios.

Updated about 8 hours ago