↑ Все API
API Информация о сроках поставки и производства
Для работы с API доступно демо-окружение, где можно протестировать запросы перед использованием в продуктивном контуре. Авторизация осуществляется с использованием Bearer токена, передаваемого в заголовке запроса.
Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку.
Параметры
Получает информацию по одному или нескольким из указанных ниже параметров:
- MATERIAL_ID - ID материала позиции спецификации,
- PID_ID - PID,
- CONTRACT_EXTERNAL_NUMBER - Номер договора,
- SPECIFICATION_EXTERNAL_ID - Номер спецификации,
- SPECIFICATION_DELIVERY_PLAN_END[from] - Дата, от которой происходит выборка. Плановая дата окончания отгрузки по позиции спецификации
- SPECIFICATION_DELIVERY_PLAN_END[to] - Дата, до которой происходит выборка. Плановая дата окончания отгрузки по позиции спецификации
- SPECIFICATION_DELIVERY_FACT_END[from] - Дата, от которой происходит выборка. Фактическая дата окончания отгрузки по позиции спецификации
- SPECIFICATION_DELIVERY_FACT_END[to] - Дата, до которой происходит выборка. Фактическая дата окончания отгрузки по позиции спецификации
- SPECIFICATION_PRODUCTION_PLAN_END[from] - Дата, от которой происходит выборка. Плановая дата окончания производства последнего листа по позиции спецификации
- SPECIFICATION_PRODUCTION_PLAN_END[to] - Дата, до которой происходит выборка. Плановая дата окончания производства последнего листа по позиции спецификации
- limit - Количество записей. На данный момент лимиты 5, 10, 20, 50, 100
- offset - Смещение
Как вызвать
Примеры запросов по разным параметрам:
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?MATERIAL_ID=504030003295' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?SPECIFICATION_DELIVERY_PLAN_END[from]=2023-01-01 00:00:00&SPECIFICATION_DELIVERY_PLAN_END[to]=2023-10-31 00:00:00' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?SPECIFICATION_DELIVERY_PLAN_END[from]=2023-01-01 00:00:00' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?SPECIFICATION_DELIVERY_PLAN_END[to]=2023-10-31 00:00:00' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?MATERIAL_ID=504030003295&SPECIFICATION_DELIVERY_PLAN_END[from]=2023-09-09 00:00:00&SPECIFICATION_EXTERNAL_ID=1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
curl -X 'GET' \
'https://api-integration.omk.ru/api/lk/specification-position-stage?MATERIAL_ID=504030003295&limit=5&offset=5' \
-H 'accept: application/json' \
-H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
Что в ответе
Стандартизованный объект:
Пример ответа
{
"success": true,
"error_code": null,
"data": {
"result": [
{
"ID": 304742,
"EXTERNAL_ID": "000860",
"MATERIAL_ID": "504030003143",
"MATERIAL_NAME": "Труба электросварная прямошовная с наружным покрытием 820х12-К56 2 ТУ 1381-051-05757848-2016 Тип 1 2,5 ТУ 1390-044-05757848-2011",
"PID_ID": "000101203496531",
"CONTRACT_EXTERNAL_NUMBER": "Дог-1000-23-00007401",
"SPECIFICATION_EXTERNAL_ID": "3",
"SPECIFICATION_DELIVERY_PLAN_END": "2023-10-21 00:00:00",
"SPECIFICATION_DELIVERY_FACT_END": null,
"SPECIFICATION_PRODUCTION_PLAN_END": "2023-09-12 00:00:00"
},
{
"ID": 304741,
"EXTERNAL_ID": "000850",
"MATERIAL_ID": "504030003143",
"MATERIAL_NAME": "Труба электросварная прямошовная с наружным покрытием 820х12-К56 2 ТУ 1381-051-05757848-2016 Тип 1 2,5 ТУ 1390-044-05757848-2011",
"PID_ID": "000101203496530",
"CONTRACT_EXTERNAL_NUMBER": "Дог-1000-23-00007401",
"SPECIFICATION_EXTERNAL_ID": "3",
"SPECIFICATION_DELIVERY_PLAN_END": "2023-11-20 00:00:00",
"SPECIFICATION_DELIVERY_FACT_END": null,
"SPECIFICATION_PRODUCTION_PLAN_END": "2023-10-12 00:00:00"
},
{
"ID": 304740,
"EXTERNAL_ID": "000840",
"MATERIAL_ID": "504030002692",
"MATERIAL_NAME": "Труба электросварная прямошовная для защитных футляров (кожухов) с наружным покрытием 1020х16-К52 ТУ 1381-020-05757848-2011 Тип 4 3,5 ТУ 1390-044-05757848-2011",
"PID_ID": "000101203496525",
"CONTRACT_EXTERNAL_NUMBER": "Дог-1000-23-00007401",
"SPECIFICATION_EXTERNAL_ID": "3",
"SPECIFICATION_DELIVERY_PLAN_END": "2023-10-21 00:00:00",
"SPECIFICATION_DELIVERY_FACT_END": null,
"SPECIFICATION_PRODUCTION_PLAN_END": "2023-09-12 00:00:00"
},
{
"ID": 304739,
"EXTERNAL_ID": "000830",
"MATERIAL_ID": "504030003286",
"MATERIAL_NAME": "Труба электросварная прямошовная с наружным покрытием 820х14-К56 2 ТУ 1381-051-05757848-2016 Тип 1 2,5 ТУ 1390-044-05757848-2011",
"PID_ID": "000101203496523",
"CONTRACT_EXTERNAL_NUMBER": "Дог-1000-23-00007401",
"SPECIFICATION_EXTERNAL_ID": "3",
"SPECIFICATION_DELIVERY_PLAN_END": "2023-11-20 00:00:00",
"SPECIFICATION_DELIVERY_FACT_END": null,
"SPECIFICATION_PRODUCTION_PLAN_END": "2023-10-12 00:00:00"
},
{
"ID": 304738,
"EXTERNAL_ID": "000820",
"MATERIAL_ID": "504030003286",
"MATERIAL_NAME": "Труба электросварная прямошовная с наружным покрытием 820х14-К56 2 ТУ 1381-051-05757848-2016 Тип 1 2,5 ТУ 1390-044-05757848-2011",
"PID_ID": "000101203496522",
"CONTRACT_EXTERNAL_NUMBER": "Дог-1000-23-00007401",
"SPECIFICATION_EXTERNAL_ID": "3",
"SPECIFICATION_DELIVERY_PLAN_END": "2023-10-21 00:00:00",
"SPECIFICATION_DELIVERY_FACT_END": null,
"SPECIFICATION_PRODUCTION_PLAN_END": "2023-09-12 00:00:00"
}
],
"total": 229,
"limit": 5,
"offset": 5
}
}
| Название | Описание |
|---|---|
| ID | Bitrix ID позиции спецификации |
| EXTERNAL_ID | Номер позиции спецификации |
| MATERIAL_ID | ID материала позиции спецификации |
| MATERIAL_NAME | Наименование материала позиции спецификации |
| PID_ID | PID |
| CONTRACT_EXTERNAL_NUMBER | Номер договора |
| SPECIFICATION_EXTERNAL_ID | Номер спецификации |
| SPECIFICATION_DELIVERY_PLAN_END | Плановая дата окончания отгрузки по позиции спецификации |
| SPECIFICATION_DELIVERY_FACT_END | Фактическая дата окончания отгрузки по позиции спецификации |
| SPECIFICATION_PRODUCTION_PLAN_END | Плановая дата окончания производства последнего листа по позиции спецификации |
| total | Количество записей, подходящих под условия запроса |
| limit | Количество записей в выдаче |
| offset | Смещение |