Skip to content

Consultar retenciones de IVA ​

GET /api/Invoice/get_retention_iva

Devuelve todos los comprobantes de retención de IVA 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: aunque se envíe un cuerpo JSON (como hace la colección de Postman), se ignora y la respuesta es siempre la lista completa.

Ejemplo de solicitud ​

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

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "retention": [
    {
      "documento": "Retencion IVA",
      "numeroComprobante": "20260700000012",
      "numeroControl": "00-00000070",
      "rifCliente": "J-123456789",
      "status": "Emitida",
      "creado": "2026-07-15 10:32:18 AM",
      "pdf": [
        "https://<servidor>/readonly/exportPdf/MTIzfDl8NXxDTElFTlRFIEVKRU1QTE8..."
      ]
    }
  ]
}
ClaveDescripción
successtrue.
retentionLista de comprobantes (uno por comprobante, aunque tenga varias líneas). Arreglo vacío si no hay ninguno.
documentoSiempre Retencion IVA.
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. Filtra del lado del integrador si lo necesitas.
  • No incluye montos 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