RiokobyKapta
Guia de configuração · Novembro 2026
/ Guias · Moloni ON

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.

01O que precisa

Uma empresa no Moloni ON, com acesso à Subscrição e às Configurações.

02Tempo

Cerca de 10 minutos, se o subutilizador da AT já existir.

03Custo no Moloni ON

O módulo Cliente API: 1,80 € + IVA por mês, no simulador do Moloni ON a 18/11/2026.

ANTES DE COMEÇAR

O que precisa de ter

Confirme estes pontos antes de abrir o assistente do Rioko.

Moloni ON não é o Moloni

São dois programas diferentes, com contas e ligações próprias. Se fatura no Moloni, veja o guia do Moloni.

Uma fatura por pagamento

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.

01

Ativar o módulo Cliente API

Faz-se uma vez por empresa.

  1. 1No Moloni ON, abra Configurações e escolha Subscrição.
  2. 2Em Módulos ativos, veja se o Cliente API já aparece no grupo Ferramentas. Se aparecer, passe ao passo 2.
  3. 3Se não aparecer, carregue em Gerir módulos.
  4. 4No grupo Ferramentas, ligue Cliente API.
  5. 5Confirme a alteração da subscrição, no resumo à direita.
O módulo Cliente API ligado, no grupo Ferramentas da subscrição do Moloni ON.
Vídeo: do painel do Moloni ON ao módulo Cliente API, com legendas (sem som).
Não precisa de criar um Cliente API

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.

02

Ligar o Moloni ON à AT

Em Fiscal, Ligação webservice.

  1. 1Crie no Portal das Finanças um subutilizador com o perfil WSE.
  2. 2No Moloni ON, abra Fiscal, Ligação webservice, ligue a comunicação e indique o subutilizador e a senha.
  3. 3O passo a passo está em Ligar o Moloni ON à AT.
03

Criar a série com os códigos AT

Em Configurações, Documentos, Séries de documentos.

  1. 1Crie a série e, em Configurações do tipo de documento, acrescente Fatura, Fatura-Recibo, Nota de Crédito e Recibo.
  2. 2Em cada tipo, indique a data de início e o código de validação da AT.
  3. 3O passo a passo está em Séries no Moloni ON.
04

Autorizar o Moloni ON no Rioko

Em rioko.online, com a sua sessão iniciada.

  1. 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.
  2. 2O passo 1 liga a plataforma de pagamento.
  3. 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.
  4. 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.
A palavra-passe fica no Moloni ON

Entra na própria página do Moloni ON. O Rioko não vê nem guarda a sua palavra-passe.

05

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.
Recomendação

Deixe o "Auto Finalizar" desligado nos primeiros pagamentos, para confirmar no Moloni ON que está tudo certo, e ligue-o depois.

06

Ativar e testar

Confirme o primeiro documento antes de deixar a faturação seguir sozinha.

  1. 1Na mesma página, ative a subscrição da integração (mensal ou anual).
  2. 2No passo 4, carregue em Marcar como Ativo.
  3. 3Faça um pagamento de valor baixo na sua plataforma.
  4. 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.
O Moloni ON não tem modo de testes

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

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.

CONTINUAR

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
RiokobyKapta