Skip to content

Códigos de concepto ISLR ​

GET /api/Invoice/islr_retention_codes

Devuelve el catálogo de códigos de concepto de retención de ISLR con su descripción. Úsalo para llenar codigoRetencionIslr en Retención de ISLR.

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

Parámetros ​

Sin parámetros. Si se envía un cuerpo, se ignora.

Ejemplo de solicitud ​

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

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "islr_retention_codes": [
    { "Codigo": "001", "concepto_de_retencion": "Sueldos y Salarios" },
    { "Codigo": "002", "concepto_de_retencion": "Honorarios Profesionales No Mercantiles (PNR)" },
    { "Codigo": "004", "concepto_de_retencion": "Honorarios Profesionales No Mercantiles (PJD)" }
  ]
}
ClaveDescripción
successtrue.
islr_retention_codesLista ordenada por código.
CodigoCódigo de concepto (texto de 3 dígitos, conserva los ceros a la izquierda). Es el valor de codigoRetencionIslr.
concepto_de_retencionDescripción del concepto. Las siglas indican el tipo de beneficiario: PNR (persona natural residente), PNNR (persona natural no residente), PJD (persona jurídica domiciliada), PJND (persona jurídica no domiciliada).

Errores ​

HTTPMensaje (ejemplo)Causa
401 / 400Ver ErroresToken ausente, mal formado, inválido o expirado. Los errores de token traen success: false y también la clave antigua status: false.
404No se encontraron códigos de retención ISLR.El catálogo está vacío.
500Error obteniendo los códigos de retención ISLR: ...Error interno al leer el catálogo.

Notas ​

  • Rutas equivalentes. Estas URLs devuelven exactamente lo mismo: /api/Invoice/get_islr_retention_codes, /api/Invoice/islr_withholding_codes y /api/Invoice/get_islr_withholding_codes.
  • Porcentajes. El catálogo no incluye los porcentajes permitidos por código. Un mismo código puede admitir varios porcentajes; el API valida la combinación codigoRetencionIslr + porcentaje al emitir y responde El porcentaje ... no es válido para el código ... si no corresponde.
  • El código 001 (Sueldos y Salarios) no tiene un porcentaje fijo: al emitir no se valida la combinación código/porcentaje.

API de Facturación · CG Imprenta Digital