Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.raposa.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão Geral

A integração com a Shopify permite que a Raposa receba automaticamente os dados de pedidos, vendas e reembolsos da sua loja. Com isso, você rastreia o ROI real de cada canal de aquisição até a venda final.
A Raposa processa cada line_item do pedido como um produto individual, permitindo uma análise granular de performance por produto.

​
Pré-requisitos

  • Loja ativa na Shopify
  • Acesso de administrador à loja
  • Uma operação criada na Raposa

​
Passo 1 — Ativar a Integração na Raposa

  1. Acesse a Raposa e vá até Configurações → Integrações
  2. Localize o card da Shopify e clique no botão ”+” para abrir o painel de conexão
  3. Clique em “Ativar” para habilitar a integração
  4. A Raposa irá gerar automaticamente uma URL única do webhook:
https://app.raposa.app/api/webhook/shopify/{seu-id-unico}
  1. Clique no botão de copiar ao lado da URL
A URL é gerada automaticamente e é exclusiva da sua operação. Você não precisa preencher nenhum campo adicional — basta copiar a URL e colar na Shopify.

​
Passo 2 — Configurar o Webhook na Shopify

  1. No admin da Shopify, vá em Settings → Notifications
  2. Role até a seção Webhooks e clique em Create webhook
  3. Configure:
    • Event: Order creation (Criação de pedidos)
    • Format: JSON
    • URL: Cole a URL copiada da Raposa
    • API version: Use a versão mais recente disponível
  4. Clique em Save
Repita o processo para adicionar outros eventos importantes:
  • Order payment — Pagamento do pedido
  • Order cancellation — Cancelamento
  • Refund create — Reembolso

​
Passo 3 — Testar a Conexão

  1. Na Shopify, ao lado do webhook criado, clique em “Send test notification”
  2. Na Raposa, verifique se o status do webhook mudou para Ativo e se o Último ping foi atualizado
  3. Para um teste completo, crie um pedido de teste na sua loja Shopify

​
Eventos Suportados

Evento ShopifyDescriçãoO que a Raposa faz
orders/createNovo pedido criadoRegistra a venda e cada produto do pedido
orders/paidPagamento confirmadoAtualiza status para pago, contabiliza receita
orders/cancelledPedido canceladoMarca como cancelado nas métricas
orders/fulfilledPedido enviado/entregueAtualiza status de fulfillment
refunds/createReembolso processadoRegistra reembolso e ajusta métricas

​
Dados Capturados

Para cada pedido, a Raposa extrai:
  • Produtos: Nome, ID, quantidade, preço unitário (de cada line_item)
  • Valor total: Receita do pedido (com desconto aplicado, se houver)
  • Cliente: Identificador para atribuição
  • Status: Criado, pago, cancelado, reembolsado, enviado
  • Data/hora: Timestamp do evento

​
Solução de Problemas

  1. Verifique se o pedido tem line_items — pedidos vazios são ignorados
  2. Confirme que o webhook da Shopify está com formato JSON (não XML)
  3. Verifique se a operação correta está selecionada na Raposa
  1. Verifique se a URL está correta e acessível
  2. A Shopify tenta reenviar webhooks que falharam por até 48h
  3. Se persistir, recrie o webhook na Shopify com a mesma URL
A Raposa possui proteção contra duplicação — o mesmo order_id não é processado duas vezes. Se está vendo duplicatas, verifique se não criou webhooks duplicados na Shopify.
  1. Confirme que clicou em “Ativar” no painel da Shopify dentro da Raposa
  2. Envie uma notificação de teste pela Shopify
  3. Aguarde alguns segundos e recarregue a página