АСУ ВРК - Ремонт вагонов

Текущая версия выгрузки 4:
Добавлено поле ДатаВводаВсистему

версия выгрузки 3:
В Категориях ПредставителиДепо и ПредставителиСобственника добавлен атрибут МЧД,
подробности смотрите ниже в описании

версия выгрузки 2:
Добавлено поле XmlSF (Электронная СФ)

Выгрузка информации с сайта разбита на 3 части:

Cправочная информация, основные справочники используемые в работе, очень редко меняющиеся или не меняющиеся вовсе. Описание справочников Вы можете найти на странице https://remontvagonov.ru/export_directory.php
Непосредственно данные по деталям

Для получения данных по рассчету стоимости хранения Вам необходимо через свое приложение или в ручном режиме сделаеть запрос по адресу

https://remontvagonov.ru/export_keep.php

в качестве параметров необходимо передать логин и пароль пользователя ИМЕЮЩЕГО ПРАВА на загрузку данных, а так же параметры фильтра.

Параметры можно передавать как GET так и POST методом.

Внимание: параметры login и pass - передаются строго методом POST.

Например:

https://remontvagonov.ru/export_keep.php?login=логин&pass=пароль&id=12

В данном случае будет выгружен один документ с кодом в АСУ ВРК 12 только в том случае если он проверен экономистом депо.

или

https://remontvagonov.ru/export_keep.php?login=логин&pass=пароль&dt1=01.07.2010&dt2=01.07.2010

В данном случае будет выгружены все документы дата документа которых попадает в указанный диапозон и которые проверены экономистом депо. Дату в этом случае следует указывать в формате ДД.ММ.ГГГГ

Так же доступны параметры:

checkedonly : при его наличии (параметр не обязателен) будут выгружены только те документы, которые проверены собственником на портале RemontVagonov.ru

nochecked : при его наличии (параметр не обязателен) будут выгружены только те документы, которые еще НЕ проверены на портале RemontVagonov.ru

komment : при его наличии, в выгрузку так же будут включаться комментарии пользователей к документам

lastchange : при его наличии фильтр по датам будет обрабатывать НЕ по дате документа а по дате последнего изменения состояния документа.

fulldetalnomer : при его наличии, во всех местах выгрузки, номера деталей будут представлены одним полем, Номер, которое будет содержать номер детали в формате Завод-Номер-Год, одной строкой без этого параметра номер будет представлен в отдельных полях Завод, Номер, Год

ecp0 : при его наличии, в выгрузку будут попадать только документы не подписанные ЭП

ecp1 : при его наличии, в выгрузку будут попадать только документы с одной ЭП, с подписью начальника депо

ecp2 : при его наличии, в выгрузку будут попадать только документы с двумя ЭП

onlyvagondata : при его наличии, в выгрузку будут попадать только категория Хранение, данный параметр удобно использовать для обновления состояния документа, например при подписи документов ЭП

https://remontvagonov.ru/export_keep.php?login=логин&pass=пароль&dt1=01.07.2010&dt2=01.07.2010

Пример получаемых данных Вы можете скачать отсюда, так же Вы можете скачать XSD схему

Хранение - Основная категория, содержит информацию документах на основании которых детали хранятся в ВЧДр/ВРП.

Код {число - целое 64 бит} - уникальный код записи - НЕ ИЗМЕНЯЕТСЯ

КодДепо {число - целое} - код контрагента депо в котором хранятся детали (см. справочник Контрагенты в выгрузке справочников)

КлеймоДепо {строка} - клеймо контрагента депо в котором хранятся детали

ДатаФиксации {дата в формате ДД.ММ.ГГГГ чч:мм.сс} - местное дата и время фиксации документа экономистом ВРП

КодСтанции {число - целое} - код станции на которой находится подрядчик

Зафиксирован {число - целое} - статус проверки документа экономистом депо, в редких случаях данное поле может иметь значение =0

НачалоХранения {дата в формате ДД.ММ.ГГГГ} - дата начала хранения в текущем периоде обычно равна 1 числу месяца

ОкончаниеХранения {дата в формате ДД.ММ.ГГГГ} - дата окончания хранения в текущем периоде обычно равна последнему дню месяца

ДатаАВР {дата в формате ДД.ММ.ГГГГ} - дата акта выполненных работ

НомерАктаВыпРабот {строка} - номер акта выполненных работ

СтоимостьБезНДС {число} - итоговая стоимость хранения в текущем периоде

НДС {число} - НДС

СтавкаНДС {число} - ставка НДС (в сотых долях от единицы)

ДатаСФ {дата в формате ДД.ММ.ГГГГ} - дата счет фактуры, может быть пустой

НомерСФ {строка} - номер счет фактуры, может быть пустой

ДатаВводаВсистему {дата в формате ДД.ММ.ГГГГ чч:мм.сс} дата/время ввода информации в АСУ ВРК

Изменен {дата в формате ДД.ММ.ГГГГ чч:мм.сс} дата/время последнего изменения

ЭЦП {число - целое}- статус подписи документов ЭП

где:
0 - не подписывался
1 - данные подготовлены для подписи, но не подписаны
10 - подписан начальником депо
15 - Документы подписаны с двух сторон, НО электронная счет фактура НЕ Подписана со стороны одного из контрагентов, значение имеет место быть только в том случае если заказчик и подрядчик подписывают электронные версии акта выполненных работ и счет фактуры в формате налоговой
20 - подписан с двух сторон
5,9,18,19 - статус подписи не известен, вагон ожидает синхронизации с оператором ЭДО

КоррАВР {число - целое} - Наличие Корректировочного АВР/ЭСФ

где:
0 - некорректировочный АВР/ЭСФ
1 - Корректировочный АВР/ЭСФ
2 - Исправительный АВР/ЭСФ

Проверка {строка - 10 символов} - указывает статус проверки собственником ВСЕХ документов в формате "ХХХХХХХХХХ", может быть пустой

где:
0 - документ НЕ ПРОВЕРЯЛСЯ
1 - документ ПРОВЕРЕН
2 - документ ОТПРАВЛЕН НА ДОРАБОТКУ

XmlSF {число - целое} - Электронная СФ.

где:
0 - ЭСФ не должно быть в документах на текущий момент, ("пустое" значение в колонке будет так же при фиксации вагона, а так же после фиксации, если работа с контрагентом проводится без выставления ЭСФ).
1 - ЭСФ должна быть на вагоне, но она не создана.
2 - ЭСФ создана.

Изменен {дата в формате ДД.ММ.ГГГГ чч:мм.сс} - дата и время последнего изменения записи в БД, время местное относительно ВЧДр.

+Категория Договор содержит информацию о договоре и собственнике деталей отправленных на ремонт.

Параметры:

Код {число - целое} - уникальный номер договора - не изменяется

Номер {строка - 25 символов}- номер договора

СобственникКод {число - целое}- уникальный код собственника - не изменяется

НачалоДействия {дата в формате ДД.ММ.ГГГГ}- дата начала действия договора в формате "ДД.ММ.ГГГГ"

ОкончаниеДействия {дата в формате ДД.ММ.ГГГГ}- дата окончания действия договора в формате "ДД.ММ.ГГГГ"

ДоговорОт {дата в формате ДД.ММ.ГГГГ}- дата подписания договора в формате "ДД.ММ.ГГГГ"

+Категория Договор имеет подчиненные категории РеквизитыСобственника и РеквизитыДепо содержание обоих категорий одинаково:

+Категория ПредставителиДепо отражает информацию о представителях депо подписывающих документы в АСУ ВРК:

+Категория ПредставителиСобственника отражает информацию о представителях собственника подписывающих документы в АСУ ВРК:

+Категория Акт - информация из Акта выполненных работ (по услугам хранения)

+Категория Детали отражает информацию о хранимых деталях

Код {число - целое 64 бит} - уникальный код детали отраженной в хранении.

ИдентификаторДетали {число - целое 64 бит} - уникальный код детали, внимание может дублироватся у различных типов деталей, например боковая рама и колесо могут иметь один уникальный код

КодВАВР {число - целое 64 бит} - Код услуги в АВР

ТипДетали {число - целое} - тип детали

ГруппаДетали {число - целое} - группа детали

Вес {число - дробное} - вес детали в килограммах, равен нулю если хранение оплачивается по штучно

Количество {число - целое} - количество хранимых деталей

Состояние {число - целое} - состояние хранимой детали, 0 - годная, 1 - брак

ДетальНаОстатке {число - целое} - статус детали на остатке равно еднице если деталь все еще находиться на остатке

ДетальХранитсяС {дата в формате ДД.ММ.ГГГГ} - дата поступления детали на склад

ОплачиваемоеХранениеС {дата в формате ДД.ММ.ГГГГ} - дата начала оплачиваемого хранения

ОплачиваемоеХранениеПо {дата в формате ДД.ММ.ГГГГ} - дата окончания оплачиваемого хранения

СрокХраненияПоАкту {число - целое} - оплачиваемый срок хранения

СрокХраненияВсего {число - целое} - общий срок хранения детали

ЕдИзм {строка 3 символа} - единица измерения, при штучном расчет равна "шт", при весовом - "т"

Стоимость {число - дробное} - Стоимость хранения за единицу измерения, за день или за тонну

СтоимостьХранения {число - дробное} - итоговая стоимость хранения

ДетальЗавод {число - целое} - Завод изготовитель детали, может быть пустым

ДетальНомер {число - целое} - Номер детали(Может быть пустым), при указанном параметре fulldetalnomer в данном поле будет содержаться полный номер детали в формате Завод-Номер-Год

ДетальГод {число - целое} - Год выпуска детали, может быть пустым

НомерВагона {число - целое} - Снята/Установлена на вагон №, может быть пустым

+Категория "ПрикрепленныеФайлы" отражает информацию о файлах прикрепленных к вагону в АСУ ВРК:

+Категория "ЭЦП" отражает информацию о подписи документов ЭЦП, содержит две подчиненные категории Сертификаты и Документы:

+Сертификаты содержит информацию о сертификатах, которыми были подписаны документы, вся информация соответствует данным указанным в сертификате, которым производилась подпись

+Документы содержит информацию документах, которые были или будут подписаны сертификатами описанными выше

Параметры:

Код {число - целое 64 бит} - уникальный код записи, при помощи данного кода Вы можете скачать подписанные документы с портала ЭДО, для этого сделайте пост запрос на адрес https://remontvagonov.ru/download_edo_copy.php с параметрами login и pass, а так же параметром id содержищим этот код, так же Вы можете вместо параметра id указать параметр allid который равен коду документа, в этом случае Вы получите все подписанные файлы с портала ЭДО в одном архиве, выгрузить файлы возможно только в том случае, если вагон подписан с двух сторон.

ttk_guid {строка - 36 символов} - уникальный идентификатор документа на портале ЭДО.

ВидДокумента {число - целое}- см. справочник ВидыДокументов в выгрузке справочников

ДатаПодписи1 {дата в формате ДД.ММ.ГГГГ}- Дата подписи документа представителем Подрядчика, может быть пустой

ДатаПодписи1 {дата в формате ДД.ММ.ГГГГ}- Дата подписи документа представителем Заказчика, может быть пустой

Сертификат1 {число - целое}- код сертификата Подрядчика, которым подписаны документы, может быть пустым

Сертификат2 {число - целое}- код сертификата Заказчика, которым подписаны документы, может быть пустым

МЧД1 {строка - 40 символов} - идентификационный номер МЧД (GUID МЧД) Подрядчика, может быть пустым

МЧД2 {строка - 40 символов}- идентификационный номер МЧД (GUID МЧД) Заказчика, может быть пустым

+Категория "Коментарии" (включено при добавлении параметра komment) отражает информацию о комментариях пользователей, оставленных на портале, и пользователями АСУ ВРК:

Параметры:

ДатаВремя {Дата и время в формате ДД.ММ.ГГГГ ЧЧ:ММ:CC} - дата добавления комментария.

Текст {строка до 500 символов} - комментарий

ТипКоментария {число целое} - тип комментария согласно списка,

где:
3 - снятие фиксации, в случае отмены ЭП или отклонения документа собственником
5 - информация о времени и стоимости ремонта при очередной фиксации документа со стороны ВРП/ВЧДр
998 - общий комментарий собственника не привязанный к документу
999 - согласование собственником всех документов, полная проверка документов
1000 - комментарий собственника к ЭСФ
1001 - комментарий собственника к ЭСФ
1002 - комментарий собственника к Расчету хранения со стороны Вагонника
1003 - комментарий собственника к Расчету хранения со стороны Экономиста
1004 - комментарий собственника к Акту выполненных работ со стороны Вагонника
1005 - комментарий собственника к Акту выполненных работ со стороны Экономиста
1222 - Запрос пользователя АСУ ВРК на расфиксацию
1255 - Общий комментарий пользователя АСУ ВРК, не привязанный к документу

Отклонение {Число целое} Информация об отклонении, согласовании при повторном рассмотрении со стороны собственника, где 2 - отклонение, 1 - согласование при повторной проверке

ПризнакОтменыРасфиксации {Число целое} Отмена/согласование запроса на расфиксацию,

где:
1 - Ожидание отмены или подтверждения расфиксации
2 - Подтвержден запрос на расфиксацию
3 - Отклонен запрос на расфиксацию
4 - Отменен запрос на расфиксацию

ФИО {строка - 100 символов} - ФИО

ПрирепленФайл {Число целое} - в том случае если значение больше нуля Вы можете использовать его для загрузки файла, для этого сделайте POST запрос на адрес https://remontvagonov.ru/download_file.php с параметрами login и pass, а так же параметром id содержащим этот код и параметром h.

Протестировать выгрузку можно воспользовавшись ссылкой test_export_keep.html

Так же Вы можете воспользоваться выгрузкой печатных форм документов в формате HTML document_export.html

Так же ждем ваших пожеланий и замечаний на адрес