Формат обміну даними 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	Рядок	Адреса2 організації.
adr3	Рядок	Адреса3 організації.
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, то не нужно сопоставлять.