{"id":15280,"date":"2023-10-06T10:15:11","date_gmt":"2023-10-06T08:15:11","guid":{"rendered":"https:\/\/guide.itscope.com\/?post_type=kb&p=15280"},"modified":"2026-01-09T14:34:13","modified_gmt":"2026-01-09T12:34:13","slug":"set-up-webhooks","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/set-up-webhooks\/","title":{"rendered":"Set up webhooks"},"content":{"rendered":"\n

What are webhooks?<\/h2>\n\n\n\n

A webhook is a non-standard HTTP request that is triggered when something happens in the originating system.<\/p>\n\n\n\n

In the case of ITscope, this occurs when new deal or order response documents become available. For example, if a distributor A provides a new delivery note for an order from customer B, a webhook with this information will be sent to the corresponding URL (if everything has been configured correctly).<\/p>\n\n\n\n

Structure<\/h2>\n\n\n\n

ITscope’s webhooks are structured according to the following scheme:<\/p>\n\n\n\n

eventId<\/td>ID of the sent webhook<\/td><\/tr>
timestamp<\/td>Timestamp of when the webhook was sent<\/td><\/tr>
eventType<\/td>Type of document that triggered the webhook. Possible values are ORDER, ORDERRESPONSE, DELIVERY and INVOICE<\/td><\/tr>
transactionStatus<\/td>New status of the order or deal (e.g. ARRIVED or PROCESSING)<\/td><\/tr>
orderId<\/td>ID of the order or deal<\/td><\/tr>
itscopeOrderId<\/td>ID of the order or deal assigned by ITscope<\/td><\/tr>
documentId<\/td>ID of the document that triggered the webhook<\/td><\/tr>
documentUrl<\/td>URL to access the actual document via ITscope API<\/td><\/tr>
transactionId<\/td>ID of the transaction<\/td><\/tr><\/tbody><\/table>
Structure of ITscope webhooks<\/figcaption><\/figure>\n\n\n\n

A webhook for a new dispatch notification could, for example, look like this:<\/p>\n\n\n\n

{\n  \"eventId\": \"e2a6a466-3b62-4bb7-af53-b59aec592b49\",\n  \"timestamp\": \"2023-10-17T11:01:36\",\n  \"eventType\": \"DELIVERY\",\n  \"transactionStatus\": \"ADVISED\",\n  \"orderId\": \"123-SAMPLE-456\",\n  \"itscopeOrderId\": \"SAMPLE-123456-789\",\n  \"documentId\": \"123456789\",\n  \"documentUrl\": \"https:\/\/api.itscope.com\/2.1\/business\/documents\/123456789-1234-5678-9123-12SAMPLE4567\/DISPATCHNOTIFICATION.xml\",\n  \"transactionId\": \"123456789-1234-5678-9123-12SAMPLE4567\"\n}<\/code><\/pre>\n\n\n\n
Set up<\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
The webhook settings can be accessed in the header bar above the profile picture on the right <\/strong>> My Account<\/strong> > Webhooks<\/strong><\/a> tab. This page is visible to all users. Changes can only be made if the executing user is a company admin<\/strong> and if the necessary modules have been purchased in the company’s contract<\/p>\n\n\n\n
The settings are roughly divided into two areas:<\/p>\n\n\n\n
    \n
  1. The access data for the target system can be entered in \u201cBasic Authentication\u201d so that the webhooks can be sent with them if the server of the entered URLs expects such authentication. If a password has already been stored, asterisks are displayed to indicate the length of the password.<\/li>\n\n\n\n
  2. The links to which the respective webhooks should be sent can be entered under URLs. To do this, the respective checkbox must be selected and an https URL must be entered. Only when both are fulfilled will the webhooks be sent. A dummy webhook can be sent to the entered URL using the \u201cTest\u201d button.<\/li>\n<\/ol>\n\n\n\n
    The webhook settings are only saved once the \u201cApply changes\u201d button has been clicked.<\/p>\n","protected":false},"excerpt":{"rendered":"
    What are webhooks? A webhook is a non-standard HTTP request that is triggered when something happens in the originating system. In the case of ITscope, this occurs when new deal …<\/p>\n","protected":false},"author":36,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[200],"kbtag":[],"class_list":["post-15280","kb","type-kb","status-publish","hentry","kbtopic-account-en"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/15280","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/users\/36"}],"replies":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/comments?post=15280"}],"version-history":[{"count":6,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/15280\/revisions"}],"predecessor-version":[{"id":19881,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/15280\/revisions\/19881"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=15280"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=15280"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=15280"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}