Facturação Electrónica AGT
sem complicação técnica.
Infraestrutura de API REST para emitir e validar documentos fiscais em Angola. Tratamos da assinatura criptográfica JWS RS256, comunicação TLS 1.2 e gestão de ambientes.
const API = "https://connect.factflexi.com/v2/documentos/emitir";
const response = await fetch(API, {
method: "POST",
headers: {
"x-api-key": "feak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
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,
}],
}],
}),
});
const data = await response.json();
console.log(data.requestIdAGT);Funcionalidades da API
Tudo o que a sua equipa precisa para integrar facturação electrónica de forma segura e rápida.
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.
Passos para Integração
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.
Planos e Preços
Escolha a modalidade de subscrição ideal para o seu negócio.
Mensal
100.000 Kz
por mês
- Chamadas ilimitadas à API
- FT, FR, NC, ND e Recibos (RC)
- Ambientes HML + PROD
- Assinatura JWS RS256 automática
- Suporte técnico dedicado
Anual
90.000 Kz
por mês · facturado anualmente (1.080.000 Kz/ano)
- Chamadas ilimitadas à API
- FT, FR, NC, ND e Recibos (RC)
- Ambientes HML + PROD
- Assinatura JWS RS256 automática
- Suporte prioritário
API Gateway vs Software Completo
Escolha a solução ideal conforme o perfil de desenvolvimento do seu projeto.
Precisa de suporte na integração?
A nossa equipa de engenharia está pronta para ajudar na configuração do ambiente AGT.
Não pretende integrar com o Fact Flexi Connect?
O Fact Flexi é a nossa plataforma completa de facturação electrónica certificado pela AGT. Sem necessidade de código, configure a sua empresa e comece a emitir facturas em minutos.