Apariencia
Ver facturas
GET /api/Invoice/get_list_invoices
Lista los documentos fiscales emitidos por el negocio del token, con su número, número de control, cliente, estado y enlace al PDF. Admite filtros por número de documento, rango de fechas y cliente, y paginación.
Autenticación: Authorization: Bearer <token> (cómo obtenerlo)
Parámetros
Todos van en la query string y todos son opcionales. Sin filtros devuelve todos los documentos del negocio.
| Parámetro | Tipo | Obligatorio | Descripción y reglas |
|---|---|---|---|
numeroDeFactura | string | No | Número del documento. Coincidencia exacta (por ejemplo 00000123). |
numeroDeControl | string | No | Número de control tal como aparece en el documento, formato 00-00000000 (coincidencia exacta). |
fechaInicio | string | No | Fecha inicial, formato YYYY-MM-DD. Solo se aplica si también envías fechaFin. |
fechaFin | string | No | Fecha final, formato YYYY-MM-DD (inclusive). Solo se aplica si también envías fechaInicio. |
tipoDeIdentificacion | string | No | Letra del documento del cliente: V, E, P, J, G o C (se convierte a mayúscula). Solo se aplica junto con identificacionCliente. |
identificacionCliente | string | No | Número de identificación del cliente sin la letra (por ejemplo 12345678). Coincidencia exacta. Solo se aplica junto con tipoDeIdentificacion. |
limite | entero | No | Cantidad máxima de documentos por página. Si se omite, no se pagina (devuelve todo). |
pagina | entero | No | Número de página, empezando en 1 (valor por defecto). Solo tiene efecto si envías limite. |
Las fechas se comparan contra la fecha del documento (sin la hora).
Ejemplo de solicitud
http
GET {{host}}api/Invoice/get_list_invoices?fechaInicio=2026-01-01&fechaFin=2026-01-31&tipoDeIdentificacion=V&identificacionCliente=12345678&limite=20&pagina=1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...Respuesta exitosa
HTTP 200
json
{
"success": true,
"invoices": [
[
{
"document": "FACTURA",
"invoice_number": "00000123",
"control_number": "00-00000456",
"customer_name": "Cliente Ejemplo C.A.",
"customer_document_identification": "V12345678",
"serial_code": "A",
"status": "Emitida",
"created": "2026-01-15 10:32:08",
"invoice_pdf": "{{host}}readonly/export_pdf/3f2a9c0b-7e5d-41a8-a6c2-d9e0f1a2b3c4"
}
]
]
}Observa que invoices es un arreglo que contiene otro arreglo con los documentos: la lista real está en invoices[0].
| Clave | Descripción |
|---|---|
success | true si hay resultados. |
invoices[0][] | Lista de documentos, ordenada por número de control de mayor a menor. |
document | Tipo de documento fiscal en mayúsculas: FACTURA, NOTA DE CREDITO, NOTA DE DEBITO, ORDEN DE ENTREGA, GUIA DE DESPACHO. |
invoice_number | Número del documento. |
control_number | Número de control asignado (formato 00-00000000). |
customer_name | Nombre o razón social del cliente. |
customer_document_identification | Letra + número de identificación del cliente (por ejemplo J123456789). |
serial_code | Serie del número de control. |
status | Estado legible: Emitida, Borrador, Anulada o Desconocido. |
created | Fecha y hora de registro (YYYY-MM-DD HH:MM:SS). |
invoice_pdf | Enlace público para descargar el PDF del documento. |
Errores
| HTTP | Mensaje (ejemplo) | Causa |
|---|---|---|
| 400 | Formato de fecha inválido. Utilice YYYY-MM-DD. | fechaInicio o fechaFin no tienen el formato YYYY-MM-DD (o no son fechas reales). |
| 404 | No se encontraron datos | No hay documentos que cumplan los filtros (o la página pedida está vacía). |
| 400 / 401 | Ver Errores | Token ausente, con formato inválido, expirado o no autorizado. |
| 500 | No existen coincidencias | Error interno al consultar. |
En este endpoint los errores usan la clave status (no success): {"status": false, "message": "..."}.
Notas
- Pese al nombre, el endpoint devuelve todos los tipos de documento registrados por el negocio (facturas, notas de crédito y débito, órdenes de entrega y guías de despacho); usa
documentpara distinguirlos. Las retenciones no aparecen aquí. statusagrupa estados: una factura pagada o pendiente de pago aparece igualmente comoEmitida.- Para recorrer muchos resultados usa
limite+paginae incrementapaginahasta recibir404. - Envía los parámetros de fecha y de cliente siempre en pareja; si falta uno de la pareja, el filtro se ignora sin error.
