Skip to main content

API integration

Sync orders, inventory and indeliveries via API

Webhook

Receive real-time order updates

​
Supported data types

Orders

Customer transactions

Inventory

Stock levels & product data

Indeliveries

Incoming products

Returns

Order return details

​
API integration

​
Prerequisites

To integrate Centra with our platform, you need to have an API token with the necessary permissions within your Centra project. 
{
  "permissionsUsed": [ 
    "Attribute:read",
    "Brand:read",
    "Category:read",
    "Collection:read",
    "Display:read",
    "Folder:read",
    "Product:read",
    "Product.attributes:read",
    "ProductMedia:read",
    "ProductMedia.attributes:read",
    "ProductSize:read",
    "ProductSize.stockTotals:read",
    "ProductVariant:read",
    "ProductVariant.stock:read",
    "ProductVariant.stockTotals:read",
    "PurchaseOrder:read",
    "Warehouse:read"
  ]
}

​
Step-by-step integration guide

1

Initial setup

For the integration setup, specific credentials are required to securely access your Centra data.
  1. Gather required information: Confirm you have the following details from your Centra account:
    • API token
    • Endpoint
  2. Provide credentials: Share the credentials with your Customer Success Manager.
For security reasons, send this information via a secure password sharing method.
Example
{
  "token": "exampletoken123456789",
  "endpoint": "https://examplestore.centra.com/graphql"
}
2

Configuring the integration

Once your credentials are received, our team will configure the integration, ensuring secure and efficient data synchronization between Centra and our platform.
  • Access configuration: The provided credentials will be used to set up access to your Centra data, focusing on orders, indeliveries and inventory.
  • Schema mapping: Since Centra has custom data models for each customer, our integration team will map our data model schema to your relevant Centra fields.
  • Data synchronization: Our platform will begin to fetch and sync data based on your specified scope.
3

Finalizing integration

Once the integration is successfully configured, you’ll gain the ability to access and analyze your Centra orders and inventory data directly through our platform. This enables enhanced decision-making and helps you to refine your e-commerce strategy for better efficiency and growth.

​
Webhook

Setting up the webhook allows Dema to receive order data from Centra in real-time.

​
Prerequisites

To use Centra webhook with our platform, you need to setup a plugin with the necessary permissions within your Centra store.

​
Step-by-step webhook guide

1

Initial steps

For the webhook setup, a webhook URL and endpoint secret are required to securely access your Centra data.
  1. From the left panel, navigate to Stores management ⟩ Stores.
  2. Click the row (or the View link) for the Store you want to add the webhook to. The Store details will open to the right.
  3. Scroll down to the Plugins section and click the ”+ Add plugin method” button.
  4. Select “Active” from the Status dropdown.
  5. Enter a name for the plugin, preferably “Dema Webhook”, in the Plugin name field.
  6. Choose “Centra Webhook” from the Plugin dropdown. This will add some more fields to the form.
2

Configuring the webhook

  1. In the Webhook URL field, enter the following URL:
https://centra-webhook.dema.ai/DV-XXXXXXXXXXXXXXXXXXXX
where DV-XXXXXXXXXXXXXXXXXXXX is the unique ID provided by Dema for your store.
  1. Share the pre-generated Endpoint secret securely with Dema.
  2. From the Version dropdown, choose “Integration API”.
  3. Under Event triggers, choose “Yes” for Order, and “No” for others.
  4. Leave the default values for all other fields.
  5. Click on the Save button (top right) when you’re ready.

​
Troubleshooting and support

If you face any challenges during the integration process or have any questions about the setup, our support team is ready to assist you.

​
Additional resources

For further details on managing your Centra account and utilizing the API, refer to the Centra Documentation.