Формат обмена данными 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	Строка	Полное имя.
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	Дробное число	Вес порции, если этот товар имеет рецепт. Используется в печати технологической карты.