--- title: "Detalii NIR" method: GET path: "/v3/companies/{cif}/goods-receipts/{id}" tags: ["NIR-uri (Beta)"] --- # Detalii NIR `GET /v3/companies/{cif}/goods-receipts/{id}` ## Request - Base URL: `https://ws.smartbill.ro/SBORO/api` - URL: `https://ws.smartbill.ro/SBORO/api/v3/companies/{cif}/goods-receipts/{id}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Returneaza un singur NIR al firmei, dupa id, indiferent daca este activ, ciorna sau anulat. Necesita aceleasi drepturi ca listarea: un NIR dintr-o serie sau gestiune la care utilizatorul nu are acces intoarce `404 document_not_found`, la fel ca unul inexistent. Id-ul se trimite integral, cu prefixul `gr_`. Se obtine din listare sau din raspunsul de emitere; seria si numarul NIR-ului nu pot fi folosite in locul lui. ## Path parameters - `cif` string, required - `id` string, required ## Response `200` Detalii NIR - 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 ## Other responses - `400`: ID invalid - `401`: Autentificare esuata - `403`: Permisiuni insuficiente - `404`: NIR negasit - `405`: Metoda HTTP nepermisa - `406`: Format neacceptat (Accept header invalid) ## Changes - **2026-10-10** `b79a53e24b9d`: 1 warning, 1 info - removed the optional property `supplierId` from the response with the `200` status - added the optional property `supplier` to the response with the `200` status - **2026-10-07** `c4fae8d32eea`: 1 info - endpoint added [Operation history](https://skmtc.dev/smartbill/apis/smartbill-api/changes/v3/companies/:cif/goods-receipts/:id/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)