Autenticación, endpoints y ambientes QA / PROD

Antes de consumir los Web Services de Quiero Mi Factura, es necesario conocer
el endpoint correcto, la llave de integración y el proceso para pasar de pruebas a producción.

Esta página resume cómo conectarse a QMF, qué esperar del ambiente QA y qué validar antes de solicitar
el acceso productivo.

Si quieres, tambien puedes conocer paso a paso todo el proceso de conexión desde un inicio desde la página Getting Started

Idea clave

En QMF, una integración no queda lista solo porque el XML “sale”. La operación debe probarse en QA, validarse funcionalmente y después solicitar el acceso a producción.

Endpoint de pruebas (QA / Sandbox)

El endpoint de pruebas actual para los Web Services de Quiero Mi Factura es:

http://159.203.10.206/QA2/web_services/servidorMarket.php?wsdl

Este ambiente debe usarse para validar estructura, catálogos, flujo operativo y resultados del request antes de pasar a producción.

Tecnología de integración

Quiero Mi Factura expone sus servicios mediante Web Services SOAP con
intercambio de estructuras XML.

La infraestructura opera con Cloudflare y Amazon Web Services (AWS).

Endpoint productivo

El endpoint productivo no se entrega desde el inicio.

Para obtener acceso al ambiente productivo, el integrador debe completar sus pruebas y entregar resultados satisfactorios al equipo de Quiero Mi Factura.

Autenticación básica

La autenticación lógica del request se realiza mediante el campo USUARIO.

Este valor es proporcionado por Quiero Mi Factura y actúa como la llave de integración correspondiente al emisor o cuenta que consumirá el servicio.

El valor de USUARIO debe insertarse en la raíz del request, que se desea utilizar, por ejemplo, puede utilizarse  en el método   RequestXMLCFDICompleto, junto con el campo STATUS, o en el método DESCARGACFDI para recuperar los CFDI emitidos.

<USUARIO>ABC1_ABC140702XYZ</USUARIO>

Requisito operativo de acceso

Además del valor USUARIO, el acceso a los endpoints de integración debe habilitarse previamente como parte del proceso de implementación.

En la práctica, esto implica validar con el equipo de Quiero Mi Factura que el ambiente, el origen de conexión y la configuración técnica del integrador ya están listos para operar.

Se recomienda utilizar infraestructura estable y evitar cambios no controlados en el entorno de salida de las peticiones.

Control de acceso por IP

Además del valor USUARIO, las integraciones con Quiero Mi Factura requieren autorización de la dirección IP pública desde la cual se enviarán las peticiones.

  • La IP debe ser compartida previamente con el equipo de QMF.
  • Se recomienda trabajar con IP fija o infraestructura con IP estable.
  • Si la IP cambia constantemente, pueden presentarse errores de conexión.

La autorización de IP forma parte del modelo actual de seguridad del servicio.

Diferencia entre los ambientes QA y PROD

Ambiente Uso Clave visible en configuración
QA Pruebas, validación funcional, revisión de integración. QA
PROD Operación real de facturación en producción. PROD

En la configuración del sistema, el ambiente puede identificarse como QA para pruebas o PROD para producción.

Regla crítica

En integraciones vía API, es responsabilidad del usuario verificar que la configuración que funcionó exitosamente en QA quede configurada exactamente de la misma forma al pasar a PROD.

Diferencias entre ambos ambientes pueden provocar errores en facturación, impuestos, envío de avisos o procesamiento de órdenes.

Checklist antes de solicitar el ambiente productivo

  1. El método SOAP se consume correctamente desde el sistema origen.
  2. El campo USUARIO fue configurado correctamente.
  3. La IP pública ya fue compartida y autorizada.
  4. Los productos requeridos ya existen con su información fiscal SAT.
  5. La configuración fiscal y operativa fue validada en QA.
  6. Las pruebas del flujo principal fueron documentadas.
  7. Se confirmó que QA y PROD quedarán configurados de la misma forma.

Errores comunes

  • Intentar consumir producción sin haber completado pruebas en QA.
  • Usar un valor incorrecto en USUARIO.
  • No autorizar previamente la IP del sistema integrador.
  • Probar con una configuración en QA y dejar otra distinta en PROD.
  • Asumir que el endpoint productivo es igual al de QA sin validación previa.
  • Olvidar que QMF depende también de configuración interna, no solo del request.

Buenas prácticas

  • Realiza todas las primeras pruebas en QA.
  • Documenta tus casos de prueba antes de pedir PROD.
  • Trabaja con IP fija siempre que sea posible.
  • Guarda evidencia de configuración y resultados por ambiente.
  • Valida que las mismas reglas fiscales y operativas estén replicadas en producción.

Explora la documentación

Navega por todas las secciones técnicas de Quiero Mi Factura para completar tu integración:

Scroll al inicio