Documentation

Carrier Product Mappings

Carrier Product Mappings are crucial to accurate tracking. They link specific tracking numbers to the corresponding carrier services, allowing the Ingrid System to retrieve carrier tracking events.

Setup for Carrier Product Mappings varies depending on booking source (Ingrid Booked or Externally Booked Carrier Products). Mappings configuration can be accessed in IMP under Delivery Tracking Section > Product mappings.

After Carrier Product Mappings are in place and tracking configuration is set up by the Ingrid Onboarding Team, Ingrid Delivery Tracking will start to retrieve Tracking Events from carriers.

Ingrid Booked Products

Mapping for products booked with Ingrid Transport Administration will automatically appear under Ingrid Booked Products section. If something for your booking setup is missing from that section, please reach out to Ingrid Customer Support.

Ingrid Bokked Products Carrier Mappings Example

Externally Booked Products

Carrier Product Mappings for externally booked product require manual configuration.

carrier_product_ref is a unique reference that connects carrier products from your system to Ingrid. It helps to understand which carrier service was used to book a delivery. carrier_product_ref can be any string value, but do keep it consistent for all tracking numbers using the same product. Don't forget to add new products to Ingrid by mapping them first, so that they can be tracked properly.

External Carrier Mapping Reference Example

Add External Carrier Mapping Reference Example

Usage

carrier_product_ref are later used in CreateTrackingOrder and RegisterTrackingNumbers requests.

Mapping suggestions

If CreateTrackingOrder or RegisterTrackingNumber requests were made with an unmapped carrier_product_ref, a mapping suggestion for those will appear on top on the Product mappings page. You will also receive a notification about unmapped references after logging into IMP.

Mappings notification toast

Mappings suggestions Example

There are two types of suggestions:

  1. General ones, highlighting the reference only
  2. Showing the exact carrier product used - those will work only if the carrier_product_ref used matches exactly against a carrier_product_id in Ingrid System.

After a suggestion is mapped, all tracking numbers with such carrier_product_ref will be updated with the carrier product assigned to that mapping.

Unmapped suggestions

Unmapped suggestions will expire after 5 days, as long as there are no new requests made with them. Each carrier_product_ref actively used for tracking numbers registration must be mapped; otherwise you will be stuck with an unmapped product suggestion and Ingrid will be unable to track those parcels.

If tracking integration for selected product is not available, but URLs to Carrier's tracking are (referred to as tracking links), a fallback redirecting Customers from Ingrid Delivery Tracking to Carrier's tracking website can be enabled. To this end, select the Always show tracking links option.

Apart from the default carrier tracking links available, you can configure custom URLs. Those are not linked to any particular carrier product and serve as a fallback solution for products not yet integrated with Ingrid. Every custom URL must contain a <TRACKING_NUMBER> placeholder. It will be filled with a parcel's tracking number by Ingrid.

Tracking links fallback can de applied to both Ingrid Booked and externally booked carrier products.

Custom Tracking Link Example

Tracking Links impact on the Ingrid Delivery Tracking Experience

Bear in mind that tracking links are meant to be a fallback for carrier products without a tracking integration with Ingrid in place yet. As all URLs require a placeholder for tracking_number, a redirection button will appear only after a tracking number is registered or a shipment gets booked. Until then, Harmonised Progress steps will be shown. Showing the redirection button results in Alerts and ETA tracking features being disabled.

Tracking Page with Tracking Link Enabled Example

Last updated: Fri, Jul 12, 06:15 AM