Ciclo de vida de un equipo¶
Para quién es esta guía
Para cualquiera que necesite responder “¿en qué parte del proceso está este equipo?”: almacén, ventas, soporte o un desarrollador que investiga un registro detenido.
Esta página es un mapa de referencia de los estados, cambios y condiciones. Úsela cuando algo parezca bloqueado y necesite saber qué paso falta.
Qué estados guarda cada equipo¶
Un equipo (stock.lot) tiene tres campos de estado independientes. Cada uno responde una
pregunta distinta y puede cambiar sin que cambien los otros.
| Campo | Pregunta que responde | Valores |
|---|---|---|
device_status |
¿Dónde está dentro del flujo de venta? | Available, Reserved, Sold, Returned |
qc_status |
¿Ya se probó? | Pending QC, In QC, QC Complete, QC Failed |
settlement_status |
¿Ya se pagó a Axis? | Not Applicable, Pending, Settled |
Un equipo puede estar Sold + QC Complete + Settled: es una venta consignada totalmente terminada. Las reservas minoristas se guardan en campos de reserva separados y no cambian Device Status de Available a Reserved. Esta diferencia es importante al investigar problemas.
Device Status — flujo de venta¶
Received
↓
+-----------+
│ Available │ ← Estado inicial al recibir
+-----+-----+
│
┌───────────────┬───────────────────────────┐
↓ ↓
Asignación a SO Indicador de reserva minorista
↓ (Device Status sigue Available)
+----------+ │ confirmar venta minorista
│ Reserved │ ↓
+-----+----+ +------+
│ enviar │ Sold │
↓ +------+
+------+
│ Sold │
+--+---+
│
│ devolución del cliente
↓
+----------+
│ Returned │ → reacondicionar → Available
+----------+
Cambios posibles:
| De | A | Qué lo provoca |
|---|---|---|
| Available | Reserved | Asignación a una línea de orden de venta |
| Reserved | Sold | Se completa el manifiesto de entrega al cliente |
| Available | Sold | Se confirma una venta minorista de un equipo correctamente reservado para retail |
| Sold | Returned | Proceso de devolución del cliente |
| Returned | Available | Se procesa o se repite QC y vuelve a inventario vendible |
QC Status — flujo de pruebas¶
QC es el requisito para vender como Reyder QC Verified y para los flujos minoristas estrictos. Una fila mayorista normal marcada expresamente como As Received (Supplier/PO Grade) puede usar la evidencia inmutable de proveedor/PO aunque el equipo esté Pending QC. Los equipos con QC Failed conocido siguen bloqueados y continúan aplicándose los controles de disponibilidad, propiedad, reserva, compañía, costo y cantidad.
+-------------+
│ Pending QC │ ← Estado inicial al recibir
+-----+-------+
│ asistente QC Handoff
↓
+-------------+
│ In QC │ ← En prueba y clasificación
+-----+-------+
│
┌───┴───┐
↓ ↓
+-----------+ +-----------+
│QC Complete│ │ QC Failed │
+-----------+ +-----+-----+
│ Reset to QC
↓
+-------------+
│ Pending QC │
+-------------+
| De | A | Qué lo provoca |
|---|---|---|
| Pending QC | In QC | Asistente QC Handoff |
| In QC | QC Complete | action_mark_qc_complete() en el formulario del equipo |
| In QC | QC Failed | action_mark_qc_failed() |
| QC Failed | Pending QC | Return to Pending QC en el formulario del equipo (solo Stock Manager), después de revisar la falla. Esto limpia los resultados anteriores de Reyder/M360 para exigir una nueva entrega y evidencia nueva. |
Settlement Status — flujo del dinero¶
+-----------------+
│ Not Applicable │ ← Equipo de Reyder; no existe pago de consignación
+-----------------+
+-----------------+
│ Pending │ ← Se vendió un equipo consignado; falta pagar a Axis
+--------+--------+
│ Mark as Paid en el informe de liquidación
↓
+-----------------+
│ Settled │ ← Factura de proveedor conciliada; Axis ya recibió el pago
+-----------------+
Not Applicablecuandoowner_company_ides igual a la compañía vendedora: Reyder vendió un equipo propio y no debe comisión.Pendinglo establecestock.lot.action_mark_sold()cuando se envía un equipo consignado o se vende por retail.Settledse establece cuando el informe de liquidación emparejado se marca Paid.
Estados de los manifiestos¶
Los manifiestos de recepción y entrega no siguen exactamente el mismo camino.
Receiving Manifest¶
Draft → Awaiting Manifest → Ready → In Progress → Complete
└──────────────→ Cancelled (solo con cero escaneos aceptados)
| Estado | Significado |
|---|---|
| Draft | Recién creado; todavía no está asociado a una PO confirmada |
| Awaiting Manifest | La PO está confirmada; falta elegir lista exacta o recepción sin lista |
| Ready | Los requisitos de IMEI del proveedor o precargados están listos para verificarse |
| In Progress | Ya se escaneó por lo menos un equipo |
| Complete | Se recibieron todos los equipos aceptados y terminó la confirmación final |
| Cancelled | Manifiesto anulado con cero escaneos entrantes aceptados. El escáner de recepción no tiene una acción pública Undo Last Scan. Si la recepción ya empezó, deténgase y use el proceso de unreceive o reinicio aprobado por supervisión/soporte; no cancele alrededor de inventario aceptado. |
Delivery Manifest¶
| Estado | Significado |
|---|---|
| Draft | Creado desde la venta; todavía no se escaneó un equipo de salida |
| In Progress | Se aceptó por lo menos un IMEI de salida |
| Complete | Terminó la revisión final; se publica un envío a cliente externo o comienza el traspaso de recepción en el destino entre compañías |
| Cancelled | Cumplimiento Draft/incompleto anulado con cero escaneos de salida aceptados. Use Undo Last Scan, disponible solo en salida, para quitar los aceptados antes de cancelar. |
Undo Last Scan es un control exclusivo de la entrega de salida. No lo busque en un manifiesto de recepción ni use una corrección de entrega para revertir inventario recibido.
Estado del acuerdo de consignación¶
| Estado | ¿Permite ventas bajo este acuerdo? |
|---|---|
| Draft | No |
| Active | Sí, pero solo mientras la fecha de hoy esté dentro de Start Date y End Date |
| Suspended | No; pausa temporal que puede reactivarse |
| Terminated | No; final permanente |
Un Start Date o End Date vacío deja abierto ese extremo del rango. La etiqueta Active
por sí sola no autoriza ventas antes del inicio ni después del vencimiento.
Estado del informe de liquidación¶
| Estado | Qué ocurrió |
|---|---|
| Draft | Casi nunca se ve; al crearse normalmente se confirma solo |
| Confirmed | El informe espera el pago. Normalmente la factura de proveedor ya está publicada; si no había diario de compras, una advertencia puede dejarlo sin factura y contabilidad debe resolverlo antes de pagar. |
| Paid | Se marcó pagado después de conciliar la factura de proveedor |
Estado de asignación de equipo a una línea de SO¶
| Estado | Significado |
|---|---|
| Draft | Valor técnico/transitorio mientras se construye la asignación; no es un estado de espera del operador guiado |
| Reserved | SO confirmada; el equipo está reservado en su stock.lot |
| Delivered | Manifiesto completo; el equipo está Sold |
| Cancelled | Asignación cancelada; el equipo vuelve a Available |
El flujo guiado de asignación comienza después de confirmar la SO y pasa inmediatamente a
Reserved, donde permanece mientras el manifiesto de entrega está abierto. Confirmed
es un valor técnico heredado, no un paso que el operador deba esperar.
Estado de una caja de empaque¶
| Estado | Significado |
|---|---|
| Draft | Caja creada; todavía no contiene equipos |
| Packing | Se están escaneando equipos dentro de la caja |
| Ready to Ship | Todos los equipos esperados fueron escaneados y confirmados; falta Mark Shipped |
| Shipped | Los teléfonos salieron; publica factura y liquidación de consignación cuando corresponden, y COGS solo con contabilidad configurada y valor enviado distinto de cero |
| Cancelled | Caja anulada; se limpian sus indicadores de empaque/escaneo. Las asignaciones de la SO siguen Reserved y deben cancelarse por separado mediante la corrección aprobada si el pedido no continuará. |
Estado de una reserva minorista¶
Draft ──→ Active ──→ Released
└─────────┴──────→ Cancelled
└──────→ Released automáticamente al vender el último equipo
| Estado | Significado |
|---|---|
| Draft | Todavía no se activó |
| Active | Equipo marcado para el socio minorista |
| Released | Se vendieron todos los equipos reservados o se liberó toda la reserva activa |
| Cancelled | Se canceló una reserva Draft o Active |
La reserva se cierra automáticamente cuando se registra la venta minorista del último equipo reservado. La fecha esperada de devolución es solamente un recordatorio operativo; el módulo no tiene una tarea automática que cierre reservas vencidas.
Referencia rápida — dónde vive cada estado¶
| Campo de estado | Modelo | Quién o qué lo cambia |
|---|---|---|
device_status |
stock.lot |
Asignación, manifiesto de entrega, venta minorista |
qc_status |
stock.lot |
Asistente QC Handoff y botones de QC |
settlement_status |
stock.lot |
action_mark_paid() del informe de liquidación |
state del manifiesto |
device.manifest |
Carga, escaneo y finalización |
state del acuerdo |
device.consignment.agreement |
Activar, suspender y terminar manualmente |
state del informe |
consignment.settlement.report |
Confirmación automática al crear y Mark as Paid manual |
state de la asignación |
sale.order.line.device |
Confirmación de SO y finalización del manifiesto |
state de la caja |
packing.box |
Escaneo, Mark Ready to Ship y Mark Shipped |
state de la reserva |
device.retail.reservation |
Activar y cierre automático por venta |
