Guía de Consulta de Situación Fiscal con Moffin Solutions API

La consulta de situación fiscal permite obtener información clave sobre la situación tributaria de un contribuyente utilizando su RFC. Esta guía te mostrará cómo utilizar la API de Moffin Solutions para realizar consultas de situación fiscal de manera eficiente.

Descripción General

Con la API de Moffin Solutions, puedes:

• Consultar la situación fiscal de un contribuyente utilizando su RFC.
• Obtener información detallada sobre su estado fiscal, domicilio fiscal y régimen fiscal.
• Integrar fácilmente la consulta fiscal en tus procesos de validación.

Paso 1: Realizar la consulta de situación fiscal

Para obtener la información fiscal de un contribuyente, realiza una consulta con su RFC.

Realizar la consulta

Utiliza el siguiente comando curl para hacer la solicitud:

curl -X POST https://solutions-api.moffin.mx/query/sat/csf \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "rfc": "MOCKRFC123456"
}'

• rfc: El RFC del contribuyente que deseas consultar.

Ejemplo de respuesta

{
  "_id": "6791bc81d68f4ff2b76493d2",
  "service": "CSF",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PM",
    "query": {
      "rfc": "MOCKRFC123456"
    }
  },
  "query": {
    "rfc": "MOCKRFC123456"
  },
  "response": {
    "claveMensaje": 0,
    "pdf": "https://cdn.moffin.com/csf/MOCKRFC123456-CSF.pdf",
    "datosSat": {
      "razonSocial": "EMPRESA MOCK SA DE CV",
      "regimenFiscal": "601 - General de Ley Personas Morales",
      "estado": "ACTIVO",
      "domicilioFiscal": {
        "calle": "Avenida Mock",
        "numeroExterior": "123",
        "colonia": "Centro",
        "codigoPostal": "01000",
        "estado": "Ciudad de México",
        "municipio": "Benito Juárez"
      }
    },
    "codigoValidacion": "cs123456789"
  }
}

Esta respuesta proporciona la información fiscal registrada en el SAT del contribuyente.

Paso 2: Validación del perfil

Antes de realizar la consulta de situación fiscal, es necesario que el contribuyente tenga un perfil creado en Moffin Solutions.

Crear un perfil SAT

Utiliza el siguiente comando curl para crear el perfil:

curl -X POST https://solutions-api.moffin.mx/sat/profile \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "rfc": "MOCKRFC123456",
  "ciec": "MOCKCIEC1234"
}'

Respuesta esperada

{
  "message": "Perfil creado satisfactoriamente",
  "rfc": "MOCKRFC123456",
  "profileId": 27287
}

Si el perfil ya existe, recibirás un error indicando que el RFC ya está registrado.

Paso 3: Descargar la constancia

La consulta de situación fiscal proporciona un enlace a un archivo PDF con la constancia oficial del SAT.

Descargar el archivo

Utiliza la URL proporcionada en la respuesta para descargar el PDF de la constancia:

curl -O https://cdn.moffin.com/csf/MOCKRFC123456-CSF.pdf

Paso 4: Manejo de errores

Si se producen errores durante la consulta, la API devolverá mensajes específicos para ayudarte a resolverlos.

Error 400 - RFC inválido

{
  "errors": [
    "El RFC debe tener al menos 12 caracteres."
  ]
}

Error 403 - Perfil no encontrado

{
  "message": "El perfil no existe. Primero debe crear un perfil con CIEC utilizando el endpoint POST /api/query/sat/profile"
}

Mejores Prácticas

• Almacena el RFC de tus clientes: Para realizar consultas rápidas y optimizar tiempos de validación.
• Consulta periódica: Verifica la situación fiscal de tus clientes regularmente para mantener actualizados los datos.
• Usa perfiles Moffin: Asegúrate de que cada contribuyente tiene un perfil antes de realizar consultas.

Conclusión

La API de Moffin Solutions te permite automatizar la consulta de situación fiscal de forma sencilla, brindándote acceso a información detallada y actualizada del SAT. Siguiendo esta guía, puedes integrar esta funcionalidad en tus procesos empresariales sin complicaciones.

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