Faturação
Integração Moloni ON
Encomendas viram documentos no Moloni ON e as alterações de produtos e stock chegam à loja através dos hooks da plataforma.
Visão geral
Moloni ON
O Moloni ON é a plataforma mais recente da Moloni, do grupo Visma: um software de gestão e faturação online, modular, em que os módulos se vão juntando à medida do negócio. Tem registo, conta e API próprios, separados do Moloni clássico.
A API do Moloni ON é GraphQL. Cada tipo de documento tem as suas operações: faturas, faturas-recibo, faturas simplificadas, notas de crédito, recibos, orçamentos, faturas pró-forma e guias de transporte, com criação, PDF e envio por email. A plataforma permite ainda registar hooks, endereços que recebem um aviso quando um produto é criado ou alterado, ou quando o stock muda.
A Tejobit usa as duas direções. Do lado das vendas, a ligação cria cliente e documento quando a encomenda é paga. Do lado do catálogo, escuta os hooks do Moloni ON e atualiza preços e stock na loja ou no marketplace, para o Moloni ON ser a fonte única dos artigos.
Casos de uso
Para que serve
- Loja com espaço físico e site, em que o stock vendido ao balcão no Moloni ON desce também na loja online.
- Distribuidor que emite guia de transporte no Moloni ON quando a encomenda sai do armazém.
- Configurador de produto no site que gera orçamento ou fatura pró-forma automaticamente.
- Empresa que migra do Moloni clássico para o Moloni ON e precisa de refazer as integrações existentes.
- Catálogo com variantes (tamanho, cor) gerido no Moloni ON e publicado em várias lojas.
O que a ligação escuta
- Hook do Moloni ON quando um produto é criado ou alterado.
- Hook do Moloni ON quando o stock de um artigo muda.
- Encomenda paga na loja online ou no marketplace.
- Envio preparado ou expedido no sistema de logística.
O que a ligação faz
- Cria ou atualiza o cliente e emite o documento certo para a venda.
- Gera o PDF do documento e envia-o por email ao cliente.
- Emite guia de transporte com os artigos e as moradas de carga e descarga.
- Atualiza preço e stock na loja quando o Moloni ON avisa de uma alteração.
- Regista entradas e saídas manuais de stock vindas de outro sistema.
Como funciona
Do pedido à ligação em funcionamento
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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
- Conta Moloni ON com os módulos de faturação e stock que a ligação vai usar.
- Credenciais de acesso à API do Moloni ON para a empresa a integrar.
- Referências de artigo iguais nos dois sistemas, ou uma tabela de correspondência.
- Armazéns e séries de documentos já configurados no Moloni ON.
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 API do Moloni ON é diferente da do Moloni clássico: integrações feitas para um não funcionam no outro.
- Os hooks cobrem alterações de produtos e de stock; para acompanhar documentos emitidos no Moloni ON, a ligação faz consultas periódicas.
- As sessões da API expiram e têm de ser renovadas; a ligação guarda e renova os tokens, mas uma autorização revogada obriga a novo acesso.
Perguntas frequentes
Antes de começar
Qual é a diferença entre Moloni e Moloni ON?
São plataformas distintas da mesma empresa, com contas e APIs diferentes. O Moloni ON é modular e mais recente. A integração é feita para a plataforma que a empresa usa, não para as duas ao mesmo tempo.
Já existe app do Moloni ON para Shopify e plugin para WooCommerce. Quando faz sentido uma integração à medida?
Quando há mais do que uma loja, vendas fora dessas plataformas, regras de documento próprias ou sistemas como reservas e CRM que precisam de falar com o Moloni ON.
Quem comunica os documentos à AT?
O Moloni ON, como programa de faturação certificado. A ligação só lhe entrega os dados da venda; não emite nem assina documentos.
Integrações relacionadas
Ver todas as integrações- Faturação
Moloni
Cada venda paga noutro sistema passa a fatura no Moloni, na série certa e com o cliente identificado pelo NIF.
Desde 5 € /mês + IVA
Ver integração - Comércio
WooCommerce
Liga a loja WooCommerce à faturação, aos pagamentos portugueses e às transportadoras, por webhooks e REST API.
Desde 5 € /mês + IVA
Ver integração - Comércio
Shopify
Liga a loja Shopify à faturação certificada portuguesa, às transportadoras e ao stock, a partir dos webhooks de encomendas.
Desde 5 € /mês + IVA
Ver integração
Ativar a integração Moloni ON?
Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.