| 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. |
clasificacion | Obligatorio. Una de las claves de Clasificación. |
monto | Obligatorio si no se envía porcentaje. Numérico. |
porcentaje | Obligatorio si no se envía monto. Numérico (acepta nulo). |
afectaciones | Arreglo de códigos de Afectaciones. |
escala_pago | Opcional. Entero: ID de una escala de pago (o null para quitarla). |
opciones | Opcional. Objeto de banderas de Opciones (true/false); reemplaza por completo las opciones del concepto. |
cuenta_contable / cuenta_contable_contraparte | Opcionales. IDs de cuentas contables. |
La actualización reemplaza las afectaciones y las opciones del concepto por las enviadas. Si el ID no existe, responde 406. Si la validación pasa pero el guardado falla, responde200con unmessagede error.
{ satisfactorio: true, concepto: {...} } con el concepto actualizado.curl --location --request PUT 'https://dev-api.talentify.cr/api/planilla/conceptos/649' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"nombre": "Pago comisiones",
"factor": -1,
"pais": "CRC",
"clasificacion": "CRC_INGRESO_VACACION",
"monto": 1000,
"afectaciones": [
"CRC_RENTA_APLICABLE"
],
"escala_pago": 12,
"opciones": {
"carga_seleccionable": true,
"carga_pago_monto": true
}
}'{
"satisfactorio": true,
"concepto": {
"id": 649,
"nombre": "Pago comisiones",
"factor": -1,
"pais": "CRC",
"subperiodo": null,
"clasificacion": "CRC_INGRESO_VACACION",
"monto": "1000.00",
"porcentaje": "0.00",
"cuenta_contable": null,
"cuenta_contable_contraparte": null,
"afectaciones": [
{
"codigo": "CRC_RENTA_APLICABLE",
"pais": "CRC"
}
],
"opciones": {
"carga_seleccionable": {
"nombre": "carga_seleccionable",
"valor": "1"
},
"carga_pago_monto": {
"nombre": "carga_pago_monto",
"valor": "1"
}
},
"escalaPago": null
}
}