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

В sh5 код документа состоит только из одной части, которая заполняется в поле textcode.
В sh5 нельзя добавить примечание к создаваемой накладной.
В sh5 если указывается процентная ставка НДС, то она должна быть уже заведена в store house (как стандартная).
В sh5 можно одновременно указывать и сумму НДС и процентную ставку.
В sh5 активность документа определяется признаком активирован получателем (он и передается через api);

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

<RQ tasktype="any_call" cmd="sh_doc_receiving_report" callback="http://ya.ru" >
  <PARAM name="object_id" val="000000000"/>
  <DOC date="date"  corr="int" store="int"  active="0" duedate="1">
   <ITEM rid="int" quant="int" mu="int" sum="int" vatrate="int"/>
    <ITEM rid="int" quant="int" mu="int" sum="int" vatrate="int"/>
  </DOC>
</RQ>

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


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


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="1528" code="34124п/н11"/>
</RP>

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

ПараметрТипОписание
cmdguidguidСовпадает с taskguid в ответе
posidguidPOS id кассового сервера (можно игнорировать)
ridintRid созданной накладной
codeintКод созданной накладной
<RQ cmdguid="e1761d18-6325-43d0-85a3-2610ad637f3d">
      <ERROR code="int" text="Ошибка связи со складом"/>
</RQ>

4.1 Пример

4.1.1 Запрос

<?xml version="1.0" encoding="utf-8"?>
<RQ tasktype="any_call" cmd="sh_doc_receiving_report" callback="http://ya.ru">
  <PARAM name="object_id" val="199990106"/>
  <DOC date="2016-11-09"  corr="1392" store="1421"  active="0" duedate="1">
   <ITEM rid="13980" quant="6000" mu="6" sum="12900" vatrate="1800"/>
    <ITEM rid="13984" quant="3000" mu="6" sum="51300" vatrate="1000"/>
  </DOC>
</RQ>

4.1.2 Ответ

<?xml version="1.0" encoding="utf-8"?>
<RP taskguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" code="0" version="1.7.0.8215" />

4.1.3 Callback (асинхронный ответ)

<RP cmdguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" posid="90EF4C1B-358E-4408-8B4D-E2BC799A0688">
	  <DOC rid="1528" code="34124п/н11"/>
</RP>

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

V2 ShDocReceivingReport