Documentos Fiscais
Lista consolidada de todos os documentos fiscais emitidos (FT, FR, NC, ND) com número AGT e ATCUD. Útil para reconciliação contabilística e auditoria interna.
Facturação Electrónica DFe - Com a integração DFe activa, cada documento é submetido à AGT em segundo plano. Este endpoint agrega facturas, notas de crédito e notas de débito num único relatório exportável, útil para reconciliação interna (não substitui o ficheiro SAF-T AO, que continua obrigatório à parte).
Listar Documentos Fiscais
GET
/v1/organisations/:orgId/reports/fiscal-documentsParâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| year | integer? | Filtrar por ano (ex: 2026). Omitir para todos os anos. |
| month | integer? | Filtrar por mês (1–12). Requer year. |
Exemplo de pedido
Terminal
curl -X GET "https://api.vero.ao/v1/organisations/ORG_ID/reports/fiscal-documents?year=2026" \
-H "Authorization: Bearer vero_live_sk_..."Resposta (200 OK)
JSON
[
{
"id": "a1b2c3d4-...",
"document_type": "FT",
"number": "FT FT6326S62896N/1",
"atcud": "FT7826S214N-1",
"display_code": "B6B402",
"customer_name": "Empresa ABC, Lda",
"customer_tax_id": "5000123456",
"subtotal": 13157895,
"tax_amount": 1842105,
"total": 15000000,
"currency": "AOA",
"status": "issued",
"doc_date": "2026-06-25T08:30:00.000Z"
},
{
"id": "e5f6g7h8-...",
"document_type": "NC",
"number": "NC NC6326S37645N/1",
"atcud": "NC7825S906C-1",
"display_code": "081D93",
"customer_name": "Empresa ABC, Lda",
"customer_tax_id": "5000123456",
"subtotal": 13157895,
"tax_amount": 1842105,
"total": 15000000,
"currency": "AOA",
"status": "issued",
"doc_date": "2026-06-25T09:15:00.000Z"
}
]Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| document_type | 'FT'|'FR'|'NC'|'ND' | Tipo de documento fiscal |
| number | string | null | Número AGT certificado (ex: FT FT6326S62896N/1) |
| atcud | string | null | Código único de validação AGT - verificável por QR code |
| display_code | string | null | Código interno de apresentação |
| customer_name | string | Nome do cliente |
| customer_tax_id | string | null | NIF do cliente |
| subtotal | integer | Base tributável em kwanzas × 100 |
| tax_amount | integer | IVA em kwanzas × 100 |
| total | integer | Total em kwanzas × 100 |
| status | string | Estado: issued, cancelled |
| doc_date | string (ISO 8601) | Data de emissão do documento |