Зміст
Формат обмена данными JSON
Общее описание
В файл JSON выгружаются данные:
- Информация о базе данных, дате выгрузки, версии JSON [info]
- Справочник “Организации” [entities] [entitiesgroups]
- Справочник “Денежные счета организаций” [moneyaccounts]
- Справочник “Склады” [stores]
- Справочник “Партнеры (контрагенты)” [partners]
- Справочник “Договора” [contracts]
- Справочник “Налоговые группы” [vats]
- Справочник “Статьи движения денежных средств” [itemscost]
- Справочник “Валюты” [currencies]
- Справочник “Пользователи” [users]
- Справочник “Столы” (для ресторана) [tables]
- Справочник “Товары” [goods] [goodsgroups]
- Справочник “Рецепты” [recipes]
- Документы [docs]
В большинстве справочников также выгружается информация о группах, например, Справочник “Товары”:
При загрузке JSON-файла в другую систему учета рекомендуется загружать только те данные, которые будут использоваться. Например, раздел “Столы” можно не загружать, если объект учета не использует столы (фаст-фуд, магазин).
Порядок загрузки желательно соблюдать, как в списке выше, так как, например, в документах есть ссылки на Товары, в Товарах есть ссылки на Поставщиков. Поэтому сначала выполняется загрузка Группы справочников, потом Справочников, потом Документов.
Структура JSON файла выгрузки
[info] Информация о JSON файле
В секции [info] представлена информация о файле выгрузки.
| Параметр | Тип | Описание |
|---|---|---|
| ver | Целое число | Версия JSON-формата выгрузки. |
| jsondocdate | Строка | Дата создания выгрузки в формате: ГГГГММДДччммсс |
| sourceID | Строка | Идентификатор базы данных, с которой делалась выгрузка. Можно использовать, чтобы случайно не загрузить данные из других баз. |
[groups] Группы справочников
Большинство справочников имеют свою структуру - группы. Это секции в JSON-файле с именами:
- [entitiesgroups] - относится к справочнику Организации.
- [stores] - относится к справочнику Склады.
- [partnersgroups] - относится к справочнику Партнеры (контрагенты).
- [vatsgroups] - относится к справочнику Налоговые группы.
- [itemscostgroups] - относится к справочнику Статьи движения денежных средств.
- [currenciesgroups] - относится к справочнику Валюты.
- [usersgroups] - относится к справочнику Пользователи.
- [tablesgroups] - относится к справочнику Столы.
- [goodsgroups] - относится к справочнику Товары.
| Параметр | Тип | Описание |
|---|---|---|
| guid | Строка | Уникальный глобальный идентификатор. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый. |
| lid | Целое число | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
| level | Целое число | Уровень вложенности группы : 1 - верхний уровень. |
| name | Строка | Имя группы. Например: “Снеки” |
| fullpath | Строка | Полный путь к группе, например: “\Продукты\Снеки”. |
| children | Массив | Массив объектов - дочерние группы. |
[entities] Справочник Организаций
| Параметр | Тип | Описание |
|---|---|---|
| guid | Строка | Уникальный глобальный идентификатор. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый. |
| lid | Целое число | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
| group | Строка | Ссылка на guid Группы в [entitiesgroups]. |
| code | Строка | Внутренний код Организации. |
| name | Строка | Короткое имя. |
| namefull | Строка | Полное имя. |
| inn | Строка | ИНН - индивидуальный налоговый номер. |
| edrpou | Строка | ЕГРПОУ, ОКПО. |
| nnds | Строка | № свидетельства НДС. |
| tel1 | Строка | Телефон1 организации. |
| tel2 | Строка | Телефон2 организации. |
| tel3 | Строка | Телефон3 организации. |
| adr1 | Строка | Адрес1 организации. |
| adr2 | Строка | Адрес1 организации. |
| adr3 | Строка | Адрес1 организации. |
| visible | Целое число | Если = 1, то Огранизация доступна для выбора пользователям. |
[goods] Справочник Товаров
| Параметр | Тип | Описание |
|---|---|---|
| guid | Строка | Уникальный глобальный идентификатор. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый. |
| lid | Целое число | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
| group | Строка | Ссылка на guid Группы в [goodsgroups]. |
| code | Строка | Код товара. |
| name | Строка | Короткое имя. |
| namefull | Строка | Полное имя. |
| qtty | Дробное число | Количество на складе (для выгрузки в интернет-магазин). |
| barcode | Строка | Основной штрих код. |
| barcode2 | Строка | Штрих код 1-й дополнительной единицы измерения. |
| barcode3 | Строка | Штрих код 2-й дополнительной единицы измерения. |
| barcodelist | Строка | Список дополнительных штрих кодов товара записываются через “;”, пример:“;2930000000008;2932372939017;2930089785748;”. |
| pin | Дробное число | Цена закупочная. |
| p0 | Дробное число | Цена продажная. |
| p1..p10 | Дробное число | Дополнительные продажные цены. |
| unit1 | Строка | Основная единица измерения. |
| unit2 | Строка | Дополнительная 1-я единица измерения. |
| unit3 | Строка | Дополнительная 2-я единица измерения. |
| coeff2 | Дробное число | Коэффициент преобразования в 1-ю доп. единицу измерения. |
| coeff3 | Дробное число | Коэффициент преобразования в 2-ю доп. единицу измерения. |
| visible | Целое число | Доступность товара. 0-товар недоступный, 1-доступный и бек- и фронт-офис (экран кассира), 2-доступный только в бек-офис. |
| vendor | Строка | Ссылка на guid Поставщика в [partners]. |
| vat | Целое число | Группа налога (для кассовых аппаратов) совпадает с кодом налога “code” в секции [vats]. 1-'А', 2-'Б', 3-'В' и т.д. |
| desc | Строка | Дополнительное описание товара. |
| min | Дробное число | Управление складскими запасами: минимальное количество на складе. |
| nom | Дробное число | Управление складскими запасами: номинальное количество на складе. |
| scs | Целое число | Весы с печатью этикетки: Срок годности в днях. |
| plu | Целое число | Весы с печатью этикетки: номер PLU на весах. Если=0, то номер PLU совпадает с кодом товара “code”. Если=-1, то товар на весы не выгружается. |
| tare | Целое число | Весы с печатью этикетки: вес тары в граммах. |
| piece | Целое число | Весы с печатью этикетки: если = 1, то товар на весы выгружается как штучный. |
| type | Целое число | Если = 1, то товар имеет рецепт, и может автоматически производится. |
| lost | Дробное число | Процент потерь при обработке товара, если он выступает ингредиентом в рецепте. |
| outw | Дробное число | Вес порции, если этот товар имеет рецепт. Используется в печати технологической карты. |
[docs] Документы список
| Параметр | Тип | Описание |
|---|---|---|
| guid | Строка | Уникальный глобальный идентификатор документа. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый. |
| lid | Целое число | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
| type | Целое число | Тип документа: 1-Приход 2-Продажа 3-Прайс-лист ЕККА 4-Поступление денежных средств 5-Расход денежных средств 6-Заказ покупателя 7-Заказ поставщику 8-Перемещение 9-Списание 10-Оприходование 11-Возврат покупателя 12-Возврат поставщику 13-Производство 14-Переучет |
| num | Целое число | Номер документа. |
| sum | Дробное число | Сумма документа. |
| date | Строка | Дата документа в формате: ГГГГММДДччммсс |
| entity | Строка | Ссылка на guid Организации в [entities]. |
| partner | Строка | Ссылка на guid Партнера в [partners]. |
| contract | Строка | Ссылка на guid Договора в [contracts]. |
| store | Строка | Ссылка на guid Склада в [stores]. |
| storeto | Строка | Ссылка на guid Склада в [stores]. Присутствует в документах type: 8 (Перемещение). Склад на который перемещается товар. |
| user | Строка | Ссылка на guid Пользователя в [users]. |
| moneyaccid | Строка | Ссылка на guid Денежнего счета в [moneyaccounts]. Присутствует в документах type: 4, 5. |
| itemcostid | Строка | Ссылка на guid Статьи расхода в [itemscost]. Присутствует в документах type: 4, 5. |
| state | Целое число | Состояние: 0-проведен, 1-не проведен, 2- помечен на удаление. |
| desc | Строка | Примечание. |
| treeid | Целое число | Идентификатор связанных документов. Документы одного дерева имеют один идентификатор treeid. |
| innum | Строка | Номер входящего документа. Для документов type: 1, 7. |
| indate | Строка | Дата входящего документа в формате: ГГГГММДДччммсс |
| rrocnum | Целое число | Номер чека напечатанного на фискальном принтере (для type: 2, 11). |
| rrodevnum | Строка | Заводской номер фискального принтера (для type: 2, 11). |
| prodtype | Целое число | Только для Производства (type: 13). 0-У каждого продукта свои ингредиенты. 2-Список продуктов и ингредиентов общий: ингредиенты все списываются со склада, а продукты оприходываются (без конкретной привязки продукт-ингредиент). |
| docgoods | Массив | Список товаров в документе |
[docs.docgoods] Список товаров в документах
| Параметр | Тип | Описание |
|---|---|---|
| guid | Строка | Ссылка на guid Товара в [goods]. |
| qtty | Дробное число | Количество товара в строке документа. |
| sum | Дробное число | Сумма - стоимость товара в строке документа с учетом скидки. |
| disc | Дробное число | Скидка (в денежном измерении) на стоимость товара в строке документа. |
| tindoc | Целое число | Только для документа Производство (type: 13). 1-продукт, 2-сырье/ингредиент. |
| posdoc | Целое число | Только для документа Производство (type: 13). По этому параметру в рамках документа сопоставляется “Продукт” и его “Ингредиенты”. У каждого “Продукта” свой номер posdoc, по этому номеру нужно найти все “Ингредиенты” (tindoc=2) у которых такой же posdoc. Если в документе prodtype = 2, то не нужно сопоставлять. |