--- title: "Listare NIR-uri" method: GET path: "/v3/companies/{cif}/goods-receipts" tags: ["NIR-uri (Beta)"] --- # Listare NIR-uri `GET /v3/companies/{cif}/goods-receipts` ## Request - Base URL: `https://ws.smartbill.ro/SBORO/api` - URL: `https://ws.smartbill.ro/SBORO/api/v3/companies/{cif}/goods-receipts` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Returneaza NIR-urile firmei, active, ciorne si anulate. Fiecare element din `items` are aceeasi structura ca raspunsul de la Detalii NIR, inclusiv `acquisition` si `products`. Firma trebuie sa aiba modulul de gestiune activ. Utilizatorul cheii API are nevoie, in meniul [Utilizatori](https://cloud.smartbill.ro/core/utilizatori/), de **API / Magazin online**, de **Vizualizare** la Documente → Receptii si de **Vizualizare** la Nomenclatoare → Furnizori. **Acces la serii si gestiuni** Pe varianta **Detaliat**, lista contine doar NIR-urile din seriile permise (Documente → Receptii → **Acces la seriile**) si din gestiunile permise (**Are acces la gestiune**). Daca o singura pozitie e intr-o gestiune nepermisa, tot NIR-ul lipseste din lista. Pe varianta **Simplu** nu exista restrictii pe serii si gestiuni. | Situatie | Rezultat | |---|---| | NIR dintr-o serie sau gestiune nepermisa | Nu apare in listare; la detalii, `404 document_not_found` | | Cursor `after` / `before` catre un NIR inaccesibil | `404 cursor_not_found` | | Fara acces la nicio serie NIR sau la nicio gestiune | `200` cu `items: []` | O serie sau gestiune noua trebuie adaugata de administrator in drepturile utilizatorului ca NIR-urile ei sa devina vizibile. Un NIR care dispare din lista sau intoarce `404` poate fi doar inaccesibil: drepturile trebuie verificate inainte ca documentul sa fie considerat sters in aplicatia integrata. **Filtrare** `dateFrom` si `dateTo` filtreaza dupa `issueDate` al NIR-ului, nu dupa data documentului furnizorului, si sunt inclusive. Se poate trimite o singura limita sau ambele; pentru o singura zi se trimite aceeasi data in ambele. Filtrul nu inseamna "modificat dupa": un NIR anulat sau modificat ulterior nu reapare doar pentru ca a fost schimbat. `status` accepta litere mari sau mici si ignora spatiile de la capete. Fara el, lista contine toate cele trei stari. `supplierName` si `supplierVatCode` se comporta ca filtrele `name` si `vatCode` de la [Listare furnizori](#api-1/tag/furnizori/GET/v3/companies/{cif}/suppliers): `supplierName` potriveste oriunde in nume, fara diferenta intre litere mari si mici; `supplierVatCode` potriveste exact CIF-ul si nu normalizeaza prefixul (`RO33333333` nu e gasit de `?supplierVatCode=33333333`). Filtrarea se face pe furnizorul asa cum a fost salvat pe NIR, nu pe datele actuale din nomenclator. Un NIR emis pentru `Best supplier` ramane gasit de `?supplierName=best` si dupa ce furnizorul e redenumit in `Worst supplier`, iar `?supplierName=worst` nu il gaseste. Filtrele se combina cu AND. Un filtru trimis gol (`?status=`) e ignorat, deci lista nu se filtreaza. **Ordonare** Lista e ordonata crescator dupa `id`, nu dupa data sau numarul NIR-ului - inclusiv cand pagina e ceruta cu `before`. Editarea unei ciorne in SmartBill pastreaza acelasi `id`. `limit` numara NIR-uri, nu linii de produse: fiecare NIR vine cu toate pozitiile lui in `products`. **Preturi** Preturile de vanzare sunt `null` pe gestiunile care nu sunt en detail. `null` trebuie tratat separat de `0`. Pentru reconciliere se folosesc preturile si totalurile returnate: rotunjirile si costurile repartizate pot face ca o recalculare din cantitate, pret si cota TVA sa dea alte valori. ## Path parameters - `cif` string, required ## Query parameters - `supplierName` string - `supplierVatCode` string - `dateFrom` string, date - `dateTo` string, date - `status` string - `limit` integer - `after` string - `before` string ## Response `200` Lista NIR-uri paginata (paginare cursor) - object - `items` GoodsReceiptV3[] - `id` string: ID unic NIR - `status` 'active' | 'draft' | 'annulled': Starea NIR-ului - `seriesName` string: Denumirea seriei NIR - `number` string: Numarul NIR-ului. Gol (`""`) la o ciorna nenumerotata. Trebuie tratat ca text, nu ca numar. - `issueDate` string, date: Data NIR-ului - `currency` string: Moneda documentului - `precision` integer: Precizia documentului pentru preturi si totaluri, in zecimale - `exchangeRate` number: Cursul in RON pentru o unitate din moneda documentului, cu maximum 6 zecimale - `mentions` string: Mentiuni; `""` daca nu sunt completate - `observations` string: Observatii; `""` daca nu sunt completate - `committee` string: Comisia de receptie; `""` daca nu e completata - `totalWithoutVatCalculatedInDocumentCurrency` number: Total calculat fara TVA, in moneda documentului - `totalWithVatCalculatedInDocumentCurrency` number: Total calculat cu TVA, in moneda documentului - `totalVatCalculatedInDocumentCurrency` number: TVA total calculat, in moneda documentului - `supplier` GoodsReceiptSupplierV3: Datele furnizorului salvate pe NIR. Aceleasi campuri ca in [Furnizori](#api-1/tag/furnizori), fara `id`. - `name` string - `vatCode` string: CIF furnizor - `regCom` string - `code` string: Cod intern furnizor - `address` string - `city` string - `county` string - `country` string - `bank` string - `iban` string - `email` string, email - `contact` string - `phone` string - `isVatPayer` boolean: Platitor TVA - `acquisition` GoodsReceiptAcquisitionV3: Documentul furnizorului pe baza caruia se face receptia. - `type` 'Invoice' | 'Delivery note' | 'Fiscal receipt' | 'Sales booklet', required: Tipul documentului furnizorului - `Invoice` (factura), `Delivery note` (aviz), `Fiscal receipt` (bon fiscal) sau `Sales booklet` (carnet de comercializare). La emitere, literele mari si mici nu conteaza; in raspuns apare in forma din lista. - `number` string: Numarul documentului furnizorului; `""` daca nu e completat - `issueDate` string, date, required: Data documentului furnizorului, intre `1970-01-01` si `9999-12-31` - `dueDate` string, date: Data scadentei, cel putin egala cu `issueDate` si cel mult `9999-12-31`; `""` daca nu e completata - `totalWithVatInDocumentCurrency` number: Totalul cu TVA declarat de furnizor, in moneda NIR-ului, cu maximum 4 zecimale. Nu intra in calculul NIR-ului. `0` daca nu e completat. - `totalVatInDocumentCurrency` number: TVA-ul total declarat de furnizor, in moneda NIR-ului, cu maximum 4 zecimale. Nu intra in calculul NIR-ului. `0` daca nu e completat. - `delegateName` string: Numele delegatului - `delegateVehicleRegistration` string: Numarul de inmatriculare al vehiculului delegatului - `products` GoodsReceiptProductV3[]: Pozitiile de produse si servicii, in ordinea din document. Poate fi goala. Liniile de cheltuieli si discount nu apar aici. - `name` string - `code` string: Cod produs; poate fi `""` - `measuringUnitName` string: Unitatea de masura - `documentQuantity` number, nullable: Cantitatea de pe documentul furnizorului, cu maximum 4 zecimale - `receivedQuantity` number, nullable: Cantitatea receptionata, cu maximum 4 zecimale. Poate fi negativa pe o linie de retur. - `purchasePriceWithoutVatInDocumentCurrency` number, nullable: Pret unitar de achizitie fara TVA, in moneda NIR-ului - `purchasePriceWithVatInDocumentCurrency` number, nullable: Pret unitar de achizitie cu TVA, in moneda NIR-ului - `purchasePriceWithoutVatInRON` number, nullable: Pret unitar de achizitie fara TVA, in RON. Poate avea mai multe zecimale decat `precision`. - `purchasePriceWithVatInRON` number, nullable: Pret unitar de achizitie cu TVA, in RON. Poate avea mai multe zecimale decat `precision`. - `sellingPriceWithoutVatInRON` number, nullable: Pret unitar de vanzare fara TVA, in RON. `null` daca gestiunea nu este en detail. - `sellingPriceWithVatInRON` number, nullable: Pret unitar de vanzare cu TVA, in RON. `null` daca gestiunea nu este en detail. - `isService` boolean: Este serviciu - `destinationWarehouseId` string: ID-ul gestiunii in care a intrat marfa; `""` cand nu exista o gestiune asociata - `purchaseVatRateId` string: ID-ul cotei TVA de achizitie; `""` cand nu exista o cota asociata - `sellingVatRateId` string: ID-ul cotei TVA de vanzare; `""` cand nu exista o cota asociata - `pagination` object - `next` string, nullable: URL-ul complet catre pagina urmatoare, sau null daca nu mai exista pagini - `previous` string, nullable: URL-ul complet catre pagina anterioara, sau null daca esti pe prima pagina ## Other responses - `400`: Parametri de paginare sau filtrare invalizi - `401`: Autentificare esuata - `403`: Permisiuni insuficiente - `404`: Cursor de paginare inexistent - `405`: Metoda HTTP nepermisa - `406`: Format neacceptat (Accept header invalid) ## Changes - **2026-10-10** `b79a53e24b9d`: 1 warning, 3 info - removed the optional property `items/items/supplierId` from the response with the `200` status - added the new optional `query` request parameter `supplierName` - added the new optional `query` request parameter `supplierVatCode` - added the optional property `items/items/supplier` to the response with the `200` status - **2026-10-08** `aa288bd373e7`: 1 warning - deleted the `query` request parameter `supplierId` - **2026-10-07** `192c23f8ebdc`: 3 breaking - removed the enum value `active` from the `query` request parameter `status` - removed the enum value `annulled` from the `query` request parameter `status` - removed the enum value `draft` from the `query` request parameter `status` - **2026-10-07** `c4fae8d32eea`: 1 info - endpoint added [Operation history](https://skmtc.dev/smartbill/apis/smartbill-api/changes/v3/companies/:cif/goods-receipts/get.md) --- [API](https://skmtc.dev/smartbill/apis/smartbill-api.md) - [All operations](https://skmtc.dev/smartbill/apis/smartbill-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartbill/apis/smartbill-api/revisions/b79a53e24b9d?raw)