| Назначение | Создать товар |
| Тип запроса | Асинхронный |
| Версия SH | SH4, SH5 |
В sh5 нельзя передать код, с которым будет сгенерирован товар.
2.1 Формат запроса
<?xml version="1.0" encoding="utf-8"?>
<RQ cmd="sh_new_good" tasktype="any_call" callback="ya.ru" timeout="int">
<PARAM name="object_id" val="000000000"/>
<GOOD goodgroup_rid="int" name="string" textcode="string" numcode="int">
<MUNITS>
<MUNIT rid="int" isbase="1"/>
<MUNIT rid="int"/>
</MUNITS>
</GOOD>
</RQ>
Описание параметров
| Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
|---|
| object_id | int | + | Код ресторана в системе лицензирования |
|
| groupguid | guid | - | Необязательный guid для группировки запросов в рамках одного пользовательского сценария. Если создаётся серия запросов (создан заказ, сохранён, оплачен), то лучше группировать их в один сценарий для упрощения диагностики проблем. |
|
| callback | string | + | HTTP адрес, по которому WhiteServer отправит запрос после выполнения команды |
|
| goodgroup_rid | int | + | Rid товарной группы |
|
| textcode | string | + | Текстовая часть кода (В sh5 это поле игнорируется) |
|
| numcode | int | + | Числовая часть кода (В sh5 это поле игнорируется) |
|
| munit rid | int | + | Rid единицы измерения |
|
| munit isbase | int | + | Признак того, что ед.изм. является базовой (1 - да). Обязательно заполнение одной из двух частей (Можно обе сразу) |
|
Обязательно наличие хотя бы 1 ед.изм.
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 (асинхронного ответа)
<RQ cmdguid="e1761d18-6325-43d0-85a3-2610ad637f3d" posid="90EF4C1B-358E-4408-8B4D-E2BC799A0688">
<GOOD rid="14211"/>
</RP>
Описание параметров
| Параметр | Тип | Описание |
|
|---|
| cmdguid | guid | Совпадает с taskguid в ответе |
|
| posid | guid | POS id кассового сервера (можно игнорировать) |
|
| GOOD rid | int | Rid товара |
|
3.1 Пример
3.1.1 Запрос
<?xml version="1.0" encoding="utf-8"?>
<RQ cmd="sh_new_good" tasktype="any_call" callback="ya.ru">
<PARAM name="object_id" val="199990106"/>
<GOOD goodgroup_rid="1007" name="Новый товар" textcode="new" numcode="12">
<MUNITS>
<MUNIT rid="5" isbase="1"/>
<MUNIT rid="3"/>
</MUNITS>
</GOOD>
</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">
<GOOD rid="1007"/>
</RP>
Обратите внимание, что в 3.1.2 taskguid и 3.1.3 cmdguid совпадают.
V2 ShNewGood