NIR-uri (Beta)

Emitere NIR

Changed on Oct 10, 2026

Emite o Nota de Intrare Receptie (NIR) pe baza documentului primit de la furnizor.

⚠️ Deocamdata NIR-ul se emite doar ca ciorna. Se trimite status: "draft"; orice alta valoare este respinsa. NIR-ul ramane ciorna, fara numar alocat, pana la finalizarea din SmartBill Cloud. Emiterea directa a unui NIR finalizat va fi adaugata ulterior.

ℹ️ Deocamdata emiterea NIR-urilor prin API nu consuma din numarul de documente inclus in abonament. In curand, fiecare NIR emis prin API, inclusiv ciornele, va fi luat in calcul.

Drepturi necesare

Drepturile utilizatorului caruia ii apartine cheia API se seteaza din meniul Utilizatori in SmartBill Cloud, pe una din cele doua variante:

<details> <summary>Drepturi simple (varianta Simplu)</summary> <table class="sb-op-table"> <thead> <tr> <th>Drept</th> <th>Ce acopera</th> </tr> </thead> <tbody> <tr> <td>Emitere</td> <td>Emiterea NIR-ului si adaugarea produselor in nomenclator</td> </tr> </tbody> </table> </details> <details> <summary>Drepturi avansate (varianta Detaliat)</summary> <table class="sb-op-table"> <thead> <tr> <th>Sectiune</th> <th>Drept</th> </tr> </thead> <tbody> <tr> <td>Acces aplicatii</td> <td>API / Magazin online</td> </tr> <tr> <td>Generale</td> <td>Are acces la gestiune, cu bifa pe fiecare gestiune folosita in <code>destinationWarehouseId</code></td> </tr> <tr> <td>Generale</td> <td>Are acces la documente din trecut / din viitor - <code>issueDate</code> trebuie sa se incadreze in limitele setate pentru utilizator</td> </tr> <tr> <td>Generale</td> <td>Poate schimba preturile de vanzare - necesar la orice emitere, inclusiv ciorne, indiferent de tipul gestiunii sau de pretul de vanzare trimis</td> </tr> <tr> <td>Documente → Receptii</td> <td>Emitere si Vizualizare, plus seria NIR in Acces la seriile</td> </tr> <tr> <td>Nomenclatoare → Produse</td> <td>Adaugare si Editare/stergere - necesare si cand toate produsele exista deja in nomenclator</td> </tr> <tr> <td>Nomenclatoare → Furnizori</td> <td>Vizualizare</td> </tr> </tbody> </table> </details>

Firma trebuie sa aiba si modulul de gestiune activ. Fara un drept necesar, fara acces la serie sau la o gestiune ori cu o data in afara limitelor utilizatorului, raspunsul este 403 insufficient_permissions, iar NIR-ul nu se creeaza; mesajul nu spune care drept lipseste.

ID-uri necesare

Pentru emiterea NIR-ului se trimit ID-ul furnizorului, ID-ul gestiunii si ID-urile cotelor de TVA. Toate se obtin din API V3:

ID	Camp in cerere	Se obtine din
ID-ul furnizorului	supplierId	Listare furnizori
ID-ul gestiunii	products[].destinationWarehouseId	Listare gestiuni
ID-urile cotelor de TVA	products[].purchaseVatRateId, products[].sellingVatRateId	Listare cote TVA

Moneda si cursul de schimb

currency este moneda documentului furnizorului, de exemplu EUR. Daca lipseste, se foloseste RON.
Campurile care se termina in InDocumentCurrency sunt in moneda din currency.
Campurile care se termina in InRON sunt mereu in lei.
exchangeRate arata cati lei valoreaza 1 unitate din currency. Este obligatoriu pentru alte monede decat RON. Pentru RON se omite sau se trimite 1.

Exemplu: factura furnizorului este in euro, iar cursul este 5 lei pentru 1 euro.

Se trimite	Rezultat
currency: "EUR", exchangeRate: 5	NIR-ul este in euro, la cursul de 5 lei
purchasePriceWithoutVatInDocumentCurrency: 100	100 EUR. Serverul calculeaza purchasePriceWithoutVatInRON: 500 (100 x 5)
sellingPriceWithoutVatInRON: 615	615 lei. Nu se converteste

Valori calculate

Se trimit preturile unitare fara TVA; raspunsul adauga preturile cu TVA, preturile de achizitie in RON si totalurile NIR-ului:

<table class="sb-op-table sb-op-table--calc"> <thead> <tr> <th>Camp din raspuns</th> <th>Cum se obtine</th> <th>Exemplu (10 buc x 100 EUR, curs 5, TVA 21%)</th> </tr> </thead> <tbody> <tr> <td><code>products[].purchasePriceWithoutVatInRON</code></td> <td>pret in <code>currency</code> x <code>exchangeRate</code></td> <td>100 x 5 = <code>500</code></td> </tr> <tr> <td><code>products[].purchasePriceWithVatInDocumentCurrency</code></td> <td>pret fara TVA + TVA de achizitie</td> <td><code>121</code></td> </tr> <tr> <td><code>products[].purchasePriceWithVatInRON</code></td> <td>pret cu TVA in RON</td> <td><code>605</code></td> </tr> <tr> <td><code>products[].sellingPriceWithVatInRON</code></td> <td>pret de vanzare + TVA de vanzare</td> <td>615 -> <code>744.15</code></td> </tr> <tr> <td><code>totalWithoutVatCalculatedInDocumentCurrency</code></td> <td>suma pe produse</td> <td>10 x 100 = <code>1000</code></td> </tr> <tr> <td><code>totalVatCalculatedInDocumentCurrency</code></td> <td>TVA pe produse</td> <td><code>210</code></td> </tr> <tr> <td><code>totalWithVatCalculatedInDocumentCurrency</code></td> <td>total cu TVA</td> <td><code>1210</code></td> </tr> </tbody> </table>

Erori la emiterea NIR-ului

Erorile de autentificare si autorizare sunt comune tuturor endpoint-urilor V3. Pentru cheia API, drepturi, abonament sau formatul corpului JSON, detalii in Erori API V3. Mai jos sunt doar erorile specifice emiterii NIR-ului.

<details> <summary>Structura cererii</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td>Corpul cererii este <code>null</code></td> <td><code>missing_required_field</code>The document is required.</td> <td>NIR-ul se trimite ca obiect JSON. Eroarea nu are <code>param</code>.</td> </tr> <tr> <td>Camp repetat in acelasi obiect JSON</td> <td><code>duplicate_field</code>Property 'products[0].receivedQuantity' must appear only once.</td> <td>Fiecare camp trebuie sa apara o singura data. Regula se aplica si campurilor necunoscute, chiar cu valori identice. <code>param</code> arata calea completa, de exemplu <code>acquisition.number</code>.</td> </tr> <tr> <td>Valoare de alt tip decat cel asteptat</td> <td><code>invalid_field_type</code>Invalid type for property: 'precision'.</td> <td>Valoarea trebuie sa aiba tipul din schema: de exemplu, un text in loc de numar e respins, iar <code>precision</code> trebuie sa fie numar intreg (<code>2</code>, nu <code>2.0</code>).</td> </tr> </tbody> </table> </details> <details> <summary>Date NIR si serie</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td><code>status</code> lipsa</td> <td><code>missing_required_field</code>The document status is required.</td> <td>Se trimite <code>status: "draft"</code>.</td> </tr> <tr> <td><code>status</code> diferit de <code>draft</code></td> <td><code>document_status_not_allowed</code>Invalid status. Allowed values: draft.</td> <td>Deocamdata NIR-ul se emite doar ca ciorna: se trimite <code>draft</code>, iar finalizarea se face din SmartBill Cloud.</td> </tr> <tr> <td><code>seriesName</code> lipsa</td> <td><code>missing_required_field</code>The document series name is required.</td> <td>Denumirea seriei de NIR este obligatorie.</td> </tr> <tr> <td><code>seriesName</code> cu peste 50 de caractere</td> <td><code>invalid_field_value</code>The series name cannot be longer than 50 characters.</td> <td>Denumirea seriei are maximum 50 de caractere.</td> </tr> <tr> <td>Serie inexistenta sau de alt tip</td> <td><code>invalid_field_value</code>The document series is not valid.</td> <td>Se trimite denumirea completa a unei serii de tip NIR din cont. Literele mari si mici nu conteaza.</td> </tr> <tr> <td><code>issueDate</code> lipsa</td> <td><code>missing_required_field</code>The document issue date is required.</td> <td>Data NIR-ului este obligatorie.</td> </tr> <tr> <td>Data in format gresit</td> <td><code>invalid_field_value</code>Invalid date format. Expected format: 'yyyy-MM-dd'.</td> <td><code>issueDate</code>, <code>acquisition.issueDate</code> si <code>acquisition.dueDate</code> se trimit in format <code>yyyy-MM-dd</code>, de exemplu <code>2026-10-01</code>.</td> </tr> <tr> <td>Data in afara intervalului 1970-01-01 – 9999-12-31</td> <td><code>invalid_field_value</code>The minimum issue date is '1970-01-01'.</td> <td>Datele acceptate sunt intre <code>1970-01-01</code> si <code>9999-12-31</code>, inclusiv. Pentru limita de sus mesajul este <code>The maximum issue date is '9999-12-31'.</code>; la documentul de achizitie mesajele numesc campul.</td> </tr> <tr> <td><code>precision</code> in afara intervalului</td> <td><code>invalid_field_value</code>The precision value must be between 2 and 4.</td> <td>Valori acceptate: <code>2</code>, <code>3</code> sau <code>4</code>. Daca lipseste, se foloseste <code>2</code>.</td> </tr> <tr> <td>Text prea lung in <code>mentions</code>, <code>observations</code> sau <code>committee</code></td> <td><code>invalid_field_value</code>The mentions cannot be longer than 500 characters.</td> <td>Maximum 500 de caractere pentru <code>mentions</code> si <code>observations</code>, 200 pentru <code>committee</code>. Se numara si spatiile de la capete. Mesajul numeste campul.</td> </tr> </tbody> </table> </details> <details> <summary>Moneda si curs</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td>Moneda inexistenta in firma</td> <td><code>invalid_field_value</code>The document currency is not valid.</td> <td>Se trimite simbolul unei monede disponibile firmei, de exemplu <code>RON</code> sau <code>EUR</code>.</td> </tr> <tr> <td>Simbolul monedei are peste 20 de caractere</td> <td><code>invalid_field_value</code>The currency symbol cannot be longer than 20 characters.</td> <td>Se trimite doar simbolul monedei.</td> </tr> <tr> <td>Moneda straina fara curs</td> <td><code>missing_required_field</code>The exchange rate is required for currencies other than RON.</td> <td>Se trimite <code>exchangeRate</code>: cati lei valoreaza o unitate din <code>currency</code>.</td> </tr> <tr> <td>RON cu un curs diferit de 1</td> <td><code>invalid_field_value</code>The document exchange rate must be 1 or missing when currency is RON.</td> <td>Pentru RON, <code>exchangeRate</code> se omite sau se trimite <code>1</code>.</td> </tr> <tr> <td>Curs zero sau negativ</td> <td><code>invalid_field_value</code>The exchange rate must be greater than zero.</td> <td>Cursul trebuie sa fie strict pozitiv.</td> </tr> <tr> <td>Curs cu prea multe cifre</td> <td><code>invalid_field_value</code>The exchange rate must have at most 6 decimal digits.</td> <td>Maximum 8 cifre in partea intreaga si 6 zecimale.</td> </tr> </tbody> </table> </details> <details> <summary>Furnizor si document de achizitie</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td><code>supplierId</code> lipsa</td> <td><code>missing_required_field</code>The supplier ID is required.</td> <td>Se trimite id-ul furnizorului, din <a href="#api-1/tag/furnizori">Furnizori</a>.</td> </tr> <tr> <td><code>supplierId</code> cu prefix sau format gresit</td> <td><code>invalid_field_value</code>The 'supplierId' field must start with 'sup_'.</td> <td>Id-ul se trimite integral, cu prefixul <code>sup_</code>.</td> </tr> <tr> <td>Furnizor inexistent in firma</td> <td><code>invalid_field_value</code>The supplier with ID 'sup_01a0ee341fb17d8da8df382a41dcebaf' was not found.</td> <td>Id-ul trebuie sa apartina firmei din URL. Un id al altei firme nu e gasit.</td> </tr> <tr> <td><code>acquisition</code> fara <code>type</code></td> <td><code>missing_required_field</code>The acquisition document type is required. Allowed values: 'Invoice', 'Delivery note', 'Fiscal receipt', 'Sales booklet'.</td> <td>Se completeaza <code>acquisition.type</code> sau se omite tot obiectul <code>acquisition</code>.</td> </tr> <tr> <td><code>acquisition.type</code> necunoscut</td> <td><code>invalid_field_value</code>Invalid acquisition type. Allowed values: 'Invoice', 'Delivery note', 'Fiscal receipt', 'Sales booklet'.</td> <td>Se foloseste una din valorile din mesaj. Pentru un NIR fara document de achizitie, <code>acquisition</code> se omite.</td> </tr> <tr> <td><code>acquisition</code> fara <code>issueDate</code></td> <td><code>missing_required_field</code>The acquisition document issue date is required.</td> <td>Data documentului furnizorului este obligatorie.</td> </tr> <tr> <td>Scadenta inainte de data documentului</td> <td><code>invalid_field_value</code>The acquisition document due date must be on or after the issue date.</td> <td><code>acquisition.dueDate</code> trebuie sa fie cel putin egala cu <code>acquisition.issueDate</code>.</td> </tr> <tr> <td>TVA-ul declarat mai mare decat totalul cu TVA</td> <td><code>invalid_field_value</code>The acquisition document total VAT cannot be greater than total with VAT.</td> <td>Totalurile trebuie sa corespunda documentului furnizorului. La un document de retur (ambele totaluri negative) se compara valorile absolute.</td> </tr> <tr> <td>Totaluri de achizitie cu prea multe cifre</td> <td><code>invalid_field_value</code>The acquisition document total with VAT must have at most 4 decimal digits.</td> <td>Maximum 15 cifre in partea intreaga si 4 zecimale.</td> </tr> <tr> <td>Text prea lung in <code>acquisition</code></td> <td><code>invalid_field_value</code>The acquisition document number cannot be longer than 50 characters.</td> <td>Maximum 50 de caractere pentru <code>number</code> si <code>delegateVehicleRegistration</code>, 100 pentru <code>delegateName</code>. Mesajul numeste campul.</td> </tr> </tbody> </table> </details> <details> <summary>Produse si cantitati</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td><code>products</code> lipsa sau gol</td> <td><code>missing_required_field</code>The document must contain at least one product.</td> <td>Este necesar cel putin un produs. Lista goala intoarce acelasi mesaj, cu <code>invalid_field_value</code>.</td> </tr> <tr> <td>Element <code>null</code> in <code>products</code></td> <td><code>missing_required_field</code>The product details are required.</td> <td>Elementul <code>null</code> trebuie eliminat. <code>param</code> arata pozitia, de exemplu <code>products[1]</code>.</td> </tr> <tr> <td>Peste 400 de pozitii</td> <td><code>invalid_field_value</code>You can only add 400 products per document.</td> <td>Receptia se imparte in mai multe NIR-uri.</td> </tr> <tr> <td><code>name</code> sau <code>measuringUnitName</code> lipsa</td> <td><code>missing_required_field</code>The product name is required.</td> <td>Denumirea (maximum 5.000 de caractere) si unitatea de masura (maximum 200) sunt obligatorii.</td> </tr> <tr> <td>Cod lipsa cand firma foloseste coduri</td> <td><code>product_code_required</code>The product 'Widget' does not have a specified code.</td> <td><code>code</code> este obligatoriu la fiecare produs si serviciu.</td> </tr> <tr> <td>Cod cu peste 100 de caractere</td> <td><code>invalid_field_value</code>The product code cannot be longer than 100 characters.</td> <td>Codul are maximum 100 de caractere.</td> </tr> <tr> <td>Cantitate lipsa</td> <td><code>missing_required_field</code>The product received quantity is required.</td> <td>Sunt obligatorii atat <code>documentQuantity</code>, cat si <code>receivedQuantity</code>.</td> </tr> <tr> <td>Cantitate zero</td> <td><code>invalid_field_value</code>The received quantity cannot be zero.</td> <td>Cantitatile trebuie sa fie diferite de zero. Pentru retur se folosesc valori negative.</td> </tr> <tr> <td>Cantitate cu prea multe cifre</td> <td><code>invalid_field_value</code>The received quantity must have at most 4 decimal digits.</td> <td>Maximum 15 cifre in partea intreaga si 4 zecimale.</td> </tr> <tr> <td>Unitate de masura fara factor de conversie</td> <td><code>product_measuring_unit_conversion_missing</code>Measuring unit 'set' for product 'Widget' does not have a conversion factor. ...</td> <td>Se foloseste unitatea configurata pentru produs, scrisa exact (case-sensitive), sau se defineste conversia in Nomenclatoare > Produse.</td> </tr> <tr> <td>Conversia face cantitatea zero</td> <td><code>product_converted_measuring_unit_quantity_rounds_to_zero</code>For product 'Widget', rounding the quantity expressed in measuring unit 'set' to 4 decimal places results in an invalid quantity of zero ...</td> <td>Factorii de conversie ai unitatii de masura trebuie verificati.</td> </tr> <tr> <td>Produsul nu poate fi identificat</td> <td><code>product_with_name_not_found</code>Product 'Widget' was not found.</td> <td><code>name</code>, <code>code</code> si <code>isService</code> trebuie sa corespunda nomenclatorului.</td> </tr> <tr> <td>Produsul corespunde mai multor inregistrari</td> <td><code>duplicate_stock_product</code>Product 'Widget' has multiple stock entries on the document.</td> <td>Nomenclatorul de produse contine dubluri care trebuie eliminate.</td> </tr> </tbody> </table> </details> <details> <summary>Preturi si TVA</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td>Pret de achizitie lipsa</td> <td><code>missing_required_field</code>The product purchase price is required.</td> <td><code>purchasePriceWithoutVatInDocumentCurrency</code> este obligatoriu la fiecare pozitie.</td> </tr> <tr> <td>Pret de achizitie negativ</td> <td><code>invalid_field_value</code>The product purchase price must be greater than or equal to zero.</td> <td>Pretul ramane pozitiv si la retur (linie cu cantitate negativa); semnul se da prin cantitate.</td> </tr> <tr> <td>Pret cu mai multe zecimale decat <code>precision</code></td> <td><code>invalid_field_value</code>Price cannot have more than 2 decimal places for this document.</td> <td>Pretul se rotunjeste sau se mareste <code>precision</code>. <code>param</code> arata pozitia si campul.</td> </tr> <tr> <td>Pret de vanzare lipsa pe gestiune en detail</td> <td><code>missing_required_field</code>The selling price must be provided for a retail destination warehouse.</td> <td><code>sellingPriceWithoutVatInRON</code> este obligatoriu pentru produsele receptionate in gestiuni en detail. Serviciile si liniile cu cantitate negativa (retur) il pot omite.</td> </tr> <tr> <td>Pret de vanzare negativ</td> <td><code>invalid_field_value</code>The product selling price must be greater than or equal to zero.</td> <td>Pretul de vanzare trebuie sa fie pozitiv sau zero. Regula se aplica serviciilor (inclusiv la retur) si produselor cu cantitate pozitiva, pe orice tip de gestiune.</td> </tr> <tr> <td>Pret de vanzare sub pretul de achizitie (firma platitoare de TVA)</td> <td><code>invalid_field_value</code>The selling price without VAT must be greater than or equal to the purchase price without VAT.</td> <td>Pe gestiune en detail, pretul de vanzare fara TVA al unui produs trebuie sa fie cel putin pretul de achizitie fara TVA convertit in RON. Nu se aplica serviciilor.</td> </tr> <tr> <td>Pret de vanzare sub pretul de achizitie (firma neplatitoare de TVA)</td> <td><code>invalid_field_value</code>The selling price must be greater than or equal to the purchase price with VAT.</td> <td>Pe gestiune en detail, pretul de vanzare al unui produs trebuie sa fie cel putin pretul de achizitie cu TVA-ul furnizorului, convertit in RON. Nu se aplica serviciilor.</td> </tr> <tr> <td>Preturi de vanzare diferite pentru acelasi produs</td> <td><code>product_selling_price_inconsistent</code>Product 'Widget' cannot have multiple selling prices in warehouse 'Main' on the same document.</td> <td>Pozitiile aceluiasi produs din aceeasi gestiune en detail trebuie sa aiba acelasi pret de vanzare.</td> </tr> <tr> <td>Cote TVA de vanzare diferite pentru acelasi produs</td> <td><code>product_vat_rate_inconsistent</code>Product 'Widget' cannot have multiple VAT rates in warehouse 'Main' on the same document.</td> <td>Se foloseste aceeasi cota de vanzare pe pozitiile aceluiasi produs din aceeasi gestiune en detail.</td> </tr> <tr> <td>Cota de achizitie lipsa (furnizor platitor de TVA)</td> <td><code>missing_required_field</code>The purchase VAT rate is required.</td> <td>Se trimite <code>purchaseVatRateId</code>, din <a href="#api-1/tag/cote-tva">Cote TVA</a>.</td> </tr> <tr> <td>Cota de vanzare lipsa (firma platitoare de TVA)</td> <td><code>missing_required_field</code>The selling VAT rate is required.</td> <td><code>sellingVatRateId</code> este obligatoriu pe fiecare pozitie, inclusiv pe gestiuni en gros, servicii si linii cu cantitate negativa.</td> </tr> <tr> <td>Cota cu taxare inversa peste 0% la vanzare, pe gestiune global-valorica</td> <td><code>invalid_field_value</code>The selling VAT rate cannot be a reverse-charge rate with the reverse charge percentage greater than 0.</td> <td>Pe gestiunile global-valorice, la vanzare se foloseste o cota fara taxare inversa sau cota cu taxare inversa care are <code>reverseChargePercentage</code> 0. Cotele cu taxare inversa de 5%, 11%, 21% etc. se folosesc doar la achizitie.</td> </tr> <tr> <td>Cota TVA inexistenta in firma</td> <td><code>invalid_field_value</code>The purchase VAT rate could not be found.</td> <td>Id-ul trebuie sa existe in <a href="#api-1/tag/cote-tva">Cote TVA</a>. Pentru cota de vanzare mesajul este <code>The selling VAT rate could not be found.</code></td> </tr> <tr> <td>Id de cota cu prefix gresit</td> <td><code>invalid_field_value</code>The 'products[0].purchaseVatRateId' field must start with 'vat_'.</td> <td>Id-ul se trimite integral, cu prefixul <code>vat_</code>.</td> </tr> </tbody> </table> </details> <details> <summary>Gestiuni si stoc</summary> <table class="sb-op-table sb-op-table--3"> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td><code>destinationWarehouseId</code> lipsa</td> <td><code>missing_required_field</code>The product destination warehouse ID is required.</td> <td>Gestiunea este obligatorie pe fiecare pozitie, inclusiv la servicii.</td> </tr> <tr> <td>Id de gestiune cu prefix gresit</td> <td><code>invalid_field_value</code>The 'products[0].destinationWarehouseId' field must start with 'ware_'.</td> <td>Id-ul se trimite integral, cu prefixul <code>ware_</code>.</td> </tr> <tr> <td>Gestiune inexistenta in firma</td> <td><code>invalid_field_value</code>The warehouse with ID 'ware_01a0ee341fb17d8da8df382a41dcebaf' was not found.</td> <td>Id-ul trebuie sa existe in <a href="#api-1/tag/gestiuni">Gestiuni</a>.</td> </tr> <tr> <td>Data inaintea importului de stoc initial</td> <td><code>document_date_before_initial_stock</code>The document date cannot precede the initial stock import. Initial stock was imported into warehouse 'Main' on 2026-09-01.</td> <td><code>issueDate</code> trebuie sa fie ulterioara importului de stoc initial in gestiunile folosite.</td> </tr> <tr> <td>Linie cu cantitate negativa (retur) pe gestiune en gros cu CMP, fara cost mediu ponderat</td> <td><code>reversal_weighted_average_cost_not_found</code>Product 'Widget' has no weighted average cost in warehouse 'Main' on 2026-09-03, so it cannot be reversed.</td> <td>Produsul trebuie sa aiba o intrare pe un document finalizat si neanulat in acea gestiune, cel tarziu la data NIR-ului.</td> </tr> <tr> <td>Fara metoda de evaluare a stocului la data NIR-ului</td> <td><code>stock_mode_not_found</code>The company does not have a stock valuation method configured for the document date.</td> <td>Configurarea gestiunii firmei din SmartBill Cloud trebuie verificata.</td> </tr> </tbody> </table> </details>

Tipuri de emitere

<details> <summary>1. Emitere NIR pe gestiune global-valorica</summary>

NIR pe o gestiune global-valorica, care apare cu type: "en detail" in Listare gestiuni. Pe acest tip de gestiune sellingPriceWithoutVatInRON este obligatoriu si trebuie sa fie cel putin pretul de achizitie convertit in RON. Raspunsul calculeaza si pretul de vanzare cu TVA.

{
  "status": "draft",
  "seriesName": "NIR",
  "issueDate": "2026-10-01",
  "currency": "RON",
  "supplierId": "sup_019f0000000070008000000000000001",
  "acquisition": {
    "type": "Invoice",
    "number": "FURN1024",
    "issueDate": "2026-10-01",
    "dueDate": "2026-10-31",
    "totalWithVatInDocumentCurrency": 1210,
    "totalVatInDocumentCurrency": 210
  },
  "products": [
    {
      "name": "Produs exemplu",
      "code": "PROD-001",
      "measuringUnitName": "buc",
      "documentQuantity": 10,
      "receivedQuantity": 10,
      "purchasePriceWithoutVatInDocumentCurrency": 100,
      "sellingPriceWithoutVatInRON": 150,
      "isService": false,
      "destinationWarehouseId": "ware_019f0000000070008000000000000002",
      "purchaseVatRateId": "vat_019f0000000070008000000000000003",
      "sellingVatRateId": "vat_019f0000000070008000000000000003"
    }
  ]
}

</details> <details> <summary>2. Emitere NIR pe gestiune cantitativ-valorica</summary>

Aceeasi factura, pe o gestiune cantitativ-valorica, care apare cu type: "en gros" in Listare gestiuni. Pretul de vanzare nu se trimite: pe acest tip de gestiune nu se foloseste, iar in raspuns ambele preturi de vanzare sunt null. sellingVatRateId ramane obligatoriu daca firma este platitoare de TVA.

{
  "status": "draft",
  "seriesName": "NIR",
  "issueDate": "2026-10-01",
  "currency": "RON",
  "supplierId": "sup_019f0000000070008000000000000001",
  "acquisition": {
    "type": "Invoice",
    "number": "FURN1024",
    "issueDate": "2026-10-01",
    "dueDate": "2026-10-31",
    "totalWithVatInDocumentCurrency": 1210,
    "totalVatInDocumentCurrency": 210
  },
  "products": [
    {
      "name": "Produs exemplu",
      "code": "PROD-001",
      "measuringUnitName": "buc",
      "documentQuantity": 10,
      "receivedQuantity": 10,
      "purchasePriceWithoutVatInDocumentCurrency": 100,
      "isService": false,
      "destinationWarehouseId": "ware_019f0000000070008000000000000005",
      "purchaseVatRateId": "vat_019f0000000070008000000000000003",
      "sellingVatRateId": "vat_019f0000000070008000000000000003"
    }
  ]
}

</details> <details> <summary>3. Emitere NIR in valuta</summary>

NIR pentru o factura de furnizor in EUR, pe o gestiune global-valorica. Pretul de achizitie se trimite in currency, pretul de vanzare in RON, iar exchangeRate face conversia. Exemplul completeaza si delegatul, mentiunile si observatiile.

{
  "status": "draft",
  "seriesName": "NIR",
  "issueDate": "2026-09-16",
  "currency": "EUR",
  "precision": 2,
  "exchangeRate": 5,
  "mentions": "Receptie conform facturii furnizorului",
  "observations": "Marfa verificata la descarcare",
  "committee": "Comisia de receptie",
  "supplierId": "sup_01a0d9032d8c782d91ddf1d151aec44c",
  "acquisition": {
    "type": "Invoice",
    "number": "FACT123",
    "issueDate": "2026-09-18",
    "dueDate": "2026-10-18",
    "totalWithVatInDocumentCurrency": 1210,
    "totalVatInDocumentCurrency": 210,
    "delegateName": "Ion Popescu",
    "delegateVehicleRegistration": "B-123-ABC"
  },
  "products": [
    {
      "name": "Example product",
      "code": "PROD-001",
      "measuringUnitName": "buc",
      "documentQuantity": 10,
      "receivedQuantity": 10,
      "purchasePriceWithoutVatInDocumentCurrency": 100,
      "sellingPriceWithoutVatInRON": 615,
      "isService": false,
      "destinationWarehouseId": "ware_01a0d9042da672d58723cba68ab04d8b",
      "purchaseVatRateId": "vat_01a0af2cdabd7c39a0750098e11b9960",
      "sellingVatRateId": "vat_01a0af2cdabd7c39a0750098e11b9960"
    }
  ]
}

</details>

post/v3/companies/{cif}/goods-receipts

Request

Base URL
https://ws.smartbill.ro/SBORO/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/smartbill/apis/smartbill-api/docs/v3/companies/:cif/goods-receipts/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

cifstring required

CIF-ul firmei tale, fara spatii.

Request body

status'draft' required

Starea NIR-ului emis. Deocamdata se accepta doar draft; orice alta valoare este respinsa.

seriesNamestring required

Denumirea completa a unei serii de tip NIR din SmartBill. Literele mari si mici nu conteaza.

issueDatestring date required

Data NIR-ului, in format YYYY-MM-DD, intre 1970-01-01 si 9999-12-31.

currencystring

Moneda documentului de achizitie. Campurile ...InDocumentCurrency sunt in aceasta moneda.

precision2 | 3 | 4

Numarul de zecimale folosit pentru preturi. Se trimite ca numar intreg - 2, nu 2.0.

exchangeRatenumber

Cati lei valoreaza o unitate din currency (5 = 1 EUR = 5 RON). Obligatoriu pentru alte monede decat RON. Pentru RON se poate omite sau se trimite 1.

mentionsstring

Mentiuni afisate pe document.

observationsstring

Observatii vizibile doar in contul SmartBill, nu apar pe document.

committeestring

Comisia de receptie.

supplierIdstring required

ID-ul furnizorului, din Furnizori.

Example request

{
  "status": "draft",
  "seriesName": "NIR",
  "issueDate": "2026-09-16",
  "currency": "EUR",
  "precision": 2,
  "exchangeRate": 5,
  "mentions": "Receptie conform facturii furnizorului",
  "observations": "Marfa verificata la descarcare",
  "committee": "Comisia de receptie",
  "supplierId": "sup_01a0d9032d8c782d91ddf1d151aec44c",
  "acquisition": {
    "type": "Invoice",
    "number": "FACT123",
    "issueDate": "2026-09-18",
    "dueDate": "2026-10-18",
    "totalWithVatInDocumentCurrency": 1210,
    "totalVatInDocumentCurrency": 210,
    "delegateName": "Ion Popescu",
    "delegateVehicleRegistration": "B-123-ABC"
  },
  "products": [
    {
      "name": "Example product",
      "code": "PROD-001",
      "measuringUnitName": "buc",
      "documentQuantity": 10,
      "receivedQuantity": 10,
      "purchasePriceWithoutVatInDocumentCurrency": 100,
      "sellingPriceWithoutVatInRON": 615,
      "destinationWarehouseId": "ware_01a0d9042da672d58723cba68ab04d8b",
      "purchaseVatRateId": "vat_01a0af2cdabd7c39a0750098e11b9960",
      "sellingVatRateId": "vat_01a0af2cdabd7c39a0750098e11b9960"
    }
  ]
}

Response

NIR creat ca ciorna. number este gol pana la finalizarea NIR-ului.

idstring

ID unic NIR

status'active' | 'draft' | 'annulled'

Starea NIR-ului

seriesNamestring

Denumirea seriei NIR

numberstring

Numarul NIR-ului. Gol ("") la o ciorna nenumerotata. Trebuie tratat ca text, nu ca numar.

issueDatestring date

Data NIR-ului

currencystring

Moneda documentului

precisioninteger

Precizia documentului pentru preturi si totaluri, in zecimale

exchangeRatenumber

Cursul in RON pentru o unitate din moneda documentului, cu maximum 6 zecimale

mentionsstring

Mentiuni; "" daca nu sunt completate

observationsstring

Observatii; "" daca nu sunt completate

committeestring

Comisia de receptie; "" daca nu e completata

totalWithoutVatCalculatedInDocumentCurrencynumber

Total calculat fara TVA, in moneda documentului

totalWithVatCalculatedInDocumentCurrencynumber

Total calculat cu TVA, in moneda documentului

totalVatCalculatedInDocumentCurrencynumber

TVA total calculat, in moneda documentului

Example response

{
  "id": "gr_019f0000000070008000000000000004",
  "status": "active",
  "seriesName": "NIR",
  "number": "1024",
  "issueDate": "2026-09-29",
  "currency": "RON",
  "precision": 2,
  "exchangeRate": 1,
  "mentions": "Receptie conform facturii furnizorului",
  "committee": "Comisia de receptie",
  "totalWithoutVatCalculatedInDocumentCurrency": 1000,
  "totalWithVatCalculatedInDocumentCurrency": 1210,
  "totalVatCalculatedInDocumentCurrency": 210,
  "supplier": {
    "name": "Furnizor Exemplu SRL",
    "vatCode": "RO44444444",
    "regCom": "J40/9999/2021",
    "code": "FURN003",
    "address": "Str. Exemplu 10",
    "city": "Bucuresti",
    "county": "Bucuresti",
    "country": "Romania",
    "bank": "Banca Exemplu",
    "iban": "RO49AAAA1B31007593840000",
    "email": "supplier@example.com",
    "contact": "Maria Ionescu",
    "phone": "0722000003",
    "isVatPayer": true
  },
  "acquisition": {
    "type": "Invoice",
    "number": "FACT123",
    "issueDate": "2026-09-18",
    "dueDate": "2026-10-18",
    "totalWithVatInDocumentCurrency": 1210,
    "totalVatInDocumentCurrency": 210,
    "delegateName": "Ion Popescu",
    "delegateVehicleRegistration": "B-123-ABC"
  },
  "products": [
    {
      "name": "Produs exemplu",
      "code": "PROD-001",
      "measuringUnitName": "buc",
      "documentQuantity": 10,
      "receivedQuantity": 10,
      "purchasePriceWithoutVatInDocumentCurrency": 100,
      "purchasePriceWithVatInDocumentCurrency": 121,
      "purchasePriceWithoutVatInRON": 100,
      "purchasePriceWithVatInRON": 121,
      "sellingPriceWithoutVatInRON": 150,
      "sellingPriceWithVatInRON": 181.5,
      "destinationWarehouseId": "ware_019f0000000070008000000000000002",
      "purchaseVatRateId": "vat_019f0000000070008000000000000003",
      "sellingVatRateId": "vat_019f0000000070008000000000000003"
    }
  ]
}

Changes

Oct 10, 2026b79a53e24b9d Revision changes
- warning
  removed the optional property from the response with the status
- info
  added the optional property to the response with the status
Oct 7, 2026c4fae8d32eea Revision changes
- info
  endpoint added

Operation history