Интеграция API: ERP, CRM и интернет-магазин
Интеграция API связывает интернет-магазин, ERP, CRM, платежи, курьерские службы и бухгалтерские системы, чтобы вам не приходилось вводить одни и те же данные вручную. При использовании API одна система отправляет запрос, а при использовании webhook другая отправляет уведомление о произошедшем событии. Надёжная интеграция начинается с одного конкретного процесса и чётких правил, определяющих, какая система является ведущей для каждого типа данных.

В чём разница между API и webhook?
API, это согласованный способ, с помощью которого одна система запрашивает или отправляет информацию другой системе. Интернет-магазин может запросить данные об остатках, отправить заказ в ERP или проверить статус отправления. Система, которой нужны данные, начинает взаимодействие.
Webhook работает в обратном направлении. Когда происходит событие, система отправляет уведомление на заранее заданный адрес. Например, платёжный оператор может уведомить вашу систему об успешной оплате, после чего она изменит статус заказа и запустит следующий шаг.
| Механизм | Кто начинает взаимодействие? | Подходящий пример | Что необходимо предусмотреть |
|---|---|---|---|
| API | Ваша система отправляет запрос | Проверка наличия или отправка заказа | Аутентификация, ограничения количества запросов и обработка ответов |
| Webhook | Система, в которой произошло событие | Новый платёж, заказ или изменение статуса | Проверка подписи, повторная отправка и защита от дублирования |
Какие процессы стоит подключить в первую очередь?
Не начинайте с желания подключить всё сразу. Выберите процесс, который часто повторяется, замедляет работу команды или приводит к дорогостоящим ошибкам. Обычно это обработка заказа, контакт с клиентом, складские остатки или платёж.
Интернет-магазин, склад и ERP
При оформлении нового заказа магазин отправляет в ERP данные о товарах, количествах, клиенте и способе оплаты. ERP возвращает данные об остатках и статус, а при изменении складских остатков магазин получает обновлённые количества. Так снижается риск продать товар, который уже закончился.
До начала разработки определите, какая система является ведущей для цены, остатка, товара и клиента. Если и магазин, и ERP могут изменять одно и то же значение без установленного правила, интеграция лишь быстрее перенесёт конфликт из одной системы в другую.
Сайт, CRM и отдел продаж
Форма заявки на сайте может создать лид в CRM с указанием источника, услуги, телефона и сообщения. Затем система может поставить задачу менеджеру, отправить подтверждение или направить срочную заявку конкретному сотруднику.
Самая частая проблема здесь не в отсутствии API, а в неясном определении лида. Нужно понимать, когда создаётся новый контакт, что происходит при повторной заявке и кому назначается задача. Иначе вы получите дубли клиентов и неравномерное распределение заявок. Если процесс в CRM имеет особую специфику, CRM-система на заказ позволяет заложить эти правила в саму систему.
Платежи, выставление счетов и уведомления
Успешный платёж может изменить статус заказа на «оплачен», отправить данные в ERP и запустить создание счёта. Важно, чтобы счёт не создавался повторно, если платёжный оператор отправит одно и то же уведомление несколько раз.
Сайт, CRM и телефония
При входящем звонке телефонная система может передать номер в CRM, чтобы открыть карточку клиента. После разговора сохраняются результат, задача или заметка. Это особенно полезно, когда отделы продаж и поддержки работают с большим количеством входящих заявок.
Как выглядит интеграция в реальной бизнес-системе?
В LiftexPro, ERP для лифтовых компаний различные операции являются частью единого процесса: планирование осмотров, управление зданиями, работа техников и автоматическое выставление счетов. Такая система показывает, почему интеграция, это не просто перенос полей между двумя программами. Нужно понимать, что происходит после каждого статуса и кто имеет право его изменить.
Например, для выездных команд недостаточно просто зафиксировать визит. Результат должен попасть на нужный объект, создать или изменить задачу, участвовать в выставлении счета и оставаться видимым в истории клиента. Именно эти зависимости определяют архитектуру и тесты.
Какие есть варианты подключения систем?
Выбор зависит от количества систем, документации, сценариев и цены ошибки. Инструмент без кода удобен для простого обмена данными. Готовый коннектор, разумный выбор, если он поддерживает именно ваш процесс. Кастомная интеграция больше подходит, если у вас есть ERP, несколько каналов или особые правила.
| Вариант | Когда подходит | Что может пойти не так | Цена |
|---|---|---|---|
| Make или Zapier | Одно или два простых действия между популярными приложениями | Ограниченная логика, лимиты операций и зависимость от внешнего сервиса | указывается в предложении |
| Готовый коннектор или плагин | Системы популярны, и для них есть поддерживаемый сценарий | Несовпадение полей, отсутствие важных исключений и зависимость от версии плагина | указывается в предложении |
| Кастомная API-интеграция | У вас есть особые правила, ERP, склад или несколько каналов | Больше первоначальной работы и необходимость в поддержке | указывается в предложении |
| Интеграционный слой | Много систем, большой объём данных или критически важные операции | Необходимость в архитектуре, мониторинге и ответственном за процесс | указывается в предложении |
Низкая цена готового коннектора не означает, что работа завершена. Проверьте поля, налоговые правила, дублирование, округление, отклонённые платежи и возвраты. При кастомной интеграции бюджет в основном зависит от количества сценариев и исключений, а не только от количества систем.
Если основная проблема связана с магазином и его операциями, интеграции с платёжными системами, курьерскими службами и внутренними системами нужно планировать уже на этапе создания интернет-магазина. Если магазин уже работает, интеграция строится с учётом его реальных возможностей и ограничений API.
Как проходит надёжная API-интеграция?
- 01Описание процесса
Запишите, что происходит сегодня от начала до конца. Кто вводит заказ, где проверяется наличие, когда выставляется счёт и кто узнаёт о проблеме? Так становятся видны ручные действия и места, где теряется информация.
- 02Проверка систем и документации
Проверьте, есть ли у каждой системы API или webhook, как подтверждается доступ, есть ли тестовая среда и каковы ограничения. Запросите у внешнего поставщика документацию, примеры запросов и правила внесения изменений в интерфейс.
- 03Определение данных и зон ответственности
Сопоставьте поля: номер заказа, SKU, количество, цена, НДС, клиент, адрес и статус. Определите, какая система может изменять каждое значение и что происходит при расхождении.
- 04Создание небольшого первого сценария
Начните с одного потока, например передачи нового заказа в ERP или нового лида в CRM. Не подключайте сразу все уведомления, отчёты и исключения. Небольшой первый сценарий покажет, верна ли логика.
- 05Тестирование пограничных случаев
Протестируйте отклонённый платёж, отсутствие товара, ошибочный номер телефона, возвращённый заказ, удалённый товар, разрыв соединения и повторный webhook. Эти случаи показывают, готова ли интеграция к работе, а не только работает ли она в демонстрации.
- 06Мониторинг и передача команде
Обеспечьте журнал запросов, уведомление об ошибке и возможность повторной обработки. Команда должна видеть, какой заказ заблокирован, почему он заблокирован и как исправить ситуацию без вмешательства в базу данных.
Что чаще всего идёт не так?
Один запрос выполняется дважды
Webhook может быть отправлен повторно, если получатель не подтвердит его вовремя. Каждое событие должно иметь уникальный идентификатор, а система, проверять, обработано ли оно ранее. Это особенно важно для платежей, счетов и отправки посылок.
Одна из систем недоступна
Если ERP не отвечает, заказ не должен исчезнуть. Его нужно поставить в очередь, выполнить контролируемые повторные попытки и отправить уведомление сотруднику, если проблема сохраняется.
Данные имеют разную структуру
Одна система может использовать отдельные поля для имени и фамилии, а другая, одно поле для имени. SKU, единицы измерения, ставки НДС, часовые пояса и адреса также часто различаются. Эти преобразования должны быть частью интеграции, а не оставляться сотрудникам.
Доступ слишком широкий
Ключи API и пароли нельзя хранить в коде или отправлять по электронной почте. Используйте зашифрованное соединение, отдельные доступы для тестовой и рабочей среды, минимальные права и процедуру замены ключей. При работе с персональными данными также проверьте сроки хранения и доступы сотрудников.
Как понять, успешна ли интеграция?
Определите критерии до начала разработки. Все новые заказы должны поступать в ERP, у каждого лида должен быть ответственный, каждая ошибка должна быть видна сотруднику, а ни один платеж не должен создавать два счета.
Не измеряйте только то, «поступили» ли данные. Проверьте, завершается ли процесс правильно, может ли команда отреагировать на проблему и выполняется ли повторная обработка без ручного редактирования базы данных. Чтобы понять, как могут выглядеть связанные объекты, роли и операции, ознакомьтесь с демо ERP системой.
Когда выбрать готовый инструмент, а когда индивидуальную разработку?
Make или Zapier удобны для отправки уведомления, создания задачи или передачи простой формы. Это хороший способ проверить идею и автоматизировать небольшой процесс. Однако при большом объёме нужно учитывать лимиты операций, ежемесячную зависимость и способ восстановления после ошибки.
Готовый плагин подходит, когда магазин и бухгалтерская или курьерская система поддерживают именно нужный сценарий. Если у вас особые цены для компаний, несколько складов, сложные возвраты или разные правила оформления заказов, плагин может оказаться слишком ограниченным.
Индивидуальная интеграция имеет смысл, когда ошибка означает упущенную продажу, неверные остатки или проблему со счётом. Она позволяет реализовать собственную логику, контролировать данные и лучше восстанавливаться при недоступности системы. Самое важное, наличие документации и человека, ответственного за процесс после запуска.
Часто задаваемые вопросы
- В чём разница между API и webhook?
- При использовании API ваша система отправляет запрос, чтобы получить или передать данные. При использовании webhook другая система автоматически уведомляет вас, когда происходит событие, например новый заказ или успешный платёж.
- Можно ли интегрировать старую ERP без API?
- Иногда да, с помощью импорта и экспорта CSV, доступа к базе данных, готового коннектора или промежуточного модуля. Это более ограниченный вариант по сравнению с API и требует особого внимания к дублированию, безопасности и графику обмена данными.
- Сколько времени занимает интеграция API?
- Простой сценарий между хорошо документированными системами можно реализовать в рамках короткого проекта. Срок увеличивается при наличии нескольких систем, отсутствующей документации, специфических правил, миграции старых данных и необходимости вести журнал или выполнять повторную обработку.
- Кто поддерживает интеграцию после запуска?
- С вашей стороны должен быть конкретный ответственный, а со стороны разработчика или поставщика, техническая поддержка. Внешняя система может изменить версию API, поле или способ аутентификации, поэтому мониторинг и уведомления являются частью поддержки.






































