Sign in
copilot_frontend
OCR

Extract And Update 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

post/api/extract-cadastral-reference

Response

Successful Response

successboolean required
cadastral_referencestring nullable required
confidencestring required
messagestring required
hubspot_updatedboolean required

Changes