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.
Algunos de estos parámetros son configurados directamente por el equipo de Quiero Mi Factura.

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.

Scroll al inicio