Actualizar el estado de un pedido
Usa el selector Order status del panel de detalles del pedido para solicitar un cambio en su etapa operativa. El código fuente actual de Dashboard filtra las opciones según el contexto y el contrato de la API valida el estado enviado y a quien realiza la solicitud antes de aceptar el cambio.
El código fuente deshabilita el selector para usuarios de solo lectura y filtra los estados según el tipo de entrega y las reglas de visibilidad específicas del proyecto. La API limita de manera independiente qué roles y estados pueden enviar ciertas transiciones.
Antes de empezar
- Confirma que estés trabajando en el proyecto Ordering correcto y que hayas abierto el pedido previsto.
- Antes de cambiar algo, revisa el estado actual, los datos de cumplimiento y los detalles del cliente.
- No aprendas el flujo con un pedido activo. En el código fuente de Dashboard inspeccionado, seleccionar una opción envía un cambio operativo sin un paso de confirmación independiente.
Cambia el estado
- En la barra lateral de Dashboard, selecciona Orders y luego Orders list.
- Selecciona el pedido para abrir su panel de detalles.
- En Order status, abre el selector del estado actual.
- Busca o selecciona un estado disponible.
- Revisa el resultado que muestra Dashboard. Si el selector se restablece o aparece un error, considera que el cambio no está confirmado.
El selector inspeccionado se restablece después de que se rechaza una solicitud y puede mostrar el error devuelto. Se requiere una respuesta exitosa para que el cliente actualice el estado local del pedido.
Qué puedes esperar
El código fuente actual agrupa las opciones en Pending, In progress, Completed y Cancelled. No todos los pedidos ofrecen todos los estados; el filtro por tipo de entrega puede ocultar de los pedidos Pickup las etapas específicas de conductores.
El código fuente de la API contiene validaciones adicionales de autorización, bloqueo del pedido, regresión, ubicación del Driver y logística. También incluye trabajos y hooks posteriores para algunas transiciones aceptadas. Esta revisión exclusiva del código fuente no establece qué módulos o integraciones están habilitados en un proyecto desplegado.
Este control envía un cambio al pedido y puede activar flujos de cumplimiento específicos del proyecto. No lo uses solo para probar el selector en un pedido activo.
Lista de comprobación de verificación
- El panel de detalles muestra el número de pedido y los detalles del cliente previstos.
- El estado seleccionado aparece como Order status actual solo después de una respuesta aceptada.
- El selector no se restableció al valor anterior.
- Dashboard no muestra ningún error devuelto.
Solución de problemas
¿Por qué está deshabilitado el selector de estado?
El código fuente deshabilita el control para los usuarios de solo lectura. La API también puede rechazar solicitudes fuera del rol permitido para quien las envía o fuera de su alcance de pedidos. Pide a un administrador u operador autorizado que revise el pedido.
¿Por qué no aparece el estado que necesito?
El selector filtra las opciones según el tipo de entrega y las reglas de visibilidad específicas del proyecto. La API también permite distintos subconjuntos de estados según el rol que envía la solicitud, así que no todos los estados de API necesariamente aparecen en este control de Dashboard.
¿Por qué Dashboard volvió al estado anterior?
El cliente inspeccionado restablece la selección cuando la solicitud devuelve un error. El código fuente de la API muestra posibles validaciones de rol, bloqueo del pedido, regresión, ubicación de Driver y operaciones. Antes de decidir si corresponde otro intento, revisa el mensaje devuelto.
Guías relacionadas: Ver y gestionar un pedido · Referencia de estados de pedidos