Trade items
Supported Trade-item scenarios
- Sync Trade items
- Create trade items
- Delete trade items
- Update trade items
- Change trade items
Sync Trade items
Purpose:
Synchronise trade items from Floriday in supplier application.
Prerequisites:
- The supplier application has the latest update of organizations.
- The supplier application has the latest update of custom packages.
- The supplier application has the latest update of base items.
- The user has inserted trade items in the Floriday catalog.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Get changed trade items since last sequence number. Repeat step until all trade items are synchronised | GetTradeItemsBySequenceNumber |
| 2 | Get highest generated sequence number. | GetTradeItemsMaxSequence |
| 3 | Process the retrieved trade items with the trade items in the supplier application with their unique tradeItemId and tradeItemVersion and trade-item details including one or more imageURLs.The trade items will be added, updated or deleted in the supplier application. | |
| 3 | Get trade item images by imageURL. | |
| 4 | Process the retrieved images. |
Create Trade items
Purpose:
Creating new trade items from supplier application in Floriday.
Prerequisites:
- The supplier application has the latest update of organizations.
- The supplier application has the latest update of custom packages.
- The supplier application has the latest update of base items.
- The user has inserted a trade item in the supplier application.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Create one or more images. | AddImage |
| 2 | Create a new trade item with an unique tradeItemId and trade item details including one or more imageURLs. | AddTradeItem |
| The new trade item is validated by Floriday and will be added to the Supplier organization catalog in Floriday. | ||
| 3 | The new trade item will be added to the Supplier organization catalog in the Customer channel if hiddenfromcustomer is false. | |
| 4 | The new trade item can be retrieved by the Customer organization from the Customer channel. |
Delete Trade items
Purpose:
Deleting trade items from supplier application in Floriday.
Prerequisites:
- The supplier application has the latest update of trade items;
- The user is deleting a trade item in the supplier application.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Soft delete an existing trade item with an unique tradeItemId | DeleteTradeItem |
| The trade item will be soft deleted from the Supplier organization catalog in Floriday. | ||
| 2 | The trade item will be soft deleted from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false. | |
| 3 | The trade item will be soft deleted by the Customer channel for the Customer oranization. |
Update Trade items
Purpose:
Updating the trade item in Floriday.
Prerequisites:
- The supplier application has the latest update of organizations;
- The supplier application has the latest update of custom packages;
- The supplier application has the latest update of base items;
- The supplier application has the latest update of trade items;
- The user has updated the trade item in the supplier application.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Update a trade item with an unique `tradeItemId. | EditTradeItem |
The trade item will be updated in the Supplier organization catalog in Floriday and get a new tradeItemVersion. | ||
| 2 | The trade item will be updated from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false | |
| 3 | The trade item will be updated by the Customer channel for the Customer organization. |
Change Trade items
Purpose:
Fundamentally change the trade item in Floriday.
Prerequisites:
- The supplier application has the latest update of organizations;
- The supplier application has the latest update of custom packages;
- The supplier application has the latest update of base items;
- The supplier application has the latest update of trade items;
- The user has fundamentally changed the trade item in the supplier application.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Delete a trade item. | DeleteTradeItem |
| 2 | Create a trade item. | AddTradeItem |
Interaction model Trade item variants
Supported Trade item scenarios:
- Create trade item variants;
- Update trade item variants.
Create Trade item variants
Purpose:
Create new trade item variants in Floriday.
Prerequisites:
- The supplier application has the latest update of organizations;
- The supplier application has the latest update of custom packages;
- The supplier application has the latest update of base items;
- The supplier application has the latest update of trade items;
- The user has inserted a trade item variants in the supplier application with different product characteristics and/or country of origin.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Create a new trade item variant with an unique tradeItemId with different product characteristics and reference to the parentId. | AddTradeItemVariant |
The new trade item variant is validated by Floriday and will be added to the Supplier organization catalog in Floriday as a new trade item with an unique tradeItemId and a reference to the parentId with a unique supplierArticleCode containing the parent supplierArticleCode +'additional string'. The parent Trade item is updated with isParentForVariant is true. | ||
Get and process created trade item variant with unique tradeItemId, tradeItemVersion, supplierArticleCode and trade item details. | GetTradeItemById | |
| 3 | The new trade item will be added to the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false. | |
| 4 | The new trade item can be retrieved by the Customer organization from the Customer channel. |
Update Trade item variants
Purpose:
Updating trade item variants in Floriday.
Prerequisites:
- The supplier application has the latest update of organizations;
- The supplier application has the latest update of custom packages;
- The supplier application has the latest update of base items;
- The supplier application has the latest update of trade items;
- The user has updated the trade item variant characteristics and/or country of origin in the supplier application.
Process steps:
| NR | Process step | API call / scenario |
|---|---|---|
| 1 | Update a trade item variant with an unique tradeItemId characteristics and/or country of origin. | EditTradeItemVariant |
The trade item variant will be updated in the Supplier organization catalog in Floriday and get a new tradeItemVersion. | ||
| 2 | The trade item will be updated from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false. | |
| 3 | The trade item will be updated by the Customer channel for the Customer organization. |
Updated almost 2 years ago