Валюти та курси: довідник, джерело курсів і історія

Де це у програмі

Меню

Довідники → Валюти та курси

Оновити курси зараз

кнопка ⟳ у вікні довідника

Історія курсів

з того самого вікна, кнопка «Історія курсів»

1

Курс

2

ЦП + %

3

Провайдер курсів

1. Курс — скільки базової валюти (UAH) коштує одна одиниця цієї валюти.
2. ЦП + % — надбавка до курсу, якщо валюту купують дорожче за банківський курс.
3. Провайдер курсів — звідки програма забирає курси валют.

Основна валюта — точка відліку

Одна валюта в довіднику позначена як основна. Її курс завжди дорівнює одиниці, і саме в ній програма рахує все: ціни каталогу, суми документів, прибуток. Курси решти валют — це відповідь на питання «скільки основної валюти коштує одна одиниця цієї».

Шукати її у сітці не обов'язково: над списком є смужка підсумків, і в ній прямо написано, скільки всього валют, скільки активних, яка з них базова, коли востаннє оновлювалися курси і який обрано провайдер.

Окремо є основна валюта сайту — вона може відрізнятися від основної валюти обліку, якщо ви ведете облік в одній валюті, а вітрину показуєте в іншій.

Кожна валюта в довіднику має ще кілька полів: код (USD, EUR, UAH), символи ліворуч і праворуч від суми, кількість знаків після коми для цін, прапорці активності, вивантаження на сайт і відображення на сайті. Неактивні валюти не оновлюються й у розрахунках не беруть участі.

Що станеться з документами, якщо змінити основну валюту

Просто зняти позначку «Основна валюта» не вийде: якщо зняти її з єдиної основної, програма мовчки поверне все як було. Основною призначають іншу валюту — і тоді з попередньої позначка знімається сама.

У момент призначення програма робить три речі: знімає позначку з попередньої основної, новій ставить курс 1 і обнуляє їй «ЦП + %». У документах, на складах і в резервах при цьому не змінюється жодного рядка.

Саме тому незакриті документи лишаються порахованими за старою логікою:

• сума документа й ціни в його рядках — ті самі числа, у валюті самого документа;
• курс, записаний у документі при створенні або при проведенні, теж лишається на місці — і саме на нього множаться всі зведені суми: взаєморозрахунки з контрагентом, плитки, звіти;
• виходить, що зведення рахуються за курсом, узятим щодо старої основної валюти. Поки курс у документі не виправити, підсумки показуватимуть не ті цифри.

Курс окремого документа правиться в його картці, поле «Курс валюти». Якщо змінити у документі валюту, програма підставить курс на дату документа: найближчий запис історії не пізніше цієї дати, а якщо історії за той період немає — поточний курс довідника. Курс, який ви ввели руками, вона при цьому не чіпає.

Ціни каталогу й прайсів після зміни основної валюти теж лишаються тими самими числами. А от наступний перерахунок порахує прайсові ціни вже від нової основної валюти: у неї курс 1, і числа в прайсах стануть означати нову валюту.

Джерело курсів

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

З цього вікна оновлення запускається двома способами: вручну кнопкою ⟳ або автоматично за розкладом — бургер-меню ≡ → «Налаштування розкладу». Поки курси тягнуться, програма пише «Оновлення курсів валют, чекайте...», а коли закінчить — «Курси валют оновлені».

Якщо джерело нічого не віддало — не відповіло, відповіло не в тому форматі або, для свого посилання, у rates немає коду основної валюти, — при запуску кнопкою ⟳ у вікні з'являється червоне повідомлення «Джерело курсів не віддало даних — курси не оновлено, в історію нічого не записано.». Курси в довіднику лишаються як були, знімок в історію не пишеться, а в «Журнал операцій» лягає червоний рядок із тим самим текстом. Для alphavantage.co повідомлення з'являється, коли не прийшов курс жодної валюти; якщо прийшла частина — оновиться лише вона, решта лишиться зі старим значенням.

Якщо джерело не обране взагалі, плашка «Провайдер курсів» показує прочерк — але курси все одно тягнуться: без вибору програма опитує alphavantage.co. Це джерело влаштоване інакше за решту: на кожну активну валюту йде окремий запит із паузою в секунду між ними, тож чим більше валют, тим довше триває прогін. Інші джерела віддають усі курси одним запитом. І ще: коли ліміт безкоштовного ключа alphavantage.co вичерпано, сервіс відповідає без курсу — і якщо так вийшло з усіма валютами, з'явиться те саме червоне повідомлення.

Які джерела є в списку і яке обрати

Правило просте: обирайте національний банк країни, валюта якої у вас основна. Це офіційний курс — саме за ним рахує бухгалтерія, і ваша основна валюта в ньому точно є. Якщо такого банку в списку немає, беріть open.er-api.com: він знає понад 160 валют і працює з будь-якою основною.

Нацбанк іншої країни теж можна обрати — програма перерахує курси через вашу основну валюту. Наприклад, основна валюта гривня, джерело — Нацбанк Польщі: він публікує і долар, і гривню у злотих, тож курс долара в гривнях програма отримає діленням одного на інше. Умова та сама, що й для свого джерела: ваша основна валюта має бути в таблиці банку. Якщо її там немає — як гривні в Європейського центробанку, — не оновиться жодна валюта, а у вікні з'явиться червоне повідомлення «Джерело курсів не віддало даних — курси не оновлено, в історію нічого не записано.».

Готові джерела мають 15 секунд на відповідь (alphavantage.co — на кожну валюту). Не встигло — курси лишаються як були (у alphavantage.co — лише та валюта, на якій сталася затримка), і можна просто повторити оновлення пізніше.

Після оновлення курсів ціни товарів не перераховуються самі. Перерахунок запускають окремо — кнопкою-паличкою в тому ж вікні. Це зроблено навмисно: інакше кожен рух курсу переписував би весь каталог.

Курс, введений руками, і що його перепише

Курс правиться прямо в сітці: подвійний клік по клітинці «Курс», нове значення — і рядок зберігається. Програма запише його, у колонці «Зміна» покаже різницю зі старим курсом, у «Даті оновлення» поставить поточний час, а в історію додасть запис із джерелом «Вручну» — якщо запису за цей день там ще немає.

Живе це значення рівно до наступного оновлення курсів: воно перезаписується мовчки, без запитання й без позначки «тут правили руками». Перезаписати його може не лише кнопка ⟳ — курси тягне ще й розклад, дія «Оновити курси валют» у сценаріях Elbuz Flows, прохання до ІІ-консультанта оновити курси, а також завантаження прайс-листа, якщо в налаштуваннях увімкнено «Оновлювати курс перед завантаженням» («Налаштування системи» → «Прайс-листи» → «Завантаження та розбір», за замовчуванням вимкнено).

Закріпити свій курс можна двома способами, і обидва — не в довіднику:

• Курс для одного прайс-листа. У налаштуваннях колонок прайсу є поля «Курс валюти» і «+%». Якщо в полі «Курс валюти» стоїть значення, відмінне від нуля й одиниці, довідник для цього прайсу не питають узагалі — товари перерахуються за вашим курсом, хоч би що показував довідник.
• Зняти «Активність» із валюти. Неактивні валюти джерело не оновлює — але вони й випадають із перерахунку цін: курс таких валют товарам не підставляється, і ціна лишається у валюті файлу постачальника.

1

Курс валюти

2

+%

1. Курс валюти — ручний курс для цієї колонки (тут 44,8 для USD).
2. Поле «+%» — відсоткова надбавка до курсу.

І дві дії, яких програма не зробить, не сказавши про це. Назву й код валюти зі стандартного набору змінити не можна: решта полів рядка збережеться, а ці два лишаться як були. Видалити таку валюту теж не вийде — з'явиться повідомлення «Запис видалено», рядок зникне з сітки, але після оновлення повернеться. Валюту, яка не потрібна, вимикають «Активністю».

Якщо оновлення обірвалося

Програма спершу отримує від джерела всю відповідь і лише потім записує курси — по одній валюті, швидким проходом. Тому обрив під час запиту до джерела — зв'язок, закрите вікно — курсів не змінює зовсім. Частина валют із новим курсом, а частина зі старим лишиться, тільки якщо обрив припав саме на запис. Де що, видно в колонці «Дата оновлення»: у оновлених вона сьогоднішня.

Знімок в історію, чистка старих записів і рядок у журналі робляться в самому кінці, після всіх валют. Обірваний прогін не лишає рядка «Оновлення курсів валют» у «Журналі операцій» (Кабінет → Журнал операцій) — це і є ознака, що він не дійшов до кінця. Завершений прогін кладе туди перелік курсів, які вийшли; якщо ж джерело нічого не віддало, рядок буде червоний, із текстом «Джерело курсів не віддало даних — курси не оновлено, в історію нічого не записано.».

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

З розкладом одна відмінність. Якщо обірвався прогін за розкладом, задача лишається позначеною як запущена, і наступного разу планувальник її пропустить. Сторож знімає такий замок, коли від старту минула година, — після цього розклад працює як раніше. Кнопкою ⟳ оновити курси руками можна й доти.

Націнка до курсу

У сітці є колонка «ЦП + %» — надбавка до курсу у відсотках. Вона потрібна, коли ви не хочете продавати точно за курсом джерела: банківський курс і курс, за яким ви реально купуєте валюту, зазвичай відрізняються, і ця різниця має бути в ціні, а не з'їдати маржу.

Надбавка застосовується до курсу, а не до ціни товару: усі перерахунки після неї йдуть уже за збільшеним курсом.

Своє джерело курсів за посиланням

Готові джерела підходять не всім: у когось курс приходить із власної системи обліку, у когось — від банку, з яким укладено договір. Для таких випадків є варіант свого посилання: ви вказуєте адресу, звідки програма забирає курси, і далі все працює так само.

Вимоги до того, що лежить за посиланням, прості, але жорсткі. Адреса має віддавати JSON із двома полями:

• base — код валюти, відносно якої наведені курси;
• rates — перелік «код валюти → курс».

Виглядає це приблизно так:

{"base": "USD", "rates": {"UAH": 41.5, "EUR": 0.92, "PLN": 3.95}}

Далі програма рахує крос-курси сама: бере курс вашої основної валюти в джерелі й ділить на курс кожної іншої. Тому не має значення, у якій валюті джерело веде свій base, — аби ваша основна там була.

Ще дві деталі, які рятують у складних випадках. Якщо валюта в джерелі названа іншим кодом, ніж у вас, спрацює додатковий код валюти — програма шукає спершу за основним кодом, потім за додатковим. Це стосується всіх валют, крім основної: її код у джерелі має збігатися з кодом у довіднику. І: на відповідь відводиться 30 секунд, тож джерело має бути швидким.

Перерахунок цін за курсом

Свіжий курс у довіднику сам по собі нічого не змінює: ціни в прайс-листах і в каталозі лишаються такими, якими їх порахували минулого разу. Перерахунок запускає окрема кнопка-паличка в тому ж вікні — у підказці вона зветься «Застосувати націнку для товарів з прайсів».

1

Отримати курси валют

2

Застосувати націнку для товарів з прайсів

3

Додаткові операції

1. Кнопка ⟳ завантажує актуальні курси валют від провайдера.
2. Кнопка-паличка перераховує ціни товарів з прайс-листів за поточними курсами та націнками.
3. Меню ≡ містить додаткові операції, зокрема «Налаштування розкладу».

Вибору, що саме перераховувати, тут немає: кнопка бере всі активні прайс-листи активних постачальників. Вимкнений прайс або вимкнений постачальник пропускається мовчки.

Для кожного прайсу програма робить чотири речі поспіль:

1. повертає ціну й РРЦ до вихідних значень із файлу постачальника — тих, що були до будь-яких націнок;
2. підставляє курс: спершу з довідника валют — разом із надбавкою «ЦП + %», так само як при завантаженні прайсу, — а якщо для прайсу заданий власний курс у налаштуваннях колонок — його. Валюта, з якої знято «Активність», курсу не дає: ціна в ній лишається у валюті файлу;
3. заново проганяє всі правила націнки цього прайсу;
4. перераховує формули полів — спочатку правила самого прайсу, потім спільні для всіх прайсів.

Після прайсів окремим кроком перераховуються ціни товарів базового каталогу — але за правилами націнки БК від закупівельної ціни, а не з прайсу. Нова прайсова ціна в картки каталогу цим прогоном не переноситься.

1

Ціна + курс валют

1. Перший у ланцюжку вид «Ціна + курс валют» бере налаштування з довідника валют і прайс-листа.

Товари базового каталогу з позначками «Фіксована ціна» і «Не оновлювати» правила націнки БК не чіпають — їхня ціна лишається такою, яку поставили ви.

Про хід роботи програма пише в «Журнал операцій»: на кожен прайс лягає рядок «Застосування операції націнки/знижки (без завантаження прайс-листа)», а в кінці — «Застосування операції націнки/знижки завершено». Останнього рядка немає — прогін не дійшов до кінця; частина прайсів перерахована, частина ні, і повторний запуск це виправить.

Черги тут немає: перерахунок іде прямо в тому ж запиті, поки вікно чекає на відповідь. На цей час кнопка блокується, а на екрані висить повідомлення «Обробка даних, чекайте»; коли все закінчиться, з'явиться «Операція успішно виконана». Закриєте вікно — не побачите ні підтвердження, ні помилки, і дивитися доведеться в журнал. Стелі за кількістю товарів немає: кожен прайс-лист програма перераховує цілком, набором запитів до бази, а не по рядку.

Якщо перерахували за помилковим курсом

Ситуація звичайна: джерело віддало дивне число або хтось вписав курс із помилкою, а перерахунок уже пройшов. Окремої кнопки «скасувати» немає — і вона тут не потрібна.

Перерахунок щоразу починається з вихідної ціни з файлу постачальника, тому помилковий курс не лягає другим шаром поверх попереднього. Порядок дій такий: виправте курс у довіднику — руками або оновіть від джерела, — і натисніть кнопку перерахунку ще раз. Ціни стануть такими, ніби помилкового прогону не було.

Один виняток: якщо у прайсі вихідна ціна нульова, а поточне значення записали не кроки націнки, до вихідної воно не повертається — така ціна лишиться як була.

Подивитися, за яким саме курсом порахували конкретний товар, можна в його контекстному меню: пункт «Історія націнки товару». Там показано вихідну ціну й усі кроки по черзі, серед них рядок «Курс:» із застосованим значенням. А який курс стояв у довіднику того дня, покаже вікно «Історія курсів».

Історія курсів

Окреме вікно «Історія курсів» показує, що відбувалося з кожною валютою: графік динаміки, графік зміни у відсотках за період і таблиця знімків по днях. Період обирається згори — від 30 днів до всієї історії.

Знімок пишеться раз на добу для кожної валюти, і не тільки при оновленні від джерела: ручне редагування курсу й підстановка курсу в документ теж лишають запис.

Глибина зберігання налаштовується кнопкою-мітлою; за замовчуванням історія тримається 730 днів, тобто два роки. Старіші записи видаляються автоматично при кожному оновленні курсів, і там же є кнопка прибрати їх негайно.

Сценарії

Постачальник виставляє прайс у доларах, ви продаєте у гривні й хочете свіжий курс щодня

Що ввімкнути. Оберіть джерело в діалозі «Джерело курсів» (клік по плашці «Провайдер курсів») і поставте оновлення на розклад: бургер-меню ≡ → «Налаштування розкладу». У прайс-листа постачальника в списку видів націнок має стояти «Ціна + курс валют. Джерело налаштувань: довідник валют + прайс-лист». Після оновлення курсів натисніть кнопку-паличку «Застосувати націнку для товарів з прайсів».

Що вийде. Розклад оновлює курси в довіднику, а паличка перераховує всі активні прайс-листи активних постачальників за цими курсами.

Чого не станеться. Задача розкладу лише тягне курси — ціни прайсів і каталогу вона не перераховує, це робить тільки паличка або наступне завантаження прайсу. Документи, уже створені, лишаються зі своїм курсом.

Постачальник рахує за своїм курсом, не за курсом джерела

Що ввімкнути. У картці прайс-листа, секція «Колонки» → «Майстер стовпців», у рядку поля ціни відкрийте налаштування колонки й у групі «Валюта» вкажіть валюту колонки та «Курс валюти» — будь-яке значення, крім 0 і 1. Якщо до цього курсу треба додати надбавку, заповніть «+%». Перерахунок кнопкою-паличкою цю надбавку не додає: для товарів у валюті колонки він бере чистий «Курс валюти».

Що вийде. Цей прайс перераховується за вашим курсом, а решта прайсів — як і раніше, за довідником.

Чого не станеться. Оновлення курсів довідника цей прайс не зачіпає, і сам довідник теж не змінюється: курс у налаштуваннях колонки живе лише в цьому прайсі.

Курси мають приходити з вашої системи обліку або від банку

Що ввімкнути. У діалозі «Джерело курсів» оберіть «Власне джерело — JSON за посиланням» і впишіть адресу в однойменне поле під списком. Відповідь має містити base і rates, а в rates — код вашої основної валюти. Якщо джерело називає якусь іншу валюту не так, як довідник, впишіть їй додатковий код. Для основної валюти додатковий код не працює: у rates вона має бути під тим самим кодом, що й у довіднику.

Що вийде. Програма сама рахує крос-курси: курс основної валюти в джерелі ділить на курс кожної іншої. На відповідь відводиться 30 секунд.

Чого не станеться. Якщо в rates немає коду основної валюти, або джерело не відповіло, не оновиться жодна валюта: у вікні з'явиться червоне повідомлення «Джерело курсів не віддало даних — курси не оновлено, в історію нічого не записано.», у «Журналі операцій» — червоний рядок із тим самим текстом, а в історію курсів нічого не запишеться.

Прайс має завантажуватися за курсом, свіжим на момент завантаження

Що ввімкнути. «Налаштування системи» → «Прайс-листи» → «Завантаження та розбір», перемикач «Оновлювати курс перед завантаженням» (за замовчуванням вимкнено).

Що вийде. Перед завантаженням прайс-листа в журнал завантаження лягає окремий крок «Завантаження курсів валют». Джерело при цьому опитується, лише якщо за останню годину його ще не опитували — кнопкою ⟳, розкладом чи попереднім завантаженням, причому рахується й невдала спроба: недоступне джерело не гальмуватиме кожен прайс; інакше прайс іде за курсами, які вже є в довіднику.

Чого не станеться. Курс, який ви виправили в довіднику руками, не вціліє: перше завантаження прайсу, яке опитає джерело, перезапише його значенням від джерела, якщо воно відрізняється. Якщо потрібен сталий курс для одного постачальника, скористайтеся попереднім сценарієм.

Розбір частих проблем

Часті питання

Яке джерело курсів обрати?

Національний банк країни, валюта якої у вас основна: для гривні — bank.gov.ua, для тенге — nationalbank.kz, для злотого — nbp.pl і так далі (усі джерела). Якщо нацбанку вашої країни в списку немає — open.er-api.com. Якщо у вас договір із банком або власна система обліку — підключайте своє посилання.

Який формат має віддавати моє джерело?

JSON із полями base і rates, де rates — перелік «код валюти → курс». Обов'язкова умова: у переліку має бути код вашої основної валюти, інакше програма не порахує крос-курси.

Чи можна оновлювати курси автоматично?

Так, у вікні довідника є налаштування розкладу. Вручну курси тягнуться кнопкою ⟳.

Чому після оновлення курсів ціни лишилися старими?

Перерахунок цін — окрема дія, кнопка-паличка в тому самому вікні. Так зроблено навмисно: інакше кожна зміна курсу переписувала б увесь каталог без вашого відома.

Навіщо колонка «ЦП + %»?

Це надбавка до курсу. Купуєте валюту дорожче за банківський курс — впишіть різницю у відсотках, і всі перерахунки підуть уже за вашим курсом.

Скільки зберігається історія курсів?

За замовчуванням 730 днів. Термін змінюється кнопкою-мітлою у вікні історії; старі записи видаляються самі при кожному оновленні курсів.

Чи можна відкотити ціни, перераховані за помилковим курсом?

Кнопки «скасувати» немає, але відкочувати й не доводиться: перерахунок щоразу починається з вихідної ціни з файлу постачальника. Виправте курс і натисніть кнопку перерахунку ще раз — ціни стануть такими, ніби помилкового прогону не було. Документи це не зачепить: курс у них зберігається окремо.

Що буде з незакритими документами, якщо змінити основну валюту?

Нічого не перерахується. Суми лишаться тими самими числами, а курс, записаний у документі при створенні або проведенні, лишиться тим самим — і всі зведені підсумки множитимуться саме на нього, тобто рахуватимуться щодо старої основної валюти. Виправляють це у полі «Курс валюти» самого документа.

Суміжні теми

• Як завантажити прайс постачальника — валюта прайсу задається там, а перераховується за цими курсами.
• Правила ціноутворення для прайс-листа — що відбувається з ціною після перерахунку за курсом.
• Розклад і черга завдань — як поставити оновлення курсів на автомат.