Трансферы
Ваш путеводитель по интеграции V5!
Интеграция переводов между V5 Traceability и ERP-системой клиента позволяет отправлять в V5 Traceability детали перевода, позиции переноса и информацию о планировании. Эти передачи затем можно отправлять и получать через программное обеспечение V5 WMS, после чего информация о том, какие партии были отправлены и получены, сколько было отправлено, на каком поддоне это было и т. д. может быть отправлена обратно в ERP.
В этом случае V5 также может выступать в качестве мастера данных и отправлять в ERP переносы, созданные в системе.
Дополнительную информацию о том, как работает модуль передачи в V5 Traceability, можно найти в нашем руководстве по модулю. здесь.
Содержание
1. Схема центра управления
С точки зрения того, как мы можем относиться ‘Transfers’ и ‘Transfer Lines’ к тому, что мы видим в Центре управления, мы видим, что верхняя панель здесь предназначена для трансферов, где можно импортировать места на/с сайтов, внешние ссылочные номера и т. д.
В нижней левой панели мы можем добавить наши линии передачи, содержащие данные, относящиеся к товарам и количествам, необходимым для передачи.
Используя V5 Gateway, мы можем легко заполнить обе панели как по отдельности, так и вместе.
В нижней правой панели хранятся данные о том, откуда предметы при передаче были выбраны в месте «от» и получены в месте «куда». Эти данные станут частью экспорта, который мы сможем получить обратно от шлюза V5.
2. API-ссылки
Чтобы узнать больше об определениях этих классов базы данных, перейдите по следующим ссылкам:
3. Шаблон интеграции
Шаблон интеграции для Трансферов можно скачать здесь.
4. Полевое руководство по трансферам
4.1. Первичные ключи
Первичные ключи — это уникальный идентификатор для каждой таблицы в V5 API. Для Transfers, это:
reference – Уникальный ссылочный номер для перевода. По сути, номер передаточного ордера.
Для пакетов TransferLines, первичный ключ или:
reference + commodity.code – Номер/номер передачи вместе с передаваемым товаром.
or
lineID – В расширенных целях, когда один и тот же товар может отображаться в нескольких строках, вы можете указать идентификатор строки в качестве уникального идентификатора вместо ссылки на передачу и кода товара. Это необходимо, если в передаче более 1 строки одного и того же товара.
4.2. Обязательные поля
Другие поля, которые требуются SG для заполнения действительной записи в Центре управления:
Для пакетов TransferLines:
quantityOrdered - количество заказанного товара.
Для пакетов Transfers:
fromLocation.code – место, откуда будет отправлен перевод.
toLocation.code – место, куда будет отправлен перевод.
4.3. Предпочтительные поля
Предпочтительные поля служат для добавления дополнительных данных в передачу и, хотя и не являются обязательными, полезны, когда речь идет о функциональности в рамках V5 Traceability. Это:
lineID – если не используется в качестве первичного ключа выше, это поле должно быть включено.
commodity.code – если это поле не используется в качестве первичного ключа выше, оно должно быть включено. Код товара, который необходимо передать.
transfer.reference – если не используется в качестве первичного ключа выше, это поле должно быть включено.
Вышеизложенное относится к «transferLines’. Мы можем применить те же поля к «transfers' добавлением ‘transferLine’ к первым двум записям и удалив ‘transfer’ из последнего.
4.4. Дополнительные поля
Также могут быть включены дополнительные поля, например, для ‘transfer’:
comment – любые дополнительные комментарии к переводу.
fromAddress – адрес, с которого отправляется перевод. Они заселены в ‘Site Addresses‘.
toAddress – адрес, по которому был получен перевод.
directTransfer – должен ли этот трансфер быть прямой перевод или нет.
Аналогично описанному выше, если создать 'transferLine’, мы можем просто перейти к классу передачи, добавив ‘transfer’ в начало вышеуказанных параметров.
5. Методология
Учитывая характер ‘Transfer’ и ‘TransferLine’, мы можем выбрать импорт данных двумя способами:
- Мы можем использовать ‘Transfer’ конечную точку для импорта переводов, а затем, как мы увидим ниже, перейдите к ‘TransferLine’ class, чтобы затем включить все позиции компонента в один файл. Это наиболее логичный способ импорта целых переводов, поскольку для него требуется только один набор информации заголовка, а затем последующие позиции. Обратите внимание, что это также единственная конечная точка, которую мы можем использовать для изменения информации заголовка для передачи.
- Мы можем использовать ‘TransferLine’ конечная точка для изменения или добавления строк переноса после создания переноса. Это по-прежнему можно использовать для импорта целых переводов, но он менее эффективен, поскольку каждая позиция строки переноса должна будет содержать вложенную ссылку на заголовок перевода (например, ссылку). Как указано выше, эту конечную точку нельзя использовать для внесения изменений в информацию заголовка передачи (ссылка/в и из местоположений и т. д.).
Какие из этих конечных точек мы будем использовать, во многом будет зависеть от того, используем ли мы импорт JSON или CSV. Теперь мы можем посмотреть на них ниже.
5.1. JSON — Импорт
Перемещение:
‘Transfer’ импортировать конечную точку/URI –
http://host:port/V5-API/api/integrate/import/transfer
Для этого примера импорта мы будем использовать ‘Transfer’ конечную точку и структурирование базового файла импорта передачи с двумя строками, это может выглядеть примерно так:
Этот образец файла JSON можно загрузить здесь.
Мы можем понять, почему мы будем использовать ‘Transfer’ конечная точка для этого формата, учитывая способность файлов JSON хранить вложенные данные, что позволяет нам включать отступы ‘TransferLines’ списки, а затем ‘Commodity’ точки данных в импорте, которые можно определить с помощью руководства SG API. Например, ‘commodity code’ точку данных можно найти, используя следующий путь в руководстве по API:
Мы можем создать остальные необходимые точки данных, используя аналогичный метод поиска пути.
Используя приведенный выше файл, мы видим, что наш новый трансфер создан в Центре управления.
Линии передачи:
‘TransferLine’ импортировать конечную точку/URI –
http://host:port/V5-API/api/integrate/import/transfer_line
Как обсуждалось выше, мы можем использовать ‘TransferLine’ конечная точка для добавления или редактирования строк существующей передачи. Мы также можем добавлять передачи, используя эту конечную точку, но важно помнить, что мы можем редактировать заголовок передачи только с помощью ‘Transfer’ URI выше. Также обратите внимание, что информация о переводе должна быть вложена сюда для каждой строки перевода.
Мы можем увидеть пример ‘TransferLine’ JSON-файл ниже, куда мы добавим еще одну строку для передачи ‘TR-1882’ который мы создали выше:
Этот образец файла JSON можно загрузить здесь.
Как только этот запрос будет опубликован, мы сможем вернуться в Центр управления и увидеть, что к этой передаче добавлена третья строка.
5.2. JSON — Экспорт
Что касается получения файлов, относящихся к переводам, обратно из API V5, если мы проверим сводку методов в разделе ‘IntegrationExport‘ class, то здесь у нас есть несколько разных вариантов:
Трансферы:
Экспорт конечной точки/URI –
http://host:port/V5-API/api/integrate/export/transfers
Эта конечная точка будет экспортировать файлы JSON полной передачи с использованием класса базы данных передачи и будет включать в себя каждую передачу, которая еще не была помечена системой как экспортированная или была изменена с момента ее первого экспорта. Это не будет включать какие-либо данные о движении запасов, а скорее предоставит возврат для каждой точки данных в ‘Transfer’ класса.
Пример этого типа файла JSON можно скачать. здесь.
Перемещение:
Экспорт конечной точки/URI –
http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}
Эта конечная точка будет экспортировать файлы JSON полной передачи с использованием класса базы данных передачи, но только для указанной передачи и только в том случае, если эта передача еще не была помечена системой как экспортированная. Как указано выше, это не будет включать какие-либо данные о движении запасов, а скорее предоставит возврат для каждой точки данных в ‘Transfer’ класса.
Пример этого типа файла JSON можно скачать. здесь.
Мы также можем использовать конечные точки транзакций и журналов для получения более актуальной информации о товарах, полученных по заказам на поставку.
Для трансферов у нас есть 1 Системный журнал конечная точка, которую мы можем использовать:
Системные журналы:
Экспорт конечной точки/URI –
http://host:port/V5-API/api/integrate/export/system_logs
Использование этой конечной точки вернет полный список событий системного журнала, которые не были помечены как экспортированные ранее. Более подробную информацию об этой конечной точке можно найти здесь. Эти результаты можно фильтровать для поиска конкретных трансферов. дескрипторы, Такие, как ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ и ‘PALLET TRANSFER OUT/IN’.
Пример этого типа файла JSON можно скачать. здесь.
5.3. CSV – Импорт
Обратите внимание, что для импорта CSV мы обычно используем только ‘TransferLine’ конечная точка, позволяющая нам создавать трансферы и их отдельные позиции с помощью одного импорта CSV.
Имя файла определения заголовка/столбца: “transferLine.csvh”
Готовые заголовочные файлы должны быть размещены в: “<installdir>\SG Control Center\gateway\import\column_defs”
Импортировать имя файла CSV: “transferLine-datetime.csv”
CSV для импорта должны быть размещены в: “<installdir>\SG Control Center\gateway\import”
Заголовочный файл:
Файлы заголовков обычно компилируются SG Systems до интеграции CSV, но мы можем увидеть базовый пример того, который мы можем использовать для передачи ниже:
Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции. Этот образец заголовочного файла можно загрузить здесь.
Файл импорта CSV:
Затем мы можем использовать определенный порядок точек данных в заголовке, чтобы структурировать наш файл импорта. SG Systems может предоставить для этого файл шаблона, в котором перечислены точки данных для каждого столбца, чтобы было понятнее при заполнении списка. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и поэтому может быть сохранена в файле при отправке на импорт.
Здесь мы видим, что мы стремимся создать передачу, аналогичную тому, что мы создали, используя методологию JSON. Этот образец файла импорта можно скачать здесь.
После завершения импорта мы видим, что этот перенос вместе с необходимыми позициями был добавлен в Центр управления. Обратите внимание, что если ‘Created Date’ данные не включаются в импорт, размещенная дата будет ссылаться на сегодняшнюю дату.
5.4. CSV — Экспорт
При экспорте информации о переводе с помощью этого метода это будет частью ‘SystemLog’ экспорт. Мы можем видеть определения классов для этой конечной точки здесь.
Имя файла определения заголовка/столбца: “SystemLog.csvh”
Готовые заголовочные файлы должны быть размещены в: “<installdir>\SG Control Center\gateway\export\order”
Экспортировать имя файла CSV: “SystemLog-datetime.csv”
CSV для экспорта будут созданы в: “<installdir>\SG Control Center\gateway\export”
Эту конечную точку можно использовать для извлечения самых разных данных путем обхода доступных точек данных, связанных с ней.
Заголовок:
Мы можем использовать точки данных, такие как ‘user’, ‘timestamp’ и ‘quantity’ на этой вершине ‘System Log’ уровень, но затем мы можем перейти на ‘TransferLine’ класс для добавления полей, таких как номер ссылки и товары, которые были запрошены при передаче, а также в ‘Stock’ класс для получения такой информации, как места, из которых или в которые были перемещены элементы.
На самом базовом уровне наша часть заголовка системного журнала, касающаяся передач, может выглядеть примерно так:
Этот образец заголовочного файла можно загрузить здесь.
Имея этот заголовок, мы также должны убедиться, что мы выбрали экспорт. ‘System Logs’ на вкладке экспорта шлюза в Центре управления.
С нашим заголовком и включенным экспортом (не забудьте перезапустить Центр управления, чтобы применить любые изменения, внесенные в шлюз!), мы впоследствии получим файл возврата для этой передачи (наряду с любыми другими ранее неэкспортированными передачами), который выглядит следующим образом: этот:
