Saltar para o conteúdo
Logótipo Moloni ON

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.
IN

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.
OUT

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

  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

  • 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.

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.