Trade items
Supported trade item scenarios
- Receiving trade items;
- Selecting and deselecting trade items;
- Receiving selected trade items.
For the business rules concerning trade items, please read Trade items and Selected trade items.
Receiving trade items
Purpose:
Synchronise trade items from Floriday in customer application.
Prerequisites:
- The customer application has the latest update of connections.
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Receive all trade items by SupplierId. | GetTradeItems |
| 2 | Receive all trade items by TradeItemId. | GetTradeItemById |
| 3 | Receive all trade items by TradeItemId and version. | GetTradeItemByIdAndVersion |
| 4 | Receive your maximum found sequence number. | GetTradeItemsMaxSequence |
| 5 | Receive modified trade items from all the suppliers in your network with a maximum of 1000 based on your given sequence number. Repeat until your given sequence number is the same as maximum found sequence number. | GetTradeItemsBySequenceNumber |
Selecting trade items via the Floriday API
Selecting trade items
There are four ways to select trade items as a customer:
- Select trade items on the platform Floraxchange by adding the trade item to a week list;
- Select trade items on the buyers platform Flordiday by marking the trade item as a favourite;
- Enable suppliers to mark their trade items as your selected trade items by enabling this in the system settings on the Floriday platform;
- Select trade items via the Floriday API.
Purpose:
Selecting trade items from Floriday suppliers in customer application.
Prerequisites
All trade items of the connected suppliers have been received and saved;
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Select a specific trade item by using the right TradeItemId. | AddSelectedTradeItem |
| 2 | Add a packing configuration to the selected trade item. | SetSelectedTradeItemPackingConfiguration |
| 3 | Set the SelectedTradeItemPackingConfiguration as primary for the given supplier. | SetSelectedTradeItemPackingConfigurationPrimary |
Deselecting trade items via the Floriday API
Purpose:
Deselecting trade items from Floriday suppliers in customer application.
Prerequisites
Trade items of the connected suppliers have been received and saved en used for deselection.
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Deselect a specific trade item by using the right TradeItemId. | DeleteSelectedTradeItem |
| 2 | Deselect multiple trade items by using the right TradeItemId's. | DeleteSelectedTradeItems |
Receiving selected trade items
Purpose:
Synchronise selected trade items from Floriday in customer application.
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Receive your maximum found sequence number. | GetSelectedTradeItemsMaxSequence |
| 2 | Receive the selected trade items based on the provided sequence number. | GetSelectedTradeItemsBySequenceNumber |
| 3 | Receive the modified selected trade items based on the provided sequence number by filtering out all the non selected trade items with the parameter PostFilterSelectedTradeItems on true. | GetTradeItemsBySequenceNumber |
| 4 | - All the non-selected trade items will be filtered out of the completed call; - Postfilters are executed after receiving the entire response within the given limit. |
Updated 5 months ago