Apariencia
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..."
]
}
]
}| Clave | Descripción |
|---|---|
success | true. |
retention | Lista de comprobantes (uno por comprobante, aunque tenga varias líneas). Arreglo vacío si no hay ninguno. |
documento | Siempre Retencion IVA. |
numeroComprobante | Período AAAAMM + correlativo de 8 dígitos. Es el valor que pide Anular retención. |
numeroControl | Número de control asignado al comprobante. |
rifCliente | Documento del proveedor con guion (J-123456789). |
status | Emitida o Anulada. |
creado | Fecha y hora de emisión, tal como está registrada (formato AAAA-MM-DD hh:mm:ss AM/PM). |
pdf | Enlace(s) al PDF del comprobante. |
Errores
| HTTP | Mensaje (ejemplo) | Causa |
|---|---|---|
| 401 / 400 | Ver Errores | Token ausente, mal formado, inválido o expirado. |
| 401 | No 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 200con"retention": [].
