Workflow Trigger ExtensionsWorkflow Trigger Extensions

Triggers para empresas B2B, passo a passo

Cinco critérios de filtragem para lojas nos recursos B2B do site Shopify: empresas, suas localizações, seus contatos e as isenções fiscais de cada local.

Nesta página: Atualização da empresa, Atualização da localização da empresa, Isenções fiscais da localização da empresa alteradas, Contato da empresa atualizado, 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 localização (B2B)
Ligado Ativar um fluxo de trabalho do Flow que o utilize aciona esse recurso. O botão de ativação fica na página “Gatilhos” do aplicativo.

Use-o para

  • Sincronize as empresas com um ERP baseado no sistema externalId.

O que a “Atualização da empresa” envia para o seu fluxo de trabalho

Variável no fluxo 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 ver 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 está vazio e existe.
  3. Adicione “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 localização das empresas (B2B)
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação fica na página “Gatilhos” do aplicativo

Use-o para

  • Mantenha atualizados os registros de remessa de um ERP.

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

Variável no fluxo 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 endereço 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 CNPJ 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 link code e um link legível label.
Incêndios causados por Verificado em intervalos regulares, pois o Shopify não envia nenhum webhook para isso
Permissão Acesso a dados sobre empresas e localização (B2B)
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação desse fluxo de trabalho fica na página “Gatilhos” do aplicativo.

Use-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 por localização da empresa” envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
companyLocation Objeto A unidade da empresa cujas isenções fiscais foram alteradas
companyLocation.id ID
companyLocation.name Texto
changes Objeto As isenções fiscais adicionadas, removidas ou 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 Isenções fiscais eliminadas nesta 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 unidade da empresa (em branco se não estiver definido).
changes.taxExempt Verdadeiro / falso Se a sede da empresa está totalmente isenta de impostos.
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

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

  1. Escolha “Isenções fiscais por localização da empresa” como fator desencadeador.
  2. Adicionar uma condição: changes.added não está vazio e existe.
  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, localidade, indicador de contato principal.
Incêndios causados por Shopify webhook
Permissão Acesso a dados de empresas e localizações (B2B) + Acesso a dados de clientes
Ligado Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação fica na página “Gatilhos” do aplicativo

Use-o para

  • Informe ao gerente de contas quando houver uma mudança no principal contato de uma empresa.

O que a ação “Contato da empresa atualizado” envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
customer Cliente (Shopify) O cliente cujos dados de contato da empresa foram atualizados. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações de cliente próprias do 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 ver exatamente o que foi enviado.

Exemplo: Notificar sobre um novo contato principal

  1. Selecione “Contato da empresa atualizado” como o gatilho.
  2. Adicionar uma condição: companyContact.isMainContact é 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 Flow que o utilize aciona esse recurso. O botão de ativação fica na página “Gatilhos” do aplicativo

Use-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 a função “Cliente removido da empresa” envia para o seu fluxo de trabalho

Variável no fluxo 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 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 ver 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 do site {{company.name}}.
  4. Ative o fluxo de trabalho.

Próximos passos

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