Saltar al contenido principal
English (US) Português do Brasil

API - Entidad Colaboradores

Actualización

Entendimiento funcional

Un empleado en Buk es la entidad maestra de persona que representa a un colaborador dentro de la empresa, concentrando su identificación y datos personales (por ejemplo: nombres, RUT/documento, nacionalidad, fecha de nacimiento, género), sus datos de contacto y domicilio (correo, teléfonos, dirección, ciudad/región), y otros atributos administrativos relevantes para la gestión interna.
En términos funcionales, el empleado es el registro central sobre el cual se relacionan posteriormente otros elementos del sistema (como trabajos o planes), pero por sí mismo se entiende como la ficha del colaborador: quién es, cómo contactarlo, cómo identificarlo y qué información base se requiere para administrarlo en la plataforma.
Es importante entender que un empleado puede existir en el sistema, sin la necesidad de tener asociado un plan previsional y un trabajo, pero que para ese caso figura como inactivo hasta el momento en que se le asocien dichos datos.
modelo_relacional_empleado_buk.png

🟦 GET /employees

Definición:

GET /employees: Entrega la información de todos los Empleados.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura' o 'Lectura y Modificación.
 

🟦 GET /employees- CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees'

🟦 GET /employees - Ejemplo Respuesta

{  "period_type": "string",  "person_id": 0,  "id": 0,  "picture_url": "string",  "first_name": "string",  "surname": "string",  "second_surname": "string",  "full_name": "string",  "rut": "string",  "nationality": "string",  "country_code": "string",  "civil_status": "string",  "email": "string",  "personal_email": "string",  "address": "string",  "street": "string",  "street_number": "string",  "office_number": "string",  "city": "string",  "district": "string",  "location_id": 0,  "region": "string",  "office_phone": "string",  "phone": "string",  "gender": "string",  "birthday": "string",  "university": "string",  "degree": "string",  "active_since": "string",  "status": "string",  "private_role": true,  "code_sheet": "string",  "health_company": "string",  "pension_regime": "string",  "pension_fund": "string",  "retired": true,  "retirement_regime": "string",  "afc": "string",  "active_until": {},  "created_at": {},  "termination_reason": "string",  "custom_attributes": {},  "current_job": {    "company_id": 0,    "area_id": 0,    "contract_type": "string",    "start_date": "2025-12-15",    "end_date": "2025-12-15",    "notice_date": "2025-12-15",    "contract_finishing_date_1": "2025-12-15",    "contract_finishing_date_2": "2025-12-15",    "weekly_hours": 0,    "cost_center": "string",    "periodicity": "string",    "frequency": "string",    "role": "string",    "working_schedule_type": "string",    "other_type_of_working_day": "string",    "cost_centers": {      "id": "string",      "job_id": "string",      "weight": 0,      "cost_center": "string"    },    "location_id": "string",    "without_wage": "string",    "zone_assignment": "string",    "currency_code": "string",    "base_wage": 0,    "custom_attributes": {},    "boss": {      "id": 0,      "rut": "string",      "document_number": "string",      "document_type": "string"    },    "contract_subscription_date": "2025-12-15",    "reward": true,    "reward_concept": "string",    "reward_payment_period": "string",    "reward_description": "string",    "contractual_stipulation": {      "options": [        "string"      ],      "affected_to": "string",      "instrument_start_date": "2025-12-15",      "instrument_end_date": "2025-12-15",      "other_details": "string"    },    "contractual_detail": {      "internal_rules_shift": true,      "workday_distribution": "string",      "service_type": "string",      "rut_empresa_principal": "string",      "rut_empresa_usuaria": "string"    },    "grado_sector_publico_chile": "string",    "estamento_sector_publico_chile": "string",    "termination_fundaments": "string"  },  "bank": "string",  "payment_currency": "CLP",  "payment_method": "string",  "payment_period": "string",  "advance_payment": "string",  "account_type": "string",  "account_number": "string",  "progressive_vacations_start": "2025-12-15",  "family_responsabilities": {    "id": 0,    "family_allowance_section": "string",    "maternity_family_responsability": "string",    "invalid_family_responsability": "string",    "start_date": "2025-12-15",    "end_date": "2025-12-15",    "responsability_details": {      "id": 0,      "gender": "string",      "first_name": "string",      "first_surname": "string",      "second_surname": "string",      "birthday": "2025-12-15",      "legal_responsability": "string",      "health_plan": "string",      "relation": "string",      "expiration_date": {},      "retirement_fund": "string",      "voluntary_enrollment": "string",      "voluntary_retirement_percentage": "string",      "voluntary_account_2": "string",      "custom_attributes": {},      "rut": "string"    }  },  "document_number": "string",  "document_type": "string"}
Campo Tipo Descripción
pagination object Objeto que trae los datos de paginación de la petición.
next string Endpoint para realizar la petición a la siguiente página.
previous string Endpoint para realizar la petición a la siguiente página.
count int Cantidad de objetos que trae la petición actual.
total_pages int Cantidad de paginas que trae la petición.
data array Arreglo que trae los cargos asociados al tenant.
period_type string
Frecuencia de pago: monthly, semi_monthly, weekly.
picture_url string URL de la foto del empleado.
first_name string Nombre
surname string Apellido
second_surname string Segundo apellido.
code_sheet string Código de Ficha
nationality string
Código de nacionalidad (lista provista; estilo ISO alfa-2).
gender string
Género: M, F.
civil_status string
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
birthday string Fecha de nacimiento.
email string Email corporativo.
personal_email string Email personal.
location_id integer Id Localidad, se obtiene del endpoint get /locations
address string Dirección (texto libre).
street string Calle
street_number string Número de calle.
office_number string Depto / Oficina.
city string Ciudad
payment_currency string
Moneda de pago: CLP
payment_method string
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
advance_payment string
Anticipo: sin_anticipo, anticipo_por_hora, anticipo_diario, anticipo_semanal, anticipo_quincenal.
bank string Nombre de la entidad bancaria
account_type string
Tipo de cuenta Corriente, Vista, Ahorro.
account_number string
Obligatorio si payment_method = "Transferencia Bancaria"
start_date string Ingreso a la compañía.
private_role boolean true si es Rol Privado o false si no lo es
active string
Estado: active, inactive, pending
document_number string Número de documento del empleado.
document_type string
Tipo de documento: rut, otro
🟦GET /employees- Diccionario de datos
Campo Tipo Obligatorio Descripción
status string NO
Define el estado del empleado a filtrar. Los  valores permitidos son:
  •  
    • activo
    • inactivo
    • pendiente
document_number string NO
El número de documento del colaborador, se debe entregar sin puntos ni guión.
code_sheet string NO Código de ficha del empleado
company_id string NO
Id Identificador de la empresa.
El valor se puede obtener del endpoint GET /companies.
update_start_date date NO
Fecha de actualización.
  • Si se incluye junto con company_id, valida el trabajo activo en esa fecha para definir la
    información a mostrar.
  • Si no se especifica, se considera la fecha actual.
custom_attr_job_name string NO Nombre de un atributo personalizado de trabajo.
custom_attr_job_value string NO
Valor del atributo personalizado de trabajo.
  • Si son varios valores, se deben separar con ::.
  • Ejemplo: Valor1::Valor2.
code_recinto string NO
Código del recinto.
  • Este dato se puede obtener del endpoint GET /recintos.
page_size integer NO
Tamaño de página (cantidad de colaboradores) para paginación de resultados.
  • El tamaño de la página determina la cantidad de objetos que trae la consulta, el mínimo es 25 y el máximo 100.
page integer NO
Número de página a consultar.
  • Por rendimiento de la respuesta, los resultados son paginados.
sort string NO
  • Parámetro para ordenar registros por identificador.
  •  
    • El único valor permitido es id.
    • Si no se envía, los registros se ordenan por nombre.
🟦GET /employees- Parámetros

🟦GET/ employees - Reglas de Negocio

Multi-país: Los campos dentro de la respuesta pueden variar significativamente entre Chile, México, Perú y Colombia (ej. rut vs dni, campos de seguridad social).
Campos Personalizados: La cantidad, el nombre y el tipo de campos personalizados varían según la definición de cada cliente.
Localidades: El campo location_id hace referencia a la ubicación geográfica del colaborador, estos valores cuentan con niveles jerárquicos de comuna, provincia región.
Estado: Para el caso de los colaboradores que se encuentran en estado pendiente, son colaboradores que ya se encuentran finiquitados pero a los que se les pueden asignando ítems.
Los atributos personalizados pueden estar catalogados como sensibles, en ese caso el token debe permitir ver información sensible.

 

🟦GET /employees/active

Definición:

GET /employees/active: Retorna todos los Empleados vigentes en el sistema. Un Empleado vigente es un Empleado con plan y trabajo activos en la fecha seleccionada.
Como parámetro (opcional) recibe la fecha (en formato YYYY-MM-DD) en la que deben tener un contrato vigente, si no se proporciona este parámetro entonces se tomará la fecha del mes abierto en la aplicación.
Adicionalmente, puede recibir un parámetro opcional para excluir los Empleados que se encuentren pendientes.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura' o 'Lectura y Modificación'.

🟦 GET /employees/active- CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/active'

🟦 GET /employees/active - Ejemplo Respuesta

{  "pagination": {    "next": "string",    "previous": "string",    "count": 0,    "total_pages": 0  },  "data": [    {      "period_type": "string",      "person_id": 0,      "id": 0,      "picture_url": "string",      "first_name": "string",      "surname": "string",      "second_surname": "string",      "full_name": "string",      "rut": "string",      "nationality": "string",      "country_code": "string",      "civil_status": "string",      "email": "string",      "personal_email": "string",      "address": "string",      "street": "string",      "street_number": "string",      "office_number": "string",      "city": "string",      "district": "string",      "location_id": 0,      "region": "string",      "office_phone": "string",      "phone": "string",      "gender": "string",      "birthday": "string",      "university": "string",      "degree": "string",      "active_since": "string",      "status": "string",      "private_role": true,      "code_sheet": "string",      "health_company": "string",      "pension_regime": "string",      "pension_fund": "string",      "retired": true,      "retirement_regime": "string",      "afc": "string",      "active_until": {},      "created_at": {},      "termination_reason": "string",      "custom_attributes": {},      "current_job": {        "company_id": 0,        "area_id": 0,        "contract_type": "string",        "start_date": "2026-01-02",        "end_date": "2026-01-02",        "notice_date": "2026-01-02",        "contract_finishing_date_1": "2026-01-02",        "contract_finishing_date_2": "2026-01-02",        "weekly_hours": 0,        "cost_center": "string",        "periodicity": "string",        "frequency": "string",        "role": "string",        "working_schedule_type": "string",        "other_type_of_working_day": "string",        "cost_centers": {          "id": "string",          "job_id": "string",          "weight": 0,          "cost_center": "string"        },        "location_id": "string",        "without_wage": "string",        "zone_assignment": "string",        "currency_code": "string",        "base_wage": 0,        "custom_attributes": {},        "boss": {          "id": 0,          "rut": "string",          "document_number": "string",          "document_type": "string"        },        "contract_subscription_date": "2026-01-02",        "reward": true,        "reward_concept": "string",        "reward_payment_period": "string",        "reward_description": "string",        "contractual_stipulation": {          "options": [            "string"          ],          "affected_to": "string",          "instrument_start_date": "2026-01-02",          "instrument_end_date": "2026-01-02",          "other_details": "string"        },        "contractual_detail": {          "internal_rules_shift": true,          "workday_distribution": "string",          "service_type": "string",          "rut_empresa_principal": "string",          "rut_empresa_usuaria": "string"        },        "grado_sector_publico_chile": "string",        "estamento_sector_publico_chile": "string",        "termination_fundaments": "string"      },      "bank": "string",      "payment_currency": "CLP",      "payment_method": "string",      "payment_period": "string",      "advance_payment": "string",      "account_type": "string",      "account_number": "string",      "progressive_vacations_start": "2026-01-02",      "family_responsabilities": {        "id": 0,        "family_allowance_section": "string",        "maternity_family_responsability": "string",        "invalid_family_responsability": "string",        "start_date": "2026-01-02",        "end_date": "2026-01-02",        "responsability_details": {          "id": 0,          "gender": "string",          "first_name": "string",          "first_surname": "string",          "second_surname": "string",          "birthday": "2026-01-02",          "legal_responsability": "string",          "health_plan": "string",          "relation": "string",          "expiration_date": {},          "retirement_fund": "string",          "voluntary_enrollment": "string",          "voluntary_retirement_percentage": "string",          "voluntary_account_2": "string",          "custom_attributes": {},          "rut": "string"        }      },      "document_number": "string",      "document_type": "string"    }  ]}
Campo Tipo Descripción
pagination object Objeto que trae los datos de paginación de la petición.
next string Endpoint para realizar la petición a la siguiente página.
previous string Endpoint para realizar la petición a la siguiente página.
count int Cantidad de objetos que trae la petición actual.
total_pages int Cantidad de paginas que trae la petición.
data array Arreglo que trae los cargos asociados al tenant.
period_type string
Frecuencia de pago: monthly, semi_monthly, weekly.
picture_url string URL de la foto del empleado.
first_name string Nombre
surname string Apellido
second_surname string Segundo apellido.
code_sheet string Código de Ficha
nationality string
Código de nacionalidad (lista provista; estilo ISO alfa-2).
gender string
Género: M, F.
civil_status string
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
birthday string Fecha de nacimiento.
email string Email corporativo.
personal_email string Email personal.
location_id integer Id Localidad, se obtiene del endpoint get /locations
address string Dirección (texto libre).
street string Calle
street_number string Número de calle.
office_number string Depto / Oficina.
city string Ciudad
payment_currency string
Moneda de pago: CLP
payment_method string
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
advance_payment string
Anticipo: sin_anticipo, anticipo_por_hora, anticipo_diario, anticipo_semanal, anticipo_quincenal.
bank string Nombre de la entidad bancaria
account_type string
Tipo de cuenta Corriente, Vista, Ahorro.
account_number string
Obligatorio si payment_method = "Transferencia Bancaria"
start_date string Ingreso a la compañía.
private_role boolean true si es Rol Privado o false si no lo es
active string
Estado: active, inactive, pending
document_number string Número de documento del empleado.
document_type string
Tipo de documento: rut, otro
🟦 GET /employees/active - Diccionario de datos
Campo Tipo Obligatorio Descripción
rut string NO Rut del colaborador.
code_sheet string NO Código de ficha del colaborador
date date NO Mes en el cual evaluar si el Empleado tiene contrato vigente, en formato YYYY-MM-DD. En caso de no ingresar este parámetro se usará por defecto el primer mes que se encuentre abierto en la plataforma
exclude_pending boolean NO Se excluyen los Empleados pendientes en el caso de enviar este parámetro como true
page_size integer NO Numero de objetos por página. Por defecto tiene un valor de 25 y debe estar entre un rango de [25 - 100]
🟦 GET /employees/active - Parámetros

🟦GET /employees/active - Reglas de Negocio

Multi-país: Los campos dentro de la respuesta pueden variar significativamente entre Chile, México, Perú y Colombia (ej. rut vs dni, campos de seguridad social).
Campos Personalizados: La cantidad, el nombre y el tipo de campos personalizados varían según la definición de cada cliente.
Localidades: El campo location_id hace referencia a la ubicación geográfica del colaborador, estos valores cuentan con niveles jerárquicos de comuna, provincia región.
Estado: Para el caso de los colaboradores que se encuentran en estado pendiente, son colaboradores que ya se encuentran finiquitados pero a los que se les pueden asignando ítems.
Periodo: En BUK se trabaja en base a periodos, por lo que se recomienda que en el campo date se ingrese una fecha de inicio o fin de periodo, esta se puede obtener del endpoint get /process_periods

 

🟦GET /employees/{id}

Definición:

GET /employees/{id}: Recibimos la información específica del Empleado cuya ID o RUT enviamos en la consulta.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura' o 'Lectura y Modificación'.
 

🟦 GET /employees/{id} - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TOKEN}.buk.cl/api/v1/chile/employees/{id}'

🟦 GET /employees/{id} - Ejemplo Respuesta

{  "period_type": "string",  "person_id": 0,  "id": 0,  "picture_url": "string",  "first_name": "string",  "surname": "string",  "second_surname": "string",  "full_name": "string",  "rut": "string",  "nationality": "string",  "country_code": "string",  "civil_status": "string",  "email": "string",  "personal_email": "string",  "address": "string",  "street": "string",  "street_number": "string",  "office_number": "string",  "city": "string",  "district": "string",  "location_id": 0,  "region": "string",  "office_phone": "string",  "phone": "string",  "gender": "string",  "birthday": "string",  "university": "string",  "degree": "string",  "active_since": "string",  "status": "string",  "private_role": true,  "code_sheet": "string",  "health_company": "string",  "pension_regime": "string",  "pension_fund": "string",  "retired": true,  "retirement_regime": "string",  "afc": "string",  "active_until": {},  "created_at": {},  "termination_reason": "string",  "custom_attributes": {},  "current_job": {    "company_id": 0,    "area_id": 0,    "contract_type": "string",    "start_date": "2026-01-02",    "end_date": "2026-01-02",    "notice_date": "2026-01-02",    "contract_finishing_date_1": "2026-01-02",    "contract_finishing_date_2": "2026-01-02",    "weekly_hours": 0,    "cost_center": "string",    "periodicity": "string",    "frequency": "string",    "role": "string",    "working_schedule_type": "string",    "other_type_of_working_day": "string",    "cost_centers": {      "id": "string",      "job_id": "string",      "weight": 0,      "cost_center": "string"    },    "location_id": "string",    "without_wage": "string",    "zone_assignment": "string",    "currency_code": "string",    "base_wage": 0,    "custom_attributes": {},    "boss": {      "id": 0,      "rut": "string",      "document_number": "string",      "document_type": "string"    },    "contract_subscription_date": "2026-01-02",    "reward": true,    "reward_concept": "string",    "reward_payment_period": "string",    "reward_description": "string",    "contractual_stipulation": {      "options": [        "string"      ],      "affected_to": "string",      "instrument_start_date": "2026-01-02",      "instrument_end_date": "2026-01-02",      "other_details": "string"    },    "contractual_detail": {      "internal_rules_shift": true,      "workday_distribution": "string",      "service_type": "string",      "rut_empresa_principal": "string",      "rut_empresa_usuaria": "string"    },    "grado_sector_publico_chile": "string",    "estamento_sector_publico_chile": "string",    "termination_fundaments": "string"  },  "bank": "string",  "payment_currency": "CLP",  "payment_method": "string",  "payment_period": "string",  "advance_payment": "string",  "account_type": "string",  "account_number": "string",  "progressive_vacations_start": "2026-01-02",  "family_responsabilities": {    "id": 0,    "family_allowance_section": "string",    "maternity_family_responsability": "string",    "invalid_family_responsability": "string",    "start_date": "2026-01-02",    "end_date": "2026-01-02",    "responsability_details": {      "id": 0,      "gender": "string",      "first_name": "string",      "first_surname": "string",      "second_surname": "string",      "birthday": "2026-01-02",      "legal_responsability": "string",      "health_plan": "string",      "relation": "string",      "expiration_date": {},      "retirement_fund": "string",      "voluntary_enrollment": "string",      "voluntary_retirement_percentage": "string",      "voluntary_account_2": "string",      "custom_attributes": {},      "rut": "string"    }  },  "document_number": "string",  "document_type": "string"}
Campo Tipo Descripción
data object Objeto que trae los cargos asociados al tenant.
period_type string
Frecuencia de pago: monthly, semi_monthly, weekly.
picture_url string URL de la foto del empleado.
first_name string Nombre
surname string Apellido
second_surname string Segundo apellido.
code_sheet string Código de Ficha
nationality string
Código de nacionalidad (lista provista; estilo ISO alfa-2).
gender string
Género: M, F.
civil_status string
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
birthday string Fecha de nacimiento.
email string Email corporativo.
personal_email string Email personal.
location_id integer Id Localidad, se obtiene del endpoint get /locations
address string Dirección (texto libre).
street string Calle
street_number string Número de calle.
office_number string Depto / Oficina.
city string Ciudad
payment_currency string
Moneda de pago: CLP
payment_method string
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
advance_payment string
Anticipo: sin_anticipo, anticipo_por_hora, anticipo_diario, anticipo_semanal, anticipo_quincenal.
bank string Nombre de la entidad bancaria
account_type string
Tipo de cuenta Corriente, Vista, Ahorro.
account_number string
Obligatorio si payment_method = "Transferencia Bancaria"
start_date string Ingreso a la compañía.
private_role boolean true si es Rol Privado o false si no lo es
active string
Estado: active, inactive, pending
document_number string Número de documento del empleado.
document_type string
Tipo de documento: rut, otro
🟦GET /employees/{id} - Diccionario de datos

🟦GET /employees/{id} - Reglas de Negocio

Multi-país: Los campos dentro de la respuesta pueden variar significativamente entre Chile, México, Perú y Colombia (ej. rut vs dni, campos de seguridad social).
Campos Personalizados: La cantidad, el nombre y el tipo de campos personalizados varían según la definición de cada cliente.
Localidades: El campo location_id hace referencia a la ubicación geográfica del colaborador, estos valores cuentan con niveles jerárquicos de comuna, provincia región.
Estado: Para el caso de los colaboradores que se encuentran en estado pendiente, son colaboradores que ya se encuentran finiquitados pero a los que se les pueden asignando ítems.

 

🟦 GET /employees/{id}/subordinates

Definición:

GET /employees/{id}/subordinates: Recibimos la lista de Empleados que sean subordinados del que se entregue el id.

Permisos Requeridos:

Permisos de empleados en: 'Lectura' o 'Lectura y Modificación'.
 

🟦 GET /employees/{id}/subordinates- CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://TENANT.buk.cl/api/v1/chile/employees/{id}/subordinates'

🟦 GET /employees/{id}/subordinates - Ejemplo Respuesta

{  "pagination": {    "next": "string",    "previous": "string",    "count": 0,    "total_pages": 0  },  "data": [    {      "document_number": "string",      "document_type": "string",      "rut": "string",      "id": 0,      "first_name": "string",      "surname": "string",      "second_surname": "string",      "full_name": "string",      "picture_url": "string",      "email": "string"    }  ]}
Campo Tipo Descripción
pagination object Objeto que trae los datos de paginación de la petición.
next string Endpoint para realizar la petición a la siguiente página.
previous string Endpoint para realizar la petición a la siguiente página.
count int Cantidad de objetos que trae la petición actual.
total_pages int Cantidad de paginas que trae la petición.
data array Arreglo que trae los cargos asociados al tenant.
document_number string Número de documento del empleado.
document_type string
Tipo de documento: rut, otro
número de documento string
Frecuencia de pago: monthly, semi_monthly, weekly.
id string Id del empleado
first_name string Nombre del subordinado
surname string Apellido del subordinado
second_surname string Segundo apellido del subordinado
full_name string Nombre completo del subordinado
picture_url string URL de la foto del subordinado
email string Email corporativo del subordinado
🟦GET /employees/{id}/subordinates - Diccionario de datos
Campo Tipo Obligatorio Descripción
id
 int SI Id del colaborador del cual se desean traer los empleados.
date date NO La fecha en la que deben estar vigentes los subordinados
page_size int NO (OPCIONAL) Numero de respuestas por página. Por defecto tiene un valor de 25 y debe estar entre un rango de [25 - 100]
🟦GET /employees/{id}/subordinates - Parámetros

🟦GET /employees/{id}/subordinates - Reglas de Negocio

Multi-país: Los campos dentro de la respuesta pueden variar significativamente entre Chile, México, Perú y Colombia (ej. rut vs dni, campos de seguridad social).
Fecha: El campo date hace referencia a la fecha de vigencia de los subordinados, por ejemplo: si un colaborador fue cesado antes de la fecha indicada en el campo señalado no aparecerá en la respuesta.
URL Foto: Retorna la url del repositorio en la cual se encuentra almacenado la foto de perfil del colaborador.

 

🟦GET /employees/{id}/vacations_available

Definición:

GET /employees/{id}/vacations_available: Endpoint que muestra cantidad de días disponible para vacaciones de un colaborador.

 

Permisos Requeridos:

Permisos de vacaciones en: 'Lectura' o 'Lectura y Modificación'.
 

🟦 GET /employees/{id}/vacations_available - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{id}/vacations_available'
Campo Tipo Descripción
employee_id integer Id del empleado consultado
full_name string Nombre completo del empleado
nationality string Gentilicio del colaborador
country_code string Código del país de origen del colaborador
civil_status string Estado civil del colaborador
private_role boolean true cuando es Rol Privado y false cuando no lo es
code_sheet string Código de Ficha del colaborador
health_company string
Género: M, F.
pension_regime string
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
pension_fund string Fecha de nacimiento.
afc string Email corporativo.
retired string Email personal.
retirement_regime integer Id Localidad, se obtiene del endpoint get /locations
current_job object Dirección (texto libre).
current_job.periodicity string Calle
current_job.frequency string Número de calle.
current_job.working_schedule_type string Depto / Oficina.
current_job.zone_assignment string Ciudad
vacations array
Moneda de pago: CLP
vacations.name string
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
vacations.stock integer
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
🟦 GET /employees/{id}/vacations_availables - Diccionario de datos
Campo Tipo Obligatorio Descripción
id
 int SI ID o Número de Documento del Empleado a consultar. En caso de ser Número de Documento, no debe tener puntos ni guión.
discount bool NO Descontar vacaciones tomadas a futuro. (true, false)
date date NO La fecha en la que se calculará las vacaciones pendientes (Formato: DD-MM-YYYY), por defecto será el último día del mes abierto
🟦GET /employees/{id}/vacations_available - Parámetros

🟦GET /employees/{id}/vacations_available - Reglas de Negocio

Identificador: Se recomienda utilizar el id del empleado por sobre el RUT, ya que el endpoint puede retornar un único objeto. En escenarios de multificha (más de un registro asociado a una misma persona), consultar por RUT puede generar ambigüedades o interpretaciones incorrectas sobre a qué registro corresponde la información devuelta.
discount: Campo booleano que, al activarse, permite que el cálculo descuente vacaciones ya registradas con fechas futuras (posteriores al día de la consulta), reflejando así una disponibilidad proyectada considerando esos días ya comprometidos.
Fecha / criterio de cálculo: El cálculo considera vacaciones efectivamente tomadas versus vacaciones disponibles. No contempla solicitudes de vacaciones ni sus estados (pendiente, aprobada, rechazada, etc.).

 

🟦 GET /employees/{id}/earned_vacations

Definición:

GET /employees/{id}/earned_vacations: Recibimos el detalle de las vacaciones percibidas y simulación de proporcionales hasta cierta fecha.

Permisos Requeridos:

 

Permisos de vacaciones en: 'Lectura' o 'Lectura y Modificación'.
 

🟦 GET /employees/{id}/earned_vacations - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{ID}/earned_vacations'
Campo Tipo Descripción
pagination object Objeto que trae los datos de paginación de la petición.
next string Endpoint para realizar la petición a la siguiente página.
previous string Endpoint para realizar la petición a la siguiente página.
count int Cantidad de objetos que trae la petición actual.
total_pages int Cantidad de paginas que trae la petición.
data array Arreglo que trae los cargos asociados al tenant.
vacation_definition_id int Código identificador de la política de vacaciones
vacation_type_id int Código identificador del tipo de vacación
earned_days decimal Número de días acumulados por una vacación percibida o proporcional
period_start_date date
  • Para Proporcionales: Corresponde a la fecha de inicio de vigencia, su fecha de aniversario de ingreso a la compañía más reciente
  • Para Percibidas (devengo automático en su fecha de aniversario de ingreso a la compañía): Corresponde a la misma fecha de las proporcionales que se convirtieron en este saldo devengado.
  • Para Percibidas (carga manual en una fecha dada que puede ser distinto a la del aniversario de ingreso): Corresponde a la misma fecha en que se realiza la carga pero 1 año antes.
earned_at date Fecha en que se cargó el saldo devengado (por devengo automático o por carga manual)
proportional bool Valor booleano que indica si la vacación corresponde a una vacación proporcional o no.
compensated bool Booleano que indica si la vacación es compensada o no.
expiration_date date Fecha de expiración de los días de vacaciones percibidas en caso que correspondan a un tipo de vacación vencible.
🟦 GET /employees/{id}/earned_vacations - Diccionario de datos

🟦GET /employees/{id}/vacations_available - Reglas de Negocio

  1. Fecha de corte (date): el endpoint retorna vacaciones percibidas (devengadas) y proporcionales hasta la fecha indicada; si no se envía date, se usa la fecha del día de la consulta.
  2. Paginación y límites: los resultados pueden venir paginados con page y page_size; page_size debe estar entre 25 (mín.) y 100 (máx.).
  3. vacation_type_id: Se puede obtener desde el endpoint get /vacation_definitions
  4. Semántica de period_start_date según el origen:
    • Proporcionales: period_start_date = aniversario de ingreso más reciente (inicio del período vigente).
    • Percibidas por devengo automático: mantiene el mismo period_start_date del período proporcional que se convirtió en devengado.
    • Percibidas por carga manual: period_start_date = fecha de carga - 1 año.
  5. Identificación de proporcional vs devengado y vencimiento:
    • proportional = true → saldo proporcional (simulado hasta la fecha de corte).
    • proportional = false → saldo percibido/devengado (con earned_at cuando corresponde).
    • expiration_date solo aplica si el tipo es vencible (si no, viene null).

 

🟦 GET /employees/{employee_id}/family_responsibilities/{id}

Definición:

GET /employees/{employee_id}/family_responsibilities/{id}: Retorna la información de un Grupo Familiar asociado a un Empleado.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura' o 'Lectura y Modificación'.
 

General requerida para utilizar este endpoint:

Habilitar grupo familiar, valor: true.
 

🟦 GET /employees/{employee_id}/family_responsibilities/{id} - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{ID_EMPLOYEE}/family_responsibilities/{ID_GRUPO_FAMILIAR}'
Campo Tipo Obligatorio Descripción
employee_id
 int SI ID del Empleado a consultar.
id int SÍ ID del Grupo Familiar a consultar.
🟦GET /employees/{employee_id}/family_responsibilities/{id} - Parámetros
Campo Tipo Descripción
data object Objeto que trae los datos de paginación de la petición.
data.id int id del grupo familiar
data.family_allowance_section string Tramo de Asignación
data.simple_family_responsibility int Carga Simple
data.maternity_family_responsibility int Carga Maternal
data.invalid_family_responsibility int Carga Inválida
data.start_date string  
data.end_date string  
data.responsibility_details array Arreglo que trae a las cargas familiares
data.responsibility_details[i].id int Id de la base de datos de la carga familiar
data.responsibility_details[i].rut string Rut de la carga familiar
data.responsibility_details[i].gender string Genero de la carga familiar. (male o female)
data.responsibility_details[i].first_name string Primer nombre de la carga familiar
data.responsibility_details[i].first_surname string Primer apellido de la carga familiar
data.responsibility_details[i].second_surname string Segundo apellido de la carga familiar
data.responsibility_details[i].birthday string Fecha de nacimiento de la carga familiar en formato YYYY-MM-DD
data.responsibility_details[i].legal_responsibility bool Boleando que indica si es carga legal para efectos de asignación familiar
data.responsibility_details[i].health_plan bool Plan previsional de la carga
data.responsibility_details[i].relation string Relación de la carga con el colaborador (child, husband, father, mother, other)
data.responsibility_details[i].expiration_date string Fecha de expiración de carga en formato YYYY-MM-DD
data.responsibility_details[i].retirement_fund string  
data.responsibility_details[i].voluntary_enrollment bool Booleano que indica si el trabajador es afiliado voluntario
data.responsibility_details[i].voluntary_retirement_percentage int
Porcentaje Cotización AFP
 
data.responsibility_details[i].voluntary_account_2 int Cotización Cuenta 2 de la carga
data.responsibility_details[i].custom_attributes object Objeto que trae los datos correspondientes a atributos personalizados vinculados a la carga familiar
🟦GET /employees/{employee_id}/family_responsibilities/{id} - Diccionario de datos

🟦 GET /employees/{id}/pension_savings

Definición:

GET /employees/{id}/pension_savings: Obtener los ahorros previsionales mediante el id de un Empleado
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura'.
Permisos de ítems en: 'Lectura'.
 

🟦 GET /employees/{id}/pension_savings - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{ID_EMPLOYEE}/pension_savings'
Campo Tipo Obligatorio Descripción
id
 int SI
Empleado ID
date date NO Filtra los ahorros previsionales que son vigentes para esta fecha en formato “YYYY-MM-DD”
🟦GET /employees/{id}/pension_savings - Parámetros
Campo Tipo Descripción
data array Arreglo que trae los ahorros asociados al colaborador.
type string Hace referencia al tipo de descuento, para este caso el valor fijo seria APVI
institution string Es la entidad financiera o administradora donde se contrata y mantiene el APVI.
amount integer Valor del APVI informado para el registro (monto asociado al plan).
currency string Moneda en la que se expresa el monto del APVI.
deposit_type string Modalidad de pago del APVI (p. ej., directo).
document string Identificador del contrato/comprobante del APVI (número de documento).
reduction bool Indica si el APVI se considera con rebaja de impuestos (booleano).
start_date string
Mes de inicio de vigencia del APVI; se envía como fecha con día 01 (YYYY-MM-01).
end_date string
Mes de término de vigencia del APVI; se envía como fecha con día 01 (YYYY-MM-01).
GET /employees/{id}/pension_savings - Diccionario de datos

🟦 GET /employees/{id}/plans

Definición:

GET /employees/{id}/plans: Retorna la información de los planes asociados a un Empleado. (endpoint no implementado para México)
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura'.
 

🟦 GET /employees/{id}/pension_savings - CURL Ejemplo

curl -X GET --header 'Accept: application/json' --header 'auth_token: {TOKEN}' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{ID_EMPLEADO}/plans'
 
Campo Tipo Obligatorio Descripción
id
 int SI
Empleado ID del colaborador que se quiere obtener información previsional
🟦GET /employees/{id}/plans - Parámetros
Campo Tipo Descripción
pagination object Objeto que trae los datos de paginación de la petición.
pagination.next string Endpoint para realizar la petición a la siguiente página.
pagination.previous string Endpoint para realizar la petición a la siguiente página.
pagination.count int Cantidad de objetos que trae la petición actual.
pagination.total_pages int Cantidad de paginas que trae la petición.
data array Arreglo que trae los planes asociados al colaborador.
data[i].start_date string Mes/fecha desde la cual rige la configuración previsional informada (se representa como YYYY-MM-01 cuando aplica por mes).
data[i].pension_scheme string Régimen previsional del trabajador (p. ej., AFP/IPS u otro según país/tenant).
data[i].fund_quote string AFP/Fondo previsional seleccionado para la cotización (p. ej., Capital, Habitat).
data[i].health_company string Institución de salud previsional (Fonasa o Isapre).
data[i].health_company_plan integer Valor del plan de salud
data[i].health_company_plan_currency integer Identificador del contrato/comprobante del APVI (número de Moneda del plan de salud, puede ser peso, uf o porcentaje
data[i].health_company_plan_percentage integer Porcentaje del plan de salud cuando se expresa como %
data[i].disability bool Indica si el trabajador está marcado como en situación de discapacidad (true/false).
data[i].disability_start_date string Fecha desde la cual se considera informada/notificada la discapacidad (si aplica).
data[i].invalidity string Estado de invalidez (p. ej., “no”).
data[i].invalidity_start_date string Fecha desde la cual rige la invalidez (si aplica).
data[i].afc string Condición/tipo de AFC del trabajador.
data[i].afp_collector string Recaudador asociado a AFP
data[i].start_date_quotation_afc string Fecha desde la cual comienza la cotización AFC
data[i].youth_employment_subsidy bool Indica si el trabajador tiene habilitado el subsidio de cotización para trabajadores jóvenes.
data[i].retired bool Indica si el trabajador está marcado como jubilado (true/false).
data[i].retirement_regime integer Régimen asociado a la jubilación
 
data[i].fun integer Identificador/código asociado al plan o registro previsional según configuración
data[i].ips_rate integer Tasa IPS
data[i].foreign_technician bool Indica si el trabajador está marcado como técnico extranjero .
data[i].quote_increase_one_percent bool Indica si aplica incremento de cotización del 1%.
🟦GET /employees/{id}/plans - Diccionario de datos

🟦 GET /employees/{id}/plans - Reglas de negocio

  • Búsqueda de planes colaboradores: La búsqueda de planes se realiza solo mediante el id, para este caso el rut no es válido.
  • Historial: Un colaborador tiene muchos planes pero NO DE MANERA SIMULTANEA. Cada modificación genera un nuevo plan y con un nuevo id. Esto se debe a que cada plan está vinculado a un periodo.
  • Todos los planes están vinculados a periodos de remuneraciones. La información de periodos se puede obtener a través del API get /process_periods
 
 

🟩 POST /employees

Definición:

POST /employees: Permite almacenar la información de los Empleados.
 

Permisos Requeridos:

Permisos de empleados en: Lectura y Modificación.
 

🟩 POST /employees- CURL Ejemplo

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'auth_token: {TOKEN}' -d '{ \    "period_type": "string", \    "picture_url": "string", \    "first_name": "string", \    "surname": "string", \    "second_surname": "string", \    "code_sheet": "string", \    "nationality": "AD", \    "gender": "M", \    "civil_status": "Casado", \    "birthday": "2026-01-02", \    "email": "string", \    "personal_email": "string", \    "location_id": 0, \    "address": "string", \    "street": "string", \    "street_number": "string", \    "office_number": "string", \    "city": "string", \    "payment_currency": "CLP", \    "payment_method": "Cheque", \    "payment_period": "mensual", \    "advance_payment": "sin_anticipo", \    "bank": "Scotiabank", \    "account_type": "Corriente", \    "account_number": "string", \    "start_date": "2026-01-02", \    "private_role": true, \    "active": "active", \    "document_number": "string", \    "document_type": "string" \  }' 'https://{TENANT}.buk.cl/api/v1/chile/employees'
Campo Tipo Obligatorio Descripción
period_type string NO
Frecuencia de pago: monthly, semi_monthly, weekly.
picture_url string NO URL de la foto del empleado.
first_name string SI Nombre
surname string SI Apellido
second_surname string NO Segundo apellido.
code_sheet string SI Código de Ficha
nationality string SI
Código de nacionalidad (lista provista; estilo ISO alfa-2).
gender string SI
Género: M, F.
civil_status string NO
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
birthday string SI Fecha de nacimiento.
email string NO Email corporativo.
personal_email string NO Email personal.
location_id integer SI Id Localidad, se obtiene del endpoint get /locations
address string SI Dirección (texto libre).
street string NO Calle
street_number string NO Número de calle.
office_number string NO Depto / Oficina.
city string NO Ciudad
payment_currency string NO
Moneda de pago: CLP
payment_method string NO
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string SI
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
advance_payment string NO
Anticipo: sin_anticipo, anticipo_por_hora, anticipo_diario, anticipo_semanal, anticipo_quincenal.
bank string CONDICIONAL Nombre de la entidad bancaria. Obligatorio cuando payment_method = Transferencia Bancaria
account_type string CONDICIONAL
Tipo de cuenta Corriente, Vista, Ahorro. Obligatorio cuando payment_method = Transferencia Bancaria
account_number string CONDICIONAL
Número de Cuenta Bancaria. Obligatorio si payment_method = "Transferencia Bancaria"
start_date string SI Fecha de Ingreso a la compañía.
private_role boolean NO true si es Rol Privado o false si no lo es
active string NO
Estado: active, inactive, pending
document_number string SI Número de documento del empleado.
document_type string NO
Tipo de documento: rut, otro
🟩 POST /employees - Diccionario de datos
Campo Opciones
nationality
 [“AD”,“AE”,“AF”,“AG”,“AI”,“AL”,“AM”,“AO”,“AQ”,“AR”,“AS”,“AT”,“AU”,“AW”,“AX”,“AZ”,“BA”,“BB”,“BD”,“BE”,“BF”,“BG”,“BH”,“BI”,“BJ”,“BL”,“BM”,“BN”,“BO”,“BQ”,“BR”,“BS”,“BT”,“BV”,“BW”,“BY”,“BZ”,“CA”,“CC”,“CD”,“CF”,“CG”,“CH”,“CI”,“CK”,“CL”,“CM”,“CN”,“CO”,“CR”,“CU”,“CV”,“CW”,“CX”,“CY”,“CZ”,“DE”,“DJ”,“DK”,“DM”,“DO”,“DZ”,“EC”,“EE”,“EG”,“EH”,“ER”,“ES”,“ET”,“FI”,“FJ”,“FK”,“FM”,“FO”,“FR”,“GA”,“GB”,“GD”,“GE”,“GF”,“GG”,“GH”,“GI”,“GL”,“GM”,“GN”,“GP”,“GQ”,“GR”,“GS”,“GT”,“GU”,“GW”,“GY”,“HK”,“HM”,“HN”,“HR”,“HT”,“HU”,“ID”,“IE”,“IL”,“IM”,“IN”,“IO”,“IQ”,“IR”,“IS”,“IT”,“JE”,“JM”,“JO”,“JP”,“KE”,“KG”,“KH”,“KI”,“KM”,“KN”,“KP”,“KR”,“KW”,“KY”,“KZ”,“LA”,“LB”,“LC”,“LI”,“LK”,“LR”,“LS”,“LT”,“LU”,“LV”,“LY”,“MA”,“MC”,“MD”,“ME”,“MF”,“MG”,“MH”,“MK”,“ML”,“MM”,“MN”,“MO”,“MP”,“MQ”,“MR”,“MS”,“MT”,“MU”,“MV”,“MW”,“MX”,“MY”,“MZ”,“NA”,“NC”,“NE”,“NF”,“NG”,“NI”,“NL”,“NO”,“NP”,“NR”,“NU”,“NZ”,“OM”,“PA”,“PE”,“PF”,“PG”,“PH”,“PK”,“PL”,“PM”,“PN”,“PR”,“PS”,“PT”,“PW”,“PY”,“QA”,“RE”,“RO”,“RS”,“RU”,“RW”,“SA”,“SB”,“SC”,“SD”,“SE”,“SG”,“SH”,“SI”,“SJ”,“SK”,“SL”,“SM”,“SN”,“SO”,“SR”,“SS”,“ST”,“SV”,“SX”,“SY”,“SZ”,“TC”,“TD”,“TF”,“TG”,“TH”,“TJ”,“TK”,“TL”,“TM”,“TN”,“TO”,“TR”,“TT”,“TV”,“TW”,“TZ”,“UA”,“UG”,“UM”,“US”,“UY”,“UZ”,“VA”,“VC”,“VE”,“VG”,“VI”,“VN”,“VU”,“WF”,“WS”,“YE”,“YT”,“ZA”,“ZM”,“ZW”]
gender [“M”,“F”]
civil_status [“Casado”,“Divorciado”,“Soltero”,“Viudo”,“Acuerdo de Unión Civil”]
payment_method [“Transferencia Bancaria”,“No Generar Pago”,“Vale Vista”,“Servipag”,“Cheque”]
payment_period [“semanal”,“mensual”,“quincenal”,“diario”,“por_hora”]
advance_payment [“sin_anticipo”,“anticipo_por_hora”,“anticipo_diario”,“anticipo_semanal”,“anticipo_quincenal”]
account_type [“Corriente”,“Vista”,“Ahorro”]
bank [“BBVA”,“BCI”,“BICE”,“Banco de Chile”,“Consorcio”,“COOPEUCH”,“Corpbanca”,“CrediChile”,“Banco Estado”,“Falabella”,“Internacional”,“Rabobank”,“BTG Pactual”,“Ripley”,“Santander”,“Scotiabank”,“Security”,“The Bank of Tokyo-Mitsubishi”,“Sociedad Emisora de Tarjetas Los Heroes S.A.”,“Tenpo Prepago SA”,“Global 66”,“Mercadopago Emisora S.A.”,“Los Andes Tarjetas de Prepago”,“JP Morgan Chase Bank”,“Banco Deutsche”,“Copec Pay”,“MACH”,“HSBC”,“Itau”]
active [“active”,“inactive”,“pending”]
document_number {“rut”:“RUT”,“otro”:“Otro”}
🟩 POST /employees - Catálogo de valores

🟩 POST /employees - Reglas de negocio

  • Estado Empleados: Un colaborador puede existir dentro del sistema sin estar vinculado a un plan previsional o a un trabajo, pero existirá como inactivo.
  • Al momento de crear a un colaborador no se da por defecto de alta el usuario, eso debe realizarse de manera independiente.
  • Para el campos personalizados se debe respetar el nombre y la obligatoriedad que se indicó por interfaz y dentro de la estructura estos están en el objeto custom_attributes
  • Los atributos personalizados deben ser creados y gestionados en Administración=>Atributos Personalizados=>Crear Atributo personalizado por un usuario con permisos de administrador.

 

🟩 POST /employees/{idEmpleado}/clone

Definición:

POST /employees/{id}/clone: Permite crear una nueva ficha tomando como referencia otra existente. Esto incluye el detalle de cada una de las cargas de su grupo familiar. Recibe los campos que serán distintos, los demás serán copiados de la ficha de referencia.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura y Modificación'.
 

General requerida para utilizar este endpoint:

Doble trabajo, valor: true.
 

🟩 POST /employees/{idEmpleado}/clone - CURL Ejemplo

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'auth_token: {TOKEN}' -d '{ \    "payment_method": "Cheque", \    "payment_period": "mensual", \    "bank": "Scotiabank", \    "account_type": "Corriente", \    "account_number": "string", \    "code_sheet": "string", \    "start_date": "2026-01-02", \    "private_role": true, \    "custom_attributes": {}, \    "period_type": "string" \  }' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{ID_EMPLOYEE}/clone'
Campo Tipo Obligatorio Descripción
period_type string NO
Frecuencia de pago: monthly, semi_monthly, weekly.
code_sheet string SI Código de Ficha
payment_method string NO
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string SI
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
bank string CONDICIONAL Nombre de la entidad bancaria. Obligatorio cuando payment_method = Transferencia Bancaria
account_type string CONDICIONAL
Tipo de cuenta Corriente, Vista, Ahorro. Obligatorio cuando payment_method = Transferencia Bancaria
account_number string CONDICIONAL
Número de Cuenta Bancaria. Obligatorio si payment_method = "Transferencia Bancaria"
start_date string SI Fecha de Ingreso a la compañía.
private_role boolean NO true si es Rol Privado o false si no lo es
custom_attributes object NO Objeto de tipo clave valor en donde se pueden clonar los campos personalizados.
🟩 POST /employees/{idEmpleado}/clone - Diccionario de datos
Campo Opciones
nationality
 [“AD”,“AE”,“AF”,“AG”,“AI”,“AL”,“AM”,“AO”,“AQ”,“AR”,“AS”,“AT”,“AU”,“AW”,“AX”,“AZ”,“BA”,“BB”,“BD”,“BE”,“BF”,“BG”,“BH”,“BI”,“BJ”,“BL”,“BM”,“BN”,“BO”,“BQ”,“BR”,“BS”,“BT”,“BV”,“BW”,“BY”,“BZ”,“CA”,“CC”,“CD”,“CF”,“CG”,“CH”,“CI”,“CK”,“CL”,“CM”,“CN”,“CO”,“CR”,“CU”,“CV”,“CW”,“CX”,“CY”,“CZ”,“DE”,“DJ”,“DK”,“DM”,“DO”,“DZ”,“EC”,“EE”,“EG”,“EH”,“ER”,“ES”,“ET”,“FI”,“FJ”,“FK”,“FM”,“FO”,“FR”,“GA”,“GB”,“GD”,“GE”,“GF”,“GG”,“GH”,“GI”,“GL”,“GM”,“GN”,“GP”,“GQ”,“GR”,“GS”,“GT”,“GU”,“GW”,“GY”,“HK”,“HM”,“HN”,“HR”,“HT”,“HU”,“ID”,“IE”,“IL”,“IM”,“IN”,“IO”,“IQ”,“IR”,“IS”,“IT”,“JE”,“JM”,“JO”,“JP”,“KE”,“KG”,“KH”,“KI”,“KM”,“KN”,“KP”,“KR”,“KW”,“KY”,“KZ”,“LA”,“LB”,“LC”,“LI”,“LK”,“LR”,“LS”,“LT”,“LU”,“LV”,“LY”,“MA”,“MC”,“MD”,“ME”,“MF”,“MG”,“MH”,“MK”,“ML”,“MM”,“MN”,“MO”,“MP”,“MQ”,“MR”,“MS”,“MT”,“MU”,“MV”,“MW”,“MX”,“MY”,“MZ”,“NA”,“NC”,“NE”,“NF”,“NG”,“NI”,“NL”,“NO”,“NP”,“NR”,“NU”,“NZ”,“OM”,“PA”,“PE”,“PF”,“PG”,“PH”,“PK”,“PL”,“PM”,“PN”,“PR”,“PS”,“PT”,“PW”,“PY”,“QA”,“RE”,“RO”,“RS”,“RU”,“RW”,“SA”,“SB”,“SC”,“SD”,“SE”,“SG”,“SH”,“SI”,“SJ”,“SK”,“SL”,“SM”,“SN”,“SO”,“SR”,“SS”,“ST”,“SV”,“SX”,“SY”,“SZ”,“TC”,“TD”,“TF”,“TG”,“TH”,“TJ”,“TK”,“TL”,“TM”,“TN”,“TO”,“TR”,“TT”,“TV”,“TW”,“TZ”,“UA”,“UG”,“UM”,“US”,“UY”,“UZ”,“VA”,“VC”,“VE”,“VG”,“VI”,“VN”,“VU”,“WF”,“WS”,“YE”,“YT”,“ZA”,“ZM”,“ZW”]
gender [“M”,“F”]
civil_status [“Casado”,“Divorciado”,“Soltero”,“Viudo”,“Acuerdo de Unión Civil”]
payment_method [“Transferencia Bancaria”,“No Generar Pago”,“Vale Vista”,“Servipag”,“Cheque”]
payment_period [“semanal”,“mensual”,“quincenal”,“diario”,“por_hora”]
advance_payment [“sin_anticipo”,“anticipo_por_hora”,“anticipo_diario”,“anticipo_semanal”,“anticipo_quincenal”]
account_type [“Corriente”,“Vista”,“Ahorro”]
bank [“BBVA”,“BCI”,“BICE”,“Banco de Chile”,“Consorcio”,“COOPEUCH”,“Corpbanca”,“CrediChile”,“Banco Estado”,“Falabella”,“Internacional”,“Rabobank”,“BTG Pactual”,“Ripley”,“Santander”,“Scotiabank”,“Security”,“The Bank of Tokyo-Mitsubishi”,“Sociedad Emisora de Tarjetas Los Heroes S.A.”,“Tenpo Prepago SA”,“Global 66”,“Mercadopago Emisora S.A.”,“Los Andes Tarjetas de Prepago”,“JP Morgan Chase Bank”,“Banco Deutsche”,“Copec Pay”,“MACH”,“HSBC”,“Itau”]
active [“active”,“inactive”,“pending”]
document_number {“rut”:“RUT”,“otro”:“Otro”}
🟩 POST /employees/{idEmpleado}/clone - Catálogo de valores

🟩 POST /employees/{idEmpleado}/clone - Reglas de negocio

  • Clonación Empleados: Este endpoint está orientado a creación de fichas nuevas a colaboradores ya existentes, por lo mismo solo se clonan los datos mencionados en el diccionario.
  • Identificador Base de Datos: Al crearse un nuevo registro este retornará un nuevo id de colaborador.
  • Los datos ingresados deben respetar la misma nomenclatura del catalogo de valores.
  • Los atributos personalizados deben ser creados y gestionados en Administración=>Atributos Personalizados=>Crear Atributo personalizado por un usuario con permisos de administrador.

🟧 PATCH /employees/{id}

Definición:

PATCH /employees/{id}: Actualiza la información del Empleado.
 

Permisos Requeridos:

Permisos de empleados en: 'Lectura y Modificación'.
 

🟧 PATCH /employees/{id}- CURL Ejemplo

curl -X PATCH --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'auth_token: {TOKEN}' -d '{ \    "picture_url": "string", \    "first_name": "string", \    "surname": "string", \    "second_surname": "string", \    "code_sheet": "string", \    "nationality": "AD", \    "gender": "M", \    "civil_status": "Casado", \    "birthday": "2026-01-02", \    "email": "string", \    "personal_email": "string", \    "location_id": 0, \    "address": "string", \    "street": "string", \    "street_number": "string", \    "office_number": "string", \    "city": "string", \    "payment_currency": "CLP", \    "payment_method": "Cheque", \    "payment_period": "mensual", \    "advance_payment": "sin_anticipo", \    "bank": "Scotiabank", \    "account_type": "Corriente", \    "account_number": "string", \    "start_date": "2026-01-02", \    "private_role": true, \    "active": "active", \    "document_number": "string", \    "document_type": "string" \  }' 'https://{TENANT}.buk.cl/api/v1/chile/employees/{id}'
Campo Tipo Descripción
period_type string
Frecuencia de pago: monthly, semi_monthly, weekly.
picture_url string URL de la foto del empleado.
first_name string Nombre
surname string Apellido
second_surname string Segundo apellido.
code_sheet string Código de Ficha
nationality string
Código de nacionalidad (lista provista; estilo ISO alfa-2).
gender string
Género: M, F.
civil_status string
Estado civil: Casado, Divorciado, Soltero, Viudo, Acuerdo de Unión Civil.
birthday string Fecha de nacimiento.
email string Email corporativo.
personal_email string Email personal.
location_id integer Id Localidad, se obtiene del endpoint get /locations
address string Dirección (texto libre).
street string Calle
street_number string Número de calle.
office_number string Depto / Oficina.
city string Ciudad
payment_currency string
Moneda de pago: CLP
payment_method string
Forma de pago: Cheque, Servipag, Vale Vista, No Generar Pago, Transferencia Bancaria.
payment_period string
Periodo de pago: semanal, mensual, quincenal, diario, por_hora.
advance_payment string
Anticipo: sin_anticipo, anticipo_por_hora, anticipo_diario, anticipo_semanal, anticipo_quincenal.
bank string Nombre de la entidad bancaria. Obligatorio cuando payment_method = Transferencia Bancaria
account_type string
Tipo de cuenta Corriente, Vista, Ahorro. Obligatorio cuando payment_method = Transferencia Bancaria
account_number string
Número de Cuenta Bancaria. Obligatorio si payment_method = "Transferencia Bancaria"
start_date string Fecha de Ingreso a la compañía.
private_role boolean true si es Rol Privado o false si no lo es
active string
Estado: active, inactive, pending
document_number string Número de documento del empleado.
document_type string
Tipo de documento: rut, otro
🟧 PATCH /employees/{id} - Diccionario de datos

🟧 PATCH /employees/{id} - Reglas de negocio

  • Estado Empleados: Un colaborador puede existir dentro del sistema sin estar vinculado a un plan previsional o a un trabajo, pero existirá como inactivo.
  • Al momento de crear a un colaborador no se da por defecto de alta el usuario, eso debe realizarse de manera independiente.
  • Para el campos personalizados se debe respetar el nombre y la obligatoriedad que se indicó por interfaz y dentro de la estructura estos están en el objeto custom_attributes
  • Los atributos personalizados deben ser creados y gestionados en Administración=>Atributos Personalizados=>Crear Atributo personalizado por un usuario con permisos de administrador.
 

Artículos relacionados