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"
  }'

Response

application/json

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

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"
  }'

Response

application/json

{
  "_id": "6791b9d091fa0dfcd7e8fe67",
  "service": "JOB_HISTORY",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PF",
    "query": { … }
  },
  "query": {
    "curp": "AICA888888HMNJRC08"
  },
  "response": {
    "nss": "19999999999",
    "curp": "AICA888888HMNJRC08",
    "fechaEmision": "22/01/2025",
    "semanasCotizadas": 52,
    "semanasDescontadas": 0,
    "semanasReintegradas": 0,
    "empleos": [ … ]
  },
  "state": {
    "JOB_HISTORY": { … }
  },
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 1209967,
  "createdAt": "2025-01-23T03:38:56.954Z",
  "updatedAt": "2025-01-23T03:39:01.671Z"
}

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.