Интеграция QuickBooks и RetailCRM

Подробная инструкция по установке и активации

Содержание

1. Создание Ключа доступа к API
2. Вход в настройки модуля
3. Подключение модуля
   — Вкладка «Access»
   — Вкладка «Account»
4. Создание приложения для работы с QB
5. Настройка интеграции
   — Вкладка «Authorization»
   — Вкладка «Setting»
   — Вкладка «Statuses»
   — Вкладка «Payments statuses»
   — Вкладка «Catalog»
   — Вкладка «Logs»

Приложение 1

 

 1. Создание Ключа доступа к API

1. Войдите под своей учетной записью в Silma с правами администратора.
2. Перейдите в Setting/Integration/API access keys и нажмите кнопку «Add».
3. Выберите тип доступа к магазину.
4. Отметьте магазин из списка, с которым будет работать модуль.
5. Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).
6. Скопируйте ключ.
7. Нажмите “Save”.

 

2. Вход в настройки модуля

1. Перейдите в Setting/Integration/Marketplace.
   
2.  Выберите модуль.

       

 

3. Нажмите кнопку «Go to account setting». При первом входе откроется страница регистрации.

3. Подключение модуля

— Вкладка «Access»

1. 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.

 

Теперь нам нужно скопировать в отдельное место следующие важные параметры: Client ID, Client Secret, QBO Company ID. 

Client ID и Client Secret:

Нажимаем Dashboard и переходим в созданное приложение.

Данные находятся в разделе Keys & credentials.

 

 

 

QBO Company ID:

Переходим на вкладку API Docs & Tools/Sandbox и копируем Company ID.

 

 

5. Настройка интеграции

Переходим к настройке, кнопка гаечный ключ (Edit).

 

— Вкладка «Authorization» 

1. Заполняем основные поля:

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»

Заполняем основные настройки на вкладке:

 

— Вкладка «Statuses»

Выставляем соответствие статусов RetailCRM статусам QB.

Для добавления нового сопоставления нажмите Add, для удаления сопоставления нажмите Delete. После завершения настройки статусов нажмите Save.

 

— Вкладка «Payments«

Выставляем соответствие типов оплат RetailCRM типам оплат QB.

Для добавления нового сопоставления нажмите Add, для удаления сопоставления нажмите Delete. После завершения настройки статусов нажмите Save.

 

— Вкладка «Payment statuses«

Выставляем соответствие статусов оплат RetailCRM статусам оплат QB.

Для добавления нового сопоставления нажмите Add, для удаления сопоставления нажмите Delete. После завершения настройки статусов нажмите Save.

 

— Вкладка «Catalog«

На данной вкладке доступно формирование каталога и выгрузки товаров из QB в RetailCRM.

Для формирования каталога нажмите Generate catalog.

Затем вам нужно данную часть ссылки совместить вот с этой: , чтобы получилось /files/{ID аккаунта}/icml/{имя файла}.xml

 

— Вкладка «Logs«

На данной вкладке отражаются процессы взаимодействий между QB и RetailCRM

 

Приложение 1

Необходимые методы API для ключа: