Skip to content

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ámetroTipoObligatorioDescripción y reglas
numeroDeFacturastringNoNúmero del documento. Coincidencia exacta (por ejemplo 00000123).
numeroDeControlstringNoNúmero de control tal como aparece en el documento, formato 00-00000000 (coincidencia exacta).
fechaIniciostringNoFecha inicial, formato YYYY-MM-DD. Solo se aplica si también envías fechaFin.
fechaFinstringNoFecha final, formato YYYY-MM-DD (inclusive). Solo se aplica si también envías fechaInicio.
tipoDeIdentificacionstringNoLetra del documento del cliente: V, E, P, J, G o C (se convierte a mayúscula). Solo se aplica junto con identificacionCliente.
identificacionClientestringNoNúmero de identificación del cliente sin la letra (por ejemplo 12345678). Coincidencia exacta. Solo se aplica junto con tipoDeIdentificacion.
limiteenteroNoCantidad máxima de documentos por página. Si se omite, no se pagina (devuelve todo).
paginaenteroNoNú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].

ClaveDescripción
successtrue si hay resultados.
invoices[0][]Lista de documentos, ordenada por número de control de mayor a menor.
documentTipo de documento fiscal en mayúsculas: FACTURA, NOTA DE CREDITO, NOTA DE DEBITO, ORDEN DE ENTREGA, GUIA DE DESPACHO.
invoice_numberNúmero del documento.
control_numberNúmero de control asignado (formato 00-00000000).
customer_nameNombre o razón social del cliente.
customer_document_identificationLetra + número de identificación del cliente (por ejemplo J123456789).
serial_codeSerie del número de control.
statusEstado legible: Emitida, Borrador, Anulada o Desconocido.
createdFecha y hora de registro (YYYY-MM-DD HH:MM:SS).
invoice_pdfEnlace público para descargar el PDF del documento.

Errores ​

HTTPMensaje (ejemplo)Causa
400Formato de fecha inválido. Utilice YYYY-MM-DD.fechaInicio o fechaFin no tienen el formato YYYY-MM-DD (o no son fechas reales).
404No se encontraron datosNo hay documentos que cumplan los filtros (o la página pedida está vacía).
400 / 401Ver ErroresToken ausente, con formato inválido, expirado o no autorizado.
500No existen coincidenciasError 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 document para distinguirlos. Las retenciones no aparecen aquí.
  • status agrupa estados: una factura pagada o pendiente de pago aparece igualmente como Emitida.
  • Para recorrer muchos resultados usa limite + pagina e incrementa pagina hasta recibir 404.
  • 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.

API de Facturación · CG Imprenta Digital