Ciclo de vida y comportamiento de la orden
Esta sección describe cómo Quiero Mi Factura gestiona las órdenes cuando son enviadas múltiples veces
y cómo se controla su actualización, facturación y estado fiscal.
Concepto clave
En QMF, cada orden está identificada de forma única por:
- USUARIO
- SellerOrderId
Esta combinación determina si una orden es nueva, debe actualizarse o ya fue previamente procesada.
Una misma persona o empresa con el mismo RFC puede tener uno o más usuarios dentro del portal Quiero Mi Factura y a su vez, tener uno o más canales de ventas.
Comportamiento del sistema
1. Orden nueva
Si el SellerOrderId no existe para el usuario y canal, la orden se registra normalmente.
2. Orden existente (no facturada)
Si la orden ya fue enviada previamente pero aún no ha sido facturada:
- La información se actualiza completamente.
- Se reemplazan datos como productos, importes, impuestos y OrderStatus.
Esto permite sincronizar cambios en el sistema origen.
3. Orden ya facturada
Si la orden ya fue facturada (timbrada):
- No puede ser modificada.
- No puede volver a facturarse.
Respuesta del sistema
Cuando se intenta reenviar una orden ya facturada:
- El sistema responde: PREVIAMENTE EMITIDO
- Se devuelve el XML original
- Se devuelve el PDF original
Los datos enviados en el nuevo request son ignorados.
Ejemplo
Una orden con SellerOrderId = 12345 se envía:
- Primero con STATUS = ALMACENAR
- Luego se actualiza con nuevos datos → OK
- Después se factura → CFDI emitido
- Se vuelve a enviar → respuesta: PREVIAMENTE EMITIDO
Relación con OrderStatus
El campo OrderStatus influye en cuándo una orden puede ser facturada. Por ejemplo:
- Pending → no facturable
- Shipped / Paid → facturable
Consulta la página de OrderStatus para más detalles.
Importante
Una vez que un CFDI ha sido emitido, no puede modificarse debido a que está protegido por un sello digital conforme a la normativa fiscal vigente.
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 comenzar una integración.
Autenticación y ambientes
Endpoints QA/PROD, acceso, USUARIO e IP.
RequestXMLCFDICompleto
Método principal para enviar órdenes a QMF.
Campos del request
Referencia completa campo por campo del XML.
PRODUCTOS
Catálogo fiscal requerido para facturación.
DESCARGACFDI
Descarga de CFDI con paginación y tokens.
Configuración
Parámetros fiscales y operativos del sistema.
Reglas
Índice de reglas técnicas y fiscales.
Impuestos y decimales
Validación fiscal y cálculos del CFDI.
Caracteres permitidos
Reglas de texto para XML y timbrado.
OrderStatus
Estados de la orden y comportamiento en QMF.
