CFDI - Listado paginado de peticiones
Este endpoint permite consultar de forma paginada las peticiones CFDI registradas en Fénix.
Está diseñado para:
-
Obtener listados por bloques de registros
-
Aplicar ordenamiento
-
Filtrar resultados por datos clave de la petición
Es útil para integraciones que necesiten consultar el estado de CFDIs, identificar facturas generadas y consultar la información fiscal asociada a cada petición.
---
## Parámetros de consulta (Query Params)
Estos parámetros son opcionales y se envían por URL.
| Parámetro | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `orderNo` | string | No | Filtra por un número de orden específico. |
| `status` | string | No | Filtra por el estado actual de la petición. |
| `customerRfc` | string | No | Filtra las peticiones por RFC del cliente receptor. |
---
## Body de ejemplo
``` json
{
"lazyState": {
"first": 0,
"page": 0,
"rows": 10,
"sortField": null,
"sortOrder": "asc"
}
}
```
---
## Descripción del body
### Objeto raíz
| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `lazyState` | object | Sí | Contiene la configuración de paginación y ordenamiento de la consulta. |
### Objeto `lazyState`
| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `first` | integer | Sí | Índice del primer registro a recuperar. |
| `page` | integer | Sí | Número de página actual. Generalmente inicia en `0`. |
| `rows` | integer | Sí | Número de registros por página. |
| `sortField` | string / null | No | Campo por el cual se ordenarán los resultados. |
| `sortOrder` | string | Sí | Dirección del ordenamiento. Valores esperados: `asc` o `desc`. |
---
## Descripción del response
### Objeto raíz
| Campo | Tipo | Descripción |
| --- | --- | --- |
| `total_records` | integer | Número total de registros que coinciden con la búsqueda. |
| `records` | array | Lista de peticiones CFDI recuperadas en la página actual. |
---
## Detalle de cada registro en `records`
La estructura es la misma que en `/precfdi/lazy`, con los mismos datos generales de la petición, cliente, seller, detalle de línea, metadata y último log.
La diferencia es que este endpoint agrega información del CFDI generado.
### Campos adicionales
| Campo | Tipo | Descripción |
| --- | --- | --- |
| `previousUuid` | string / null | UUID relacionado previamente con la petición, cuando aplique. |
| `cfdi` | object | Información principal del CFDI generado. |
### Objeto `cfdi`
| Campo | Tipo | Descripción |
| --- | --- | --- |
| `uuid` | string | UUID fiscal del CFDI. |
| `serie` | string | Serie del comprobante. |
| `folio` | string | Folio del comprobante. |
| `stampedDate` | string (ISO 8601) | Fecha y hora de timbrado del CFDI. |
Request
This endpoint expects an object.
lazyState
Response
OK
total_records
records
Errors
400
Bad Request Error
