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 imageURL s.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 imageURL s. | 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 about 1 year ago