Единицы измерения

Интеграция единиц измерения между V5 Traceability и системой ERP клиента позволяет отправлять единицы измерения, используемые системой ERP/третьей стороной, в V5 Traceability. Затем эти единицы можно применять для складирования и формулирования/производства в системе V5 Traceability.

Гибкость системы V5 Traceability позволяет полностью настраивать единицы измерения с возможностью установки пользовательских преобразований единиц для больших количеств, таких как ящики и бочки, а также устанавливать коэффициенты преобразования для конкретных товаров. Конкретные коэффициенты преобразования особенно полезны для товаров с определенной плотностью, как мы увидим в примере ниже.

Для классов «WeightUnit» и «UnitCommodity», которые мы здесь рассмотрим, доступен только импорт; экспорт недоступен ни через методологии JSON, ни через CSV.

Более подробную информацию о том, как работают единицы измерения в V5 Traceability, см. в нашем руководстве по модулю. здесь.

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

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

Если запись на нижней панели отсутствует для данного товара, то система вернется к курсу конвертации, установленному на верхней панели, когда товар используется с этой единицей. После того, как товар добавлен на нижней панели и к нему добавлен курс конвертации ('UnitCommodity'), это затем переопределяет курс конвертации на верхней панели.

 

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

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

Вес Ед.

Единица

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

Шаблон интеграции для UnitCommodity (коэффициенты конверсии для конкретных товаров) можно загрузить здесь.

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

Для пакетов Вес Ед., это:

код – Уникальный код единицы измерения (например, г, кг, фунт, унция и т. д.)

Для пакетов Единица, первичные ключи:

unit.код – уникальный код единицы измерения, как указано выше.

и

Код товара – Уникальный код товара, к которому применяется определенный коэффициент конвертации.

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

Для пакетов ВесЕдиница:

конверсия – Коэффициент конвертации для данной единицы по отношению к единице с идентификатором 1 в базе данных.

Для пакетов Единица:

конверсия – удельный коэффициент конверсии для конкретного товара.

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

описание – описание единицы (килограммы, фунты и т. д.)

Дополнительные поля также могут быть включены для Вес Ед., Таких как:

ноты – любые дополнительные примечания по блоку

Учитывая относительно простую природу этого класса, мы можем использовать интеграцию JSON или CSV для импорта единиц в V5. Мы рассмотрим это с точки зрения выполнения начального импорта для внесения любых недостающих единиц в систему (weightUnit), после чего мы назначим товарно-специфические преобразования с использованием единиц в системе (UnitCommodity). Обратите внимание еще раз, что экспорт недоступен ни для одной конечной точки/класса.

Конечная точка/URI импорта ''WeightUnit' –

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

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

Образцы:

Для этого примера импорта мы будем использовать конечную точку 'WeighUnit' для добавления фунтов и унций в таблицу единиц Control Center, показанную выше во введении. Файл JSON для этого будет выглядеть следующим образом:

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

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

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

Для класса «WeightUnit» экспорт JSON недоступен.

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

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

Импортировать имя файла CSV: «weightUnit-datetime.csv»

CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»

Образцы:

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

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

Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции.

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

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

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

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

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

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

Как и в случае с экспортом JSON, экспорт CSV для класса «WeightUnit» недоступен.

Конечная точка/URI импорта «UnitCommodity» –

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

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

Образцы:

Для этого примера импорта мы будем использовать конечную точку 'UnitCommodity', чтобы добавить определенную единицу преобразования для литров молока. Мы видели в Центре управления выше, что литры обычно конвертируются в соотношении 1:1 из литров в кг, т. е. 1 литр воды весит 1 кг. Однако литр молока будет весить немного больше (1.035 кг), поэтому ниже мы увидим, как настроить это для импорта JSON.

Таким образом, мы сообщаем системе, что при использовании молока будет использоваться коэффициент преобразования 1.035, переопределяющий коэффициент преобразования по умолчанию для единицы измерения «литр».

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

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

Для класса «UnitCommodity» экспорт JSON недоступен.

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

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

Импортировать имя файла CSV: «unitCommodity-datetime.csv»

CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»

Образцы:

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

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

Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции.

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

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

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

Здесь мы видим, что мы создаем то же самое преобразование единиц товара, что и в примере JSON выше.

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

После завершения импорта мы видим, что снова было создано новое преобразование единиц измерения для конкретного товара.

Как и в случае с экспортом в формате JSON, экспорт в формате CSV для класса «UnitCommodity» недоступен.