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

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:

NRProcess stepAPI call / scenario
1Get changed trade items since last sequence number. Repeat step until all trade items are synchronisedGetTradeItemsBySequenceNumber
2Get highest generated sequence number.GetTradeItemsMaxSequence
3Process 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.
3Get trade item images by imageURL.
4Process 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:

NRProcess stepAPI call / scenario
1Create one or more images.AddImage
2Create 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.
3The new trade item will be added to the Supplier organization catalog in the Customer channel if hiddenfromcustomer is false.
4The 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:

NRProcess stepAPI call / scenario
1Soft delete an existing trade item with an unique tradeItemIdDeleteTradeItem
The trade item will be soft deleted from the Supplier organization catalog in Floriday.
2The trade item will be soft deleted from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false.
3The 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:

NRProcess stepAPI call / scenario
1Update 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.
2The trade item will be updated from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false
3The 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:

NRProcess stepAPI call / scenario
1Delete a trade item.DeleteTradeItem
2Create a trade item.AddTradeItem

Interaction model Trade item variants

2246

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:

NRProcess stepAPI call / scenario
1Create 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
3The new trade item will be added to the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false.
4The 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:

NRProcess stepAPI call / scenario
1Update 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.
2The trade item will be updated from the Supplier organization catalog in the Customer channel if hiddenFromCustomer is false.
3The trade item will be updated by the Customer channel for the Customer organization.