Afectaciones

Entorno desarrollo

https://dev-api.talentify.cr

GET

/api/planilla/afectacion-conceptos

Devuelve el catálogo de afectaciones disponibles para el país de la unidad de negocio del usuario autenticado.

Una afectación es una regla que un concepto puede activar y que altera cómo se calcula la planilla: por ejemplo, que el concepto esté sujeto a impuesto de renta (CRC_RENTA_APLICABLE), que se le apliquen cargas sociales (CRC_CARGAS_SOCIALES_APLICABLE), que sea pagable en el aguinaldo (CRC_PAGABLE_EN_AGUINALDO), etc.

Los códigos devueltos por este endpoint son los valores válidos para el campo afectaciones[] al registrar o actualizar un concepto.

Respuesta

Un arreglo de objetos { codigo, descripcion }, ordenado por codigo. La descripcion viene traducida al idioma del sistema. El conjunto depende del país (para Costa Rica, códigos con prefijo CRC_).

No recibe parámetros: el país se obtiene de la unidad de negocio del usuario autenticado.

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de Header

Respuestas

🟢200Éxito

application/json

Catálogo de afectaciones disponibles para el país de la unidad de negocio.

Bodyapplication/json

🟠401No autentificado

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api.talentify.cr/api/planilla/afectacion-conceptos' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Ejemplo de Respuesta

200 - Afectaciones de Costa Rica (CRC)

[
    {
        "codigo": "CRC_AFECTA_INGRESOS_BRUTOS",
        "descripcion": "El concepto es considerado dentro de los ingresos brutos del salario"
    },
    {
        "codigo": "CRC_CARGAS_SOCIALES_APLICABLE",
        "descripcion": "Se le aplican deducciones de ley"
    },
    {
        "codigo": "CRC_PAGABLE_EN_AGUINALDO",
        "descripcion": "Se paga en el periodo del aguinaldo"
    },
    {
        "codigo": "CRC_RENTA_APLICABLE",
        "descripcion": "Se le aplica impuesto de renta"
    }
]

Modificado en 2026-06-16 21:51:08

Clasificación

Opciones

Afectaciones

Respuesta#

Solicitud

Respuestas

Respuesta