API REST para Facturação Electrónica em Angola

Emita, anule e consulte documentos fiscais por API.

Um gateway simples para softwares que precisam comunicar com a AGT: o cliente envia apenas os campos do documento e a privateKey da empresa; a API gera UUIDs, timestamps, assinaturas JWS e submete a requisição.

Solicitar validação Ver exemplos de integração

Consulta de NIF Facturas e recibos Notas de crédito e débito Séries Sandbox local

Subscrição anual

350.000 Kz/ ano

Validação por WhatsApp 946369451, telefone 952918165 ou suporte@facturize.net.

Hoje18

Validados16

Pendentes2

FR SEDE/2026/2FRVálido

NC NC8126S1021N/1NCRecebido

RC-2026-002RCPago

POST /api/fe/v1/documentos/registar → requestID recebido

Fluxo de emissão

Como a integração funciona

O registo é assíncrono: depois de submeter um documento, guarde o requestID e consulte o estado até a AGT validar ou devolver erro.

Enviar payload

Use JSON com os campos de negócio e privateKey em Base64. Para consultar NIF, envie apenas o NIF e a autenticação do cliente.

Assinar e submeter

A API completa metadados técnicos, gera todas as assinaturas JWS e envia a requisição para o serviço correcto.

Consultar resposta

O seu software recebe a resposta da AGT e acompanha o estado pelo endpoint de consulta.

Integração

Configure o endpoint no seu software

Em produção, cada cliente autentica-se com API key ou username/password. A assinatura fiscal fica sempre dentro da API.

curl -X POST "https://www.facturize-api.cloud/api/fe/v1/documentos/registar" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $FACTURIZE_API_KEY" \
  -d '{"taxRegistrationNumber":"5001636863","privateKey":"...","documents":[]}'

const response = await fetch("https://www.facturize-api.cloud/api/fe/v1/documentos/registar", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.FACTURIZE_API_KEY
  },
  body: JSON.stringify(payload)
});

const result = await response.json();

import axios from "axios";

const result = await axios.post(
  "https://www.facturize-api.cloud/api/fe/v1/documentos/registar",
  payload,
  {
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.FACTURIZE_API_KEY
    }
  }
);

import requests

response = requests.post(
    "https://www.facturize-api.cloud/api/fe/v1/documentos/registar",
    headers={
        "Content-Type": "application/json",
        "x-api-key": FACTURIZE_API_KEY,
    },
    json=payload,
)

print(response.json())

$ch = curl_init("https://www.facturize-api.cloud/api/fe/v1/documentos/registar");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: " . getenv("FACTURIZE_API_KEY")
  ],
  CURLOPT_POSTFIELDS => json_encode($payload)
]);

$result = json_decode(curl_exec($ch), true);

curl "https://www.facturize-api.cloud/api/fe/v1/nif/5002852780" \
  -H "x-api-key: $FACTURIZE_API_KEY"

// Resposta
{
  "success": true,
  "cached": false,
  "data": {
    "numeroDocumento": "5002852780",
    "nome": "..."
  }
}

Sandbox

Teste simulado com payload editável

Edite o JSON e escolha o modo. No modo Produção, inclua apiKey no payload; a página remove essa chave do corpo e envia-a como header.

Simulado Produção real

Para resposta verdadeira da AGT, use dados reais, privateKey em Base64 e apiKey do cliente.

Solicitar série Série

Registar documento Factura

{
  "taxRegistrationNumber": "5001636863",
  "documents": [
    {
      "documentType": "FR",
      "documentNo": "FR SEDE/2026/2",
      "documentDate": "2026-02-03",
      "companyName": "CENFOLITE, LDA",
      "customerTaxID": "999999999",
      "customerName": "Consumidor Final",
      "customerCountry": "AO",
      "lines": [
        {
          "lineNumber": "1",
          "productCode": "SERV001",
          "productDescription": "Prestação de serviços",
          "quantity": "1.00",
          "unitOfMeasure": "UNI",
          "unitPrice": "1000.00",
          "unitPriceBase": "1000.00",
          "creditAmount": "1000.00",
          "settlementAmount": "0.00",
          "taxes": [
            {
              "taxType": "IVA",
              "taxCode": "NOR",
              "taxCountryRegion": "AO",
              "taxPercentage": "14.00",
              "taxContribution": "140.00"
            }
          ]
        }
      ],
      "documentTotals": {
        "taxPayable": "140.00",
        "netTotal": "1000.00",
        "grossTotal": "1140.00"
      }
    }
  ],
  "privateKey": "BASE64_DA_CHAVE_PRIVADA_DA_EMPRESA"
}

Anular por Nota de Crédito NC

{
  "taxRegistrationNumber": "5001636863",
  "documents": [
    {
      "documentNo": "NC NC8126S1021N/1",
      "documentDate": "2026-02-03",
      "documentType": "NC",
      "customerTaxID": "5001441337",
      "customerCountry": "AO",
      "companyName": "NIF DE TESTE IIRS - NAO RESIDENTE",
      "lines": [
        {
          "lineNumber": 1,
          "productCode": "d7a06a73-6c40-4cdb-9984-34f2b8810a25",
          "productDescription": "Carga",
          "quantity": 1,
          "unitOfMeasure": "UN",
          "unitPriceBase": 7298.29,
          "unitPrice": 7298.29,
          "debitAmount": 7298.29,
          "settlementAmount": 0,
          "referenceInfo": {
            "reference": "FR FR8126S963N/1",
            "reason": "Item anulado",
            "referenceItemLineNo": 1
          },
          "taxes": [
            {
              "taxType": "IVA",
              "taxCountryRegion": "AO",
              "taxCode": "NOR",
              "taxPercentage": 14,
              "taxContribution": 1021.77
            }
          ]
        },
        {
          "lineNumber": 2,
          "productCode": "1122824c-857e-4769-8394-88134fb41306",
          "productDescription": "Manuseamento",
          "quantity": 1,
          "unitOfMeasure": "UN",
          "unitPriceBase": 2736.86,
          "unitPrice": 2736.86,
          "debitAmount": 2736.86,
          "settlementAmount": 0,
          "referenceInfo": {
            "reference": "FR FR8126S963N/1",
            "reason": "Item anulado",
            "referenceItemLineNo": 2
          },
          "taxes": [
            {
              "taxType": "IVA",
              "taxCountryRegion": "AO",
              "taxCode": "NOR",
              "taxPercentage": 14,
              "taxContribution": 383.17
            }
          ]
        }
      ],
      "documentTotals": {
        "taxPayable": 1404.94,
        "netTotal": 10035.15,
        "grossTotal": 11440.09
      }
    }
  ],
  "privateKey": "BASE64_DA_CHAVE_PRIVADA_DA_EMPRESA"
}

Emitir recibo RC

Consultar NIF NIF

Edite um payload, escolha o modo e clique em simular. A resposta aparecerá aqui.

Modelos reais

Payloads de operações suportadas

Os exemplos abaixo são carregados directamente dos JSONs do projecto para orientar a implementação do seu software.

Factura-recibo

Emitir venda paga no acto

Use quando a factura e o recibo nascem na mesma operação. Envie linhas, impostos e totais no endpoint de registo.