Reglas fiscales, impuestos y decimales

Para integrar correctamente con Quiero Mi Factura, no basta con enviar un XML válido:
también es necesario que los importes, descuentos, impuestos y totales respeten las reglas fiscales
aplicables al CFDI y que la configuración del sistema esté alineada con el tipo de operación.

En integraciones mediante RequestXMLCFDICompleto, el integrador es responsable de construir correctamente la operación y de enviar importes consistentes. 

Aquí puedes encontrar una guía detallada campo por campo de toda la información que debe contener el RequestXMLCFDICompleto

Cuando la opción de Impuestos Web Services está activa, Quiero Mi Factura toma los valores directamente del request y no realiza cálculos automáticos de impuestos.

Principio general

Si tu integración envía impuestos vía API, debes asumir que el cálculo fiscal ya viene resuelto desde
el sistema origen. Esto incluye:

  • Importes unitarios
  • Base gravable
  • Descuentos
  • Impuestos trasladados o retenidos
  • Subtotal
  • Total

Quiero Mi Factura validará y procesará la información enviada hasta el momento de intentar timbrar el comprobante, pero no debe considerarse como un motor que corrija aritmética incorrecta en el request.

Regla crítica: decimales y redondeo

En CFDI, los importes a nivel concepto e impuestos pueden manejar hasta 6 decimales. En MXN, los importes monetarios finales normalmente deben expresarse con 2 decimales.

La práctica recomendada es:

  1. Realizar cálculos internos con la mayor precisión posible.
  2. Conservar precisión suficiente en conceptos e impuestos.
  3. Redondear únicamente al final, al construir los importes monetarios finales del comprobante.

No redondees prematuramente cada paso intermedio, porque esto puede provocar que subtotal, impuestos y total no cuadren al momento de timbrar.

Tabla de validación numérica

Los siguientes ejemplos muestran cómo validar que los montos enviados a QMF sean consistentes antes de emitir el CFDI.

Escenario Subtotal Descuento Base IVA Total Resultado
IVA 16% correcto 250.00 0.00 250.00 40.00 290.00 Cuadra correctamente
Con descuento 250.00 20.00 230.00 36.80 266.80 Cuadra correctamente
Error por redondeo prematuro 3 conceptos con cálculos parciales redondeados antes de tiempo 0.00 Variable Variable Puede diferir por centavos Puede provocar rechazo o inconsistencia

Nota técnica: esta tabla es ilustrativa. En operaciones reales, los conceptos e impuestos pueden requerir mayor precisión decimal antes del redondeo final. La validación definitiva debe realizarse conforme a las reglas fiscales aplicables y a la lógica del sistema origen.

Qué revisar antes de enviar el request

  • Que el subtotal coincida con la suma de conceptos antes de impuestos.
  • Que el total coincida con subtotal, descuentos e impuestos aplicables.
  • Que las tasas y tipos de impuesto correspondan al tratamiento fiscal real de la operación.
  • Que los valores de FormaPago, UsoCFDI y demás catálogos SAT sean válidos.
  • Que la moneda usada en las operaciones sea Peso Mexicano (MXN) y sus decimales sean consistentes.
  • Que el producto exista previamente con su información fiscal SAT en el catálogo de productos de Quiero Mi Factura antes de intentar realizar el timbrado de un comprobante.

Escenarios fiscales comunes

Dependiendo del giro del cliente, una integración puede involucrar distintos tratamientos fiscales. Entre los escenarios más comunes están:

  • Operaciones con IVA 16%
  • Operaciones con IVA 0%
  • Operaciones exentas
  • Operaciones con IEPS por tasa
  • Operaciones con descuentos
  • Operaciones mixtas con más de un tratamiento fiscal

En integraciones con Quiero Mi Factura, estos valores pueden enviarse directamente por API cuando el esquema configurado es Impuestos Web Services.

Advertencia: qué no debe asumir el integrador

  • Que QMF recalculará automáticamente impuestos si el request ya los envía.
  • Que QMF corregirá diferencias pequeñas de redondeo.
  • Que cualquier valor de SalesChannel será aceptado sin configuración previa.
  • Que QA y PROD tendrán el mismo comportamiento si no se revisó la configuración.
  • Que un producto sin información fiscal SAT podrá facturarse correctamente.

Errores típicos en la integración

Si una operación no se factura correctamente, revisa primero estos puntos:

  • Los importes no cuadran entre conceptos, subtotal, impuestos y total.
  • El producto no existe previamente con clave SAT, unidad y clave de unidad.
  • Se enviaron caracteres no sustituidos correctamente antes del request.
  • El SalesChannel enviado no existe en la configuración del cliente.
  • La fecha tiene un formato incorrecto.
  • QA estaba configurado de una forma y PROD quedó distinto.
  • La integración envía impuestos por API, pero la configuración no está alineada para recibirlos así.

Checklist de validación antes de pasar a producción

  • Validé cálculos con precisión suficiente antes de redondear.
  • Verifiqué que subtotal, descuentos, impuestos y total cuadren exactamente.
  • Confirmé que los catálogos SAT enviados son válidos.
  • Verifiqué que QA y PROD tengan la misma configuración funcional.
  • Confirmé que los productos ya existen con datos fiscales SAT.
  • Probé casos con descuento, IVA 0%, exento o IEPS si forman parte de mi operación.

Responsabilidad de validación

Quiero Mi Factura automatiza la emisión de CFDI y diversos flujos operativos, pero la validación final de la lógica fiscal y de la configuración corresponde al integrador y al usuario de negocio.

En la práctica, el usuario debe revisar periódicamente que la configuración, los cálculos enviados y los comprobantes emitidos sigan siendo correctos conforme al modelo de operación y a las reglas fiscales aplicables.

Explora la documentación

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

Scroll al inicio