Це стара версія документу!
Зміст
Формат обміну даними 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, то не нужно сопоставлять. |