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

Faturação automática no Moloni.

Para o Rioko emitir faturas no Moloni, a conta precisa do plano Flex ou superior, da ligação à AT, de uma série registada e da API ativa. Este guia reúne os requisitos e mostra como fazer a ligação. Depois, cada pagamento recebido no Shopify, na Stripe, no Lodgify, na Easypay ou na EuPago dá uma fatura, e cada reembolso uma nota de crédito.

01O que precisa

Moloni no plano Flex ou superior, ligado à AT e com uma série registada.

02Tempo

Cerca de 10 minutos, se a ligação à AT e a série já estiverem feitas.

03Preço

7,50 € + IVA por mês ou 75 € + IVA por ano, por integração.

ANTES DE COMEÇAR

O que precisa de ter

Confirme estes pontos antes de abrir o assistente do Rioko.

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

Escolher a integração no Rioko

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

  1. 1Abra Integrações.
  2. 2Em Plataforma de Pagamento / E-commerce, escolha a sua plataforma. Em Plataforma de Faturação, escolha Moloni.
  3. 3Carregue em Configurar Agora.
  4. 4O passo 1 liga a plataforma de pagamento. O botão Ver como se faz de cada passo mostra onde está cada dado.
02

Ativar a API no Moloni

Faz-se uma vez por empresa.

  1. 1No Moloni, abra Configurações e escolha Configuração da API e Plugins.
  2. 2Ative Ativar API.
  3. 3No campo URI de Resposta (Callback), cole este endereço, igual carácter a carácter. É o mesmo para todas as contas, e o assistente do Rioko também o mostra:https://rioko.online/api/integrations/moloni-oauth/callback
  4. 4Carregue em Atualizar.
  5. 5Copie o Developer ID, que o Moloni sugere e pode alterar, e o Client Secret.
Configuração da API no Moloni: Ativar API, Developer ID, URI de Resposta e Client Secret. Os valores estão desfocados.
Vídeo: onde estão o Developer ID e o Client Secret, com legendas (sem som). Os valores são exemplos.
O endereço tem de ser exatamente este

Um carácter a mais, ou uma barra no fim, e o Moloni recusa a autorização. Trate o Client Secret como uma password.

03

Autorizar o Moloni

No passo do Moloni, no assistente do Rioko.

  1. 1Preencha o Developer ID e o Client Secret.
  2. 2Carregue em Autorizar o Moloni.
  3. 3O Moloni pede-lhe que confirme o acesso. Confirme: volta ao Rioko com a ligação feita.
Bom saber

A autorização renova-se sozinha, e o Rioko não guarda a sua password do Moloni.

04

Definições de fatura

Empresa, série, IVA, finalização e isenção.

Empresa e série
Escolha a empresa do Moloni e a série onde os documentos são emitidos.
Tipo de documento
Fatura-recibo quando o pagamento já entrou, Fatura quando fica pendente, ou Fatura + recibo automático, quando a sua plataforma o permite.
IVA Incluído
Ligado, os preços já incluem IVA. Desligado, o IVA é somado ao preço.
Auto Finalizar
Desligado, o documento fica em rascunho no Moloni. Ligado, é emitido logo.
Razão de Isenção
Aplicada quando a fatura tem IVA a 0%.
Recomendação

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

05

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 último passo, 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 e confirme totais, IVA e cliente.
Tudo certo?

Se deixou o Auto Finalizar desligado, ligue-o nas definições. A partir daí, cada pagamento é faturado automaticamente.

PERGUNTAS FREQUENTES

Perguntas frequentes

O plano Base do Moloni serve para ligar ao Rioko?

Não. A API do Moloni está incluída a partir do plano Flex, e o Rioko liga-se pela API.

O Rioko guarda a minha password do Moloni?

Não. A ligação é feita por autorização: o Moloni pede-lhe que confirme o acesso e o Rioko guarda só a autorização, que se renova sozinha.

Onde encontro o Developer ID e o Client Secret?

No Moloni, em Configurações, Configuração da API e Plugins, depois de ativar a API.

Porque é que o Moloni recusa a autorização?

O motivo mais comum é o endereço em URI de Resposta (Callback) não ser exatamente o que o Rioko mostra. Confirme-o carácter a carácter e carregue em Atualizar.

Tenho várias empresas no Moloni. Como escolho a certa?

Depois de autorizar, o Rioko lista as empresas da conta. Nas definições de fatura, escolha a empresa certa.

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