es_income_tax_return

Declaração de IRS espanhola (modelo 100)

Declaração de IRPF espanhola (modelo 100) apresentada: exercício, declarante, bases tributáveis, coleta e resultado.

Categoria: Impostos
País: Espanha
Campos extraídos: 12 campos
Custo: 1 crédito

es_income_tax_returnspecimen

Ano fiscal
Nome do titular
N.º de identificação do titular
Spouse id
Joint
General tax base
Savings tax base
Total tax due
Result

O que verifica

Identificadores nacionais. Checksum ou formato oficial do número (NIF, CPF, CURP, RUT…).es_nif, es_nif
Titular. Nome, número ou data de nascimento coincidem com o esperado.
Código de verificação. Formato do código para o conferir junto do emissor.

Campos extraídos

Ano fiscaltax_year
Nome do titularholder_name
N.º de identificação do titularholder_id
Spouse idspouse_id
Jointjoint
General tax basegeneral_tax_base
Savings tax basesavings_tax_base
Total tax duetotal_tax_due
Resultresult
Receipt numberreceipt_number
Filing datefiling_date
Código Seguro de Verificação (CSV)csv_code

Exemplo de pedido

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "es_income_tax_return",
    "checks": {
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_income_tax_return",
    "label": "Declaração de IRS espanhola (modelo 100)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_income_tax_return"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Declaração de IRS espanhola (modelo 100)."
      }
    ]
  },
  "fields": {
    "tax_year": {
      "value": 2025,
      "confidence": 0.99,
      "validated": true
    },
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.98,
      "validated": null
    },
    "holder_id": {
      "value": "99999999R",
      "confidence": 0.97,
      "validated": null
    },
    "joint": {
      "value": false,
      "confidence": 0.96,
      "validated": null
    },
    "general_tax_base": {
      "value": 28500,
      "confidence": 0.99,
      "validated": null
    },
    "savings_tax_base": {
      "value": 350.2,
      "confidence": 0.98,
      "validated": null
    },
    "total_tax_due": {
      "value": 4870.55,
      "confidence": 0.97,
      "validated": null
    },
    "result": {
      "value": -312.4,
      "confidence": 0.96,
      "validated": null
    },
    "receipt_number": {
      "value": "1001234567890",
      "confidence": 0.99,
      "validated": null
    },
    "filing_date": {
      "value": "2026-05-10",
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    },
    {
      "code": "csv_format",
      "passed": true,
      "message": "O código de verificação tem um formato válido."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

A Constaia prova que o documento é autêntico?

Não. Verifica o tipo, a coerência dos dados e as suas regras, e assinala sinais como possível edição ou fotografia de ecrã. Isso não prova autenticidade.

É guardada uma cópia do documento?

Não, a menos que o peça. Com storage "none" (por omissão) o ficheiro é apagado quando a análise termina.

Outros documentos

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.

Criar conta grátis Falar com vendas