Facturação Electrónica · AGT Angola
Integra a facturação electrónica
no teu sistema
Serviço REST que abstrai toda a complexidade da API da AGT — assinatura digital JWS RS256, TLS 1.2, gestão de ambientes HML/PROD. A tua aplicação envia JSON, nós tratamos do resto.
curl -X POST https://connect.factflexi.com/v2/documentos/emitir \
-H "x-api-key: feak_..." \
-H "Content-Type: application/json" \
-d '{
"nif": "5000537039",
"privateKey": "-----BEGIN PRIVATE KEY-----...",
"companyName": "SONHE TESTE",
"documentos": [{
"numero": "FT FT3926S9043N/1",
"tipo": "FT",
"data": "2026-07-25",
"cliente": { "nome": "Cliente", "nif": "999999999", "pais": "AO" },
"itens": [{
"codigo": "PROD001", "descricao": "Produto",
"quantidade": 2, "unidade": "UN",
"precoUnitario": 5000, "taxa": 14
}]
}]
}'Assinatura JWS automática
O serviço assina cada documento com RS256 usando a chave privada da empresa. Zero conhecimento de criptografia necessário da tua parte.
Um endpoint, dois ambientes
Homologação e produção partilham a mesma API. O serviço gere automaticamente URLs, credenciais e certificados de cada ambiente.
Todos os tipos de documento
Facturas (FT), recibos (RC), notas de crédito (NC), notas de débito (ND) e mais — o mesmo endpoint trata de todos.
Retry seguro com idempotência
Usa um idempotencyKey para garantir que um retry acidental não cria documentos duplicados na AGT.
Documentação interactiva
OpenAPI + Scalar UI. Testa todos os endpoints directamente do browser, com exemplos em TypeScript, Python e PHP.
API Keys seguras
Chaves armazenadas com hash SHA-256. Rotação, revogação instantânea e scopes por endpoint.
Como integrar
Cria uma conta
Regista-te no portal. Após aprovação, gera a tua API Key no painel do cliente.
Solicita séries
Para cada tipo de documento e ano fiscal, cria as séries de numeração necessárias.
Emite documentos
Uma única chamada REST com os dados do documento. O serviço trata da assinatura, submissão e log.
Verifica o estado
A AGT processa de forma assíncrona. Usa o endpoint de status para confirmar a validação.
Não queres integrar uma API?
O Fact Flexi é o nosso software completo de facturação electrónica e gestão empresarial. Crias a tua conta, configuras os dados da empresa e começas a emitir facturas imediatamente — sem escrever uma linha de código.