8-800-200-0811
↑ Все API

Стальной путь

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

Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку по адресу: https://forms.tracker-omk.ru/crm_form_dzpms/ или направляя запрос на электронную почту ОМК Стальной путь Дирекция по продажам

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

Запрос данных. Вагоны.

API производит асинхронную обработку запросов, после первого обращения за данными клиенту выдается идентификатор очереди, затем необходим второй запрос на загрузку данных по полученному идентификатору.

Эндпоинты

  1. Демо: https://api-integration.omk.ru/demo/api/steel-track/vagons
  2. Демо: https://api-integration.omk.ru/demo/api/export_repair_vagons
  3. Прод: https://api-integration.omk.ru/api/steel-track/vagons
  4. Прод: https://api-integration.omk.ru/api/export_repair_vagons

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

curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/vagons?id=1b5c1984-71c2-11ef-bda3-01505685b093' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/vagons?dt1=01.01.2025&dt2=01.03.2025' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/vagons?dt1=01.01.2025&lastchange=true' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/vagons?queue_id=9e8430b2-c583-417e-b74f-3e897302595a' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_vagons?id=1b5c1984-71c2-11ef-bda3-01505685b093' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_vagons?dt1=01.01.2025&dt2=01.03.2025' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_vagons?dt1=01.01.2025&lastchange=true' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_vagons?queue_id=9e8430b2-c583-417e-b74f-3e897302595a&page=1&&per_page=150' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                

Параметры

  • id - Код заказа (Пример: "1b5c1984-71c2-11ef-bda3-00505685b092")
  • dt1 - Начальная дата в формате m.d.Y (Пример:"01.01.2025")
  • dt2 - Конечная дата в формате m.d.Y (Пример:"01.01.2025")
  • lastchange - Если указан, фильтр по датам применяется к дате последнего изменения состояния объекта (Пример: :"true" / "false")
  • queue_id - Идентификатор очереди полученный из предшествующего запроса (Пример: "ab5573ab-f377-4da0-8cff-8b5e00a8e19b")
  • page - Номер страницы для постраничного вывода данных. По умолчанию — 1. Использовать вместе с параметром queue_id для поиска по очереди запросов.
  • per_page - Параметр постраничной навигации. Количество элементов на странице. Если не указано — используется значение по умолчанию (100). Использовать вместе с параметром queue_id для поиска по очереди запросов.

Что в ответе

Пример ответа с созданием очереди
        {
            "success": true,
            "error_code": null,
            "data": "9e8430b2-c583-417e-b74f-3e897302595a"
        }
                                    
Пример ответа поиска по очереди запросов.
{
    "success": true,
    "error_code": null,
    "data": [
        [
            {
                "КодЗаказа": "550e8400-e29b-41d4-a716-446655440000",
                "Код": "550e8400-e29b-41d4-a716-446655440001",
                "Номер": "12345678",
                "КодДепо": "123456789",
                "КлеймоДепо": "AB12",
                "КодСтанции": "123456",
                "ТипВагона": "Полувагон",
                "ГодВыпуска": "2020-01-01T00:00:00",
                "ДатаВводаВсистему": "2025-04-01T00:00:00",
                "ДатаАВР": "2025-04-05T00:00:00",
                "НомерАктаВыпРабот": "АВР-12345",
                "ДатаФиксации": null,
                "НомерСФ": "СФ-54321",
                "ДатаСФ": "2025-04-06T00:00:00",
                "XmlSF": 1,
                "КоррАВР": 0,
                "ЭтоУПД": 0,
                "НачалоРемонта": "2025-04-02T00:00:00",
                "ОкончаниеРемонта": "2025-04-04T00:00:00",
                "ПроверкаСобственником": null,
                "ПробегМежремонтный": 0,
                "ПробегНакопленный": 0,
                "ПробегПослеКапитального": 0,
                "Проверка": "",
                "СтоимостьБезНДС": 10000.50,
                "СтоимостьУборки": 500.00,
                "УборкаВРаботах": 0.00,
                "СтоимостьВзвешивания": 200.00,
                "ИзНихЗаРемонтКП": 3000.00,
                "СтавкаНДС": 20.00,
                "НДС": 2000.10,
                "Скидка": 0.00,
                "ТипРемонта": "КР",
                "Удален": false,
                "Изменен": "2025-04-01T00:00:00",
                "ФиксированнаяСтоимость": 12000.75,
                "ДатаБраковки": "2025-03-15T00:00:00",
                "Договор": {
                    "ДоговорОт": "2024-01-01T00:00:00",
                    "Код": "550e8400-e29b-41d4-a716-446655440002",
                    "НачалоДействия": "2024-01-01T00:00:00",
                    "Номер": "Д-2024/001",
                    "ОкончаниеДействия": "2025-12-31T00:00:00",
                    "СобственникКод": "550e8400-e29b-41d4-a716-446655440003",
                    "РеквизитыДепо": {
                        "ПолноеНаименование": "ООО Депо",
                        "БАНК": "ВТБ",
                        "БИК": "044525187",
                        "РСЧЕТБАНК": "30101810700000000187",
                        "РСЧЕТ": "40702810900000054321",
                        "КПП": "987654321",
                        "ИНН": "0987654321",
                        "ОКОНХ": "54321",
                        "ОКПО": "12345678",
                        "АДРЕС": "г. Санкт-Петербург, ул. Мира, д. 10"
                    },
                    "РеквизитыСобственника": {
                        "ПолноеНаименование": "АО Собственник",
                        "БАНК": "Альфа-Банк",
                        "РСЧЕТБАНК": "30101810200000000700",
                        "РСЧЕТ": "40702810700000098765",
                        "БИК": "044525593",
                        "ИНН": "1122334455",
                        "КПП": "556677889",
                        "ОКПО": "33445566",
                        "АДРЕС": "г. Екатеринбург, ул. Победы, д. 5"
                    },
                },
                "СотрудникиДепо": [
                    {
                        "ФИО": "Иванов Иван Иванович",
                        "Должность": "Мастер",
                        "НаОсновании": "Доверенность №123",
                        "МЧД": "МЧД-001"
                    }
                ],
                "ПредставителиДепо": [
                    {
                        "ФИО": "Петров Петр Петрович",
                        "Должность": "Инженер",
                        "НаОсновании": "Доверенность №124",
                        "МЧД": "МЧД-002"
                    }
                ],
                "ПредставителиСобственника": [
                    {
                        "ФИО": "Сидоров Сидор Сидорович",
                        "Должность": "Директор",
                        "МЧД": "",
                        "НаОсновании": "Доверенность №125"
                    }
                ],
                "РДВ": {
                    "Работа": [
                        {
                            "Код": "Ремонт КП",
                            "ЦенаБезНДС": 3000.00,
                            "Колво": 2.000,
                            "НомераДеталей": "Деталь123"
                        }
                    ],
                    "Деталь": [
                        {
                            "РаботаКод": "Ремонт КП",
                            "Колво": 1.000,
                            "Наименование": "Колесная пара",
                            "ЦенаБезНДС": 1500.00,
                            "ДетальЗавод": "1234",
                            "ДетальНомер": "5678",
                            "ДетальГод": "2023-01-01T00:00:00",
                            "ГруппаДетали": "КП"
                        }
                    ]
                },
                "ДопИнформацияПоРаботам": [
                    {
                        "РаботаКод": "Ремонт КП",
                        "ГруппаДетали": "КП",
                        "ДетальГод": "2023-01-01T00:00:00",
                        "ДетальНомер": "5678",
                        "ДетальЗавод": "1234"
                    }
                ],
                "КоментарииКВагону": [],
                "ПрикрепленныеФайлы": [
                    {
                        "ДатаВремя": "2025-05-01T15:00:00",
                        "BARCODE": "AAA688701W250043071",
                        "SAPDOCID": "B4F13123260849479AAAA2FA9B4C9337",
                        "SAPDOCIDАрхив": "B4F13123260849479AAAA2FA9B4C9337",
                        "ТаблицаВСаперион": "TBL_NAME",
                        "ТаблицаВСаперионАрхив": "TBL_NAME_A",
                        "СтатусСогласования": 1002,
                        "СтатусСогласованияСтрокой": "Требует согласования",
                        "КомментарийОтмены": "",
                        "КодФайла": 1001,
                        "ИмяФайла": "Расчетно-Дефектная Ведомость",
                        "ИДКабинета": "4b1a771a0c27333cbcb537662f68bd37@diadoc.demo",
                        "ИДДокументаЭДО": "e8363142-3d21-35c1-bd55-3318c700fcdb",
                        "ПакетОператораЭДО": "163ae68d-280f-4442-ca98-3ee4e75c6a88",
                        "СтатусДокументаУОперЭДО": "",
                        "СсылкаЭДО": "https://diadoc.kontur.ru/4b1a771a0c27333cbcb537662f68bd37/Document/Show?letterId=163ae68d-280f-4442&documentId=4442-ca98-3ee4e75c6a88",
                        "ТипДокументаЭДО": "Nonformalized",
                        "ТребуетСогласования": 1,
                        "ТребуетПодписания": 1
                    }
                ],
                "ВУ4М": [
                    {
                        "ЗаводПроизводитель": "4714",
                        "СтарыйНомер": "OLD123",
                        "РодВагона": 1,
                        "ГосСобственник": 7,
                        "РучнойТормоз": 1,
                        "ВозможПостанБуферов": 0,
                        "ВоздухоРаспределитель": 2,
                        "ДатаПоследнегоДР": "2024-12-01T00:00:00",
                        "ВЧДРПоследнегоДР": "Депо123",
                        "ДатаПоследнегоКР": "2023-06-01T00:00:00",
                        "ВЧДРПоследнегоКР": "Депо456",
                        "АвторегуляторРП": 1,
                        "РПКомпозитКолодки": 0,
                        "Авторежим": 1,
                        "Тара": 25.500,
                        "Грузоподъемность": 70.000,
                        "ДлинаПоОсям": 12.300,
                        "Габарит": "1-Т",
                        "МатериалКузова": "Сталь",
                        "Модель": "12-123",
                        "ПодпольныеУсБалки": 0.000,
                        "СливнойПрибор": 1,
                        "КалибрКотла": 0.000,
                        "НаличиеРамы": 1,
                        "КонструкцияКотла": 0,
                        "НомерТехРешения": ",",
                        "ДатаТехРешения": null,
                        "СрокСлПродленДо": null,
                        "ТУ": "",
                        "ЗаводскойНомер": "Z12345",
                        "Приписка": 123456,
                        "ИнвентарнТип": "ПВ"
                    }
                ],
                "АктВыбраковки": [
                    {
                        "РаботаОснованиеКод": "Ремонт КП",
                        "КодДетали": "КП-001",
                        "ГруппаДетали": "КП",
                        "СнятаЗавод": "1234",
                        "СнятаНомер": "5678",
                        "СнятаГод": "2023-01-01T00:00:00",
                        "УстанавленаЗавод": "",
                        "УстанавленаНомер": "",
                        "УстанавленаГод": null,
                        "Статус": 0,
                        "Причина": "Износ"
                    }
                ],
                "ВУ36М": {
                    "Номер": "550e8400-e29b-41d4-a716-446655440001",
                    "Код1": "Мод1",
                    "Код2": "Мод2",
                    "Код3": "",
                    "Код4": "",
                    "Код5": "",
                    "Код6": ""
                },
                "АВР": [
                    {
                        "Наименование": "Ремонт вагона",
                        "ЕдИзм": "шт",
                        "Колво": 1.000,
                        "ЦенаБезНДС": 10000.00,
                        "НДС": 2000.00,
                        "СтавкаНДС": 20.00
                    }
                ],
                "МХ1": [
                    {
                        "Наименование": "Лом КП",
                        "Вес": 50.500,
                        "Вид": 0,
                        "ДетальЗавод": "1234",
                        "ДетальНомер": "5678",
                        "ДетальГод": "2023-01-01T00:00:00",
                        "РаботаОснованиеКод": "Ремонт КП",
                        "ТипМеталла": "Сталь",
                        "ГруппаДетали": "КП",
                        "Колво": 1.000,
                        "Стоимость": 500.00
                    }
                ],
                "МХ3": [
                    {
                        "Наименование": "Колесная пара",
                        "ДетальЗавод": "1234",
                        "ДетальНомер": "5678",
                        "ДетальГод": "2023-01-01T00:00:00",
                        "РаботаОснованиеКод": "Ремонт КП",
                        "ГруппаДетали": "КП",
                        "Колво": 1.000,
                        "Стоимость": 1500.00,
                        "Свагона": "12345678",
                        "ДатаМХ1": "2025-03-01T00:00:00",
                        "ДатаОкончанияРемонта": "2025-04-04T00:00:00",
                        "НаВагон": "87654321"
                    }
                ],
                "ЛистКомплектации": {
                    "Номер": "Комп123",
                    "Вход": {
                        "ТормозноеОборудование": [
                            {
                                "ГЧ_ВР": 1,
                                "МЧ_ВР": 1,
                                "РК_ВР": 0,
                                "ТЦ": 1,
                                "Авторежим": 1,
                                "ЗапаснойРезервуар": 0
                            }
                        ],
                        "КП": [
                            {
                                "ГребеньЛ": "30",
                                "ГребеньП": "31",
                                "ОбодЛ": "70",
                                "ОбодП": "71",
                                "Положение": 0,
                                "ПрокатЛ": "5",
                                "ПрокатП": "6",
                                "Сталь": "Сталь Т",
                                "ТипПодш": "Роликовый",
                                "Тележка": 1,
                                "Тип": 1,
                                "Завод": "1234",
                                "Номер": "5678",
                                "Год": "2023-01-01",
                                "ЗаводГВЦ": "1234",
                                "НомерГВЦ": "5678",
                                "ГодГВЦ": "2023-01-01T00:00:00"
                            }
                        ],
                        "ПК": [
                            {
                                "КодКП": 1,
                                "Тип": "Кассетный",
                                "КодТИП": 123,
                                "ДетальЗавод": "1234",
                                "ДетальНомер": "5678",
                                "ДетальГод": "2023-01-01T00:00:00"
                            }
                        ],
                        "СоединительнаяБалка": [
                            {
                                "Завод": "1234",
                                "Номер": "SB001",
                                "Год": "2022-01-01T00:00:00",
                                "Тележка": 1,
                                "Положение": 0
                            }
                        ],
                        "НадресорнаяБалка": [
                            {
                                "Завод": "1234",
                                "Номер": "NB001",
                                "Год": "2022-01-01T00:00:00",
                                "Тележка": 1,
                                "МодельТележки": "18-100",
                                "Положение": 0,
                                "ЗаводГВЦ": "1234",
                                "НомерГВЦ": "NB001",
                                "ГодГВЦ": "2022-01-01T00:00:00"
                            }
                        ],
                        "РамаБоковая": [
                            {
                                "Завод": "1234",
                                "Номер": "RB001",
                                "Год": "2022-01-01T00:00:00",
                                "Тележка": 1,
                                "Положение": 0,
                                "ЗаводГВЦ": "1234",
                                "НомерГВЦ": "RB001",
                                "ГодГВЦ": "2022-01-01T00:00:00"
                            }
                        ],
                        "Автосцепка": [
                            {
                                "Завод": "1234",
                                "Номер": "AC001",
                                "Год": "2022-01-01T00:00:00",
                                "Положение": 1,
                                "Тип": "СА-3"
                            }
                        ],
                        "ПоглощающийАппарат": [
                            {
                                "Положение": 1,
                                "Завод": "1234",
                                "Номер": "PA001",
                                "Год": "2022-01-01T00:00:00",
                                "Тип": "ПМК-110"
                            }
                        ],
                        "ТяговыйХомут": [
                            {
                                "Завод": "1234",
                                "Номер": "TH001",
                                "Год": "2022-01-01T00:00:00",
                                "Положение": 1
                            }
                        ]
                    },
                    "Выход": {
                        "ТормозноеОборудование": [
                            {
                                "ГЧ_ВР": 1,
                                "МЧ_ВР": 1,
                                "РК_ВР": 0,
                                "ТЦ": 1,
                                "Авторежим": 1,
                                "ЗапаснойРезервуар": 0
                            }
                        ],
                        "КП": [
                            {
                                "ГребеньЛ": "30",
                                "ГребеньП": "31",
                                "ОбодЛ": "70",
                                "ОбодП": "71",
                                "Положение": 0,
                                "ПрокатЛ": "5",
                                "ПрокатП": "6",
                                "Сталь": "Сталь Т",
                                "ТипПодш": "Роликовый",
                                "Тележка": 1,
                                "Тип": "Тип1",
                                "Завод": "1234",
                                "Номер": "5678",
                                "Год": "2023-01-01",
                                "ВКМ": 0,
                                "ДатаОСВ": "2025-04-01T00:00:00",
                                "РемТип": 1,
                                "Происхождение": 4
                            }
                        ],
                        "ПК": [
                            {
                                "КодКП": 1,
                                "Тип": "Кассетный",
                                "КодТИП": 123,
                                "ДетальЗавод": "1234",
                                "ДетальНомер": "5678",
                                "ДетальГод": "2023-01-01T00:00:00",
                                "Происхождение": 1
                            }
                        ],
                        "СоединительнаяБалка": [
                            {
                                "Завод": "1234",
                                "Номер": "SB002",
                                "Год": "2023-01-01T00:00:00",
                                "Тележка": 1,
                                "Положение": 0,
                                "Происхождение": 1
                            }
                        ],
                        "НадресорнаяБалка": [
                            {
                                "Завод": "1234",
                                "Номер": "NB002",
                                "Год": "2023-01-01T00:00:00",
                                "Тележка": 1,
                                "МодельТележки": "18-100",
                                "Положение": 0,
                                "Происхождение": 1
                            }
                        ],
                        "РамаБоковая": [
                            {
                                "Завод": "1234",
                                "Номер": "RB002",
                                "Год": "2023-01-01T00:00:00",
                                "Тележка": 1,
                                "Положение": 0,
                                "Происхождение": 1
                            }
                        ],
                        "Автосцепка": [
                            {
                                "Завод": "1234",
                                "Номер": "AC002",
                                "Год": "2023-01-01T00:00:00",
                                "Положение": 1,
                                "Тип": "СА-3",
                                "Происхождение": 1
                            }
                        ],
                        "ПоглощающийАппарат": [
                            {
                                "Положение": 1,
                                "Завод": "1234",
                                "Номер": "PA002",
                                "Год": "2023-01-01T00:00:00",
                                "Тип": "ПМК-110",
                                "Происхождение": 1
                            }
                        ],
                        "ТяговыйХомут": [
                            {
                                "Завод": "1234",
                                "Номер": "TH002",
                                "Год": "2023-01-01T00:00:00",
                                "Положение": 1
                            }
                        ]
                    }
                }
            }
        ]
    ],
    "paginate": {
        "current_page": 1,
        "per_page": 100,
        "total": 2,
        "last_page": 1
    }
}
                                    
Пояснения по значениям полей
  1. КоррАВР: 0 - АВР, 1- Корректировочный АВР, 2- Исправительный АВР
  2. ЛистКомплектации.Вход.ТормозноеОборудование.ГЧ_ВР, ЛистКомплектации.Вход.ТормозноеОборудование.МЧ_ВР, ЛистКомплектации.Вход.ТормозноеОборудование.РК_ВР, ЛистКомплектации.Вход.ТормозноеОборудование.ТЦ, ЛистКомплектации.Вход.ТормозноеОборудование.Авторежим, ЛистКомплектации.Вход.ТормозноеОборудование.ЗапаснойРезервуар, ЛистКомплектации.Выход.ТормозноеОборудование.ГЧ_ВР, ЛистКомплектации.Выход.ТормозноеОборудование.МЧ_ВР, ЛистКомплектации.Выход.ТормозноеОборудование.РК_ВР, ЛистКомплектации.Выход.ТормозноеОборудование.ТЦ, ЛистКомплектации.Выход.ТормозноеОборудование.Авторежим, ЛистКомплектации.Выход.ТормозноеОборудование.ЗапаснойРезервуар: 1 - истина, 0 - ложь
  3. ЛистКомплектации.Вход.КП.Положение, ЛистКомплектации.Выход.КП.Положение: 0 - Передняя, 1 - Задняя
  4. ЛистКомплектации.Вход.СоединительнаяБалка.Положение, ЛистКомплектации.Выход.СоединительнаяБалка.Положение: 0 - Слева, 1 - Справа
  5. ЛистКомплектации.Вход.НадресорнаяБалка.Положение, ЛистКомплектации.Выход.НадресорнаяБалка.Положение: 0 - Слева, 1 - Справа
  6. ЛистКомплектации.Вход.РамаБоковая.Положение, ЛистКомплектации.Выход.РамаБоковая.Положение: 0 - Слева, 1 - Справа
  7. ЛистКомплектации.Вход.Автосцепка.Положение, ЛистКомплектации.Выход.Автосцепка.Положение: 1 - Первая, 2 - Вторая
  8. ЛистКомплектации.Вход.ПоглощающийАппарат.Положение, ЛистКомплектации.Выход.ПоглощающийАппарат.Положение: 1 - Первый, 2 - Второй
  9. ЛистКомплектации.Вход.ТяговыйХомут.Положение, ЛистКомплектации.Выход.ТяговыйХомут.Положение: 1 - Первый, 2 - Второй

*Примечание: точный набор полей в ответе может варьироваться в зависимости от данных и запроса

Название Тип Описание
КодЗаказа Строка (50) GUID ЗК
Код Строка (50) GUID Вагона
Номер Строка (11) Номер вагона
КодДепо Строка (9) Код депо
КлеймоДепо Строка (4)
КодСтанции Строка (6)
ТипВагона Строка (100)
ГодВыпуска Дата
ДатаВводаВсистему Дата Дата заказа клиента
ДатаАВР Дата
НомерАктаВыпРабот Строка (15)
ДатаФиксации Дата Отправляем пустым
НомерСФ Строка (15)
ДатаСФ Дата
XmlSF Число (1) В зависимости от признака "Использовать ЦО" в ЗК и "Выставлен в электронном виде" в СФ
КоррАВР Число (1) В зависимости от наличия корр документов. 0 - АВР, 1- Корректировочный АВР, 2- Исправительный АВР
ЭтоУПД Число (1) Отправляется 0
НачалоРемонта Дата
ОкончаниеРемонта Дата
ПроверкаСобственником Дата Передаем пустой датой
ПробегМежремонтный Число (15:3) Передаем 0, в дальнейшем возможна передача данных
ПробегНакопленный Число (15:3) Передаем 0, в дальнейшем возможна передача данных
ПробегПослеКапитального Число (15:3) Передаем 0, в дальнейшем возможна передача данных
Проверка Строка (14) Передаем пустой
СтоимостьБезНДС Число (15:2)
СтоимостьУборки Число (15:2) Для строки номенклатуры "Подача-уборка"
УборкаВРаботах Число (15:2) Для строки номенклатуры "Подача-уборка" при условии включения уборки в стоимость
СтоимостьВзвешивания Число (15:2) Для строки номенклатуры "Взвешивание вагона"
ИзНихЗаРемонтКП Число (15:2) Для строки номенклатуры по ремонту КП
СтавкаНДС Число (15:2)
НДС Число (15:2)
Скидка Число (15:2) Передаем пустой.
ТипРемонта Строка (50)
Удален Булево Значения true или false
Изменен Дата При изменении даты ЗК
ФиксированнаяСтоимость Число (15:2) Строки с установленным признаком "Фиксированная стоимость"
ДатаБраковки Дата
Договор.
ДоговорОт Дата
Код Строка (50)
НачалоДействия Дата
Номер Строка (150)
ОкончаниеДействия Дата
СобственникКод Строка (50)
Договор. РеквизитыДепо.
ПолноеНаименование Строка (300) Наименование банка
БАНК Строка (300) Наименование банка
БИК Строка (300)
РСЧЕТБАНК Строка (300)
РСЧЕТ Строка (300)
КПП Строка (300)
ИНН Строка (300)
ОКОНХ Строка (300)
ОКПО Строка (300)
АДРЕС Строка (300)
Договор. РеквизитыСобственника.
ПолноеНаименование Строка (300)
БАНК Строка (300)
РСЧЕТБАНК Строка (300)
РСЧЕТ Строка (300)
БИК Строка (300)
ИНН Строка (300)
КПП Строка (300)
ОКПО Строка (300)
АДРЕС Строка (300)
СотрудникиДепо. Массив.
ФИО Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
Должность Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
НаОсновании Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
МЧД Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
ПредставителиДепо. Массив.
ФИО Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
Должность Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
НаОсновании Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
МЧД Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
ПредставителиСобственника. Массив.
ФИО Строка (300)
Должность Строка (300)
МЧД Строка (300) В текущей итерации нет информации о МЧД собственника
НаОсновании Строка (300)
РДВ. Работа. Массив.
Код Строка неограниченная Используется механизм произвольного наименования
ЦенаБезНДС Число (15:2)
Колво Число (15:3)
НомераДеталей Строка (300)
РДВ. Деталь. Массив.
РаботаКод Строка неограниченная
Колво Число (15:3)
Наименование Строка (300)
ЦенаБезНДС (15:2)
ДетальЗавод Строка (4)
ДетальНомер Строка (50)
ДетальГод Дата
ГруппаДетали Строка (300)
ДопИнформацияПоРаботам. Массив.
РаботаКод Строка неограниченная
ГруппаДетали Строка (300)
ДетальГод Дата
ДетальНомер Строка (50)
ДетальЗавод Строка (4)
КоментарииКВагону. Массив.
ДатаВремя Дата На текущий момент не передается
Текст Строка (500) На текущий момент не передается
ФИО Строка (300) На текущий момент не передается
ПрирепленФайл Булево На текущий момент не передается
Отклонение Булево На текущий момент не передается
ПрикрепленныеФайлы. Массив.
BARCODE Строка (50) Уникальный идентификатор документа
SAPDOCID Строка (50)
SAPDOCIDАрхив Строка (50)
ТаблицаВСаперион Строка (50)
ТаблицаВСаперионАрхив Строка (50)
СтатусСогласования Число (9) Числовой код статуса согласования
СтатусСогласованияСтрокой Строка (150) Наименование статуса согласования
КомментарийОтмены Строка (неограниченная)
КодФайла Строка (9)
ИДКабинета Строка (неограниченная) ИД кабинета
ИДДокументаЭДО Строка (неограниченная) ИД документа ЭДО
ПакетОператораЭДО Строка (неограниченная) Пакет оператора ЭДО
СтатусДокументаУОперЭДО Строка (неограниченная) Статус документа у оператора ЭДО, появляется при начале процесса подписания
СсылкаЭДО Строка (неограниченная) Ссылка на документ Диадок
ТипДокументаЭДО Строка (неограниченная) Тип документа ЭДО
ТребуетСогласования Число (1) Истина - 1, Ложь - 0
ТребуетПодписания Число (1) Истина - 1, Ложь - 0
ВУ4М. Массив.
ЗаводПроизводитель Строка (15)
СтарыйНомер Строка (15)
РодВагона Число (10)
ГосСобственник Число (10)
РучнойТормоз Число (10)
ВозможПостанБуферов Число (10)
ВоздухоРаспределитель Число (10)
ДатаПоследнегоДР Дата
ВЧДРПоследнегоДР Строка (500)
ДатаПоследнегоКР Дата
ВЧДРПоследнегоКР Строка (500)
АвторегуляторРП Число (10)
РПКомпозитКолодки Число (10)
Авторежим Число (10)
Тара Число (15:3)
Грузоподъемность Число (15:3)
ДлинаПоОсям Число (15:3)
Габарит Строка (150)
МатериалКузова Строка (150)
Модель Строка (150)
ПодпольныеУсБалки Число (15:3)
СливнойПрибор Число (10)
КалибрКотла Число (15:3)
НаличиеРамы Число (10)
КонструкцияКотла Число (10)
НомерТехРешения Строка (100)
ДатаТехРешения Дата
СрокСлПродленДо Дата
ТУ Строка (50)
ЗаводскойНомер Строка (50)
Приписка Число (10)
ИнвентарнТип Строка (150)
АктВыбраковки. Массив.
РаботаОснованиеКод Строка неограниченная Используется механизм произвольного наименования
КодДетали Строка (300)
ГруппаДетали Строка (300)
СнятаЗавод Строка (4) Для акта выбраковки
СнятаНомер Строка (50) Для акта выбраковки
СнятаГод Дата Для акта выбраковки
УстанавленаЗавод Строка (4) Для акта разбраковки
УстанавленаНомер Строка (50) Для акта разбраковки
УстанавленаГод Дата Для акта разбраковки
Статус Число (5) Пока что пустая
Причина Строка (300)
ВУ36М.
Номер Строка (50) GUID вагона
Код1 Строка (300)
Код2 Строка (300)
Код3 Строка (300)
Код4 Строка (300)
Код5 Строка (300)
Код6 Строка (300)
АВР. Массив.
Наименование Строка неограниченная
ЕдИзм Строка (50)
Колво Число (15:3)
ЦенаБезНДС Число (15:3)
НДС Число (15:3)
СтавкаНДС Число (15:3)
МХ1. Массив.
Наименование Строка неограниченная Приемка по реквизиту "Заказ на производство". Произвольное наименование по аналогии с РДВ.
Вес Число (15:3) Только для вида номенклатуры "Лом"
Вид Число (15:3) В насоящий момент заполняется пустым
ДетальЗавод Строка (4)
ДетальНомер Строка (50)
ДетальГод Дата
РаботаОснованиеКод Строка (300) Из произвольногоь наименования работы, на основании которой была снята деталь
ТипМеталла Строка (50) Только для вида номенклатуры "Лом".
ГруппаДетали Строка (100)
Колво Число (15:3)
Стоимость Число (15:3)
МХ3. Массив.
Наименование Строка (300)
ДетальЗавод Строка (4)
ДетальНомер Строка (50)
ДетальГод Дата
РаботаОснованиеКод Строка Неограниченная Из произвольного наименования работы, на основании которой была снята деталь
ГруппаДетали Строка (100)
Колво Число (15:3)
Стоимость Число (15:3)
Свагона Строка (50) По партии номер вагона с которого была снята деталь
ДатаМХ1 Дата Из документа поступления, дата входящего
ДатаОкончанияРемонта Дата Из ЗНП для вагона с которого деталь была снята
НаВагон Строка (50) Номер Вагона, на который деталь установлена
ЛистКомплектации.
Номер Строка (150)
ЛистКомплектации. Вход.
ЛистКомплектации. Вход. ТормозноеОборудование. Массив.
ГЧ_ВР Число (1) Истина - 1, Ложь - 0
МЧ_ВР Число (1) Истина - 1, Ложь - 0
РК_ВР Число (1) Истина - 1, Ложь - 0
ТЦ Число (1) Истина - 1, Ложь - 0
Авторежим Число (1) Заполнен - 1, Не заполнен - 0
ЗапаснойРезервуар Число (1) Истина - 1, Ложь - 0
ЛистКомплектации. Вход. КП. Массив.
ГребеньЛ Строка (50) Для вида номенклатуры "Пары колесные"
ГребеньП Строка (50) Для вида номенклатуры "Пары колесные"
ОбодЛ Строка (50) Для вида номенклатуры "Пары колесные"
ОбодП Строка (50) Для вида номенклатуры "Пары колесные"
Положение Число (1) Для вида номенклатуры "Пары колесные". Передняя - 0, Задняя - 1
ПрокатЛ Строка (50) Для вида номенклатуры "Пары колесные"
ПрокатП Строка (50) Для вида номенклатуры "Пары колесные"
Сталь Строка (50) Для вида номенклатуры "Пары колесные"
ТипПодш Строка (50). Для вида номенклатуры "Пары колесные". Согласно справочнику РЖД
Тележка Число (3) Для вида номенклатуры "Пары колесные". Порядковый Номер Тележки
Тип Число (3) Для вида номенклатуры "Пары колесные". Тип торцевого крепления
Завод Строка (4) Для вида номенклатуры "Пары колесные"
Номер Строка (50) Для вида номенклатуры "Пары колесные"
Год Дата Для вида номенклатуры "Пары колесные"
ЗаводГВЦ Строка (4) Для вида номенклатуры "Пары колесные"
НомерГВЦ Строка (50) Для вида номенклатуры "Пары колесные"
ГодГВЦ Дата Для вида номенклатуры "Пары колесные"
ЛистКомплектации. Вход. ПК. Массив.
КодКП Число (10) Только для КП, с которого снят кассетный подшибник
Тип Строка (150) Только для КП, с которого снят кассетный подшибник
КодТИП Число (10) Только для КП, с которого снят кассетный подшибник
ДетальЗавод Строка (4) Только для КП, с которого снят кассетный подшибник
ДетальНомер Строка (50) Только для КП, с которого снят кассетный подшибник
ДетальГод Дата Только для КП, с которого снят кассетный подшибник
ЛистКомплектации. Вход. СоединительнаяБалка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
Положение Число (1) Слева - 0, Справа - 1
ЛистКомплектации. Вход. НадресорнаяБалка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
МодельТележки Строка (50)
Положение Число (1) Для вида номенклатуры "Пары колесные". Передняя - 0, Задняя - 1
ЗаводГВЦ Строка (4)
НомерГВЦ Строка (50)
ГодГВЦ Дата
ЛистКомплектации. Вход. РамаБоковая. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
Положение Число (1) Слева - 0, Справа - 1
ЗаводГВЦ Строка (4)
НомерГВЦ Строка (50)
ГодГВЦ Дата
ЛистКомплектации. Вход. Автосцепка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Положение Число (1) Первая - 1, Вторая - 2
Тип Строка (50)
ЛистКомплектации. Вход. ПоглощающийАппарат. Массив.
Положение Число (1) Первый - 1, Второй - 2
Завод Строка (4)
Номер Строка (50)
Год Дата
Тип Стирока (50)
ЛистКомплектации. Вход. ТяговыйХомут. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Положение Число (1) Первый - 1, Второй - 2
ЛистКомплектации. Выход. ТормозноеОборудование. Массив.
ГЧ_ВР Число (1) Истина - 1, Ложь - 0
МЧ_ВР Число (1) Истина - 1, Ложь - 0
РК_ВР Число (1) Истина - 1, Ложь - 0
ТЦ Число (1) Истина - 1, Ложь - 0
Авторежим Число (1) Заполнен - 1, Не заполнен - 0
ЗапаснойРезервуар Число (1) Истина - 1, Ложь - 0
ЛистКомплектации. Выход. КП. Массив.
ГребеньЛ Строка (50) Для вида номенклатуры "Пары колесные"
ГребеньП Строка (50) Для вида номенклатуры "Пары колесные"
ОбодЛ Строка (50) Для вида номенклатуры "Пары колесные"
ОбодП Строка (50) Для вида номенклатуры "Пары колесные"
Положение Число (1) Для вида номенклатуры "Пары колесные". Слева - 0, Справа - 1
ПрокатЛ Строка (50) Для вида номенклатуры "Пары колесные"
ПрокатП Строка (50) Для вида номенклатуры "Пары колесные"
Сталь Строка (50) Для вида номенклатуры "Пары колесные"
ТипПодш Строка (50) Для вида номенклатуры "Пары колесные". Согласно справочнику РЖД
Тележка Число (3) Для вида номенклатуры "Пары колесные". Порядковый Номер Тележки
Тип Строка (50) Для вида номенклатуры "Пары колесные". Тип торцевого крепления
Завод Строка (4) Для вида номенклатуры "Пары колесные"
Номер Строка (50) Для вида номенклатуры "Пары колесные"
Год Дата Для вида номенклатуры "Пары колесные"
ВКМ Число (10)
ДатаОСВ Дата
РемТип Число (10)
Происхождение Число (10)
ЛистКомплектации. Выход. ПК. Массив.
КодКП Число (10) Только для КП, с которого снят кассетный подшибник
Тип Строка (50) Только для КП, с которого снят кассетный подшибник
КодТИП Число (10) Только для КП, с которого снят кассетный подшибник
ДетальЗавод Строка (4) Только для КП, с которого снят кассетный подшибник
ДетальНомер Строка (50) Только для КП, с которого снят кассетный подшибник
ДетальГод Дата Только для КП, с которого снят кассетный подшибник
Происхождение Число (10)
ЛистКомплектации. Выход. СоединительнаяБалка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
Положение Число (1) Слева - 0, Справа - 1
Происхождение Число (10)
ЛистКомплектации. Выход. НадресорнаяБалка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
МодельТележки Строка (50)
Положение Число (1) Слева - 0, Спарва - 1
Происхождение Число (10)
ЛистКомплектации. Выход. РамаБоковая. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Тележка Число (3) Порядковый номер тележки
Положение Число (1) Слева - 0, Спарва - 1
Происхождение Число (10)
ЛистКомплектации. Выход. Автосцепка. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Положение Число (1) Первая - 1, Вторая - 2
Тип Строка (50)
Происхождение Число (10)
ЛистКомплектации. Выход. ПоглощающийАппарат. Массив.
Положение Число (1) Первый - 1, Второй - 2
Завод Строка (4)
Номер Строка (50)
Год Дата
Тип Стирока (50)
Происхождение Число (10)
ЛистКомплектации. Выход. ТяговыйХомут. Массив.
Завод Строка (4)
Номер Строка (50)
Год Дата
Положение Число (1) Первый - 1, Второй - 2

Запрос данных. Детали.

API производит асинхронную обработку запросов, после первого обращения за данными клиенту выдается идентификатор очереди, затем необходим второй запрос на загрузку данных по полученному идентификатору.

Эндпоинты

  1. Демо: https://api-integration.omk.ru/demo/api/steel-track/details
  2. Демо: https://api-integration.omk.ru/demo/api/export_repair_details
  3. Прод: https://api-integration.omk.ru/api/steel-track/details
  4. Прод: https://api-integration.omk.ru/api/export_repair_details

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

curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/details?id=1b5c1984-71c2-11ef-bda3-01505685b093' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/details?dt1=01.01.2025&dt2=01.03.2025' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/details?dt1=01.01.2025&lastchange=true' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/details?queue_id=9e8430b2-c583-417e-b74f-3e897302595a' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_details?id=1b5c1984-71c2-11ef-bda3-01505685b093' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_details?dt1=01.01.2025&dt2=01.03.2025' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_details?dt1=01.01.2025&lastchange=true' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/export_repair_details?queue_id=9e8430b2-c583-417e-b74f-3e897302595a&page=1&per_page=150' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                

Параметры:

  • id - Код заказа (Пример: "1b5c1984-71c2-11ef-bda3-00505685b092")
  • dt1 - Начальная дата в формате m.d.Y (Пример:"01.01.2025")
  • dt2 - Конечная дата в формате m.d.Y (Пример:"01.01.2025")
  • lastchange - Если указан, фильтр по датам применяется к дате последнего изменения состояния объекта (Пример: :"true" / "false")
  • queue_id - Идентификатор очереди полученный из предшествующего запроса (Пример: "ab5573ab-f377-4da0-8cff-8b5e00a8e19b")
  • page - Номер страницы для постраничного вывода данных. По умолчанию — 1. Использовать вместе с параметром queue_id для поиска по очереди запросов.
  • per_page - Параметр постраничной навигации. Количество элементов на странице. Если не указано — используется значение по умолчанию (100). Использовать вместе с параметром queue_id для поиска по очереди запросов.
Пример ответа с созданием очереди
        {
            "success": true,
            "error_code": null,
            "data": "9e8430b2-c583-417e-b74f-3e897302595a"
        }
                                    
Пример ответа поиска по очереди запросов.
{
    "success": true,
    "error_code": null,
    "data": [
        [
            {
                "КодЗаказа": "550e8400-e29b-41d4-a716-446655440000",
                "Номер": "ЗК-12345678",
                "КодДепо": "123456789",
                "КлеймоДепо": "AB12",
                "КодСтанции": "123456",
                "ДатаНачалаРемонта": "2025-04-02T00:00:00",
                "ДатаОкончанияРемонта": "2025-04-04T00:00:00",
                "ПроверкаСобственником": null,
                "Проверка": "",
                "XmlSF": 1,
                "КоррАВР": 0,
                "ДатаВводаВсистему": "2025-04-01T00:00:00",
                "Изменен": "2025-04-01T00:00:00",
                "Договор": {
                    "РеквизитыДепо": {
                        "ПолноеНаименование": "ООО Депо",
                        "БАНК": "ВТБ",
                        "БИК": "044525187",
                        "РСЧЕТБАНК": "30101810700000000187",
                        "РСЧЕТ": "40702810900000054321",
                        "КПП": "987654321",
                        "ИНН": "0987654321",
                        "ОКОНХ": "54321",
                        "ОКПО": "12345678",
                        "АДРЕС": "г. Санкт-Петербург, ул. Мира, д. 10"
                    },
                    "РеквизитыСобственника": {
                        "ПолноеНаименование": "АО Собственник",
                        "БАНК": "Альфа-Банк",
                        "РСЧЕТБАНК": "30101810200000000700",
                        "РСЧЕТ": "40702810700000098765",
                        "БИК": "044525593",
                        "ИНН": "1122334455",
                        "КПП": "556677889",
                        "ОКПО": "33445566",
                        "АДРЕС": "г. Екатеринбург, ул. Победы, д. 5"
                    },
                    "ДоговорОт": "2024-01-01T00:00:00",
                    "Код": "550e8400-e29b-41d4-a716-446655440002",
                    "НачалоДействия": "2024-01-01T00:00:00",
                    "Номер": "Д-2024/001",
                    "ОкончаниеДействия": "2025-12-31T00:00:00",
                    "СобственникКод": "550e8400-e29b-41d4-a716-446655440003"
                },
                "ПредставителиДепо": [
                    {
                        "ФИО": "Петров Петр Петрович",
                        "Должность": "Инженер",
                        "НаОсновании": "Доверенность №124",
                        "МЧД": "МЧД-002"
                    }
                ],
                "ПредставителиСобственника": [
                    {
                        "ФИО": "Сидоров Сидор Сидорович",
                        "Должность": "Директор",
                        "МЧД": "",
                        "НаОсновании": "Доверенность №125"
                    }
                ],
                "Деталь": [
                    {
                        "Код": "550e8400-e29b-41d4-a716-446655440004",
                        "ДетальОсталасьНаСкладе": 1,
                        "ДопИнформ": "",
                        "ГруппаДетали": "КП",
                        "Тип": "Колесная пара",
                        "ДетальЗавод": "1234",
                        "ДетальНомер": "5678",
                        "ДетальГод": "2023-01-01T00:00:00",
                        "Статус": 1,
                        "КолВо": 1.000,
                        "Наименование": "Колесная пара",
                        "ОценочнаяСтоимость": 1500.00,
                        "Свагона": "",
                        "СВагонаКод": "",
                        "Работа": [
                            {
                                "Код": "Ремонт КП",
                                "КолВо": 1.000,
                                "ЦенаБезНДС": 3000.00
                            }
                        ],
                        "Возврат": [
                            {
                                "ГруппаДетали": "КП",
                                "РаботаОснованиеКод": "Ремонт КП",
                                "КолВо": 1.000,
                                "ТипМеталла": "",
                                "Вес": 0.000,
                                "Стоимость": 1500.00
                            }
                        ],
                        "Лом": [
                            {
                                "Вес": 50.500,
                                "РаботаОснованиеКод": "Ремонт КП",
                                "ТипМеталла": "Сталь",
                                "ГруппаДетали": "Лом",
                                "КолВо": 1.000,
                                "ЕдИзм": "кг",
                                "ЕдИзмОКЕИ": "166",
                                "Стоимость": 500.00
                            }
                        ],
                        "ИспДеталь": [
                            {
                                "КодРаботы": "Ремонт КП",
                                "ГруппаДетали": "КП",
                                "КолВо": 1.000,
                                "ЦенаБезНДС": 1500.00
                            }
                        ],
                        "КП": {
                            "ОбодЛ": "70",
                            "ОбодП": "71",
                            "ГребеньЛ": "30",
                            "ГребеньП": "31",
                            "ОбодЛДо": "72",
                            "ОбодПДо": "73",
                            "ГребеньЛДо": "32",
                            "ГребеньПДо": "33",
                            "ТипКП": "Роликовый",
                            "Диск": [
                                {
                                    "ТолщинаОбода": "70"
                                }
                            ],
                            "Подшибник": [
                                {
                                    "Завод": "1234",
                                    "Номер": "P001",
                                    "Год": "2023-01-01T00:00:00",
                                    "ТипПодш": "Кассетный"
                                }
                            ]
                        }
                    }
                ],
                "АВР": [
                    {
                        "Наименование": "Ремонт детали",
                        "ЕдИзм": "шт",
                        "Колво": 1.000,
                        "ЦенаБезНДС": 3000.00,
                        "НДС": 600.00,
                        "СтавкаНДС": 20.00
                    }
                ],
                "ПрикрепленныеФайлы": [
                    {
                        "ДатаВремя": "2025-05-01T15:00:00",
                        "BARCODE": "AAA688701W250043071",
                        "SAPDOCID": "B4F13123260849479AAAA2FA9B4C9337",
                        "SAPDOCIDАрхив": "B4F13123260849479AAAA2FA9B4C9337",
                        "ТаблицаВСаперион": "TBL_NAME",
                        "ТаблицаВСаперионАрхив": "TBL_NAME_A",
                        "СтатусСогласования": 1002,
                        "СтатусСогласованияСтрокой": "Требует согласования",
                        "КомментарийОтмены": "",
                        "КодФайла": 1001,
                        "ИмяФайла": "Расчетно-Дефектная Ведомость",
                        "ИДКабинета": "4b1a771a0c27333cbcb537662f68bd37@diadoc.demo",
                        "ИДДокументаЭДО": "e8363142-3d21-35c1-bd55-3318c700fcdb",
                        "ПакетОператораЭДО": "163ae68d-280f-4442-ca98-3ee4e75c6a88",
                        "СтатусДокументаУОперЭДО": "",
                        "СсылкаЭДО": "https://diadoc.kontur.ru/4b1a771a0c27333cbcb537662f68bd37/Document/Show?letterId=163ae68d-280f-4442&documentId=4442-ca98-3ee4e75c6a88",
                        "ТипДокументаЭДО": "Nonformalized",
                        "ТребуетСогласования": 1,
                        "ТребуетПодписания": 1
                    }
                ]
            }
        ]
    ]
}
                                    
Пояснения по значениям полей
  1. КоррАВР: 0 - АВР, 1- Корректировочный АВР, 2- Исправительный АВР
  2. Деталь.Статус: 0 - не ремонтировалась, 1 - отремонтирована, 2 - брак, 3 - определение ремонтопригодности, 4 - Расформирована, 5 - Брак Оси КП, 6 - Исправна, 7 - Формирование, 8 - Брак букс

*Примечание: точный набор полей в ответе может варьироваться в зависимости от данных и запроса

Название Тип Описание
КодЗаказа Строка (50) GUID ЗК
Номер Строка (11) Номер вагона
КодДепо Строка (9) Код депо
КлеймоДепо Строка (4)
КодСтанции Строка (6)
ДатаНачалаРемонта Дата
ДатаОкончанияРемонта Дата
ПроверкаСобственником Дата Передаем пустой датой
Проверка Строка (14) Передаем пустой
ДатаВводаВсистему Дата Дата заказа клиента
XmlSF Число (1) В зависимости от признака "Использовать ЦО" в ЗК и "Выставлен в электронном виде" в СФ
КоррАВР Число (1) В зависимости от наличия корр документов. 0 - АВР, 1- Корректировочный АВР, 2- Исправительный АВР
Изменен Дата При изменении даты ЗК
Договор.
ДоговорОт Дата
Код Строка (50)
НачалоДействия Дата
Номер Строка (150)
ОкончаниеДействия Дата
СобственникКод Строка (50)
Договор. РеквизитыДепо.
ПолноеНаименование Строка (300) Наименование банка
БАНК Строка (300) Наименование банка
БИК Строка (300)
РСЧЕТБАНК Строка (300)
РСЧЕТ Строка (300)
КПП Строка (300)
ИНН Строка (300)
ОКОНХ Строка (300)
ОКПО Строка (300)
АДРЕС Строка (300)
Договор. РеквизитыСобственника.
ПолноеНаименование Строка (300)
БАНК Строка (300)
РСЧЕТБАНК Строка (300)
РСЧЕТ Строка (300)
БИК Строка (300)
ИНН Строка (300)
КПП Строка (300)
ОКПО Строка (300)
АДРЕС Строка (300)
ПредставителиДепо. Массив.
ФИО Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
Должность Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
НаОсновании Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
МЧД Строка (300) Или на основании справочника "Ответсвенные лица организаци". В зависимости от механизма указания подписанта.
ПредставителиСобственника. Массив.
ФИО Строка (300)
Должность Строка (300)
МЧД Строка (300) В текущей итерации нет информации о МЧД собственника
НаОсновании Строка (300)
Деталь. Массив.
Код Строка (50) GUID детали из ЗНП
ДетальОсталасьНаСкладе Число (1) Если есть приемка ОХ, но нет отгрузки ОХ отправляем 1. Есть отгрузка - отправляем 0
ДопИнформ Строка (500) Доп информация. Передаем пустой
ГруппаДетали Строка (50) Из ЭП получаем ремонтируемую деталь. Из нее получаем вид номенклатуры
Тип Строка (50) Для автосцепки и тягового хомута. Из ремонтируемой детали получаем номенклатуру и из нее получаем тип/вид ПА и тягового хомута
ДетальЗавод Строка (4)
ДетальНомер Строка (50)
ДетальГод Дата
Статус Число (2) 0 - не ремонтировалась, 1 - отремонтирована, 2 - брак, 3 - определение ремонтопригодности, 4 - Расформирована, 5 - Брак Оси КП, 6 - Исправна, 7 - Формирование, 8 - Брак букс
КолВо Число (15:3)
Наименование Строка (300) Получаем ремонтируемую деталь
ОценочнаяСтоимость Число (15:3)
Свагона Строка (50) Для ремонта детали нет способа определить связь ЗК и приемки ОХ
СВагонаКод Строка (50) Для ремонта детали нет способа определить связь ЗК и отгрузки ОХ
Деталь. Работа. Массив.
Код Строка Неограниченная Произвольное наименование работ
КолВо Число (15:3)
ЦенаБезНДС Число (15:2)
Деталь. Возврат. Массив.
ГруппаДетали Строка (100)
РаботаОснованиеКод Строка Неограниченная Из произвольного наименования работы, на основании которой была снята деталь
КолВо Число (15:3)
ТипМеталла Строка (50) Только для вида номенклатуры ""Лом"".
Вес Число (15:3) Только для вида номенклатуры ""Лом""
Стоимость Число (15:2)
Деталь. Лом. Массив.
Вес Число (15:3) Только для вида номенклатуры ""Лом""
РаботаОснованиеКод Строка неограниченная Из произвольного наименования работы, на основании которой была снята деталь
ТипМеталла Строка (50) Только для вида номенклатуры ""Лом"".
ГруппаДетали Строка (100)
КолВо Число (15:3)
ЕдИзм Строка (20)
ЕдИзмОКЕИ Строка (20) Единица измерения по ОКЕИ
Стоимость Число (15:2)
Деталь. ИспДеталь. Массив.
КодРаботы Строка (300) Наименовыание деталей
ГруппаДетали Строка (50) Вид номенклатуры ремонтируемой детали
КолВо Число (15:3) Количество ремонтируемых деталей
ЦенаБезНДС Число (15:2) Цена детали
Деталь. КП. Массив.
ОбодЛ Строка (50)
ОбодП Строка (50)
ГребеньЛ Строка (50)
ГребеньП Строка (50)
ОбодЛДо Строка (50)
ОбодПДо Строка (50)
ГребеньЛДо Строка (50)
ГребеньПДо Строка (50)
ТипКП Строка (50) Тип крепления ОСИ ремонируемой детали
Деталь. КП. Диск. Массив.
ТолщинаОбода Строка (50)
Деталь. КП. Подшибник. Массив.
Завод Строка (4) При указании ППС подшибника
Номер Строка (50) При указании ППС подшибника
Год Дата При указании ППС подшибника
ТипПодш Строка (50) При указании ППС подшибника
ПрикрепленныеФайлы. Массив.
BARCODE Строка (50) Уникальный идентификатор документа
SAPDOCID Строка (50)
SAPDOCIDАрхив Строка (50)
ТаблицаВСаперион Строка (50)
ТаблицаВСаперионАрхив Строка (50)
СтатусСогласования Число (9) Числовой код статуса согласования
СтатусСогласованияСтрокой Строка (150) Наименование статуса согласования
КомментарийОтмены Строка (неограниченная)
КодФайла Строка (9)
ИДКабинета Строка (неограниченная) ИД кабинета
ИДДокументаЭДО Строка (неограниченная) ИД документа ЭДО
ПакетОператораЭДО Строка (неограниченная) Пакет оператора ЭДО
СтатусДокументаУОперЭДО Строка (неограниченная) Статус документа у оператора ЭДО, появляется при начале процесса подписания
СсылкаЭДО Строка (неограниченная) Ссылка на документ Диадок
ТипДокументаЭДО Строка (неограниченная) Тип документа ЭДО
ТребуетСогласования Число (1) Истина - 1, Ложь - 0
ТребуетПодписания Число (1) Истина - 1, Ложь - 0
АВР. Массив.
Наименование Строка неограниченная
ЕдИзм Строка (50)
Колво Число (15:3)
ЦенаБезНДС Число (15:3)
НДС Число (15:3)
СтавкаНДС Число (15:3)

Скачивание документа

Скачивание необходимого документа осуществляется по его уникальному идентификатору BARCODE. Возможно скачивание готового документа, а также скачивание архива со всей служебной информацией по документу.

Эндпоинты

  1. Демо: https://api-integration.omk.ru/demo/api/steel-track/download-documents/[BARCODE]
  2. Прод: https://api-integration.omk.ru/api/steel-track/download-documents/[BARCODE]

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

curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/download-documents/AAA688701W250043071 \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                
curl -X 'GET' \
        'https://api-integration.omk.ru/api/steel-track/download-documents/AAA688701W250043071?archive=true' \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
                                

Параметры:

  • BARCODE - Штрихкод документа, получаемый в массиве "ПрикрепленныеФайлы" сущностей вагонов и деталей (Пример: "AAA688701W250043071")
  • archive - Флаг загрузки архива с полной информацией по документу (Для загрузки архива необходимо указать: "true")

Согласование документа

Документы требующие согласования помечаются признаком "ТребуетСогласования" = 1, в массиве "ПрикрепленныеФайлы" сущностей вагонов и деталей.

Эндпоинты

  1. Демо: https://api-integration.omk.ru/demo/api/steel-track/documents-approval
  2. Прод: https://api-integration.omk.ru/api/steel-track/documents-approval

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

curl -X 'POST' \
        'https://api-integration.omk.ru/api/steel-track/documents-approval \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
        -F 'barcode=AAA688701W250043071' \
        -F 'status=approved' \
        -F 'fullName=Иванов П.С.' \
        -F 'email=Ivanov_ps@demo-api.ru' \
                                
curl -X 'POST' \
        'https://api-integration.omk.ru/api/steel-track/documents-approval \
        -H 'accept: application/json' \
        -H 'Authorization: Bearer 32|sVhXFa8q2loDB8ZLSJqOV3vySBO6Kgo9xe5XIjGp' \
        -F 'barcode=AAA688701W250043071' \
        -F 'status=declined' \
        -F 'fullName=Иванов П.С.' \
        -F 'email=ivanov_ps@demo-api.ru' \
        -F 'comment=Отсутствуют фото и видео материалы подтверждающие произведенные работы' \
                                

Параметры:

  • barcode - Штрихкод документа, получаемый в массиве "ПрикрепленныеФайлы" сущностей вагонов и деталей из поля BARCODE (Пример: "AAA688701W250043071")
  • status - Параметр статуса согласования ("approved" – согласован, "declined" - отклонен)
  • fullName - Фамилия Имя Отчество согласующего
  • email - Email адрес согласующего
  • comment - Текстовый комментарий поясняющий причину отклонения
Пример ответа
        {
            "success": true,
            "message": "Документ успешно согласован"
        }
                                    

Подписание документа

Документы, требующие подписания, помечаются признаком "ТребуетПодписания":1 в массиве "ПрикрепленныеФайлы" объектов вагонов и деталей.

Ссылка для подписания передается в параметре "СсылкаЭДО" внутри массива "ПрикрепленныеФайлы". Для подписания необходимо перейти по этой ссылке в систему Контур.Диадок и завершить подписание документа там.