Заказы

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

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

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

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

 

Затем на нижнюю панель мы можем добавить наши строки заказа на покупку, содержащие данные, относящиеся к товарам, количествам и стоимости строк заказа.

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

Нижняя правая панель содержит данные, относящиеся к тому, где товары в заказе на покупку собираются и хранятся при обработке заказа на покупку. Эти данные станут частью экспортируемых данных, которые мы можем получить от шлюза.

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

Purchase Orders

Purchase Order Lines

Шаблон интеграции для заказов на покупку можно скачать здесь.

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

purchaseOrder.orderNumber – номер ПО.

До Purchase Order Lines, первичный ключ или:

purchaseOrder.orderNumber + commodity.code – номер заказа вместе с товаром, который нужно заказать

or

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

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

quantity - количество заказанного товара.

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

lineID – если не используется в качестве первичного ключа выше, это поле должно быть включено.

commodity.code – если не используется в качестве первичного ключа выше, это поле должно быть включено.

purchaseOrder.orderNumber – если не используется в качестве первичного ключа выше, это поле должно быть включено.

purchaseOrder.supplier.code – уникальный код, используемый для идентификации поставщика.

purchaseOrder.placedDate – дата размещения заказа.

purchaseOrder.deliveryDate – установленная дата доставки заказа.

unit – ЕИ заказываемого товара.

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

purchaseOrder.notes – любые примечания к ЗП.

cost – стоимость (за единицу) заказываемого товара.

Учитывая характер PurchaseOrder и PurchaseOrderLine , мы можем выбрать импорт данных двумя способами:

1. Мы можем использовать конечную точку PurchaseOrder для импорта заказов на покупку, а затем, как мы увидим ниже, перейти к классу PurchaseOrderLine, чтобы затем включить все позиции компонента в один файл. Это наиболее логичный способ импорта целых заказов, поскольку для него требуется только один набор информации заголовка, а затем последующие позиции. Обратите внимание, что это также единственная конечная точка, которую мы можем использовать для изменения информации заголовка заказа на покупку.
2. Мы можем использовать конечную точку PurchaseOrderLine для изменения или добавления строк после создания заказа. Это по-прежнему можно использовать для импорта целых заказов, но оно менее эффективно, поскольку каждая позиция заказа должна будет содержать вложенную ссылку на заголовок заказа на покупку (например, номер заказа). Как указано выше, эту конечную точку нельзя использовать для внесения изменений в информацию заголовка заказа (номер заказа/даты доставки и т. д.).

Какие из этих конечных точек мы будем использовать, во многом будет зависеть от того, используем ли мы импорт JSON или CSV. Теперь мы можем посмотреть на них ниже.

Purchase Order:

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

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

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

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

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

Мы можем понять, почему мы будем использовать ‘PurchaseOrder’ конечная точка для этого формата, учитывая способность файлов JSON хранить вложенные данные, что позволяет нам включать отступы ‘PurchaseOrderLine’, и впоследствии ‘Commodity’ точки данных в импорте, которые можно определить с помощью руководства SG API. Например, ‘commodity code’ точку данных можно найти, используя следующий путь в руководстве по API:

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

Purchase Order Lines:

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

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

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

Мы также можем использовать ‘PurchaseOrderLine’ endpoint для добавления или редактирования строк существующего заказа. Мы также можем добавлять заказы на покупку, используя эту конечную точку, но мы можем редактировать заказ на покупку только с помощью ‘PurchaseOrder’ URI.

Мы можем увидеть пример ‘PurcahseOrderLine’ JSON ниже, где мы добавим еще одну строку заказа для заказа «PO-8471», который мы создали выше:

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

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

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

Purchase Orders:

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

http://host:port/V5-API/api/integrate/export/purchase_orders

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

Эта конечная точка будет экспортировать полные файлы заказов на покупку в формате JSON с использованием класса базы данных заказов на покупку и будет включать все заказы на покупку, которые еще не были отмечены системой как экспортированные. Это не будет включать какие-либо полученные данные, а скорее обеспечит возврат для каждой точки данных в ‘PurchaseOrder’ класса.

Мы можем увидеть начало примера экспорта этого типа ниже:

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

Purchase Order:

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

http://host:port/V5-API/api/integrate/export/purchase_order/{ordernumber}

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

Эта конечная точка будет экспортировать полные файлы заказов на покупку JSON с использованием класса базы данных заказов на покупку, но только для указанного заказа и только в том случае, если этот заказ еще не помечен системой как экспортированный. Как и выше, это не будет включать какие-либо полученные данные, а скорее обеспечит возврат для каждой точки данных в ‘PurchaseOrder’ класса.

Purchase Order Logs:

Конечная точка/URI экспорта – http://host:port/V5-API/api/integrate/export/po_logs

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

Эту конечную точку можно использовать для получения списка журналов заказов на покупку, относящихся к событиям, возникающим во время получения заказа на покупку, и, в отличие от вышеперечисленных типов, можно использовать для получения информации, например о том, что было получено, сколько и где оно хранилось и т. д. Это позволяет использовать ‘SystemLog’ класс данных для предоставления дополнительных транзакционных данных, таких как системные дескрипторы. Конечная точка предоставляет эти данные только для выполненных заказов, при условии, что они ранее не были помечены как экспортированные.

Мы можем увидеть начало примера экспорта этого типа ниже:

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

Purchase Order Transactions:

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

http://host:port/V5-API/api/integrate/export/po_transactions

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

Эта конечная точка работает так же, как ‘Purchase Order Logs’ выше, за исключением того, что эта конечная точка также будет предоставлять данные из заказов, которые еще не завершены (т. е. заказы в процессе).

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

У нас есть одна транзакционная/универсальная конечная точка, которую мы можем здесь использовать:

Транзакции покупки

Обратите внимание, что для импорта CSV мы обычно используем ‘PurchaseOrderLine’ конечная точка, позволяющая нам генерировать заказы на покупку и их позиции с помощью одного CSV-файла.

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

Завершенные заголовочные файлы следует разместить в папке: “<installdir>\SG Control Center\gateway\import\column_defs”

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

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

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

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

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

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

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

Здесь мы видим, что импортируем 2 разных заказа: один с 2 позициями, а другой — только с 1. Пример файла импорта можно скачать здесь.

После завершения импорта мы видим, что эти заказы вместе с их позициями были добавлены в Центр управления. Обратите внимание, что если данные «Дата размещения» не включены в импорт, дата размещения будет ссылаться на сегодняшнюю дату.

Если вы хотите экспортировать информацию о заказе на поставку с помощью этого метода, это станет частью ‘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’ уровне, но тогда мы также можем использовать ‘Purchase Order и ‘Purchase Order Line’ страницы для дальнейшего создания необходимой информации, такой как номер заказа на покупку, приобретенный товар, где он хранился и т. д.

На самом базовом уровне наша часть заголовка системного журнала, связанная с нашими заказами на покупку, может выглядеть примерно так:

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

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

Если мы пойдем дальше и получим ‘Flour’ Строка заказа для заказа «PO-8472» выше даст нам следующий экспорт, сообщающий нам, что эта мука была заказана в количествах 2x 250 фунтов и хранилась на складе ‘SG User’ в ‘GEN’ складское расположение.

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