Saltar para o conteúdo
Faturação

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.

Atualizado a 3 de outubro de 20264 min de leitura
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

ProgramaO que precisasOnde está
InvoiceXpressNome da conta e Chave APIInvoiceXpress → Conta → Integrações → API. O nome da conta é o que aparece antes de .app.invoicexpress.com.
MoloniDeveloper ID, Client Secret, Utilizador (email) e Palavra-passeMoloni → Configurações → Developers. Depois de testar a ligação escolhes a Empresa.
VendusChave APIVendus → Apps → API (a chave de um utilizador ativo). A série é a caixa (register) onde os documentos são emitidos.

Ligar o programa

  1. Passo 1:

    No painel, abre Definições → Faturação.

  2. Passo 2:

    Em Programa, escolhe InvoiceXpress, Moloni ou Vendus.

  3. Passo 3:

    Preenche as credenciais. As chaves e palavras-passe ficam guardadas de forma cifrada e nunca voltam a aparecer completas.

  4. 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.

  5. 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).

  6. Passo 6:

    Carrega em Guardar no fim da página.

InvoiceXpress escolhido: nome da conta, chave API, "Testar ligação" e o modo de testes

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.

Sem programa: "Nenhum (associo as faturas à mão)"

Problemas frequentes

ProblemaO que fazer
"Testar ligação" dá erro de autenticaçãoConfirma 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 impostoOs nomes das taxas de IVA têm de existir na tua conta. Vê IVA e isenções.

Este artigo foi útil?

Artigos relacionados

Não encontras o que procuras?

No painel, o Sidekick responde a perguntas sobre a tua loja. Para tudo o resto, a equipa da Feitora responde em português, em dias úteis.

Escrever à equipa