CFDI - Listado paginado de peticiones

View as Markdown
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.
lazyStateobjectRequired

Response

OK
total_recordsinteger
recordslist of objects

Errors

400
Bad Request Error