## SPFE - Consulta de pagos, cobros, rechazos e impagos

`GET`  https://{entorno}.ticketbaiws.eus/spfe-estados/

La **Ley 18/2022 «Crea y Crece»**  (desarrollada por el RD 238/2026 y la Orden HAC/1028/2026) obliga a expedir las facturas entre empresas y profesionales en formato electrónico y a informar de su estado: **pago, cobro, rechazo o impago** . Ticketbai WS envía automáticamente a la **Solución Pública de Facturación Electrónica (SPFE) de la AEAT**  las facturas completas a clientes españoles con NIF que emites con el API, en formato UBL, y descarga las facturas que recibes de tus proveedores.

Estos métodos solo están disponibles para las empresas que tienen activado el envío a la SPFE. Se activa en los datos de la empresa del área privada (**Factura electrónica B2B** ) o con el parámetro **spfe**  de los métodos [Nueva empresa](https://ticketbaiws.eus/es/empresas-post/) y [Editar datos empresa](https://ticketbaiws.eus/es/empresas-put/). Al activarlo se envían las facturas desde ese día.

Devuelve los últimos 100 estados (pago, cobro, rechazo, impago) comunicados a la SPFE con [POST spfe-estados](https://ticketbaiws.eus/es/spfe-estados-post/) o desde el área privada, con el resultado de cada uno: **PENDING**  (en cola), **OK**  (aceptado por la AEAT) o **ERROR**  (con la lista de errores). Todos los filtros son opcionales y se pueden combinar.

**Los métodos GET permiten el envío de los parámetros en el body como payload JSON o mediante query string en la URL como se ve en el ejemplo cURL.**

### Parámetros

- `id` (integer, opcional): Identificador devuelto por POST spfe-estados. Ejemplo: `128`
- `serie` (string, opcional): Serie de una factura emitida. Ejemplo: `A`
- `numero` (string, opcional): Número de una factura emitida. Ejemplo: `2026000245`
- `factura` (string, opcional): Serie y número de la factura (emitida o recibida) Ejemplo: `F2026-0153`
- `nif_emisor` (string, opcional): NIF del emisor de la factura. Ejemplo: `B01000012`

**RESPUESTA (return, una fila por estado)**

- `id` (integer, Identificador del estado en Ticketbai WS) Ejemplo: `128`
- `estado / baja` (, Estado comunicado y si es una anulación) Ejemplo: `pago`
- `factura, fecha_factura, nif_emisor` (, Factura a la que se refiere) Ejemplo: `F2026-0153`
- `fecha / vencimiento` (, Fechas comunicadas (dd/mm/yyyy)) Ejemplo: `10/11/2026`
- `result` (string, **PENDING**  en cola, **OK**  aceptado por la AEAT, **ERROR**  rechazado (ver **errores** )) Ejemplo: `OK`
- `errores` (array, Lista de errores de la AEAT: codigo y descripcion)

**GET** `https://{entorno}.ticketbaiws.eus/spfe-estados/`

```bash
$ curl --request GET \
     --url 'https://api-test.ticketbaiws.eus/spfe-estados/?factura=F2026-0153&nif_emisor=B01000012' \
     --header 'Accept: application/json' \
     --header 'Token: xxx' \
     --header 'Nif: 00000014Z'
```

Respuesta:

```json
HTTP/1.1 200 OK
{
    "result": "OK",
    "return": [
        {
            "id": 128,
            "estado": "pago",
            "baja": false,
            "factura": "F2026-0153",
            "fecha_factura": "03\/11\/2026",
            "nif_emisor": "B01000012",
            "fecha": "10\/11\/2026",
            "vencimiento": "03\/12\/2026",
            "result": "OK",
            "errores": []
        },
        {
            "id": 131,
            "estado": "cobro",
            "baja": false,
            "factura": "A2026000245",
            "fecha_factura": "28\/10\/2026",
            "nif_emisor": "00000014Z",
            "fecha": "09\/11\/2026",
            "vencimiento": "27\/11\/2026",
            "result": "OK",
            "errores": []
        }
    ],
    "msg": null
}
```

Fuente: https://ticketbaiws.eus/es/spfe-estados-get/