> Усі статті WIKI Helomi: /wiki/llms.txt

# 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 для бізнесу (ТОВ)».

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 (виписка ФОП)](int-monobank.md), [Фінанси](finance.md), [Закупівлі](procurement.md).
- Застереження: офіційна документація бізнес-API з хмари не відкрилася, поля запитів узято з неофіційного опису; перший
  платіж на живому токені перевірте на малій сумі.