Faturação automática no Moloni ON.
Para o Rioko emitir faturas no Moloni ON, a empresa precisa do módulo Cliente API, da ligação à AT e de uma série com o código de validação da AT em cada tipo de documento. Este guia reúne o que se faz do lado do Moloni ON.
Uma empresa no Moloni ON, com acesso à Subscrição e às Configurações.
Cerca de 10 minutos, se o subutilizador da AT já existir.
O módulo Cliente API: 1,80 € + IVA por mês, no simulador do Moloni ON a 18/11/2026.
O que precisa de ter
Confirme estes pontos antes de abrir o assistente do Rioko.
- Módulo Cliente APIÉ o módulo que deixa outros programas ligarem-se ao Moloni ON. Ativa-se na subscrição, no passo 1 deste guia.
- Ligação à ATO Moloni ON ligado à Autoridade Tributária com um subutilizador. Veja Ligar o Moloni ON à AT.
- Série com código ATUma série com o código de validação da AT em cada tipo de documento que o Rioko emite. Veja Séries no Moloni ON.
São dois programas diferentes, com contas e ligações próprias. Se fatura no Moloni, veja o guia do Moloni.
Se os mesmos pagamentos já são faturados noutro programa, pelo Rioko ou por outro sistema, desligue essa faturação antes de ativar esta. O mesmo pagamento ficaria com duas faturas.
Ativar o módulo Cliente API
Faz-se uma vez por empresa.
- 1No Moloni ON, abra Configurações e escolha Subscrição.
- 2Em Módulos ativos, veja se o Cliente API já aparece no grupo Ferramentas. Se aparecer, passe ao passo 2.
- 3Se não aparecer, carregue em Gerir módulos.
- 4No grupo Ferramentas, ligue Cliente API.
- 5Confirme a alteração da subscrição, no resumo à direita.
A página Clientes API, em Ferramentas, Developers, é para quem programa a sua própria ligação. O Rioko liga-se com a sua autorização.
Ligar o Moloni ON à AT
Em Fiscal, Ligação webservice.
- 1Crie no Portal das Finanças um subutilizador com o perfil WSE.
- 2No Moloni ON, abra Fiscal, Ligação webservice, ligue a comunicação e indique o subutilizador e a senha.
- 3O passo a passo está em Ligar o Moloni ON à AT.
Criar a série com os códigos AT
Em Configurações, Documentos, Séries de documentos.
- 1Crie a série e, em Configurações do tipo de documento, acrescente Fatura, Fatura-Recibo, Nota de Crédito e Recibo.
- 2Em cada tipo, indique a data de início e o código de validação da AT.
- 3O passo a passo está em Séries no Moloni ON.
- 1Abra Integrações. Em Plataforma de Pagamento / E-commerce, escolha a sua plataforma; em Plataforma de Faturação, escolha Moloni ON. Carregue em Configurar Agora.
- 2O passo 1 liga a plataforma de pagamento.
- 3No passo 2, carregue em Autorizar o Moloni ON, entre no Moloni ON com o utilizador que tem a empresa e confirme. O Moloni ON devolve-o ao Rioko, que mostra Moloni ON autorizado.
- 4Escolha a empresa e a série. Se a série não tiver o código AT de algum tipo de documento, o Rioko diz qual: registe-o no Moloni ON (passo 3) ou escolha outra série.
Entra na própria página do Moloni ON. O Rioko não vê nem guarda a sua palavra-passe.
Definições de fatura
Passo 3 do assistente.
- Tipo de documento
- Fatura-recibo por omissão no Stripe, na Easypay e na EuPago, porque o pagamento chega já recebido; Fatura por omissão no Shopify e no Lodgify.
- IVA incluído
- Ligado, o valor pago já inclui o IVA.
- Auto Finalizar
- Desligado por omissão: o documento fica em rascunho no Moloni ON, para o confirmar e finalizar lá. Ligado, o documento é finalizado logo.
- Enviar a fatura ao comprador
- Ligado, o documento finalizado segue por email para o comprador. Um rascunho nunca é enviado.
- Razão de isenção
- Usada nas linhas com IVA a 0%. Sem ela, uma venda isenta não é faturada.
Deixe o "Auto Finalizar" desligado nos primeiros pagamentos, para confirmar no Moloni ON que está tudo certo, e ligue-o depois.
Ativar e testar
Confirme o primeiro documento antes de deixar a faturação seguir sozinha.
- 1Na mesma página, ative a subscrição da integração (mensal ou anual).
- 2No passo 4, carregue em Marcar como Ativo.
- 3Faça um pagamento de valor baixo na sua plataforma.
- 4No Dashboard, em Últimos documentos, aparece o pagamento e o estado do documento. Abra o documento no Moloni ON e confirme totais, IVA e cliente.
Um pagamento de teste da sua plataforma (por exemplo, no modo de testes do Stripe ou na sandbox da Easypay ou da EuPago) fica sempre em rascunho no Moloni ON. Apague-o lá depois de o ver.
Perguntas frequentes
O Moloni ON é o mesmo que o Moloni?
Não. São dois programas diferentes, com contas e ligações próprias. Este guia é do Moloni ON; o Moloni tem um guia à parte.
Que módulo do Moloni ON é preciso?
O Cliente API, no grupo Ferramentas da subscrição. É o que permite a ligação de outros programas, como o Rioko.
Quanto custa o módulo Cliente API?
No simulador do Moloni ON, a 18/11/2026: 1,80 € por mês, mais IVA. O preço é do Moloni ON e pode mudar.
Tenho de criar um Cliente API em Ferramentas, Developers?
Não. Essa página é para quem programa a sua própria ligação. O Rioko liga-se com a sua autorização.
Guias relacionados
Precisa de ajuda?
Se preferir fazer a configuração connosco, marque uma chamada. Configuramos tudo consigo, em direto.
Marcar uma chamada ↗ calendly.com/pedro-kapta/rioko-support