O que é o Shopify
A Shopify é uma plataforma de loja rápida de subir e simples de operar, o que a torna comum em marcas próprias e operações em crescimento. O catálogo, o checkout e o app store resolvem bem a vitrine.
No Brasil, o ponto de atenção é o que ela deliberadamente não faz: emissão fiscal e as particularidades tributárias. Isso vive fora da plataforma, e é aí que a integração passa a ser obrigatória e não opcional.
O que a API entrega
API bem documentada, com REST e GraphQL, cobrindo produto, variante, pedido, cliente, estoque por local e fulfillment. A versão da API é datada e evolui em ciclos, o que exige acompanhar depreciação.
Webhooks cobrem os eventos principais de pedido e produto, com reenvio em caso de falha — idempotência é requisito, não refinamento.
Estoque é por local, o que combina bem com operação multi-depósito, desde que a integração respeite o local em vez de somar tudo.
Fluxos que construímos
Pedido para o ERP com fiscal
Pedido pago entra no ERP, a nota é emitida por lá e chave e link voltam para a Shopify, ficando visíveis ao cliente no pedido.
Estoque por local
Saldo publicado por local de estoque, respeitando a operação multi-depósito em vez de um número agregado.
Fulfillment e rastreio
Envio e código de rastreio devolvidos à plataforma para o cliente acompanhar sem abrir chamado.
Cliente e endereço
Cadastro com documento tratado como chave, que é o campo que a plataforma não exige e a operação brasileira precisa.
O que costuma quebrar
Documento do cliente ausente
CPF ou CNPJ não é campo nativo do checkout. Sem captura explícita, a nota não sai — e o problema aparece depois do pagamento, com o cliente esperando.
Versão de API depreciada
A plataforma evolui em ciclos datados. Integração sem acompanhamento para de funcionar em uma virada de versão, quase sempre sem aviso interno.
Estoque somado entre locais
Ignorar o local de estoque produz venda que sai do depósito errado, com frete acima do previsto.
Webhook duplicado
Reenvio é normal. Sem chave de idempotência, o mesmo pedido entra duas vezes no ERP.
Prazo típico
- 2 a 5
- semanas para pedido, estoque e fiscal
- +1
- semana para fulfillment e rastreio
- por ciclo
- revisão quando a API muda de versão
Perguntas frequentes
A Shopify emite nota fiscal no Brasil?
Não nativamente. A emissão acontece no ERP ou em um emissor especializado, e a integração devolve chave e link para a plataforma. Esse é o primeiro ponto a resolver em qualquer operação brasileira na Shopify.
Como capturar CPF ou CNPJ no checkout?
Por campo adicional no checkout ou por app, com validação. O importante é capturar antes do pagamento: pedir depois significa cliente pago sem nota e atendimento para resolver.
App da loja de aplicativos resolve?
Para operação simples, muitas vezes sim, e é mais barato. Desenvolvimento se justifica quando há regra fiscal específica, multi-depósito, tabela de preço por canal ou um ERP que nenhum app cobre.
Como acompanhar mudança de versão da API?
Faz parte da sustentação: monitorar aviso de depreciação e testar contra a versão nova antes da virada. Integração sem esse acompanhamento tem prazo de validade.