Consulta Única API Docs

# 🏥 Servicio de reporte detallado Semanas Cotizadas del IMSS

# Headers (requerido API Key)

{
    "x-api-key": "1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f"
}

# Payload JSON de ejemplo (obligatorios)

// POST https://consultaunica.mx/api/v3/imss
{
    "type": "sc",
    "vdSc": {
        "curp": "LOOA531113HTCPBN07",
        "nss": "12345678901"
    },
    "userEmail": "amlo@gmail.com",
    "allowEmailConcat": true // default: true; concat nss to email, example: amlo+12345678901@gmail.com
}

# Respuesta exitosa. HTTP 200

{
    "message": "Semanas cotizadas enviadas al correo ingresado",
}

# ❌ Error de validación de datos. HTTP 409

La CURP tiene un formato inválido

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.vdSc.curp",
            "error": "String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'"
        }
    ]
}

El NSS debe tener 11 dígitos

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.vdSc.nss",
            "error": "String should have at most 11 characters"
        }
    ]
}

El correo tiene un formato inválido

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.userEmail",
            "error": "value is not a valid email address: An email address must have an @-sign."
        }
    ]
}

# ❌ Errores de consulta con el IMSS. HTTP 400

{
    "message": "El correo usado no es aceptado por el IMSS, escriba un correo diferente"
}

Otros mensajes de error pueden ser:

  • "El correo ya fue usado con otra CURP, escriba un correo diferente"
  • "El NSS capturado no coincide con la CURP"
  • "El NSS no fue localizado en el IMSS"
  • "Las semanas cotizadas solo pueden consultarse 2 veces al día"

# ❌ Errores de consulta con el IMSS. HTTP 422

{
    "message": "El servicio de RENAPO tienen inconsistencias con la CURP"
}

Otros mensajes de error pueden ser:

  • "El servicio de RENAPO no se encuentra disponible para validar la CURP"
  • "Es necesario ir a una subdelegación para recibir el reporte"
  • "Correo de consulta pendiente autorización del IMSS, favor de consultar más tarde"

# ❌ Error desconocido. HTTP 500

{
    "message": "Algo falló durante la consulta, favor de consultar nuevamente"
}

Otros mensajes de error pueden ser:

  • "El servicio no se encuentra disponible, favor de consultar más tarde"
  • "El reporte detallado no esta funcionando, favor de utilizar el reporte sencillo"

← 💰 Servicio de enviar Afore al correo →