Сырьевые товары

Интеграция товаров (ингредиентов/упаковки/сырья/артикулов) между V5 Traceability и ERP-системой клиента позволяет отправлять в V5 Traceability сведения о товарах, такие как стоимость, единицы, срок годности по умолчанию и т. д.

1. Компоновка центра управления
2. Ссылки API
3. Шаблон интеграции
4. Справочник по товарам
   1. Первичные ключи
   2. Обязательные поля
   3. Предпочтительные поля
   4. Дополнительные поля
5. Методология
   1. JSON — импорт
   2. JSON — Экспорт
   3. CSV – Импорт
   4. CSV — Экспорт

Что касается связи товаров с тем, что мы видим в Центре управления , то здесь нам нужно заполнить только одну панель — главное окно с товарами.

 

Используя шлюз V5, мы можем легко заполнить данные здесь, используя одну конечную точку.

Чтобы узнать больше об определениях этих классов базы данных, перейдите по следующей ссылке:

Commodities

Шаблон интеграции для Commodities могут быть загружены здесь.

Первичные ключи — это уникальный идентификатор для каждой таблицы в V5 API. Для Commodities, это:

code – Уникальный идентификационный код для каждого товара.

Другими полями, которые необходимы SG для заполнения действительной товарной строки в Центре управления, являются:

units.code – Единица измерения запаса товара по умолчанию.

type – Тип товара (ингредиент (0), формула (1) или упаковка (2)).

recordStock – Следует ли отслеживать использование этого товара с помощью V5 Traceability (не записывается (0) или записывается (1)).

Предпочтительные поля служат для добавления дополнительной информации о рассматриваемом товаре, и, хотя они и не обязательны, они полезны, когда речь идет о дополнительных функциях в рамках V5 Traceability.

description – Описание товара.

bulkUnit - объемная единица товара (например, «Мешок» или «Коробка»).

bulkQuantity – Количество единиц измерения по умолчанию (units.code) товара входит в указанную выше оптовую единицу (например, «20» для этого и «Мешок», введенное для оптовых единиц, с единицей по умолчанию «фунт» означает в 1 мешке этот товар есть 20lbs).

Также могут быть включены дополнительные поля, например:

cost – Стоимость по умолчанию (за единицу) товара.

defExpiryDays - Количество дней по умолчанию с момента получения, по истечении которого товарно-материальные запасы этого типа будут установлены для истечения срока действия.

gtin - GTIN товара.

Учитывая, что мы используем только одну конечную точку для этого класса объектов, мы можем использовать конечную точку «товар» для импорта и экспорта JSON и CSV. Теперь мы можем посмотреть на это ниже.

Commodity:

‘Commodity’ импортировать конечную точку/URI –

http://host:port/V5-API/api/integrate/import/commodity

Описание конечной точки

Для этого примера импорта мы будем использовать ‘Commodity’ конечная точка и структурирование базового файла импорта для одного товара, это может выглядеть примерно так:

Этот пример JSON-файла можно скачать здесь.

Здесь мы видим пример использования вложенных классов, связанных с ‘Commodity’ конечная точка. В этом случае мы включили отступ ‘units’ и ‘bulkUnit’ точки данных, что позволяет нам определить как единицу измерения товара по умолчанию, так и его массовую единицу. Поскольку оба они используют ‘WeightUnit’ class, мы можем использовать руководство V5 API, чтобы найти эти точки данных, используя следующий путь:

Мы можем создать остальные необходимые нам точки данных, используя аналогичный метод поиска пути для перехода к дополнительным классам, таким как ‘Location’ or ‘Container’ как требуется.

Если бы мы импортировали приведенный выше пример файла, мы бы увидели в Центре управления, что наш товар был импортирован.

Что касается получения файлов, относящихся к товарам, обратно из V5 API, если мы проверим сводку методов в разделе IntegrationExport класс, у нас есть 2 разных варианта:

Commodity:

Экспорт конечной точки/URI –

http://host:port/V5-API/api/integrate/export/commodity/{code}

Описание конечной точки

Эта конечная точка будет экспортировать файл JSON со всей связанной информацией для определенного товара. Если мы запустим этот запрос, используя только что импортированный товар, мы получим файл, который выглядит примерно так:

Пример JSON-файла можно скачать здесь.

Commodities:

Экспорт конечной точки/URI –

http://host:port/V5-API/api/integrate/export/commodites/{all}

Описание конечной точки

Эта конечная точка будет экспортировать файл JSON, который включает список всей связанной информации для всех товаров в системе в зависимости от значения параметра {all} поле. Если это ‘true’ то мы будем тянуть все товары, а если ‘false’ тогда мы просто получим прибыль за новые товары (то есть товары, которые не отмечен как уже экспортированный).

Если мы запустим этот запрос как true , мы получим файл, который выглядит примерно так:

Пример JSON-файла можно скачать здесь.

Имя файла определения заголовка/столбца: “commodity.csvh”

Готовые заголовочные файлы должны быть размещены в: “<installdir>\SG Control Center\gateway\import\column_defs”

Импортировать имя файла CSV: “commodity-datetime.csv”

CSV для импорта должны быть размещены в: “<installdir>\SG Control Center\gateway\import”

Заголовочный файл:

Файлы заголовков, как правило, компилируются SG Systems до интеграции CSV, но мы можем увидеть базовый пример того, что мы можем использовать для товаров ниже:

Для получения более подробной информации о структуре этих файлов, пожалуйста, посетите главную страницу интеграции . Пример заголовочного файла можно скачать здесь.

Файл импорта CSV:

Затем мы можем использовать определенный порядок точек данных в заголовке, чтобы структурировать наш файл импорта. SG Systems может предоставить для этого файл шаблона, в котором перечислены точки данных для каждого столбца, чтобы было понятнее при заполнении списка. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и поэтому может быть сохранена в файле при отправке на импорт.

Пример файла импорта csv с использованием приведенного выше заголовка может выглядеть примерно так:

Этот пример файла импорта можно скачать здесь.

После завершения импорта мы видим, что эти товары были добавлены в Центр управления.

При экспорте товаров этим методом мы будем использовать те же определения классов, что и при импорте, которые можно найти здесь.

Имя файла определения заголовка/столбца: “commodity.csvh”

Готовые заголовочные файлы должны быть размещены в: “<installdir>\SG Control Center\gateway\export\order”

Экспортировать имя файла CSV: “Commodity-datetime.csv”

CSV для экспорта будут созданы в: “<installdir>\SG Control Center\gateway\export”

Этот экспорт также необходимо включить в разделе «Шлюз» Центра управления. Мы можем выбрать здесь, чтобы экспортировать только ‘Ingredients’ (ингредиенты/упаковка), или формулы, или и то, и другое. Здесь мы просто рассмотрим экспорт ‘Ingredients’ :

Заголовочный файл:

Отсюда будет простой случай структурирования нашего файла заголовка экспорта в соответствии с тем, какую информацию мы хотим получить обратно из системы.

Мы могли бы структурировать его очень похоже на то, как мы структурировали заголовок импорта:

Этот пример заголовочного файла можно скачать здесь.

Файл экспорта CSV:

Имея указанный выше заголовок, мы получим возвращаемый CSV-файл для наших недавних импортированных операций, который будет выглядеть примерно так:

Этот пример файла экспорта можно скачать здесь.