Инструменты пользователя

Инструменты сайта


обмен_данными_с_другими_системами:формат_обмена_json

Формат обмена данными JSON

Общее описание

В файл JSON выгружаются данные:

  1. Информация о базе данных, дате выгрузки, версии JSON [info]
  2. Справочник «Организации» [entities] [entitiesgroups]
  3. Справочник «Денежные счета организаций» [moneyaccounts]
  4. Справочник «Склады» [stores]
  5. Справочник «Партнеры (контрагенты)» [partners]
  6. Справочник «Договора» [contracts]
  7. Справочник «Налоговые группы» [vats]
  8. Справочник «Статьи движения денежных средств» [itemscost]
  9. Справочник «Валюты» [currencies]
  10. Справочник «Пользователи» [users]
  11. Справочник «Столы» (для ресторана) [tables]
  12. Справочник «Товары» [goods] [goodsgroups]
  13. Справочник «Рецепты» [recipes]
  14. Документы [docs]

В большинстве справочников также выгружается информация о группах, например, Справочник «Товары»:

При загрузке JSON-файла в другую систему учета рекомендуется загружать только те данные, которые будут использоваться. Например, раздел «Столы» можно не загружать, если объект учета не использует столы (фаст-фуд, магазин).

Порядок загрузки желательно соблюдать, как в списке выше, так как, например, в документах есть ссылки на Товары, в Товарах есть ссылки на Поставщиков. Поэтому сначала выполняется загрузка Группы справочников, потом Справочников, потом Документов.

Структура JSON файла выгрузки

[info] Информация о JSON файле

В секции [info] представлена информация о файле выгрузки.

Параметр Тип Описание
ver Целое число Версия JSON-формата выгрузки.
jsondocdate Строка Дата создания выгрузки в формате: ГГГГММДДччммсс
sourceID Строка Идентификатор базы данных, с которой делалась выгрузка. Можно использовать, чтобы случайно не загрузить данные из других баз.

[groups] Группы справочников

Большинство справочников имеют свою структуру - группы. Это секции в JSON-файле с именами:

  1. [entitiesgroups] - относится к справочнику Организации.
  2. [stores] - относится к справочнику Склады.
  3. [partnersgroups] - относится к справочнику Партнеры (контрагенты).
  4. [vatsgroups] - относится к справочнику Налоговые группы.
  5. [itemscostgroups] - относится к справочнику Статьи движения денежных средств.
  6. [currenciesgroups] - относится к справочнику Валюты.
  7. [usersgroups] - относится к справочнику Пользователи.
  8. [tablesgroups] - относится к справочнику Столы.
  9. [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 Дробное число Вес порции, если этот товар имеет рецепт. Используется в печати технологической карты.
обмен_данными_с_другими_системами/формат_обмена_json.txt · Последние изменения: 2019/04/24 21:55 — ipostalatii