Customer Delivery

Supported scenarios

Get delivery orders;
Add fulfillment orders;
Delivery via DC;
Delivery direct.

Get Delivery Orders

Purpose:
Get Delivery Orders for customer delivery in Floriday.

Prerequisites:

The supplier application has the latest update of organizations;
The supplier application has the latest update of warehouses;
The supplier application has the latest update of additional services;
The supplier application has the latest update of trade-items;
Direct sales orders are committed.

Process steps:

NR	Process step	API call / scenario
1	Get highest generated sequence number.	GetDeliveryOrdersMaxSequence
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	The retrieved batches will be added or updated in the supplier application with the new batch IDs.
4	Get the package stickers as a PDF for the delivery order.	GetTrayLabelsAsPdfById
5	The retrieved stickers will be added or updated in the supplier application.
6	Get plant passports (optional)	GetPlantPassportPdf
7	The retrieved plant passports will be added or updated in the supplier application.

Synchronize Delivery locations

Purpose:
Receive delivery location GLN for goods movement in Floriday. Can be used when supplier creates their own sales orders, delivery locations marked as default can be used when delivery location is unknown.

NR	Process step	API call / scenario
1	Get highest generated sequence number.	GetDeliveryLocationMaxSequence
2	Sync delivery orders by latest sequence number.	GetDeliveryLocationsBySequenceNumber

Add Fulfillment Orders

Purpose:
Add Fulfillment Orders for goods movement in Floriday.

Prerequisites:

The supplier application has the latest update of organizations;
The supplier application has the latest update of warehouses;
The supplier application has the latest update of additional services;
The supplier application has the latest update of trade-items;
The supplier application has the latest update of batches;
The supplier application has the latest update of delivery orders;
The user has inserted fulfillment orders in the supplier application.

Process steps:

NR	Process step	API call / scenario
1	Add a fulfillment order with one or more load carrier items with one or more fulfillment requests with a number of packages.	AddFulfillmentOrder
2	The DC gets an ASN from Floriday.
3 (temporarily)	Financial settlement of sales orders and logistic means is initiated.
4	Logistic means balance is received and updated by Logistic Means service provider
5	Customer receives an ASN and a sales order status, starting with a DESADV.
6	The DC and the Payment service provider sends a fulfillment status to Floriday.
7	Get fulfillment order status	GetFulfillmentOrderStatusById
8	The retrieved fulfillment order status will be added or updated in the supplier application.
9	Get logistic labels starting with a Delivery Note as pdf by fulfillment order ID.	GetLogisticLabelsById
10	The retrieved logistic labels will be added or updated in the supplier application.
11A	Get Customer stickers (PDF) by sales order ID for a fulfillment request.	GetTrayLabelsAsPdfById
12A	The Customer stickers (PDF) will be added or updated in the supplier application.
11B	Get Customer stickers (label metadata) by sales order ID for a fulfillment request.	GetCustomerStickerMetaData
12B	The Customer stickers (label metadata) will be added or updated in the supplier application and used for printing on customised labels.
13	Financial settlement of the logistic means deposit/rental fee is send to Payment service provider.
14	The Financial settlement of the logistic means deposit/rental fee is processed.

📘
Time out errors
504 (Gateway Timeout) on Fulfillment orders

Despite an initial 504 error, sometimes fulflillment orders can later be successfully committed within the fulfillment-service if the time out is resolved quickly enough;

You can check the status of a placed fulfillment order after the time-out message, when the status is accepted you do not have to replace this fulfillment order, when the status is cancelled you do have to place a new fulfillment order.

Delivery via DC

Purpose:
Delivery of goods to a customer location via a DC.

Prerequisites:

The supplier application has the latest update of organizations;
The supplier application has the latest update of warehouses;
The supplier application has the latest update of additional services;
The supplier application has the latest update of trade-items;
The supplier application has the latest update of batches;
The supplier application has the latest update of delivery orders;
The supplier application has the latest update of fulfillment orders;

Process steps:

NR	Process step	API call / scenario
1	Dispatch of delivery of goods with logistic labels and optional plant passports to a customer location
2	The DC receives the goods and scans the delivery notes.
3	Financial settlement of the service charge by the payment service provider.
4	The DC sends a fulfillment status to Floriday
5	Get fulfillment order status	GetFulfillmentOrderStatusById
6	The retrieved fulfillment order status will be added or updated in the supplier application.

Delivery Direct

Purpose:
Direct delivery of goods to a customer location.

Prerequisites:

The supplier application has the latest update of organizations;
The supplier application has the latest update of warehouses;
The supplier application has the latest update of additional services;
The supplier application has the latest update of trade-items;
The supplier application has the latest update of batches;
The supplier application has the latest update of delivery orders;
The supplier application has the latest update of fulfillment orders.

Process steps:

NR	Process step	API call / scenario
1	Dispatch of delivery of goods with logistic labels and optional plant passports to a customer location
2	The Customer location receives the goods and scans the delivery notes.