Ligar o programa de faturação (InvoiceXpress, Moloni ou Vendus)
Liga a loja ao teu programa de faturação certificado pela AT para emitir faturas, faturas simplificadas e notas de crédito automaticamente — ou associa as faturas à mão.
Neste artigo
Em Portugal as faturas têm de sair de um programa de faturação certificado pela AT. A Feitora não substitui esse programa: liga-se a ele. Depois de ligado, a loja emite sozinha a fatura-recibo das encomendas online, a fatura simplificada ou fatura-recibo no ponto de venda e as notas de crédito dos reembolsos — e o cliente recebe o PDF.
Podes ligar um destes três programas: InvoiceXpress, Moloni ou Vendus. Se usas outro, escolhe "Nenhum" e associa o número da fatura à mão em cada encomenda (ver no fim).
Antes de começar
Precisas de uma conta ativa num dos programas, com as séries de documentos comunicadas à AT (o programa trata disso).
Só o proprietário da loja altera estas definições.
Fala com o teu contabilista certificado sobre as séries a usar (loja online, ponto de venda, notas de crédito) e os motivos de isenção.
Onde encontrar as credenciais
| Programa | O que precisas | Onde está |
|---|---|---|
| InvoiceXpress | Nome da conta e Chave API | InvoiceXpress → Conta → Integrações → API. O nome da conta é o que aparece antes de .app.invoicexpress.com. |
| Moloni | Developer ID, Client Secret, Utilizador (email) e Palavra-passe | Moloni → Configurações → Developers. Depois de testar a ligação escolhes a Empresa. |
| Vendus | Chave API | Vendus → Apps → API (a chave de um utilizador ativo). A série é a caixa (register) onde os documentos são emitidos. |
Ligar o programa
- Passo 1:
No painel, abre Definições → Faturação.
- Passo 2:
Em Programa, escolhe InvoiceXpress, Moloni ou Vendus.
- Passo 3:
Preenche as credenciais. As chaves e palavras-passe ficam guardadas de forma cifrada e nunca voltam a aparecer completas.
- Passo 4:
Carrega em Testar ligação. A mensagem ao lado diz se a ligação funcionou; no Moloni e no Vendus a lista de empresas e séries passa a aparecer para escolheres.
- Passo 5:
Em Séries e emissão, escolhe a série da Loja online, do Ponto de venda e das Notas de crédito (vê Emissão automática de faturas).
- Passo 6:
Carrega em Guardar no fim da página.
O modo de testes da faturação
Logo a seguir ao Testar ligação está o interruptor Modo de testes, ligado por omissão:
Sem credenciais, ou com InvoiceXpress/Moloni em modo de testes, os documentos são simulados na Feitora, com numeração, ATCUD e código QR de teste, e ficam marcados SEM VALIDADE FISCAL. O canto do cartão mostra "Simulação local (teste)".
Com o Vendus, o modo de testes cria os documentos no modo de formação do próprio Vendus (também sem validade fiscal).
Com o modo de testes ligado aparece Simular programa indisponível, para veres como funciona a fila de emissão quando o programa falha.
Quando estiver tudo validado, desliga Modo de testes e guarda. O canto do cartão passa a dizer Documentos reais.
Sem programa: associar a fatura à mão
Se emites as faturas noutro programa, deixa Programa em Nenhum (associo as faturas à mão). Em cada encomenda paga, no cartão Fatura, carrega em Associar número e indica o número da fatura (e, se quiseres, o link do PDF). O número fica guardado na encomenda e aparece ao cliente.
Problemas frequentes
| Problema | O que fazer |
|---|---|
| "Testar ligação" dá erro de autenticação | Confirma o nome da conta (InvoiceXpress), o utilizador e a palavra-passe (Moloni) ou se a chave API pertence a um utilizador ativo (Vendus). |
| As faturas saem "sem validade fiscal" | O Modo de testes continua ligado, ou faltam credenciais. Desliga-o e guarda. |
| No InvoiceXpress dá erro de imposto | Os nomes das taxas de IVA têm de existir na tua conta. Vê IVA e isenções. |