VRt.Packer [PC] (7.26.3024)
Программный интерфейс для Veeroute Packer.
Поддон
Моно-поддон
Если поддон полностью укомплектован одинаковым товаром, то такой поддон называется моно-поддон, такой поддон имеет следующие правила загрузки:
- Учитывается максимально допустимая высота поддона с уложенным на него товаром.
- Учитывается максимально допустимый вес загруженного поддона.
- Упаковки товара могут укладываться только параллельно стенкам поддона.
- Допускается поворачивать упаковки вокруг вертикальной оси Z и только под прямым углом.
- Чтобы выровнять высоту между позициями (для размещения еще одного поддона сверху), в укладку по слоям могут добавляться пустые места.
Разделенный на зоны поддон
После формирования моно-поддонов оставшаяся часть товаров того же артикула размещается на на следующем поддоне, который делится при помощи картонной перегородки на зоны таким образом, чтобы в каждой зоне был размещен товар только одного артикула, при этом зоны имеют следующие ограничения:
- Зоны прямоугольные.
- Соотношение между сторонами зон может быть любое.
- Одна из сторон любой зоны всегда соприкасается с краем поддоны.
- Допустимое количество зон на поддоне: от 2 до 6.
- Каждая зона заполняется по правилам заполнения моно-поддона.
- Высота укладки всех товаров не превышает 50 мм, чтобы сверху такого поддона можно было поставить еще один поддон.
- Допускается формировать поддоны с разной высотой укладки для разных позиций (разница высот больше 50 мм), если это будут верхние поддоны в стопке.
Миксбокс
Если на описанных выше этапах не удается разместить номенклатуру таким образом, чтобы поддон был необходимой высоты или веса, используются миксбоксы:
- Миксбокс можно класть только в один слой.
- В одном миксбоксе могут находится разные товары, в этом случае он делится перегородками аналогично поддону (единственно отличие - не выравнивается высота упакованного товара).
- Миксбоксы можно смешивать с товарными позициями на одной палете.
- Один товар может быть упакован в разные миксбокс.
Слот
Загруженные поддоны укладываются в стопки друг на друга, слот - это место установки стопки поддонов.
У слота нет физического тела - поэтому размеры body слота нулевые.
Для указания местоположение упаковок и товаров используется локальная система координат, в которой координаты конкретного объекта указываются относительно ближнего левого нижнего угла родительского объекта, при этом:
- Горизонтальная плоскость - оси X, Y
- Вертикальная - ось Z
Соотношение осей товаров и упаковок:
- Ширина - по оси X
- Длина - по оси Y
- Высота - по оси Z
Упаковка (SYNC)
Планирование оптимального размещения.
Authorizations:
Request Body schema: application/jsonrequired
Данные для расчета.
required | Array of objects (product) [ 1 .. 70001 ] items unique Список товаров, которые необходимо упаковать. |
required | Array of objects (package) [ 1 .. 11 ] items unique Список доступных упаковок. Обязательно наличие хотя бы одной упаковки каждого типа (SLOT, PALLET, MIXBOX). |
object (pack_settings) Настройки упаковки. | |
| dataset_name | string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" Название набора данных. Техническое поле, не влияющее на расчет. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | Array of objects (blueprint) [ 0 .. 70001 ] items План размещения товаров в виде списка расположений упаковок. На первом уровне находится список стопок поддонов. |
required | object (pack_statistics) Общая статистика по схеме упаковки. |
Array of objects (entity_warning_list) [ 0 .. 70001 ] items Список предупреждений. В зависимости от флага | |
object (unpacked_items) Список неупакованных товаров и не используемых упаковок. | |
| calculation_progress required | integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. |
required | object (calculation_info) Информация о расчете. |
Request samples
- Payload
- Python
{- "$ref": "pack_task_small.json"
}Response samples
- 200
- 400
- 402
- 404
- 429
- 500
{- "$ref": "pack_result_small.json"
}Упаковка (ASYNC)
Authorizations:
Request Body schema: application/jsonrequired
Данные для расчета.
required | Array of objects (product) [ 1 .. 70001 ] items unique Список товаров, которые необходимо упаковать. |
required | Array of objects (package) [ 1 .. 11 ] items unique Список доступных упаковок. Обязательно наличие хотя бы одной упаковки каждого типа (SLOT, PALLET, MIXBOX). |
object (pack_settings) Настройки упаковки. | |
| dataset_name | string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" Название набора данных. Техническое поле, не влияющее на расчет. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
| process_code required | string <uuid> (process_code) Example: "11111111-2222-3333-4444-555555555555" Код процесса - идентификатор расчета. |
Request samples
- Payload
{- "$ref": "pack_task_small.json"
}Response samples
- 200
- 400
- 402
- 404
- 429
- 500
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-01-21T09:30:00+03:00"
}, - "process_code": "11111111-2222-3333-4444-555555555555"
}Отмена расчета
Отмена процесса планирования по идентификатору расчета.
Authorizations:
path Parameters
| process_code required | string <uuid> (process_code) Example: 11111111-2222-3333-4444-555555555555 Уникальный идентификатор процесса. |
Responses
Response samples
- 400
- 402
- 404
- 429
- 500
{- "$ref": "result_400.json"
}Состояние расчета
Получение состояния расчета по идентификатору расчета.
Authorizations:
path Parameters
| process_code required | string <uuid> (process_code) Example: 11111111-2222-3333-4444-555555555555 Уникальный идентификатор процесса. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
| calculation_progress required | integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. |
required | object (calculation_info) Информация о расчете. |
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
| calculation_progress required | integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. |
required | object (calculation_info) Информация о расчете. |
Response samples
- 200
- 202
- 299
- 400
- 402
- 404
- 429
- 500
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-01-21T09:30:00+03:00"
}, - "calculation_progress": 52,
- "calculation_info": {
- "status": "FINISHED_IN_TIME",
- "message": "detail error message",
- "result_version": 133,
- "preparing_time": "PT1H45M",
- "business_validation_time": "PT1H45M",
- "math_validation_time": "PT1H45M",
- "waiting_time": "PT1H45M",
- "calculation_time": "PT1H45M"
}
}Получение результата
Получение результата расчета по идентификатору расчета.
Authorizations:
path Parameters
| process_code required | string <uuid> (process_code) Example: 11111111-2222-3333-4444-555555555555 Уникальный идентификатор процесса. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | Array of objects (blueprint) [ 0 .. 70001 ] items План размещения товаров в виде списка расположений упаковок. На первом уровне находится список стопок поддонов. |
required | object (pack_statistics) Общая статистика по схеме упаковки. |
Array of objects (entity_warning_list) [ 0 .. 70001 ] items Список предупреждений. В зависимости от флага | |
object (unpacked_items) Список неупакованных товаров и не используемых упаковок. | |
| calculation_progress required | integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. |
required | object (calculation_info) Информация о расчете. |
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | Array of objects (blueprint) [ 0 .. 70001 ] items План размещения товаров в виде списка расположений упаковок. На первом уровне находится список стопок поддонов. |
required | object (pack_statistics) Общая статистика по схеме упаковки. |
Array of objects (entity_warning_list) [ 0 .. 70001 ] items Список предупреждений. В зависимости от флага | |
object (unpacked_items) Список неупакованных товаров и не используемых упаковок. | |
| calculation_progress required | integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. |
required | object (calculation_info) Информация о расчете. |
Response samples
- 200
- 202
- 299
- 400
- 402
- 404
- 429
- 500
{- "$ref": "pack_result_small.json"
}Удаление результата
Удаление результата по идентификатору расчета.
Authorizations:
path Parameters
| process_code required | string <uuid> (process_code) Example: 11111111-2222-3333-4444-555555555555 Уникальный идентификатор процесса. |
Responses
Response samples
- 400
- 402
- 404
- 429
- 500
{- "$ref": "result_400.json"
}Валидация данных
Проверка данных перед отправкой на расчет.
Authorizations:
Request Body schema: application/jsonrequired
Данные для расчета.
required | Array of objects (product) [ 1 .. 70001 ] items unique Список товаров, которые необходимо упаковать. |
required | Array of objects (package) [ 1 .. 11 ] items unique Список доступных упаковок. Обязательно наличие хотя бы одной упаковки каждого типа (SLOT, PALLET, MIXBOX). |
object (pack_settings) Настройки упаковки. | |
| dataset_name | string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" Название набора данных. Техническое поле, не влияющее на расчет. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | Array of objects (entity_warning_list) [ 0 .. 70001 ] items Список предупреждений. В зависимости от флага |
Request samples
- Payload
{- "$ref": "pack_task_small.json"
}Response samples
- 200
- 400
- 402
- 404
- 429
- 500
{- "$ref": "validation_result.json"
}Проверка доступности
Проверка доступности сервиса.
Responses
Response Schema: application/json
| health required | number <double> [ 0 .. 1 ] Example: "0.999" Текущий показатель здоровья сервиса.
|
Response samples
- 200
- 404
- 429
- 500
{- "health": 0.999
}Получение версии сервиса
Получение версии сервиса.
Responses
Response Schema: application/json
| major required | integer <int32> [ 1 .. 100 ] Example: "7" Версия продукта.
В рамках одной версии гарантируется совместимость общих структур данных между сервисами. |
| minor required | integer <int32> [ 0 .. 111 ] Example: "15" Минорная версия сервиса. Изменение версии указывает на новую функциональность. Обновление имеет обратную совместимость в рамках мажорной версии сервиса. |
| build required | string [ 1 .. 64 ] characters Example: "3754RC" Версия сборки. |
Response samples
- 200
- 404
- 429
- 500
{- "major": 7,
- "minor": 15,
- "build": "3754RC"
}Получение документации
Получение файла с документацией на этот сервис.
path Parameters
| filename required | string [ 6 .. 128 ] characters Example: file_en.html Название файла. |
Responses
Response Schema:
Файл с данными в формате HTML.
Response samples
- 404
- 429
- 500
{- "resource_key": "resource_key_one",
- "detail": null
}