Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- обмін_даними_з_іншими_системами:формат_обмену_json [2022/05/18 18:09] – створено ipostalatii
+++ обмін_даними_з_іншими_системами:формат_обмену_json [2022/05/19 17:08] – ipostalatii
@@ Рядок 1: / Рядок 1: @@
-====== Формат обмена данными JSON ======
+====== Формат обміну даними JSON ======
-===== Общее описание =====
+===== Загальний опис =====
-В файл JSON выгружаются данные:
+У файл JSON вивантажуються дані:
-  - Информация о базе данных, дате выгрузки, версии JSON [[#[info] Информация о JSON файле|[info]]]
+  - Інформація про базу даних, дату вивантаження, версію JSON[[#[info] Інформація про JSON файл|[info]]]
-  - Справочник "Организации" [[#[entities] Справочник Организаций|[entities]]] [[#[groups] Группы справочников|[entitiesgroups]]]
+  - Довідник "Організації" [[#[entities] Довідник Організацій|[entities]]] [[#[groups] Групи довідників|[entitiesgroups]]]
-  - Справочник "Денежные счета организаций" [**moneyaccounts**]
+  - Довідник "Грошові рахунки організацій" [**moneyaccounts**]
-  - Справочник "Склады" [**stores**]
+  - Довідник "Склади" [**stores**]
-  - Справочник "Партнеры (контрагенты)" [**partners**]
+  - Довідник "Партнери (контрагенти)" [**partners**]
-  - Справочник "Договора" [**contracts**]
+  - Довідник "Договору"[**contracts**]
-  - Справочник "Налоговые группы" [**vats**]
+  - Довідник "Податкові групи" [**vats**]
-  - Справочник "Статьи движения денежных средств" [**itemscost**]
+  - Довідник "Статті руху грошових коштів"[**itemscost**]
-  - Справочник "Валюты" [**currencies**]
+  - Довідник "Валюти"[**currencies**]
-  - Справочник "Пользователи" [**users**]
+  - Довідник "Користувачі" [**users**]
-  - Справочник "Столы" (для ресторана) [**tables**]
+  - Довідник "Столи" (для ресторану) [**tables**]
-  - Справочник "Товары" [[#[goods] Справочник Товаров|[goods]]] [[#[groups] Группы справочников|[goodsgroups]]]
+  - Довідник "Товари" [[#[goods] Довідник Товарів|[goods]]] [[#[groups] Групи довідників|[goodsgroups]]]
-  - Справочник "Рецепты" [**recipes**]
+  - Довідник "Рецепти" [**recipes**]
-  - Документы [[#[docs] Документы список|[docs]]]
+  - Документи [[#[docs] Документи список|[docs]]]
-В большинстве справочников также выгружается информация о группах, например, Справочник "Товары":
+У більшості довідників також вивантажується інформація про групи, наприклад, Довідник "Товари":
 {{ :обмен_данными_с_другими_системами:json-goods-1.png?nolink |}}
-При загрузке JSON-файла в другую систему учета рекомендуется загружать только те данные, которые будут использоваться. Например, раздел "Столы" можно не загружать, если объект учета не использует столы (фаст-фуд, магазин).
+При завантаженні файлу JSON в іншу систему обліку рекомендується завантажувати лише ті дані, які будуть використовуватися. Наприклад, розділ "Столи" можна не завантажувати, якщо об'єкт обліку не використовує столи (фаст-фуд, магазин).
+Бажано дотримуватись порядку завантаження, як у списку вище, тому що, наприклад, у документах є посилання на Товари, у Товарах є посилання на Постачальників. Тому спочатку виконується завантаження Групи довідників, потім Довідників, потім Документів.
-Порядок загрузки желательно соблюдать, как в списке выше, так как, например, в  документах есть ссылки на Товары, в Товарах есть ссылки на Поставщиков. Поэтому сначала выполняется загрузка Группы справочников, потом Справочников, потом Документов.
+===== Структура JSON файлу вивантаження =====
+==== [info] Інформація про JSON файл ====
+У секції [info] представлена інформація про файл вивантаження.
+^ Параметр      ^ Тип         ^ Опис ^
+| ver  | Ціле число| Версія JSON-формату вивантаження.|
+| jsondocdate| Рядок | Дата створення вивантаження у форматі: РРРРММДДччммсс  |
+| sourceID| Рядок | Ідентифікатор бази даних, з якої робилося розвантаження. Можна використовувати, щоб випадково не завантажити дані з інших баз.|
-===== Структура JSON файла выгрузки =====
+==== [groups] Групи довідників ====
-==== [info] Информация о JSON файле ====
+Більшість довідників мають свою структуру – групи.
-В секции [info] представлена информация о файле выгрузки.
+Це секції Це секції в JSON-файлі з іменами:
-^ Параметр      ^ Тип         ^ Описание ^
+  - **[entitiesgroups]** - належить до довідника Організації.
-| ver  | Целое число| Версия JSON-формата выгрузки.|
+  - **[stores]** - відноситься до довідника Склади.
-| jsondocdate| Строка | Дата создания выгрузки в формате: ГГГГММДДччммсс  |
+  - **[partnersgroups]** - відноситься до довідника Партнери (контрагенти).
-| sourceID| Строка  | Идентификатор базы данных, с которой делалась выгрузка. Можно использовать, чтобы случайно не загрузить данные из других баз.|
+  - **[vatsgroups]** - відноситься до довідника Податкові групи.
+  - **[itemscostgroups]** - відноситься до довідника Статті руху грошових коштів.
+  - **[currenciesgroups]** - відноситься до довідника Валюти.
+  - **[usersgroups]** - відноситься до довідника Користувачі.
+  - **[tablesgroups]** - відноситься до довідника Столи.
+  - **[goodsgroups]** - відноситься до довідника.
-==== [groups] Группы справочников ====
+^ Параметр      ^ Тип         ^ Опис ^
-Большинство справочников имеют свою структуру - группы.
+| guid  | Рядок    | Унікальний глобальний ідентифікатор. Унікальний за всіма базами даних. Рекомендується використовувати його. Розмір рядка завжди однаковий.|
-Это секции в JSON-файле с именами:
+| lid| Ціле число   | Локальний ідентифікатор у межах однієї бази даних. НЕ рекомендується використовувати його. |
-  - **[entitiesgroups]** - относится к справочнику Организации.
+| level| Ціле число | Рівень вкладеності групи: 1 - верхній рівень.|
-  - **[stores]** - относится к справочнику Склады.
+| name| Рядок | Назва групи. Наприклад: "Снеки"|
-  - **[partnersgroups]** - относится к справочнику Партнеры (контрагенты).
+| fullpath| Рядок | Повний шлях до групи, наприклад: "\Продукти\Снеки".|
-  - **[vatsgroups]** - относится к справочнику Налоговые группы.
+| children| Масив | Масив об'єктів – дочірні групи.|
-  - **[itemscostgroups]** - относится к справочнику Статьи движения денежных средств.
-  - **[currenciesgroups]** - относится к справочнику Валюты.
-  - **[usersgroups]** - относится к справочнику Пользователи.
-  - **[tablesgroups]** - относится к справочнику Столы.
-  - **[goodsgroups]** - относится к справочнику Товары.
-^ Параметр      ^ Тип         ^ Описание ^
-| guid  | Строка     | Уникальный глобальный идентификатор. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый.|
-| lid| Целое число   | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
-| level| Целое число | Уровень вложенности группы : 1 - верхний уровень.|
-| name| Строка | Имя группы. Например: "Снеки"|
-| fullpath| Строка | Полный путь к группе, например: "\Продукты\Снеки".|
-| children| Массив | Массив объектов - дочерние группы.|
+==== [entities] Довідник Організацій ====
-==== [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, то Обмеження доступне для вибору користувачам.|
-^ Параметр      ^ Тип         ^ Описание ^
-| 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] Довідник Товарів ====
-==== [goods] Справочник Товаров ====
+^ Параметр      ^ Тип         ^ Опис ^
+| guid  | Рядок     | Унікальний глобальний ідентифікатор. Унікальний за всіма базами даних. Рекомендується використовувати його. Розмір рядка завжди однаковий.|
-^ Параметр      ^ Тип         ^ Описание ^
+| lid| Ціле число   | Локальний ідентифікатор у межах однієї бази даних. НЕ рекомендується використовувати його. |
-| guid  | Строка     | Уникальный глобальный идентификатор. Уникальный по всем базам данных. Рекомендуется его использовать. Размер строки всегда одинаковый.|
+| group| Рядок  | Посилання на guid Групи в [goodsgroups].|
-| lid| Целое число   | Локальный идентификатор в пределах одной базы данных. НЕ рекомендуется его использовать. |
+| code| Рядок  | Код товара.|
-| group| Строка | Ссылка на guid Группы в [goodsgroups].|
+| name| Рядок  | Короткое имя.|
-| code| Строка | Код товара.|
+| namefull| Рядок  | Полное имя.|
-| name| Строка | Короткое имя.|
-| namefull| Строка | Полное имя.|
 | qtty| Дробное число| Количество на складе (для выгрузки в интернет-магазин).|
-| barcode| Строка | Основной штрих код.|
+| barcode| Рядок  | Основной штрих код.|
-| barcode2| Строка | Штрих код 1-й дополнительной единицы измерения.|
+| barcode2| Рядок  | Штрих код 1-й дополнительной единицы измерения.|
-| barcode3| Строка | Штрих код 2-й дополнительной единицы измерения.|
+| barcode3| Рядок  | Штрих код 2-й дополнительной единицы измерения.|
-| barcodelist| Строка | Список дополнительных штрих кодов товара записываются через ";", пример:";2930000000008;2932372939017;2930089785748;".|
+| barcodelist| Рядок  | Список дополнительных штрих кодов товара записываются через ";", пример:";2930000000008;2932372939017;2930089785748;".|
 | pin| Дробное число| Цена закупочная.|
 | p0| Дробное число| Цена продажная.|
 | p1..p10| Дробное число| Дополнительные продажные цены.|
-| unit1| Строка | Основная единица измерения.|
+| unit1| Рядок  | Основная единица измерения.|
-| unit2| Строка | Дополнительная 1-я единица измерения.|
+| unit2| Рядок  | Дополнительная 1-я единица измерения.|
-| unit3| Строка | Дополнительная 2-я единица измерения.|
+| unit3| Рядок  | Дополнительная 2-я единица измерения.|
 | coeff2| Дробное число| Коэффициент преобразования в 1-ю доп. единицу измерения.|
 | coeff3| Дробное число| Коэффициент преобразования в 2-ю доп. единицу измерения.|
-| visible| Целое число| Доступность товара. 0-товар недоступный, 1-доступный и бек- и фронт-офис (экран кассира), 2-доступный только в бек-офис.|
+| visible| Ціле число| Доступность товара. 0-товар недоступный, 1-доступный и бек- и фронт-офис (экран кассира), 2-доступный только в бек-офис.|
-| vendor| Строка | Ссылка на guid Поставщика в [partners].|
+| vendor| Рядок  | Ссылка на guid Поставщика в [partners].|
-| vat| Целое число| Группа налога (для кассовых аппаратов) совпадает с кодом налога "code" в секции [vats]. 1-'А', 2-'Б', 3-'В' и т.д.|
+| vat| Ціле число| Группа налога (для кассовых аппаратов) совпадает с кодом налога "code" в секции [vats]. 1-'А', 2-'Б', 3-'В' и т.д.|
-| desc| Строка | Дополнительное описание товара.|
+| desc| Рядок  | Дополнительное описание товара.|
 | min| Дробное число| Управление складскими запасами: минимальное количество на складе.|
 | nom| Дробное число| Управление складскими запасами: номинальное количество на складе.|
-| scs| Целое число| Весы с печатью этикетки: Срок годности в днях.|
+| scs| Ціле число| Весы с печатью этикетки: Срок годности в днях.|
-| plu| Целое число| Весы с печатью этикетки: номер PLU на весах. Если=0, то номер PLU совпадает с кодом товара "code". Если=-1, то товар на весы не выгружается.|
+| plu| Ціле число| Весы с печатью этикетки: номер PLU на весах. Если=0, то номер PLU совпадает с кодом товара "code". Если=-1, то товар на весы не выгружается.|
-| tare| Целое число| Весы с печатью этикетки: вес тары в граммах.|
+| tare| Ціле число| Весы с печатью этикетки: вес тары в граммах.|
-| piece| Целое число| Весы с печатью этикетки: если = 1, то товар на весы выгружается как штучный.|
+| piece| Ціле число| Весы с печатью этикетки: если = 1, то товар на весы выгружается как штучный.|
-| type| Целое число| Если = 1, то товар имеет рецепт, и может автоматически производится.|
+| type| Ціле число| Если = 1, то товар имеет рецепт, и может автоматически производится.|
 | lost| Дробное число| Процент потерь при обработке товара, если он выступает ингредиентом в рецепте.|
 | outw| Дробное число| Вес порции, если этот товар имеет рецепт. Используется в печати технологической карты.|