Workflow Trigger ExtensionsWorkflow Trigger Extensions
Gatilhos para empresas B2B, passo a passo

Gatilhos para empresas B2B, passo a passo

Copiar página

Gatilhos Shopify Flow para empresas B2B: atualização de dados, endereço, isenção fiscal e contato, passo a passo.

Cinco gatilhos para lojas nas funcionalidades B2B do site Shopify: empresas, seus locais, seus contatos e as isenções fiscais de cada local.

Nesta página: Atualização da empresa, Atualização do endereço da empresa, Isenções fiscais do endereço da empresa alteradas, Dados de contato da empresa atualizados, Cliente removido da empresa

Shopify Flow
Onde encontrá-los: em Shopify Flow, selecione “Select a trigger”, acesse Workflow Trigger Extensions e pesquise por “Compan”.

Atualização da empresa

É acionado quando um registro da empresa é atualizado: nome, observação, ID externo.
Incêndios causados por Shopify webhook
Permissão Acesso a dados sobre empresas e seus locais (B2B)
Ligado Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

  • Sincronize empresas com um ERP configurado com base em externalId.

O que o “Company Update” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
company Objeto A empresa que foi atualizada
company.id ID
company.name Texto
company.note Texto
company.externalId Texto
company.customerSince Texto
company.createdAt Texto
company.updatedAt Texto
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Sincronizar uma empresa com o ERP

  1. Selecione “Atualização da empresa” como gatilho.
  2. Adicionar uma condição: company.externalId não estiver vazio e existir.
  3. Adicione a opção “Enviar solicitação HTTP” com {{company.externalId}}, {{company.name}} e {{company.note}}.
  4. Ative o fluxo de trabalho.

Atualização sobre a localização da empresa

É acionado quando os dados de um endereço da empresa são atualizados: nome, telefone, localidade, observação, ID externo.
Incêndios causados por Shopify webhook
Permissão Acesso a dados sobre empresas e local (B2B)
Ligado Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

  • Mantenha atualizados os registros de remessa do ERP.

O que a atualização de localização da empresa envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
companyLocation Objeto A localização da empresa que foi atualizada
companyLocation.id ID
companyLocation.name Texto
companyLocation.note Texto
companyLocation.externalId Texto
companyLocation.locale Texto
companyLocation.phone Texto
companyLocation.currency Texto
companyLocation.createdAt Texto
companyLocation.updatedAt Texto
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Sincronizar um local de entrega

  1. Selecione “Atualização da localização da empresa” como gatilho.
  2. Adicione “Enviar solicitação HTTP” com {{companyLocation.externalId}}, {{companyLocation.name}} e {{companyLocation.currency}}.
  3. Ative o fluxo de trabalho.

Alterações nas isenções fiscais relacionadas à localização da empresa

É acionado quando ocorrem alterações nas isenções fiscais, no número de identificação fiscal ou na marcação de isenção fiscal de uma unidade da empresa. changes.added e changes.removed são listas de isenções, cada uma com um code e um label de fácil compreensão.
Incêndios causados por Verificado periodicamente, pois o Shopify não envia nenhum webhook para isso
Permissão Acesso a dados sobre empresas e seus locais (B2B)
Ligado Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

  • Solicite ao departamento financeiro que verifique todas as novas isenções antes do próximo pedido.
  • Mantenha o sistema tributário em dia.

O que a função “Alterações nas isenções fiscais relacionadas à localização da empresa” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
companyLocation Objeto A sede da empresa cujas isenções fiscais foram alteradas
companyLocation.id ID
companyLocation.name Texto
changes Objeto As isenções fiscais adicionadas / removidas / atuais (cada uma composta por um código + descrição), além do número de identificação fiscal e do indicador de isenção fiscal
changes.added Lista de objetos Isenções fiscais adicionadas nesta alteração.
changes.added (each).code Texto O valor de enumeração da isenção fiscal Shopify (por exemplo, CA_BC_RESELLER_EXEMPTION, EU_REVERSE_CHARGE_EXEMPTION_RULE).
changes.added (each).label Texto Uma etiqueta legível por pessoas derivada do código (por exemplo, “Isenção para revendedores da CA BC”).
changes.removed Lista de objetos As isenções fiscais foram suprimidas com essa alteração.
changes.removed (each).code Texto O valor de enumeração da isenção fiscal Shopify (por exemplo, CA_BC_RESELLER_EXEMPTION, EU_REVERSE_CHARGE_EXEMPTION_RULE).
changes.removed (each).label Texto Uma etiqueta legível por pessoas derivada do código (por exemplo, “Isenção para revendedores da CA BC”).
changes.current Lista de objetos Todas as isenções fiscais atualmente vigentes na sede da empresa (após essa alteração).
changes.current (each).code Texto O valor de enumeração da isenção fiscal Shopify (por exemplo, CA_BC_RESELLER_EXEMPTION, EU_REVERSE_CHARGE_EXEMPTION_RULE).
changes.current (each).label Texto Uma etiqueta legível por pessoas derivada do código (por exemplo, “Isenção para revendedores da CA BC”).
changes.taxRegistrationId Texto Número de identificação fiscal da sede da empresa (em branco caso não tenha sido definido).
changes.taxExempt Verdadeiro / falso Se o local da empresa está totalmente isento de impostos.
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Enviar novas isenções fiscais ao departamento financeiro

  1. A opção “Isenções fiscais relacionadas à localização da empresa” foi definida como o gatilho.
  2. Adicionar uma condição: changes.added não estiver vazio e existir.
  3. Adicione o envio de um e-mail interno com {{companyLocation.name}} e um loop Liquid for sobre changes.added que exiba label e code de cada isenção.
  4. Ative o fluxo de trabalho.

Contato da empresa atualizado

É acionado quando um contato da empresa é atualizado: cargo, localização, indicador de contato principal.
Incêndios causados por Shopify webhook
Permissão Acesso a dados de empresas e localização de empresas (B2B) + Acesso a dados de clientes
Ligado Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

  • Informe o gerente de contas sempre que houver uma mudança no principal contato de uma empresa.

O que o evento “Contato da empresa atualizado” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
customer Cliente (Shopify) O cliente cujos dados de contato da empresa foram atualizados. Trata-se de um cliente com acesso completo ao Shopify; portanto, todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
company Objeto A empresa à qual o contato pertence (ID, nome, ID externo, observação)
company.id ID
company.name Texto
company.externalId Texto
company.note Texto
companyContact Objeto Os dados atualizados do contato (ID, cargo, localidade, se é o contato principal)
companyContact.id ID
companyContact.title Texto
companyContact.locale Texto
companyContact.isMainContact Verdadeiro / falso
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Notificar sobre um novo contato principal

  1. Selecione “Contato da empresa atualizado” como o gatilho.
  2. Adicione uma condição: companyContact.isMainContact seja igual a true.
  3. Adicione a opção “Enviar e-mail interno” com {{company.name}} e {{customer.displayName}}.
  4. Ative o fluxo de trabalho.

Cliente removido da empresa

É acionado quando um cliente é removido da lista de contatos de uma empresa.
Incêndios causados por Shopify webhook
Permissão Acesso a dados de empresas e localização (B2B) + Acesso a dados de clientes
Ligado Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

  • Remova as tags B2B, o acesso à lista de preços ou os dados de login no portal de quem deixou a empresa.

O que o cliente removeu da empresa é enviado para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
customer Cliente (Shopify) O cliente que foi removido da empresa. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
company Objeto A empresa da qual o cliente foi removido (ID, nome, ID externo, observação)
company.id ID
company.name Texto
company.externalId Texto
company.note Texto
companyContact Objeto O contato removido (ID, cargo, localidade, se era o contato principal)
companyContact.id ID
companyContact.title Texto
companyContact.locale Texto
companyContact.isMainContact Verdadeiro / falso
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Remover a tag “atacado” de um contato excluído

  1. Selecione “Cliente removido da empresa” como gatilho.
  2. Adicione ou remova tags de clientes com o wholesale.
  3. Adicione a opção “Enviar e-mail interno” ao gerente de contas da {{company.name}}.
  4. Ative o fluxo de trabalho.

Próximos passos

O acesso às empresas depende do acesso aos dados do cliente: sem ele, o link Shopify não exibe nenhuma empresa. Conceda primeiro o acesso ao cliente e, em seguida, o acesso às empresas. Para compradores B2B que visitam a loja virtual, consulte Gatilhos da loja virtual, passo a passo.