Інтеграція з AvaTax

AvaTax від Avalara - це хмарне податкове програмне забезпечення. Інтеграція AvaTax з Odoo забезпечує розрахунки податків у режимі реального часу та для кожного регіону, коли користувачі продають, купують та виставляють рахунки-фактури в Odoo. Розрахунок податків AvaTax підтримується для кожної країни, що входить до списку Організації Об’єднаних Націй, включаючи міжкордонні транзакції.

Важливо

AvaTax доступний для інтеграції лише з базами даних/компаніями, які мають філії у Сполучених Штатах, Канаді та Бразилії. Це означає, що фінансову позицію/країну бази даних можна встановити лише на Сполучені Штати, Канаду або Бразилію. Для отримання додаткової інформації зверніться до цієї документації: Фіскальна країна.

AvaTax враховує податкові ставки на основі місцезнаходження для кожного штату, округу та міста. Він підвищує точність переказів, звертаючи пильну увагу на закони, правила, межі юрисдикції та особливі обставини (наприклад, податкові канікули та звільнення від сплати податків для продуктів). Компанії, які інтегруються з AvaTax, можуть контролювати розрахунки податків власними силами за допомогою цієї простої інтеграції API.

Важливо

В Odoo існують деякі обмеження під час використання AvaTax для розрахунку податків:

  • AvaTax не підтримується в додатку Odoo Точка продажу, оскільки динамічна модель розрахунку податку є надмірною для транзакцій в межах однієї адреси доставки, наприклад, магазинів чи ресторанів.

  • AvaTax та Odoo використовують адресу компанії, не адресу складу.

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

Перегляньте також

Допоміжні документи Avalara: Про AvaTax

Налаштування на AvaTax

Щоб користуватися AvaTax, для налаштування потрібен обліковий запис Avalara. Якщо він ще не налаштований, зв’яжіться з Avalara, щоб придбати ліцензію: Avalara: Давайте поговоримо.

Порада

Під час налаштування облікового запису зверніть увагу на AvaTax ID Обліковий запис. Він знадобиться в налаштуванні Odoo. В Odoo це число є API ID.

Потім створіть базовий профіль компанії.

Створіть базовий профіль компанії

Зберіть важливі дані про бізнес для наступного кроку: місця стягнення податків, товари/послуги, що продаються (та місця їх продажу), а також податкові пільги для клієнтів, якщо такі є. Дотримуйтесь документації Avalara для створення базового профілю компанії:

  1. Додайте інформацію про компанію.

  2. Повідомте нам, де компанія збирає та сплачує податки.

  3. Перевірте юрисдикції та активуйте компанію.

  4. Додайте інші місця розташування компанії для подання документації на основі місцезнаходження.

  5. Додайте торговельну площадку до профілю компанії.

Підключитися до AvaTax

Після створення базового профілю компанії в Avalara підключіться до AvaTax. Цей крок пов’язує Odoo та AvaTax у двох напрямках.

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

Увійдіть, щоб створити Ліцензійний ключ. Перейдіть до Налаштування ‣ Ліцензійні та API ключі. Натисніть Згенерувати ліцензійний ключ.

Важливо

З’являється попередження: Якщо ваш бізнес-додаток підключено до рішень Avalara, з’єднання буде розірвано, доки ви не оновите додаток новим ліцензійним ключем. Цю дію не можна скасувати.

Генерація нового ліцензійного ключа розриває зв’язок з існуючими бізнес-додатками, що використовують інтеграцію AvaTax. Обов’язково оновіть ці додатки новим ліцензійним ключем.

Якщо це буде перша інтеграція API з AvaTax та Odoo, тоді натисніть Згенерувати ліцензійний ключ.

Якщо це додатковий ліцензійний ключ, переконайтеся, що попереднє з’єднання можна розірвати. З кожним обліковим записом Avalara (пісочниця, робочий обліковий запис) пов’язано лише один ліцензійний ключ.

Попередження

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

Конфігурація Odoo

Перш ніж використовувати AvaTax, в Odoo є деякі додаткові налаштування, щоб забезпечити точні розрахунки податків.

Перевірте, чи база даних Odoo містить необхідні дані. Країна, початково вказана в базі даних, визначає фінансову позицію та допомагає AvaTax у розрахунку точних податкових ставок.

Фіскальна країна

Щоб встановити Фіскальна країна, перейдіть до Бухгалтерський облік ‣ Конфігурація ‣ Налаштування.

Перегляньте також

Фіскальні локалізації

У розділі Податки встановіть для параметра Фінансова країна значення Сполучені Штати, Канада або Бразилія. Потім натисніть Зберегти.

Налаштування компанії

Усі компанії, що працюють у базі даних Odoo, повинні мати повну та вичерпну адресу, зазначену в налаштуваннях. Перейдіть до Налаштування додатку та в розділі Компанії переконайтеся, що базою даних Odoo керує лише одна компанія. Натисніть Оновити інформацію, щоб відкрити окрему сторінку для оновлення даних компанії.

Якщо в базі даних працює кілька компаній, натисніть Керування компаніями, щоб завантажити список компаній для вибору. Оновіть інформацію про компанію, натиснувши на конкретну компанію.

Адміністратори баз даних повинні переконатися, що Вулиця…, Вулиця2…, Місто, Область, Поштовий індекс та Країна оновлені для всіх компаній.

Це забезпечує точні розрахунки податків та безперебійне ведення бухгалтерського обліку наприкінці року.

Перегляньте також

Встановлення модуля

Далі переконайтеся, що модуль Odoo AvaTax встановлено. Для цього перейдіть до додатку Додатки. У рядку Пошук… введіть avatax і натисніть Enter. З’являться такі результати:

Ім’я

Технічна назва

Опис

Avatax

account_avatax

Стандартний модуль AvaTax. Цей модуль додає базові функції AvaTax для розрахунку податків.

Avatax для геолокалізації

account_avatax_geolocalize

Цей модуль містить функції, необхідні для інтеграції AvaTax у геолокалізацію в Odoo.

Avatax для SO

account_avatax_sale

Включає інформацію, необхідну для розрахунку податку на замовлення на продаж в Odoo.

Avatax для інвентаризації

account_avatax_stock

Включає розрахунок податку в Odoo Інвентаризація.

Amazon/Avatax Bridge

sale_amazon_avatax

Включає функції розрахунку податків між Amazon Connector та Odoo.

Avatax Brazil

l10n_br_avatax

Містить інформацію для розрахунку податку в локалізації для Бразилії.

Avatax Brazil для Послуг

l10n_br_avatax_services

Цей модуль містить необхідні функції для розрахунку податку на послуги в локалізації Бразилії.

Avatax Brazil Sale для Послуг

l10n_br_edi_sale_services

Цей модуль містить необхідні функції для розрахунку податку на продаж послуг у бразильській локалізації. Це включає електронний обмін даними (EDI).

Тестові SO для Brazilian AvaTax

l10n_br_test_avatax_sale

Цей модуль містить необхідні функції для тестових замовлень на продаж у локалізації Бразилії.

Натисніть кнопку Встановити на модулі з позначкою Avatax: account_avatax. Це встановить такі модулі:

  • Avatax: account_avatax

  • Avatax для SO: account_avatax_sale

  • Avatax для Інвентаризації: account_avatax_stock

Якщо AvaTax потрібен для геолокалізації або за допомогою Amazon Connector, встановіть ці модулі окремо, натиснувши Встановити на Avatax для геолокалізації та Amazon/Avatax Bridge відповідно.

Перегляньте також

Щоб ознайомитися з інструкціями щодо локалізації AvaTax, перегляньте наступну документацію фіскальна локалізація:

Налаштування Odoo AvaTax

Щоб інтегрувати AVATax API з Odoo, перейдіть до розділу Бухгалтерський облік ‣ Конфігурація ‣ Налаштування. Поля AvaTax у розділі Податки – це місця, де налаштовуються AvaTax та вводяться облікові дані.

Спочатку поставте позначку ліворуч від налаштувань AvaTax, щоб активувати AvaTax у базі даних. Це швидкий та зручний спосіб активувати та деактивувати розрахунок податку AvaTax у базі даних Odoo.

Налаштування параметрів AvaTax

Передумови

Спочатку виберіть Середовище, у якому компанія бажає використовувати AvaTax. Це може бути Пісочниця або Продукція.

Перегляньте також

Щоб отримати допомогу у визначенні середовища AvaTax (Виробництво або Sandbox), Пісочниця: Пісочниця проти виробничих середовищ.

Облікові дані

Тепер можна ввести облікові дані. AvaTax Account ID слід ввести в поле API ID, а Ліцензійний ключ слід ввести в поле Ключ API.

Важливо

Ідентифікатор облікового запису Account ID можна знайти, увійшовши на портал AvaTax (пісочниця або виробництво). У верхньому правому куті натисніть на ініціали користувача та Обліковий запис. Account ID буде вказано першим.

Щоб отримати доступ до Ліцензійний ключ, див. цю документацію: Підключитися до AvaTax.

У полі Код компанії введіть код компанії Avalara, яку потрібно налаштувати. Avalara інтерпретує його як ЗА ЗАМОВЧАННЯМ, якщо його не встановлено. Код компанії можна отримати на порталі керування Avalara.

Спочатку увійдіть на портал AvaTax (пісочниця або виробництво). Потім перейдіть до Налаштування ‣ Керування компаніями. Значення Код компанії знаходиться в рядку Компанії у стовпці Код компанії.

Код компанії AvaTax виділено на сторінці з інформацією про компанію.

Варіанти транзакцій

У налаштуваннях Odoo AvaTax є два параметри транзакцій, які можна налаштувати: Використовувати UPC та Фіксувати транзакції.

Якщо прапорець поруч із Використовувати UPC встановлено, у транзакціях використовуватимуться універсальні коди товарів (UPC) замість спеціально визначених кодів в Avalara. Зверніться до сертифікованого бухгалтера (CPA) для отримання конкретних інструкцій.

Якщо прапорець Зафіксувати транзакції встановлено, то транзакції в базі даних Odoo будуть зафіксовані для звітності в AvaTax.

Перевірка адреси

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

Важливо

Функція Перевірка адреси працює лише з партнерами/клієнтами в Північній Америці.

Крім того, поставте позначку поруч із полем Перевірка адреси.

Важливо

Для точного розрахунку податків найкраще вводити повну адресу контактів, збережених у базі даних. Однак AvaTax все ще може функціонувати, доклавши максимум зусиль, використовуючи лише Країна, Область та Поштовий індекс. Це три мінімальні обов’язкові поля.

Зберегти налаштування для застосування конфігурації.

Порада

Вручну Перевірте адресу, перейшовши до Контакти та вибравши контакт. Тепер, коли модуль AvaTax налаштовано в базі даних, кнопка Перевірити з’явиться безпосередньо під Адреса.

Натисніть Перевірити, і з’явиться спливаюче вікно зі списком Перевірена адреса та Початкова адреса. Якщо Перевірена адреса є правильною поштовою адресою для цілей оподаткування, натисніть Зберегти перевірені.

Спливаюче вікно перевірки адреси в Odoo з кнопкою "Зберегти перевірену" та виділеним пунктом "Перевірена адреса".

Попередження

Усі раніше введені адреси контактів у базі даних Odoo потрібно буде перевірити вручну, використовуючи описаний вище процес перевірки. Адреси не перевіряються автоматично, якщо їх було введено раніше. Це відбувається лише під час розрахунку податку.

Тестувати з’єднання

Після введення всієї вищезазначеної інформації в налаштування AvaTax на Odoo, натисніть Тестувати з’єднання. Це гарантує, що API ID та API KEY правильні, і що між Odoo та інтерфейсом прикладного програмування (API) AvaTax встановлено з’єднання.

Параметри синхронізації

Після завершення налаштування розділу AvaTax натисніть кнопку Синхронізувати параметри. Ця дія синхронізує коди звільнення від сплати податків з AvaTax.

План рахунків

Далі перейдіть до Бухгалтерський облік ‣ Конфігурація ‣ Бухгалтерський облік: Фіскальні позиції. Фіскальна позиція вказана під назвою Автоматичне податкове зіставлення (AvaTax). Натисніть на неї, щоб відкрити сторінку конфігурації фіскальної позиції AvaTax.

Тут переконайтеся, що прапорець Використовувати AvaTax API встановлено.

За бажанням, поставте прапорець поруч із полем з написом: Виявляти автоматично. Якщо цей параметр позначено, Odoo автоматично застосовуватиме це Фіскальна позиція для транзакцій в Odoo.

Увімкнення Виявляти автоматично також призводить до появи певних параметрів, таких як Іноземний ID податку, Ідентифікаційний номер іноземного податкового платника, Група країн, Країна, Федеральні штати або Діапазон поштових індексів. Заповнення цих параметрів фільтрує використання Фіскальна позиція. Якщо залишити їх порожніми, усі розрахунки будуть виконані з використанням Фіскальна позиція.

Попередження

Якщо прапорець Виявляти автоматично не встановлено, кожному клієнту потрібно буде встановити Фіскальна позиція на вкладці Продажі та закупівлі запису контакту. Щоб це зробити, перейдіть до Продаж» ‣ Замовлення ‣ Клієнти або Контакти ‣ Контакти. Потім виберіть клієнта або контакт, для якого потрібно встановити фінансову позицію.

Перейдіть на вкладку Продажі та покупки та перейдіть до розділу з назвою Фіскальна позиція. Встановіть у полі Фіскальна позиція фіскальну позицію для клієнта.

Облікові дані AvaTax

Після встановлення прапорця Використовувати AvaTax API з’явиться нова вкладка AvaTax. Натисніть на цю вкладку, щоб відобразити два різні налаштування.

Перший параметр - це Інвойс рахунків AvaTax, а другий - Рахунок повернення коштів AvaTax. Переконайтеся, що обидва облікові записи налаштовано для безперебійного ведення обліку наприкінці року. Зверніться до сертифікованого бухгалтера (CPA) для отримання конкретних інструкцій щодо налаштування обох облікових записів.

Натисніть Зберегти, щоб застосувати зміни.

Зіставлення податків

Інтеграція AvaTax доступна для замовлень на продаж та рахунків із включеною фіскальною позицією AvaTax.

Порада

Крім того, у фіскальній позиції Автоматичне податкове зіставлення (AvaTax) є вкладки Зіставлення рахунків та Зіставлення податків, де також можна налаштувати зіставлення для продуктів. Щоб отримати доступ до Фіскальні позиції, перейдіть до Бухгалтерський облік ‣ Налаштування ‣ Бухгалтерський облік: Фіскальні позиції.

Картування категорій продуктів

Перш ніж використовувати інтеграцію, вкажіть Категорія Avatax для категорій продуктів. Перейдіть до Інвентаризація ‣ Конфігурація ‣ Категорії продуктів. Виберіть категорію продукту, до якої потрібно додати Категорія AvaTax. У полі Категорія AvaTax виберіть категорію з випадаючого меню або Пошук ще…, щоб відкрити повний список опцій.

Вкажіть категорію AvaTax для товарів.

Зіставлення продукту

Категорії AvaTax також можна встановлювати для окремих продуктів. Щоб встановити Категорія Avatax, перейдіть до Інвентаризація ‣ Продукти ‣ Продукти. Виберіть продукт, до якого потрібно додати Категорія Avatax. На вкладці Загальна інформація, у крайньому правому куті, є поле вибору з позначкою: Категорія Avatax. Нарешті, натисніть спадне меню та виберіть категорію або Шукати більше…, щоб знайти ту, якої немає у списку.

Примітка

Якщо і для продукту, і для його категорії встановлено Категорія AvaTax, пріоритет має Категорія AvaTax продукту.

За потреби перевизначте категорії товарів.

Важливо

Зіставлення категорії Категорія AvaTax з Продукт або Категорія продукту слід виконати для кожного Продукту або Категорії продукту, залежно від обраного маршруту.