Integração bill.pt com Shopify (Faturação Automática)

A app bill.pt para Shopify é gratuita no marketplace do Shopify e permite gerar faturas automáticas para os seus clientes sempre que uma encomenda é criada/paga.

Resumo rápido: Ative o módulo Shopify no bill.pt, copie o Webhook URL e o Token/API, instale a app do Shopify, cole os dados nas definições da app e ative a API.

Passo a passo

  1. Ativar o módulo Shopify no bill.pt
    Aceda a Configurações (canto superior direito).
    No menu lateral direito, clique em Módulos e ative a opção “Módulo Shopify”.
    Ativar Módulo Shopify no bill.pt
    Imagem 1 — Ativar o módulo Shopify nos Módulos.
  2. Configurar NIF e copiar o Webhook
    Defina qual o campo do Shopify que utiliza para guardar o NIF do cliente (por exemplo, nota do cliente, atributo personalizado, etc.).
    Em seguida, copie o URL do Webhook gerado pelo bill.pt para usar no Shopify.
    Definir campo NIF e copiar Webhook no bill.pt
    Imagem 2 — Campo NIF e Webhook no módulo Shopify.
  3. Ativar a chave de API do utilizador
    Visite Configurações > Utilizadores.
    Página de Utilizadores no bill.pt
    Imagem 3 — Lista de utilizadores.
    Escolha Editar no seu utilizador principal e ative a API. Copie a sua Chave da API (Token).
    Ativar chave de API no utilizador do bill.pt
    Ativar e copiar a chave de API.
  4. Instalar a app bill.pt no Shopify
    Aceda à página oficial: bill.pt — Faturação Portugal (Shopify App Store) e clique em Instalar.
    Após instalar, entre nas Definições da app no seu painel Shopify.
    Instalar app bill.pt e abrir definições no Shopify
    Instalação e definições da app no Shopify.
  5. Colar Webhook e Token na app do Shopify
    Nas definições da app no Shopify, cole:
    • Webhook URL (copiado no Passo 2)
    • Token/Chave de API do bill.pt (copiado no Passo 3)
    Garanta que a opção de “Ativar API” está ligada e guarde as alterações.

Como funciona

A partir deste momento, sempre que um novo documento elegível for criado no Shopify (ex.: encomenda paga), a app solicitará ao bill.pt a geração automática da fatura correspondente.

Nota (Beta): Esta aplicação encontra-se em fase beta. Por favor, valide na sua conta do bill.pt a criação do documento após novas vendas, especialmente nas primeiras utilizações.

Dicas

  • Confirme que o NIF do cliente está a ser guardado corretamente no campo escolhido do Shopify.
  • Se alterar o campo de NIF ou rotas de Webhook, atualize também nas definições da app.
  • Em caso de dúvidas, verifique os logs do Shopify e do bill.pt para identificar eventuais falhas de comunicação.
Icon