Инструкция по функциональному взаимодействию автоматизированной системы этран с АСУ экспедитора (стр. 16 )

<invDepArc value=""/>

<!-- Раздел размещения -->

<!-- * тип данных: строка (до 8 символов) -->

<invDepSec value=""/>

<!-- Технические условия размещения груза -->

<!-- * тип данных: строка (до 1000 символов) -->

<invDepCond value=""/>

<!-- Фактическая дата погрузки -->

<!-- Значение по умолчанию – текущее время -->

<invFactDateToLoad value=""/>

<!-- Фактическая дата погрузки(местная) -->

<!-- Значение по умолчанию – текущее время -->

<!-- * тип данных: дата -->

<invFactDateToLoadLocal value=""/>

<!-- НАКЛАДНАЯ: Тарифные отметки за отправку (0..n) -->

<invTranspClause>

<!-ИД тарифной отметки (ID по T_INV_TRANSP_CLAUSE с TRANSPCLAUSETYPE_ID=2 и TRANSPCLAUSE_ID<>14) -->

<!-- * тип данных: целое число -->

<transpClauseId value=""/>

<!-Замечание -->

<!-- * тип данных: строка(до 255 символов) -->

<transpClauseCustomText value=""/>

</invTranspClause>

<!-- НАКЛАДНАЯ: Особые условия (0..n) -->

<invCndBlock>

<!-ИД особой отметки (ID по T_INV_TRANSP_CLAUSE TRANSPCLAUSE_ID=14) -->

<!-- * тип данных: целое число -->

<cndClauseId value=""/>

<!-Замечание -->

<!-- * тип данных: строка(до 255 символов) -->

<cndClauseCustomText value=""/>

<!-- Груз по ЕТ СНГ (код ЕТСНГ по НСИ - FREIGHT) -->

<!-- * тип данных: строка (до 6 символов) -->

<cndFreightCode value=""/>

</invCndBlock>

<!-- Использование 6-значных кодов станций и грузов в ответе -->

<useMod11/>

</ cmpExpedInvoice >

</ complaintToInvoice >

Ответ запроса:

В случае успешного приема запроса «Запрос подачи обращения по провозной плате к накладной» ответ содержит следующую информацию:

<!-- ************************ -->

<!— ПОДАЧА ОБРАЩЕНИЯ ПО ПРОВОЗНОЙ ПЛАТЕ К НАКЛАДНОЙ: ответ (при отсутствии ошибок) -->

<!-- ************************ -->

<complaintToInvoiceReply version="1.0">

<!-- Структура ответа аналогична сообщению ответа на запрос «Получение данных обращения по провозной плате»-->

</complaintToInvoiceReply >

3.4.  Запрос операций над документом

Данный запрос следует использовать при необходимости получить список операций выполненных над конкретным документом. По списку операций выполненных над документом можно узнать: дату проведения операции; отчетную дату выполнения операции; ФИО и должность сотрудника, выполнившего операцию;наименование операции; и другую информацию согласно поддокументу docOper из ответа на запрос «Запрос операций над документом»(docOper).

<!-- ******************************* -->

<!-- Операции над документом: запрос -->

<!-- ******************************* -->

<getDocOper version="1.0">

<!-- ID документа -->

<!-- * тип данных: целое число -->

<docID value=""/>

<!-- Выдавать данные подписи ЭЦП -->

<useECP/>

</getDocOper>

Ответ на запрос:

В случае успешного приема запроса «Запрос операций над документом» ответ содержит следующую информацию:

<getDocOperReply version="1.0">

<!-- Идентификатор документа -->

<!-- * тип данных: целое число (до 10 символов) -->

<docID value=""/>

<!-- Состояние -->

<!-- * тип данных: целое число (до 5 символов) -->

<StateID value=""/>

<!-- * тип данных: строка (до 40 символов) -->

<State value=""/>

<!-- Операции документа(1..n) -->

<docOper>

<!-- Дата операции -->

<!-- * тип данных: дата -->

<operDate value=""/>

<!-- Отчетная дата -->

<!-- * тип данных: дата -->

<operFactDate value=""/>

<!-- ID организации -->

<!-- * тип данных: целое число (до 10 символов) -->

<operOrgId value=""/>

<!-- Наименование организации -->

<!-- * тип данных: строка (до 250 символов) -->

<operOrgName value=""/>

<!-- Должность пользователя -->

<!-- * тип данных: строка (до 255 символов) -->

<operPost value=""/>

<!-- ФИО пользователя -->

<!-- * тип данных: строка (до 255 символов) -->

<operPerson value=""/>

<!-- Операция -->

<!-- * тип данных: строка (до 255 символов) -->

<operText value=""/>

<!-- Результат операции -->

<!-- * тип данных: строка (до 255 символов) -->

<operResult value=""/>

<!-- Примечание -->

<!-- * тип данных: строка (до 4000 символов) -->

<operRemark value=""/>

<!-- Рабочее место -->

<!-- * тип данных: строка (до 40 символов) -->

<operWorkPlace value=""/>

<!-- ЭЦП(0..n) -->

<ecp>

<!-- Дата начала ожидания подписи -->

<!-- * тип данных: дата -->

<ecpOperDate value=""/>

<!-- ID организации -->

<!-- * тип данных: целое число (до 10 символов) -->

<ecpOrgId value=""/>

<!-- Наименование организации -->

<!-- * тип данных: строка (до 250 символов) -->

<ecpOrgName value=""/>

<!-- Должность подписавшего -->

<!-- * тип данных: строка (до 255 символов) -->

<ecpPost value=""/>

<!-- ФИО согласовавшего -->

<!-- * тип данных: строка (до 255 символов) -->

<ecpPerson value=""/>

<!-- Дата подписания -->

<!-- * тип данных: дата -->

<ecpDate value=""/>

<!-- Подписываемый текст (выдается при указании useECP) -->

<!-- * тип данных: строка -->

<ecpText value=""/>

<!-- Электронно-цифровая подпись (выдается при указании useECP) -->

<!-- * тип данных: строка -->

<ecpECP value=""/>

<!-- Штамп времени (выдается при указании useECP) -->

<!-- * тип данных: строка -->

<ecpTSP value=""/>

</ecp>

</docOper>

</getDocOperReply>

В случае ошибки приема или обработки запросов ответ содержит следующую информацию:

<!-- ******************* -->

<!-- Сообщение об ошибке -->

<!-- ******************* -->

<error version="1.0">

<!-- Код ошибки -->

<errorCode value=""/>

<!-- Сообщение -->

<errorMessage value=""/>

</error>

3.5.  Запрос связанных документов

Данный запрос может быть полезен для нахождения всех документов связанных с заданным. Например, это может быть полезно для нахождения заявки и обращения по провозной плате по идентификатору накладной.

<!-- *************************** -->

<!-- Связанные документы: запрос -->

<!-- *************************** -->

<getDocLink version="1.0">

<!-- ID документа -->

<!-- * тип данных: целое число -->

<docID value=""/>

</getDocLink>

Ответ на запрос:

В случае успешного приема запроса «Запрос связанных документов» ответ содержит следующую информацию:

<getDocLinkReply version="1.0">

<!-- Идентификатор документа -->

<!-- * тип данных: целое число (до 10 символов) -->

<docID value=""/>

<!-- Связанные документы(0..n) -->

<docLink>

<!-- Идентификатор связанного документа -->

<!-- * тип данных: целое число (до 10 символов) -->

<linkDocId value=""/>

<!-- Тип связанного документа -->

<!-- тип данных: целое число (до 3 символов) -->

<linkDocTypeId value=""/>

<!-- Наименование типа связи -->

<!-- * тип данных: строка (до 255 символов) -->

<linkDocTypeName value=""/>

<!-- Дата создания связанного документа -->

<!-- * тип данных: дата -->

<linkDateCreate value=""/>

<!-- Состояние связанного документа -->

<!-- * тип данных: строка (до 40 символов) -->

<linkDocState value=""/>

</docLink>

</getDocLinkReply>

3.6.  Запрос получения нормативной справочной информации

Данный запрос следует использовать для закачки справочников из системы ЭТРАН.

<!-- ************************* -->

<!-- НСИ системы ЭТРАН: запрос -->

<!-- ************************* -->

<getNSI version="1.0">

<!-- Таблица НСИ -->

<!-- * тип данных: строка -->

<tableName value=""/>

<!-- Начальное значение TRANS_ID -->

<!-- * тип данных: целое число -->

<fromTransID value=""/>

<!-- Поле, по которому делать фильтрацию -->

<!-- * тип данных: строка (до 1000 символов) -->

<filterField value=""/>

<!-- Значение фильтра -->

<!-- * тип данных: строка (до 1000 символов) -->

<filterValue value=""/>

<!-- Условие фильтра -->

<!-- * тип данных: строка (до 1000 символов) -->

<!-- * условия из списка: '=,<>,!=,<,>,<=,>=,LIKE, IS, IS NOT' -->

<filterCond value=""/>

<!-- Использование 6-значных кодов станций и грузов в ответе -->

<useMod11/>

</getNSI>

При задании условий фильтрации: filterField, filterValue и filterCond, выдаваемые записи будут отфильтрованы по условию ‘filterField filterValue filterCond’. filterCond имеет значение по умолчанию ‘=’.

Т. е. при задании filterField = ‘ID’, filterValue = ‘10’, на записи будет наложено условие: ‘ID = 10’. Если, например, дополнительно указать filterCond = ‘>=’, то условие будет: ‘ID >= 10’.