Skip to main content

Overview

The Career Trajectory API manages employment history and career information. The system handles two distinct evaluation types:
  • Permanencia (Current Employees): For existing employees undergoing background re-evaluation
  • Nuevo Ingreso (New Hires): For candidates applying for new positions
Additionally, this API captures information about family members in legal processes and family members working in law enforcement.

Authentication

All endpoints require authentication via the isLoggedIn middleware. Users must have an active session to access these endpoints.

Get Career Trajectory Data

Retrieves career trajectory data based on evaluation type.

Path Parameters

encyptData
string
required
Encrypted evaluation data

Response

For Permanencia (tipoEvalID === 1):
dataTrayectoria
object
Career trajectory data for current employees
GetAdscripciones
array
Array of previous department assignments within the organization
GetFamProceso
array
Family members with legal processes
GetFamCorp
array
Family members in law enforcement/corporation
For Nuevo Ingreso (tipoEvalID !== 1):
dataTrayectoria
object
Career trajectory data for new hire candidates
GetEmpleos
array
Array of previous employment records
GetFamProceso
array
Family members with legal processes
GetFamCorp
array
Family members in law enforcement/corporation

Save Career Trajectory (Permanencia)

Saves career trajectory information for current employees.

Request Body

evalID
string
required
Evaluation ID

Current Position Information

trayectoriaDependencia
string
required
Government department or agency
trayectoriaAdscripcion
string
required
Current department assignment
trayectoriaCargo
string
required
Current job position/role
trayectoriaGrado
string
required
Rank or grade level
trayectoriaFechaIngreso
date
required
Date of entry into the organization
trayectoriaPromocion
date
Date of last promotion
trayectoriaZonaTrabajo
string
required
Work zone or area

Job Responsibilities

trayectoriaPortaArma
string
required
Whether employee carries a firearm (“Si” or “No”)
trayectoriaPersonal
string
required
Whether manages personnel (“Si” or “No”)
trayectoriaCuantos
integer
Number of people managed (if applicable)
trayectoriaFunciones
text
required
Detailed description of job functions

Supervisor Information

trayectoriaNombreJefe
string
required
Supervisor’s name
trayectoriaPuestoJefe
string
required
Supervisor’s position
trayectoriaNumJefe
string
required
Supervisor’s contact number

Disciplinary History

trayectoriaAcusaciones
string
required
Any accusations (“Si” or “No”)
trayectoriaProcesos
string
required
Any legal processes (“Si” or “No”)
trayectoriaSanciones
string
required
Any sanctions (“Si” or “No”)
trayectoriaProcedimientos
string
required
Any administrative procedures (“Si” or “No”)
trayectoriaQuejas
string
required
Any complaints (“Si” or “No”)
trayectoriaOcurrioProcesos
string
Description of what occurred (if applicable)
trayectoriaMotivoProcesos
string
Reason for the process
trayectoriaDocumentosProcesos
string
Supporting documents

CCC (Control, Confianza, Certificación) History

trayectoriaUltimoCcc
date
Date of last CCC evaluation
trayectoriaDondeCcc
string
Where the CCC was conducted
trayectoriaDependenciaCcc
string
Agency that conducted the CCC
trayectoriaMotivoCcc
string
Reason for CCC evaluation

Response

success
string
“Se guardaron datos laborales. Continua con Adscripciones” - Work data saved, continue with assignments

Update Career Trajectory (Permanencia)

Updates career trajectory information for current employees. Contains all fields from SaveTrayectoria plus:
trayectoriaTipoEval
string
required
Evaluation type identifier
Name of family member with legal issues
Relationship to family member
What legal situation occurred
Additional legal details
trayectoriaNombreCorp
string
Name of family member in corporation
trayectoriaParentescoCorp
string
Relationship to family member in corporation

Response

success
string
“Se actualizaron datos laborales. Continua con Adscripciones” - Work data updated

Save Career Trajectory (Nuevo Ingreso)

Saves career trajectory for new hire candidates.

Request Body

evalID
string
required
Evaluation ID
trayectoriaPuestoEval
string
required
Position applying for
trayectoriaEnteroVacante
string
required
How they learned about the vacancy
trayectoriaFuncion1
text
required
First key function they expect to perform
trayectoriaFuncion2
text
required
Second key function
trayectoriaFuncion3
text
required
Third key function
trayectoriaAcusaciones
string
required
Any accusations (“Si” or “No”)
trayectoriaProcesos
string
required
Any legal processes (“Si” or “No”)
trayectoriaSanciones
string
required
Any sanctions (“Si” or “No”)
trayectoriaProcedimientos
string
required
Any administrative procedures (“Si” or “No”)
trayectoriaQuejas
string
required
Any complaints (“Si” or “No”)
trayectoriaOcurrio
string
What occurred (if applicable)
trayectoriaMotivo
string
Reason for the process
trayectoriaDocResolucion
string
Resolution documents
trayectoriaCcc
string
required
Whether they’ve had CCC before (“Si” or “No”)
trayectoriaCccCuando
date
When CCC was conducted
trayectoriaCccDependencia
string
Which agency conducted CCC
trayectoriaCccMotivo
string
Reason for CCC

Response

success
string
“Se guardó trayectoria laboral NI!” - Career trajectory saved for new hire

Update Career Trajectory (Nuevo Ingreso)

Updates career trajectory for new hires. Contains all SaveTrayectoriaNI fields plus:
Name of family member with legal issues
Relationship to family member
What legal situation occurred
Additional legal details
trayectoriaSpNombre
string
Name of family member in service/corporation
trayectoriaSpParentesco
string
Relationship
trayectoriaSpPuesto
string
Their position
trayectoriaSpDependencia
string
Their department/agency

Response

success
string
“Se actrualizó trayectoria laboral NI!” - Career trajectory updated

Save Previous Employment

Saves previous employment records for new hire candidates.

Request Body

evalID
string
required
Evaluation ID
num
string
required
Number of employment records being submitted (“1” for single, or count for multiple)
For single employment (num === “1”):
empleoEmpresa
string
required
Company name
empleoPuesto
string
required
Position held
empleoDireccion
string
required
Company address
empleoPeriodo
string
required
Employment period
empleoIngreso
string
required
Salary/income
empleoMotivo
string
required
Reason for leaving
For multiple employments, all fields above should be arrays.

Response

success
string
“Se guardaron empleos” - Employments saved successfully

Delete Employment

Deletes a previous employment record.

Request Body

empleoID
string
required
ID of the employment record to delete

Response

success
string
“Se elimino empleo” - Employment deleted successfully

Save Department Assignments

Saves previous department assignments for current employees.

Request Body

evalID
string
required
Evaluation ID
num
string
required
Number of assignment records
adscripcionNombre
string
required
Department name
adscripcionPuesto
string
required
Position held
adscripcionPeriodo
string
required
Time period
adscripcionIngreso
string
required
Salary during this period
adscripcionMotivo
string
required
Reason for change
adscripcionJefe
string
required
Supervisor’s name

Response

success
string
“Se guardaron adscripciones” - Assignments saved successfully

Records family members involved in legal processes.

Request Body

evalID
string
required
Evaluation ID
famProcesoNombre
string
required
Name of family member
famProcesoParentesco
string
required
Relationship to candidate
famProcesoCuando
string
required
When the legal issue occurred
famProcesoQue
text
required
Description of the legal situation

Response

success
string
“Se guardaro familiar con proceso” - Family member with legal process saved

Save Family in Corporation

Records family members working in law enforcement or the corporation.

Request Body

evalID
string
required
Evaluation ID
corpFamiliarNombre
string
required
Name of family member
corpFamiliarParentesco
string
required
Relationship to candidate

Response

success
string
“Se guardaro familiar en coorporacion” - Family member in corporation saved

Error Responses

All endpoints return:
message
string
“Algo salio mal !” - Generic error message

Workflow

For Permanencia (Current Employees):

  1. Get trajectory data
  2. Save/Update career trajectory
  3. Save department assignments
  4. Add family in legal processes (if applicable)
  5. Add family in corporation (if applicable)

For Nuevo Ingreso (New Hires):

  1. Get trajectory data
  2. Save/Update career trajectory for new hire
  3. Save previous employments
  4. Add family in legal processes (if applicable)
  5. Add family in corporation (if applicable)

Build docs developers (and LLMs) love