SMsmartbill
NIR-uri (Beta)

Listare NIR-uri

Changed on

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, 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.

SituatieRezultat
NIR dintr-o serie sau gestiune nepermisaNu apare in listare; la detalii, 404 document_not_found
Cursor after / before catre un NIR inaccesibil404 cursor_not_found
Fara acces la nicio serie NIR sau la nicio gestiune200 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: 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.

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

Request

Path parameters

cifstring required

CIF-ul firmei tale, fara spatii.

Query parameters

supplierNamestring

Filtreaza dupa numele furnizorului salvat pe NIR (potrivire partiala, case-insensitive)

supplierVatCodestring

Filtreaza dupa CIF-ul furnizorului salvat pe NIR (potrivire exacta, case-insensitive)

dateFromstring date

Data minima a NIR-ului, inclusiv, in format yyyy-MM-dd. Nu poate depasi 9999-12-31.

dateTostring date

Data maxima a NIR-ului, inclusiv, in format yyyy-MM-dd. Nu poate fi inainte de 'dateFrom' si nu poate depasi 9999-12-31.

statusstring

Filtreaza dupa stare - active, draft sau annulled (case-insensitive)

limitinteger

Numar maxim de rezultate returnate (intre 1 si 100)

afterstring

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

beforestring

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

Response

Lista NIR-uri paginata (paginare cursor)

Example response

{
  "items": [
    {
      "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

  • b79a53e24b9dRevision changes
    • warning

      removed the optional property // from the response with the status

    • info

      added the new optional query request parameter supplierName

    • info

      added the new optional query request parameter supplierVatCode

    • info

      added the optional property // to the response with the status

  • aa288bd373e7Revision changes
    • warning

      deleted the query request parameter supplierId