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

Интеграция товаров (ингредиентов/упаковки/сырья/артикулов) между 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-файл для наших недавних импортированных операций, который будет выглядеть примерно так:

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