Для міжнародних операцій Nova Industries іноді потрібен ринковий курс, коли фінансовий відділ не вніс його вручну.
Менеджер з продажу Nova створює рахунок-фактуру в EUR, але фінансовий відділ не ввів курс на цю дату вручну. ERPNext може або зупинити користувача, або запитати курс в онлайн-сервісу курсів валют. «Параметри обміну валют» керують цим резервним варіантом: постачальником, адресою запиту (endpoint), параметрами запиту, обліковими даними та розбором відповіді.
Налаштування глобальне, тож одна помилка в конфігурації може вплинути на операції та переоцінку на кінець періоду одразу в кількох організаціях. Використовуйте його, якщо ринкові курси прийнятні, або вимкніть, якщо фінансовий відділ вимагає лише затверджених записів «Обмін валюти». Ця сторінка допоможе налаштувати й перевірити постачальника, перш ніж користувачі почнуть на нього покладатися.
Перш ніж почати
Складіть перелік потрібних валютних пар, дат операцій і типів курсів. З'ясуйте, чи надає постачальник історичні курси, а не лише поточні. Визначте, хто відповідає за облікові дані постачальника, затвердження джерела курсів, дії під час збоїв і ручний резервний варіант.
Увімкніть потрібні записи «Валюта». Перегляньте параметри застарілих курсів у «Налаштуваннях рахунків»: перед зверненням до постачальника система віддає перевагу дійсному ручному запису. Якщо увімкнено Дозволити застарілі обмінні курси, старий ручний курс може й надалі мати пріоритет без обмежень у часі.
Перевірка налаштованого постачальника
- Відкрийте «Параметри обміну валют».
- Переконайтеся, що прапорець Вимкнено знято, якщо потрібен резервний запит до постачальника.
- Виберіть «Постачальник послуги».
- Перевірте «Кінцеву точку API» та протокол.
- Вводьте «Ключ доступу» лише для постачальника, який його вимагає.
- Перевірте параметри запиту та відповідність ключів результату.
- Збережіть, а потім перевірте роботу на чернетці валютної операції.
У поточній develop-версії доступні варіанти frankfurter.dev, frankfurter.dev - v2, exchangerate.host і Custom. Frankfurter v2 підтримує більше валют, ніж старіша конфігурація v1. Exchangerate.host потребує ключа доступу. Перелік валют і комерційні умови постачальників можуть змінюватися, тому перед запуском перевірте їх безпосередньо в постачальника.
Основні поля та їхнє значення
| Поле | Значення |
|---|---|
| Вимкнено | Зупиняє запити до постачальника. ERPNext і далі може використовувати відповідні збережені записи «Обмін валюти». |
| Постачальник послуги | Завантажує готові налаштування постачальника або дозволяє власну конфігурацію (Custom). |
| Кінцева точка API | Шаблон URL, який викликає ERPNext. Може містити підстановки, наприклад {transaction_date}, {from_currency} і {to_currency}. |
| Використовувати протокол HTTP | Використовує HTTP замість HTTPS. Не вмикайте, якщо лише довірений внутрішній сервіс прямо не вимагає HTTP. |
| Ключ доступу | Облікові дані, яких вимагають деякі постачальники. Захищайте його, як будь-який секретний ключ зовнішнього API. |
| Параметри | Пари «ключ — значення», що передаються із запитом. Значення можуть містити підтримувані підстановки. |
| Ключ результату | Шлях, за яким із відповіді постачальника витягується числове значення курсу. |
| Приклад URL | Попередній перегляд, який допомагає перевірити формат запиту. |
Не вставляйте секретні ключі в документацію, знімки екрана, звернення до підтримки чи клієнтські скрипти. Обмежте право змінювати це налаштування.
За допомогою прав доступу на основі ролей обмежте коло тих, хто може змінювати постачальника чи його облікові дані. Джерело курсів — це елемент внутрішнього контролю обліку, а не просто технічна вподобайка. Зафіксуйте у фінансовому регламенті відповідальну особу, дату продовження, затверджених постачальників, підтримувані валютні пари та ручний резервний варіант.
Вибір постачальника
Frankfurter v2
Використовуйте готову конфігурацію v2, щоб отримувати курс без ключа з централізованого джерела, якщо підтримувані валюти та глибина історичних даних вам підходять. Налаштована на демо-сайті адреса запитує курс для полів «З валюти», «У валюту» та дати операції.
Frankfurter v1
Старіша адреса охоплює менше валют. Залишайте її лише тоді, коли наявну інтеграцію вже перевірено на підтримуваному переліку валют. Для нових налаштувань спершу розгляньте v2.
Exchangerate.host
Цей постачальник пропонує ширший комерційний сервіс, але в поточній готовій конфігурації вимагає ключа доступу. Перед використанням вивчіть його безплатний чи платний тариф, ліміти запитів, глибину історичних даних, ліцензійні умови та доступність.
Custom
Використовуйте Custom для затвердженого казначейського сервісу або внутрішньої служби курсів. Ретельно налаштуйте URL, параметри та шлях до результату. Відповідь має містити числовий курс саме в тому напрямі, у якому його запитує ERPNext.
Порядок пошуку курсу
Коли ERPNext запитує курс для певного напряму, дати й контексту купівлі чи продажу, спершу він шукає збережені записи «Обмін валюти». Якщо відповідного немає, викликається постачальник. Якщо постачальник не відповідає або не повертає придатного значення, ERPNext просить створити запис вручну.
Цей порядок важливий, коли користувачі скаржаться, що система не бере ринковий курс. Причиною може бути відповідний збережений запис, а не постачальник. Перш ніж змінювати налаштування API, перегляньте фіксацію обмінного курсу і параметри застарілих курсів.
Перевірка налаштувань
Створіть чернетку рахунку-фактури (продаж) або рахунку-фактури на покупку з датою відомого робочого дня. Виберіть підтримувану іноземну валюту й перевірте, що:
- поле «Курс валюти» заповнюється;
- напрям курсу в підписі поля правильний;
- підсумок у валюті організації відповідає курсу;
- для історичної дати повертається правдоподібний історичний курс;
- для свідомо непідтримуваної пари спрацьовує зрозумілий резервний сценарій;
- звичайні користувачі не бачать ключа API чи подробиць відповіді.
Перевірте також введення платежу: валюти рахунку-джерела та рахунку-призначення в ньому можуть потребувати курсу в іншому напрямі. Окремо перевірте переоцінку валютного курсу на дату закриття.
Повторюйте перевірку після оновлень системи або змін у налаштуваннях постачальника. Порівнюйте отримане значення з незалежним затвердженим джерелом на відому дату й переконайтеся, що той самий запит несподівано не бере старіший ручний курс.
Вимкнення резервного постачальника
Позначте Вимкнено, якщо кожен курс має надходити із затвердженого вручну довідника або з іншого контрольованого процесу. Перед цим створіть потрібні записи з урахуванням напряму й дати та перевірте, як система поводиться за відсутності курсу. Саме по собі вимкнення постачальника не створює процесу погодження з попередженнями.
Якщо фінансовий відділ імпортує курси, використовуйте «Імпорт даних» з контрольованим шаблоном і процедурою перевірки. Не допускайте непомітного накопичення дублікатів або записів із неправильним напрямом.
Вирішення проблем
ERPNext не може знайти курс для однієї з валют
Переконайтеся, що постачальник підтримує обидві валюти та потрібну історичну дату. Постачальник може мати USD і EUR, але не регіональну валюту. Спробуйте інший затверджений сервіс або створіть запис вручну.
Постачальника налаштовано, але з'являється інший курс
Пошукайте відповідний ручний запис у «Обміні валюти». Перевірте дату операції, напрям, позначку купівлі чи продажу, параметри «Дозволити застарілі обмінні курси» та «Застарілі дні».
Власний постачальник повертає дані, але ERPNext читає нуль
Перевірте шлях у полі «Ключ результату» та те, що витягнуте значення числове. Порівняйте URL запиту та структуру відповіді, не розкриваючи облікових даних.
Історичні курси не отримуються, а поточні — так
Можливо, постачальник або ваш тариф не підтримує історичні дати. Використайте постачальника з відповідним охопленням або імпортуйте затверджені історичні записи «Обмін валюти».
Поширені запитання
Чи завжди ERPNext звертається до налаштованого постачальника?
Ні. Перевагу має відповідний ручний запис «Обмін валюти».
Якого постачальника обрати?
Вибирайте з огляду на перелік валют, підтримку історичних даних, вимоги до точності, ліцензійні умови, ліміти запитів, надійність і безпеку. Універсально найкращого постачальника немає.
Чи потрапляють курси від постачальника автоматично в облік?
Ні. Отриманий курс лише заповнює поле в документі. Облік змінюється тільки після проведення облікового документа або створеного на його основі запису журналу.
Чи може кожна організація використовувати власного постачальника?
«Параметри обміну валют» — це єдине налаштування на весь сайт. Якщо організаціям потрібні різні затверджені джерела, використовуйте контрольовані ручні записи або доопрацювання.
Чи вмикати HTTP для зовнішнього постачальника?
Ні. Для зовнішніх сервісів використовуйте HTTPS. HTTP допустимий лише у свідомо захищеній внутрішній інфраструктурі.
Пов'язані теми
- Обмін валюти
- Налаштування мультивалютності
- Налаштування рахунків
- Операції в кількох валютах
- Переоцінка валютного курсу
Переклад сторінки «Currency Exchange Settings» з документації ERPNext. © Frappe Technologies Pvt. Ltd., ліцензія CC BY-SA 3.0. Переклад — OpenOblik, на тих самих умовах. Переклад машинний, вичитка триває: помітили неточність — напишіть нам.