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.

Proces 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.

Proces 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.

Proces 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.

Proces 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.

Proces 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.

Proces 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.

Proces 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.


Did this page help you?