201 подписчик

Добавление интеграции Контур.Экстерн с Битрикс24 с помощью Пинкитбилдер

15 декабря 202415 дек 2024

5 мин

Оглавление

1. Как добавить интеграцию, если в Пинкит нет нужного сервиса. Проблема и решение
2. Добавление авторизации сервиса, событий и действий через ПинкитБилдер
2.1. Авторизация

Сегодня разберем ситуацию, когда у вас есть задача интеграции двух сервисов, но в Пинкит нет подходящего реализованного сценария (например, нет авторизации). На примере конкретной задачи пользователя, использующего платформу Контур.Экстерн, расскажем про функционал Пинкитбилдер.

1. Как добавить интеграцию, если в Пинкит нет нужного сервиса. Проблема и решение

Рассмотрим пример. К нам обратился заказчик, который использует платформу Контур.Экстерн. Платформа используется для бухгалтерского учета.

Передаем данные по сделке из Битрикс24 в продажу ПланФакт с выгрузкой суммы, товаров и основных пользовательских полей: интересный кейс по финучету здесь.

Сотрудники его компании ведут сделки, выставляют счета и заполняют данные компаний-контрагентов в Битрикс24. Так как счета также необходимо проводить через Контур.Экстерн, менеджеры вынужденно делают двойную работу, перенося ручками счета из Битрикс24.

Управленческий учет для бизнеса с помощью ПланФакт и Битрикс24: читайте кейс по ссылке.

В Контур.Экстерн ведется информация об остатках товаров и формируются закрывающие бухгалтерские документы (УПД). Еще благодаря интеграции с государственными справочниками из Контур.Экстерн можно получить развернутые данные о реквизитах, кодах ОКВЭД и другие сведения о контрагентах.

Конечно, было бы здорово передавать товары и счета с сопоставлением по компании из Контур.Экстерн в Битрикс24. Это и есть та интеграционная задача, с которой заказчик к нам обратился.

Интеграция для создания и обновления товаров из нескольких касс на СБИС в каталог Битрикс24 по ссылке.

Он зарегистрировался в личном кабинете Пинкит и подключил доступ к своему порталу Битрикс24, но не нашел в списке второго сервиса — Контур.Экстерн. Суть в том, что ранее у нас не было запроса на добавление этого сервиса в Пинкит, поэтому Контур.Экстерн и не было в списке доступных веб-сервисов:

Связка Dadata и Битрикс24 для привязки компаний к сделкам по ИНН: читайте подробнее в нашем блоге.

В той модели, в которой мы работали раньше, это означало бы, что нужно будет дополнительно подключать разработку для авторизации внешнего сервиса (это бы не повлекло дополнительные расходы для заказчика, так как авторизацию мы делали "за свои", но означало бы временную задержку), то с появлением Пинкитбилдер необходимость в подключении разработчика отпала.

Интеграция онлайн-кассы СБИС и Битрикс24 с автоматической отправкой чека клиенту из сделки Битрикс24 описана по ссылке.

В функционале конструктора Пинкитбилдер есть все необходимые инструменты, чтобы добавить нужный сервис в Пинкит. Требуется только сделать небольшие настройки (пользователь может сделать это сам или с помощью наших инженеров).

С помощью Пинкитбилдер можно сразу добавить нужные события и действия на шаге 1 и 3, чтобы настроить рабочую интеграцию в Пинкит. Интерфейс позволяет обойтись без написания кода — нужно только заполнить значения нужных полей из документации. Напомним, что для успешной настройки связки с необходимым сервисом, требуется наличие у этого сервиса API.

Рассмотрим подробнее настройку интеграции заказчика с использованием Пинкитбилдер.

2. Добавление авторизации сервиса, событий и действий через ПинкитБилдер

2.1. Авторизация

Чтобы добавить платформу, которая нужна для интеграции, заходим в раздел "Сервисы" в Пинкитбилдер:

Для добавления необходимо нажать кнопку "Добавить сервис":

Заполняем необходимые поля: название сервиса, статус (приватный или публичный), и другие настройки.

Если, к примеру, у сервиса изменится API, можно изменить настройки добавленного сервиса.

Затем необходимо добавить настройки доступа к сервису:

Тип доступа - это один из методов авторизации. Пинкитбилдер поддерживает следующие методы авторизации:

Basic-аутентификация
API-ключ в обмен на логин и пароль
Логин и пароль
IMAP
Анонимный
OAuth 2 + Basic-аутентификация
OAuth 1

Ключ или токен доступа можно взять из документации API сервиса, который вы хотите подключить.

Если у сервиса есть открытый API, добавить авторизацию данного сервиса в Пинкит можно быстро и без разработки. Для каждого нового кейса это существенная экономия как денег, так и времени.

2.2. Добавление события на шаге 1

Если вы хотите получить данные из внешней платформы на шаге 1, чтобы затем их обрабатывать и передавать дальше, вам нужно добавить на шаге 1 сервис-источник и событие (так называемый триггер, при срабатывании которого Пинкит будет забирать данные). Это может быть: создание сущности, ее обновление или заполнение какого-то поля.

Добавить событие, если вы не нашли нужного шага в списке, можно также через Пинкитбилдер.

Чтобы добавить событие, переходим в раздел "События" и заполняем поля: название, статус, тип события, URL запроса и так далее. Понадобится документация сервиса, если вы хотите настроить событие самостоятельно или с помощью наших инженеров.

2.3. Добавление действия на шаге 3

Действие на шаге 3 необходимо, чтобы передать данные, полученные на шаге 1, в сервис-приемник.

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

Все, что может отдать API, можно задействовать в данном случае. После добавления авторизации, событий и действий мы можем далее настроить полноценную интеграцию для выгрузки, например, товаров из Битрикс24 в Контур.Экстерн с последующей выгрузкой счетов из Битрикс24 в Контур.Экстерн с сопоставлением данных по контрагентам.

3. Итог

Резюмируем. Если у нужного сервиса есть API у вас есть задача на интеграцию данного сервиса, например, с вашей CRM, то добавить авторизацию нового сервиса теперь можно без дополнительной разработки и ожидания. Просто используем для добавления функционал Пинкитбилдер. Сделать это вы можете самостоятельно или с помощью наших инженеров.