Saltar al contenido
Constaia
tax_residence_certificate

Certificado de residencia fiscal

Certificado de residencia fiscal de cualquier país, a efectos de convenios de doble imposición (incluido el formulario IRS 6166).

Categoría
Impuestos
País
Internacional
Campos que extrae
8 campos
Coste
1 crédito
tax_residence_certificatespecimen
Nombre del titular
DNI/NIE del titular
Fecha de expedición
Country
Ejercicio fiscal
Treaty
Issuing authority
Verification code

Qué comprueba

  • Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
  • Antigüedad. Emitido hace menos de N días.

Campos que extrae

  • Nombre del titularholder_name
  • DNI/NIE del titularholder_id
  • Fecha de expediciónissue_date
  • Countrycountry
  • Ejercicio fiscaltax_year
  • Treatytreaty
  • Issuing authorityissuing_authority
  • Verification codeverification_code

Petición de ejemplo

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

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "tax_residence_certificate",
    "label": "Certificado de residencia fiscal",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "tax_residence_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Certificado de residencia fiscal."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "ESPECIMEN",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "ESPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "country": {
      "value": "ESPECIMEN",
      "confidence": 0.96,
      "validated": null
    },
    "tax_year": {
      "value": 1,
      "confidence": 0.99,
      "validated": null
    },
    "treaty": {
      "value": "ESPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "issuing_authority": {
      "value": "ESPECIMEN",
      "confidence": 0.97,
      "validated": null
    },
    "verification_code": {
      "value": "ESPECIMEN",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.