Actualizar información salarial

Actualizar la información salarial de un empleado.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Actualiza la información salarial del empleado (salario, modalidad, auxilios, procedimiento de retención). El uuid de la URL es el del vinculado.

Reglas de negocio

  • No se puede modificar el salario si el empleado ya tiene un pago en estado definitivo. El cambio se rechaza; para ajustarlo hay que registrar un cambio de salario con vigencia futura.
  • Un cambio se considera tal si varía el indicador de salario integral o si el salario difiere en más de 0.1.
  • La modalidad por días solo es coherente con el tipo de cotizante Trabajador de tiempo parcial; el servicio ajusta la combinación al guardar.
  • Con procedimiento de retención 2, el porcentaje se toma del body salvo que el empleado sea practicante, en cuyo caso se fuerza a 0.
  • Los campos de identificación para pago al banco (tipoIdentificacionPago, identificacionPago) solo se tienen en cuenta cuando el tipo de documento del empleado lo requiere y se marca el cambio de identificación bancaria.
  • Si se marca salario integral, se verifica contra el mínimo legal integral vigente.
  • Tras guardar se reevalúa el estado del empleado con las mismas reglas de completitud que en la creación.
Path Params
string
required
Body Params
string

Uuid del vinculado asociado al empleado.

string

Tipo de cotizante del empleado (ver /vinculados/tiposCotizante).

number
required

Salario del empleado.

string
required

Código de modalidad de salario.

boolean
required

Indica si el salario es integral.

boolean

Indica si recibe auxilio de conectividad.

string
required

Código de tipo de auxilio de transporte.

string
required

Código de procedimiento de retencion.

number

Solo informativo, enviar vacio o cero.

number

Solo informativo, enviar vacio o cero.

boolean

Solo informativo, no enviar.

string
required

Número de cuenta bancaria.

string
required

Código de tipo de cuenta.

string
required

Uuid de la entidad financiera (contactos tipo BAN).

string

Solo informativo, no diligenciar.

number

Porcentaje del procedimiento 2 de retencion.

string

Tipo de identificación para la cuenta bancaria, solo si cambia.

string

Identificación para la cuenta bancaria, solo si cambia.

date

Fecha desde la cual rige la retroactividad salarial; si no se envia se asume salarioDesde.

boolean

Indica si hay cambio en la identificación bancaria.

Headers
string
required

Bearer token para la autorización. Consulte la documentación inicial del módulo de nómina para obtener instrucciones sobre cómo generar el token de autenticación.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json