← Guia completo

Faturação certificada

Faturas e faturas-recibo legais emitidas diretamente da venda ou da reparação — via InvoiceXpress, com a conta e a chave da própria loja.

Só para Portugal

O módulo emite documentos através do InvoiceXpress, um serviço de faturação certificado para Portugal, e as taxas de IVA disponíveis na app são as de Portugal continental (IVA23, IVA13, IVA6 e IVA0). Lojas noutros países, incluindo Espanha, ainda não podem usar este módulo para faturação legal.

O que o módulo faz

Com a faturação ativa, cada venda do POS e cada reparação entregue ganham um botão «Emitir documento». A app envia os dados ao InvoiceXpress e o documento fiscal sai numerado e certificado — fatura-recibo quando o cliente tem NIF, fatura simplificada («Consumidor final») quando não tem.

O permalink do documento fica registado na ficha — dá para abrir o PDF oficial do InvoiceXpress a partir da app e entregar ao cliente.

Situação Documento emitido
Cliente com NIF na ficha Fatura-recibo (FR) — documento completo
Cliente sem NIF Fatura simplificada (FS) — «Consumidor final»
Venda no POS Documento com as linhas dos artigos vendidos
Reparação entregue Documento com as reparações e peças da ficha

O que é preciso

  • Uma conta InvoiceXpress da loja (o serviço deles tem o custo próprio — independente do OficinaOS)
  • A chave API da conta — cria-se nas definições do InvoiceXpress
  • A taxa de IVA predefinida da loja — IVA23, IVA13, IVA6 ou IVA0
  • O módulo invoicing ativo na conta OficinaOS Cloud (no beta, ativamos nós)

Configuração — passo a passo (~5 minutos)

1. No InvoiceXpress, entre na conta da loja e gere uma chave API (nas definições de API da conta).

2. No OficinaOS: Definições → separador Cloud → secção «Faturação (InvoiceXpress)» (aparece com a app emparelhada e o módulo ativo).

3. Em «Conta InvoiceXpress» escreva o subdomínio da conta — o que aparece antes de .app.invoicexpress.com.

4. Cole a chave API e escolha a taxa de IVA predefinida (ex.: IVA23).

5. Ligue «Ativar faturação» e guarde.

6. Teste com uma venda ou reparação de valor simbólico e confirme que o documento aparece no InvoiceXpress.

Preços com IVA incluído

Os preços da loja são finais (IVA já incluído). A app calcula o valor líquido de cada linha a partir da taxa configurada e envia-o ao InvoiceXpress — o total do documento bate certo com o que o cliente pagou.

Privacidade — o que sai e o que fica

A chave API fica guardada encriptada (AES-256) no PC da loja e nunca é mostrada novamente — só se substitui. A app fala diretamente com o InvoiceXpress: os documentos e os dados fiscais não passam pela OficinaOS Cloud — a Cloud só confirma que o módulo está ativo.

Emitir um documento é irreversível (é um documento legal numerado) — a app bloqueia dupla emissão da mesma venda ou reparação.

Limites honestos

  • Requer a conta InvoiceXpress da loja — o custo desse serviço é da loja, separado do OficinaOS
  • Só Portugal: o InvoiceXpress e as taxas de IVA disponíveis são portugueses — noutros países o módulo não emite documentos fiscais válidos
  • Documentos emitidos não são apagados pela app — anulações/credit notes fazem-se no InvoiceXpress