🏢 Servicio de búsqueda 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_search",
    "rfcSearch": {
      "name": "ANDRES MANUEL",
      "paternalName": "LOPEZ",
      "maternalName": "OBRADOR",
      "birthDate": "1953-11-13"
    }
  }'

✅ Respuesta exitosa. HTTP 200

{
    "variant": "rfc_search",
    "rfcSearch": {
        "rfc": "LOOA531113FI5",
        "isValid": true
    }
}

isValid es siempre true en un 200. Este servicio arma el RFC con los datos que envías y lo valida con el mismo mecanismo que la validación de RFC: si el RFC resultante no se localiza, la respuesta es el 400 de abajo, no un 200 con la bandera en false.

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

El RFC construido con esos datos no existe ante Hacienda. Suele significar que algún dato de entrada no coincide con el registro oficial.

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

❌ Error de validación. HTTP 409

La fecha de nacimiento 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.rfcSearch.birthDate",
            "error": "Input should be a valid date or datetime, day value is outside expected range"
        }
    ]
}

❌ Error desconocido. HTTP 500

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