Workflow Trigger ExtensionsWorkflow Trigger Extensions

Condições de acionamento da ordem preliminar, passo a passo

Os pedidos em rascunho são onde se encontram as cotações B2B, os pedidos por grosso e os pedidos por telefone, e o Shopify Flow praticamente não oferece nada para eles. Estes dez gatilhos abrangem todo o ciclo de vida de um rascunho: edições, estado, etiquetas, notas e, opcionalmente, os dados de contacto.

Nesta página: Atualização do pedido preliminar, Alteração do estado do pedido preliminar, Alteração dos itens do pedido preliminar, Adição de etiquetas ao pedido preliminar, Remoção de etiquetas do pedido preliminar, Alteração da nota do pedido preliminar, Alteração dos atributos do pedido preliminar, Alteração do e-mail do pedido preliminar, Alteração da morada de envio do pedido preliminar, Alteração da morada de faturação do pedido preliminar

Shopify Flow
Onde os encontrar: em Shopify Flow, selecione «Select a trigger», abra Workflow Trigger Extensions e procure por «Draft Order».

Atualização do projeto de decreto

Aciona-se sempre que se guarda uma ordem de seleção.
Incêndios provocados por Shopify webhook
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Importar citações para um CRM.
  • Uma solução provisória enquanto decide qual o gatilho mais específico que se adequa melhor.

O que a atualização da ordem preliminar envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O projeto de decreto que foi atualizado
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.totalPrice Texto
draftOrder.currencyCode Texto
draftOrder.tags Texto
draftOrder.note Texto
draftOrder.invoiceUrl Texto
draftOrder.updatedAt Texto
payload Texto Objeto JSON que contém o GID do pedido em rascunho que foi atualizado (por exemplo, {"id":"gid://shopify/DraftOrder/123"})
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Refletir todas as alterações nas cotações no CRM

  1. Selecione «Atualização da ordem do draft» como gatilho.
  2. Adicione «Enviar pedido HTTP» com {{draftOrder.id}}, {{draftOrder.name}}, {{draftOrder.status}} e {{draftOrder.totalPrice}} {{draftOrder.currencyCode}}.
  3. Ative o fluxo de trabalho.

Alteração do estado do pedido preliminar

É acionado quando uma ordem preliminar é transferida entre open, invoice_sent e completed.
Incêndios causados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Iniciar uma sequência de lembretes quando for enviada uma fatura.
  • Informe o gestor de contas quando um orçamento se transformar numa encomenda.

O que a função «Alteração do estado do rascunho da encomenda» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O projeto de decreto cujo estado se alterou
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
oldStatus Texto O estado anterior do rascunho da encomenda (em aberto / fatura enviada / concluída)
newStatus Texto O novo estado do rascunho da encomenda (em aberto / fatura enviada / concluída)
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Enviar um lembrete ao cliente três dias após a emissão da fatura

  1. Selecione «Alteração do estado da ordem de seleção» como condição de ativação.
  2. Adicionar uma condição: newStatus é igual a invoice_sent.
  3. Adicione «Aguardar 3 dias» e, em seguida, envie um pedido HTTP para a sua ferramenta de e-mail com {{draftOrder.name}}.
  4. Ative o fluxo de trabalho.

Alterações aos itens da linha de encomenda do rascunho

É acionado quando os itens de uma ordem preliminar sofrem alterações: adição, remoção, quantidade, preço ou variante. Apresenta a mesma estrutura changes.items que o acionador de ordem.
Incêndios causados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação.

Utilize-o para

  • Exigir aprovação sempre que um representante de vendas reduzir o preço de um orçamento.
  • Mantenha o sistema de reservas em sintonia com os orçamentos.

O que a função «Itens de linha de encomenda alterados (rascunho)» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da ordem cujos itens foram alterados
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
changes Objeto Alterações nas linhas de item: adições, eliminações, alterações na quantidade, no preço e nas variantes, com os respetivos valores antigos e novos
changes.items Lista de objetos Lista das alterações detetadas
changes.items (each).changeType Texto Tipo de alteração: adicionado, removido, quantidade_alterada, preço_alterado, variante_alterada
changes.items (each).lineItemId ID ID da rubrica (se disponível)
changes.items (each).productTitle Texto Título do produto
changes.items (each).variantTitle Texto Título alternativo
changes.items (each).oldVariantId ID Variante antiga GID (para «removido» ou «variante alterada»)
changes.items (each).newVariantId ID Nova variante GID (para «adicionado» ou «variante_alterada»)
changes.items (each).oldProductId ID GID do produto antigo (para produtos removidos ou cuja variante foi alterada)
changes.items (each).newProductId ID GID do novo produto (para «adicionado» ou «variante alterada»)
changes.items (each).oldQuantity Número Quantidade anterior (para quantity_changed)
changes.items (each).newQuantity Número Nova quantidade (para quantity_changed)
changes.items (each).oldPrice Texto Preço anterior (para price_changed)
changes.items (each).newPrice Texto Novo preço (para price_changed)
changes.items (each).lineItemData Texto Dados completos das rubricas em formato JSON
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Solicitar aprovação quando o preço de um orçamento for alterado

  1. Selecionar «Alterações nos itens da ordem de seleção» como condição de acionamento.
  2. Adicionar uma condição: Pelo menos um dos seguintes **elementos - changes.items - ** tem changeType igual a price_changed.
  3. Adicionar as etiquetas de encomenda preliminar needs-approval e enviar um e-mail interno ao responsável pelas vendas com os campos oldPrice e newPrice das entradas alteradas (um ciclo Liquid for sobre changes.items).
  4. Ative o fluxo de trabalho.

Adicionadas etiquetas de rascunho da ordem

É acionado quando é adicionada pelo menos uma etiqueta a um rascunho de encomenda.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Deixem que a equipa de vendas inicie um processo ao atribuir uma etiqueta a um orçamento: approved, rush.

O que a funcionalidade «Adicionar etiquetas ao rascunho» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da ordem cujas etiquetas foram alteradas
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.tags Texto
addedTags Texto Lista de etiquetas, separadas por vírgulas, que foram adicionadas ao rascunho da encomenda
removedTags Texto Lista separada por vírgulas das etiquetas que foram removidas da ordem preliminar na mesma atualização (pode estar vazia)
currentTags Texto Lista separada por vírgulas de todas as etiquetas atuais na ordem preliminar
previousTags Texto Lista separada por vírgulas de todas as etiquetas anteriores que constavam na ordem preliminar antes desta atualização
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Notificar o departamento financeiro quando uma cotação for aprovada

  1. Foram adicionadas as etiquetas «Ordem do Draft» como condição de ativação.
  2. Adicionar uma condição: addedTags inclui approved.
  3. Adicionar a opção «Enviar e-mail interno ao departamento financeiro» com {{draftOrder.name}}.
  4. Ative o fluxo de trabalho.

Etiquetas de rascunho da ordem removidas

É executado quando pelo menos uma etiqueta é removida de um pedido preliminar.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este fique ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Anular o que foi feito pelo fluxo de trabalho de correspondência de etiquetas.

O que a função «Remoção de etiquetas de rascunho» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da ordem cujas etiquetas foram alteradas
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.tags Texto
addedTags Texto Lista separada por vírgulas das etiquetas que foram adicionadas ao rascunho da encomenda na mesma atualização (pode estar vazia)
removedTags Texto Lista separada por vírgulas das etiquetas que foram removidas do rascunho da ordem
currentTags Texto Lista separada por vírgulas de todas as etiquetas atuais na ordem preliminar
previousTags Texto Lista separada por vírgulas de todas as etiquetas anteriores na ordem do rascunho antes desta atualização
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Informar o departamento de vendas quando a aprovação for retirada

  1. As etiquetas «Pick Draft Order» foram removidas como condição de ativação.
  2. Adicionar uma condição: removedTags inclui approved.
  3. Adicionar «Enviar e-mail interno ao representante de vendas».
  4. Ative o fluxo de trabalho.

Nota sobre o projeto de decreto alterada

É disparado quando a nota de uma ordem de pagamento é adicionada, alterada ou anulada.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Transmitir as observações internas relativas a um orçamento à equipa seguinte.

O que a nota «Alterações à ordem preliminar» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O projeto de decreto cuja nota foi alterada
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.note Texto
oldNote Texto A nota anterior relativa ao projeto de ordem (vazia se a nota não tiver sido definida anteriormente)
newNote Texto A nova nota no rascunho da encomenda (em branco se a nota tiver sido apagada)
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Encaminhar notas de cotação para o canal da conta

  1. A «Nota sobre a alteração da ordem do draft» foi definida como o gatilho.
  2. Adicionar a funcionalidade «Enviar pedido HTTP para o Slack» com o {{draftOrder.name}}: {{newNote}}.
  3. Ative o fluxo de trabalho.

Atributos do rascunho da ordem alterados

É disparado quando são adicionados, removidos ou alterados atributos personalizados numa encomenda preliminar.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Reagir a um número de ordem de compra ou a uma semana de entrega solicitada, armazenados como um atributo.

O que a função «Atributos da ordem preliminar alterados» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da ordem cujos atributos personalizados foram alterados
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
changes Objeto Foram detetadas alterações nos atributos. Cada item tem um «changeType» (adicionado, removido ou alterado), a chave e os valores antigo e novo.
changes.items Lista de objetos Lista das alterações de atributos detetadas
changes.items (each).changeType Texto Tipo de alteração: adicionado, removido, alterado
changes.items (each).key Texto A chave do atributo
changes.items (each).oldValue Texto O valor anterior (cadeia vazia quando changeType é 'added')
changes.items (each).newValue Texto O novo valor (cadeia vazia quando changeType é 'removed')
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Obter um número de ordem de compra

  1. Selecionar «Atributos da ordem do draft alterados» como condição de ativação.
  2. Adicionar uma condição: Pelo menos um dos seguintes **elementos - changes.items - ** tem key igual a po_number.
  3. Adicione «Enviar pedido HTTP» ao ERP com o novo valor.
  4. Ative o fluxo de trabalho.

Alteração do e-mail relativo ao rascunho da ordem

É acionado quando o endereço de e-mail de um pedido em rascunho é alterado. Contém o endereço atual.
Incêndios causados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de portaria
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Certifique-se de que as faturas são enviadas para a morada correta.

O que o e-mail «Alteração do rascunho da encomenda» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da ordem cujo endereço de e-mail foi alterado
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.note Texto
email Texto O endereço de e-mail atual do projeto de decreto
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Reenviar a fatura após uma correção no e-mail

  1. O e-mail relativo à ordem de seleção no draft foi alterado no fluxo.
  2. Adicionar uma condição: draftOrder.status é igual a invoice_sent.
  3. Adicionar: Enviar um e-mail interno a pedir ao representante que reenvie a fatura.
  4. Ative o fluxo de trabalho.

Alteração do endereço de entrega de uma encomenda em espera de confirmação

É acionado quando a morada de entrega de uma encomenda em rascunho é alterada.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Recalcular os portes de envio ou os impostos de uma cotação quando o destino for alterado.

O que a ordem preliminar «Alteração da morada de envio» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O pedido em fase de processamento cuja morada de entrega foi alterada
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.note Texto
shippingAddress Texto O endereço de envio (entrega) atual da encomenda preliminar, apresentado numa única linha formatada (pode estar vazio)
shippingAddressDetails Objeto A morada de envio (entrega) atual da encomenda preliminar, sob a forma de campos estruturados (pode estar em branco)
shippingAddressDetails.firstName Texto Nome próprio que consta na morada
shippingAddressDetails.lastName Texto Apelido que consta na morada
shippingAddressDetails.name Texto Nome completo, derivado de «firstName» e «lastName»
shippingAddressDetails.company Texto Nome da empresa ou organização
shippingAddressDetails.address1 Texto Primeira linha - morada ou número de caixa postal
shippingAddressDetails.address2 Texto Segunda linha - apartamento, suite ou unidade
shippingAddressDetails.city Texto Cidade, distrito, aldeia ou vila
shippingAddressDetails.province Texto Região - província, estado ou distrito
shippingAddressDetails.provinceCode Texto Código da região (por exemplo, ON)
shippingAddressDetails.zip Texto Código postal
shippingAddressDetails.country Texto Nome do país
shippingAddressDetails.countryCode Texto Código de país de duas letras (por exemplo, US)
shippingAddressDetails.phone Texto Número de telefone indicado na morada
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Assinalar as cotações cujo país de destino mudou

  1. Ordem de seleção do draft: endereço de envio alterado no fluxo.
  2. Adicione as etiquetas recheck-shipping ao rascunho da encomenda e mencione {{shippingAddressDetails.countryCode}} num e-mail interno.
  3. Ative o fluxo de trabalho.

Alteração do endereço de faturação do pedido de ordem de pagamento

É acionado quando o endereço de faturação de uma encomenda em rascunho é alterado.
Incêndios provocados por Shopify webhook e deteção de alterações
Autorização Acesso aos dados do projeto de decreto
Ligado Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

  • Mantenha atualizado o registo do devedor no sistema ERP antes da emissão da fatura.

O que a ordem preliminar «Alteração do endereço de faturação» envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
draftOrder Objeto O rascunho da encomenda cujo endereço de faturação mudou
draftOrder.id ID
draftOrder.name Texto
draftOrder.status Texto
draftOrder.note Texto
billingAddress Texto O endereço de faturação atual da encomenda preliminar, apresentado numa única linha formatada (pode estar em branco)
billingAddressDetails Objeto O endereço de faturação atual da encomenda preliminar, sob a forma de campos estruturados (pode estar em branco)
billingAddressDetails.firstName Texto Nome próprio que consta na morada
billingAddressDetails.lastName Texto Apelido que consta na morada
billingAddressDetails.name Texto Nome completo, derivado de «firstName» e «lastName»
billingAddressDetails.company Texto Nome da empresa ou organização
billingAddressDetails.address1 Texto Primeira linha - morada ou número de caixa postal
billingAddressDetails.address2 Texto Segunda linha - apartamento, suite ou unidade
billingAddressDetails.city Texto Cidade, distrito, aldeia ou vila
billingAddressDetails.province Texto Região - província, estado ou distrito
billingAddressDetails.provinceCode Texto Código da região (por exemplo, ON)
billingAddressDetails.zip Texto Código postal
billingAddressDetails.country Texto Nome do país
billingAddressDetails.countryCode Texto Código de país de duas letras (por exemplo, US)
billingAddressDetails.phone Texto Número de telefone indicado na morada
eventId Texto O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Atualizar o ERP antes da emissão da fatura

  1. Ordem de seleção no draft: endereço de faturação alterado no fluxo.
  2. Adicione a opção «Enviar pedido HTTP» com {{draftOrder.id}} e os campos de billingAddressDetails.
  3. Ative o fluxo de trabalho.

Próximos passos

Um rascunho de ordem não é um tipo de referência do Flow, pelo que estes gatilhos devolvem um objeto draftOrder com o ID, o nome e o estado. Para qualquer outra situação, adicione uma etapa «Enviar pedido à API de administração» ou «Executar código» com draftOrder.id.