facturapi
Funcionalidades

Tudo o que a plataforma oferece

Do painel de administração à API — uma solução completa de facturação electrónica conforme com a legislação portuguesa.

Visão geral

Dashboard centralizado

Acompanhe em tempo real o estado da sua actividade de facturação — clientes, chaves API, configurações fiscais e documentos emitidos.

Total de Clientes
Visão global de todos os clientes API registados na plataforma.
Chaves API activas
Contagem de keys live e test em utilização em todos os clientes.
Configurações NIF
Número de empresas (NIFs) configuradas com credenciais AT.
Facturas emitidas
Total acumulado de documentos fiscais em todos os estados.
Multi-cliente

Gestão de clientes e chaves API

Arquitectura multi-tenant que permite gerir múltiplos clientes, cada um com as suas próprias chaves de acesso e configurações fiscais independentes.

Gestão de clientes

  • Criar e listar clientes com nome e email
  • Ver contadores de API keys e NIFs por cliente
  • Acesso rápido ao detalhe de cada cliente
  • Avatar automático com inicial do nome

Chaves API (API Keys)

  • Gerar chaves com label personalizada
  • Dois ambientes: live (produção) e test (sandbox)
  • Public Key + Secret Key — secret exibida apenas uma vez
  • Copiar chaves para clipboard com confirmação visual
  • Revogar chaves individualmente (badge de revogada)
  • Ver data de criação e última utilização

Configuração NIF (empresa)

  • NIF da empresa (9 dígitos, validado)
  • Nome da empresa e tipo de entidade (ENI / Empresa)
  • Regime de IVA: Normal ou Isento
  • Credenciais AT: username, password, número certificado
  • Ambiente AT: Produção ou Sandbox
  • Morada completa: rua, código postal, cidade, país
Séries de faturação

Séries AT — todos os tipos de documento

Crie e gira séries de faturação separadas por tipo, ano e NIF. Registe directamente na Autoridade Tributária a partir da plataforma.

Criar e gerir séries

  • Definir código da série (ex: FT 2026/A)
  • Associar a um NIF específico
  • Definir ano de exercício
  • Controlo de sequência automático (lastSequence)
  • Activar ou desactivar séries
  • Ver contagem de documentos emitidos por série

Tipos de documento suportados

FT
FaturaDocumento fiscal padrão para venda de bens ou serviços.
FR
Fatura-ReciboFatura com comprovativo de pagamento imediato.
FS
Fatura SimplificadaPara transacções de pequeno valor a consumidores finais.
NC
Nota de CréditoDocumento de rectificação — redução de valor facturado.
ND
Nota de DébitoDocumento de rectificação — aumento de valor facturado.

Registo na AT

  • Registar série directamente nos webservices AT
  • Receber código de validação AT (atCode) automaticamente
  • Estado de validação visível na listagem (Pendente / código AT)
  • Suporte a ambiente sandbox para testes
Documentos fiscais

Emissão completa de documentos

Crie, emita, cancele e gera PDFs de documentos fiscais com numeração automática, cálculo de IVA em tempo real e integração com a AT.

Criar documento

  • Seleccionar série (filtra por NIF do cliente)
  • Dados do comprador: NIF, nome, morada completa
  • Múltiplas linhas de produto/serviço
  • Seleccionar produto do catálogo (preenche campos automaticamente)
  • Quantidade com precisão de 3 casas decimais
  • Preço unitário com precisão de 2 casas decimais
  • Notas internas opcionais

Cálculo de IVA em tempo real

  • Subtotal calculado automaticamente por linha
  • IVA agregado por taxa (NOR / INT / RED / ISE)
  • Total final actualizado a cada alteração
  • Suporte a documentos isentos de IVA (ISE)
Códigos IVA:
NOR — NormalINT — IntermédioRED — ReduzidoISE — Isento

Ciclo de vida do documento

  • Rascunho: criado, editável, ainda não fiscal
  • Emitir: torna o documento legal e imutável
  • Cancelar: anula o documento com registo
  • Transições de estado auditadas e irreversíveis
RascunhoEmitidaCancelada

PDF automático

  • Download directo do PDF a partir da listagem
  • Documento formatado com todos os dados legais
  • Inclui ATCUD, QR Code fiscal e hash de controlo
  • Rodapé com número de certificado AT

QR Code fiscal

  • Gerado automaticamente em todos os documentos
  • Conforme Portaria 195/2020
  • Inclui hash de controlo (campo Q)
  • Verificável pelo consumidor final na app AT
Compliance AT

Conformidade total com a Autoridade Tributária

Todos os requisitos legais de facturação electrónica em Portugal implementados e automatizados.

ATCUD — Código Único de Documento

  • Gerado automaticamente para cada documento emitido
  • Sincronização com os webservices AT
  • Acção manual disponível por documento na listagem
  • Formato: CÓDIGO-SÉRIE_Nº conforme legislação
  • Obrigatório para documentos a partir de 2023

Hash chaining RSA

  • Assinatura de cada documento com chave RSA-SHA1
  • Encadeamento de hashes entre documentos consecutivos
  • Campos assinados: data, hora de sistema, número, total, hash anterior
  • hashControl: caracteres [1,11,21,31] do base64 (requisito certificação)
  • Chave privada configurada via variável de ambiente segura

SAF-T(PT) v1.04_01

  • Exportação do ficheiro XML de auditoria fiscal
  • Seleccionar período: anual ou por mês específico
  • Download directo a partir das definições
  • Formato validado v1.04_01 conforme portaria AT
  • Contém: transacções, clientes, produtos, totais de IVA
  • Obrigatório submeter até ao dia 5 do mês seguinte
Catálogo

Gestão de produtos e serviços

Mantenha um catálogo de produtos e serviços reutilizável. Ao criar documentos, basta seleccionar o produto para preencher os campos automaticamente.

Criar produtos

  • Nome e descrição do produto/serviço
  • Preço unitário pré-definido
  • Taxa de IVA por defeito
  • Código IVA associado (NOR/INT/RED/ISE)
  • Unidade de medida: unidade, hora, litro, metro, m², m³
  • Activação/desactivação (soft delete)

Produtos padrão

  • Seed de produtos standard com um clique
  • Incluídos: Consultoria (€20/un, 23% IVA) e Serviço Digital (€20/un, 23% IVA)
  • Editáveis e personalizáveis após criação
  • Ponto de partida rápido para novos clientes

Auto-preenchimento em facturas

  • Ao seleccionar produto numa linha de fatura, preenche automaticamente:
  • → Descrição do produto
  • → Preço unitário
  • → Taxa de IVA
  • → Código IVA
  • Editável após preenchimento automático
REST API

API completa para integração

Todos os recursos acessíveis via REST API autenticada. Integre a facturação directamente no seu sistema em qualquer linguagem.

Autenticação

  • Chave admin via header x-admin-key
  • Ambiente live/test controlado pela API key do cliente
  • Chaves geráveis e revogáveis a qualquer momento
  • Sem expiração automática — controlo total pelo administrador

Endpoints disponíveis

  • Clientes: listar, criar
  • API Keys: listar, gerar, revogar
  • NIF Config: obter, criar/actualizar
  • Séries: listar, criar, registar na AT
  • Facturas: listar, criar, emitir, cancelar, PDF, ATCUD
  • Produtos: listar, criar, eliminar
  • SAF-T: exportar XML (anual ou mensal)

Alguns endpoints

MétodoEndpointDescrição
POST/invoicesCriar factura
POST/invoices/{id}/issueEmitir — torna o documento legal
GET/invoices/{id}/pdfDownload PDF com ATCUD e QR Code
POST/seriesCriar série de documentos
GET/saftExportar SAF-T(PT) v1.04
... e muito mais — gestão de clientes, produtos, séries, recibos, notas de crédito, webhooks e SDKs.