Webhooks

Supported scenarios

Subscribe to events;
Unsubscribe from events.

For the business rules concerning webhooks, please read Business Rules - Webhooks.

Subscribe to events

Purpose

A Supplier application may subscribe to organization events that are posted by Floriday at the specified callbackURL. Starting with sales order events: accepted, committed, cancelled and corrected.

Process steps

NRProcess stepAPI call / scenario 1A Supplier application may subscribe to organization events that are posted by Floriday at the specified callbackURL. Starting with sales order events: accepted, committed, cancelled and corrected.AddWebhookSubscription2/3Floriday posts a message with a subscribeURL on the callbackURL.4/5Supplier application confirms registration by using a GET on the subscribeURL.
Non confirmed registrations will be deleted after 72h.After registration Supplier application will receive events on the given callbackURL.

Supplier application can add more than one callbackURL for an organization.
Supplier applications can share one callbackURL for multiple organizations.
For technical reasons a maximum of 120 organizations can share one callbackURL at a time.
It is advised not to use too many callbackURL for Supplier application maintenance purposes.
For technical documentation on the callbackURL please refer to:

Unsubscribe from events

Purpose

A supplier application may unsubscribe their organization for posting events for the specified callbackURL.

Process steps

NRProcess stepAPI call / scenario 1Supplier application unsubscribe organization for posting events for the specified callbackURLDeleteWebhookSubscriptionIf after unsubscribing no organization has a subscription to the callbackURL, the subscription/registration of the callbackURL is deleted.After unsubscribing events Supplier application will no longer receive events on the given callbackURL.

Retry configuration

Floriday has the current retry configuration:

{
  "minDelayTarget": 20,
  "maxDelayTarget": 20,
  "numRetries": 3,
  "numMaxDelayRetries": 0,
  "numNoDelayRetries": 0,
  "numMinDelayRetries": 0,
  "backoffFunction": "linear"
}

After the initial attempt to delivery the message, 3 additional attempts will follow with an interval of 20s between the attempts.

For technical documentation on the 'message delivery retry' please refer to: