Welcome to SortedREACT! Here you’ll find a brief overview of REACT’s component parts and what you can do with them.
If you just want to get started with the system, check out the Quick Start guide.
REACT aggregates all your tracking information in one place and one format, no matter where your shipments are going or what carrier they’re shipping with. Once you register your shipments and give REACT permission to access tracking data from your carriers, REACT automatically watches out for updates and keeps all your shipment records up to date.
This standardised tracking data enables you to build API-driven tracking pages on your sites, use webhooks to set up automated delivery alerts to your consumers or customer service teams, and monitor shipment performance via REACT’s UI dashboard.
REACT is based around three fundamental concepts: shipments, tracking events, and events.
A typical REACT shipment lifecycle might look something like this:
A shipment is registered for tracking in REACT. You can register shipments via either the Register Shipments API endpoint or REACT’s SFTP upload service.
More Information: For more information on registering shipments, see the Registering Shipments page.
REACT continually checks its carrier data for new tracking events relating to the shipment. You’ll need to set up carrier connectors via the Settings > Carrier Connectors UI page to give REACT access to your tracking information.
Where REACT finds new tracking information, it analyses the tracking event sent by the carrier and uses it to determine the shipment’s current state.
REACT uses internal, standardised shipment states for all carriers. For example, our analysis has shown that DPD UK’s tracking events with a status of Collected and Yodel tracking events with a status of Parcel Picked Up mean the same thing. As such, REACT converts both of these statuses to an internal REACT shipment state of Collected By Carrier, making it easier to track and manage your shipments no matter which carrier they’re with. This process takes place for every tracking event received from REACT’s supported carriers.
You can also customise the names used for REACT shipment states via the UI’s Settings > Custom State Labels page. For example. you could rename the Collected By Carrier REACT shipment state to With Our Providers. State labels enable you to communicate tracking information to your customers in your brand’s tone of voice or in an alternative language. REACT state labels support up to 8 locales.
More Information: For a full list of available REACT shipment states, see the Shipment States page.
REACT converts the contents of the carrier’s tracking update into a standardised REACT tracking event, and associates the contents of that event with the relevant shipment, based on the shipment’s carrier tracking reference. If two or more shipments have the same carrier tracking reference, then REACT associates the tracking event with all relevant shipments.
More Information: For information on the structure of REACT’s tracking events, see the Get Tracking Events API reference.
If a shipment’s properties need to be updated as a result of the tracking event (for example, because the shipment’s state or promised date have changed), then REACT creates an internal event and updates the shipment’s details accordingly.
More Information: For more information on the structure of REACT’s Event objects, see the Get Event API reference.
If the change in shipment properties has triggered any of your webhooks (for example, because you have a webhook set up to listen out for failed deliveries and the shipment’s state has changed to Delivery Failed Card Left), then REACT sends the shipment’s data to you.
More Information: For more information on setting up webhooks, see the Managing Webhooks page.
You can use the webhook data REACT sends to drive services that send automated email, SMS, push, or social media notifications to your customers.
You can also use REACT’s webhook data to build services that automatically escalate issues to your carriers or create tickets for your customer service team to manage.
You can use the data from REACT’s APIs to drive embedded delivery tracking from your own website, without the need to pass customers off to a carrier portal.
More Information: For more information on retrieving tracking data from REACT, see the Retrieving Shipment and Event Data page.
REACT is designed to be flexible, enabling you to manage and track shipments in a variety of ways. You can interact with REACT via:
REACT offers the following API endpoints, enabling you to offer advanced shipment tracking and management features through your own website or apps:
|Register Shipments||Register shipments for tracking|
|Get Shipment by Shipment ID||Retrieve shipment details by REACT Shipment ID|
|Get Shipments||Retrieve shipment details by tracking or custom reference|
|Update Shipment||Update shipment details|
|Delete Shipment||Delete a shipment|
|Get Tracking Events by Shipment ID||Retrieve all shipment tracking events for a specified shipment|
|Get Event||Retrieve events by REACT Event ID|
|Get Shipment Events||Retrieve events by date range, references and carrier|
|Get Shipment Events by Shipment ID||Retrieve event details by REACT Shipment ID|
|Get Shipment States History||Retrieve a shipment’s shipment state history|
To query any of the APIs, you’ll need an API key. You can create one from the Settings > API Keys tab in the REACT UI. You’ll also need to make sure your
content-type headers are set to
application/json, as REACT only works with JSON data.
- For full request and response details for each endpoint, see the API Reference.
- For information on how to register shipment details via API and SFTP, see the Registering Shipments page.
- For information on retrieving shipment, event, and tracking information via API, see the Retrieving Shipment and Event Data page.
- For information on updating shipment details via API, see the Updating Shipments page.
- For information on the error codes that REACT’s APIs can return, see the Error Codes page.
REACT’s webhooks enable you to build services that respond to shipping events proactively. During the webhook setup process, you associate a particular webhook with a shipment state or group of states. When an event puts a particular shipment into one of those states, REACT sends details of the event and its associated shipment to a URL of your choice. You can then feed this data into whatever application you choose.
Webhooks can be configured from the Settings > Webhooks tab on the REACT Dashboard. The settings you select on this page depend on the service that is to receive the webhook data. You’ll need to know:
In REACT, webhooks are triggered by Shipment State Groups. A Shipment State Group is a list of shipment states or tags that acts as a webhook trigger. When a shipment meets any of these criteria, any webhooks configured for that group will deploy. Each webhook can be triggered by multiple Shipment State Groups, and each Shipment State Group can be associated with multiple webhooks.
You can create Shipment State Groups from the Settings > Shipment State Groups tab on the REACT Dashboard.
For more information on creating and maintaining Shipment States Groups and webhooks, see the Managing Webhooks page.
The UI gives REACT admins an intuitive set of tools with which to monitor shipments and configure system operation. It has three main functions - Reporting, Configuration, and User Management.
You can access the REACT UI here.
REACT’s dashboards can be found under the UI’s Dashboard tab. They give you a filterable overview of your registered shipments and system connectivity.
For more information on monitoring shipments in the UI, see the Monitoring Shipments page.
The UI’s Settings tab enables you to configure REACT to receive carrier tracking information, set up webhooks and API keys, and configure connectivity to third-party products.
For more information on configuring REACT in the UI, see the Settings page.
Administrators can manage the REACT users in their team from the Add Member page, accessed from the user menu icon.
From this screen, as an Administrator, you can:
For more information on managing users in the UI, see the User Management page.
Learn more about REACT: