BGC Laboral (Historial Laboral)

El proceso BGC Laboral realiza una consulta automatizada para obtener el historial laboral oficial del candidato (ej: IMSS en México), permitiendo corroborar semanas cotizadas, empleadores anteriores y salarios base registrados.

Restricción de Entidad

Este proceso es exclusivo para Personas Físicas (Candidatos individuales). No está disponible para registros corporativos o comerciales.

Métodos de Registro (Payloads de Entrada)

Para inicializar el proceso laboral de un candidato, se admiten dos métodos de registro en el payload de entrada. El uso del Número de Seguridad Social (nss) es opcional pero altamente recomendado, ya que agiliza la localización en la fuente oficial.

Opción A: Registro por Identificador Nacional

Este método permite registrar al candidato utilizando su identificador nacional (como CURP en México).

{
  "byNationalId": true,
  "nationalId": "CURP_PLACEHOLDER",
  "clientId": "CL_12345",
  "package": "PKG_LABORAL_01",
  "taxClassification": "PF",
  "nss": "12345678901" // Opcional: Proporcionarlo agiliza la localización en la fuente oficial
}

Opción B: Registro por Datos Demográficos

Este método permite registrar al candidato mediante sus datos demográficos completos en caso de no contar con el identificador nacional.

{
  "byNationalId": false,
  "clientId": "CL_12345",
  "name": "JANE",
  "lastName": "DOE",
  "secondLastName": "SMITH",
  "birthDate": "1995-05-10",
  "sex": "F",
  "state": "SP",
  "package": "PKG_LABORAL_01",
  "nss": "12345678901" // Opcional
}

---

Arquitectura de Respuestas (Summary vs Extended)

La API estructurará la información laboral retornada en función del nivel de detalle consultado por medio del query parameter detail:

• Métricas Globales (Vista Summary): Por defecto, la API entrega el consolidado general del candidato en el nodo detail, el cual incluye campos como total_semanas_cotizadas, total_razones_sociales, total_empleos, semanas promedio, etc.
• Historial Detallado (Vista Extended / ?detail=true): Habilita la inclusión del arreglo historia_laboral dentro del nodo detail. Este arreglo desglosa cronológicamente cada una de las relaciones obrero-patronales registradas del candidato.

Origen de los Datos

Nota sobre el formato: Los campos internos del objeto detail e historia_laboral se presentan en español y mantienen la nomenclatura técnica oficial de la institución de seguridad social emisora (ej: registro_patronal, salario_base_cotizacion). Esto garantiza la integridad, fidelidad y transparencia de los datos crudos extraídos de la fuente gubernamental.

---

Ejemplo de Respuesta Comentado

A continuación se muestran ejemplos estructurados y totalmente anonimizados que diferencian la respuesta básica de la extendida utilizando datos ficticios.

Vista Summary (Básica)

Esta estructura básica se presenta por defecto (sin pasar ?detail=true), devolviendo únicamente las métricas globales calculadas para el candidato.

{
  "isSuccess": true,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "processId": "zrQKr9R0ksg0QHMQ3Wo1",
    "processName": "BGC Laboral",
    "detail": {
      "nss": "12345678901",
      "fecha_emision_reporte": "2026-06-29",
      "total_semanas_cotizadas": "17", // Total de semanas acumuladas en la vida laboral institucional
      "total_razones_sociales": "2",
      "total_empleos": "2"
    },
    "status": "Finalizado",
    "result": "Proceso completo"
  }
}

Vista Extended (Detallada)

Esta estructura incluye la trayectoria laboral cronológica completa del candidato en el arreglo historia_laboral, habilitada mediante el parámetro de consulta ?detail=true.

{
  "isSuccess": true,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "processId": "zrQKr9R0ksg0QHMQ3Wo1",
    "processName": "BGC Laboral",
    "detail": {
      "nss": "12345678901",
      "fecha_emision_reporte": "2026-06-29",
      "total_semanas_cotizadas": "17", // Total de semanas acumuladas en la vida laboral institucional
      "total_razones_sociales": "2",
      "total_empleos": "2",
      
      // [Habilitado únicamente si se consulta con el parámetro ?detail=true]
      "historia_laboral": [
        {
          "registro_patronal": "Y622902310", // Identificador oficial del patrón
          "nombre": "EMPRESA DE PRUEBA S.A. DE C.V.",
          "fecha_alta": "2024-09-26",
          "fecha_baja": "2025-01-20",
          "salario_base_cotizacion": "$379.1", // Salario diario registrado ante la institución
          "semanas_laboradas": "16"
        },
        {
          "registro_patronal": "A123456789", // Identificador oficial del patrón
          "nombre": "EMPRESA EJEMPLO S.A. DE C.V.",
          "fecha_alta": "2023-01-10",
          "fecha_baja": "2023-01-17",
          "salario_base_cotizacion": "$350.0", // Salario diario registrado ante la institución
          "semanas_laboradas": "1"
        }
      ]
    },
    "status": "Finalizado",
    "result": "Proceso completo"
  }
}