Report: Отчет о расхождениях заказов и поступлений
Позволяет получить данные о расхождениях заказов и поступлений
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| login | string | Логин пользователя | |
| password | string | Пароль | |
| parameters | Element | Список параметров | |
| name | string | Наименование отчёта = GoodsOrderDiscrepancy для отчета о расхождениях заказов и поступлений |
Параметр parameters должен содержать:
- Key: значение parameters (строго как указано);
- List: непустой массив элементов, каждый из которых — отдельный параметр в виде структуры с тремя полями:
- Key: имя параметра (например, FromDate, ToDate);
- Value: значение параметра (строка, дата и т.д.);
- ValueType: тип значения (string, dateTime и т.п.).
Пример структуры:
<p><m:parameters xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<m:Key>parameters</m:Key>
<m:List>
<m:Key>FromDate</m:Key>
<m:Value xsi:type="xs:dateTime">2014-09-01T00:00:00</m:Value>
<m:ValueType>dateTime</m:ValueType>
</m:List>
<m:List>
<m:Key>ToDate</m:Key>
<m:Value xsi:type="xs:dateTime">2014-09-30T00:00:00</m:Value>
<m:ValueType>dateTime</m:ValueType>
</m:List>
</m:parameters></p>List не может быть пустым — каждый параметр должен быть описан как отдельный элемент.
Иерархия parameters:
Key: parameters
List (массив) → каждый элемент → Key, Value, ValueType
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| FromDate | dateTime | Дата, с которой формируется отчёт. Если не указана, то отчёт формируется с начала предыдущего месяца | |
| ToDate | dateTime | Дата, по которую формируется отчёт. Если не указана, то отчёт формируется до конца предыдущего месяца | |
| OrderNumber | string | Номер заказа, если мы хотим сформировать отчёт только по данным одного заказа | |
| WaybillNumber | string | Номер накладной, если мы хотим сформировать отчёт только по данным одной накладной | |
| Divergence | string | Количество единиц расхождения (для GoodsOrderDiscrepancy) |
Возвращаемые данные зависят от того отчета который запрашивается.
Если во время запроса произошла ошибка, информация о ней будет отражена в свойстве Properties (см. метод GetReferenceData: ErrorCodes — Коды ошибок).
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
Корневой контейнер ответа метода Report содержит return с Key = Report. Fields (повторяются), содержащие описание колонок и List с данными отчёта.
Данные отчета возвращаются в Rows - Строки отчёта, каждая из которых соответствует конкретной накладной, попавшей в группу накладных. Они представлены в виде структуры Row. В структуре Row конкретные данные по накладной находятся в списке Cells.
Содержимое и порядок данных в Cells соответствует списку колонок, описанному ниже.
Описание колонок отчёта (название и тип данных). Каждый параметр представлен отдельным блоком Fields, содержащим:
- Key — название колонки (варианты в таблице ниже зависят от типа отчёта)
- Value — тип данных колонки (string, int, decimal, dateTime и т.д.)
- ValueType — тип значения (всегда string)
Варианты Key для Fields отчета:
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| Nom | int | Порядковый номер | |
| OrderNumber | string | Номер заказа | |
| OrderDate | dateTime | Дата заказа | |
| ShippingDate | dateTime | Дата выполнения заказа | |
| ClientCode | string | Код клиента | |
| Client | string | Наименование клиента | |
| Department | string | Подразделение клиента | |
| Project | string | Проект клиента | |
| LineCode | decimal | Код строки | |
| Product | string | Наименование товара | |
| Article | string | Артикул товара | |
| Code | string | Код товара | |
| Party | string | Партия товара | |
| Units | string | Единица измерения товара | |
| PackageQty | decimal | Количество упаковок заказ | |
| UnitsQty | decimal | Количество единиц заказ | |
| ActualUnitsQty | decimal | Количество единиц факт | |
| Discrepancy | decimal | Расхождение |
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header/>
<soap:Body>
<m:Report
xmlns:m="http://www.cargo3.ru">
<m:login>LOGIN</m:login>
<m:password>PASSWORD</m:password>
<m:name>GoodsOrderDiscrepancy</m:name>
<m:parameters>
<m:Key>Parameters</m:Key>
<m:List>
<m:Key>FromDate</m:Key>
<m:Value xsi:type="xs:dateTime">2014-09-01T00:00:00</m:Value>
<m:ValueType>dateTime</m:ValueType>
</m:List>
<m:List>
<m:Key>ToDate</m:Key>
<m:Value xsi:type="xs:dateTime">2014-09-30T00:00:00</m:Value>
<m:ValueType>dateTime</m:ValueType>
</m:List>
</m:parameters>
</m:Report>
</soap:Body>
</soap:Envelope>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<m:ReportResponse
xmlns:m="http://www.cargo3.ru">
<m:return
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<m:Key>Report</m:Key>
<m:Fields>
<m:Key>Nom</m:Key>
<m:Value xsi:type="xs:string">int</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>OrderNumber</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string
</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>OrderDate</m:Key>
<m:Value xsi:type="xs:string">dateTime</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>ShippingDate</m:Key>
<m:Value xsi:type="xs:string">dateTime</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>ClientCode</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Client</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Subdivision</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Project</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>LineCode</m:Key>
<m:Value xsi:type="xs:string">decimal</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Product</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Article</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Code</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Party</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Units</m:Key>
<m:Value xsi:type="xs:string">string</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>PackageQty</m:Key>
<m:Value xsi:type="xs:string">decimal</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>UnitsQty</m:Key>
<m:Value xsi:type="xs:string">decimal</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>ActualUnitsQty</m:Key>
<m:Value xsi:type="xs:string">decimal</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:Fields>
<m:Key>Discrepancy</m:Key>
<m:Value xsi:type="xs:string">decimal</m:Value>
<m:ValueType>string</m:ValueType>
</m:Fields>
<m:List>
<m:Key>GoodsOrderDiscrepancy</m:Key>
<m:Rows>
<m:Cells xsi:type="xs:decimal">1</m:Cells>
<m:Cells xsi:type="xs:string">888-0000107545</m:Cells>
<m:Cells xsi:type="xs:dateTime">2017-09-19T16:54:54</m:Cells>
<m:Cells xsi:type="xs:dateTime">2017-09-19T17:05:57</m:Cells>
<m:Cells xsi:type="xs:string">497-3226985</m:Cells>
<m:Cells xsi:type="xs:string">ТЕСТ_&_ТРЕСТ</m:Cells>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:string">яблоко</m:Cells>
<m:Cells xsi:type="xs:string">я1</m:Cells>
<m:Cells xsi:type="xs:string">00000000000000105503</m:Cells>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:string">Упк (23 шт)</m:Cells>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:decimal">92</m:Cells>
<m:Cells xsi:type="xs:decimal">92</m:Cells>
</m:Rows>
<m:Rows>
<m:Cells xsi:type="xs:decimal">2</m:Cells>
<m:Cells xsi:type="xs:string">888-0000107545</m:Cells>
<m:Cells xsi:type="xs:dateTime">2017-09-19T16:54:54</m:Cells>
<m:Cells xsi:type="xs:dateTime">2017-09-19T17:05:57</m:Cells>
<m:Cells xsi:type="xs:string">497-3226985</m:Cells>
<m:Cells xsi:type="xs:string">ТЕСТ_&_ТРЕСТ</m:Cells>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:string">эль</m:Cells>
<m:Cells xsi:type="xs:string">э3</m:Cells>
<m:Cells xsi:type="xs:string">00000000000000105511</m:Cells>
<m:Cells xsi:type="xs:string"/>
<m:Cells xsi:type="xs:string">см</m:Cells>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:decimal">0</m:Cells>
<m:Cells xsi:type="xs:decimal">67.87</m:Cells>
<m:Cells xsi:type="xs:decimal">67.87</m:Cells>
</m:Rows>
</m:List>
</m:return>
</m:ReportResponse>
</soap:Body>
</soap:Envelope>
