# Валюти в Krokul: базова валюта, курси й автооновлення

У якій валюті компанія веде звітність і за яким курсом суми в інших валютах переводяться в неї.

Теги: валюти, курс валют, базова валюта, курс нбу, автооновлення курсів

## Коротко
- **Базова валюта** — валюта звітності; у ній еквівалент кожної суми.
- **Курс** — скільки одиниць бази коштує одна одиниця валюти на дату.
- **Автооновлення** — щогодинний курс НБУ для валют компанії.

## Як зробити
### Подивитися курси валюти
Останній курс і журнал однієї валюти.
1. Відкрийте «Каталог» → «Валюти».
2. Клацніть валюту в переліку ліворуч.
3. Праворуч зʼявиться журнал: дата, курс, джерело.
> Порада: Під час відкриття Krokul сам обирає першу валюту, для якої вже є курс. Позначка „ручний“ — курс записано рукою, „ринковий“ — з джерела.

### Записати курс вручну
Свій курс на будь-яку дату, зокрема минулу.
1. Оберіть валюту в переліку.
2. Оберіть дату, з якої діє курс.
3. Введіть курс — скільки базової валюти за одиницю обраної, наприклад 44,85.
4. Натисніть «Записати курс».
> Порада: Кнопка неактивна, доки не заповнено дату й курс. Новий рядок стане в журналі з позначкою „ручний“.

### Увімкнути автооновлення
Курс НБУ щогодини без ручного запису.
1. Переконайтеся, що потрібні валюти вже мають хоч один курс у журналі.
2. Увімкніть «Автооновлення курсів» у верхній смузі.
3. Щоб зупинити, вимкніть перемикач — записані курси лишаться.
> Порада: Перший курс зʼявиться протягом години, далі — щогодини, на сьогоднішню дату компанії.

### Оновити з ринку
Разово взяти сьогоднішні курси.
1. Натисніть «Оновити з ринку».
> Порада: Krokul запише курси всіх активних валют, крім базової. Автооновлення від кнопки не вмикається.

### Змінити базову валюту
Нова валюта звітності компанії.
1. Відкрийте вибір валюти поруч із „База“ й оберіть нову валюту.
2. Прочитайте наслідки у вікні „Зробити … базовою валютою“.
3. Натисніть «Змінити базу».
> Важливо: Курси, заморожені на угодах, документах і оплатах, перерахуються в нову базу. Суми у валютах документів не зміняться.
> Важливо: Якщо на якусь дату бракує курсу нової бази, Krokul відмовить і назве дату. Запишіть курс і повторіть.

## Як це влаштовано
**Базова валюта.** Кожна сума в іншій валюті отримує еквівалент у базовій за курсом на дату, і курс фіксується на самій сумі. Типова база — UAH. Нові угоди, прайси, товари й рахунки компанії без названої валюти отримують базову.

**Який курс береться.** Діє курс із найпізнішою датою, не пізнішою за дату суми. Курс заднім числом змінює лише нові суми — зафіксовані свого курсу не міняють. Другий курс на ту саму дату замінює перший.

**Перелік валют.** 14 поширених валют (UAH, USD, EUR, PLN, GBP, CHF, CZK, CNY, TRY, KZT, MDL, RON, CAD, JPY) і будь-яка інша, для якої є курс. Російський і білоруський рублі не ведуться. Для базової валюти курсу немає: „Це базова валюта — курсів у неї немає.“

**Журнал.** До 50 останніх записів валюти. Для ручних записів у джерелі стоїть „вручну“ і день, коли курс внесли.

**Автооновлення.** Перемикач на компанію, типово вимкнений. Джерело — „НБУ — офіційний курс“; інше джерело чи націнку тут не задати.
- оновлюються валюти, для яких у журналі вже є курс; базова — ні;
- немає жодної такої валюти — адміністратори отримують сповіщення;
- джерело мовчить 1–3 доби — пишеться останній відомий курс зі сповіщенням про його вік;
- понад 3 доби — автооновлення зупиняється й просить курс вручну;
- поки перемикач увімкнений, ручний курс на сьогодні замінюється курсом джерела.

**Де працюють курси.** Еквіваленти сум угод, документів і оплат у базовій валюті та переведення ціни, коли прайс в іншій валюті, ніж угода. Курси банків і міжбанку — у вікні «Ринкові курси».

**Хто що може.**
- бачити валюти й журнал — усі ролі;
- записувати курси й оновлювати з ринку — адміністратор і менеджер;
- змінювати базу й вмикати автооновлення — лише адміністратор; менеджеру Krokul скаже „Базову валюту змінює лише адміністратор.“

**Джерело курсу.** Офіційний курс гривні до іноземних валют Національний банк України публікує як відкриті дані: [НБУ — API для розробників](https://bank.gov.ua/ua/open-data/api-dev).

Повʼязані вікна: «Ринкові курси», «Ціноутворення», «Оплати».

## Питання й відповіді
### Чому курси валют не оновлюються самі?
Автооновлення за замовчуванням вимкнене. Адміністратор вмикає «Автооновлення курсів»; перший курс зʼявиться протягом години.

### Я ввімкнув автооновлення, а курсу долара немає — чому?
Автооновлення веде лише валюти з курсом у журналі. Запишіть курс долара вручну один раз — далі його оновлюватиме Krokul.

### Чи можна поставити курс заднім числом?
Так, оберіть минулу дату. Курс діятиме для нових сум з цієї дати; зафіксовані суми не зміняться.

### Чому мій ручний курс на сьогодні замінився іншим?
Увімкнене автооновлення щогодини пише курс джерела на сьогодні. Щоб працювати з власним курсом, вимкніть перемикач.

### Чому нова угода одразу в доларах, а не в гривні?
Базова валюта вашої компанії — долар. Валюта, якої не назвали, береться з бази компанії.

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

### Екран «Валюти»

| Поле | Що це й на що впливає |
|---|---|
| Змінити базову валюту | Перераховує заморожені курси угод, документів і оплат у нову базу; суми документів не змінюються. Лише адміністратор; без потрібного курсу — відмова з його назвою. |
| Автооновлення курсів | Krokul сам підтягує курси з джерела в дужках; вимкнено — лише «Оновити з ринку» чи вручну. |
| На дату | Можна заднім числом — журнал покаже, хто й коли поклав курс. |
| Курс (валюта → база) | Скільки бази коштує одиниця валюти; до бази додається маржа компанії, якщо задана. |

| Колонка | Що це й на що впливає |
|---|---|
| Дата, Курс, Джерело | Угоди й документи заморожують курс при створенні, тож зміна журналу їх не перераховує. |

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

| Розділ | Що це й на що впливає |
|---|---|
| База | Валюта звітності й усіх збережених еквівалентів. |
| Список валют | Останній курс до бази з джерелом; клік відкриває журнал курсів. |

---

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