Crear contacto

Registrar un nuevo contacto en el sistema.

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

Crea un tercero o contacto en la nómina (entidades de seguridad social, proveedores, beneficiarios de libranza).

Reglas de negocio

  • La combinación de tipo y número de identificación identifica al contacto; si ya existe uno con esos datos, se rechaza.
  • El tipo de contacto determina para qué se puede usar: una entidad registrada como EPS no puede asignarse luego como AFP en las vigencias de seguridad social del empleado.
  • Si la identificación corresponde a una persona que ya está registrada como empleado, la creación del contacto entra en conflicto: hay que resolverlo antes de crear o actualizar ese empleado.
  • Los errores de validación de negocio se devuelven con el detalle del campo que falló.
Body Params
string
required

Naturaleza del contacto (persona natural/juridica).

string
required

Tipo de documento de identidad.

string
required

Número de identificación.

string

Digito de verificacion (NIT).

string

Nombre completo o razon social.

string

Primer nombre.

string

Segundo nombre.

string

Primer apellido.

string

Segundo apellido.

string
required

Dirección.

string
required

Código de ciudad.

string
required

Indicativo telefonico.

string
required

Teléfono.

string

Indicativo telefonico adicional.

string

Teléfono adicional.

string

Código postal.

string
required

Correo electrónico.

string

Sitio web.

string

Persona de contacto.

string

Facebook.

string

Twitter.

string

Instagram.

boolean

Indica si el usuario puede editar el contacto.

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