Reglas de integración
Esta sección reúne las reglas técnicas y fiscales que deben considerarse antes de integrar con Quiero Mi Factura.
Aunque una integración pueda enviar correctamente un XML o consumir el Web Service, la emisión exitosa del CFDI también depende de respetar reglas de caracteres, catálogos, impuestos, decimales, estados de orden y configuración del sistema.
¿Qué encontrarás en esta sección?
- Reglas de texto y caracteres permitidos en XML
- Reglas fiscales, impuestos, decimales y consistencia aritmética
- Reglas de estados operativos de la orden
- Buenas prácticas para reducir errores de integración
Estas reglas complementan la documentación de métodos como RequestXMLCFDICompleto, PRODUCTOS y DESCARGACFDI.
Importante
La mayoría de los errores de integración no se deben al endpoint en sí, sino a reglas de negocio, validaciones fiscales o diferencias entre la configuración esperada y la configuración real del entorno.
Reglas disponibles
Consulta la documentación específica de cada grupo de reglas:
¿Cuándo debes revisar estas reglas?
- Antes de comenzar una nueva integración.
- Cuando una orden no se factura correctamente.
- Cuando se agregan nuevos tipos de producto, impuestos o canales.
- Antes de pasar de QA a producción.
Alertas rápidas
- No enviar caracteres especiales sin procesar.
- No asumir que QMF recalculará importes enviados por API.
- No usar un SalesChannel no configurado.
- No facturar productos que aún no tienen Clave SAT, Unidad o Clave Unidad.
- No pasar a producción sin validar que QA y PROD estén alineados.
Relación con los métodos principales
Las reglas aquí documentadas deben leerse junto con la documentación de los métodos operativos:
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.
