8-800-200-0811
↑ Все 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
    }
}

Название Описание
IDBitrix ID позиции спецификации
EXTERNAL_IDНомер позиции спецификации
MATERIAL_IDID материала позиции спецификации
MATERIAL_NAMEНаименование материала позиции спецификации
PID_IDPID
CONTRACT_EXTERNAL_NUMBERНомер договора
SPECIFICATION_EXTERNAL_IDНомер спецификации
SPECIFICATION_DELIVERY_PLAN_ENDПлановая дата окончания отгрузки по позиции спецификации
SPECIFICATION_DELIVERY_FACT_ENDФактическая дата окончания отгрузки по позиции спецификации
SPECIFICATION_PRODUCTION_PLAN_ENDПлановая дата окончания производства последнего листа по позиции спецификации
totalКоличество записей, подходящих под условия запроса
limitКоличество записей в выдаче
offsetСмещение