API — это оговорённый способ, которым одна программа обращается к другой: набор адресов, по которым можно запросить данные или передать их, и правила, по которым составляется запрос и приходит ответ. Никакого человека в этой цепочке нет. Заявка с сайта попадает в CRM сама, потому что сайт умеет позвать CRM по этим правилам, а CRM умеет ответить.
Для владельца бизнеса это не техническая подробность, а множитель в смете. Одна и та же строка «интеграция с 1С» в двух предложениях может означать двадцать часов работы или сто тридцать — и разница объясняется не квалификацией исполнителя, а тем, есть ли у обеих систем нормальный программный доступ. Три вопроса, которые эту разницу вскрывают, разобраны ниже; задать их можно на первом созвоне, без программиста.
Все суммы дальше — модельные расчёты на сентябрь 2026 года при ставке инженера 3 000 ₽/час и сотрудника 700 ₽/час. Каталог типовых обменов и их цены — на странице интеграций; здесь разбираем сам термин и его влияние на бюджет.
Окно выдачи: кто спрашивает, кто отвечает и что бывает при отказе
Представьте окно выдачи в учреждении. Вы подаёте в него бланк установленной формы, за окном по бланку находят нужное и возвращают вам карточку. Вы не заходите внутрь, не ходите между стеллажами и не видите остальные дела. У окна есть часы работы, есть перечень бланков, которые оно принимает, и есть человек, который решает, что именно вам показать. Это и есть API: программа-заказчик подаёт запрос по форме, программа-хозяин отвечает по форме.
Набор адресов и правил, по которым одна программа обращается к другой без участия человека: запросить список заказов, создать сделку, изменить остаток. Бизнесу нужен, чтобы данные переходили между системами сами. В смете API — не отдельная строка, а условие, которое меняет стоимость всех остальных: наличие документированного доступа у обеих сторон экономит 30–60 часов работы. Проверочный вопрос: покажите документацию API обеих систем и назовите методы, которые будете вызывать.
Отказ — обычная часть работы окна, и именно к нему сводится половина стоимости интеграции. Ответ может не прийти вовсе, прийти с сообщением «нет прав на эту операцию», «превышено число запросов», «обязательное поле не заполнено» или «система на обслуживании». Каждый из этих случаев — отдельная ветка в коде обмена: что делать с заявкой, которая не доехала, кого уведомить и когда попробовать снова. В дешёвых предложениях этих веток нет, поэтому первый же сбой заканчивается тишиной: данные не пришли, а никто не заметил.
Один адрес API с одной функцией: «получить заказы за период», «создать контакт», «изменить статус». Права даются не на систему целиком, а на отдельные методы: чтение заказов может быть открыто, а создание документа — нет. В смете каждый метод — от одного до шести часов вместе с обработкой его отказов. Проверочный вопрос: перечислите методы, которые будете вызывать, и отметьте, какие из них меняют данные.
Отличие, на котором путаются чаще всего: API — это не доступ к базе данных. Прямой доступ означал бы, что вы видите все таблицы и пишете в них что угодно, минуя проверки самой программы. Через API видно ровно то, что владелец системы решил открыть. Это ограничение и одновременно защита: обмен через API не ломает учёт, а прямая запись в базу 1С в обход конфигурации ломает его регулярно и незаметно.
Горизонтальная схема из пяти блоков. Слева блок «Система-заказчик», от него стрелка «запрос по форме» к блоку «Проверка прав и лимитов», далее к блоку «Система-хозяин», обратная стрелка «ответ по форме» возвращается к заказчику. Вниз от блока проверки отходят четыре короткие ветки с подписями: «нет прав на операцию», «превышено число запросов», «обязательное поле не заполнено», «система недоступна». Все четыре ветки сходятся в один блок «Очередь и повторная попытка», от него пунктир вверх к запросу и стрелка вбок к блоку «Журнал и уведомление». Тонкие чертёжные линии, подписи по-русски.
Три вопроса, которые двигают цену интеграции в шесть раз
Цену обмена определяют не системы как таковые, а три их свойства. Ответы на эти вопросы получают у вендора или у своего администратора за один день, и они меняют смету сильнее, чем выбор подрядчика.
- 1Есть ли API вообще и в каком он состоянии
Различайте три ответа. «Есть документированное API» — работа идёт по описанию, риск минимален. «API есть, документации нет» — добавьте 15–30 часов на разведку: методы находят опытным путём. «API нет» — обмен строится через выгрузки файлов или через робота, работающего в интерфейсе за человека, и это другая по цене и хрупкости история.
- 2Что открыто на запись, а не только на чтение
Самая частая неприятность на середине проекта. Чтение обычно открыто щедро: заказы, контакты, остатки. Запись — избирательно: создать контакт можно, а провести документ или изменить цену в справочнике — нет, потому что за этим стоят проверки учёта. Требуйте разделить перечень методов на две колонки — читаем и меняем — до подписания. Один закрытый метод на запись превращает автоматический обмен в полуручной.
- 3Какие ограничения по числу запросов
У облачных систем есть лимиты частоты — обычно единицы запросов в секунду и потолок в сутки; точные значения смотрите в текущей документации, они меняются от тарифа к тарифу. Лимит важен не для повседневного обмена, а для первичной загрузки и для пиков. Пример: при ограничении в два запроса в секунду перенос 12 000 карточек по одной займёт 100 минут, а пакетными методами по 50 записей — около двух минут.
| Вопрос | Ответ, после которого дорожает | Ответ, после которого дешевеет | Разница в работе |
|---|---|---|---|
| Есть ли API | «Сделаем через выгрузку в Excel» или «поставим робота в интерфейс» | «Вот ссылка на документацию, вот перечень методов» | +40–90 часов |
| Что открыто на запись | «Разберёмся в процессе» или «наверняка всё есть» | Список методов, разделённый на чтение и запись | +15–35 часов |
| Есть ли лимиты и пакетные методы | «Про лимиты не спрашивали» | Названы предел частоты и наличие пакетной загрузки | +8–20 часов и риск срыва первичной загрузки |
| Есть ли тестовый контур | «Проверим на боевой базе, аккуратно» | Есть отдельная копия системы для проверок | +10–25 часов и риск испорченных данных |
Почему одна и та же строка стоит 60 000 ₽ или 390 000 ₽
Возьмём один и тот же обмен: заявки с сайта уходят в CRM, оттуда — в учётную систему. В первом варианте у обеих систем есть документированное API. Во втором у второй системы программного доступа нет: данные забираются из выгрузок, а запись делает робот, который заполняет формы в интерфейсе вместо человека. Формулировка в коммерческом предложении в обоих случаях одинаковая — «интеграция с учётной системой».
| Работа | С документированным API | Без API, через файлы и интерфейс |
|---|---|---|
| Получение доступа | 4 ч: токен, права, тестовый контур | 24 ч: вход в систему, обход двухфакторной проверки, устойчивость к перезапускам |
| Чтение данных | 3 ч: вызов метода, разбор ответа | 18 ч: разбор выгрузок и печатных форм, отслеживание изменений формата |
| Запись данных | 5 ч: вызов метода, проверка результата | 34 ч: заполнение экранных форм, проверка, что запись действительно создалась |
| Ошибки и повторные попытки | 4 ч: система прямо сообщает об отказе | 26 ч: интерфейс об отказе не сообщает, отказ распознают по косвенным признакам |
| Мониторинг и сопровождение первого года | 4 ч на настройку наблюдения | 28 ч: любое обновление интерфейса ломает робота |
| Итого | 20 часов — 60 000 ₽ | 130 часов — 390 000 ₽ |
Разница — 330 000 ₽, то есть в шесть с половиной раз, на одном и том же по названию пункте. И это не вся цена: во втором варианте расходы не заканчиваются вместе с проектом. Робот в чужом интерфейсе ломается при каждом изменении экранов, и на починку уходит 4–12 часов несколько раз в год. Когда подрядчик называет подозрительно маленькую сумму, вопрос не в щедрости, а в том, какой из двух столбцов он имел в виду.
Две вертикальные колонки-карточки рядом. Левая подписана «С документированным API — 20 часов, 60 000 ₽», правая — «Без API — 130 часов, 390 000 ₽». Внутри каждой колонки пять горизонтальных полос разной длины с подписями работ и часами: доступ 4 ч / 24 ч, чтение 3 ч / 18 ч, запись 5 ч / 34 ч, ошибки 4 ч / 26 ч, сопровождение 4 ч / 28 ч. Длина полос пропорциональна часам, у правой колонки полосы заметно длиннее. Внизу общая подпись: «В коммерческом предложении обе колонки называются одинаково».
Что на самом деле входит в строку «интеграция по API»
Строка в смете выглядит как одна работа, а внутри их пять. Порядок здесь не случайный: каждая следующая нужна для того, чтобы предыдущая продолжала работать через полгода без вашего участия.
- 1Авторизация и доступы
Получение ключа, настройка прав по принципу «только то, что нужно», хранение ключа так, чтобы он не лежал в переписке, и порядок его замены. Отдельно — тестовый контур, чтобы проверки не шли на боевых данных.
- 2Сопоставление полей и справочников
Таблица соответствий: что во что превращается. «Клиент» в CRM и «Контрагент» в учётной системе — разные сущности с разным набором обязательных полей. Сюда же попадают номенклатура, единицы измерения, статусы и правило для случая, когда обязательное поле пустое.
- 3Обработка ошибок
Что делать с записью, которую вторая система не приняла: отложить, отправить в ручной разбор, уведомить ответственного. Без этого блока отказ выглядит как отсутствие данных, и его замечают через неделю по жалобе клиента.
- 4Повторные попытки и защита от дублей
Связь рвётся регулярно, поэтому повторы неизбежны. Нужны очередь, интервал между попытками и ключ операции, по которому вторая отправка той же записи не создаёт второй заказ. Это самая часто пропускаемая строка в дешёвых предложениях.
- 5Мониторинг обмена
Журнал переданного, отчёт о расхождениях и уведомление ответственному, когда обмен встал. Правило простое: если о поломке обмена вы узнаёте от клиента, мониторинга нет.
Смотреть на эту смету надо не построчно, а по смыслу. На собственно передачу данных — доступы и сопоставление полей — приходится 48 000 ₽. Оставшийся 81 000 ₽ уходит на то, что происходит, когда обмен ломается. Именно этой второй половины нет в предложениях за 40 000 ₽: там покупается связь, которая работает ровно до первого сбоя, а дальше данные тихо теряются, и расплачивается за это бухгалтерия при сверке. Как та же логика выглядит на конкретной паре систем, разобрано отдельно.
Горизонтальная столбиковая диаграмма из шести строк, длина пропорциональна сумме. Строки сверху вниз с подписями: «Доступы и авторизация — 12 000 ₽», «Сопоставление полей и справочников — 36 000 ₽», «Обработка ошибок — 24 000 ₽», «Повторные попытки и защита от дублей — 24 000 ₽», «Журнал и уведомление о сбое — 18 000 ₽», «Приёмка и запуск — 15 000 ₽». Первые две строки объединены скобкой слева с подписью «передача данных — 48 000 ₽», остальные четыре — скобкой с подписью «работа со сбоями — 81 000 ₽». Внизу итог: «43 часа, 129 000 ₽».
API, выгрузка файлом и человек с ноутбуком
Обмен по API — не единственный способ передать данные, и не всегда лучший. Осмысленно сравнивать три варианта сразу, потому что в реальных проектах они соседствуют: часть потоков идёт автоматически, часть — файлом раз в сутки, часть остаётся ручной сознательно.
| Признак | Ручной перенос | Выгрузка файлом по расписанию | Обмен по API |
|---|---|---|---|
| Задержка данных | От часа до суток, зависит от загрузки сотрудника | Равна периоду выгрузки: обычно сутки | Секунды или минуты |
| Ошибки | 2–4 % записей с опечаткой или пропуском — обычная величина при ручном вводе | Ошибки формата всплывают пачкой в момент загрузки | Отказ виден сразу и попадает в журнал |
| Что при сбое | Сотрудник заметит и повторит | Файл не сформировался — узнают на следующий день | Очередь и повторная попытка, уведомление ответственному |
| Стоимость запуска | 0 ₽ | 24 000–48 000 ₽ | 60 000–390 000 ₽ в зависимости от доступа |
| Стоимость владения | 35 ₽ за операцию при ставке 700 ₽/час | Разбор ошибок формата, 1–3 часа в месяц | 4 000–8 000 ₽/мес наблюдения и мелких правок |
| Когда разумно | До 20 операций в рабочий день | Отчётность, сверки, данные, которые нужны раз в сутки | Всё, где задержка стоит денег: заявки, оплаты, остатки |
Вещь, которую подрядчики обходят молчанием: обмен файлом — нормальное инженерное решение, а не признак халтуры. Он плох, когда его выдают за автоматический обмен, и хорош, когда выбран осознанно для потока, где сутки задержки никого не беспокоят. Ошибка не в файле, а в подмене понятий.
Российская практика на сентябрь 2026: у кого API есть и что в нём открыто
Хорошая новость: у большинства систем, на которых работает российский средний бизнес, программный доступ есть. Плохая — объём прав зависит не только от системы, но и от вашего тарифа, редакции и того, кто владеет доработками.
| Система | Что обычно доступно | Что выяснить до подписания |
|---|---|---|
| 1С (УНФ, УТ, Бухгалтерия, ERP) | HTTP-сервисы и OData в типовых конфигурациях; в доработанных — то, что настроил ваш подрядчик | Кто владеет конфигурацией, есть ли доступ к публикации сервисов, что будет при типовом обновлении |
| Битрикс24 | REST-методы, входящие и исходящие вебхуки, локальные приложения | Ограничения частоты на вашем тарифе и то, какие методы доступны в облаке, а какие только в коробке |
| amoCRM | REST-методы и уведомления о событиях | Что из нужного вам входит в тариф, а что требует платной интеграции |
| МойСклад, RetailCRM | Открытые интерфейсы для товаров, заказов, документов | Пределы выборки и наличие пакетных методов для первичной загрузки |
| Отраслевые системы (например, YCLIENTS в сфере услуг) | Программный доступ есть, но оформляется отдельной заявкой или партнёрским договором | Сроки получения доступа и его стоимость — это может занять недели |
| Самописные и устаревшие системы | Часто API нет вовсе; обмен строится через базу, файлы или робота в интерфейсе | Есть ли живой разработчик системы и сохранились ли исходники |
У части отраслевых и облачных систем программный доступ входит не во все тарифы, а иногда продаётся отдельным модулем. Отдельная история — системы, поддержка которых заканчивается: с 1 сентября 2026 года Контур.Диадок прекращает поддержку модуля для 1С:Предприятие 7.7, и строить новый обмен на такой связке бессмысленно. Оба вопроса стоят один звонок вендору и снимают самый дорогой класс сюрпризов — тот, который обнаруживается на третьей неделе проекта.
Карта связей из четырёх узлов. Слева узел «Сайт», в центре «CRM», справа «Учётная система», снизу отдельно «Склад». Стрелки с подписями: сайт → CRM «заявка: 10 полей, событие», CRM → учётная система «контрагент и документ: 18 полей», учётная система → CRM «остатки и оплаты, каждые 15 минут», склад → учётная система «отгрузка». Общая подпись у связки: «28 полей в обмене». На стрелке от CRM к учётной системе стоит замок с подписью «запись открыта не для всех документов», на стрелке от склада — знак вопроса с подписью «API уточняется». Тонкие чертёжные линии, подписи по-русски.
Формулировки-прикрытия и пять вопросов, которые их раскрывают
Слово API в коммерческом предложении часто работает не как характеристика, а как способ не называть объём работ. Это не всегда злой умысел: подрядчик и сам не знает объёма, пока не посмотрел системы, — но риск при этом молча переезжает на вас. Ниже шесть формулировок и способ раскрыть каждую за один вопрос. Более широкий список маркеров неопределённости — в словаре раздела.
| Формулировка в предложении | Что за ней обычно стоит | Как раскрыть до подписания |
|---|---|---|
| «Интеграция по API» | Уровень обмена не назван: это может быть и выгрузка раз в сутки, и двусторонняя синхронизация | В какую сторону идут данные, по какому событию и с какой задержкой? Ответ должен умещаться в три строки |
| «API есть, всё получится» | Есть на чтение, а вам нужна запись; выясняется на третьей неделе | Дайте перечень методов двумя колонками: читаем и меняем |
| «Настроим обмен» | Будет включён типовой обмен площадки; ваши доработанные поля через него не проходят | Какие наши поля типовой обмен не переносит и что мы будем с ними делать? |
| «Доработка по факту» | Часы не оценены, риск перерасхода целиком на заказчике | Зафиксируйте вилку часов и порядок утверждения работ сверх неё письменно |
| «Настройка под ваши процессы» | Объём не определён, потому что процесс не описан | Приложите перечень полей, статусов и правил — он же станет основанием приёмки |
| «Интеграция под ключ» | Нет раздела «что не входит», поэтому спор о готовности будет решаться голосом | Потребуйте раздел «не входит» — он защищает обе стороны сильнее, чем список работ |
- 1Где документация API обеих систем и какие методы вы будете вызывать? Отказ показать документацию до подписания — достаточное основание не подписывать.
- 2Сколько запросов в минуту разрешено и есть ли пакетные методы? Без этого ответа нельзя оценить первичную загрузку и поведение обмена в пик.
- 3Что происходит, когда вторая система недоступна? Правильный ответ содержит слова «очередь», «повторная попытка» и «уведомление», а не «такого не бывает».
- 4Кто платит за доступ, если он платный, и на чьё имя оформляется ключ? Ключ должен принадлежать вам, иначе смена подрядчика останавливает обмен.
- 5Что будет при обновлении смежной системы и кто чинит обмен в этом случае? Ответ должен быть в договоре, а не в устной договорённости; что именно писать в договоре, разобрано отдельно.
Не сравнивайте предложения по строке «интеграция по API» — сравнивайте по четырём ответам: в какую сторону, по какому событию, что при сбое, что при дублях. Разница в этих ответах объясняет почти весь разрыв между дешёвым и дорогим предложением, и почти всегда дешёвое означает одностороннюю передачу раз в сутки без обработки отказов.
Когда API вам не нужен
Наличие программного доступа — не повод им пользоваться. Есть три ситуации, в которых обмен по API проигрывает более простым решениям, и определяются они арифметикой до начала работ.
- Малый поток. Ручной перенос одной записи занимает около трёх минут — это 35 ₽ при ставке 700 ₽/час. Обмен стоит 6 000 ₽/мес наблюдения плюс разнесённое на три года внедрение: при смете в 306 000 ₽ это ещё 8 500 ₽/мес, итого 14 500 ₽. Порог — примерно 414 операций в месяц, то есть около 21 операции в рабочий день. Ниже этого числа сотрудник с ноутбуком дешевле, и честный подрядчик скажет это до сметы.
- Разовый перенос. Если данные нужно передать один раз — при переезде на новую систему, — это не интеграция, а миграция: другая задача, другая процедура приёмки и другая цена. Строить постоянный обмен ради одной загрузки не нужно.
- Система, которую вы меняете в ближайший год. Обмен живёт вместе с обеими системами. Если одну из них планово заменяют, разумнее дождаться замены и построить обмен один раз, чем делать его дважды.
Есть и четвёртый случай: данных, которыми стоит обмениваться, просто нет. Если в CRM карточки заполнены наполовину, а номенклатуру ведут три человека по трём разным правилам, автоматический обмен разнесёт беспорядок по всем системам быстрее, чем это делал человек. Порядок в данных — работа заказчика, её нельзя купить вместе с интеграцией.
API — это не строка в смете, а условие, которое меняет цену всех остальных строк. Три вопроса о нём стоят один рабочий день и до трёхсот тысяч рублей разницы.
