Introdução ao Vero
Infraestrutura de facturação certificada AGT para Angola. Emita facturas legais a partir do seu código em menos de 10 minutos.
orgId e uma API key prontos. Vai primeiro a Primeiros Passos para o percurso completo, do zero - inclui como emitir NC, ND, Nota de Entrega e Proforma.Escolha a sua integração
Três formas de integrar - escolha a que encaixa no seu stack.
Para backends, APIs e scripts. Emite facturas certificadas directamente do servidor.
npm install @veroao/nodeHooks e componentes React para gerir facturação no frontend sem expor a API key.
npm install @veroao/reactUm bloco de facturação pronto a usar. Incorpore com uma linha de HTML.
<script src="https://cdn.vero.ao/widget.js">Início rápido
Emita a sua primeira factura certificada em menos de 5 minutos.
import { createVeroClient } from '@veroao/node'
const vero = createVeroClient({
secretKey: process.env.VERO_API_KEY, // vero_test_sk_... ou vero_live_sk_...
})
const invoice = await vero.invoices.create(process.env.VERO_ORG_ID, {
customerId: 'uuid-do-cliente',
documentType: 'FT',
items: [{ description: 'Plano Pro', quantity: 1, unitPrice: 1500000 }],
})
console.log(invoice.number) // "FT FT6326S62896N/1" - número AGT
console.log(invoice.atcud) // "FT7826S214N-1" - código de verificação AGT
console.log(invoice.pdfUrl) // PDF com QR code, pronto a enviarO que é o Vero?
Vero é uma plataforma de Billing-as-a-Service desenhada para eliminar a complexidade da facturação certificada em Angola. Fornecemos APIs e ferramentas que permitem emitir documentos legais - Factura (FT/FR), Nota de Crédito, Nota de Débito, Nota de Entrega, Proforma e Recibo - sem construir todo o motor de conformidade de raiz.
Arquitectura Core
- HTTPS obrigatório e assinatura JWS (RS256) por documento
- ATCUD e hash de integridade automáticos
- Submissão DFe em segundo plano - consulta agtStatus para saber quando a AGT valida
- Webhooks para os eventos principais (factura emitida/anulada, proforma convertida/anulada)
Próximos Passos
Após emitir a primeira factura, configure webhooks ou explore o fluxo de proformas.