Status de pedido

Marcar pedido como lido

PUT

/orders/v1/{order}/read

Ao receber um pedido, o usuário tem a opção de ler o pedido. Para ler o pedido, deve ser usado o endpoint /orders/v1/{order}/read

O usuário deve confirmar a leitura do pedido dentro de 10 minutos após seu recebimento. Caso ultrapasse, o pedido é cancelado automaticamente. A loja pode ser fechada temporariamente caso tenha muitos pedidos cancelados automaticamente.

Marcar pedido como em separação

PUT

/orders/v1/{order}/in-separation

A opção de marcar como em separação está disponível apenas a usuários com lojas do tipo catálogo (categorias mercados, farmácias, pet shops, shopping). Esse evento deve ser gerado apenas após a confirmação do pedido e antes de ele ser despachado. Se a requisição for feita fora desse intervalo, ela será ignorada. Seu uso é opcional, porém a utilização é recomendada para aprimorar a experiência do usuário e notificá-lo no app de que o pedido está sendo preparado, especialmente em pedidos agendados.

Marcar pedido como pronto

PUT

/orders/v1/{order}/ready

Quando o pedido estiver pronto para ser entregue (por um entregador) ou retirado (pelo cliente), a sua aplicação deve enviar uma requisição PUT para o endpoint /orders/v1/{order}/ready.

Essa ação é crucial, pois ela inicia a última etapa da jornada do pedido para Cardápio, atualizando o status tanto para o cliente (no aplicativo do Aiqfome) quanto para o lojista (no painel de gestão da loja).

Impacto da Ação:

O status final do pedido varia de acordo com o tipo de entrega selecionado no momento da compra.

• Pedidos de Retirada:

• Para o Cliente: O aplicativo do cliente é atualizado para indicar que o pedido está pronto para a retirada.
• Para o Lojista: No painel de gestão da loja, o pedido será movido para o status "Finalizado". Essa é a última marcação possível para pedidos de retirada.

• Pedidos de Entrega:

• Para o Cliente: O aplicativo do cliente é atualizado para indicar que o pedido saiu para entrega.
• Para o Lojista: O pedido também será movido para o status "Finalizado" no painel de gestão da loja.

Marcar pedido como entregue

PUT

/orders/v1/{order}/delivered

Este endpoint é usado para confirmar que um pedido foi entregue com sucesso. O uso desta ação é opcional, mas recomendado, pois ajuda no acompanhamento do fluxo de pedidos e agiliza o suporte em casos de eventuais ocorrências.

Importante: Só é possível marcar um pedido como entregue (delivered) se ele já tiver sido previamente marcado como pronto (ready). A chamada a este endpoint deve ser feita após a requisição PUT /orders/v1/{order}/ready.

A chamada a este endpoint é aplicável apenas quando a entrega é feita por logística própria do estabelecimento. Caso a entrega seja realizada por um entregador parceiro que usa o Aiqentrega, a confirmação ocorre diretamente pelo aplicativo do Aiqentrega, portanto não é necessário utilizar este endpoint.