SMsmartbill
Cote TVA

Listare cote TVA

Changed on

Returneaza cotele de TVA din nomenclatorul tau SmartBill.

Relatia cu V1

Este acelasi nomenclator ca Cote TVA din V1: name si percentage au aceleasi valori. Aici primesti in plus id, isReverseCharge si reverseChargePercentage.

Ce trimiti mai departe depinde de document. Facturile, proformele si incasarile V1 primesc taxName si taxPercentage. NIR-urile V3 identifica cota prin id. Endpointul acesta acopera ambele cazuri; /tax doar pe primul.

Id-uri

Cotele nu pot fi modificate din SmartBill Cloud, doar create si sterse, deci un id pastreaza acelasi name si acelasi percentage cat timp exista. O schimbare de procent inseamna o cota noua, cu id nou. O cota stearsa dispare imediat din listare, iar GET .../{id} intoarce 404 vat_rate_not_found - trateaza situatia ca normala, nu ca eroare de integrare. Id-urile sunt per firma: un id valid pe o firma intoarce 404 pe alta.

Taxare inversa

Cotele cu taxare inversa au isReverseCharge true si percentage 0, iar procentul lor de referinta se afla in reverseChargePercentage. Filtrul percentage se aplica doar campului percentage, deci ?percentage=21 nu returneaza o cota cu taxare inversa al carei reverseChargePercentage este 21. Toate cotele cu taxare inversa apar la ?percentage=0.

Filtrare

name potriveste oriunde in nume, nu doar la inceput: ?name=norm gaseste si Normala, si Normala2. Potrivirea ignora literele mari si spatiile de la capetele valorii trimise. percentage potriveste exact valoarea, deci ?percentage=21, ?percentage=21.0 si ?percentage=21.0000 dau acelasi rezultat, iar ?percentage=2 nu gaseste cota de 21%. Un filtru trimis gol (?name= sau ?percentage=) e ignorat, deci primesti lista nefiltrata. Trimise impreuna, cele doua filtre se aplica simultan.

get/v3/companies/{cif}/vat-rates

Request

Path parameters

cifstring required

CIF-ul firmei tale, fara spatii.

Query parameters

namestring

Filtreaza dupa nume (potrivire partiala, case-insensitive)

percentagenumber

Filtreaza dupa procent (potrivire exacta pe valoare)

limitinteger

Numar maxim de rezultate returnate (intre 1 si 100)

afterstring

Cursor pentru pagina urmatoare, id-ul cotei dupa care se continua. Nu se foloseste impreuna cu 'before'.

beforestring

Cursor pentru pagina anterioara, id-ul cotei inainte de care se continua. Nu se foloseste impreuna cu 'after'.

Response

Lista cote TVA paginata (paginare cursor)

Example response

{
  "items": [
    {
      "id": "vat_01a0aaabdf4374d9ae834e01ea5c26c6",
      "name": "Normala",
      "percentage": 21
    }
  ]
}

Changes