Skip to content

Capítulo 2 - "Automatización de Consulta de Historial Laboral"

Aprende a consultar de manera automatizada el historial laboral de un contribuyente utilizando su CURP con la API de Moffin Solutions.

Requisitos

Antes de comenzar, asegúrate de tener:

  • Un clientId y clientSecret válidos para autenticarte en la API de Moffin Solutions.
  • El CURP del contribuyente a consultar.

Paso 1: Obtener el token de acceso

Para realizar consultas a la API, primero necesitas autenticarte y obtener un token de acceso.

Ejemplo de llamada a la API:

curl -i -X POST \
  https://solutions-api.moffin.mx/api/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grantType": "client_credentials",
    "clientId": "MOFFIN_cccccccc-aaaa-5555-aa33-11111111111",
    "clientSecret": "eeeee111-aa221-2313-1111-a15aa15c15aa"
  }'

Ejemplo de respuesta:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIs...",
  "tokenType": "Bearer",
  "accessTokenExpiresAt": 1737686951,
  "refreshTokenExpiresAt": 1738205351
}

Paso 2: Realizar la consulta del historial laboral

Utiliza el endpoint /query/job-history para obtener la información de historial laboral del contribuyente utilizando su CURP.

Ejemplo de llamada a la API:

curl -i -X POST \
  https://solutions-api.moffin.mx/api/query/job-history \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "curp": "AICA888888HMNJRC08"
  }'

Cuerpo de la solicitud:

{
  "curp": "MOCKCURP123456HMNJRC08"
}

Ejemplo de respuesta inmediata:

{
  "message": "Consulta de historial laboral procesada exitosamente.",
  "queryId": "6791c123456789abcedf5678"
}

Paso 3: Recibir los datos de historial laboral

Los resultados detallados se enviarán a tu webhook configurado una vez procesados.

Ejemplo de respuesta del webhook:

{
  "_id": "6791c123456789abcedf5678",
  "service": "JOB_HISTORY",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PF",
    "query": {
      "curp": "MOCKCURP123456HMNJRC08"
    }
  },
  "response": {
    "nss": "12345678901",
    "curp": "MOCKCURP123456HMNJRC08",
    "fechaEmision": "2025-01-23",
    "semanasCotizadas": 150,
    "empleos": [
      {
        "patron": "Empresa Mock",
        "registroPatronal": "R123456789",
        "entidadFederativa": "Ciudad de México",
        "fechaAlta": "2023-01-01",
        "fechaBaja": "2024-01-01",
        "salarioBase": "$10,000.00"
      }
    ]
  },
  "state": {
    "JOB_HISTORY": {
      "validationCode": "abc123456def789"
    }
  }
}

Paso 4: Validar la respuesta recibida

Verifica los datos obtenidos para asegurarte de su autenticidad y tomar decisiones basadas en la información proporcionada.

Puntos clave a validar:

  • Número de semanas cotizadas.
  • Historial de empleo.
  • Salario base.

Conclusión

Has aprendido cómo automatizar la consulta de historial laboral de un contribuyente usando su CURP con la API de Moffin Solutions.