# Модульбанк Держите остатки и операции Модульбанка под контролем в чате Банковский API — счета, баланс, история операций, платёжные поручения ## Как агент работает с Модульбанк Работа начинается со справки о компаниях и счетах: агент запрашивает account-info, получает список юрлиц и расчётных счетов, доступных токену, и уже от него идёт в историю операций. Дальше он считает остатки на дату, движения за день или месяц, раскладывает списания по контрагентам и категориям и сопоставляет поступления со сделками CRM, чтобы показать выигранные сделки, за которые деньги так и не пришли. Историю операций Модульбанк отдаёт постранично и по датам, а не одним куском, поэтому месяц агент собирает частями и держит порядок по дате проводки. Валютные и рублёвые счета он считает раздельно, не складывая суммы в одну цифру, а приход и расход различает по направлению платежа, а не по знаку суммы в выписке. На запись агент доходит только до черновика: платёжное поручение он собирает, проверяет реквизиты, сумму и назначение и показывает вам, но подпись и отправка остаются в интернет-банке Модульбанка. Это не ограничение коннектора, а устройство банка — деньги уходят только после вашего подтверждения на его стороне. Всё остальное, от ежедневной сводки до месячного разбора расходов, агент делает на чтение. Частоту запросов агент выдерживает сам и длинную выписку растягивает во времени вместо параллельных вызовов. Уже показанный период он перечитывает при следующем заходе, потому что банк дописывает проводки задним числом и вчерашний остаток к утру меняется. Если за период операций нет или токену не хватает доступа, агент скажет об этом прямо, а не покажет пустую таблицу. ## Сценарии интеграции ### Ежедневный отчёт по счетам Агент проверит балансы и операции по счетам Модульбанка и пришлёт сводку с ключевыми движениями за день. ### Сверка оплат с CRM Агент сопоставит поступления в банке со сделками в CRM и покажет выигранные сделки без оплаты. ### Разбор расходов по категориям Агент разложит списания за месяц по категориям и контрагентам и покажет, куда утекают деньги. ### Платёжка на подпись Агент соберёт платёжное поручение, проверит реквизиты, сумму и назначение и покажет черновик — подпись и отправка остаются в интернет-банке Модульбанка. ### Все юрлица одним отчётом Агент возьмёт из справки все компании и счета, доступные токену, и сведёт остатки в один отчёт, считая валютные и рублёвые счета раздельно. ### Что дописалось задним числом Агент перечитает уже показанный период и найдёт проводки, которые банк добавил задним числом, — вместе с тем, как из-за них изменился остаток. ## Как подключить **Перед подключением** - Учётная запись с доступом к нужным компаниям и счетам - Подключение к API бесплатно на всех тарифах, заявка не нужна - Подпись и отправка платежей остаются в банке — агент только читает ### Войдите под учётной записью со счетами Токен привязан к учётной записи, под которой сгенерирован, и видит только её компании и счета — чужие в списке не появятся. ### В меню «+» выберите «Интеграция с банком» Короткий путь из кабинета банка к экрану генерации токена: меню «+» → «Интеграция с банком» → сгенерируйте токен. ### Либо «Настройки» → «Услуги» → «API Банка» Тот же экран длинным путём: «Настройки» → «Услуги» → «API Банка» → «Генерация токена авторизации». Туда же ведёт пункт «Подключиться к API» в меню действий. ### Подтвердите доступ к счетам и операциям На экране генерации отметьте account-info и operation-history: первый отдаёт компании и счета, второй — историю операций. ### Скопируйте токен и сохраните отдельно Токен выдаётся на 3 года, по истечении срока аннулируется автоматически, отозвать раньше можно по API. Он равен доступу в кабинет. ## Частые вопросы ### Как подключить Модульбанк? API-токеном из интернет-банка Модульбанка. Токен вводится один раз при подключении и хранится в зашифрованном виде. ### Что агент может делать со счетами? Читать счета, балансы и историю операций, готовить черновики платёжных поручений. Подпись и отправка платежей остаются в банке. ### Подходит ли для нескольких счетов? Да, агент видит все счета, доступные токену, и умеет сводить их в один отчёт. [Открыть Модульбанк](https://my.modulbank.ru)