Apariencia
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)" }
]
}| Clave | Descripción |
|---|---|
success | true. |
islr_retention_codes | Lista ordenada por código. |
Codigo | Código de concepto (texto de 3 dígitos, conserva los ceros a la izquierda). Es el valor de codigoRetencionIslr. |
concepto_de_retencion | Descripció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
| HTTP | Mensaje (ejemplo) | Causa |
|---|---|---|
| 401 / 400 | Ver Errores | Token ausente, mal formado, inválido o expirado. Los errores de token traen success: false y también la clave antigua status: false. |
| 404 | No se encontraron códigos de retención ISLR. | El catálogo está vacío. |
| 500 | Error 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_codesy/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+porcentajeal emitir y respondeEl 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.
