Guides

Supply lines

We define a supply line as a trade item that is marketed at a specific price and period during which a customer is allowed to purchase it.

Supply lines are a basis to create and process sales orders. We recommend syncing all supply lines a supplier organization has made and to make a distinction between Direct sales Supply lines and Clock (pre sales) Supply lines. These are seperate entities and should be treated as such during the implementation. The difference between the various Supply line types are listed on the Supply page.

Below is an instruction of how to retrieve Supply lines in general, using the Sync endpoint and the Get endpoint. In the following chapters you can read how to implement the different types of Supply lines.

📘

Sync vs Get

This page describes how to utilize both the Sync and non-sync Get endpoints. We strongly recommend using the Sync endpoints whenever possible.

Read the Best Practices for more information.



Sync Supply-lines


Purpose

To Sync Supply lines from Floriday to the supplier application.



Prerequisites

The following models must be present in your system in order to fully process a supply line.

  • Organizations, these determine for which customer(s) the supply line is available and which supplier is the owner.
  • TradeItems, which contains the specific product information for which the supplyline has been offered.
  • Batches, which is required when the supply is based on an existing batch. Take note: Batches may contain batch-specific values that override the tradeItem data.
  • Note that you will only receive supply lines when the supplier organization works with one of the following flows via Floriday (Portal and/or API)
    • Catalog base supply;
    • Batch base supply;
    • Weekly lines;
    • Customer offer;
    • Supply and Order requests.



Process steps

NRProcess stepAPI call / scenario
1Get highest generated sequence number.GetSupplyLinesMaxSequence
1Sync supply lines with limit and latest sequence number. Supply has supply type 'catalog price'.GetSupplyLinesBySequenceNumber
2Process the retrieved supply lines in the supplier application with their unique supply line ID. The supply lines will be added, updated or deleted in the supplier application.
The supply lines are a basis to create and process sales orders.


Get Supply lines


Purpose

To retrieve Supply lines within a given timeframe from Floriday to the supplier application.



Prerequisites

The following models must be present in your system in order to fully process a supply line.

  • Organizations, these determine for which customer(s) the supply line is available and which supplier is the owner.
  • TradeItems, which contains the specific product information for which the supplyline has been offered.
  • Batches, which is required when the supply is based on an existing batch. Take note: Batches may contain batch-specific values that override the tradeItem data.
  • Note that you will only receive supply lines when the supplier organization works with one of the following flows via Floriday (Portal and/or API)
    • Catalog base supply;
    • Batch base supply;
    • Weekly lines;
    • Customer offer;
    • Supply and Order requests.


Process steps

NRProcess stepAPI call / scenario
1 AReturns supply lines created within the given timeframe.GetSupplyLines
1 BReturns a supply line based on ID.GetSupplyLineById
2Process the retrieved supply lines in the supplier application with their unique supply line ID. The supply lines will be added, updated or deleted in the supplier application.
The supply lines are a basis to create and process sales orders.