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

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

1. No painel, abre **Definições → Faturação**.
2. Em **Programa**, escolhe InvoiceXpress, Moloni ou Vendus.
3. Preenche as credenciais. As chaves e palavras-passe ficam guardadas de forma cifrada e nunca voltam a aparecer completas.
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. 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](https://feitora.pt/ajuda/faturacao/emissao-automatica)).
6. Carrega em **Guardar** no fim da página.

*(Captura do painel: 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](https://feitora.pt/ajuda/faturacao/notas-de-credito) quando o programa falha.

Quando estiver tudo validado, desliga **Modo de testes** e guarda. O canto do cartão passa a dizer **Documentos reais**.

> **Importante — Confirma os primeiros documentos no programa**
> Antes de vender a sério, emite uma encomenda de teste de cada tipo — fatura-recibo (FR), fatura simplificada no ponto de venda (FS) e nota de crédito (NC) — e confirma no teu programa o número, o ATCUD, o código QR e o PDF. Valida as séries e as isenções com o teu contabilista certificado.

> **Em testes — Ligações por validar com contas reais**
> As ligações ao InvoiceXpress, Moloni e Vendus seguem a documentação oficial de cada API, mas **ainda não foram validadas com contas reais**. Testa primeiro numa conta de demonstração ou no modo de testes do programa. Em **Definições → Sistema e diagnóstico** podes verificar a ligação a qualquer momento.

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

*(Captura do painel: Sem programa: "Nenhum (associo as faturas à mão)")*

> **Aviso — Notas de crédito à mão**
> Com faturas associadas à mão, a Feitora não emite notas de crédito: quando reembolsas, a cronologia lembra-te de emitir a nota de crédito no teu programa.

## 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](https://feitora.pt/ajuda/faturacao/iva-e-isencoes). |