QuickBooks — это бухгалтерский программный пакет, разработанный Intuit. Продукты QuickBooks ориентированы в основном на малый и средний бизнес и предлагают локальные бухгалтерские приложения, а также облачные версии, которые принимают бизнес-платежи, управляют и оплачивают счета, а также функции расчета заработной платы.
Наш модуль позволяет:
Создавать клиентов в QB;
Создавать продажи и счёт фактуры (Payment+Invoice);
При создании продажи (Payment) передаем информацию о клиенте (ФИО, почта, почта), состав заказа, тип и статус оплаты, статус заказа;
Передавать изменения из RetailCRM в QB: состав заказа, статус заказа, тип и статус оплаты;
Формировать каталог товаров для выгрузки из QB в RetailCRM.
Войдите под своей учетной записью в Silma с правами администратора.
Перейдите в Setting/Integration/API access keys и нажмите кнопку «Add».
Выберите тип доступа к магазину.
Отметьте магазин из списка, с которым будет работать модуль.
Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).
Скопируйте ключ.
Нажмите “Save”.
2. Вход в настройки модуля
Перейдите в Setting/Integration/Marketplace.
Выберите модуль.
3. Нажмите кнопку «Go to account setting». При первом входе откроется страница регистрации.
3. Подключение модуля
— Вкладка «Access»
Link to RetailCRM of the form: https://YOUR-DOMAIN.retailcrm.ru — вставляем ссылку на ваш RetailCRM/Silma
— Вкладка «Account»
Для добавления нового аккаунта нажмите add account, для редактирования и перехода в настройки — кнопка гаечный ключ (Edit), для удаления — значок с мусорной корзиной (Delete).
Добавим магазин: нажимаем add account и вписываем Account name, затем сохраняем — Save
4. Создание приложения для работы с QB
Переходим по ссылке https://developer.intuit.com/app/developer/homepage и авторизуемся под своей учётной записью.
Нажимаем Dashboard/Create an app.
Далее на кликаем на иконку приложения.
Заполняем название приложения, активируем 2 чак-бокс и нажимаем Create app.
Теперь нам нужно скопировать в отдельное место следующие важные параметры:
Нажимаем Dashboard и переходим в созданное приложение.
Переходим на вкладку API Docs & Tools/Sandbox и копируем Company ID.
5. Настройка интеграции
Переходим к настройке, кнопка гаечный ключ (Edit).
— Вкладка «Authorization»
Заполняем основные поля:
Account name — присваивается автоматически при добавлении магазина (может быть изменено);
Client ID — данные из предыдущего шага;
Client Secret — данные из предыдущего шага;
QBO Company ID — данные из предыдущего шага;
Mode — тип подключения боевой(Production) или тестовый (Development);
Примечание: Поля Authorization Method, Access Token, Refresh Token подтягиваются автоматически после нажатия Save and update token
Redirect URI — копируем это значение и возвращаемся в среду создания приложения для QB из шага Создание приложения для работы с QB. Нажимаем Dashboard и переходим в созданное приложение, опускаемся в разделе Keys & credentials. В самом низу в разделе Redirect URIs нажимаем Add API и вставляем скопированный ранее Redirect URI .
3. Нажимаем Save and update token
— Вкладка «Setting»
Заполняем основные настройки на вкладке:
Shop — магазин, доступный API-key;
Store — выбрать 1 склад, доступный магазину;
CRM custom field TAX code — выбираем пользовательское поле, которое содержит перечень налоговых ставок (подробнее в приложении 2);
Чек-бокс: Create cron orders (every 5 minutes) — включите, если нужно обновлять заказ;
Чек-бокс: Create cron payments (every 5 minutes) — включите, если нужно обновлять оплаты;
Чек-бокс: Update file by cron (every 3 hours) — включите, если нужно обновлять ссылку на каталог;