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ção
  • POST …/listarSeries — sincronizar séries do contribuinte
  • POST …/registarFactura — submeter FT, RC/RG, NC, ND e outros tipos
  • POST …/obterEstado — consultar validação pelo requestID
  • POST …/consultarFactura — obter dados de um documento
  • POST …/anularFactura — anular documento aceite

Fluxo do programador

  1. Criar ou sincronizar séries: POST /v1/series e POST /v1/series?action=sync
  2. Emitir documentos: POST /v1/invoices, /v1/receipts, /v1/credit-notes, /v1/debit-notes
  3. 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.