Saltar para o conteúdo
Tejobit
Logótipo Moloni

Faturação

Integração Moloni

Cada venda paga noutro sistema passa a fatura no Moloni, na série certa e com o cliente identificado pelo NIF.

Pedir esta integração Ver todas as integrações

Visão geral

Moloni

O Moloni é um dos programas de faturação online mais usados por pequenas empresas, lojas e prestadores de serviços em Portugal. É software certificado: é o Moloni que emite os documentos, atribui a numeração e trata da comunicação à AT, de acordo com as opções da conta.

A Tejobit liga o Moloni ao sistema onde a venda acontece, seja uma loja online, uma plataforma de reservas ou um gateway de pagamento. Quando o pagamento é confirmado, a ligação procura o cliente pelo NIF (ou cria-o), associa os artigos com a taxa de IVA certa e insere o documento através da API do Moloni, autenticada por OAuth.

A regra de fecho fica definida no arranque. O documento pode entrar em rascunho, para alguém o rever, ou ser fechado logo. Um documento fechado já não pode ser alterado nem apagado, por isso qualquer correção segue o caminho legal, com nota de crédito.

Casos de uso

Para que serve

  • Loja online que emite fatura-recibo assim que a encomenda é paga, sem copiar dados à mão.
  • Alojamento local que fatura cada estadia no dia do check-out, com a taxa de IVA aplicável ao alojamento.
  • Ginásio ou estúdio que fatura as mensalidades cobradas por cartão ou débito direto.
  • Empresa de serviços que transforma propostas aceites no CRM em faturas com data de vencimento.
  • Faturas com referência Multibanco gerada pelo próprio Moloni, para clientes que preferem pagar no homebanking.
IN

O que a ligação escuta

  • Encomenda marcada como paga na loja online.
  • Pagamento confirmado por callback do gateway (Multibanco, MB WAY ou cartão).
  • Reserva concluída ou check-out registado na plataforma de reservas.
  • Verificação agendada que procura vendas ainda sem documento, para recuperar falhas pontuais.
OUT

O que a ligação faz

  • Procura o cliente pelo NIF e cria-o se não existir, com morada e email.
  • Cria ou associa artigos e serviços, com a taxa de IVA ou o motivo de isenção correto.
  • Insere fatura, fatura-recibo ou fatura simplificada na série escolhida, em rascunho ou fechada.
  • Envia o PDF ao cliente e guarda o número do documento no sistema de origem.
  • Emite nota de crédito quando há devolução ou reembolso.

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 num plano que inclua acesso à API.
  • Séries de documentos criadas no Moloni para cada tipo de venda a faturar.
  • Lista das taxas de IVA e dos motivos de isenção usados nos produtos ou serviços.
  • Decisão sobre o momento em que o documento fecha: no pagamento, no envio ou depois de revisão.

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

  • O acesso à API depende do plano Moloni contratado; nem todos os planos o incluem.
  • Documentos fechados não podem ser editados nem apagados; corrigir obriga a emitir nota de crédito.
  • A ligação não depende de avisos enviados pelo Moloni: quando precisa de ler dados de lá, faz consultas periódicas.
  • A integração não substitui o Moloni: numeração, assinatura e comunicação à AT continuam a ser feitas por ele.

Perguntas frequentes

Antes de começar

A integração comunica as faturas à AT?

Não diretamente. O Moloni, como programa certificado, comunica os documentos à AT conforme as opções da conta. A ligação limita-se a entregar ao Moloni os dados de cada venda.

E se o cliente não indicar NIF?

O documento sai para consumidor final. No arranque fica definida a regra, por exemplo usar fatura simplificada para vendas a particulares dentro dos limites legais.

Posso rever as faturas antes de serem emitidas?

Sim. A ligação pode deixar os documentos em rascunho para alguém os fechar no Moloni. Com volumes altos, o habitual é fechar logo e tratar as exceções com nota de crédito.

Já uso o plugin do Moloni para WooCommerce. Preciso disto?

Se o plugin cobre o caso, não. A integração faz sentido quando a venda vem de um sistema sem plugin, como reservas, CRM ou gateways, ou quando há regras próprias de séries e IVA.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Moloni?

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

Fale sobre o projeto geral@tejobit.com