Заказы

Интеграция заказов на покупку между 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 – уникальный код, используемый для идентификации поставщика.

покупкаOrder.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”

Готовые заголовочные файлы должны быть размещены в: “ \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’ складское расположение.

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