---
title: "Verificare incasare factura"
method: GET
path: "/invoice/paymentstatus"
tags: ["Facturi"]
---

# Verificare incasare factura

`GET /invoice/paymentstatus`

Verifica daca o factura este incasata si ce suma mai ramane de incasat. Parametrii se trimit in URL (query string).

**Ce intorc campurile:**

- `invoiceTotalAmount` - valoarea totala a facturii (cu TVA).
- `paidAmount` - suma incasata pana acum.
- `unpaidAmount` - suma ramasa de incasat (`invoiceTotalAmount - paidAmount`).
- `paid` - `true` daca factura e incasata integral, altfel `false`.

**Ai primit o eroare la verificarea incasarii?**

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

<details>
<summary><strong>Erori la verificarea incasarii</strong></summary>

<table>
  <thead>
    <tr>
      <th>Situatie</th>
      <th>Eroare</th>
      <th>Sugestie</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>number</code> lipseste din URL</td>
      <td><code>Numarul facturii trebuie specificat</code></td>
      <td>Adauga `number` in query string cu numarul facturii, de exemplu `number=3762`.</td>
    </tr>
    <tr>
      <td>Serie lipsa, serie gresita sau factura inexistenta</td>
      <td><code>Factura nu a fost gasita</code></td>
      <td>Verifica `seriesname` si `number`. Daca lipseste seria sau combinatia serie plus numar nu exista, API-ul raspunde cu acelasi mesaj.</td>
    </tr>
  </tbody>
</table>

</details>

## Query parameters

- `cif` string, required
- `seriesname` string, required
- `number` string, required

## Response `200`

Statusul platii facturii

- object
  - `errorText` string
  - `invoiceTotalAmount` number — Valoarea totala a facturii (cu TVA)
  - `paidAmount` number — Suma incasata pana acum
  - `unpaidAmount` number — Suma ramasa de incasat
  - `paid` boolean — true daca factura e incasata integral

## Other responses

- `400` — Parametru lipsa in URL sau document negasit
- `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)