Docs/Faturação

Faturação

Faturas profissionais automáticas com cada levantamento: conformes com a legislação fiscal e multilingue.

Como Funciona

Cada vez que conclui um levantamento, o Fivo gera automaticamente uma fatura profissional em PDF. Sem passos manuais necessários.

O levantamento é concluído (fundos enviados para o seu endereço externo)
A fatura é gerada com um número sequencial (ex.: FIV-2026-0001)
O PDF é carregado para armazenamento seguro na nuvem
É enviado um email de confirmação com o PDF em anexo
A fatura aparece na sua página Painel → Faturas

Conteúdo da Fatura

Cada fatura inclui uma decomposição completa:

Campo	Descrição
Número da fatura	Sequencial: FIV-{year}-{sequence} (ex.: FIV-2026-0001)
Data de emissão	Data em que o levantamento foi concluído
Dados do emissor	Dados da empresa Fivo (nome, morada, NIF)
Dados do destinatário	Os seus dados de faturação (nome da empresa, morada, NIF)
Montante bruto	Montante total levantado antes das taxas
Taxa de gas	Custo de gas da rede para a transação de levantamento
Taxa Fivo	0,5% do montante bruto
Imposto	Montante de IVA/imposto com base no seu país (ver Regras Fiscais abaixo)
Montante líquido	Montante final recebido após todas as deduções
Blockchain	Rede utilizada para o levantamento
Hash da transação	Link da transação on-chain para verificação

Dados de Faturação (Obrigatório)

Antes do seu primeiro levantamento, deve preencher 7 campos de faturação em . Estes são utilizados para gerar as suas faturas.Painel → Definições

Obrigatório antes de levantar

Não é possível levantar fundos até que todos os 7 campos de faturação estejam preenchidos. Configure-os antecipadamente para evitar atrasos.

Campos de faturação

billing_typestringRequired

"business" ou "individual"

billing_company_namestringRequired

Nome da empresa ou nome legal completo

billing_tax_idstringRequired

Identificador fiscal (NIF, número de IVA, CIF, etc.)

billing_address_line1stringRequired

Morada

billing_citystringRequired

Cidade

billing_postal_codestringRequired

Código postal

billing_countrystringRequired

Código do país (ISO 3166-1 alpha-2, ex.: ES, US, DE)

Name	Type	Required	Description
`billing_type`	string	Required	"business" ou "individual"
`billing_company_name`	string	Required	Nome da empresa ou nome legal completo
`billing_tax_id`	string	Required	Identificador fiscal (NIF, número de IVA, CIF, etc.)
`billing_address_line1`	string	Required	Morada
`billing_city`	string	Required	Cidade
`billing_postal_code`	string	Required	Código postal
`billing_country`	string	Required	Código do país (ISO 3166-1 alpha-2, ex.: ES, US, DE)

Regras Fiscais

O imposto é calculado automaticamente com base no seu país de faturação:

Região	Taxa	Detalhes
Espanha (ES)	21% IVA	Aplicado à taxa Fivo. O Fivo está sediado em Espanha.
Países da UE (26)	0% (inversão do sujeito passivo)	Diretiva UE 2006/112/CE, Art. 196. Declara o IVA no seu país.
Resto do mundo	0% (isento)	Isento de IVA europeu.

Países da UE com inversão do sujeito passivo

AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, SE

22 Idiomas

As faturas são geradas no idioma do seu país de faturação. O idioma é selecionado automaticamente. Sem necessidade de configuração.

English

Spanish

French

German

Italian

Portuguese

Dutch

Polish

Czech

Romanian

Hungarian

Croatian

Slovak

Slovenian

Lithuanian

Latvian

Estonian

Swedish

Danish

Norwegian

Finnish

Icelandic

Aceder às Faturas

Existem três formas de aceder às suas faturas:

Email

PDF em anexo ao email de confirmação do levantamento, enviado automaticamente.

Painel

Página : filtre por ano ou estado, descarregue qualquer fatura em PDF.Faturas

API

para listar faturas. para um URL de download pré-assinado (validade de 15 minutos).GET /invoicesGET /invoices/:id/pdf