External Integration
Purpose:
To share Sales orders from other channels (Email, telephone, webshops etc.) with Floriday for financial processing.
When to use External Integration
Please note that Sales orders must primarily be initiated by customer organizations via Floriday or the API. In case this is practically not possible, an ExternalIntegration can be used by a supplier organization.
Prerequisites:
- The supplier application has the latest update of Organizations.
- The supplier application has the latest update of Trade items.
- The supplier application has the latest update of Warehouses.
- The supplier application has the latest update of Delivery locations.
Process steps:
| Process step | API call / Scenario | |
|---|---|---|
| 1 | Create a Sales order. | AddSalesOrderExternalIntegration |
| After the Sales order is created, a Fulfillment request and the subsequent Delivery order(s) are generated. A Delivery order is a group of one or more Fulfillment requests with the same delivery location, latestDeliveryDateTime and Despatch warehouse. | ||
| 2 | Sync Delivery orders by latest sequence number. | GetDeliveryOrdersBySequenceNumber |
| Process the retrieved Delivery orders in the supplier application with their unique delivery order ID. | ||
| 3 | Add a Fulfillment order based on (a part of) Fulfillment requests that belong to the same Delivery order. | AddFulfillmentOrder |
External Integration with E-Wallet
A Sales order originating from an External Integration should be uploaded to Floriday as soon as possible, to avoid complications for the supplier during the fulfillment process. This is especially true in case the buyer pays by E-wallet (see: Business Rules: E-Wallet).
Floriday will only accept the Sales order if the buyer's E-Wallet has sufficient credit. A buyer could adjust their credit limit, but this can be a time consuming process (this may take 1 hour up to several days). During this time the suppliers system may try to upload the sales order periodically until accepted.
Updated 6 days ago