Emiterea de documente prin API

Daca folosesti API SmartBill pentru emiterea de documente, este important sa verifici dupa 1 august 2025 daca ai implementat corect modificarile privind cotele noi de TVA.

Ce trebuie sa stii?

• La emiterea documentelor prin API, se folosesc cotele de TVA specificate in request.
• Detalii tehnice despre cum definesti corect cota TVA gasesti pe🔗 API - Folosirea cotelor TVA.
• Noile cote TVA (21% si 11%) sunt deja disponibile in contul tau din SmartBill si pot fi folosite si prin API.

• Cand emiti o factura pe baza unei proforme, cota de TVA si preturile sunt preluate de pe proforma.
• Daca proforma a fost emisa cu o cota veche de TVA, si factura va prelua acea cota, chiar daca este emisa dupa 1 august 2025.

Daca vrei sa emiti o factura cu TVA nou (21% sau 11%) pe baza unei proforme emise cu cota de TVA veche, poti folosi endpoint:

🔗 URL: https://ws.smartbill.ro/SBORO/api/invoice/changeCurrentTaxPercentage

🔧 Metoda: POST

Exemplu de request JSON:

{
  "companyVatCode": "RO12345678",
  "isDraft": false,
  "issueDate": "2025-08-01",
  "dueDate": "2025-08-15",
  "seriesName": "fpub",
  "useStock": false,
  "useEstimateDetails": true,
  "estimate": {
    "seriesName": "ppub1",
    "number": "0021"
  },
  "keepPricesUnchanged": true
}

Foloseste parametrul nou keepPricesUnchanged doar daca doresti ca sa stabilesti modul in care se modifica preturile astfel:

• true - pretul final cu TVA ramane neschimbat
• false - pretul final cu TVA se modifica proportional cu cota de TVA
• implicit (nu exista in request) - se pastreaza preturile de pe proforma astfel
  • pentru cazul in care pretul pe produs nu include TVA se pastreaza pretul fara TVA neschimbat
  • pentru cazul in care pretul pe produs include TVA se pastreaza pretul cu TVA neshimbat