---
title: "Listare stocuri"
method: GET
path: "/stocks"
tags: ["Stocuri"]
---

# Listare stocuri

`GET /stocks`

Returneaza informatii despre stocurile produselor din gestiuni.

**Flexibilitate in interogare:**
- **Fara filtre**: toate produsele din toate gestiunile
- **Doar gestiune** (`warehouseName`): toate produsele din acea gestiune
- **Doar produs** (`productName`/`productCode`): stocul acelui produs in toate gestiunile
- **Ambele**: stocul unui produs anume intr-o gestiune anume

**Structura raspunsului:**
Returneaza informatii despre gestiune si detalii de produs:
- numele si tipul gestiunii (en gros/en detail)
- numele, codul, unitatea de masura si cantitatea in stoc a produsului

**Ai primit o eroare la interogarea stocului?**

**Erorile de autentificare si autorizare sunt comune tuturor endpoint-urilor V1.** Pentru email/token, `cif`, drepturi pe firma, vezi [Erori API V1](#api-1/description/erori-api-v1). Mai jos gasesti doar erorile specifice.

<details>
<summary><strong>Erori la interogarea stocului</strong></summary>

<table>
  <thead>
    <tr>
      <th>Situatie</th>
      <th>Eroare</th>
      <th>Sugestie</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>date</code> lipseste</td>
      <td><code>Data la care vreti sa aflati valoarea stocului trebuie specificata!</code></td>
      <td>Trimite `date` in format `yyyy-MM-dd`. Este parametru obligatoriu.</td>
    </tr>
    <tr>
      <td><code>date</code> in format gresit</td>
      <td><code>Data trebuie sa fie de forma yyyy-MM-dd.</code></td>
      <td>Foloseste formatul `yyyy-MM-dd`, de exemplu `2026-07-11`.</td>
    </tr>
    <tr>
      <td>Gestiune inexistenta</td>
      <td><code>Gestiunea DepozitInexistent nu a fost gasita pe server.</code></td>
      <td>Verifica `warehouseName` - e case-sensitive si trebuie sa existe in cont.</td>
    </tr>
  </tbody>
</table>

</details>

## Query parameters

- `cif` string, required
- `date` string, date, required
- `warehouseName` string
- `productName` string
- `productCode` string

## Response `200`

Stocul pe gestiuni. Fiecare intrare are `warehouse` (nume + tip) si lista de `products` (`productName`, `productCode`, `measuringUnit`, `quantity`).

- StockResponse
  - `errorText` string
  - `list` object[]
    - `warehouse` object
      - `warehouseName` string — Numele gestiunii
      - `warehouseType` 'en gros' | 'en detail' — Tipul gestiunii (en gros sau en detail)
    - `products` object[]
      - `productName` string — Numele produsului
      - `productCode` string — Codul produsului/SKU (daca firma foloseste coduri)
      - `measuringUnit` string — Unitate de masura
      - `quantity` number — Cantitate in stoc

## Other responses

- `400` — Data lipsa/invalida sau gestiune inexistenta
- `401` — Autentificare esuata

---

[API](https://skmtc.dev/smartbill/apis/smartbill-api.md) · [All operations](https://skmtc.dev/smartbill/apis/smartbill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartbill/smartbill-api/revisions/29940a27d41c/schema)