Configuración del sistema
Antes de integrar con Quiero Mi Factura, es indispensable comprender que el comportamiento del sistema no depende únicamente del API, sino de una serie de configuraciones que determinan cómo se generan, validan y envían los CFDI.
Una integración exitosa requiere alinear correctamente la información enviada en el request con la configuración activa del entorno.
Cómo funciona la configuración en Quiero Mi Factura
Quiero Mi Factura es una plataforma altamente configurable. Esto significa que el mismo request puede generar resultados distintos dependiendo de la configuración activa del usuario, canal y ambiente.
Estas configuraciones controlan aspectos como:
- Cómo se calculan los impuestos.
- Qué valores puede modificar el usuario final.
- Cuándo se envía la liga de facturación.
- Qué datos deben enviarse obligatoriamente desde la integración.
Por lo tanto, el API debe entenderse como parte de un sistema completo, no como un servicio aislado.
Configuración fiscal (impacto directo en el API)
Los siguientes campos pueden ser controlados desde la configuración del sistema o desde la integración:
Forma de pago
- Puede ser seleccionada por el usuario final.
- Puede estar bloqueada con un valor fijo.
- Puede ser enviada obligatoriamente desde el API, usando el RequestXMLCFDICompleto
Si el campo está bloqueado para API, el valor enviado en el request será el que se utilice en el CFDI.
Uso de CFDI
Funciona bajo la misma lógica que la forma de pago:
- Editable por usuario.
- Fijo.
- Controlado por API.
Método de pago
- PUE → Pago en una sola exhibición.
- PPD → Pago en parcialidades o diferido.
Debe configurarse correctamente según el modelo de negocio del cliente.
Cálculo de impuestos
Quiero Mi Factura puede operar bajo tres esquemas:
- Cálculo automático (ej. IVA 16%).
- Configuración mediante archivo Excel.
- Impuestos enviados directamente desde el API.
Para integraciones mediante RequestXMLCFDICompleto, se debe utilizar el tercer esquema.
Cuando la opción de “Impuestos Web Services” está activa:
- QMF no realiza ningún cálculo.
- El integrador es completamente responsable de los importes.
Canales de venta (SalesChannel)
El campo SalesChannel debe corresponder a un canal previamente configurado en Quiero Mi Factura.
Los canales pueden representar:
- Marketplaces (Amazon, Mercado Libre).
- Tiendas en línea.
- Aplicaciones móviles.
- Sucursales físicas.
El nombre del canal es definido durante la configuración del sistema y debe coincidir exactamente con el enviado en el request.
Envío de liga de facturación
El sistema puede enviar automáticamente una liga al cliente para que genere su factura.
Este comportamiento depende de dos configuraciones:
- Clave envío Email: define en qué momento del proceso se envía la liga (Paid, Completed, Shipped).
- Envío de correos: activa o desactiva el envío automático.
En integraciones personalizadas, este punto debe alinearse con el flujo de negocio del cliente.
Catálogo de productos
Para emitir CFDI correctamente, cada producto debe contar con:
- Clave de producto o servicio SAT.
- Unidad.
- Clave de unidad SAT.
Estos datos pueden cargarse:
- Directamente desde el aplicativo Quiero Mi Factura en línea en el Menú Productos.
- Mediante archivo Excel.
- Mediante integración API utilizando el request PRODUCTOS
Si estos datos no existen, el CFDI no podrá generarse correctamente.
Configuraciones críticas del sistema
Existen parámetros avanzados que afectan directamente el comportamiento de la integración:
- Versión de CFDI.
- Recepción de órdenes vía XML Completo.
- Días permitidos para facturación.
- Permitir facturación de ejercicios anteriores.
Consideraciones importantes
- El API no valida lógica fiscal compleja; es responsabilidad del integrador.
- La configuración en QA y PROD debe ser idéntica.
- Los errores de configuración pueden provocar CFDI incorrectos.
- Para evitar errores, te recomendamos revisar cuidadosamente las Reglas fiscales y de funcionamiento.
El usuario debe validar continuamente la correcta emisión de sus comprobantes.
Explora la documentación
Navega por todas las secciones técnicas de Quiero Mi Factura para completar tu integración:
Developers
Inicio del portal técnico y visión general.
Getting Started
Recorrido recomendado para iniciar tu integración.
Autenticación y ambientes
Endpoints QA/PROD, USUARIO, IP y acceso.
RequestXMLCFDICompleto
Método principal para enviar órdenes a QMF.
Campos del request
Referencia completa del XML.
PRODUCTOS
Catálogo fiscal requerido.
DESCARGACFDI
Descarga de CFDI y paginación.
Configuración
Parámetros fiscales y operativos.
Sales Channels
Segmentación de órdenes por canal de venta.
Reglas
Índice de reglas técnicas y fiscales.
Impuestos y decimales
Validación fiscal del CFDI.
Caracteres permitidos
Reglas de texto para XML.
OrderStatus
Estados operativos de la orden.
Ciclo de vida de la orden
Idempotencia, actualización y control de duplicados.
