sh_get_doc_receiving_report
1 Описание
| Назначение | Просмотр приходной накладной |
| Тип запроса | Асинхронный |
| Версия SH | SH4, SH5 |
В sh5 код документа состоит только из одной части, которая возвращается в поле textcode.
2 Формат запросов
2.1 Формат запроса
<?xml version="1.0" encoding="utf-8"?> <RQ tasktype="any_call" cmd="sh_get_doc_receiving_report" callback="http://ya.ru" > <PARAM name="object_id" val="000000000"/> <PARAM name="doc_rid" val="int"/> </RQ>
Описание параметров
| Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
|---|---|---|---|---|
| object_id | int | + | Код ресторана в системе лицензирования | |
| groupguid | guid | - | Необязательный guid для группировки запросов в рамках одного пользовательского сценария. Если создаётся серия запросов (создан заказ, сохранён, оплачен), то лучше группировать их в один сценарий для упрощения диагностики проблем. | |
| callback | string | + | HTTP адрес, по которому WhiteServer отправит запрос после выполнения команды | |
| doc_rid | int | + | Rid накладной |
2.2 Формат ответа
<?xml version="1.0" encoding="utf-8"?> <RP taskguid="6774b0bc-dd5e-4eca-a1f9-d982607feb2e" code="0" version="1.5.0.7155" />
Описание параметров
| Параметр | Тип | Описание |
|---|---|---|
| taskguid | guid | Уникальный код этой задачи. При отправке callback будет использован этот код, чтобы вызывающий сервис мог сопоставить запрос и ответ |
2.3 Формат callback (асинхронного ответа)
<RP cmdguid="d87eb27c-6220-4ff4-9d1b-0951b50447a7" posid="4D7B18F2-58CE-4F0F-A2B6-2D90A6BFCF67"> <DOC date="2017-01-24T00-00-00" textcode="pn" numcode="100500" note="note" corr="1392" corr_name="ООО "АШАН"" store="1421" store_name="Второй склад" active="0"> <ITEM record_rid="44042" rid="13980" name="Моджи 8 шт" mu="6" mu_name="порция" quant="77000" vatsum="2000" sum="12900"/> <ITEM record_rid="44043" rid="13984" name="Моджи 8 шт Манго" mu="6" mu_name="порция" quant="3000" vatrate="1000" sum="51300"/> <ITEM record_rid="44047" rid="13980" name="Моджи 8 шт" mu="6" mu_name="порция" quant="7000" vatsum="2000" sum="12900"/> </DOC> </RP>
Описание параметров
| Параметр | Тип | Описание | |
|---|---|---|---|
| cmdguid | guid | Совпадает с taskguid в ответе | |
| posid | guid | POS id кассового сервера (можно игнорировать) | |
| date | datetime | Дата накладной | |
| corr | int | Ссылка на поставщика | |
| corr_name | string | Наименование поставщика | |
| store | int | Ссылка на получателя | |
| store_name | string | Наименование получателя | |
| active | int | Активность дока (1 - да) | |
| note | string | Примечание, макс. 255 символов | |
| textcode | string | Кекстовая часть кода, макс 19 символов | Возможны 2 варианта задания кода накладной - автоматически и вручную. Если вручную, то нужно обязательно задать и текстовую часть и числовую, иначе код будет сгенерирован автоматически. |
| numcode | int | Числовая часть кода | |
| record_rid | int | Rid записи | |
| rid | int | Ссылка на товар | |
| name | string | Наименование товара | |
| quant | int | Кол-во * 1000 | |
| mu | int | Ссылка на единицу измерения | |
| mu_name | string | Наименование единицы измерения | |
| vatrate | int | Ставка НДС * 100 | В зависимости от того, что было передано при создании - сумма или ставка ндс - такой атрибут и будет отображаться - vatrate или vatsum |
| vatsum | int | Сумма НДС * 100 | |
| sum | int | сумма * 100 |
3 Примеры вызовов
3.1 Пример
3.1.1 Запрос
<?xml version="1.0" encoding="utf-8"?> <RQ tasktype="any_call" cmd="sh_get_doc_receiving_report" callback="http://ya.ru"> <PARAM name="object_id" val="199990106"/> <PARAM name="doc_rid" val="1533"/> </RQ>
3.1.2 Ответ
<?xml version="1.0" encoding="utf-8"?> <RP taskguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" code="0" version="1.7.0.8215" />
3.1.3 Callback (асинхронный ответ)
<RP cmdguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" posid="797C3E3B-3C33-4D97-87F8-25578FE48BE6"> <DOC date="2017-01-24T00-00-00" textcode="pn" numcode="100500" note="note" corr="1392" corr_name="ООО "АШАН"" store="1421" store_name="Второй склад" active="0"> <ITEM record_rid="44042" rid="13980" name="Моджи 8 шт" mu="6" mu_name="порция" quant="77000" vatsum="2000" sum="12900"/> <ITEM record_rid="44043" rid="13984" name="Моджи 8 шт Манго" mu="6" mu_name="порция" quant="3000" vatrate="1000" sum="51300"/> <ITEM record_rid="44047" rid="13980" name="Моджи 8 шт" mu="6" mu_name="порция" quant="7000" vatsum="2000" sum="12900"/> </DOC> </RP>
Обратите внимание, что в 3.1.2 taskguid и 3.1.3 cmdguid совпадают.