Эскроу‑счета из двух банков в 1С по API с нуля: из чего состоит интеграция и где подстелить соломку

Значимый прорыв формирует отрасль ИИ: abelenya 8 минут назад Объяснить с Эскроу‑счета из двух банков в 1С по API с нуля: из чего состоит интеграция и где подстелить соломку Средний 8 мин 192 1С * Проектирование API * Финансы в IT Кейс Из песочницы У застройщика деньги дольщиков лежат не на его счёте, а на эскроу — и до ввода дома в эксплуатацию он видит их, но не распоряжается ими. Для финансиста это отдельная вселенная: нужно знать, сколько поступило по каждому договору долевого участия, что раскрыто, что ещё ждёт. А рядом — обычные расчётные счета, по которым идёт вся текущая жизнь компании.

До интеграции этой информации в 1С не было вообще. Дольщики получали информацию по своим счетам с задержкой до трёх дней. Задача звучала просто: пусть движение по эскроу и расчётным счетам появляется в 1С само.

Технические детали

Готового решения под эскроу‑часть не нашлось, поэтому интеграции со Сбербанк API и Альфа‑Банк API я писал с нуля. Банков два, и API у них разные — это приходится учитывать с первого дня. Ниже — не пересказ документации банка (её лучше читать в первоисточнике, она меняется), а то, из каких частей состоит такая интеграция на стороне 1С и какие решения я бы принял снова.

Из чего состоит интеграцияЕсли убрать детали, интеграция с банковским API на стороне 1С — это пять слоёв:Транспорт и авторизация. HTTPS‑запросы, получение и продление доступа к API. Тонкий слой: «получить список счетов», «получить операции за период», «получить сведения по эскроу‑счёту».

Ничего не знает про документы 1С. Хранилище сырых ответов. Всё, что пришло от банка, сохраняется как есть — до разбора.

Отраслевые последствия

Счёт банка → банковский счёт организации в 1С, контрагент по ИНН, операция по эскроу → договор долевого участия. Создание документов или записей регистров, идемпотентно. У Сбербанка и Альфа‑Банка различалось всё, что касается первых двух слоёв: авторизация, устройство API, форматы данных.

При таких различиях я бы держал транспорт и клиент API отдельными для каждого банка, а всё, что ниже, — общим: ответ любого банка приводится к одному внутреннему формату операции, и дальше сопоставление и отражение в учёте уже не знают, откуда пришли данные. Смешивать эти слои — главная ошибка, которую хочется сделать в начале, когда «надо просто скачать выписку». Через месяц окажется, что изменился формат ответа, и ремонт затрагивает всё сразу.

Аутентификация: токены живут своей жизньюБанковские API почти всегда используют короткоживущий access‑токен и более долгоживущий refresh‑токен. На стороне 1С из этого следуют простые, но обязательные вещи:токены хранятся в безопасном хранилище (ОбщегоНазначения.

Этот прогресс даёт важные сигналы о будущем отрасли, и технологический мир внимательно наблюдает.