Інтеграції28 вер. 2026 р.
Підключіть свою адміністрацію Yuki до Xcellerate OPS, і кожен рахунок, який ви надсилаєте з OPS, автоматично створюється в Yuki як рахунок продажу. Більше не треба вводити дані двічі. Інструкція для адміністраторів IT MSP і сервісних компаній, які вже ведуть облік у Yuki.
TL;DR
- Потрібні API-ключ Yuki, Administration ID і роль адміністратора в OPS.
- Коли рахунок переходить із чернетки в надіслані, OPS створює його в Yuki як рахунок продажу.
- Ручний імпорт переносить наявні рахунки продажу та клієнтів із Yuki до OPS.
Перш ніж почати
- Ви адміністратор (admin) робочого простору OPS.
- Ваш обліковий запис Yuki має доступ до API. У вас є API-ключ Yuki та Administration ID адміністрації, у якій ви хочете вести облік. Де саме їх знайти в Yuki, може відрізнятися; за потреби запитайте людину, яка керує вашим обліковим записом Yuki.
- Зовнішнє електронне виставлення рахунків в OPS вимкнене. Поки воно активне, інтеграція з Yuki не застосовується.
- Вебхуки чи URL-адреси перенаправлення не потрібні.
Підключення Yuki за 5 кроків
Крок 1: відкрийте дошку інтеграцій
В OPS перейдіть до Settings (Налаштування) → Integrations (Інтеграції). Якщо в колонці Billing (Виставлення рахунків) ще немає картки Yuki, додайте Yuki з каталогу.
Дошка інтеграцій із порожніми категоріями (Mailbox, Authentication, Payments, Billing) і каталогом доступних інтеграцій праворуч.
Крок 2: введіть дані
На картці Yuki заповніть поля API key та Administration ID. Ці назви полів англійською в будь-якій мові інтерфейсу. Натисніть Save (Зберегти). OPS підтвердить, що налаштування Yuki збережено.
Крок 3: перевірте з'єднання
Натисніть Test connection (Перевірити з'єднання). У разі успіху OPS повідомить, що з'єднання з Yuki працює.
Крок 4: зробіть Yuki ціллю надсилання
Натисніть Use for invoice push (Використовувати для надсилання рахунків). На картці з'явиться значок Push target (Ціль надсилання). Відтепер фіналізовані рахунки надходять до Yuki.
Крок 5 (необов'язково): імпортуйте наявні дані
У розділі Manual import from Yuki (Ручний імпорт із Yuki) виберіть From date (Дата початку) і натисніть Import companies & invoices (Імпортувати компанії та рахунки).
Що відбувається після підключення
- Автоматичне надсилання. Коли рахунок в OPS переходить із чернетки в надіслані, зокрема з графіка виставлення рахунків, OPS створює рахунок продажу в Yuki. Він містить референс, дату, строк оплати, валюту, клієнта (назва, номер ПДВ, e-mail) і рядки з описом, кількістю, ціною за одиницю без ПДВ і ставкою ПДВ.
- Статус у рахунку. Кожен рахунок показує, чи вдалася синхронізація. Якщо ні, ви бачите помилку й кнопку повторної спроби.
- Ручний імпорт. Імпорт отримує рахунки продажу від вибраної дати разом із рядками та статусом оплати. Клієнтів зіставляють за номером ПДВ, потім за назвою, а нових створюють. Повторний імпорт пропускає вже імпортовані документи.
- Лише рахунки. Комерційні пропозиції не надсилаються до Yuki і не імпортуються, бо в Yuki немає пропозицій.
Корисно знати
- Рахунки з OPS одночасно отримує лише одна бухгалтерська система.
- Рахунки, імпортовані з Yuki, не надсилаються назад до Yuki.
- Якщо зберегти з порожнім полем API key, збережений ключ залишиться. Після збереження ключ більше не показується; Administration ID залишається видимим.
- Щоб припинити надсилання до Yuki, натисніть Stop invoice push (Зупинити надсилання рахунків). Якщо також налаштовано ключ Billit, надсилання рахунків знову переходить до Billit.
- Порада: після підключення спершу надішліть один тестовий рахунок і перевірте його в Yuki.
Усунення проблем
Повідомлення наведено так, як вони виглядають в англійському інтерфейсі.
Yuki responded with HTTP <code>під час перевірки: зазвичай неправильний API-ключ або Administration ID. Перевірте обидва й повторіть тест.Configure this provider first.: ви перевіряєте чи імпортуєте, ще не зберігши ключ. Заповніть поля й спершу натисніть Save.Configure and connect this provider first.: ви натиснули Use for invoice push до налаштування з'єднання. Спершу виконайте кроки 2 і 3.Import failed: <error>або… N skipped because the customer has no name or VAT number.: у деяких документах клієнт без назви чи номера ПДВ. Доповніть їх у Yuki і запустіть імпорт знову.
Докладніше про європейські інтеграції OPS і про продажі та виставлення рахунків. Ще немає робочого простору? Почніть безкоштовно, а потім підключіть Yuki.