API de facturación electrónica CFDI 4.0 para sistemas, apps y ecommerce en México

Integra facturación electrónica directamente en tu sistema mediante los
Web Services de Quiero Mi Factura. Nuestra plataforma permite registrar
operaciones, almacenar pedidos, emitir CFDI y recuperar comprobantes desde sistemas
propios, aplicaciones móviles, ecommerce y plataformas desarrolladas a la medida.

Esta documentación está dirigida a desarrolladores, integradores y empresas
que necesitan conectar su operación con un portal de facturación electrónica.
en México.

¿Qué tipo de sistemas pueden integrarse con Quiero Mi Factura?

La API de Quiero Mi Factura está pensada para integrarse con sistemas que
controlan sus propias operaciones y pueden enviar datos de venta mediante servicios web.

  • Aplicaciones móviles de venta o servicios
  • Tiendas en línea desarrolladas a medida
  • Sistemas administrativos o ERP propios
  • Plataformas de ecommerce personalizadas
  • Marketplaces o portales desarrollados internamente
  • Otras aplicaciones capaces de consumir servicios SOAP/XML

Si tu sistema puede enviar información estructurada de una operación, puede integrarse con
nuestra plataforma para automatizar la facturación electrónica.

Flujo general de integración

El proceso de integración con Quiero Mi Factura se basa en tres componentes
principales: productos, órdenes de venta y descarga de comprobantes.

  1. Registrar productos Antes de facturar correctamente, cada producto debe tener información fiscal asociada,
    como clave de producto o servicio del SAT, unidad y clave de unidad.
  2. Enviar la orden de venta Tu sistema envía la operación mediante el método RequestXMLCFDICompleto.
  3. Definir el comportamiento de la orden La orden puede almacenarse para facturación posterior o facturarse inmediatamente,
    según el valor de STATUS.
  4. Descargar CFDI emitidos: Una vez emitidos, los CFDI pueden recuperarse mediante el método DESCARGACFDI.
Flujo de integración para desarrolladores Quiero Mi Factura

Inicio rápido

 Si vas a integrar tu sistema con Quiero Mi Factura por primera vez, te recomendamos seguir
este orden:
 
  1. Solicita tus credenciales de integración a nuestro equipo
  2. Realiza pruebas en el endpoint QA / Sandbox.
  3. Registra los productos con sus datos fiscales mediante el método PRODUCTOS.
  4. Envía una orden de venta con RequestXMLCFDICompleto.
  5. Valida la respuesta y el estatus de la operación.
  6. Descarga CFDI emitidos con el método DESCARGACFDI.

Endpoint QA / Sandbox:
http://159.203.10.206/QA2/web_services/servidorMarket.php?wsdl

El endpoint productivo se entrega una vez concluidas las pruebas de integración.

En la sección “Getting Started – Inicio para desarrolladores”, puedes encontrar a detalle los pasos iniciales para la integración con el portal Quiero Mi Factura.

Seguridad y control de acceso a la API

Quiero Mi Factura implementa un modelo de seguridad en dos capas para proteger el acceso
a sus Web Services de facturación electrónica.

1. Protección a nivel de red (Cloudflare)

El acceso a los endpoints de integración está protegido mediante reglas de seguridad en Cloudflare.
Solo las direcciones IP previamente autorizadas pueden establecer comunicación con el servicio.

2. Validación interna en QMF

Adicionalmente, Quiero Mi Factura valida que las peticiones provengan de direcciones IP registradas
en el sistema. Si la IP no está autorizada, la petición será rechazada.

Requisito para integraciones

Para habilitar una integración, es necesario proporcionar al equipo de Quiero Mi Factura la
dirección IP pública desde la cual el sistema enviará las peticiones.

  • Se recomienda utilizar una IP fija o infraestructura con IP estática.
  • Las IP deben mantenerse estables para evitar interrupciones en el servicio.

Consideraciones importantes

  • Las IP dinámicas pueden provocar fallas de conexión.
  • El uso de IP rotativa no es compatible con el modelo de seguridad actual.
  • En caso de cambio de IP, es necesario solicitar su actualización.

Métodos disponibles

1. RequestXMLCFDICompleto.

Método principal para cargar órdenes a la plataforma, incluyendo la información completa
de la operación y los impuestos necesarios para la facturación.

2. PRODUCTOS.

Permite registrar los datos fiscales de productos y servicios, especialmente aquellos que
normalmente no llegan desde marketplaces o sistemas externos.

  • ClaveProdServ
  • Unidad
  • ClaveUnidad

3. DESCARGACFDI.

Permite recuperar CFDI emitidos en un rango de fechas, con paginación por TOKEN y filtros
por tipo de comprobante.

Valores importantes en la integración

Campo USUARIO

El valor de la etiqueta USUARIO funciona como llave de integración y será
proporcionado por Quiero Mi Factura.

Campo STATUS

  • ALMACENAR: guarda la orden en la plataforma para que quede disponible
    para facturación posterior.
  • FACTURAR: almacena la orden y además emite el CFDI inmediatamente.

Campo OrderStatus

El campo OrderStatus ayuda a controlar el estado operativo de la orden.
Entre los valores relevantes documentados están:

  • Pending
  • Paid
  • Completed
  • Shipped
  • Unshipped
  • Canceled / Cancelado
  • Inhabilitado

El valor Inhabilitado requiere reenviar la petición completa con:

  • STATUS = ALMACENAR
  • OrderStatus = Inhabilitado
  • Observaciones con al menos 5 caracteres

Regla crítica: cada producto debe tener datos fiscales SAT

Para que una factura pueda emitirse correctamente, Quiero Mi Factura necesita que cada producto o servicio tenga asociados tres datos fiscales que normalmente no vienen en la orden original:

  • ClaveProdServ
  • Unidad
  • ClaveUnidad

Por esta razón existe el método PRODUCTOS, que permite registrar o actualizar esa información por separado. Esto permite precargar catálogos completos o registrar productos nuevos cuando son dados de alta en el sistema origen.

En la lógica de integración, el producto enviado al método PRODUCTOS debe hacer match con el identificador que más tarde llegue en la orden, por ejemplo mediante el nodo ASIN o el identificador equivalente en la operación.

Puedes consultar a detalle todo lo relacionado con el método PRODUCTOS en esta página

Regla obligatoria: sustitución de caracteres antes del envío

Antes de enviar la petición al endpoint de Quiero Mi Factura, el sistema origen debe aplicar las sustituciones de caracteres definidas para evitar errores durante el timbrado o el procesamiento XML.

Algunos ejemplos de sustitución documentados son:

  • á = @a12345
  • é = @e12345
  • í = @i12345
  • ó = @o12345
  • ú = @u12345
  • ñ = @n12345
  • Ñ = @N12345
  • ü = @u678
  • & = @amp;
  • < = &lt;
  • > = &gt;

Esta sustitución debe realizarse desde el sistema que consume el Web Service, antes de enviar la petición.

Puedes consultar todo lo relacionado a las reglas de sustitución de caracteres a detalle en esta página

Descarga de CFDI emitidos

El método DESCARGACFDI permite recuperar los comprobantes emitidos desde la plataforma mediante filtros por fecha, tipo de  comprobante y token de paginación.

  • Consulta por rango de fechas.
  • Máximo de 30 CFDI por petición.
  • Paginación mediante TOKEN.
  • Filtro por tipo de comprobante: Factura (F), Nota de crédito (NC) y Global (G).

Si existen más de 30 resultados, el sistema devuelve un TOKEN que debe reenviarse en la siguiente petición para obtener la siguiente página de resultados.

Puedes consultar a detalle todo lo referente al método DESCARGACFDI en esta página

Casos de uso de integración

Quiero Mi Factura puede integrarse con distintos tipos de sistemas cuando existe control sobre el backend y la capacidad de enviar operaciones mediante Web Services.

  • App móvil de ventas o servicios
  • Ecommerce desarrollado a medida
  • ERP o sistema administrativo propio
  • Plataforma de venta especializada
  • Marketplace o sistema transaccional interno

Este enfoque resulta especialmente útil en escenarios donde la empresa desea controlar su proceso comercial y conectar la facturación electrónica como una capa especializada.

¿Qué necesitas para comenzar?

  • Credenciales de integración proporcionadas por Quiero Mi Factura.
  • Capacidad de consumir servicios SOAP/XML.
  • Acceso a un entorno de pruebas, proporcionado por Quiero Mi Factura.
  • Catálogo de productos con datos fiscales SAT.
  • Capacidad de aplicar las reglas de sustitución de caracteres.

Si tu equipo de desarrollo controla estos elementos, es posible iniciar una integración de forma estructurada y validarla primero en  ambiente QA.

Te recomendamos continuar en la página Getting Started para iniciar con tu proceso de Integración con el Portal Quiero Mi Factura haciendo click aqui.

¿Listo para integrar tu sistema con Quiero Mi Factura?

Si tu empresa cuenta con desarrolladores o con un sistema propio, podemos ayudarte a evaluar la integración de facturación electrónica mediante nuestros Web Services. Nuestro equipo puede orientarte sobre el flujo correcto, el ambiente de pruebas y la forma de estructurar tu integración.

Solicitar información técnica

Preguntas frecuentes sobre integración con el Portal Quiero Mi Factura

Loader image

Sí. La documentación actual de Quiero Mi Factura está basada en Web Services SOAP con intercambio de estructuras XML.

Sí. El flujo de integración inicia en un endpoint QA / Sandbox para realizar validaciones antes de pasar a producción.

Sí. Existe un método específico para registrar la información fiscal de productos y servicios antes de enviar órdenes, y para agregar los nuevos productos posteriormente.

Sí. El método DESCARGACFDI permite recuperar comprobantes emitidos, con filtros y paginación.

Sí. Es una regla crítica de integración para evitar errores al procesar la información enviada al endpoint.

Explora la documentación

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

Scroll al inicio