Integração AGT
Em Produção, o SIGESC encaminha cada pedido do programador para a API oficial de Facturação Electrónica da AGT (SIGT/FE). O seu software fala apenas com o contrato estável /api/v1; nós tratamos autenticação Basic, payloads, JWS RS256 e polling de estado.
Endpoints AGT utilizados
POST …/solicitarSerie— criar série de numeraçãoPOST …/listarSeries— sincronizar séries do contribuintePOST …/registarFactura— submeter FT, RC/RG, NC, ND e outros tiposPOST …/obterEstado— consultar validação pelorequestIDPOST …/consultarFactura— obter dados de um documentoPOST …/anularFactura— anular documento aceite
Fluxo do programador
- Criar ou sincronizar séries:
POST /v1/seriesePOST /v1/series?action=sync - Emitir documentos:
POST /v1/invoices,/v1/receipts,/v1/credit-notes,/v1/debit-notes - Consultar:
GET /v1/documents?id=…ou listagens por tipo
Ambientes AGT
- Homologação:
https://sifphml.minfin.gov.ao/sigt/fe/v1 - Produção:
https://sifp.minfin.gov.ao/sigt/fe/v1
Configure AGT_TRANSPORT=http com credenciais oficiais para chamadas reais. Sem credenciais, o adaptador usa transporte mock no mesmo formato de resposta (útil em desenvolvimento). Ver também Produção e Séries.