1. Создание и заполнение Google-таблицы

1.1.  Создание Google-аккаунта и загрузка шаблона

Прежде всего, для работы с Google-таблицей необходимо завести Google-аккаунт.

Далее, мы предлагаем использовать наш готовый шаблон, который вы можете скачать по этой ссылке: https://docs.google.com/spreadsheets/d/1YPdUD3PK74_R9fHppBvQJOdRpuxo2NfgdUAmLfDsvuA/edit#gid=1487831409

Открыв таблицу, нажимаем “Файл” и выбираем “Создать копию”.

Копия таблицы появится на вашем Google-диске и теперь вы можете с ней полноценно работать!

---

1.2. Заполнение вкладки (листа) “Категории”

Для заполнения категорий, выбираем первый лист таблицы “Categories”

И заполняем каждую колонку:

#id — это ID каждой категории в базе данных вашего бота. Если ID совпадает с уже существующим в базе — он будет перезаписан. Если ID категории не существует или равен 0 — будет создана новая категория.

#sort — Порядковый номер категории . Используется для сортировки вывода категории пользователю в боте. Чем больше номер, тем дальше категория.

#parent_id — это вложенность категорий. 0 — Главная (родительская) категория Все остальные значения должны соответствовать ID категории, в которую нужно сделать вложенность.

#name — обязательное название категории. Поле не может быть пустым! Если не заполнить это поле, прерывается импорт на конкретной категории.

#image — изображение категории. Необходимо вставить полную ссылку с ресурса, на котором расположено изображение. Ссылка должна начинаться с http\https и заканчиваться форматом изображения. Если поле пустое — категория сохраняет исходное изображение. Максимальный размер изображения — 2 МБ, если размер больше — изображение не будет загружено в систему. В таком случае, воспользуйтесь онлайн-сервисом сжатия для уменьшения размера файла.

#hidden — Включить/Выключить. Отвечает за отображение категории в боте. Напишите «TRUE», если категория должна быть скрыта для пользователя.

---

1.3. Заполнение вкладки (листа) “Товары”

Заполнение товаров аналогично категориям, но с парой дополнительных колонок.

Выбираем второй лист таблицы “Products”

И заполняем каждую колонку:

#id — это ID каждого товара в базе данных вашего бота. Если ID совпадает с уже существующим в базе — он будет перезаписан. Если ID товара не существует или равен 0 — будет создан новый товар.

#sort — Порядковый номер товара. Используется для сортировки вывода товара пользователю в боте. Чем больше номер, тем дальше товар.

#name — обязательное название товара. Поле не может быть пустым! Если не заполнить это поле, прерывается импорт на конкретном товаре.

#description — описание товара. Если не заполнить поле, товар не будет иметь никакого описания соответственно.

#categories_id — ID категории, к которой принадлежит товар. Если ID категории совпадает с существующей в базе — она будет привязана к товару. Если совпадений не удается найти в базе, товар будет загружен без категории.

#image — изображение товара. Необходимо вставить полную ссылку с ресурса, на котором расположено изображение. Ссылка должна начинаться с http\https и заканчиваться форматом изображения. Если поле пустое — товар сохраняет исходное изображение. Максимальный размер изображения — 2 МБ, если размер больше — изображение не будет загружено в систему. В таком случае, воспользуйтесь онлайн-сервисом сжатия для уменьшения размера файла.

#price —  цена товара. Может быть указана как целым числом (например, 5), так и с плавающей точкой до 2 знаков после точки. (например, 5.0 или 5.00, но не более символом после точки). Между числами не должно быть пробелов.

#unit — единица измерения вашей продукции. Доступные единицы измерения: шт. кг. г. л. мл. м. см.

Если вы не укажете единицу измерения, товар по умолчанию получит значение «шт.»

#discount — скидка. Может быть указана как целым числом так и с плавающей точкой до 2 знаков после точки. Не используйте как разделитель запятую! Не используйте буквы! Если после числа указан знак ‘%’, обрабатывается как процент от цены, в обратном случае как фиксированная скидка

#quantity — количество товара. Только целые числа, минимальное число 0. Если упущено или указано 0, то обрабатывается как #hidden = 1

#hidden — Включить/Выключить. Отвечает за отображение товара в боте. Напишите «TRUE», если товар должен быть скрыт для пользователя.

---

2. Импорт категорий и товаров из Google-таблицы

2.1. Импорт категорий и товаров из Google-таблицы

Когда таблица будет готова для импорта, открываем приборную доску (административную панель), вкладку “Магазин”, выбираем подвкладку “Импорт/Экспорт”.

Вставляем ссылку на заполненную таблицу, нажимаем на зеленую кнопку “Сохранить”, а затем ниже на кнопку “Загрузить данные из Google Sheets → JoinChat”.

Если таблица заполнена правильно, вся информация начнет загружаться на сервер.

Пожалуйста, не закрывайте данную вкладку до полного завершения загрузки.

---

2.2. “Ошибка при сохранении”

Попробуйте изменить режим доступа к документу.

---

2.3. Почему загрузилась только часть товаров?

Внимательно проверьте все данные, которые вы вводили: вероятно, в одной из ячеек вверены некорректные данные, либо символы.

---

2.4. Товары загрузились без категорий

Перепроверьте корректность данных в колонке #categories_id на листе “Prosucts” — ID категорий обязательно должны быть в квадратных скобках [].

Не должно быть никаких других символов, букв или буквальных наименований категорий.

---

2.5. Не работают изображения

Ссылка на изображение не должна быть кликабельной.

Нажмите на ячейку и выберите “Удалить ссылку”

В конце ссылки обязательно должен быть формат изображения, иначе бот не сможет отобразить картинку.

---

3. Пример заполнения таблицы

1. Лист Categories — Категории

1.1. Заполняем ID категорий и подкатегорий

Прописываем ID родительских (основных) категорий.Например, 1, 2, 3…

Важно, чтобы в дальнейшем другие категории не имели данный ID

---

1.2. Определяем порядок сортировки категорий

Если это необходимо, определяем порядок перечня каждой категории в списке.

Если порядок категорий не имеет значения, оставляем 0.

---

1.3. Определяем вид категории

Существует два вида категорий:

Родительская категория — основная категория, в которой находятся подкатегории.

Подкатегория — категория, которая вложена в другую категорию, и в которой находятся товары или другие подкатегории.

---

1.4. Добавляем изображение

Ссылка на изображение не должна быть кликабельной.

Нажмите на ячейку и выберите “Удалить ссылку”

В конце ссылки обязательно должен быть формат изображения, иначе бот не сможет отобразить картинку.

Рассмотрим два примера:

1) Родительская категория с подкатегорией с товарами:

В #parent_id подкатегорий указываем ID родительской (основной) категории, которая будет содержать данную подкатегорию.

Например, родительская категория “Одежда” имеет ID “1”

Следовательно, подкатегории “Блузки” и “Свитера” в #parent_id будут содержать значение “1”

Родительская категория “Обувь”  имеет ID “2”

ледовательно, подкатегории “Ботинки” и “Туфли” в #parent_id будут содержать значение “2” и так далее.

---

2) Родительская категория с подкатегорией с подкатегориями:

Подкатегории также могут содержать подкатегории.

Например, в категории “Одежда” есть подкатегория “Блузки” как в предыдущем примере, но данные товары также поделены по бренду, составу или другим сортировочным параметрам.

В таком случае создаём подкатегории с наименованиями брендов (условно) и в  #parent_id присваиваем им ID подкатегории “Блузки”, то есть в данном случае это ID со значением “5”.

---

2. Лист Products — Продукты / Товары

Как в случае с категориями, назначаем каждому товару ID и порядковый номер.

Далее определяем, к какой категории относится каждый товар.

Продолжим предыдущий пример с категориями блузок.

Допустим, Блузка 1 от Бренда №2, а Блузка 2 от Бренда №3. Так как бренды мы уже распределили в категориях, Блузку 1 относим к категории [14] в #categories_id.

Как мы помним по таблице категорий, 14 — это ID подкатегории “Бренд 2”.

Соответственно, Блузка 2 в #categories_id получает значение [15], так как относится к подкатегории “Бренд 3”, чей ID — “15”.

Загрузка изображений аналогична пункту 4.1.3.

Прописываем цену каждого товара в колонке #price
Прописываем скидку каждого товара в колонке #discount

Обратите внимание, что между цифрами не должно быть пробелов и никаких символов, кроме точки “.”, если вы указываете стоимость товара с копейками.

Прописываем единицу измерения каждого товара в колонке #unit
Прописываем количество каждого товара в колонке #quantity

Во вкладке Магазин — Импорт/Экспорт вставляем ссылку на свою таблицу в JoinChat и синхронизируем.

---

Экспорт продукции из JoinChat в GoogleSheets

Скачиваем шаблон и удаляем из него все данные, кроме наименования колонок на обоих листах

https://docs.google.com/spreadsheets/d/1YPdUD3PK74_R9fHppBvQJOdRpuxo2NfgdUAmLfDsvuA/edit#gid=1487831409

Во вкладке Магазин — Импорт/Экспорт вставляем ссылку на очищенную таблицу, нажимаем “Сохранить”, а затем “Передать данные JoinChat → Google Sheets”

Пожалуйста, не закрывайте данную вкладку до полного завершения загрузки.