Vero
DevelopersDashboard
Fluxo de Trabalho

Guia de Facturação

Aprenda como implementar o fluxo completo de facturação, desde o registo do cliente até à emissão do documento final certificado pela AGT.

1. Registar o Cliente

Antes de emitir qualquer factura, deve garantir que o cliente existe no Vero. O NIF (Número de Identificação Fiscal) é obrigatório para facturas acima do valor legal ou se o cliente solicitar.

TypeScript
const customer = await Vero.customers.create(orgId, {
  name: 'Empresa de Exemplo, Lda',
  taxId: '5000123456',
  email: 'financeiro@exemplo.ao',
  phone: '923456789',
  addressLine1: 'Rua da Missão, 123',
  city: 'Luanda'
})

2. Definir os Itens (Produtos)

Pode utilizar itens do seu catálogo pré-registado ou enviar itens ad-hoc. Lembre-se que em Angola os preços devem ser comunicados com clareza sobre o IVA.

TypeScript
const items = [
  {
    description: 'Consultoria Técnica',
    quantity: 1,
    unitPrice: 500000, // 5.000,00 AOA (em cêntimos)
    taxRate: 14 // IVA Normal (14%)
  }
]

3. Escolher o Tipo de Documento

FT (Factura)

Utilizada para vendas a crédito. O cliente tem um prazo para pagar.

FR (Factura/Recibo)

Utilizada para vendas a pronto pagamento. Liquida a factura no momento.

TypeScript
const invoice = await Vero.invoices.create(orgId, {
  customerId: customer.id,
  items: items,
  documentType: 'FR' // Emissão imediata com quitação
})

Opcional: Retenção na fonte

Se a tua organização estiver sujeita ao Art. 67º do Código do Imposto Industrial (activável em Definições → Perfil → Retenção na fonte - desligado por omissão, a maioria não precisa), marca as linhas sujeitas com withholdingTax: true, como a caixa "Retenção" de cada linha no painel. Na mesma factura, um serviço pode ter retenção e um produto não. A base é a soma das linhas marcadas (sem IVA); abaixo do limiar mínimo não há retenção. Não altera o total cobrado - só acrescenta o campo withholdingTax na resposta e na factura AGT. Ver Invoices API.

TypeScript
await vero.invoices.create(orgId, {
  customerId,
  items: [
    { description: 'Consultoria', quantity: 1, unitPrice: 50000000, taxRate: 14, withholdingTax: true },
    { description: 'Licença', quantity: 1, unitPrice: 10000000, taxRate: 14 }, // sem retenção
  ],
})
// invoice.withholdingTax -> { type: 'II', rate: 650, base: 50000000, amount: 3250000, ... }

Entrega Automática

Uma vez emitida, a factura é assinada digitalmente e o Vero gera um PDF legal com o código de barras AGT. Pode descarregar o PDF ou enviar por email directamente.

Download PDF →Configurar Webhooks →