Status dos Pedidos

Os status dos pedidos são necessários para acompanhar o progresso do pedido desde sua criação até a conclusão. Eles ajudam a sistematizar o trabalho com os pedidos para os gerentes, além de permitir que o cliente veja o estado atual do pedido.

Cada repositório de pedidos tem seu próprio conjunto de status, portanto, para diferentes grupos de produtos, você pode adicionar status únicos, característicos de um grupo específico.

Modos de Trabalho com Status

Na parte superior da seção "Status dos Pedidos" há um bloco "Configuração do Modo de Status do Pedido", onde você pode escolher um dos dois modos de operação:

• Básico (Basic) — modo padrão. Utiliza um único conjunto de status vinculado à conta de pagamento. O status do pedido muda linearmente com base nos eventos de pagamento. Este modo é suficiente para a maioria dos cenários.
• Avançado (Advanced) — configuração flexível em três eixos independentes: order (status principal do pedido), fulfillment (execução — coleta, envio, entrega) e payment (pagamento). Para cada eixo, é definido um conjunto próprio de status, mapas de transições automáticas por gatilhos e gatilhos personalizados.

Para mudar o modo, selecione a opção desejada no bloco "Configuração do Modo de Status do Pedido" e confirme a ação na janela pop-up.

Importante entender

Ao alternar para o modo avançado, é essencial definir um status padrão para o eixo order — é a partir dele que se inicia o ciclo de vida do pedido. Enquanto o status padrão para o eixo order não estiver definido, os dados são considerados inválidos e a salvaguarda do repositório está bloqueada.

Criação de Status

Para criar um novo status de pedido, abra a seção de pedidos no menu à esquerda. Selecione na lista o repositório de pedidos onde deseja criar um novo status de pedido e clique no ícone de edição . Vá para a seção "Status dos Pedidos".

No bloco de criação de um novo status, preencha:

• Nome do status - Uma string não única. O nome também reflete a essência do status. Por exemplo, o status pode ser chamado de "Em Transporte" ou "Concluído". É essa informação que o gerente e o usuário verão na seção de status do pedido.
• Marcador - Uma string única, utilizada dentro do código do seu aplicativo. Lembre-se disso ao criar o marcador, para que não cause conflitos no funcionamento do aplicativo.

Após preencher os campos, clique no botão "Adicionar". Se todos os dados forem inseridos corretamente, o status será salvo automaticamente e adicionado à lista geral.

Alteração de Status

Para fazer alterações em um status de pedido já existente, abra a seção de pedidos no menu à esquerda. Selecione na lista o repositório de pedidos onde deseja criar um novo status de pedido e clique no ícone de edição . Vá para a seção "Status dos Pedidos".

Selecione na lista o status que deseja alterar e clique no ícone de edição . Você pode alterar o nome do status e seu marcador.

Importante entender

Se o status já estiver sendo utilizado em seu aplicativo, altere o marcador apenas se tiver certeza de que isso não prejudicará o funcionamento do aplicativo.

Valor Padrão

Você pode escolher um dos status como valor padrão. O status com essa marcação será definido sempre que nenhum outro status for estabelecido.

Para tornar um status o padrão, vá para as configurações do status clicando no ícone de edição . Marque a opção "Valor Padrão".

Em um repositório de pedidos, pode haver apenas um status com essa configuração. Na lista geral, esse status será marcado com um marcador especial.

Exclusão de Status

Para excluir um status de pedido, abra a seção de pedidos no menu à esquerda. Selecione na lista o repositório de pedidos onde deseja criar um novo status de pedido e clique no ícone de edição . Vá para a seção "Status dos Pedidos".

Selecione na lista geral o status do pedido que deseja excluir. Clique no ícone de exclusão . Confirme a ação na janela pop-up. O status será removido da lista, bem como dos pedidos em que está sendo utilizado.

Modo Avançado

O modo avançado (Advanced) é destinado a cenários complexos de processamento de pedidos, quando um único conjunto linear de status não é suficiente. Ele divide os status em três eixos independentes e permite configurar transições automáticas entre os status com base em gatilhos.

Para ativar o modo avançado, no bloco "Configuração do Modo de Status do Pedido", selecione a opção Advanced e confirme a mudança.

Três Eixos de Status

No modo avançado, cada pedido possui três eixos independentes de status:

• order — status comercial principal do pedido.
• fulfillment — execução do pedido (coleta, envio, entrega).
• payment — status de pagamento.

Cada status pertence a apenas um eixo. Os eixos order e fulfillment são gerenciados pelo vendedor (manualmente ou por meio de integração), enquanto o eixo payment é gerenciado automaticamente pelo sistema com base nos eventos de pagamento.

Importante entender

Um status que está envolvido em um mapa de transições ou atribuído a algum pedido não pode ser excluído.

Criação de Status no Modo Avançado

A criação de status é realizada da mesma forma que no modo básico, mas no formulário de criação aparece um campo adicional para selecionar o eixo ao qual o status pertence (Order status, Fulfillment ou Payment). Na lista geral de status, uma coluna adicional "Eixo" é exibida, mostrando a afiliação de cada status.

Mapas de Status

Ao ativar o modo avançado, aparece a aba "Status dos Pedidos" → "Status mapping" (mapas de status). O mapa traduz automaticamente o status do eixo order ou fulfillment com base em um gatilho. Por exemplo, ao ocorrer o gatilho payment.paid, o status do eixo order é alterado para "Pago".

A configuração do mapa é dividida em sub-abas por eixos (Order status e Fulfillment). Para cada gatilho, agrupado por categorias (eventos de pedido, pagamento e devolução), é especificado o status de destino para o qual o pedido deve ser transferido. O status inicial é retirado do status padrão do eixo correspondente.

Após configurar o mapa, clique no botão "Salvar".

info

Os status dos eixos order e fulfillment podem ser alterados manualmente ou por meio de integração. O eixo payment é gerenciado apenas pelo sistema com base nos eventos de pagamento.

Gatilhos Personalizados

Na aba de mapas de status, você pode criar seus próprios gatilhos personalizados do tipo custom.{name}. Esses gatilhos são acionados apenas por meio de integração API e estão disponíveis para os eixos order e fulfillment. Isso permite descrever transições de status para eventos de negócios não padronizados do seu aplicativo.