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 (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.
Ao alternar para o modo avançado, é essencial definir um status padrão para o eixo Order status — é a partir dele que se inicia o ciclo de vida do pedido. Enquanto o status padrão para o eixo Order status não estiver definido, os dados são considerados inválidos e a salvaguarda do repositório é bloqueada.
Os status criados no modo básico, após a mudança, vão para o eixo Payment. Para o eixo Order status, os status precisam ser criados novamente — antes disso, uma mensagem de aviso "No default status set for the 'order' axis" será exibida na seção.
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 alterar o status do 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 (Name), seu marcador (Marker), bem como as configurações de Default status, Final cancellation e Final Success.
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 outro status não for estabelecido.
Para tornar um status o status padrão, vá para as configurações do status clicando no ícone de edição .
Marque a opção Default status. O status padrão é automaticamente atribuído ao pedido na criaçã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.
Cancelamento Final
Marque a opção Final cancellation se o status significar o cancelamento final do pedido. Ao mudar o pedido para esse status, o pedido é cancelado e os bônus aplicados a ele são devolvidos. Normalmente, essa configuração é ativada para status que correspondem aos status de pagamento expired e canceled.
Sucesso Final
Marque a opção Final Success se o status significar a conclusão bem-sucedida do pedido. Pedidos nesse status são contabilizados no LTV do cliente — o total de todos os seus pedidos pagos.
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 excluir o status do 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.
Um status atribuído a algum pedido ou utilizado em um mapa de status não pode ser excluído — o ícone de exclusão não é exibido para esse status.
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 tem três eixos independentes de status:
- Order status — status de negócios 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 status e Fulfillment são gerenciados pelo vendedor (manualmente ou por meio de integração), enquanto o eixo Payment é gerenciado automaticamente pelo sistema com base em eventos de pagamento.
Um status 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, uma aba "Status dos Pedidos" → "Status mapping" (mapas de status) aparece. O mapa traduz automaticamente o status do eixo Order status ou Fulfillment com base em um gatilho. Por exemplo, ao ocorrer o gatilho payment.paid, o status do eixo Order status é 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".
Os status dos eixos Order status e Fulfillment podem ser alterados manualmente ou por meio de integração. O eixo Payment é gerenciado apenas pelo sistema com base em 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 status e Fulfillment. Isso permite descrever transições de status para eventos de negócios não padronizados do seu aplicativo.