Cервис Сертификаты
Для работы с API доступно демо-окружение, где можно протестировать запросы перед использованием в продуктивном контуре. Авторизация осуществляется с использованием Bearer токена, передаваемого в заголовке запроса.
Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку.
Инструкция и пример по получению токена для работы с API доступна по ссылке: https://api-integration.omk.ru/auth/apiDoc.
Параметры
Получает сертификат по одному из параметров:
- CERTIFICATE_NUMBER - Номер сертификата качества
- SPECIFICATION_SAP_ID - Спецификация
- FINAL_DATE_DISPATCH - Дата отгрузки из цеха/склада
- FINAL_DATE_SHIPPING - Дата приема к перевозке
- DELIVERY_SAP_ID - Номер поставки
- CAR_NUMBER - Номер транспорта
- CONSIGNEE_SHORT_NAME - Имя грузополучателя
- POSITION.MATERIAL_NAME - Материал
- POSITION.MATERIAL_SAP_ID - Код материала
- POSITION.PID - PID
- POSITION.PACKET_NUMBER - Номер трубы
- POSITION.PACK_NUMBER - Номер пакета
- POSITION.SIGN_B_STEAM_PART - Номер партии
- POSITION.MELT - Номер плавки
- limit - Количество записей. На данный момент доступные лимиты 5, 10, 20
- offset - Смещение
Как вызвать
Примеры запросов по разным параметрам:
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/certificate?CERTIFICATE_NUMBER=59668111' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/certificate?SPECIFICATION_SAP_ID=20-959-4241-23' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/certificate??limit=5&POSITION[MATERIAL_NAME]=Z340 7200 v1 18.03.2024' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
Что в ответе
Стандартизованный объект:
Пример ответа
{
"success": true,
"error_code": null,
"data": {
"result": [
{
"ID": 50947367,
"CONSIGNEE_SHORT_NAME": "ООО \"AZERTEXNOLAYN\"",
"FINAL_DATE_DISPATCH": "2023-07-01 00:00:00",
"FINAL_DATE_SHIPPING": "2023-07-02 00:00:00",
"DELIVERY_SAP_ID": "81873144",
"CERTIFICATE_NUMBER": "20-089-08772-23",
"SHIPMENT_TYPE": "ЖелезнодорожнТрансп",
"CAR_NUMBER": "64113434",
"SPECIFICATION_SAP_ID": "2",
"POSITION": [
{
"ID": 5450943,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "318664",
"PACK_NUMBER": "23-317693",
"SIGN_B_STEAM_PART": "23-8668",
"MELT": "2314175"
},
{
"ID": 5450944,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "317693",
"PACK_NUMBER": "23-317690",
"SIGN_B_STEAM_PART": "23-8644",
"MELT": "2314116"
}
]
},
{
"ID": 50947263,
"CONSIGNEE_SHORT_NAME": "ООО \"AZERTEXNOLAYN\"",
"FINAL_DATE_DISPATCH": "2023-07-31 00:00:00",
"FINAL_DATE_SHIPPING": "2023-08-02 00:00:00",
"DELIVERY_SAP_ID": "81889310",
"CERTIFICATE_NUMBER": "20-089-10493-23",
"SHIPMENT_TYPE": "ЖелезнодорожнТрансп",
"CAR_NUMBER": "61116562",
"SPECIFICATION_SAP_ID": "2",
"POSITION": [
{
"ID": 5624014,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "377334",
"PACK_NUMBER": "23-377337",
"SIGN_B_STEAM_PART": "23-11136",
"MELT": "2314346"
},
{
"ID": 5624015,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "377337",
"PACK_NUMBER": "23-377367",
"SIGN_B_STEAM_PART": "23-11136",
"MELT": "2314346"
}
]
},
{
"ID": 50937962,
"CONSIGNEE_SHORT_NAME": "ООО \"AZERTEXNOLAYN\"",
"FINAL_DATE_DISPATCH": "2023-09-17 00:00:00",
"FINAL_DATE_SHIPPING": "2023-09-18 00:00:00",
"DELIVERY_SAP_ID": "81913615",
"CERTIFICATE_NUMBER": "20-089-13299-23",
"SHIPMENT_TYPE": "ЖелезнодорожнТрансп",
"CAR_NUMBER": "58806902",
"SPECIFICATION_SAP_ID": "2",
"POSITION": [
{
"ID": 5905226,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "458443",
"PACK_NUMBER": "23-393665",
"SIGN_B_STEAM_PART": "23-13090",
"MELT": "2315540"
},
{
"ID": 5905227,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "393665",
"PACK_NUMBER": "23-377852",
"SIGN_B_STEAM_PART": "23-11542",
"MELT": "2315004"
}
]
},
{
"ID": 50937954,
"CONSIGNEE_SHORT_NAME": "ООО \"AZERTEXNOLAYN\"",
"FINAL_DATE_DISPATCH": "2023-09-17 00:00:00",
"FINAL_DATE_SHIPPING": "2023-09-18 00:00:00",
"DELIVERY_SAP_ID": "81913614",
"CERTIFICATE_NUMBER": "20-089-13314-23",
"SHIPMENT_TYPE": "ЖелезнодорожнТрансп",
"CAR_NUMBER": "54986450",
"SPECIFICATION_SAP_ID": "2",
"POSITION": [
{
"ID": 5905276,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "458134",
"PACK_NUMBER": "23-458160",
"SIGN_B_STEAM_PART": "23-13082",
"MELT": "2315538"
},
{
"ID": 5905277,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "458160",
"PACK_NUMBER": "23-458283",
"SIGN_B_STEAM_PART": "23-13084",
"MELT": "2315538"
}
]
},
{
"ID": 50937327,
"CONSIGNEE_SHORT_NAME": "ООО \"AZERTEXNOLAYN\"",
"FINAL_DATE_DISPATCH": "2023-09-16 00:00:00",
"FINAL_DATE_SHIPPING": "2023-09-17 00:00:00",
"DELIVERY_SAP_ID": "81913342",
"CERTIFICATE_NUMBER": "20-089-13279-23",
"SHIPMENT_TYPE": "ЖелезнодорожнТрансп",
"CAR_NUMBER": "59929166",
"SPECIFICATION_SAP_ID": "2",
"POSITION": [
{
"ID": 5902865,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "458568",
"PACK_NUMBER": "23-458643",
"SIGN_B_STEAM_PART": "23-13094",
"MELT": "2315537"
},
{
"ID": 5902866,
"MATERIAL_NAME": "Z340 7200 v1 18.03.2024",
"MATERIAL_SAP_ID": "503040003713",
"PID": "",
"PACKET_NUMBER": "458643",
"PACK_NUMBER": "23-458642",
"SIGN_B_STEAM_PART": "23-13096",
"MELT": "2315537"
}
]
}
],
"total": 500,
"limit": 5,
"offset": 0
}
}
| Название | Описание |
|---|---|
| ID | id==DOCUMENT_ID |
| CONSIGNEE_SHORT_NAME | Имя грузополучателя |
| FINAL_DATE_DISPATCH | Дата отгрузки из цеха/склада |
| FINAL_DATE_SHIPPING | Дата приема к перевозке |
| DELIVERY_SAP_ID | Номер поставки |
| CERTIFICATE_NUMBER | Номер сертификата качества |
| SHIPMENT_TYPE | Тип доставки |
| CAR_NUMBER | Номер транспорта |
| SPECIFICATION_SAP_ID | Номер спецификации |
| POSITION.ID | ID позиции |
| POSITION.MATERIAL_NAME | Наименование материала |
| POSITION.MATERIAL_SAP_ID | Код материала в SAP |
| POSITION.PID | PID |
| POSITION.PACKET_NUMBER | Номер трубы |
| POSITION.PACK_NUMBER | Номер пакета |
| POSITION.SIGN_B_STEAM_PART | Номер партии |
| POSITION.MELT | Номер плавки |