🏢 Servicio de validación de RFC

• Método: POST
• URL de Consumo: https://api.consultaunica.mx/v3/sat
• Compra de paquetes: https://consultaunica.mx/paquetes

🧪 ¿Todavía sin créditos? Prueba este servicio en POST /v3/mock/sat, con el mismo contrato y sin cargo. Ver ambiente de pruebas.

Ejemplo de consumo

curl -X POST https://api.consultaunica.mx/v3/sat \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "variant": "rfc_validation",
    "rfcValidation": {
      "rfc": "LOOA531113FI5"
    }
  }'

✅ Respuesta exitosa. HTTP 200

{
    "variant": "rfc_validation",
    "rfcValidation": {
        "rfc": "LOOA531113FI5",
        "isValid": true
    }
}

isValid es siempre true en un 200. Un RFC que no se localiza no baja por esta rama con la bandera en false: produce el 400 de abajo. El campo se conserva por compatibilidad, así que no lo uses como condición — si recibiste un 200, el RFC es válido.

Toda respuesta de error trae también description y errorCode

Los ejemplos que muestran solo message los omiten; revisa la estructura de las respuestas de error.

❌ RFC no localizado. HTTP 400

{
    "message": "No se encontró un RFC válido"
}

❌ Error de validación. HTTP 409

El RFC tiene un formato inválido

{
    "message": "Datos inválidos, favor de verificar la información ingresada",
    "description": "Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.",
    "errorCode": "bad_request",
    "errors": [
        {
            "field": "body.rfcValidation.rfc",
            "error": "String should have at most 13 characters"
        }
    ]
}

❌ Error desconocido. HTTP 500

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