Tradecloud Connectors
  • Overview
  • API v2
  • Azure Active Directory Connector
    • Azure AD Connector - AD Configuration
    • Azure AD Connector - Tradecloud Configuration
  • FTP Connectors
    • CSV FTP Connector
    • Edifact FTP Connector
  • SAP SOAP Connector
  • Webhook Connector
    • Setting up the webhook
    • Configure the webhook
    • Order Events
    • Order Documents Events
    • Shipment Events
  • Legacy
    • API v1
    • CVS File Connector
      • CSV File Connector Requirements
      • CSV Buyer Specification
      • CSV Supplier Specification
    • Exact Globe Connector
Powered by GitBook
On this page
  • Setting up the order webhook
  • Setting up the shipment webhook
  • Next: configure the webhook

Was this helpful?

  1. Webhook Connector

Setting up the webhook

Setting up the webhook at the customer side

PreviousWebhook ConnectorNextConfigure the webhook

Last updated 6 months ago

Was this helpful?

To receive a webhook trigger you will need:

  • A simple web service reachable from the internet, which listens to some URL.

  • The web service must support SSL only and you will need a SSL certificate.

  • The web service must be configured to use TLS v1.2 or v1.3.

  • Self-signed certificates are NOT supported.

  • The web service must support either basic authentication, static bearer token or OAuth 2.0 Client Credentials Grant.

  • The webservice must support the POST HTTP method and be able to parse the request body in JSON or tXML

You can test the security level of your certificate at

Setting up the order webhook

Your webhook must implement the :

  • Use the orderEvent field when working with a delivery schedule with multiple deliveries per order line.

  • Use the singleDeliveryOrderEvent field when with working with a single delivery per order line.

  • Use the orderDocumentsEvent field when receiving order documents.

See to read about the delivery schedule versus the single delivery per order line.

An orderEvent or singleDeliveryOrderEvent will only contain the order lines affected by the event.

When using the orderDocumentsEvent field, you must as the document content is not embedded in the event itself.

Setting up the shipment webhook

THe shipment even will contain all the lines and documents. You can filter new/changed lines and documents based on the lastUpdatedAt fields.

Next: configure the webhook

Your webhook must implement the :

When using a documents field, you must as the document content is not embedded in the event itself.

SSL Labs
order webhook OpenAPI specification
the API manual
download the document
shipment webhook OpenAPI specification
download the document
Configure the webhook