Ingrid can pick up tracking numbers directly from Centra, so you don't need to send them to Ingrid yourself. When a shipment changes in Centra, Centra notifies Ingrid through its webhook plugin. Ingrid then reads the order and shipment from Centra and registers the tracking number.
This integration only registers tracking numbers. To show tracking events and send notifications, you also need:
Carrier tracking set up with Ingrid, so Ingrid can fetch events from your carriers. Your Ingrid contact will help you with this.
The Ingrid tracking widget embedded on your site, or the Ingrid-hosted tracking page. See Engage: configuration and integration.
The integration works for orders placed through Ingrid Checkout and, if enabled, for orders placed with other shipping methods.
Before you start
You need admin access to Centra and the following from your Ingrid contact:
Your Ingrid site ID. You get one per environment, for example one for test and one for production.
A secure way to share credentials, such as a shared password vault. Never send tokens or secrets by email or chat.
If you test in a Centra test environment (SIT, ACC or QA), set it up against Ingrid's stage environment first. Then repeat the steps for production.
Setup takes three steps: create an API token, set up the webhook plugin, and share the details with Ingrid.
Setup
Step 1: Create a Centra API token
Create a GraphQL Integration API token in Centra. Ingrid uses it to read the order and shipment after each webhook. Give the token the permissions below. A token with missing permissions is the most common reason tracking numbers don't appear.
Permission | Needed for |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| All setups |
| Translated product names |
| Translated product names |
| Split orders (several shipments per order) |
| Orders not placed through Ingrid Checkout |
| Orders not placed through Ingrid Checkout |
| Orders not placed through Ingrid Checkout |
If you're unsure which features you use, add all of them.
Also note your Centra GraphQL API URL, for example https://yourbrand.centra.com/graphql.
Step 2: Set up the Centra webhook plugin
In Centra admin, go to Stores management → Stores → your store → Plugins.
Add a plugin of type Centra Webhook and select the Integration API version. See Centra's webhook plugin documentation.
Set the URL to the Ingrid webhook for your environment. Replace
{site_id}with the site ID you got from Ingrid (see the table below).Create an endpoint secret in the plugin and keep it for step 3.
Turn on these event triggers: Order, Shipment and, if you use Ingrid for returns, Return. Leave the others off.
Leave the plugin inactive until Ingrid confirms that your details are in place (step 3).
Environment | Webhook URL |
Test (Centra SIT, ACC or QA) |
|
Production |
|
Common mistakes are a production URL in a Centra test environment, or a site ID from another environment.
Don't confuse this with the Ingrid Checkout plugin (Shipping Method / Ingrid V2). They are separate plugins.
Step 3: Share the details with Ingrid
Send these to your Ingrid contact through a secure channel, once per environment:
Centra GraphQL API URL
API token from step 1
Webhook endpoint secret from step 2
Whether to register tracking numbers for all orders, or only orders placed through Ingrid Checkout
Whether you want return shipments registered too
Ingrid adds the details to your site and confirms. Then set the webhook plugin to Active in Centra.
Shipment requirements in Centra
Ingrid registers a tracking number only when the shipment in Centra meets all of these:
Marked as paid, good to go and shipped.
Has a tracking number.
Has at least one carrier information field filled in: carrier name or service name. You'll find them under Shipment info in Centra.
Ingrid uses the carrier name and service name to match the shipment to the right carrier. Use the same values consistently, and tell your Ingrid contact which values you use.
If your warehouse system sends tracking numbers to Centra, make sure it fills in these fields too.
FAQ
How do I test it?
Ship a test order in your Centra test environment with a tracking number and carrier info. Send your Ingrid contact the Centra order number and the time you shipped it. Ingrid confirms whether the tracking number was registered.
How long does it take?
There's no polling delay. Centra notifies Ingrid when the shipment changes, and Ingrid registers the tracking number shortly after.
What about orders shipped before setup?
They aren't registered automatically, because Centra only sends webhooks for new changes. A small edit to the order in Centra, such as adding a comment, triggers a new webhook.
Tracking numbers aren't showing up. What should I check?
The webhook plugin is Active and uses the right URL and site ID for the environment.
The API token has all permissions from step 1.
The shipment is paid, good to go and shipped, with a tracking number and carrier info.
If all of the above are fine, contact Ingrid Support with the Centra order number.
Do I need to buy anything from Centra?
No. The webhook plugin is part of Centra, and Ingrid handles the rest.
