GuidesChangelog
HomeLog In
Guides
These docs are for v2023.1. Click to read the latest docs for v2024.2.

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:

NRProcess stepAPI call / scenario
1Get highest generated sequence number.GetDeliveryOrdersMaxSequence
2Sync delivery orders by latest sequence number.GetDeliveryOrdersBySequenceNumber
Process the retrieved delivery orders in the supplier application with their unique delivery order ID
3The retrieved batches will be added or updated in the supplier application with the new batch IDs.
4Get the package stickers as a PDF for the delivery order.GetTrayLabelsAsPdfById
5The retrieved stickers will be added or updated in the supplier application.
6 (Not yet supported)Get plant passports (optional)
7 (Not yet supported)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.

NRProcess stepAPI call / scenario
1Get highest generated sequence number.GetDeliveryLocationMaxSequence
2Sync 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:

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

NRProcess stepAPI call / scenario
1Dispatch of delivery of goods with logistic labels and optional plant passports to a customer location
2The DC receives the goods and scans the delivery notes.
3Financial settlement of the service charge by the payment service provider.
4The DC sends a fulfillment status to Floriday
5Get fulfillment order statusGetFulfillmentOrderStatusById
6The 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:

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