Запись объектов
Введение
Команды записи поддерживаются только на сервере справочников.
Ниже приводятся минимально допустимые наборы атрибутов объектов. Для получения списка всех атрибутов объекта — выполните чтение соответствующего справочника.
Логика записи — вставка или обновление.
Ключевым атрибутом считается GUIDString.
Связи с родительскими объектами — по атрибуту MainParentGUID.
Если какие-то атрибуты не заполнены — они игнорируются.
Если атрибуту надо определить пустое значение — укажите «».
Удаление записей — выполняется установкой статуса rsDeleted, при этом фактически записи в базе данных не удаляются.
Чтобы избежать дублирования идентификаторов при создании элемента через XML-API, в таблице GENERATORS используйте значение SIFR=1. Генератор будет использоваться для сквозной идентификации в таблицах:
- MENUITEMS
- MODIFIERS
- DISCOUNTS
- DISCOUNTDETAILS
- MODISCHEMEDETAILS.
Получение меню
Вставка товара
Атрибут | Тип значения | |
---|---|---|
GUIDString | GUID | Уникальный идентификатор объекта |
MainParentIdent | GUID/Ident | Ссылка на родителя. Родитель должен существовать или быть в xml ранее |
Code | Integer | Код объекта (уникальный, для быстрого доступа) |
ExtCode | Integer | Внешний код объекта (уникальный, для внешних систем) |
Name | string | Название товара |
Status | rsActive, rsInactive, rsDeleted | Статус объекта (активен (доступен), недоступен, удален) |
PRICETYPES-0 | integer | Цена (в копейках) для типа цены (0 - по умолчанию) |
TaxDishType | integer | Тип налога |
CLASSIFICATORGROUPS-2560 | GUID/Ident | Ссылка на категорию, где 2560 - ID классификации |
Сразу можно перечислить несколько цен и принадлежность блюда к нескольким категориям.
Результат:
Вставка расширенных свойств
Где расширенное свойство называется BGU, но указывать нужно genBGU.
В версии 7.5.4, для внесения изменений в расширенное свойство по XML интерфейсу к расширенному свойству кроме основного типа, нужно добавить еще 1 тип, с идентификатором 2560. В списке типов без названия, ярлык — белый листок.
Создание товарных групп
Если возвращает ошибку, пропишите в тег RK7Query UserGUID, UserID и UserPass:
Обязательные поля:
Атрибут | Тип значения | |
---|---|---|
GUIDString | GUID | Уникальный идентификатор объекта |
MainParentIdent | GUID | Ссылка на родителя. Родитель должен существовать или быть в xml ранее |
Name | string | Название товара |
Дополнительные поля:
Атрибут | Тип значения | |
---|---|---|
Code | Integer | Код объекта (уникальный, для быстрого доступа) |
AltName | string | Альтернативное имя |
ExtCode | Integer | Внешний код объекта (уникальный, для внешних систем) |
Status | rsActive, rsInactive, rsDeleted | Статус объекта (активен (доступен), недоступен, удален) |
Результат успешного выполнения:
Создание классификаций
Есть ограничение на количество классификаций. При достижении ограничения сервер вернет ошибку.
Ident при генерации новой классификации нужно задавать вручную, он должен быть кратен 256. Все что не кратно 256 будет считаться категорией.
Обязательные поля:
Атрибут | Тип значения | |
---|---|---|
UserGUID | GUID | Уникальный идентификатор пользователя |
UserID | Integer | Идентификатор пользователя |
UserPass | Integer | Пароль пользователя |
GUIDString | GUID | Уникальный идентификатор объекта |
Ident | Integer | Уникальный идентификатор объекта |
Name | string | Название товара |
Создание категорий
Ident при генерации также необходимо задавать вручную, он должен быть по значению больше MainParentIdent и меньше MainParentIdent + 256.
Обязательные поля:
Атрибут | Тип значения | |
---|---|---|
GUIDString | GUID | Уникальный идентификатор объекта |
MainParentIdent | GUID | Ссылка на родительскую классификацию. Родитель должен существовать или быть в xml ранее |
Ident | Integer | Уникальный идентификатор объекта |
Name | string | Название товара |
Создание модификаторов
Обязательные поля:
Атрибут | Тип значения | |
---|---|---|
GUIDString | GUID | Уникальный идентификатор объекта |
MainParentIdent | GUID | Ссылка на родительскую классификацию. Родитель должен существовать или быть в xml ранее |
Name | string | Название товара |
Где:
- SalesTerms_StartSale — дата начала продаж
- SalesTerms_StopSale — дата конца продаж
- PRICETYPES-1000231 — указание цены в копейках для типа цены с Ident = 1000231
- TRADEGROUPS-1000132=«3» — указание значения для торговой группы с Ident = 1000132
Создание схем модификаторов
Где:
- MainParentIdent — родительский сет
- Если есть ModiSchemeType — тип схемы
- AutoOpen — флаг автооткрытия
- IgnoreDefaultForKitchen — флаг игнорировать «по умолчанию»
Назначение схемы модификатора на блюдо
Где ModiScheme — это Ident схемы модификаторов.