Registrar concepto
Entorno desarrollo
https://dev-api.talentify.cr
Entorno desarrollo
https://dev-api.talentify.cr
POST
/api/planilla/conceptos
Reglas de validación
| Campo | Regla |
|---|---|
nombre | Obligatorio. Cadena de máximo 60 caracteres. |
factor | Obligatorio. Entero 1 (ingreso) o -1 (egreso). |
pais | Obligatorio. Código ISO de 3 letras (por ejemplo, CRC). |
clasificacion | Obligatorio. Una de las claves devueltas por Clasificación. |
monto | Obligatorio si no se envía porcentaje. Numérico. |
porcentaje | Obligatorio si no se envía monto. Numérico. |
escala_pago | Opcional. Entero: ID de una escala de pago. |
afectaciones[] | Opcional. Arreglo de códigos de Afectaciones. |
opciones[<codigo>] | Opcional. Banderas de Opciones (true/false); solo se guardan las que vengan en true. |
cuenta_contable | Opcional. ID de una cuenta contable. |
cuenta_contable_contraparte | Opcional. ID de la cuenta contable contraparte. |
Importante: se envía montooporcentaje, nunca ambos con valor. La unidad de negocio no se envía: se toma del usuario autenticado.
Respuesta
{ satisfactorio: true, concepto: {...} } con el concepto recién creado. Si la validación falla, responde 422. Si la validación pasa pero ocurre un error al guardar, la API responde con código 200 y un message de error.Solicitud
Parámetros de Header
Parámetros del Body multipart/form-data
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://dev-api.talentify.cr/api/planilla/conceptos' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--form 'nombre="Comisiones por ventas"' \
--form 'factor="1"' \
--form 'pais="CRC"' \
--form 'clasificacion="CRC_INGRESO_BONO"' \
--form 'monto="1000"' \
--form 'porcentaje=""' \
--form 'escala_pago="11"' \
--form 'afectaciones[]="CRC_RENTA_APLICABLE"' \
--form 'opciones[carga_seleccionable]="1"' \
--form 'cuenta_contable="221"' \
--form 'cuenta_contable_contraparte="222"'Respuesta Ejemplo de Respuesta
200 - Concepto registrado
{
"satisfactorio": true,
"concepto": {
"id": 764,
"nombre": "Comisiones por ventas",
"factor": 1,
"pais": "CRC",
"subperiodo": null,
"clasificacion": "CRC_INGRESO_BONO",
"monto": "1000.00",
"porcentaje": "0.00",
"cuenta_contable": 221,
"cuenta_contable_contraparte": 222,
"afectaciones": [
{
"codigo": "CRC_RENTA_APLICABLE",
"pais": "CRC"
}
],
"opciones": {
"carga_seleccionable": {
"nombre": "carga_seleccionable",
"valor": "1"
}
},
"escalaPago": null
}
}Modificado en 2026-06-16 21:51:08