Crear vigencia de entidad SS

Registrar una nueva vigencia de entidad de seguridad social.

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

Crea una vigencia de entidad de seguridad social para un vinculado (EPS, AFP, ARL, caja de compensación, cesantías).

Reglas de negocio

  • El empleado debe tener contrato vigente; si no lo tiene, o si su fecha fin de contrato queda fuera del período de pago, se rechaza.
  • El conceptoCode debe corresponder a una entidad de seguridad social válida.
  • El uuidContacto es obligatorio y debe existir, y además debe ser del tipo de contacto correcto para ese concepto: no se puede asignar una EPS en el campo de AFP.
  • La vigencia se normaliza al primer día del mes de la fecha enviada: estas vigencias operan por mes completo, no por día.
  • Al crear una vigencia nueva, la vigencia anterior de esa misma entidad se cierra automáticamente con fecha fin el último día del mes previo. No hay que cerrarla a mano.
  • Para empleados practicantes (aprendices) hay conceptos que no aplican según la etapa; en esos casos la operación no crea la vigencia y responde sin error.
  • La operación es transaccional y se integra con una transacción mayor si ya hay una abierta.
Path Params
string
required
Body Params
string

Identificador único del evento.

string
required

Uuid del vinculado (ver /vinculados).

string
required

Código del concepto (para entidades de seguridad social: AdmPen, Eps, Ccf).

number

Valor numerico asociado al evento.

string

Representacion en texto del valor.

boolean

Representacion booleana del valor.

date-time

Representacion en fecha del valor.

string

Uuid del contacto de la entidad de seguridad social (ver /contactos).

string

Informativo, nombre del contacto.

string

Código del tipo de pariente.

string

Informativo.

date-time
required

Fecha de inicio de la vigencia.

date-time

Fecha de fin de la vigencia.

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