Saltar al contenido
Constaia
es_self_employed_fee_receipt

Recibo de autónomos (RETA)

Recibo de liquidación de cotizaciones del Régimen Especial de Trabajadores Autónomos: titular, NAF, periodo, base e importe.

Categoría
Pagos y finanzas
País
España
Campos que extrae
9 campos
Coste
1 crédito
es_self_employed_fee_receiptspecimen
Nombre del titular
DNI/NIE del titular
Social security number
Period
Contribution base
Importe
Payment date
IBAN
Receipt number

Qué comprueba

  • Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).es_nif
  • Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
  • Antigüedad. Emitido hace menos de N días.
  • IBAN. Dígitos de control ISO 13616 y longitud por país.

Campos que extrae

  • Nombre del titularholder_name
  • DNI/NIE del titularholder_id
  • Social security numbersocial_security_number
  • Periodperiod
  • Contribution basecontribution_base
  • Importeamount
  • Payment datepayment_date
  • IBANiban
  • Receipt numberreceipt_number

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "es_self_employed_fee_receipt",
    "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": "es_self_employed_fee_receipt",
    "label": "Recibo de autónomos (RETA)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_self_employed_fee_receipt"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Recibo de autónomos (RETA)."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "99999999R",
      "confidence": 0.98,
      "validated": null
    },
    "social_security_number": {
      "value": "281234567840",
      "confidence": 0.97,
      "validated": null
    },
    "period": {
      "value": "2026-08",
      "confidence": 0.96,
      "validated": null
    },
    "contribution_base": {
      "value": 1000,
      "confidence": 0.99,
      "validated": null
    },
    "amount": {
      "value": 314,
      "confidence": 0.98,
      "validated": null
    },
    "payment_date": {
      "value": "2026-08-31",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    },
    {
      "code": "iban_checksum",
      "passed": true,
      "message": "iban_checksum"
    }
  ],
  "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.