Capítulo 3 - "Consulta de RFC mediante CURP"

En esta guía aprenderás cómo obtener el RFC de una persona utilizando su CURP mediante la API de Moffin Solutions.

Requisitos previos

Antes de comenzar, asegúrate de contar con lo siguiente:

• Una cuenta activa en Moffin Solutions.
• Tu token de autenticación JWT.
• El CURP de la persona a consultar.

Paso 1: Hacer la solicitud a la API

Para obtener el RFC a partir de un CURP, realiza una solicitud POST al endpoint /query/curp-data enviando el CURP como parámetro en el cuerpo de la petición.

Ejemplo de solicitud

curl -X POST https://solutions-api.moffin.mx/api/query/curp-data \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "curp": "MOCKCURP123456XX9"
  }'

Explicación de los parámetros:

• Authorization: Token de autenticación de tu cuenta en formato Bearer Token.
• Content-Type: Define el tipo de contenido como JSON.
• curp: El CURP del individuo a consultar.

Respuesta esperada

Si la solicitud es exitosa, recibirás una respuesta con el RFC y otros datos asociados al CURP consultado.

{
    "_id": "mock123456789",
    "service": "CURP",
    "status": "SUCCESS",
    "authentication": "MOFFIN",
    "query": {
        "curp": "MOCKCURP123456XX9"
    },
    "response": {
        "rfc": "MOCKRFC123456",
        "estatus": "OK",
        "nombre": "JOHN",
        "apellidoPaterno": "DOE",
        "apellidoMaterno": "SMITH",
        "sexo": "HOMBRE",
        "fechaNacimiento": "1990-01-01",
        "paisNacimiento": "MEXICO"
    },
    "createdAt": "2025-01-23T19:26:07.076Z"
}

Datos en la respuesta:

• rfc: RFC generado basado en el CURP.
• nombre, apellidoPaterno, apellidoMaterno: Datos personales del contribuyente.
• fechaNacimiento: Fecha de nacimiento del individuo.
• estatus: Estado de la consulta, debe ser OK si se obtuvo correctamente.

Paso 2: Manejo de errores

Si la consulta falla, la API devolverá un mensaje de error indicando la causa.

Ejemplo de error cuando el CURP es inválido:

{
    "errors": [
        "El CURP no cumple con el formato requerido."
    ]
}

Posibles errores comunes:

• 400 Bad Request: El CURP no cumple con el formato válido.
• 401 Unauthorized: El token de autenticación es inválido o ha expirado.
• 500 Internal Server Error: Ocurrió un problema interno en el servicio.

Paso 3: Integración en tu aplicación

Puedes integrar esta funcionalidad en tu sistema utilizando cualquier lenguaje de programación que permita realizar peticiones HTTP.

Ejemplo en JavaScript (Node.js):

const axios = require('axios');

async function obtenerRFC(curp) {
  try {
    const response = await axios.post('https://solutions-api.moffin.mx/api/query/curp-data', 
      { curp },
      {
        headers: {
          Authorization: `Bearer YOUR_API_TOKEN`,
          'Content-Type': 'application/json',
        }
      }
    );

    console.log('RFC obtenido:', response.data.response.rfc);
  } catch (error) {
    console.error('Error al obtener RFC:', error.response.data);
  }
}

obtenerRFC('MOCKCURP123456XX9');

Conclusión

En esta guía aprendiste cómo obtener el RFC de un individuo utilizando su CURP con la API de Moffin Solutions. Ahora puedes integrar este proceso en tu sistema para automatizar la obtención de información fiscal.

Para más información, consulta la documentación oficial.