GET
/v1/mx/invoices
Listar facturas
Las de la cuenta, de la más reciente a la más antigua, con la misma forma completa que devuelve consultar una: la lista no trae una versión recortada que después te obligue a pedir cada factura otra vez.
La respuesta trae
total. Sin él no se puede distinguir la última página de una que salió
corta, y se termina pidiendo una de más siempre.
Parámetros
- page
- entero · opcional
- Empieza en 1, que es el default.
- per_page
- entero · opcional
- 50 por default, 100 como máximo. Un número mayor se recorta al máximo en vez de rechazarse.
- issuer_id
- entero · opcional
- Sólo las de ese emisor. Sin él vienen las de toda la cuenta.
- sort
- texto · opcional
- Sin él, por fecha de emisión, de la más reciente a la más antigua. Con created, en el orden en que se crearon, de la última a la primera. Úsalo si consultas la lista cada cierto tiempo para encontrar las nuevas: una factura puede emitirse con fecha de hasta 72 horas atrás.
Sólo lo que timbramos nosotros
Este listado son las facturas emitidas por esta cuenta a través de oden.tax. Lo que el contribuyente facturó antes con otro software, y que conocemos por la descarga masiva del SAT, no aparece aquí: en el panel las dos cosas conviven en una sola lista, y por la API todavía no.
Sí aparecen los comprobantes de pago que se timbran desde el panel, mezclados con las facturas. La respuesta no trae
el tipo de comprobante; uno de pago se reconoce porque su
cfdi_use
es CP01.