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