Novo: o Rioko já fatura também no TOConline, além do InvoiceXpress, do Moloni e do Vendusem quatro programas de faturação. Comparar os quatro programas
Todos os artigos
Guias TécnicosPedro Correia, equipa Rioko18 de novembro de 20267 min

Faturar Pagamentos Stripe no Moloni: Como Funciona

Como cada pagamento da Stripe sai como fatura-recibo no Moloni: plano, artigos, IVA, NIF, total, reembolsos e subscrições, com o que confirmar antes de ligar.

Faturar Pagamentos Stripe no Moloni: Como Funciona
Em resumo: A Stripe cobra, mas não emite documentos fiscais portugueses. Para cada pagamento sair como fatura-recibo no Moloni, é preciso ligar as duas contas: o Moloni no plano Flex ou superior, ligado à AT e com uma série registada. A fatura leva o total pago, a data do pagamento e o IVA certo, e cada reembolso dá uma nota de crédito.

A Stripe cobra e o Moloni fatura, mas um não sabe do outro. A Stripe não é software certificado: as invoices e os receipts que envia não têm ATCUD nem série comunicada à AT. Para cada pagamento ter o seu documento fiscal, alguém tem de o passar para o Moloni, à mão ou por uma integração.

Este guia mostra o que é preciso de cada lado e o que muda no Moloni em relação aos outros programas. As regras gerais, que valem para qualquer programa, estão em Faturar pagamentos Stripe em Portugal.

O que cada lado faz

StripeMoloni
CobrarSim: Checkout, Payment Links, subscrições, cobranças pela APINão
Saber quem comprouEmail, nome e, se o pedir no checkout, o NIFA ficha de cliente
Documento fiscal portuguêsNãoSim: fatura, fatura-recibo, nota de crédito
Série e ATCUDNãoSim, depois de a série estar registada
Devolver dinheiroSim: o reembolsoNão: só o documento que o corrige

A fatura é obrigatória por cada transmissão de bens ou prestação de serviços, e também pelos pagamentos recebidos antes da entrega (artigo 29.º, n.º 1, do CIVA). Quando o pagamento chega antes da entrega ou da prestação, a fatura emite-se na data do recebimento (artigo 36.º, n.º 1, alínea c)).

As três formas de ligar

FormaComo funcionaOnde costuma falhar
À mãoExportar os pagamentos da Stripe e emitir cada documento no MoloniPrazo, volume e reembolsos esquecidos
Ferramenta genérica de automaçãoUm gatilho na Stripe cria o documento no MoloniSubscrições, total ao cêntimo, notas de crédito, isenções
Integração dedicadaLê os eventos da Stripe e emite no Moloni com regras fiscaisDepende de a ligação estar bem configurada

À mão funciona com poucos pagamentos por mês. Acima disso, o prazo de emissão e os reembolsos são o que primeiro escapa.

O que é preciso no Moloni

  • Plano Flex ou superior. A API do Moloni está incluída a partir do plano Flex; o plano Base não a inclui (planos do Moloni).
  • Ligação à AT, com um subutilizador. Veja Ligar o Moloni à AT.
  • Uma série registada, para os documentos terem ATCUD. Veja Registar séries no Moloni.
  • A API ativa, em Configurações, Configuração da API e Plugins. O passo a passo está no guia do Moloni.

Do lado da Stripe, a ligação faz-se com o Stripe Connect, só com leitura: o Rioko lê os pagamentos e os dados de cliente necessários para o documento, e não move dinheiro nem faz reembolsos. Veja o guia da Stripe.

O que muda no Moloni

Um artigo em cada linha

O Moloni exige um artigo da sua conta em cada linha do documento. Há três caminhos, e podem conviver:

  • Mapear o produto. Em «Mapear Produtos → Moloni», cada produto da Stripe fica associado a um artigo seu. O artigo mapeado manda na taxa de IVA e no motivo de isenção da linha.
  • Mapear pela descrição. Um Payment Link ou uma cobrança pela API muitas vezes não traz produto. Nesse caso, escolhe-se um pedaço do texto que aparece sempre na descrição e o artigo do Moloni que lhe corresponde.
  • Deixar o Rioko criar. O que não estiver mapeado fica com um artigo criado pelo Rioko no Moloni, com a taxa que o pagamento trouxer.

Mapear é a forma certa de faturar um catálogo com taxas diferentes. Também é a forma mais rápida de pôr a taxa errada em tudo, se o artigo do Moloni estiver mal configurado: confirme a taxa de cada artigo antes de o mapear.

O IVA de cada linha

Por ordem: a taxa do artigo mapeado; a taxa que vem da Stripe, quando a conta calcula o imposto; a taxa por defeito da ligação, quando o pagamento chega sem imposto. Se a Stripe calcula o IVA com o Stripe Tax, o Rioko verifica ao ativar se a conta o cobra e, se cobrar, lê o IVA da Stripe em todos os pagamentos.

A opção IVA Incluído diz se os preços da Stripe já trazem o imposto. E uma linha a 0 % só sai com um motivo de isenção declarado na ligação ou no artigo: sem ele, o Rioko recusa emitir, em vez de inventar um código.

Quem é o cliente

O NIF chega da Stripe quando o pede no checkout, com a recolha do número fiscal ligada, ou quando o guarda no Customer. Com NIF, o Rioko reaproveita a ficha que já existe no Moloni para esse contribuinte. Sem NIF, o documento sai a consumidor final, com o NIF genérico 999999990.

Um NIF errado corrige-se na ficha do cliente. Um documento já finalizado com o NIF errado não se corrige com nota de crédito: anula-se e emite-se outro. O artigo NIF errado ou pedido depois da compra mostra os dois casos.

O total é o valor pago

Descontos, cupões e arredondamentos fazem a soma das linhas divergir do valor cobrado por cêntimos. O Moloni guarda cinco casas decimais nos preços, e o Rioko acerta o preço unitário para o total bater com o que a pessoa pagou, sem inventar um desconto que ninguém deu.

A data do documento

A do pagamento. Se a série já tiver um documento finalizado com data posterior, o Moloni recusa a data anterior: o documento sai com uma data que a série aceite, e a data do pagamento fica nas observações.

Moeda estrangeira

A fatura sai em euros, à última taxa do BCE publicada no momento do pagamento, com o valor recebido, a moeda e a taxa indicados. O câmbio com que a Stripe converte o que deposita é outro, e é normal não bater ao cêntimo. Mais em Faturar em moeda estrangeira.

Subscrições

Cada fatura da Stripe paga dá um documento no Moloni, com a data do pagamento. Períodos experimentais e faturas a zero não são faturados.

Reembolsos

Cada reembolso, mesmo parcial, dá uma nota de crédito no Moloni, ligada à fatura que corrige, desde que a fatura esteja finalizada. A lei exige que o documento retificativo identifique a fatura a que se refere (artigo 36.º, n.º 6, do CIVA). Se a fatura ainda estiver em rascunho, o Rioko avisa em vez de emitir a nota: um rascunho corrige-se ou apaga-se.

Rascunho ou finalizado

Com o Auto Finalizar desligado, os documentos ficam em rascunho no Moloni até alguém os finalizar. Ligado, saem logo. O email ao comprador sai quando o documento é finalizado, se a opção estiver ligada. O prazo legal de emissão conta da mesma forma: em regra, até ao 5.º dia útil seguinte ao momento em que o imposto é devido (artigo 36.º, n.º 1, alínea a)).

Antes de ligar

  1. Desligue outra faturação dos mesmos pagamentos, se existir. O mesmo pagamento ficaria com duas faturas.
  2. Confirme a série onde os documentos vão sair, e que está registada.
  3. Mapeie os produtos com taxas diferentes de 23 %, ou que sejam isentos.
  4. Declare a taxa por defeito e o motivo de isenção, se vende sem IVA a algum tipo de cliente.
  5. Comece com o Auto Finalizar desligado e confira os primeiros documentos com o contabilista: NIF, taxa, isenção, série e total.

A verificação das faturas cabe sempre ao comerciante e ao seu contabilista, antes e depois de automatizar.

Como o Rioko liga a Stripe ao Moloni

O Rioko emite no Moloni cada pagamento da Stripe, incluindo Checkout, Payment Links e renovações de subscrições, e cada reembolso como nota de crédito. Custa 7,50 € + IVA por mês ou 75 € + IVA por ano, por integração.

Veja como funciona com a Stripe → · Preços

Se um pagamento ficar sem fatura, veja o que impede uma fatura de sair.

Fontes

#Stripe#Moloni#Faturação#Reembolsos#IVA

Perguntas frequentes

O Moloni fatura sozinho os pagamentos da Stripe?

Não. A Stripe cobra, mas não emite documentos fiscais portugueses, e o Moloni não sabe que o pagamento existiu. É preciso ligar as duas contas, à mão ou com uma integração.

Que plano do Moloni é preciso para ligar a Stripe?

O plano Flex ou superior, porque a API do Moloni só está incluída a partir daí. A conta tem ainda de estar ligada à AT e ter uma série registada.

Que documento sai no Moloni para cada pagamento?

Uma fatura-recibo, porque o pagamento da Stripe já entrou. Se preferir, a ligação pode emitir fatura.

O Moloni pede um artigo em cada linha. Tenho de criar um por produto?

Não. Em «Mapear Produtos → Moloni» pode associar cada produto da Stripe a um artigo seu, ou mapear pelo texto da descrição. O que não estiver mapeado fica com um artigo criado pelo Rioko.

Que taxa de IVA leva cada linha?

A do artigo do Moloni, quando o produto está mapeado. Sem mapeamento, a do pagamento, quando a Stripe calcula o imposto, ou a taxa por defeito da ligação. Uma linha a 0 % só sai com um motivo de isenção declarado.

E se o comprador não indicar NIF?

O documento sai a consumidor final, com o NIF genérico 999999990. Se o comprador indicar o NIF no checkout da Stripe, o Rioko usa-o e reaproveita a ficha que já existe no Moloni.

O que acontece no Moloni quando reembolso na Stripe?

Cada reembolso, mesmo parcial, dá uma nota de crédito ligada à fatura, desde que a fatura esteja finalizada. O caminho completo está em Do reembolso à nota de crédito.

As renovações das subscrições são faturadas?

Sim. Cada fatura da Stripe paga dá um documento no Moloni, com a data do pagamento. Períodos experimentais e faturas a zero não são faturados.

Recebo em dólares. Como sai a fatura no Moloni?

Em euros, à última taxa do BCE publicada no momento do pagamento, com o valor recebido, a moeda e a taxa indicados no documento.

Posso ver os documentos antes de saírem?

Sim. Com o Auto Finalizar desligado, os documentos ficam em rascunho no Moloni até alguém os finalizar. Veja o que muda entre rascunho e finalizado.

Ficou com dúvidas

Escreva a pergunta. Chega a uma pessoa, não a um formulário.