---
title: "Extract And Update Cadastral Reference"
method: POST
path: "/api/extract-cadastral-reference"
tags: ["copilot_frontend", "OCR"]
---

# Extract And Update Cadastral Reference

`POST /api/extract-cadastral-reference`

Extrae la referencia catastral de una imagen/PDF y actualiza HubSpot automáticamente.

Este endpoint:
1. Recibe una imagen o PDF con la referencia catastral
2. Usa Claude Vision API para extraer la referencia catastral (20 caracteres)
3. Actualiza automáticamente la propiedad 'referencia_catastral__ce_' en HubSpot del contacto
4. Devuelve la referencia extraída y el estado de la actualización

**Formatos de referencia catastral soportados:**
- Certificados energéticos
- Recibos IBI (con formato fragmentado: RC:XXXX XXXX XXXX)
- Web del Catastro
- Chats de WhatsApp (texto o imágenes compartidas)
- Documentos bancarios
- Cualquier orientación o calidad de imagen

**🔒 Protected Endpoint:** Requiere JWT authentication y rol 'ui_comercial' o 'admin'

Args:
    file: Archivo de imagen (JPEG, PNG, GIF, WebP) o PDF
    email: Email del contacto para actualizar en HubSpot
    current_user: Usuario autenticado actual

Returns:
    CadastralReferenceOCRResponse: Referencia catastral extraída y estado de actualización

Raises:
    ErrValidation: Si el archivo no es válido o no se puede procesar
    ErrExternalService: Si falla la comunicación con Claude Vision API o HubSpot

## Response `200`

Successful Response

- CadastralReferenceOCRResponse — Respuesta del endpoint de OCR de referencia catastral.
  - `success` boolean, required
  - `cadastral_reference` string, nullable, required
  - `confidence` string, required
  - `message` string, required
  - `hubspot_updated` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) · [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hogarsolar/hogarsolar-backend-api/revisions/d9861e46bef8/schema)