Shopify

A integração com a Shopify permite receber pedidos automaticamente assim que são pagos e devolver o rastreamento ao lojista conforme o pedido é despachado, sai para entrega e é entregue.

Para entender o conceito geral, veja Integração de Pedido.

---

Como funciona

1. Cliente compra na Shopify — o pedido é criado e pago na loja.
2. Shopify envia o pedido — o webhook orders/paid é disparado para a Abbiamo.
3. Abbiamo enriquece e filtra — o sistema consulta a API GraphQL da Shopify, identifica a filial (location) e aplica o filtro de entrega configurado.
4. Abbiamo cria o pedido — se passar no filtro, o pedido é criado na filial correspondente e o pedido na Shopify recebe a tag AbbiamoInvoice:<número>.
5. Atualização na Shopify — quando o pedido muda de status na Abbiamo (despachado, em rota, entregue), a Abbiamo atualiza o fulfillment na Shopify com código e link de rastreamento.

---

Passo 1 — Instalar o app da Abbiamo (OAuth 2.0)

A conexão é feita por OAuth 2.0. A Abbiamo envia ao lojista um link de instalação já com os parâmetros prontos.

1. Abra o link de instalação fornecido pela Abbiamo.
2. Autorize a instalação do app na loja.
3. Ao final, será exibido o Token de Acesso da loja (shpca_...).
4. Copie o token — ele será usado no cadastro da integração.

Ao concluir o OAuth, a Abbiamo configura automaticamente o webhook orders/paid e o carrier service "Cotação Abbiamo Dinamica" (usado no modo de cotação dinâmica — ver Passo 3).

---

Passo 2 — Descobrir o identificador do local (filial)

Você precisa do ID numérico do local para vincular à filial na Abbiamo.

1. No painel Shopify, vá em Configurações → Locais.
2. Clique no local desejado.
3. O número no final da URL é o identificador. Ex.: https://admin.shopify.com/store/nomedaloja/settings/locations/72808693869 → 72808693869.

---

Passo 3 — Escolher o modo de entrega (filtro)

A integração só cria pedidos que batem com o filtro de entrega configurado. Há dois modos.

Modo A — Taxa de frete fixa (SHIPPING_LINE)

Use quando o lojista já tem taxas de frete cadastradas manualmente na Shopify (ex.: "Entrega Padrão", "Local Delivery").

• A integração compara o código (code) da taxa escolhida no checkout com a lista de nomes cadastrados na Abbiamo.
• Só importa o pedido se a taxa bater com um dos nomes configurados.

Para descobrir os nomes: Configurações → Frete e Entrega, localize a zona de frete do local e anote exatamente os nomes das taxas.

Modo B — Cotação dinâmica Abbiamo (QUOTATION_ONLY)

Use quando o frete deve ser cotado em tempo real pela Abbiamo no checkout.

• No checkout, o carrier service "Cotação Abbiamo Dinamica" (criado na instalação) retorna as opções de frete da Abbiamo.
• Cada opção carrega um código no formato ABB:logistic_id:method_id.
• Ao pagar, a integração lê esse código e cria o pedido já com a transportadora e o método corretos.

Garanta que o carrier service da Abbiamo esteja ativo nas zonas de frete do local no checkout.

Retirada (takeout)

Se a loja oferece retirada na loja, defina o comportamento:

---

Passo 4 — Cadastrar a integração na Abbiamo

Cadastre uma integração de pedido por filial em Configurações → Integrações de Pedido, escolhendo o provedor Shopify.

Campos da integração (o que você preenche)

---

Como o dado vem na Abbiamo

Cliente

Endereço de entrega

Itens e valores

• Cada item do pedido vira um item nos volumes da Abbiamo (nome, SKU, quantidade, valor e peso em grams).
• O valor do pedido vem de total_price.

Tipo de pedido

---

Atualização de status na Shopify

Quando o pedido muda de status na Abbiamo, a Shopify é atualizada automaticamente:

---

Ver o nome do motorista no pedido

Conforme o pedido avança (saiu para entrega, foi entregue), a Abbiamo também envia o nome do motorista para o pedido na Shopify. Esse dado fica visível só para o time da loja no painel administrativo — o comprador final nunca vê essa informação, nem na página de rastreio nem em e-mails.

Por padrão a Shopify não mostra esse campo na tela do pedido. Para habilitar a exibição, é preciso criar uma definição de metacampo uma única vez por loja. É rápido e só precisa ser feito uma vez.

Como habilitar (passo a passo)

1. No admin da Shopify, clique em Configurações, no canto inferior esquerdo.

   

2. Na lista de configurações, clique em Metacampos e metaobjetos.

   

3. Clique em Pedidos.

   

4. Clique em Adicionar definição.

   

5. Você vai ver o formulário de criação, com o campo Nome, o Tipo e a opção Acesso à API Storefront (que vem ligada por padrão — atenção nesse ponto no passo 7).

   

6. No campo Nome, digite Nome do motorista (ou outro texto de sua preferência — é só o rótulo exibido na tela). Assim que você digita, a Shopify gera um identificador técnico logo abaixo, algo como custom.nome_do_motorista.

   

7. Clique nesse identificador para editá-lo, apague o conteúdo e digite exatamente:

   abbiamo.driver_name

   

   Em seguida, selecione Texto de linha única no campo Tipo, e desligue a opção Acesso à API Storefront (estava ligada por padrão no passo 5) — isso garante que o nome do motorista não fique acessível pelo site de compra do cliente final.

8. Clique em Salvar, no aviso que aparece no rodapé da tela.

   

Onde aparece depois de configurado

Na página de qualquer pedido despachado pela Abbiamo, dentro da seção Metacampos, o campo com o nome escolhido no passo 3 mostra o motorista responsável pela entrega — atualizado automaticamente conforme o pedido avança.

---

Critérios para importação de pedidos

Um pedido só é importado quando todas as condições abaixo são verdadeiras:

1. O pedido está pago (webhook orders/paid).
2. O pedido tem linha(s) de frete (shipping_lines).
3. Para entregas (não retirada), o pedido tem endereço de entrega.
4. A entrega passa no filtro configurado (SHIPPING_LINE ou QUOTATION_ONLY).

Pedidos que não atendem a esses critérios são ignorados pela integração.

---

Onde acessar

• Configuração da integração: Configurações > Integrações de pedido — o cliente cadastra a integração de pedido Shopify.
• Pedidos recebidos: Operação > Pedidos — filtre pela filial e verifique a origem para identificar pedidos vindos da Shopify.