Saltar para o conteúdo

Comércio

Integração Shopify

Liga a loja Shopify à faturação certificada portuguesa, às transportadoras e ao stock, a partir dos webhooks de encomendas.

Visão geral

Shopify

O Shopify é a escolha de muitas marcas portuguesas que vendem para vários países. Trata bem do checkout e dos pagamentos, mas não emite faturas certificadas pela AT, e as apps de faturação da loja nem sempre se dão bem com séries, NIF e notas de crédito.

A Tejobit cria uma app personalizada para a loja, com acesso apenas ao que é preciso, e liga os webhooks do Shopify ao resto do negócio. Uma encomenda paga gera a fatura no programa certificado; um reembolso gera a nota de crédito; um fulfillment criado devolve o seguimento ao cliente.

A ligação usa a Admin API em GraphQL, que é a versão que o Shopify mantém para novas integrações, e respeita os limites de custo por pedido.

Casos de uso

Para que serve

  • Marca de calçado português que vende para a Europa e fatura cada encomenda no InvoiceXpress
  • Loja de decoração que cria etiquetas na Sendcloud e marca a encomenda como expedida
  • Marca com armazém externo que recebe as encomendas pagas numa folha ou por API
  • Loja que trata devoluções com nota de crédito e reposição de stock
IN

O que a ligação escuta

  • orders/paid quando o pagamento é confirmado
  • orders/create para encomendas com pagamento pendente, como transferência
  • refunds/create em reembolsos totais ou parciais
  • fulfillments/create e fulfillments/update
  • inventory_levels/update para alterações de stock
OUT

O que a ligação faz

  • Emitir a fatura no programa certificado, com país, IVA e NIF do cliente
  • Criar notas de crédito a partir dos reembolsos
  • Criar o fulfillment com o número de seguimento
  • Ajustar níveis de stock por localização
  • Adicionar etiquetas ou notas à encomenda para a equipa

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Acesso de administrador à loja para instalar a app personalizada
  • Indicação de onde o cliente coloca o NIF (campo da empresa ou atributo do checkout)
  • Regras de IVA por país, já configuradas no programa de faturação
  • Conta da transportadora ou do armazém, se a expedição fizer parte

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A Admin API tem limites de custo por pedido e por segundo; cargas grandes são feitas em lote
  • Os webhooks podem chegar repetidos, por isso cada encomenda é identificada para não faturar duas vezes
  • Dados pessoais dos clientes exigem permissões específicas na app

Perguntas frequentes

Antes de começar

Porque não uma app de faturação da Shopify App Store?

As apps da loja servem casos comuns. Quando há várias séries, vendas para fora da UE, devoluções parciais ou outro programa de faturação, uma ligação feita à medida trata cada caso sem atalhos.

A app fica visível na loja?

Não. É uma app personalizada instalada só na sua loja, sem nada no tema ou no checkout, e pode ser removida a qualquer momento no painel do Shopify.

Funciona com várias moedas?

Sim. A fatura usa a moeda da encomenda ou a conversão definida, conforme o que o programa de faturação aceitar.

Ativar a integração Shopify?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.