Pular para o conteúdo principal

Shopify

Disponível

Esta integração está ativa e pronta para usar em todos os planos Pro.

Conecte sua loja Shopify ao Frihet. Os pedidos são importados automaticamente e geram faturas.

Para que serve?​

Com Shopify integrado:

  • Importar pedidos — Importa pedidos do Shopify como faturas no Frihet (prefíxo SHOP-)
  • Importar produtos — Traz seu catálogo do Shopify para o Frihet
  • Deduplicação automática — Os pedidos já importados não são duplicados
  • Dados do cliente — E-mail, endereço e telefone são sincronizados automaticamente
  • Pagamentos automáticos — Se o Shopify processou o pagamento, o Frihet marca a fatura como paga

Requisitos​

  • Loja Shopify ativa — Com produtos listados
  • Acesso de administrador — Para autorizar o app
  • Frihet Pro ou superior

Conectar Shopify​

Passo 1: Abra o Frihet​

  1. Vá para Configurações → Integrações
  2. Procure por Shopify
  3. Clique em Conectar

Passo 2: Autorize no Shopify​

  1. Insira o nome da sua loja (ex: minhaloja ou minhaloja.myshopify.com)
  2. Clique em Conectar ao Shopify
  3. Você será redirecionado para a página de autorização do Shopify
  4. Faça login com sua conta Shopify se ainda não o fez
  5. Você verá as permissões que o Frihet precisa:
    • Ler pedidos
    • Ler clientes
    • Ler produtos
  6. Clique em Instalar app
  7. Você retornará automaticamente ao Frihet com a conexão ativada

Passo 3: Configure a sincronização​

No Frihet, após autorizar:

  1. Escolha o que sincronizar:

    • ✅ Novos pedidos — Automático
    • ✅ Criar faturas automáticas — Automático
    • ⚪ Sincronizar clientes — Opcional
    • ⚪ Sincronizar produtos — Opcional
    • ⚪ Atualizar inventário — Opcional

  2. Salve as alterações

Primeira sincronização​

Pela primeira vez:

  1. O Frihet importa seus últimos 100 pedidos (os mais recentes)
  2. Cria clientes (se não existirem)
  3. Cria faturas para cada pedido
  4. Isso leva 2-5 minutos dependendo da quantidade

Volte para Faturamento → Faturas em 5 minutos e você verá seus pedidos do Shopify como faturas.

Como funciona o sync​

Novo pedido no Shopify​

1. Cliente compra na sua loja Shopify
   ↓
2. Shopify processa o pedido
   ↓
3. Frihet detecta o novo pedido (a cada 15 minutos)
   ↓
4. Sincroniza com o Frihet automaticamente:
   - Cliente (se for novo, o cria)
   - Produtos
   - Fatura com status "Paga" (se pagou no Shopify)
   ↓
5. Aparece na sua lista do Frihet

Dados sincronizados​

DadoDo Shopify para o Frihet
ID do pedidoNúmero da fatura
ProdutosLinhas da fatura
Preço ShopifyPreço unitário
QuantidadeQuantidade
ClienteNome, e-mail, endereço de envio
Data do pedidoData da fatura
PagamentoMétodo (cartão, PayPal, etc.)
EnvioÉ incluído como linha, se aplicável
ImpostosÉ calculado conforme a jurisdição

Status do pedido​

Shopify → Frihet​

Status ShopifyStatus Frihet
PendentePendente
ConfirmadoPendente
ConcluídoPaga ✅
CanceladoCancelada
DevolvidoParcialmente reembolsado

Exemplo real​

Cliente compra na sua loja Shopify​

Pedido #1009 no Shopify
Cliente: María García
Email: maria@example.com
Endereço: Calle Principal 42, Madrid 28001

Produtos:
- 1x Camiseta azul S = €25,00
- 2x Óculos de sol = €40,00 cada = €80,00

Subtotal: €105,00
Envio: €5,95
Impostos: €23,19 (21%)
Total pago: €134,14

Método de pagamento: Cartão de crédito

No Frihet automaticamente​

Fatura #1009
Data: 10 fev 2025
Cliente: María García

Linhas:
- 1x Camiseta azul S = €25,00
- 2x Óculos de sol = €80,00
- Envio = €5,95

Subtotal: €110,95
IVA (21%): €23,29 (se estiver configurado no Frihet)
Total: €134,24

Status: Paga ✅ (Shopify processou pagamento)

Criado automaticamente. Sem fazer nada.

Configurações avançadas​

Mapeamento de produtos​

Por padrão, o Frihet importa produtos como descrição de linha. Você pode:

  1. Vá para Configurações → Shopify
  2. Ativar "Sincronizar catálogo de produtos"
  3. O Frihet cria produtos no seu catálogo
  4. Futuros pedidos usarão esses produtos (com atualização de preço)

Útil se você quiser reutilizar produtos em orçamentos.

Incluir/excluir pedidos específicos​

Você pode dizer ao Frihet:

  • "Não sincronizar pedidos cancelados" — Exclui automaticamente
  • "Apenas sincronizar após 1 de janeiro" — Apenas pedidos recentes
  • "Excluir cliente específico" — Não crie fatura para esse cliente

Configure em Configurações → Integrações → Shopify → Filtros avançados

Impostos e comissões​

O Shopify pode incluir:

  • Taxes (impostos) — São sincronizados como linha separada
  • Taxas de app — Você pode excluí-las da fatura
  • Descontos — São subtraídos em linha separada

No Frihet você pode ajustar o que incluir na fatura final.

Sincronização de clientes​

Se você ativar "Sincronizar clientes":

  • Cada novo cliente no Shopify é importado para o Frihet
  • E-mail, telefone, endereço são sincronizados
  • Se o cliente já existe, suas informações são atualizadas

Útil para ter uma visão unificada dos seus clientes.

Página de produtos​

Com "Sincronizar produtos" ativo:

  1. O Frihet importa seu catálogo do Shopify

  2. Você vê todos os produtos com:

    • Nome
    • Preço
    • SKU
    • Descrição

  3. Você pode usá-los em novas faturas manuais (não apenas pedidos)

Se você alterar o preço no Shopify, ele é atualizado automaticamente.

Teste a integração​

Teste de pedido​

  1. Vá para sua loja Shopify
  2. Faça um pedido de teste (como cliente)
  3. No Frihet, espere até 15 minutos
  4. Vá para Faturamento → Faturas
  5. Você deverá ver a fatura criada

Se não aparecer:

  • Verifique se o Shopify está conectado ✅
  • O pedido no Shopify deve ter o status "Concluído"
  • Recarregue o Frihet (F5)
  • Verifique Configurações → Integrações → Logs do Shopify

Reembolsos e cancelamentos​

Cliente cancela pedido no Shopify​

  1. Você muda o status para "Cancelado" no Shopify
  2. O Frihet detecta isso na próxima sincronização
  3. A fatura é marcada como "Cancelada"

Você processa reembolso no Shopify​

Se você reembolsar parcialmente:

  1. O Shopify registra o reembolso
  2. O Frihet detecta isso
  3. Você pode criar nota de crédito automaticamente no Frihet
  4. Ou criar manualmente, se preferir

Limitações​

  • Shopify → Frihet (sincronização unidirecional)

    • As alterações no Frihet não são sincronizadas com o Shopify
    • Se você editar uma fatura no Frihet, o Shopify não é atualizado

  • Não sincroniza rascunhos de pedido — Apenas pedidos concluídos

  • Sem acesso a faturas do Shopify — Se o Shopify gerou a fatura, o Frihet não consegue vê-la

  • Inventário — Apenas leitura, sem atualização automática

Solução de problemas​

"Não vejo meus pedidos do Shopify"​

  • Espere até 15 minutos para a primeira sincronização
  • Os pedidos devem estar com o status "Concluído" ou "Processando"
  • Recarregue o Frihet (F5 ou Cmd+Shift+R)
  • Verifique se o Shopify está conectado em Configurações

"Faturas duplicadas"​

  • Pode acontecer se você sincronizou duas vezes
  • Exclua as duplicadas de Faturamento (selecione várias e "Excluir")
  • Em seguida, desconecte e reconecte

"Desconectar apaga minhas faturas?"​

Não. As faturas já criadas no Frihet permanecem. Desconectar apenas:

  • Para novas sincronizações
  • Novos pedidos do Shopify não são sincronizados

Para desconectar:

  1. Configurações → Integrações → Shopify
  2. Desconectar
  3. Confirme

"Posso conectar múltiplas lojas Shopify?"​

Atualmente, o Frihet suporta uma loja Shopify por conta. Se você tiver múltiplas:

  • Opção 1: Crie contas Frihet separadas (uma por loja)
  • Opção 2: Entre em contato com o suporte para consultar opções avançadas

Próximos passos​

Anterior: WooCommerce