Confirmar/Rejeitar Documentos

Usado pelo adquirente de um documento (não o emissor) para confirmar ou rejeitar um documento recebido — ex.: confirmar dedução de IVA numa despesa.

POST /v1/client/validar

curl -X POST https://<host>/v1/client/validar \
  -H "X-API-Key: agt_live_XXXXXXXX.xxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "taxRegistrationNumber": "5001636863",
    "documentNo": "FT FT2026/1",
    "action": "C",
    "deductibleVATPercentage": 100
  }'

await fetch('https://<host>/v1/client/validar', {
  method: 'POST',
  headers: {
    'X-API-Key': 'agt_live_XXXXXXXX.xxxxxxxxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    taxRegistrationNumber: '5001636863',
    documentNo: 'FT FT2026/1',
    action: 'C',
    deductibleVATPercentage: 100
  })
})

requests.post(
    "https://<host>/v1/client/validar",
    headers={"X-API-Key": "agt_live_XXXXXXXX.xxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "taxRegistrationNumber": "5001636863",
        "documentNo": "FT FT2026/1",
        "action": "C",
        "deductibleVATPercentage": 100,
    },
)

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'taxRegistrationNumber' => '5001636863',
    'documentNo' => 'FT FT2026/1',
    'action' => 'C',
    'deductibleVATPercentage' => 100,
]));

Campo	Obrigatório	Notas
`taxRegistrationNumber`	sim	NIF de quem valida
`documentNo`	sim	documento a confirmar/rejeitar
`action`	sim	`C` confirmar, `R` rejeitar
`deductibleVATPercentage`	não	% de IVA dedutível (só com `C`)
`nonDeductibleAmount`	não	valor não dedutível (só com `C`) — mutuamente exclusivo com `deductibleVATPercentage`

Resposta:

{ "requestId": "uuid", "documentNo": "FT FT2026/1", "action": "C", "message": "Validação enfileirada" }

Consulta o resultado em GET /v1/client/status/{requestId} — valores finais: CONFIRMACAO_SUCESSO, REJEICAO_SUCESSO, CONFIRMACAO_FALHOU, REJEICAO_FALHOU.

Consultar Estado Webhooks