Estados de orden (OrderStatus)

El campo OrderStatus define el estado operativo de una orden dentro de
Quiero Mi Factura y ayuda a determinar cómo debe procesarse en el flujo de facturación.

Aunque una orden tenga importes correctos y productos válidos, su comportamiento dentro de QMF también depende del estado enviado en este campo a través del Método RequestXMLCFDICompleto

Idea clave

OrderStatus no sustituye a STATUS. Ambos campos trabajan juntos: STATUS indica si la operación se almacena o se factura, mientras que OrderStatus representa la condición operativa de la orden.

Estados disponibles

Quiero Mi Factura documenta los siguientes valores para OrderStatus:

  • Pending
  • Paid
  • Completed
  • Shipped
  • Unshipped
  • Canceled
  • Cancelado
  • Inhabilitado

Descripción de estados

Estado Descripción Impacto general
Pending Orden en espera, normalmente pendiente de pago. No debe asumirse como lista para facturación inmediata.
Paid Orden pagada. Puede formar parte del flujo de facturación.
Completed Orden completada. Se considera lista para procesamiento normal.
Shipped Orden enviada. Puede activar flujos configurados por canal o correo.
Unshipped Orden no enviada. Útil en escenarios donde la operación aún no se concreta completamente.
Canceled / Cancelado Orden cancelada o devuelta. Puede relacionarse con procesos posteriores como notas de crédito, según el caso.
Inhabilitado Orden desactivada manualmente. Tiene reglas especiales y no aplica si la orden ya fue facturada.

Estados comúnmente listos para facturación

En la práctica, estados como Paid, Completed y Shipped suelen representar órdenes que ya pueden participar en el flujo normal de facturación, siempre que la información fiscal, productos y configuración también sean correctos.

Esto no significa que QMF “adivine” el comportamiento, sino que esos estados suelen alinearse con operaciones ya concretadas.

Estado Pending

El valor Pending se utiliza normalmente para órdenes que aún no están listas para consolidarse como operación definitiva, por ejemplo cuando el pago no ha sido confirmado, o el producto no se tiene en inventario.

Si una integración utiliza este estado, se debe tener en cuenta que la operación en este estado no es “facturable”, la operación existe, pero no será enviada una liga de facturación al cliente final y aunque se utilice la liga, la operación no es facturable. En este estatus la operación tampoco es facturable en una factura global.

Estados Canceled / Cancelado

Los valores Canceled y Cancelado se utilizan cuando la operación
deja de ser válida comercialmente, por ejemplo en casos de devolución o cancelación del pedido.

Estos estados no significan por sí solos la cancelación automática de un CFDI ya emitido. cuando una orden queda en este estado de forma previa a la facturación, ya sea en factura individual o en factura global, la orden se convierte en “no facturable”. si la orden cae en este estado después de la facturación, el sistema la envía al apartado “Devolución” donde estará a la espera de convertirse en una nota de crédito por devolución. Las devoluciones en el portal Quiero Mi Factura pueden convertirse en una Nota de Crédito con un solo clic en el botón “Generar” cuando la orden se encuentra en este estado, o bien, se puede programar Quiero Mi Factura para que diariamente genere notas de crédito de forma automatizada con todas las órdenes que tienen dicho estado. 

Es muy importante revisar cuál será la política de la organización en cuanto a la generación de las notas de crédito, ya que es necesario tomar acción y vigilar que efectivamente las notas de crédito se realicen de manera frecuente, para evitar seguir considerando como un “ingreso fiscal” algo que en realidad ya se encuentra devuelto.

Regla especial: Inhabilitado

El estado Inhabilitado tiene un tratamiento especial dentro de Quiero Mi Factura.

Para inhabilitar una orden, no basta con cambiar el valor aislado del estado. Debe reenviarse la petición completa original con estos ajustes:

  • STATUS = ALMACENAR
  • OrderStatus = Inhabilitado
  • Observaciones con al menos 5 caracteres

No es posible inhabilitar una orden que ya fue facturada.

Ejemplo de request para inhabilitar una orden

<USUARIO>TU_USUARIO</USUARIO>
<STATUS>ALMACENAR</STATUS>
<Order>
  <RFC>XAXX010101000</RFC>
  <SellerOrderId>12345</SellerOrderId>
  <PurchaseDate>2026-03-26T04:41:58</PurchaseDate>
  <OrderStatus>Inhabilitado</OrderStatus>
  <Observaciones>pedido inhabilitado por error administrativo</Observaciones>
  <SalesChannel>MITIENDAENLINEA</SalesChannel>
</Order>

Relación entre STATUS y OrderStatus

Es importante no confundir estos dos campos:

  • STATUS define si la orden se almacena o se factura.
  • OrderStatus describe el estado operativo de la orden.

Una integración correcta debe enviar ambos valores de forma coherente con el flujo real del negocio.

Errores comunes

  • Intentar inhabilitar una orden que ya fue facturada.
  • Enviar Inhabilitado sin reenviar la petición completa.
  • No incluir el campo Observaciones cuando se usa Inhabilitado.
  • Usar Pending en flujos donde la operación ya estaba lista para facturación.
  • Asumir que Canceled cancela automáticamente un CFDI ya emitido.
  • Enviar un OrderStatus que no corresponde con la realidad operativa del pedido.

Recomendaciones prácticas

  • Mapea cuidadosamente los estados de tu sistema a los estados soportados por QMF.
  • Define desde el inicio qué estados se consideran “listos para facturar”.
  • No uses Inhabilitado como sustituto de una lógica comercial mal definida.
  • Valida en QA cómo reacciona el flujo completo antes de pasar a producción.

Explora la documentación

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

Scroll al inicio