Guia do utilizador

Um guia breve para utilizar a Billero.

Início rápido

• Preencha Os meus dados (IBAN, morada, número de identificação fiscal …).
• Adicione clientes (empresas ou particulares).
• Crie uma nova fatura (simples ou com vários itens).
• Pode partilhar ou guardar o PDF. Editar uma fatura volta a gerar o PDF.

Fatura com vários itens

• Cada item tem uma descrição, quantidade, unidade, preço e taxa de IVA.
• Em ecrãs mais pequenos, os campos distribuem-se automaticamente por duas linhas para melhor legibilidade.

Enviar faturas a um cliente

A partir da ficha de detalhe de um cliente, pode selecionar e enviar rapidamente várias faturas de uma só vez.

• Abra o separador Clientes e toque num cliente.
• Mantenha premida uma fatura → entra no modo de seleção.
• Toque em faturas adicionais para as selecionar ou desselecionar.
• Na barra de título, toque em ↗ para partilhar os PDFs selecionados.
• Para sair do modo de seleção, toque em ✕ na barra de título.

Funciona da mesma forma para empresas e particulares (incluindo o cliente Desconhecido).

Faturas recebidas com OCR por IA

A Billero pode ler automaticamente o fornecedor, número, data e valor de uma fatura em PDF utilizando IA (Anthropic Claude). A funcionalidade é opcional e requer a sua própria chave de API.

Obter uma chave de API

1. Aceda a console.anthropic.com e crie uma conta gratuita.
2. No menu, selecione API Keys → Create Key.
3. Dê um nome à chave (por exemplo, Billero) e copie-a. A chave começa por sk-ant-.
4. Tem de adicionar um método de pagamento na consola da Anthropic. Ler uma fatura custa menos de €0,001 (modelo Claude Haiku).

Configuração na aplicação

1. Abra Os meus dados (separador ⚙) → secção Chave de API da Anthropic (OCR).
2. Cole a chave no campo e toque em Guardar.
3. A chave é armazenada na área segura do seu dispositivo (Android Keystore) — nunca é escrita nos ficheiros da aplicação.

Utilização

1. No separador Faturas, toque no ícone ↑ (importar PDF) e selecione o PDF de uma fatura recebida.
2. Abre-se um formulário. Toque no botão ✨ Analisar com IA.
3. Aguarde um momento — os campos de fornecedor, número, data e valor são preenchidos automaticamente.
4. Reveja e corrija se necessário e, em seguida, toque em Guardar.

Sem uma chave de API, o formulário funciona como antes — preencha todos os campos manualmente. O botão de IA não será apresentado.

Cópia de segurança e restauro

Todos os seus dados (faturas, clientes, definições e PDFs) podem ser exportados e restaurados a partir do separador Os meus dados → secção Cópia de segurança.

Exportar

• Toque em Exportar cópia de segurança.
• A aplicação cria um ficheiro ZIP (billero_backup_YYYY-MM-DD.zip) e abre o menu de partilha.
• Guarde o ficheiro no iCloud, Google Drive, email ou onde preferir.

Restaurar (por exemplo, ao mudar de telemóvel)

• Instale a Billero no novo telemóvel.
• Abra Os meus dados → Restaurar a partir de cópia de segurança.
• Confirme o aviso (os dados existentes serão substituídos).
• Selecione o ficheiro ZIP do seu local de armazenamento.
• Todas as faturas, clientes, definições, PDFs, logótipo e assinatura digital são restaurados.

Aviso: o restauro substitui todos os dados existentes. Recomendamos que exporte uma cópia de segurança dos seus dados atuais antes de restaurar.

Faturas recorrentes

A Billero gera automaticamente faturas regulares (semanais, mensais ou trimestrais) sempre que a aplicação é iniciada.

1. No separador Faturas, toque no ícone ↻ (canto superior direito) → Faturas recorrentes.
2. Toque em + e preencha: nome do modelo, cliente, descrição do serviço, valor (sem IVA), taxa de IVA.
3. Escolha a frequência: semanal, mensal ou trimestral.
4. Para mensal/trimestral, escolha o dia do mês (1–28).
5. No próximo arranque da aplicação na data agendada ou após esta, a fatura é criada automaticamente com o respetivo PDF.

Os modelos podem ser desativados com o interruptor ou editados a qualquer momento. As faturas geradas aparecem na lista principal de faturas.

Pagamentos em criptomoedas

A Billero suporta dois tipos de pagamentos em criptomoedas: códigos QR estáticos na fatura em PDF e um link de pagamento Coingate para aceitar mais de 70 criptomoedas.

Códigos QR na fatura em PDF — criptomoedas suportadas

Defina o(s) endereço(s) da sua carteira em Os meus dados → Pagamento em cripto. O código QR é adicionado automaticamente à página 2 de todas as faturas em PDF.

• EURC — stablecoin Euro da Circle em Ethereum, Base ou Solana. Cotação: 1 EURC = 1 EUR.
• USDC — stablecoin USD da Circle em Ethereum, Base, Polygon ou Solana. Cotação: obtida do BCE através da API Frankfurter no momento da geração do PDF.
• BTC — Bitcoin, formato QR BIP-21. Cotação: obtida do CoinGecko no momento da geração do PDF.
• ETH — Ethereum (nativo), formato QR EIP-681. Cotação: CoinGecko.
• SOL — Solana (nativo), formato Solana Pay. Cotação: CoinGecko.
• Token personalizado — introduza o nome do token e o endereço da carteira; o QR codifica o endereço (valor por acordo).

A cotação e a data/hora da obtenção são impressas por baixo de cada código QR. Sem ligação à internet, o código QR não é apresentado (a cotação tem de estar atualizada).

Em Os meus dados → Apresentar na fatura, pode ativar de forma independente o QR UPN e o QR de cripto. O UPN permanece na página 1, o QR de cripto está na página 2.

Link de pagamento Coingate (BTC, ETH, SOL e mais de 70 moedas)

1. Crie uma conta em coingate.com e obtenha uma chave de API.
2. Em Os meus dados → Coingate, introduza a sua chave de API. Ative o modo Sandbox para testes.
3. No separador Faturas, toque no ícone ₿ junto à fatura.
4. A aplicação cria um link de pagamento — aparecem um código QR e um botão Abrir no navegador.
5. Partilhe o link com o seu cliente. Ele paga com qualquer criptomoeda que escolher.
6. Recebe EUR na sua conta bancária via SEPA (a Coingate trata da conversão).
7. Verifique o estado do pagamento com o botão Verificar estado na aplicação.

A Coingate é regulada na UE (licença EMI, Lituânia) e suporta pagamentos SEPA.

Tailândia — PDF bilingue (tailandês + inglês)

Quando o seu perfil está definido para a Tailândia (TH), a Billero gera automaticamente uma fatura em PDF bilingue: cada rótulo é impresso em escrita tailandesa (em cima) e em inglês (em baixo), lado a lado na mesma página.

• A fonte tailandesa (Noto Sans Thai) está incluída na aplicação — não é necessária qualquer instalação.
• Funciona para clientes locais tailandeses e para clientes internacionais que não leem tailandês.
• Taxa de IVA: 7% (Revenue Code, Secção 77). Limiar de registo: THB 1 800 000/ano.

Singapura — fatura com GST

Quando o seu perfil está definido para Singapura (SG), a Billero aplica automaticamente as regras do GST:

• Taxa de GST: 9% (GST Act, Capítulo 117A).
• Limiar de registo: SGD 1 000 000/ano — abaixo do limiar é impressa uma menção de isenção.
• Moeda: SGD ($). Condições de pagamento: 30 dias.