Integrarea AvaTax

AvaTax de la Avalara este un software fiscal bazat pe cloud. Integrarea AvaTax cu Odoo oferă calcule de taxe în timp real și specifice regiunii atunci când utilizatorii vând, cumpără și facturează articole în Odoo. Calculul taxelor AvaTax este acceptat cu fiecare țară înscrisă în cartograful Națiunilor Unite, inclusiv tranzacțiile inter frontaliere.

Important

AvaTax este disponibil numai pentru integrare cu baze de date/companii care au locații în Statele Unite, Canada și Brazilia. Aceasta înseamnă că poziția fiscală/țara unei baze de date poate fi setată numai în Statele Unite, Canada sau Brazilia. Pentru mai multe informații, consultați această documentație: Țara fiscală.

AvaTax reprezintă cotele de impozitare bazate pe locație pentru fiecare stat, județ și oraș. Îmbunătățește acuratețea remitențelor, acordând o atenție deosebită legilor, regulilor, limitelor jurisdicțiilor și circumstanțelor speciale (cum ar fi concediile fiscale și scutirile de produse). Companiile care se integrează cu AvaTax pot menține controlul intern asupra calculelor fiscale cu această integrare simplă API.

Important

Some limitations exist in Odoo while using AvaTax for tax calculation:

  • AvaTax is not supported in Odoo’s Point of Sale app, because a dynamic tax calculation model is excessive for transactions within a single delivery address, such as stores or restaurants.

  • AvaTax and Odoo use the company address, not the warehouse address.

  • Excise tax is not supported. This includes tobacco/vape taxes, fuel taxes, and other specific industries.

Vedeți și

Avalara’s support documents: About AvaTax

Configurați pe AvaTax

Pentru a utiliza AvaTax, este necesar un cont la Avalara pentru configurare. Dacă nu a fost încă configurat unul, conectați-vă cu Avalara pentru a achiziționa o licență: Avalara: Let’s Talk.

Sfat

La configurarea contului, luați notă de AvaTax ID-ul contului. Acest lucru va fi necesar în Configurarea Odoo. În Odoo, acest număr este ID API.

Then, create a basic company profile.

Creați un profil de bază al companiei

Colectați detalii comerciale esențiale pentru următorul pas: locații în care se colectează taxele, produsele/serviciile vândute (și locațiile lor de vânzare) și scutiri de taxe pentru clienți, dacă este cazul. Urmați documentația Avalara pentru a crea un profil de bază al companiei:

  1. Add company information.

  2. Tell us where the company collects and pays tax.

  3. Verify jurisdictions and activate the company.

  4. Add other company locations for location-based filing.

  5. Add a marketplace to the company profile.

Conectați-vă la AvaTax

După ce ați creat profilul de bază al companiei în Avalara, conectați-vă la AvaTax. Acest pas leagă Odoo și AvaTax bidirecțional.

Navigați la mediul sandbox sau producție al Avalara. Acest lucru va depinde de tipul de cont Avalara pe care compania ar dori să îl integreze.

Conectați-vă pentru a crea Cheia de licență. Accesați Setări ‣ Chei de licență și API. Faceți clic pe Generați cheia de licență.

Important

Apare un avertisment care spune: Dacă aplicația dvs. de afaceri este conectată la soluțiile Avalara, conexiunea va fi întreruptă până când actualizați aplicația cu noua cheie de licență. Această acțiune nu poate fi anulată.

Generarea unei noi chei de licență întrerupe conexiunea cu aplicațiile de afaceri existente folosind integrarea AvaTax. Asigurați-vă că actualizați aceste aplicații cu noua cheie de licență.

Dacă aceasta va fi prima integrare API cu AvaTax și Odoo, atunci faceți clic pe Generați cheia de licență.

Dacă aceasta este o cheie de licență suplimentară, asigurați-vă că conexiunea anterioară poate fi întreruptă. Există doar o cheie de licență asociată cu fiecare dintre conturile de producție și sandbox Avalara.

Atenționare

Copy this key to a safe place. It is strongly encouraged to back up the license key for future reference. This key cannot be retrieved after leaving this screen.

Configurație Odoo

Înainte de a utiliza AvaTax, există câteva configurații suplimentare în Odoo pentru a vă asigura că calculele taxelor sunt efectuate cu acuratețe.

Verificați dacă baza de date Odoo conține datele necesare. Țara configurată inițial în baza de date determină poziția fiscală și ajută AvaTax în calcularea cotelor de impozitare precise.

Țara fiscală

Pentru a seta Țara fiscală, navigați la Aplicația de contabilitate ‣ Configurare ‣ Setări.

Vedeți și

Localizări fiscale

În secțiunea Taxes, setați caracteristica Fiscal Country la Statele Unite, Canada sau Brazilia. Apoi, faceți clic pe Salvați.

Setările companiei

Toate companiile care operează în baza de date Odoo ar trebui să aibă o adresă completă și completă listată în setări. Navigați la Aplicația Setări, iar în secțiunea Companii, asigurați-vă că există o singură companie care operează baza de date Odoo. Faceți clic pe Actualizare informații pentru a deschide o pagină separată pentru a actualiza detaliile companiei.

Dacă există mai multe companii care operează în baza de date, faceți clic pe Manage Companies pentru a încărca o listă de companii din care să selectați. Actualizați informațiile despre companie făcând clic pe respectiva companie.

Administratorii bazei de date trebuie să se asigure că Street…, Street2…, City, State, ZIP și :guilabel :Țara sunt toate actualizate pentru companii.

Acest lucru asigură calcule precise ale impozitelor și operațiuni contabile de sfârșit de an fără probleme.

Vedeți și

Instalarea modulului

Apoi, asigurați-vă că este instalat modulul Odoo AvaTax. Pentru a face acest lucru, navigați la aplicația Apps. În bara Search…, tastați avatax și apăsați Enter. Următoarele rezultate populează:

Nume

Nume tehnic

Descriere

Avatax

cont_avatax

Modul implicit AvaTax. Acest modul adaugă funcțiile de bază AvaTax pentru calcularea taxelor.

Avatax pentru localizare geografică

cont_avatax_geolocalizare

Acest modul include caracteristicile necesare pentru integrarea AvaTax în geo-localizare în Odoo.

Avatax for SO

cont_avatax_vânzare

Include informațiile necesare pentru calcularea taxelor pe comenzile de vânzare în Odoo.

Avatax pentru inventar

cont_avatax_stoc

Include calculul taxelor în inventarul Odoo.

Amazon/Avatax Bridge

vânzare_amazon_avatax

Include funcții de calcul a taxelor între Amazon Connector și Odoo.

Avatax Brazilia

l10n_br_avatax

Include informații pentru calcularea taxelor în localizarea Braziliei.

Avatax Brazilia pentru servicii

l10n_br avatax servicii

Acest modul include caracteristicile necesare pentru calcularea taxelor pentru servicii în localizarea Braziliei.

Vânzare pentru servicii Avatax Brazilia

l10n_br_edi_vânzare_servicii

Acest modul include caracteristicile necesare pentru calcularea taxelor pentru vânzarea de servicii în localizarea Braziliei. Aceasta include schimbul electronic de date (EDI).

Testați SO pentru AvaTax brazilian

l10n_br_test_avatax_vânzare

Acest modul include caracteristicile necesare pentru comenzile de vânzări de testare în localizarea Braziliei.

Faceți clic pe butonul Instalare de pe modulul etichetat, Avatax: account_avatax. Procedând astfel, se instalează următoarele module:

  • Avatax: cont_avatax

  • Avatax for SO: cont_avatax_vanzare

  • Avatax pentru inventar: cont_avatax_stoc

Dacă AvaTax este necesar pentru geo-localizare sau cu Amazon Connector, apoi instalați acele module individual făcând clic pe Instalare pe Avatax pentru geolocalizare și Amazon/ Avatax Bridge, respectiv.

Vedeți și

Pentru instrucțiuni specifice AvaTax pentru localizare, consultați următoarea documentație localizare fiscală:

Setări Odoo AvaTax

Pentru a integra AvaTax API cu Odoo, accesați secțiunea Aplicația de contabilitate ‣ Configurare ‣ Setări. Câmpurile AvaTax din secțiunea Taxes este locul în care sunt realizate configurațiile AvaTax și sunt introduse acreditările.

Mai întâi, bifați caseta de selectare din stânga setărilor AvaTax, pentru a activa AvaTax în baza de date. Aceasta este o modalitate rapidă și convenabilă de a activa și dezactiva calculul taxelor AvaTax în baza de date Odoo.

Configurați setările AvaTax

Cerințe

Configurați setările AvaTax`.

Vedeți și

Pentru ajutor pentru a determina ce mediu AvaTax să utilizați (fie Production sau Sandbox), vizitați: Sandbox vs Medii de producție.

Credențiale

Acum, acreditările pot fi introduse. AvaTax Account ID trebuie introdus în câmpul API ID, iar License Key trebuie introdus în :guilabel Câmpul :API Key.

Important

Account ID poate fi găsit conectându-vă la portalul AvaTax (sandbox sau production). În colțul din dreapta sus, faceți clic pe inițialele utilizatorului și pe Cont. ID-ul contului este afișat primul.

Pentru a accesa Cheia de licență consultați această documentație: Conectați-vă la AvaTax.

Pentru câmpul Cod companie, introduceți codul companiei Avalara pentru compania care se configurează. Avalara interpretează acest lucru ca DEFAULT, dacă nu este setat. Codul companiei poate fi accesat în portalul de management Avalara.

Mai întâi, conectați-vă la portalul AvaTax (sandbox sau production). Apoi, navigați la Settings ‣ Manage Companies. Valoarea Codul companiei este situată pe rândul Compania din coloana Codul companiei.

Codul companiei AvaTax evidențiat pe pagina cu detaliile companiei.

Opțiuni de tranzacție

Există două setări tranzacționale în setările Odoo AvaTax care pot fi configurate: Utilizați UPC și Commit Transactions.

Dacă caseta de selectare de lângă Utilizați UPC este bifată, tranzacțiile vor folosi coduri universale de produs (UPC), în loc de coduri personalizate definite în Avalara. Consultați un contabil public certificat (CPA) pentru îndrumări specifice.

În cazul în care caseta de selectare Commit Transactions este bifată, atunci tranzacțiile din baza de date Odoo vor fi comise pentru raportare în AvaTax.

Validarea adresei

Caracteristica Validare adresă asigură că cea mai actualizată adresă conform standardelor poștale este setată pentru o persoană de contact în Odoo. Acest lucru este important pentru a oferi clienților calcule precise ale taxelor.

Important

Funcția Validarea adresei funcționează numai cu parteneri/clienți din America de Nord.

În plus, bifați caseta de selectare de lângă câmpul Validare adresă.

Important

Pentru calcule precise ale taxelor, este cea mai bună practică să introduceți o adresă completă pentru contactele salvate în baza de date. Cu toate acestea, AvaTax poate funcționa în continuare prin implementarea unei încercări maxime folosind numai Țară, State și Cod poștal. Acestea sunt cele trei câmpuri minime obligatorii.

Salvați setările pentru a implementa configurația.

Sfat

Manual Validați adresa navigând la aplicația Contacte și selectând un contact. Acum că modulul AvaTax a fost configurat în baza de date, un buton Validare apare direct sub Adresă.

Faceți clic pe Validați și va apărea o fereastră pop-up cu Adresă validată și Adresa originală. Dacă Adresa validată este adresa de corespondență corectă în scopuri fiscale, faceți clic pe Salvați validată.

Validați fereastra pop-up adresa în Odoo cu butonul „Salvați validat” și „Validat”. Adresă” evidențiată.

Atenționare

Toate adresele introduse anterior pentru contacte în baza de date Odoo vor trebui validate utilizând procesul de validare manuală descris mai sus. Adresele nu sunt validate automat dacă au fost introduse anterior. Acest lucru se întâmplă doar la calculul impozitului.

Test de conexiune

După ce ați introdus toate informațiile de mai sus în configurarea AvaTax pe Odoo, faceți clic pe Testează conexiunea. Acest lucru asigură că API ID și API KEY sunt corecte și se realizează o conexiune între Odoo și interfața de programare a aplicației (API) AvaTax.

Parametrii de sincronizare

După ce ați terminat configurarea și setările secțiunii AvaTax, faceți clic pe butonul Parametrii de sincronizare. Această acțiune sincronizează codurile de scutire de la AvaTax.

Poziție fiscală

Apoi, navigați la Aplicația de contabilitate ‣ Configurare ‣ Contabilitate: Poziții fiscale. O Poziție fiscală este listată cu numele, Mapping automat al taxelor (AvaTax). Faceți clic pe acesta pentru a deschide pagina de configurare a poziției fiscale a AvaTax.

Aici, asigurați-vă că caseta de selectare Use AvaTax API este bifată.

Opțional, bifați caseta de selectare de lângă câmpul etichetat: Detectare automată. Dacă această opțiune este bifată, atunci Odoo va aplica automat această Poziție fiscală pentru tranzacțiile în Odoo.

Activarea Detectează automat face, de asemenea, parametri specifici, cum ar fi TVA obligatoriu, Cod fiscal străin, Grup de țări, Țara, :guilabel: Apare State federale sau Interval Zip. Completarea acestor parametri filtrează utilizarea Poziția fiscală. Lăsându-le necompletate asigură că toate calculele sunt făcute folosind această Poziție fiscală.

Atenționare

În cazul în care caseta de selectare Detectează automat nu este bifată, fiecare client va trebui să aibă setată Poziția fiscală în fila lui Vânzări și achiziții din înregistrarea contactului. Pentru a face acest lucru, navigați la Aplicația de vânzări ‣ Comandă ‣ Clienți sau Aplicația Contacte ‣ Contacte. Apoi, selectați un client sau un contact pentru a seta poziția fiscală.

Navigați la fila Vânzări și achiziții și în jos la secțiunea etichetată, Poziție fiscală. Setați câmpul Poziție fiscală la poziția fiscală pentru client.

Vedeți și

poziții_fiscale

Conturi AvaTax

După selectarea casetei de selectare pentru Utilizați API-ul AvaTax, apare o nouă filă AvaTax. Faceți clic pe această filă pentru a dezvălui două setări diferite.

Prima setare este Cont de factură AvaTax, în timp ce a doua este, Cont de rambursare AvaTax. Asigurați-vă că ambele conturi sunt setate pentru păstrarea fără probleme la sfârșitul anului. Consultați un contabil public certificat (CPA) pentru îndrumări specifice privind setarea ambelor conturi.

Faceți clic pe Salvați pentru a implementa modificările.

Cartografiere fiscală

Integrarea AvaTax este disponibilă pe comenzile de vânzare și facturile cu poziția fiscală AvaTax inclusă.

Sfat

În plus, există o filă Mapping Tax și fila Mapping Account în poziția fiscală Automatic Tax Mapping (AvaTax), unde poate fi configurată și maparea pentru produse. Pentru a accesa Poziții fiscale, navigați la Aplicația de contabilitate ‣ Configurare ‣ Contabilitate: Poziții fiscale.

Maparea categoriilor de produse

Înainte de a utiliza integrarea, specificați o Categorie Avatax pe categoriile de produse. Navigați la Inventory app ‣ Configuration ‣ Product Categories. Selectați categoria de produs la care să adăugați Categoria AvaTax. În câmpul Categorie AvaTax, selectați o categorie din meniul derulant sau Căutați mai multe… pentru a deschide lista completă de opțiuni.

Specificați categoria AvaTax pe produse.

Maparea produselor

Categoriile AvaTax pot fi setate și pentru produse individuale. Pentru a seta Categoria Avatax, navigați la Aplicația de inventar ‣ Produse ‣ Produse. Selectați produsul la care să adăugați Categoria Avatax. Sub fila Informații generale, în extrema dreaptă, se află un câmp selector etichetat: Categoria avatax. În cele din urmă, faceți clic pe meniul derulant și selectați o categorie sau Căutați mai multe… pentru a găsi una care nu este listată.

Notă

Dacă atât produsul, cât și categoria acestuia, au un set Categoria AvaTax, Categoria AvaTax a produsului are prioritate.

Ignorați categoriile de produse după cum este necesar.

Important

Mapping an AvaTax Category on either the Product or Product Category should be completed for every Product or Product Category, depending on the route that is chosen.

Vedeți și