Como Criar uma Série de Faturação no Moloni
Guia passo a passo para criar uma série no Moloni (Configurações → Séries de Documentos), registá-la na AT e confirmar o ATCUD nos documentos.
O Moloni é um dos softwares certificados de faturação mais usados em Portugal. As séries vivem em Configurações → Séries de Documentos, e há duas coisas que confundem quem vem de outros programas: uma série do Moloni serve todos os tipos de documento, e o registo na AT é feito por tipo de documento, dentro da série.
Este guia mostra como criar uma série no Moloni, registá-la na Autoridade Tributária e confirmar que os documentos saem com ATCUD.
Antes de criares uma série, confirma que tens o subutilizador AT preparado para comunicar séries. Vê ATCUD: Como criar utilizador na Autoridade Tributária.
Passo 1 — Abrir as Séries de Documentos
- Inicia sessão no Moloni.
- No menu superior abre Configurações e, em Séries e templates, clica em Séries de Documentos.
As séries estão em Configurações → Séries de Documentos. Captura: Moloni
- A página lista as séries existentes. Clica em Adicionar para criar uma nova.
Passo 2 — Configurar a série
O separador Geral pede:
| Campo | O que colocar |
|---|---|
| Nome | O identificador da série, sem espaços, só com letras não acentuadas e números (ex.: FR2026) |
| Escolhida por defeito | Marca se esta deve ser a série usada quando não escolhes outra |
| Regime de IVA de Caixa | Só se a empresa está nesse regime |
| Inativo | Deixa desmarcado para a poder usar |
O formulário de nova série. O Nome só aceita letras não acentuadas e números. Captura: Moloni
O separador Número inicial define o número por onde começa cada tipo de documento. Normalmente 1; se migras de outro software a meio do ano, o seguinte ao último emitido. Clica em Inserir para gravar.
Importante: se registares a série à mão no Portal das Finanças, o identificador tem de coincidir exatamente com o Nome que puseste aqui. Uma diferença de letra e a AT não reconhece a série.
Passo 3 — Registar a série na AT
A partir daqui tens duas vias.
Via A — Registo automático pelo Moloni (recomendado)
- Em A. Tributária → Configuração da Ligação preenche o ID Utilizador e a Palavra-Passe do subutilizador AT. O ID é só o número do subutilizador, o
NdeNIF/N, sem o NIF à frente. - Ativa Registo de séries AT e grava.
O subutilizador AT, a senha e a opção Registo de séries AT. Captura: Moloni
- Regista as séries com Registar todas as séries ou Registar séries selecionadas. O Moloni pede o código de validação à AT por webservice e guarda-o na série.
Via B — Registo manual no Portal das Finanças
- No Portal das Finanças, abre Comunicação de Séries Documentais → Registar Série (o caminho completo está em Séries de faturação: o que são e como comunicar à AT).
- Faz um registo por cada tipo de documento que vais emitir, com:
- Série: igual ao Nome da série no Moloni (
FR2026). - Início da sequência: o mesmo número inicial.
- Meio de processamento:
Programa informático de faturação. - Número de certificado:
2860, o do Moloni. Confirma-o no rodapé de um documento já emitido, caso mude.
- Série: igual ao Nome da série no Moloni (
- A AT devolve um código de validação por cada registo.
- No Moloni, edita a série, abre o separador Novo registo AT e cola cada código em Código de validação (AT), na linha do tipo de documento respetivo.
Registo manual: o código de validação entra na linha do tipo de documento. Captura: Moloni
Passo 4 — Verificar emissão certificada
Antes de ligar a integração com Shopify ou Stripe, emite uma fatura de teste e confirma:
- O documento aparece com o identificador
<TIPO> <SÉRIE>/<NÚMERO>. - Contém QR Code.
- Contém a linha ATCUD, com o código de validação seguido do número.
- O PDF menciona o software certificado e o número de certificação.
Se algum destes itens falhar, a série não está registada para esse tipo de documento.
Erros frequentes no Moloni
- Documento sem ATCUD: a série não tem código de validação para aquele tipo de documento. Regista-a (Via A ou B) antes de emitir.
- Nome recusado: acentos e espaços não são aceites. Usa só letras não acentuadas e números.
- Credenciais recusadas na Via A: o ID Utilizador leva só o número do subutilizador, não o
NIF/Ninteiro. - Numeração: um rascunho não consome número. O número só é atribuído quando o documento é fechado.
Como o Rioko ajuda
Na página de integração (Stripe + Moloni ou Shopify + Moloni) escreves o nome exato da série no Moloni, por exemplo FR2026, e o Rioko vai buscar o id sozinho. Em branco, usa a série por defeito da conta. A partir daí as faturas que o Rioko gera a partir de encomendas Shopify ou pagamentos Stripe saem nessa série, e é o Moloni que lhes põe o ATCUD e o QR Code. Se ainda não estás familiarizado com o conceito de série, lê primeiro Séries de faturação: o que são e como comunicar à AT.
Fonte original: www.moloni.pt
Perguntas frequentes
No Moloni chamam-se séries ou conjuntos de documentos?
No ecrã chamam-se Séries de Documentos, em Configurações. A API do Moloni chama-lhes document sets, e há guias antigos que falam em conjuntos. É sempre a mesma coisa: aquilo que a lei chama série.
Uma série do Moloni serve para faturas e notas de crédito?
Serve. Uma série do Moloni abrange todos os tipos de documento. O registo na AT é que é feito por tipo de documento, no separador Novo registo AT.
Qual é o número de certificação do Moloni?
É o 2860. Aparece no rodapé dos documentos emitidos e no site do Moloni.
O Moloni comunica a série à AT sozinho?
Comunica, com o subutilizador AT configurado em A. Tributária → Configuração da Ligação e a opção Registo de séries AT ativa. Em alternativa registas a série no Portal das Finanças e colas o código de validação no separador Novo registo AT.
Como indico a série ao Rioko?
Pelo nome exato da série no Moloni. O Rioko vai buscar o id sozinho, e em branco usa a série por defeito da conta.
Ficaste com dúvidas
Escreve a pergunta. Chega a uma pessoa, não a um formulário.
