# Consultar estatus de CFDI

Este endpoint permite **consultar el estatus actual de un CFDI** directamente ante el SAT
y actualizar el registro local con el resultado.

Es útil para dar seguimiento a facturas cuya cancelación fue solicitada
(`CANCEL_REQUESTED`) o para verificar que un CFDI sigue vigente.

## Endpoint

```
GET /v1/qrs/invoices/uuid/{uuid}/status
```

**Host (DEV):**

```
https://api-dev.qrwey.com
```

**Host (PROD):**

```
https://api.qrwey.com
```

## Headers requeridos

```http
Authorization: Bearer {{access_token}}
```

## Parámetros de ruta

| Parámetro | Descripción |
|  --- | --- |
| `uuid` | Folio UUID del CFDI asignado por el SAT al timbrar la factura |


## Ejemplo de request (DEV)

```bash
curl -X GET "https://api-dev.qrwey.com/v1/qrs/invoices/uuid/F1G2H3I4-J5K6-7890-LMNO-PQ1234567890/status" \
  -H "Authorization: Bearer {{access_token}}"
```

## Respuesta

```json
{
  "invoiceId": "8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d",
  "invoiceStatus": "GENERATED",
  "folioUuid": "F1G2H3I4-J5K6-7890-LMNO-PQ1234567890",
  "sourceTaxId": "FUNK671228PH6",
  "sourceLegalName": "KARLA FUENTE NOLASCO",
  "targetTaxId": "EKU9003173C9",
  "targetLegalName": "ESCUELA KEMPER URGATE",
  "subtotal": 500.00,
  "iva": 80.00,
  "total": 580.00,
  "invoiceDate": "2026-03-19T15:00:00Z"
}
```

### Estatus posibles

| `invoiceStatus` | Significado |
|  --- | --- |
| `GENERATED` | El CFDI está vigente ante el SAT |
| `CANCELLED` | El CFDI fue cancelado |
| `CANCEL_IN_PROGRESS` | La cancelación está en proceso ante el SAT |


## Comportamiento

- El endpoint consulta el estatus del CFDI directamente ante el SAT usando el `folioUuid`.
- Si el SAT reporta un estatus válido (`GENERATED`, `CANCELLED` o `CANCEL_IN_PROGRESS`),
el registro local se actualiza automáticamente.
- Si el SAT no puede resolver el estatus, se retorna un error `400`.


## Errores comunes

| Código | Motivo |
|  --- | --- |
| 400 | No fue posible obtener el estatus del CFDI ante el SAT |
| 401 | Token inválido o expirado |
| 404 | Factura no encontrada |


Consulta: [Manejo de errores](/guides/error-handling)

## Buenas prácticas

- Usa este endpoint para dar seguimiento a facturas con estatus `CANCEL_REQUESTED`.
- No consultes el estatus de forma excesiva; el SAT puede limitar las consultas.
- Si necesitas cancelar un CFDI, usa el endpoint de cancelación: [Cancelar CFDI 4.0](/guides/cancel-cfdi).


## ¿Qué sigue?

- Cancela un CFDI: [Cancelar CFDI 4.0](/guides/cancel-cfdi)
- Timbra un nuevo CFDI: [Timbrar CFDI 4.0](/guides/stamp-cfdi)
- Vuelve al índice: [Gestión de Clientes](/guides/customer-portal)