Monobank для бізнесу (ТОВ, ФОП)
Інтеграція «Monobank для бізнесу» дає платити з рахунку компанії чи ФОП прямо з CRM: ви готуєте платіж постачальнику, перевізнику чи партнеру, CRM надсилає його в банк чернеткою, а директор підписує в застосунку monobank. Після підпису платіж сам стає витратою у «Фінансах» з підставою — оплатою партії чи виплатою партнеру; без підпису людини в банку гроші не йдуть ніколи. Це бізнес-API monobank (кабінет компанії або ФОП у web.monobank.ua), окремий від особистого API, яким CRM читає виписку (стаття «Monobank»): для одного рахунку ФОП у вас може бути дві картки — «Monobank» (виписка) і «Monobank для бізнесу» (платежі). Гаманець без такого ключа (особиста картка, готівка) теж платить з CRM — у режимі «до сплати» (стаття «Фінанси», §7д).
На цій сторінці
Можливості
- Вкладка Фінанси›Платежі«Фінанси → Платежі»: усі платежі зі станом «Чернетка», «Чекає підпису», «До сплати», «Проведено», «Відхилено», «Помилка».
- Рахунок ТОВ і рахунок ФОП — однаково (ключ з кабінету ФОП); гаманець без ключа — платіж «до сплати».
- Платіж з будь-якого місця: довільний, оплата партії закупівлі (сума «ще винні» й отримувач з картки), виплата партнеру.
- Перевірки до банку: IBAN (UA і 27 цифр), ЄДРПОУ (8 цифр) чи РНОКПП (10 цифр), сума, призначення.
- Підписаний платіж — витрата у «Фінансах» сама: з гаманцем акаунта, підставою, контрагентом; партія — «сплачено», виплата — «виплачено».
- Повтор безпечний: повторне надсилання не створює в банку другу чернетку; виписка дубля не дає.
- Кілька акаунтів (кілька компаній чи токенів), у журналі подій — хто що надіслав, IBAN лише хвостом «…1234».
1Налаштування
Підключає адміністратор. Дорога: «Інтеграції» (головне меню) → «Оплати» → картка «Monobank для бізнесу (ТОВ)».
- Токен: увійдіть у web.monobank.ua у кабінет компанії (ТОВ) або ФОП з правами директора / власника → «Мої токени» (
web.monobank.ua/?modal=tokens) → створіть токен. Для ФОП це той самий бізнес-API: ключ береться в кабінеті ФОП, а не в особистому застосунку; якщо пункту «Мої токени» в кабінеті ФОП нема — замовте доступ до бізнес-API у підтримці monobank для бізнесу. Поле ключа в картці підписано «Токен бізнес-API (кабінет ТОВ або ФОП)», підказка під ним — та сама дорога. - Вкладка «Підключення» → «Токен» → «Ввести» → вставте → «Зберегти ключ» → «Перевірити» (успіх — «рахунків: N»). Один кабінет — один акаунт картки: основна картка — ваш ФОП (чи ТОВ), другий кабінет — «+» → «Додати акаунт».
- Увімкніть перемикач «Інтеграція»: вимкнений акаунт не приймає нових платежів і не надсилає їх у банк.
- Ще одна компанія чи токен — «+» у правому нижньому куті картки → «Назва», токен → «Додати акаунт».
Гаманець платежів за замовчуванням — «Monobank бізнес» (створиться сам); інший обирається в шторці платежу. Якщо рахунок ФОП у CRM уже є гаманцем «Монобанк ФОП» (виписка через особистий API) — у шторці платежу оберіть цей гаманець і в «Акаунт» — акаунт бізнес-API: CRM запам'ятає пару і далі платитиме з нього через банк без запитань. IBAN і ЄДРПОУ постачальника чи перевізника можна вписати заздалегідь: «Закупівлі» → «Довідники» → постачальник / перевізник → «IBAN», «ЄДРПОУ / РНОКПП».
2Платіж з CRM
- «Фінанси» → «Платежі» → «Новий платіж банку». Відкривається шторка платежу.
- «Гаманець» (підписано «через банк» або «до сплати») → «Акаунт» → «Рахунок-відправник» (лише гривневі рахунки; порожньо — перший гривневий) → «Отримувач» (почніть писати — з'являться підказки: ваші юрособи, постачальники й перевізники з IBAN, попередні отримувачі) → «IBAN», «ЄДРПОУ / РНОКПП» → «Сума, ₴» → «Призначення». Гаманець «до сплати» (картка, готівка) — без рахунку-відправника, зате зі строком і категорією: платіж стане плановою в «Планових», а закриє його кнопка «Оплачено» або рядок виписки (стаття «Фінанси», §7д).
- «Надіслати в банк» — платіж іде в банк і стає «Чекає підпису»; «Зберегти чернетку» — лише в CRM (банк її не бачить).
- Директор відкриває застосунок monobank (чи web-кабінет) і підписує або відхиляє чернетку.
- 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")