Конечные точки транзакций и журналов
Ваш путеводитель по интеграции V5!
Введение
В дополнение к конечным точкам экспорта, представленным в наших руководствах по интеграции V5, API V5 также включает несколько конечных точек транзакций, которые можно использовать для возврата дескрипторы системных событий/logs во внешнюю ERP.
Содержание
1. Конечные точки системного журнала
Общие конечные точки можно использовать для возврата широкого спектра дескрипторы по ряду разные модули.
Эти конечные точки будут возвращать более сложные данные, чем транзакционные/универсальные конечные точки, и часто будут содержать несколько наборов вложенных данных, относящихся к событиям дескриптора. Хотя это полезно в том смысле, что будут возвращены правильные данные, эти конечные точки часто необходимо фильтровать, чтобы наилучшим образом использовать возвращаемые данные.
Ниже мы можем увидеть, что это такое для API V5:
1.1. Системные журналы
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/system_logs
Эта конечная точка предоставит файл возврата JSON, который включает ВСЕ системное событие дескрипторы и данные, относящиеся к ним. Если мы достигнем этой конечной точки, мы получим возврат, который выглядит примерно так:
Итак, мы видим здесь, что, хотя мы получаем дескриптор CONSUMED в нижней части этого изображения для некоторых потоков Saffron Threads, используемых для пакета, мы также получаем много дополнительных вложенных данных, таких как полный возврат класса для поставщик и местоположение, которые мы можем увидеть здесь.
В вашей ERP-системе можно настроить фильтры, чтобы выборочно выбирать те данные, которые вы хотите видеть.
Этот пример файла можно скачать здесь.
Полезный для:
1.2. Системный журнал
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/system_log/{id}
Эта конечная точка предоставит файл возврата JSON, структурированный аналогично экспорту «Системных журналов», описанному выше, но здесь мы можем указать индивидуальный идентификационный номер журнала, для которого будет возвращена связанная информация. Это полезно, если мы хотим сосредоточиться на конкретном событии или дескриптор.
Пример этого типа файла можно скачать здесь.
Полезный для:
1.3. Журналы системы регулировки
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/adjustment_logs
Эта конечная точка вернет файл JSON со списком событий системного журнала с параметром «НАСТРОЙКА». дескриптор, сужая возвращаемый результат от того, что мы видели выше для «Системных журналов», до записей, содержащих только этот дескриптор. Это помогает предоставить более релевантные данные для обработки ERP в зависимости от ваших потребностей.
Пример этого типа файла можно скачать здесь.
Полезный для:
1.4. Потребляемые/генерируемые системные журналы:
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/system_logs_cp
Эта конечная точка вернет файл JSON со списком событий системного журнала с пометкой «CONSUMED» или «PRODUCED». дескриптор, сужая возвращаемый результат от того, что мы видели выше для «Системных журналов», до записей, содержащих эти дескрипторы. Эти журналы относятся к основному процессу пакетирования, а именно к сокращению и производству запасов. Это помогает предоставить более релевантные данные для обработки ERP в зависимости от ваших потребностей.
Пример этого типа файла можно скачать здесь.
Полезный для:
1.5. Неиспользованные/созданные системные журналы:
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/system_logs_noncp
Эта конечная точка фактически действует как инверсия конечной точки «Потребляемые/производимые системные журналы», указанной выше, и возвращает файл JSON, в котором перечислены системные журналы с любыми значениями, кроме «CONSUMED» или «PRODUCED». дескрипторы.
Полезный для:
1.6. Журналы использования
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs
Эта конечная точка вернет файл JSON со списком событий системного журнала, относящихся к пакетной обработке, сужая возврат от того, что мы видели выше для «Системных журналов», до записей, содержащих дескрипторы такие как «СОБРИРОВАНО», «ПАРТИЯ ПРИОСТАНОВЛЕНА» и т. д. (а также «ПОТРЕБЛЕНО» и «ПРОИЗВОДНО»). Это помогает предоставить более релевантные данные для обработки ERP в зависимости от ваших потребностей.
Пример этого типа файла можно скачать здесь.
Полезный для:
1.7. Журналы использования (дата фильтра)
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs/filterFrom/{filterDate}
Эта конечная точка возвращает ту же информацию, что и «Журналы использования» выше, но позволяет фильтровать по дате (отметке времени эпохи), чтобы сузить результаты, если это необходимо.
Полезный для:
1.8. Журналы заданий
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/job_logs
Эта конечная точка предоставит возвратный файл JSON, включающий системные дескрипторы относящиеся к производству рабочих мест.
Пример файла этого типа можно скачать. здесь.
Полезный для:
2. Транзакционные/общие конечные точки
Конечные точки транзакций используются для возврата упрощенной информации о дескриптор события, которые более конкретно относятся к тому, как различные модули управляют уровнями запасов. В отличие от общих конечных точек, которые мы видели выше, которые предоставляют различные вложенные данные, эти конечные точки предоставляют упрощенную информацию без вложенных данных.
Мы можем увидеть, как это будет выглядеть на наших примерах ниже:
2.1. Корректирующие операции
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/transactions/adjustments
Эту конечную точку можно использовать для предоставления списка транзакций корректировки, произошедших в системе. Используя эту конечную точку, мы будем получать запись всякий раз, когда количество партии будет изменено (или скорректировано) с помощью Центра управления или WMS. Это может быть результатом повреждения или товаров с истекшим сроком годности, которые необходимо удалить из системы.
Пример экспорта этого типа может выглядеть так:
Как мы видим здесь, это одна запись для «КОРРЕКТИРОВКИ». дескриптор событие и не содержит никаких потенциально лишних вложенных данных, которые мы видели в общей конечной точке.
Пример файла такого типа можно скачать здесь.
Полезный для:
2.2. Пакетные транзакции потребления
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/{completedBatches}
Экспорт транзакций пакетного потребления предоставит упрощенный файл JSON, в котором представлены данные о потреблении и производстве. дескриптор данные, относящиеся к конкретной завершенной партии, обработанной системой.
Используя эту конечную точку, мы получим отчет, показывающий все товары, которые были потреблены в пакетном режиме, а также сколько самих партий было впоследствии произведено.
Пример этого типа файла можно скачать здесь.
Полезный для:
2.3. Операции пакетного потребления (дата фильтра)
Конечная точка/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/filterfrom/{filterDate}
Эта конечная точка возвращает ту же информацию, что и «Пакетное потребление» выше, но позволяет фильтровать по дате (отметке времени эпохи), чтобы сузить результаты, если это необходимо.
Полезный для:
2.4. Операции по заказам на поставку
Экспорт конечной точки/URI –
http://host:port/V5-API/api/integrate/export/transactions/purchase
Экспорт транзакций покупки из этой конечной точки предоставит упрощенный файл JSON, который предоставляет данные для получения, относящиеся к заказам на покупку, включая системные дескрипторы например «ПОЛУЧЕНО».
Конечная точка предоставляет эти данные только для завершенных заказов, которые не были помечены как экспортированные.
Пример этого типа файла можно скачать здесь.
Полезный для:
2.5. Транзакции заказа на продажу
Экспорт конечной точки/URI –
http://host:port/V5-API/api/integrate/export/transactions/sales/{true/false}
Экспорт транзакций продаж из этой конечной точки предоставит упрощенный файл JSON, содержащий данные о распределении, комплектовании и доставке, относящиеся к заказам на продажу. Использование этой конечной точки вернет данные, относящиеся ко всем товарам, проданным через заказы на продажу, и дескрипторы например «ВЫБРАНО» и «ОТПРАВЛЕНО».
Конечная точка может предоставить эти данные для завершенных заказов (true) или всех заказов (false), при условии, что эти заказы еще не были помечены как экспортированные.
Пример этого типа файла можно скачать здесь.
Полезный для:
