Add New Items

In this use case, the Client App will get the new items from GDSN Connect and show the user a list of those items for review. Once accepted, the Client App will create the item records, send the Client App Item IDs to GDSN Connect, and get the full data set for each item.

These new items can be a completely new item (ask the user if they want to set up both an ingredient and stock item) or it can be completely new linked records.

Process Flow

This process provides the basic information about the item to set up the basic record in the Client App, and then syncs the full data through a standard update endpoint.

1. Client App: Request new items

   1. Input

      1. None

   2. Response

      1. List of marked items

      2. Local DEX ID

      3. Item Schema with basic product data attributes from GCDB

         1. Item Name, Pack Size, Manufacturer, Brand, Manufacturer Product ID, GTINs, Net Weight

2. Client App: Review and accept new items.

3. Client App: Add items to Client App and send IDs to GDSN Connect

   1. Input

      1. Local DEX ID

      2. Client App Item ID

   2. Response

      1. Status

4. Client App: Get data for item (this is similar to simply updating the item)

   1. Input

      1. Client App Item ID

   2. Response

      1. Item Schema with enhanced attributes from GCDB

      2. Warnings

Process Flow (Alternate)

When the Item Schema with basic information doesn't include enough attributes to set up the initial record, this alternate approach can be used.

NOTE: Please confirm with inTEAM if this approach is intended to be used.

1. Client App: Request new items

   1. Input

      1. None

   2. Response

      1. List of marked items

      2. Local DEX ID

      3. Item Schema with enhanced attributes from GCDB

      4. Warnings

2. Client App: Review and accept new items

3. Client App: Add items to Client App and send Client App IDs to GDSN Connect

   1. Input

      1. Local DEX ID

      2. Client App Item ID

   2. Response

      1. Status