Guides

Example service

An example Carrier Integration Service in NextJS

An example project is available on Github that implements the bare minimum required for a working Carrier Integration Service. You can find the repository on Github. This NextJS app is published at https://carrier-integration-service-example.xentral.com. Feel free to fork or copy it as a starter.

Setup Xentral with the example Carrier Integration Service

Navigate to settings > Warehouse & Logistics > Shipping > Shipping Method > Add > Carrier Integration Service

Use:

  • Login Method: Bearer Token
  • Token: superSecureBearerToken1234
  • Service URL: https://carrier-integration-service-example.xentral.com

Then fill in the rest of the form.

Printing a shipping label with the example Carrier Integration Service

You can print a shipping label with the new carrier by navigating to a Delivery Note, select the new shipping method and go to the Shipping label tab.

⚠️

Hard coded response

Please be aware that large parts of the response of the example service are hardcoded. You will always get the same DHL PDF label back, even if you have set it to ZPL. And the Address info and weight info will not be matching. This service is purely to illustrate the inner workings, not to be a full working service.