1 Описание

НазначениеСоздать документ инвентаризации
Тип запросаАсинхронный
Версия SHSH4, SH5

В sh5 код документа состоит только из одной части, которая заполняется в поле textcode.
В sh5 нельзя добавить примечание к создаваемой накладной.
В sh5 не нужно указывать rid сотрудника, который завел накладную.

2 Формат запросов

2.1 Формат запроса

Создать документ инвентаризации

<RQ cmd="sh_doc_invent" tasktype="any_call" callback="http://ya.ru" timeout="int">
  <PARAM name="object_id" val="000000000"/>
  <DOC shiftdate="xmldate" store="int" staff="int">
    <ITEM rid="300" quant="int" mu="1"/>
    <ITEM rid="301" quant="1000" mu="2"/>
  </DOC>
</RQ>

Описание параметров


ПараметрТипОбязательныйОписаниеЗначение по умолчанию
object_idint+Код ресторана в системе лицензирования
groupguidguid-Необязательный guid для группировки запросов в рамках одного пользовательского сценария. Если создаётся серия запросов (создан заказ, сохранён, оплачен), то лучше группировать их в один сценарий для упрощения диагностики проблем.
callbackstring+HTTP адрес, по которому WhiteServer отправит запрос после выполнения команды
shiftdatedatetime+Дата смены
staffint+Ссылка на сотрудника
storeint+Ссылка на склад
ridint+Ссылка на товар
quantint+Кол-во * 1000
muint+Ссылка на единицу измерения


Создать документ инвентаризации по баркодам

<RQ cmd="sh_doc_invent" tasktype="any_call" callback="http://ya.ru">
  <PARAM name="object_id" val="000000000"/>
  <DOC shiftdate="xmldate" store="int" staff="int">
    <ITEM barcode="EAN13" quant="int" />
    <ITEM barcode="1212121212121" quant="1000" />
  </DOC>
</RQ>


barcodestring+Код
shiftdatedatetime+Дата смены
staffint+Ссылка на сотрудника
storeint+Ссылка на склад
quantint+Кол-во * 1000

2.2 Формат ответа

<?xml version="1.0" encoding="utf-8"?>
<RP taskguid="6774b0bc-dd5e-4eca-a1f9-d982607feb2e" code="0" version="1.5.0.7155" />

Описание параметров

ПараметрТипОписание
taskguidguidУникальный код этой задачи. При отправке callback будет использован этот код, чтобы вызывающий сервис мог сопоставить запрос и ответ


2.3 Формат callback (асинхронного ответа)

<RP cmdguid="e1761d18-6325-43d0-85a3-2610ad637f3d" posid="90EF4C1B-358E-4408-8B4D-E2BC799A0688">
 <DOC rid="int" code="text"/>
</RP>

Описание параметров

ПараметрТипОписание
cmdguidguidСовпадает с taskguid в ответе
posidguidPOS id кассового сервера (можно игнорировать)
ridintRid созданного документа
codeintКод созданного документа

3 Примеры вызовов

3.1 Пример GetSystemInfo

3.1.1 Запрос

<?xml version="1.0" encoding="utf-8"?>
<RQ cmd="sh_doc_invent" tasktype="any_call" callback="http://ya.ru">
  <PARAM name="object_id" val="199990106"/>
  <DOC shiftdate="2016-11-09" store="1" staff="1">
    <ITEM rid="300" quant="int" mu="1"/>
    <ITEM rid="301" quant="1000" mu="2"/>
  </DOC>
</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="90EF4C1B-358E-4408-8B4D-E2BC799A0688">
	  <DOC rid="1528" code="1603" />
</RP>

Обратите внимание, что в 3.1.2 taskguid и 3.1.3 cmdguid совпадают.

V2 ShDocInvent