Skip to content

Consultar retenciones de ISLR ​

GET /api/Invoice/get_retention_islr

Devuelve todos los comprobantes de retención de ISLR emitidos o anulados por el negocio del token, con su número de comprobante, número de control, estado y enlace al PDF.

Autenticación: Authorization: Bearer <token> (cómo obtenerlo)

Parámetros ​

Sin parámetros. El código actual no lee parámetros de consulta ni cuerpo: si se envía un cuerpo, se ignora y la respuesta es siempre la lista completa.

Ejemplo de solicitud ​

http
GET /api/Invoice/get_retention_islr
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "retention": [
    {
      "documento": "Retencion ISLR",
      "numeroComprobante": "20260700000005",
      "numeroControl": "00-00000069",
      "rifCliente": "J-123456789",
      "status": "Emitida",
      "creado": "2026-07-15 10:40:02 AM",
      "pdf": [
        "https://<servidor>/readonly/exportPdf/NjR8OHw1fENMSUVOVEUgRUpFTVBMTy..."
      ]
    }
  ]
}
ClaveDescripción
successtrue.
retentionLista de comprobantes (uno por comprobante, aunque tenga varias líneas). Arreglo vacío si no hay ninguno.
documentoSiempre Retencion ISLR.
numeroComprobantePeríodo AAAAMM + correlativo de 8 dígitos. Es el valor que pide Anular retención.
numeroControlNúmero de control asignado al comprobante.
rifClienteDocumento del proveedor con guion (J-123456789).
statusEmitida o Anulada.
creadoFecha y hora de emisión, tal como está registrada (formato AAAA-MM-DD hh:mm:ss AM/PM).
pdfEnlace(s) al PDF del comprobante.

Errores ​

HTTPMensaje (ejemplo)Causa
401 / 400Ver ErroresToken ausente, mal formado, inválido o expirado.
401No se pudo identificar al usuario.El token no tiene un usuario asociado.

Notas ​

  • Sin filtros ni paginación. Devuelve todos los comprobantes del negocio en estado emitido o anulado, ordenados del más antiguo al más reciente.
  • No incluye montos, códigos de concepto ni el detalle de las líneas; para eso usa el PDF.
  • Una lista vacía responde HTTP 200 con "retention": [].

API de Facturación · CG Imprenta Digital