Automatizar pedidos rascunho com o Shopify Flow

Use tarefas separadas do Kanbanify para mover um pedido rascunho aberto, definir seu marcador, atribuir um colega existente ou ler seus detalhes atuais. Tarefas de rascunho diferem das de Pedido: Draft order stage changed fornece uma ID de rascunho em texto, não a referência nativa de Pedido do Shopify Flow.

Antes de começar

• Instale Shopify Flow e Kanbanify na mesma loja, ative o quadro Rascunhos e conceda ao Kanbanify o acesso solicitado a Pedidos rascunho.
• Prepare duas etapas definidas pelo lojista naquele quadro. No menu de ações da etapa de destino, use Copy stage ID (também disponível nas Configurações Kanbanify). Use a ID, não o nome da etapa; o Flow não possui seletor de etapas Kanbanify.
• Para atribuição, escolha alguém que já esteja em Configurações → Lista da equipe. Use o e-mail da lista, não o nome exibido nem um identificador de equipe Shopify. A ação não adiciona colegas nem envia convites.
• Teste com um rascunho aberto descartável antes de ativar automação essencial. A disponibilidade depende da versão do Kanbanify implantada na loja.

Conecte o gatilho a cada ação

1. No Shopify Flow, crie um fluxo com o gatilho Kanbanify Draft order stage changed. Ele começa no posicionamento inicial no quadro Rascunhos ou em uma mudança real entre etapas, não em toda edição do rascunho.
2. Adicione condições que restrinjam o fluxo ao quadro Rascunhos e à ID da etapa de destino do gatilho. No teste inicial, restrinja também a uma ID de rascunho descartável.
3. Adicione uma ou mais ações Kanbanify abaixo. No campo Draft Order ID (draft_order_id) de cada ação, insira a variável de gatilho draftOrderId pelo seletor de variáveis do Flow. Não digite o nome da variável como texto literal.

Uma ID de rascunho decimal positiva ou gid://shopify/DraftOrder/<id> é aceita. Uma GID de Pedido, nome exibido como #D123, URL admin, entrada vazia ou ID de outro recurso não é aceita. O rascunho deve continuar aberto ou com fatura enviada. Etapas removidas, etapas de sistema, etapas de outro quadro e contexto inválido são rejeitados antes de alterações. Apenas uma associação de quadro comprovadamente ausente pode usar o quadro Rascunhos configurado; metadados salvos incompletos ou inválidos não são substituídos silenciosamente.

Leia detalhes atuais após uma espera

Após uma etapa Wait, adicione Get draft order details, vincule draftOrderId a draft_order_id e acrescente uma condição usando os valores retornados. A ação lê o estado armazenado atual quando executa, não o estado do gatilho anterior. Use Get order details da mesma forma em um fluxo de Pedido após uma espera; ele usa a referência de Pedido nativa do Flow.

O que as ações de detalhes retornam

Ambas retornam id, name, tags e os valores Kanbanify salvos boardId, stageId, sortKey, cardColor e assignee. Também retornam boardName e stageName legíveis. Get order details também retorna dueDate, exclusivo de Pedido, e closedAt nativo do Shopify: é null até Shopify fechar o Pedido, depois é o timestamp Shopify. Get draft order details retorna completedAt nativo: é null até o rascunho virar Pedido, depois é o timestamp Shopify.

Use boardId e stageId em condições estáveis, e nomes resolvidos em mensagens ou condições legíveis. Após uma espera, escolha completedAt ou closedAt nos dados retornados quando a condição depender do ciclo de vida nativo; os campos têm significados distintos e não são intercambiáveis. Os valores Kanbanify são retornados exatamente como armazenados: a ação não decodifica marcador nem resolve responsável. Uma ID de quadro ou etapa obsoleta ou ausente continua disponível como valor bruto, enquanto o nome correspondente é null; o Kanbanify não substitui outro quadro ou etapa de sistema.

As duas ações são somente leitura: não movem nem atualizam Pedido ou rascunho e não iniciam outro fluxo Flow.

Um exemplo sem loop

Para um rascunho de teste, condicione ID da etapa de destino = sua ID de etapa de entrada. Encadeie:

1. Defina a etapa como uma ID de destino diferente.
2. Defina o marcador como Teal / Diagonal stripe.
3. Atribua um colega de teste existente por e-mail.

Vincule o draftOrderId do gatilho original às três ações. O segundo evento de etapa informa o destino e deve falhar na condição de entrada, evitando loop. A ação de marcador ocorre após a ação de etapa e substitui qualquer marcador padrão de destino. As ações são independentes, não uma transação: examine o resultado de cada uma.

Ative o fluxo de teste, mova o rascunho para a etapa de entrada e examine o histórico do Flow; recarregue o Kanbanify para confirmar etapa, marcador e responsável naquele rascunho. Verifique os resultados das ações, não apenas que um fluxo foi iniciado. Desative ou remova o fluxo de teste antes de apagar dados descartáveis. Evite regras que movam um rascunho de um lado para outro.

O que sucesso e novas tentativas significam

• O sucesso da ação de etapa de rascunho confirma apenas o posicionamento salvo. Um marcador padrão de destino é salvo com a etapa; sem padrão, o marcador atual é preservado. Responsável e metadados não relacionados não mudam.
• Limpeza de ordenação manual, tags automáticas e envio do gatilho posterior são esforços após o salvamento. Falhas não desfazem a etapa nem tornam a ação uma falha. Falha ao adicionar nova tag deixa de remover tags antigas; falha na remoção pode manter ambas. Confira cartão e tags quando forem importantes.
• Uma solicitação válida para a etapa já salva tem sucesso sem mudanças. Ela não corrige falhas anteriores de ordenação/tag nem repete um gatilho, mesmo após resposta de salvamento perdida.
• Ações válidas repetidas de marcador ou responsável gravam com segurança os mesmos valores. Elas não mudam etapa, tags ou posição manual. A última gravação bem-sucedida prevalece.
• Falha de validação ou busca faz a ação falhar antes de gravar. Um salvamento primário rejeitado preserva o estado anterior; uma conexão perdida após o envio pode ocultar uma gravação concluída. Recarregue o rascunho antes de decidir. Não há reversão ou compensação automática.
• Um gatilho enviado não prova que um fluxo executou. Kanbanify não oferece entrega garantida, execução exatamente uma vez, deduplicação concorrente ou repetição automática.

Movimentos no quadro e ações de etapa de Pedido existentes têm limites de falha diferentes. Um movimento no quadro pode salvar a etapa e ainda falhar na limpeza de ordenação necessária (sem gatilho) ou nas tags (após tentar o gatilho do recurso). A ação de etapa de Pedido pode parar antes do gatilho após uma etapa salva se limpeza ou solicitação de tag lançar erro. Tentar de novo na mesma etapa não repara nem repete esses envios. Não aplique a regra de sucesso de posicionamento do rascunho a essas entradas.

Quando um rascunho se torna um Pedido

Concluir um rascunho no Shopify nunca inicia o gatilho de rascunho. Normalmente, Kanbanify copia marcador/responsável, coloca o Pedido resultante na primeira etapa do quadro Pedidos, trata tags de etapa e limpeza do rascunho e então tenta uma vez o gatilho de mudança de etapa Order.

Há um limite de tentativa retido: se a etapa do Pedido salvar, mas tags de conversão ou limpeza falharem antes do envio, uma tentativa posterior bem-sucedida pode ver a etapa salva e enviar zero gatilhos Order. A conversão não tem garantia de recuperação ou repetição. Verifique o Pedido resultante e o histórico do Flow; não conte com a conversão para notificações garantidas uma vez.

Mantenha fluxos de Pedido e rascunho separados

Nomes de tarefas de Pedido existentes e vínculos de Pedido nativos continuam disponíveis. O gatilho de Pedido também fornece orderName e orderAdminUrl; os campos originais permanecem. Solicitações no quadro de Pedido para a mesma etapa não iniciam o Flow. Mantenha um fluxo de Pedido existente como verificação independente ao introduzir automação de rascunhos.

O gatilho de rascunho oferece ID/nome/URL admin do rascunho, quadro, etapa de origem/destino e contexto de responsável capturado. Texto opcional pode estar vazio e posições indisponíveis são -1; o posicionamento inicial não possui etapa de origem. Ele não expõe referência tipada de rascunho, dados arbitrários, notas ou tags. Campos de responsável capturados não são atualizados por atribuição posterior no fluxo.

Não há ação combinada de rascunho, ação de transferência de quadro nem ações separadas de rascunho para ordenação, tags, conclusão, data de vencimento ou notas. Marcador, responsável, reordenação/ordenação, tags, notas, conclusão e conversão não iniciam o gatilho de etapa de rascunho. Não é possível concluir rascunhos pelo Kanbanify ou por suas ações Flow.