Метод ListMBex при работе с веб-сервисом Edisoft
Данный метод возвращает статус документов, которые были доставлены пользователю платформы EDI Platform.
Аргументы метода ListMBex
В методе ListMBex используются следующие аргументы (Табл. 1).
| Аргументы | Описание | Обязательность |
|---|---|---|
| name | ID пользователя на EDI Platform | M |
| password | Пароль пользователя | M |
| partnerILN | ID партнера, от которого был получен документ | O |
| documentType | Тип документа (например INVOIC) | M |
| documentVersion | Версия спецификации (например EDISOFTV0R1) | O |
| documentStandard | Стандарт документа (например EDIFACT,XML) | O |
| documentTest | Статус документа (T – тест, P – продуктивный) | O |
| dateFrom | Опциональный | O |
| dateTo | Опциональный | O |
| itemFrom | Опциональный | O |
| itemTo | Опциональный | O |
| documentStatus | Диапазон статусов выбираемых документов N – только новые документы R – только прочтенные документы (статус read(R)) Любое другое или пустое значение вернёт список всех документов. | O |
| timeout | Таймаут на выполнение вызова метода (мс) | M |
Табл. 1. Описание аргументов
При вызове метода ListMBex, аргументы: PartnerIln, DocumentType, DocumentVersion, DocumentStandard, DocumentTest используют значения, возвращаемые методом Relationship для данного пользователя, соответственно: partner-iln, document-type, document-version, document-standard, document-test.
DateFrom/To – задает промежуток времени для выбранного документа.
ItemFrom/To – задает диапазон документов. Номер 1 – документ, который был отправлен позже всех.
Формат даты rrrr-mm-dd (rrrr – year, mm - month, dd - day).
По умолчанию, метод возвращает 100 последних документов.
Значение, возвращаемое платформой EDI Platform
Ответ метода ListMBex содержит следующие поля (Табл. 2).
| Тег | Описание |
|---|---|
| <partner-iln> | ID партнера, от которого был получен документ |
| <tracking-id> | Идентификатор документа на EDI Platform |
| <document-type> | Тип документа (например INVOIC) |
| <document-version> | Версия спецификации (например EDISOFTV0R1) |
| <document-standard> | Стандарт документа (напр. EDIFACT,XML) |
| <document-test> | Статус документа (T – тест, P – продуктивный) |
| <document-status> | Статус документа (N – new, R – read) |
| <document-number> | Номер документа в самом документе |
| <document-date> | Дата документа |
| <document-control-number> | Контрольный номер документа |
| <receive-date> | Дата, когда документ был получен |
Табл. 2. Описание полей ответа
Пример формирования запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:wsedi">
<soapenv:Header/>
<soapenv:Body>
<urn:listMBEx>
<name>2000000000123</name>
<password>1234qwe</password>
<partnerILN>2000000000321</partnerILN>
<documentType>INVOICE</documentType>
<documentVersion></documentVersion>
<documentStandard></documentStandard>
<documentTest></documentTest>
<dateFrom></dateFrom>
<dateTo></dateTo>
<itemFrom></itemFrom>
<itemTo></itemTo>
<documentStatus>N</documentStatus>
<timeout>5000</timeout>
</urn:listMBEx>
</soapenv:Body>
</soapenv:Envelope>