Cервис Дислокации
Для работы с API доступно демо-окружение, где можно протестировать запросы перед использованием в продуктивном контуре. Авторизация осуществляется с использованием Bearer токена, передаваемого в заголовке запроса.
Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку.
Инструкция и пример по получению токена для работы с API доступна по ссылке: https://api-integration.omk.ru/auth/apiDoc.
Параметры
Получает дислокации по одному из параметров:
- SAP_ID - Номер поставки
- STATION_CURRENT_CODE - Код пункта местонахождения
- STATION_END_CODE - Код пункта прибытия
- CAR_NUMBER - Номер транспорта
- TTN_NUMBER - Номер ЖД-квитанции
- limit - Количество записей. На данный момент доступные лимиты 5, 10, 20
- offset - Смещение
С какими сущностями работает
- delivery - Поставки
- delivery_dislocation - Дислокация поставок
- railway_station - Станции ЖД
- delivery_position - Позиции поставок
Как вызвать
Примеры запросов по разным параметрам:
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/dislocation?limit=10&SAP_ID=81912348' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/dislocation?limit=10&STATION_CURRENT_CODE=257800' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
curl -X 'GET' \ 'https://api-integration.omk.ru/api/lk/dislocation?limit=10&TTN_NUMBER=ЭН969463' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp'
Что в ответе
Стандартизованный объект:
Пример ответа
{
"success": true,
"error_code": null,
"data": {
"result": [
{
"SAP_ID": "81912348",
"STATION_END_ID": "797604",
"STATION_END_NAME": "Лангепасовский (рзд)",
"STATION_END_CODE": "797604",
"STATION_END_LAT": "61.27526855",
"STATION_END_LONG": "75.21899414",
"STATION_CURRENT_ID": "257800",
"STATION_CURRENT_NAME": "Янаул",
"STATION_CURRENT_CODE": "257800",
"STATION_CURRENT_LAT": "56.27175903",
"STATION_CURRENT_LONG": "54.92884064",
"CAR_NUMBER": "64051188",
"TTN_NUMBER": "ЭН969463",
"POINT_NAME": "АО \"ВМЗ\"",
"DATE_UPDATE": "2025-07-23 11:35:00",
"DOC_DATE": "2023-09-19 00:00:00",
"WEIGHT": 51.14
},
{
"SAP_ID": "81908210",
"STATION_END_ID": "586504",
"STATION_END_NAME": "Миллерово",
"STATION_END_CODE": "586504",
"STATION_END_LAT": "48.92131805",
"STATION_END_LONG": "40.39269257",
"STATION_CURRENT_ID": "582005",
"STATION_CURRENT_NAME": "Лиски",
"STATION_CURRENT_CODE": "582005",
"STATION_CURRENT_LAT": "50.97949982",
"STATION_CURRENT_LONG": "39.50938416",
"CAR_NUMBER": "54984612",
"TTN_NUMBER": "ЭН554633",
"POINT_NAME": "АО \"ВМЗ\"",
"DATE_UPDATE": "2025-08-04 19:36:00",
"DOC_DATE": "2023-09-12 00:00:00",
"WEIGHT": 57.61
}
],
"total": 2,
"limit": 10,
"offset": 0
}
}
| Название | Описание |
|---|---|
| SAP_ID | Номер поставки |
| STATION_END_ID | Код станции назначения в формате ECP |
| STATION_END_NAME | Имя станции назначения |
| STATION_END_CODE | Код станции назначения без контрольной цифры |
| STATION_END_LAT | Геогр. широта станции назначения |
| STATION_END_LONG | Геогр. долгота станции назначения |
| STATION_CURRENT_ID | Код текущей станции в формате ECP |
| STATION_CURRENT_NAME | Имя текущей станции |
| STATION_CURRENT_CODE | Код текущей станции без контрольной цифры |
| STATION_CURRENT_LAT | Геогр. широта текущей станции |
| STATION_CURRENT_LONG | Геогр. долгота текущей станции |
| CAR_NUMBER | Номер транспорта |
| TTN_NUMBER | Номер накладной |
| POINT_NAME | Завод |
| DATE_UPDATE | Дата обновления дислокации |
| DOC_DATE | Дата накладной |
| WEIGHT | Вес поставки (тонны) |