HelomiWIKI

Monobank для бізнесу (ТОВ, ФОП)

Інтеграція «Monobank для бізнесу» дає платити з рахунку компанії чи ФОП прямо з CRM: ви готуєте платіж постачальнику, перевізнику чи партнеру, CRM надсилає його в банк чернеткою, а директор підписує в застосунку monobank. Після підпису платіж сам стає витратою у «Фінансах» з підставою — оплатою партії чи виплатою партнеру; без підпису людини в банку гроші не йдуть ніколи. Це бізнес-API monobank (кабінет компанії або ФОП у web.monobank.ua), окремий від особистого API, яким CRM читає виписку (стаття «Monobank»): для одного рахунку ФОП у вас може бути дві картки — «Monobank» (виписка) і «Monobank для бізнесу» (платежі). Гаманець без такого ключа (особиста картка, готівка) теж платить з CRM — у режимі «до сплати» (стаття «Фінанси», §7д).

9 хвОновлено 20.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Вкладка ФінансиПлатежі«Фінанси → Платежі»: усі платежі зі станом «Чернетка», «Чекає підпису», «До сплати», «Проведено», «Відхилено», «Помилка».
  • Рахунок ТОВ і рахунок ФОП — однаково (ключ з кабінету ФОП); гаманець без ключа — платіж «до сплати».
  • Платіж з будь-якого місця: довільний, оплата партії закупівлі (сума «ще винні» й отримувач з картки), виплата партнеру.
  • Перевірки до банку: IBAN (UA і 27 цифр), ЄДРПОУ (8 цифр) чи РНОКПП (10 цифр), сума, призначення.
  • Підписаний платіж — витрата у «Фінансах» сама: з гаманцем акаунта, підставою, контрагентом; партія — «сплачено», виплата — «виплачено».
  • Повтор безпечний: повторне надсилання не створює в банку другу чернетку; виписка дубля не дає.
  • Кілька акаунтів (кілька компаній чи токенів), у журналі подій — хто що надіслав, IBAN лише хвостом «…1234».

1Налаштування

Підключає адміністратор. Дорога: «Інтеграції» (головне меню) → «Оплати» → картка «Monobank для бізнесу (ТОВ)».

  1. Токен: увійдіть у web.monobank.ua у кабінет компанії (ТОВ) або ФОП з правами директора / власника → «Мої токени» (web.monobank.ua/?modal=tokens) → створіть токен. Для ФОП це той самий бізнес-API: ключ береться в кабінеті ФОП, а не в особистому застосунку; якщо пункту «Мої токени» в кабінеті ФОП нема — замовте доступ до бізнес-API у підтримці monobank для бізнесу. Поле ключа в картці підписано «Токен бізнес-API (кабінет ТОВ або ФОП)», підказка під ним — та сама дорога.
  2. Вкладка «Підключення» → «Токен» → «Ввести» → вставте → «Зберегти ключ» → «Перевірити» (успіх — «рахунків: N»). Один кабінет — один акаунт картки: основна картка — ваш ФОП (чи ТОВ), другий кабінет — «+» → «Додати акаунт».
  3. Увімкніть перемикач «Інтеграція»: вимкнений акаунт не приймає нових платежів і не надсилає їх у банк.
  4. Ще одна компанія чи токен — «+» у правому нижньому куті картки → «Назва», токен → «Додати акаунт».

Гаманець платежів за замовчуванням — «Monobank бізнес» (створиться сам); інший обирається в шторці платежу. Якщо рахунок ФОП у CRM уже є гаманцем «Монобанк ФОП» (виписка через особистий API) — у шторці платежу оберіть цей гаманець і в «Акаунт» — акаунт бізнес-API: CRM запам'ятає пару і далі платитиме з нього через банк без запитань. IBAN і ЄДРПОУ постачальника чи перевізника можна вписати заздалегідь: «Закупівлі» → «Довідники» → постачальник / перевізник → «IBAN», «ЄДРПОУ / РНОКПП».

2Платіж з CRM

  1. «Фінанси» → «Платежі» → «Новий платіж банку». Відкривається шторка платежу.
  2. «Гаманець» (підписано «через банк» або «до сплати») → «Акаунт» → «Рахунок-відправник» (лише гривневі рахунки; порожньо — перший гривневий) → «Отримувач» (почніть писати — з'являться підказки: ваші юрособи, постачальники й перевізники з IBAN, попередні отримувачі) → «IBAN», «ЄДРПОУ / РНОКПП» → «Сума, ₴» → «Призначення». Гаманець «до сплати» (картка, готівка) — без рахунку-відправника, зате зі строком і категорією: платіж стане плановою в «Планових», а закриє його кнопка «Оплачено» або рядок виписки (стаття «Фінанси», §7д).
  3. «Надіслати в банк» — платіж іде в банк і стає «Чекає підпису»; «Зберегти чернетку» — лише в CRM (банк її не бачить).
  4. Директор відкриває застосунок monobank (чи web-кабінет) і підписує або відхиляє чернетку.
  5. CRM дізнається про це сама: кнопка «Перевірити» в рядку, «Перевірити все» над списком або крок ШІ Марії Йосипівни (з кожним її кроком — типово раз на 30 хвилин — лише коли є платежі «Чекає підпису»). Підписано й з'явилося у виписці — «Проведено» і витрата у «Фінансах»; відхилено — «Відхилено».

Фільтр над списком — «Усі», «Чекає підпису», «До сплати», «Проведено», «Відхилено», «Чернетки». У рядку — «Перевірити», «Надіслати в банк» (для чернетки й помилки), «Оплачено» (для «До сплати»), «Прибрати» (чернетка, помилка чи «до сплати»; чернетку, вже надіслану в банк, приберіть ще й у застосунку банку). Платіж «Чекає підпису» понад тиждень стає «Помилка» з текстом «не підписано за тиждень». Банк не прийняв платіж під час надсилання — платіж лишається зі станом «Помилка» і текстом банку; «Надіслати в банк» ще раз безпечно. Платіж лише в гривні. Платіж без підстави й без категорії стає витратою у «Вхідних» — розберіть його там.

3Оплата партії закупівлі

«Закупівлі» → партія → «Оплати партії» → «Оплатити через Monobank» (біля «+ Оплата», поки частина не сплачена). Шторка заповнюється сама: сума «ще винні» частини, призначення «Оплата за товар, партія №…» (доставка — «Оплата доставки…»), отримувач з картки постачальника чи перевізника. Після «Проведено» оплата з'являється в оплатах партії зі «звірено», борг падає. IBAN і ЄДРПОУ, вписані в шторці, після першого проведеного платежу запам'ятовуються в картці постачальника чи перевізника, якщо там було порожньо.

4Виплата партнеру

«Фінанси» → «Партнери» → «Виплати» → затверджена виплата → «Оплатити через Monobank». Сума й призначення («Виплата партнеру №…») — з виплати, отримувач — партнер; IBAN і ЄДРПОУ / РНОКПП партнера впишіть у шторці (у картці партнера IBAN поки не зберігається, шторка підкаже «вкажіть IBAN партнера»). Після «Проведено» виплата стає виплаченою з операцією «Виплата партнеру»; кнопкою «Виплатити» другий раз її проводити не треба.

5Виписка рахунку ТОВ

Виписка рахунку компанії заводиться тим самим шляхом, що Monobank ФОП: правила імпорту → звірка з уже внесеним → «Вхідні». Операція платежу, проведеного кнопкою «Перевірити», другим рядком не з'являється (той самий id банку); і навпаки — якщо виписку імпортували раніше за перевірку, перевірка бере вже наявний рядок. Кнопки в «Імпорті виписки» для ТОВ поки нема: імпорт — маршрутом POST /api/crm/finance/import/monobiz або дорученням ШІ (monobiz_import); за раз — до 500 рядків. 10).

Можливі помилки

Що ви бачитеЧомуЩо зробити
«IBAN отримувача: потрібно UA і 27 цифр…»IBAN з помилкоюперевірте IBAN у рахунку отримувача
«ЄДРПОУ / РНОКПП отримувача: 8 цифр (юрособа) або 10 цифр (ФОП, фізособа)»код неповнийвпишіть код повністю
«акаунт «…» вимкнено — увімкніть його в ІнтеграціїОплати«Інтеграції → Оплати»»перемикач «Інтеграція» вимкненоувімкніть акаунт
«у акаунта «…» не задано токен (MONOBIZ_TOKEN)…»нема токена«Підключення» → «Токен»
«Monobank бізнес: токен не прийнято (HTTP 401/403)…»токен відкликаноновий токен у «Мої токени»
«Monobank бізнес: забагато запитів — зачекайте…»ліміт банкуповторіть пізніше
«платежі з CRM — лише в гривні (UAH)»інша валютаоберіть гривневий рахунок
Стан «Відхилено»директор відхилив у застосунку або банк відхилив операціюстворіть новий платіж
Стан «Помилка», «не підписано за тиждень»чернетку ніхто не підписавприберіть чернетку в банку або «Надіслати в банк» знову
«платити через банк нема чим…» у шторціу гаманця нема акаунта бізнес-APIоберіть акаунт (ключ ТОВ чи ФОП) або гаманець «до сплати»
Стан «Відхилено», «планову прибрано з журналу»платіж «до сплати», а його планову видалили в «Планових»створіть платіж знову

Для ШІ-співробітників

Картка describe_section("int-monobiz") — поля платежу, дії, приклади; доступ — розділ «Фінанси» у «Доступах» ШІ, запис — ще й «Фінанси: проводити й змінювати платежі» і доступ до гаманця (як у людини).

  • bank_payments_list (state, kind, page, per_page) — платежі зі станом; bank_payments_refs (refresh) — акаунти з рахунками банку, отримувачі, гаманці.
  • bank_payment_for_purchase (purchase_id, part) — готова заготовка платежу за партію; нічого не пише.
  • bank_payment_create (values — як у шторці; send: true — одразу в банк) — чекає підтвердження людини (вид payments); після «Підтвердити» платіж ще чекає підпису директора в застосунку банку. Повтор з тим самим idempotency_key другого платежу не створює.
  • bank_payment_send (payment_id) — надіслати чернетку в банк; теж вид payments.
  • bank_payment_check (payment_id) і bank_payments_check_all — без кошика: лише читають стан у банку й проводять витрату, яку людина вже підписала.
  • monobiz_import (values: kind, from, to, iban) — виписка ТОВ; вид bulk.

ШІ не може підписати платіж (це робить лише людина в банку), прибрати чернетку, змінити токен чи налаштування акаунта. Не створюйте платіж без прямого прохання людини, не повторюйте дію з pending_id, реквізити беріть з bank_payment_for_purchase чи bank_payments_refs, а не вигадуйте.

Додаткова інформація

  • Пов'язані статті: Monobank (виписка ФОП), Фінанси, Закупівлі.
  • Застереження: офіційна документація бізнес-API з хмари не відкрилася, поля запитів узято з неофіційного опису; перший платіж на живому токені перевірте на малій сумі.

Цю саму статтю читають ШІ-співробітники Helomi: help("int-monobiz")