↑ Все API

Cервис Cпецификаций

Для работы с API доступно демо-окружение, где можно протестировать запросы перед использованием в продуктивном контуре. Авторизация осуществляется с использованием Bearer токена, передаваемого в заголовке запроса.

Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку.

Инструкция и пример по получению токена для работы с API доступна по ссылке: https://api-integration.omk.ru/auth/apiDoc.

Параметры

Получает спецификации по одному из параметров:

SPECIFICATION_NUMBER - Номер спецификации
CONTRACT_NUMBER - Договор
STATUS - Код статуса
STATUS_TYPE - Тип статуса
ORDER.DATE_ORDER - Дата заявки
POSITION.MATERIAL_NAME - Наименование материала
POSITION.MATERIAL_SAP_ID - Код материала в SAP
limit - Количество записей. На данный момент доступные лимиты 5, 10, 20
offset - Смещение

С какими сущностями работает

specification - Cпецификации
document - Документы
specification_position - Позиции спецификаций
specification_position_sign - Атрибуты позиций спецификаций
delivery - Поставки
delivery_position - Позиции поставок
material - Материалы

Как вызвать

Примеры запросов по разным параметрам:

CONTRACT_NUMBER

curl -X 'GET' \
  'https://api-integration.omk.ru/api/lk/specification?limit=5&offset=0&CONTRACT_NUMBER=20-20-5872' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'

SPECIFICATION_NUMBER

curl -X 'GET' \
  'https://api-integration.omk.ru/api/lk/specification?SPECIFICATION_NUMBER=408&limit=5&offset=0' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'

POSITION.MATERIAL_SAP_ID

curl -X 'GET' \
  'https://api-integration.omk.ru/api/lk/specification?limit=5&POSITION[MATERIAL_SAP_ID]=504040001025' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'

Что в ответе

Стандартизованный объект:

Пример ответа

{
    "success": true,
    "error_code": null,
    "data": {
        "result": [
            {
                "SAP_ID": "45220460",
                "SPECIFICATION_NUMBER": "408",
                "CONTRACT_NUMBER": "881553",
                "CONTRACT_DATE": "2018-02-05 00:00:00",
                "PLANNED_WEIGHT_TONN": 0,
                "PREPAYMENT": 0,
                "STATUS": "45",
                "STATUS_TYPE": "ZSD_DOG",
                "DATE_ACTIVE_FROM": "2025-01-17 00:00:00",
                "DATE_ACTIVE_TO": "2027-12-31 00:00:00",
                "DELIVERY": null,
                "DOCUMENT": null,
                "ORDER": null,
                "POSITION": [
                    {
                        "ID": 304892,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000022",
                        "MATERIAL_NAME": "Труба сварная прямоугольная 40х20х1,5-В-Ст2пс ГОСТ 8645-68",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000010"
                    },
                    {
                        "ID": 304893,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000016",
                        "MATERIAL_NAME": "Труба сварная прямоугольная 50х25x2-В-Ст2пс ГОСТ 8645-68",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000020"
                    },
                    {
                        "ID": 304894,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000013",
                        "MATERIAL_NAME": "Труба сварная прямоугольная 60х40x2-В-Ст2пс ГОСТ 8645-68",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000030"
                    },
                    {
                        "ID": 304895,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000061",
                        "MATERIAL_NAME": "Труба сварная квадратная 60х60x2-В-Ст2пс ГОСТ 8639-82",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000040"
                    },
                    {
                        "ID": 304896,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000015",
                        "MATERIAL_NAME": "Труба сварная квадратная 60х60x3-В-20 ГОСТ 8639-82",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000050"
                    },
                    {
                        "ID": 304897,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502020000015",
                        "MATERIAL_NAME": "Труба сварная квадратная 60х60x3-В-20 ГОСТ 8639-82",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000060"
                    }
                ]
            },
            {
                "SAP_ID": "45182290",
                "SPECIFICATION_NUMBER": "408",
                "CONTRACT_NUMBER": "801011",
                "CONTRACT_DATE": "2020-01-17 00:00:00",
                "PLANNED_WEIGHT_TONN": 0,
                "PREPAYMENT": 3182905.56,
                "STATUS": "45",
                "STATUS_TYPE": "ZSD_DOG",
                "DATE_ACTIVE_FROM": "2023-06-29 00:00:00",
                "DATE_ACTIVE_TO": "2023-12-31 00:00:00",
                "DELIVERY": [
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"РКЦ-СЕРВИС\""
                    }
                ],
                "DOCUMENT": [
                    {
                        "ID": 50820381,
                        "NUMBER": "45182290",
                        "DATE": "2023-07-03 00:00:00"
                    }
                ],
                "DOCUMENT_LIST": [
                    {
                        "ID": 50820381,
                        "NUMBER": "45182290",
                        "DATE": "2023-07-03 00:00:00"
                    }
                ],
                "ORDER": [
                    {
                        "ID": 23860,
                        "NUMBER": "",
                        "DATE_ORDER": "2023-06-28 00:00:00",
                        "SAP_ID": "20085141"
                    }
                ],
                "POSITION": [
                    {
                        "ID": 270765,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "505070000179",
                        "MATERIAL_NAME": "Труба электросварная прямошовная 168х8,9-22ГЮ ТС 153-21-2007",
                        "DATE_PLANNED_PRODUCTION": "2023-07-03 00:00:00",
                        "SPECIFICATION_POSITION_SAP_ID": "000020"
                    },
                    {
                        "ID": 272706,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "505170000099",
                        "MATERIAL_NAME": "Труба электросварная прямошовная 168х8,9-22ГЮ ТС 153-21-2007",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000030"
                    }
                ]
            },
            {
                "SAP_ID": "30035868",
                "SPECIFICATION_NUMBER": "408",
                "CONTRACT_NUMBER": "1/19",
                "CONTRACT_DATE": "2019-01-09 00:00:00",
                "PLANNED_WEIGHT_TONN": 0,
                "PREPAYMENT": 0,
                "STATUS": "20",
                "STATUS_TYPE": "ZSDZMP",
                "DATE_ACTIVE_FROM": "2023-06-27 00:00:00",
                "DATE_ACTIVE_TO": "2900-12-31 00:00:00",
                "DELIVERY": null,
                "DOCUMENT": [
                    {
                        "ID": 50811753,
                        "NUMBER": "30035868",
                        "DATE": "2023-06-28 00:00:00"
                    }
                ],
                "ORDER": null,
                "POSITION": [
                    {
                        "ID": 269743,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "502010000197",
                        "MATERIAL_NAME": "Труба водогазопроводная 25х2,8-10 ГОСТ 3262-75",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000010"
                    }
                ]
            },
            {
                "SAP_ID": "45164722",
                "SPECIFICATION_NUMBER": "408",
                "CONTRACT_NUMBER": "К-17-251",
                "CONTRACT_DATE": "2017-12-07 00:00:00",
                "PLANNED_WEIGHT_TONN": 0,
                "PREPAYMENT": 23722991.84,
                "STATUS": "45",
                "STATUS_TYPE": "ZSD_DOG",
                "DATE_ACTIVE_FROM": "2022-09-09 00:00:00",
                "DATE_ACTIVE_TO": "9998-12-31 00:00:00",
                "DELIVERY": [
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    },
                    {
                        "CONSIGNEE_SHORT_NAME": "ООО \"ЯЭС\""
                    }
                ],
                "DOCUMENT": [
                    {
                        "ID": 48095263,
                        "NUMBER": "45164722",
                        "DATE": "2022-09-09 00:00:00"
                    }
                ],
                "DOCUMENT_LIST": [
                    {
                        "ID": 48095263,
                        "NUMBER": "45164722",
                        "DATE": "2022-09-09 00:00:00"
                    }
                ],
                "ORDER": [
                    {
                        "ID": 18118,
                        "NUMBER": "",
                        "DATE_ORDER": "2022-09-07 00:00:00",
                        "SAP_ID": "20077771"
                    }
                ],
                "POSITION": [
                    {
                        "ID": 213010,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "504010002661",
                        "MATERIAL_NAME": "Труба электросварная прямошовная нефтегазопроводная 1020х18-К52 ГОСТ 20295-85",
                        "DATE_PLANNED_PRODUCTION": "2022-11-22 00:00:00",
                        "SPECIFICATION_POSITION_SAP_ID": "000010"
                    },
                    {
                        "ID": 230693,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "504010002123",
                        "MATERIAL_NAME": "Труба электросварная прямошовная нефтегазопроводная 1020х18-К56 ГОСТ 20295-85",
                        "DATE_PLANNED_PRODUCTION": "2022-12-22 00:00:00",
                        "SPECIFICATION_POSITION_SAP_ID": "000020"
                    }
                ]
            },
            {
                "SAP_ID": "30032977",
                "SPECIFICATION_NUMBER": "408",
                "CONTRACT_NUMBER": "881703",
                "CONTRACT_DATE": "2018-07-10 00:00:00",
                "PLANNED_WEIGHT_TONN": 0,
                "PREPAYMENT": 0,
                "STATUS": "10",
                "STATUS_TYPE": "ZSDZMP",
                "DATE_ACTIVE_FROM": "2022-06-28 00:00:00",
                "DATE_ACTIVE_TO": "2900-12-31 00:00:00",
                "DELIVERY": null,
                "DOCUMENT": [
                    {
                        "ID": 47291455,
                        "NUMBER": "30032977",
                        "DATE": "2022-06-30 00:00:00"
                    }
                ],
                "ORDER": null,
                "POSITION": [
                    {
                        "ID": 191590,
                        "PID_ID": "",
                        "MATERIAL_SAP_ID": "503030000021",
                        "MATERIAL_NAME": "Труба электросварная прямошовная 219х6-В-20 ГОСТ 10705-80",
                        "DATE_PLANNED_PRODUCTION": null,
                        "SPECIFICATION_POSITION_SAP_ID": "000010"
                    }
                ]
            }
        ],
        "total": 11,
        "limit": 5,
        "offset": 0
    }
}

Название	Описание
SAP_ID	Номер спецификации в SAP
SPECIFICATION_NUMBER	Номер спецификации
CONTRACT_NUMBER	Номер договора
CONTRACT_DATE	Дата договора
PLANNED_WEIGHT_TONN	Запланировано к поставке
PREPAYMENT	Предоплата
STATUS	Код статуса (10, 15, 20 … 70)
STATUS_TYPE	Тип статуса (ZSD_DOG \ ZSDZNM)
DATE_ACTIVE_FROM	Период действия от
DATE_ACTIVE_TO	Период действия до
DELIVERY
CONSIGNEE_SHORT_NAME	Имя грузополучателя
DOCUMENT
ID	ID документа
NUMBER	Номер документа
DATE	Дата документа
DOCUMENT_LIST
ID	ID документа
NUMBER	Номер документа
DATE	Дата документа
ORDER
ID	ID запроса на производство
NUMBER	Номер запроса на производство
DATE_ORDER	Дата запроса на производство
SAP_ID	Номер запроса на производство в SAP
POSITION
ID	ID позиции
PID_ID	PID
MATERIAL_SAP_ID	Код материала в SAP
MATERIAL_NAME	Наименование материала
DATE_PLANNED_PRODUCTION	Планируемая дата производства
SPECIFICATION_POSITION_SAP_ID	Номер позиции спецификации в SAP

Маркет

Личный кабинет

Аукционы

Сертификаты

Smart construction

Биржа возможностей

Пространство

Админ панель

Тарифы

Cервис Cпецификаций

Параметры

С какими сущностями работает

Как вызвать

Что в ответе