Como integrar o Moloni com a Shopkit

Atualizado em 11 março 2026

Resumo gerado por AI · Guia de integração Moloni com Shopkit para faturação e stock. O Moloni é software de faturação certificado pela AT (n.º 2860). Para configurar, cria conta e recolhe dados pedidos na integração: e-mail e password da conta, contribuinte, série de documentos e Hash (API) em Configurações > Developer > Configuração da API e Plugins > Shopkit. Define portes de IVA e razão de isenção quando aplicável. Escolhe o tipo de documento (Fatura, Fatura/Recibo, Orçamentos, Nota de encomenda) e estado (Fechado ou Rascunho). Sincroniza stock com o Moloni; a atualização automática ocorre após emitir faturas e é gerida em Tabelas > Controlo de stocks. Requer a secção Stock ativa. Produtos inexistentes são criados no Moloni; SKU vem da Shopkit. Garante SKUs únicos por variação para evitar erros. A atualização pode demorar minutos. Opcionalmente ativa envio automático de e-mail, emissão de faturas e guias de transporte (requer documento fechado) em Documentos > Transporte.

O Moloni é um software de faturação online certificado pela Autoridade Tributária e Aduaneira com o número 2860.
É uma ferramenta de gestão que se destaca pela simplicidade e acessibilidade.

Para configurares esta App na tua loja deves primeiro criar uma conta no Moloni.

Depois basta acederes à tua conta no Moloni para obteres os dados que são solicitados na configuração da App na plataforma de gestão da tua loja.

Configuração da app

E-mail da conta Moloni

Insere o e-mail que utilizas na tua conta Moloni.

Password da conta Moloni 

Insere a password correspondente ao e-mail da tua conta Moloni.

Hash 

Corresponde à chave que o Moloni disponibiliza para integrares o software de faturação com a tua loja na Shopkit.

Encontras a chave na área de cliente no software de faturação, em Configurações > Developer > ​​Configuração da API e Plugins > Shopkit.

Contribuinte

Insere o número de contribuinte associado à conta Moloni.

Série de documentos 

A série é o elemento que identifica um determinado conjunto de faturas.

Portes de IVA (%)

Caso apliques a taxa 0 em preços na tua loja, define o campo com o valor 0 e escolhe o motivo de isenção no campo Razão de isenção.

Razão de isenção

Define a razão de isenção que surgirá na fatura quando um produto ou serviço for isento de IVA.

Este campo é de preenchimento obrigatório, pelo que, caso não tenhas isenção, será necessário selecionar uma opção disponíveis. Se não tiveres isenção, deves certificar-te de que os preços de produtos e/ou portes de envio estão configurados sem IVA incluído e que realizas as configurações necessárias de impostos. Podes saber mais sobre como configurar impostos no nosso artigo de suporte

A razão de isenção escolhida será apenas utilizada em encomendas realizadas na loja online que não tenham o IVA discriminado.

Tipo de documento

Define o tipo de documento que é emitido com recurso ao software de faturação: Fatura, Fatura/Recibo, Orçamentos e Nota de encomenda.

Estado do documento

Podes escolher entre dois estados de documento: Fechado ou Rascunho.

Se definires o campo Estado do documento com a opção Rascunho, o documento final terá que ser emitido a partir da área de cliente no Moloni.

Sincronizar stock com o Moloni

Com a opção Sincronizar stock ativada, o stock disponível em cada produto na tua loja Shopkit é atualizado com os valores definidos no Moloni. A atualização ocorre após a emissão de faturas na tua loja Shopkit.

Na área de faturação do software Moloni, podes gerir o stock na secção Tabelas > Controlo de stocks.

Aviso

A sincronização de stock apenas está disponível na integração com o Moloni e só irá ocorrer na ficha de cada produto se a secção Stock estiver ativada e configurada. Consulta o nosso artigo de suporte para saberes mais informações sobre a gestão de stock.

Nota

Se os produtos não estiverem inseridos no Moloni, são criados no software de faturação no momento da emissão de faturas a partir da área de gestão da tua loja Shopkit. Nestes casos, o stock dos produtos irá surgir com os valores definidos na ficha do produto (menu Produtose o SKU será o que está configurado na tua loja na Shopkit. Caso não tenhas SKU configurado, será atribuído um de forma automática na plataforma da Moloni.

Caso os produtos já estejam criados no Moloni, são identificados pelo SKU para serem actualizados
. Para evitar erros de atualização de stock na sincronização, importa garantir que não existem produtos com o mesmo SKU. Caso o produto tenha opções configuradas e a gestão de stock seja feita com valores diferentes, cada combinação deve ter um SKU único atribuído.

A atualização de stock ocorre de forma automática, mas não é imediata. Pode demorar alguns minutos até se verificar a atualização de stock na ficha do produto. 

Se ativares esta opção, recomendamos que a gestão das unidades em stock seja feita diretamente a partir da área de cliente no software de faturação do Moloni.

Outras configurações

Enviar email ao cliente automaticamente

Define se, além do e-mail com a atualização da encomenda, no qual consta a opção para o cliente visualizar a fatura, é enviado um e-mail a partir do software de faturação com a fatura emitida.

Emitir faturas automaticamente 

Define se as faturas vão ser emitidas de forma automática quando a encomenda é marcada como paga.

Emitir guias de transporte automaticamente

Define se, após a emissão da fatura, é também emitida uma guia de transporte. 

A guia de transporte é emitida com os dados que constam na fatura e fica disponível na área do software de faturação, em Documentos > Transporte.

Para conseguires emitir este documento, a fatura tem que ser emitida no estado de documento fechado.

Vídeo de suporte

Segue os passos deste vídeo para veres como é fácil fazer a configuração:

Caso tenhas alguma questão adicional, consulta aqui a página do Moloni dedicada à integração.