# Надходження в Krokul: гроші з банку й плани оплат

Гроші, що прийшли з банку, і до якого плану оплати кожне надходження належить.

Теги: надходження, банківська виписка, зіставлення платежів, код платежу, призначення платежу, план оплат

## Коротко
- **Надходження** — рядок банку: хто, скільки й з яким призначенням заплатив. Це ще не оплата в Krokul.
- **Підказка** — план оплати, угода чи клієнт, яких Krokul знайшов за призначенням, контрагентом або сумою.
- **Підтвердження** — надходження стає фактом оплати на угоді й закриває план.
- **Не наше** — внутрішній переказ, повернення чи чужий платіж: у факти оплати не йде.

## Як зробити
### Підключити банк
Надходження приходять лише з банку.
1. Відкрийте «Адміністрування» → «Маркетплейс».
2. Підключіть Salt Edge або monobank.
3. Нові рухи коштів зʼявляться в «Надходженнях» самі — з підказкою, якщо Krokul знайшов план.
> Порада: Поки банк не підключено й надходжень немає, на екрані стоїть «Підключіть банк» з кнопкою «Відкрити «Ринок»».

### Підтвердити надходження
Гроші прийшли за планом, який підказав Krokul.
1. Відкрийте «Документи» → «Надходження».
2. Оберіть у полі «Стан» значення «Є підказка».
3. Перевірте колонку «Зіставлено з»: номер плану й угода або клієнт.
4. Натисніть «Підтвердити» в рядку.
5. Стан зміниться на «Підтверджено», а в «Оплатах» зʼявиться факт на угоді плану.
> Важливо: Підтвердити можна лише надходження, зіставлене з планом або угодою. Якщо підказано тільки клієнта, Krokul відмовить і попросить обрати план чи угоду.

### Підтвердити всі точні
Одним натиском — надходження з точним збігом.
1. Над таблицею натисніть «Підтвердити N точних». Кнопка є, коли серед показаних рядків є точні збіги.
2. Під смугою зʼявиться, скільки підтверджено.
3. Пропущені названо поіменно: сума, платник і причина.
> Порада: Точний збіг — це 100 % у колонці «Збіг»: знайдено код платежу одного плану. Інші підказки підтверджуйте по одній.

### Позначити «Не наше»
Платіж, який не має стосунку до продажів.
1. Знайдіть рядок у стані «Нове» або «Є підказка».
2. Натисніть «Не наше».
3. Рядок перейде в стан «Не наше» й зникне з відбору відкритих.

### Скасувати підтвердження
Підтвердили не той план.
1. Знайдіть рядок у стані «Підтверджено».
2. Натисніть «Скасувати».
3. Факт оплати, створений підтвердженням, видаляється, а надходження повертається в стан «Є підказка».
> Порада: Видалений факт лежить у «Кошику», як будь-яка видалена оплата. Сальдо угоди перераховується.

### Увімкнути код платежу
Щоб надходження знаходило свій план без людини.
1. Відкрийте «Адміністрування» → «Налаштування» → «Реквізити компанії».
2. Під реквізитами знайдіть блок «Код платежу і призначення».
3. Позначте «Код платежу в призначенні» і за потреби задайте «Префікс коду».
4. Змініть «Шаблон призначення», якщо типовий не підходить.
5. У блоці «Зіставлення надходжень» задайте «Допуск суми» й позначте «Підтверджувати автоматично за кодом платежу».
6. Натисніть «Зберегти».
> Важливо: Блок бачить лише адміністратор. Одна кнопка «Зберегти» записує обидві групи полів.

## Як це влаштовано
**Звідки надходження.** Рядки приходять із підключених банків: Salt Edge і monobank. Той самий рядок банку двічі не записується, навіть якщо банк передав його повторно.

**Як Krokul шукає план.** Правила перевіряються по черзі, і наступне питають лише тоді, коли попереднє нічого не знайшло:
- **Код платежу** в призначенні — план із цим кодом. Збіг 100 %, якщо такий план один; два коди в одному призначенні — 90 % на план із ранішим строком.
- **Номер рахунку** в призначенні разом із сумою, що дорівнює залишку плану цього рахунку (або сумі рахунку без планів). Збіг 90 %.
- **Контрагент** за ЄДРПОУ чи IBAN платника — лише коли такий контрагент у компанії один. Сума дорівнює залишку одного з його відкритих планів — 80 %; інакше 50 % на найстаріший відкритий план.
- **Сума й дата** — один відкритий план тієї ж валюти, чий залишок у межах «Допуску суми», а строк — у «Вікні дат» від дня надходження. Збіг 30 %, лише підказка.
- Нічого не знайшлось — стан «Нове».

**Код платежу.** Шість знаків із латинських літер і цифр, перед ними — префікс компанії. План отримує код під час створення; план, створений раніше, — під час першого друку рахунку. Код стоїть у призначенні блоку «Як оплатити» на рахунку й у QR. Шукаючи код, Krokul не зважає на регістр, пробіли й дефіси та розпізнає кириличні літери, схожі на латинські. Змінений префікс діє на нові коди: коди, видані зі старим префіксом, за кодом платежу більше не впізнаються.

**Шаблон призначення.** До 200 знаків, токени `{NUMBER}`, `{DATE}`, `{PAY_CODE}`, `{CLIENT}`. Якщо в шаблоні немає `{PAY_CODE}`, код дописується в кінець. Готове призначення обрізається до 140 знаків.

**Автоматичне підтвердження.** Надходження підтверджується без людини, коли код платежу вказує на один план, валюта та сама, сума дорівнює залишку плану і «Підтверджувати автоматично за кодом платежу» позначено. Часткова оплата чи переплата лишається підказкою. Збіг за номером рахунку типово теж лише підказка.

**Що створює підтвердження.** Факт оплати на угоді плану, спосіб «bank», дата — день надходження, коментар — платник і призначення. Переплата тієї ж валюти ділиться: факт на залишок плану й окремий факт без плану на решту. Часткова оплата — один факт на всю суму з посиланням на план.

**Не звірено з банком.** Позначка-щит біля стану — надходження прийшло повідомленням банку раніше за виписку. Такий рядок не підтверджується автоматично. Коли виписка його підтвердить, позначка зникне, а підказка перерахується.

**Колонка «Збіг».** Впевненість підказки у відсотках. Для підтверджених і «Не наше» не показується.

**Лічильник і пошук.** Пошук іде за призначенням, платником і його ЄДРПОУ. Кількість надходжень над таблицею видно, коли не вибрано стан і порожній пошук.

**Права.** Бачать адміністратор, менеджер і агент; агент — лише надходження, зіставлені з його угодами, і про це сказано над таблицею. Підтверджують, скасовують і позначають «Не наше» адміністратор і менеджер. Налаштування коду й зіставлення — лише адміністратор.

**Відмови.** Якщо список не прочитався, на місці таблиці стоїть „Не вдалося прочитати надходження.“ з кнопкою повтору. Відмову дії сервер пише під таблицею своїми словами.

Повʼязані вікна: «Оплати», «Реквізити компанії», «Маркетплейс», «Прогноз надходжень».

## Питання й відповіді
### Чому надходження в стані «Нове»?
Жодне правило не знайшло плану: у призначенні немає коду платежу чи номера рахунку, платника немає серед контрагентів за ЄДРПОУ чи IBAN, а за сумою й датою підходить нуль або кілька планів.

### Чому гроші з кодом платежу не підтвердились самі?
Перевірте чотири речі: сума дорівнює залишку плану, валюта та сама, в налаштуваннях позначено «Підтверджувати автоматично за кодом платежу», а біля стану немає позначки «Не звірено з банком».

### Чому «Підтвердити N точних» пропустило рядок?
Під смугою названо причину: збіг не точний, план оплати видалено, надходження вже підтверджене, позначене «Не наше» або змінилось. Пропущені рядки лишаються в списку.

### Що буде з оплатою, якщо скасувати підтвердження?
Факт оплати видаляється в «Кошик», борг угоди повертається, а надходження знову чекає рішення.

### Чи можна змінити «Вікно дат»?
На екрані — ні: воно показане фактом, типово ± 3 дні від строку плану.

## Поля й елементи

### Екран «Надходження»

| Фільтр і пошук | Що це й на що впливає |
|---|---|
| Пошук за призначенням, платником | Також за ЄДРПОУ платника. |
| Стан | «Нове» — збігу немає, «Є підказка» — Krokul знайшов план, угоду чи клієнта, «Підтверджено» — став фактом оплати, «Не наше» — у факти не йде. |
| Джерело | Банк чи сервіс, з якого прийшло надходження. |

| Колонка | Що це й на що впливає |
|---|---|
| Зіставлено з | План оплати, угода або клієнт, яких знайшли правила: код платежу, номер рахунку з сумою, ЄДРПОУ чи IBAN платника, сума й дата. |
| Збіг | Впевненість підказки: 100 % — код платежу, 90 % — номер рахунку й сума, 80 або 50 % — контрагент, 30 % — лише сума й дата. |
| Не звірено з банком | Щит біля стану: надходження прийшло повідомленням банку раніше за виписку. Автоматично не підтверджується. |

| Кнопка | Що це й на що впливає |
|---|---|
| Підтвердити N точних | Підтверджує показані рядки зі збігом 100 % (код платежу одного плану); пропущені названо під смугою поіменно з причиною. |
| Підтвердити | Створює факт оплати на угоді плану; переплата — окремим фактом без плану. Потрібен план або угода. |
| Не наше | Для переказу між своїми рахунками, повернення чи чужого платежу. |
| Скасувати | Видаляє факт оплати, створений підтвердженням, у «Кошик»; надходження знову чекає рішення. |

| Розділ | Що це й на що впливає |
|---|---|
| Хто бачить | Адміністратор, менеджер і агент (лише зіставлене з його угодами); дії — адміністратор і менеджер. |

### Поля блоку «Код платежу і призначення» та «Зіставлення надходжень»

| Поле | Що це й на що впливає |
|---|---|
| Код платежу в призначенні | Кожен новий план оплати отримує код із шести знаків, і рахунок друкує його в призначенні та QR. За кодом надходження з банку знаходить свій план; без коду зіставлення спирається на номер рахунку, контрагента й суму. |
| Префікс коду | До 4 латинських літер або цифр 2–9 перед кодом. Діє на нові коди: видані планам не змінюються, але коди зі старим префіксом зіставлення за кодом більше не впізнає. |
| Шаблон призначення | До 200 знаків, токени {NUMBER}, {DATE}, {PAY_CODE}, {CLIENT}; інших не приймає. Без {PAY_CODE} код дописується в кінець, готове призначення — до 140 знаків. Порожньо — «Оплата за рахунком №{NUMBER} від {DATE}». |
| Допуск суми | Лише для підказки за сумою й датою: на скільки залишок плану може відрізнятись від надходження. 0 — сума має збігтись до копійки. |
| Підтверджувати автоматично за кодом платежу | Надходження з кодом одного плану, тією ж валютою й сумою, що дорівнює залишку плану, стає фактом оплати без людини. Часткова оплата, переплата й рядок, не звірений з банком, лишаються підказкою. |

| Кнопка | Що це й на що впливає |
|---|---|
| Зберегти | Записує обидві групи разом; відмову сервер показує під полем. |

| Розділ | Що це й на що впливає |
|---|---|
| Вікно дат | Скільки днів між строком плану й днем надходження допускає підказка за сумою. Показане фактом, типово ± 3 дні. |

### Поля форми «Зіставити надходження»

| Поле | Що це й на що впливає |
|---|---|
| З чим зіставити | План оплати, угода чи клієнт. Угода чи клієнт без плану — оплата ляже без плану; план можна завести пізніше в картці угоди. |
| Одразу підтвердити | Разом із зіставленням створює факт оплати; без позначки надходження лишається зіставленим, але не підтвердженим. |

| Фільтр і пошук | Що це й на що впливає |
|---|---|
| Пошук | План — за номером, клієнтом чи кодом платежу; угода — за назвою чи клієнтом; клієнт — за назвою чи кодом. |

### Поля форми «Додати надходження вручну»

| Поле | Що це й на що впливає |
|---|---|
| Дата надходження | Обовʼязкова; день, коли гроші надійшли. |
| Сума | Обовʼязкова, більша за нуль. |
| Валюта | Валюта, у якій надійшли гроші. |
| Платник | Назва платника, як у виписці. |
| Код платника | ЄДРПОУ чи ІПН; за ним шукається клієнт. |
| Призначення | Як у банківській виписці: за кодом платежу й номером рахунку шукається план. Точний збіг за кодом може підтвердитись сам. |

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs