Importación desde EasyBroker: Guía Completa

Requisitos Previos

Antes de importar necesitas:

Paso 1: Obtener tu API Key

sequenceDiagram
    participant U as 👤 Tú
    participant EB as 🏢 EasyBroker
    participant B as 🔧 Brokar

    U->>EB: Login → Configuración → API
    EB->>U: Genera API Key (eb-xxxx...)
    U->>B: Pega API Key
    B->>EB: Prueba conexión
    EB->>B: ✅ Conexión OK
    B->>U: ¡Listo para importar!

¿Dónde encuentro mi API Key?

1. Entra a app.easybroker.com
2. Ve a Configuración (⚙️ arriba derecha)
3. Sección API e Integraciones
4. Copia tu API Key (empieza con eb-)

Paso 2: Configurar la Integración

1. En Brokar, ve a Configuración → Integraciones → EasyBroker
2. Pega tu API Key
3. Opcional: Nombre de tu organización
4. Activa Sincronización automática si deseas actualización cada 24h
5. Clic en Probar Conexión
6. Si es exitoso, Guardar

┌─────────────────────────────────────────────────────────────┐
│  🔗 Configurar EasyBroker                                   │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━    │
│                                                             │
│  API Key: [eb-xxxxxx_________________________]             │
│                                                             │
│  Organización: [Mi Inmobiliaria S.A. _______]              │
│                                                             │
│  ☑️ Sincronización automática cada 24 horas                │
│                                                             │
│  [🔌 Probar Conexión]    [💾 Guardar]                      │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Paso 3: Importar Propiedades

Opción A: Importación Individual

Para importar propiedades específicas:

1. Ve a Integraciones → EasyBroker → Ver Propiedades
2. Verás una lista con tus propiedades de EasyBroker
3. Cada una muestra: foto, título, precio, estado
4. Clic en Importar en las que quieras traer

flowchart LR
    subgraph EB["EasyBroker"]
        P1[Casa Polanco]
        P2[Depa Condesa]
        P3[Local Roma]
    end

    subgraph Selector["Selector"]
        S1["✅ Seleccionar"]
        S2["✅ Seleccionar"]
        S3["⬜ No importar"]
    end

    subgraph Brokar["Brokar"]
        B1[Casa Polanco]
        B2[Depa Condesa]
    end

    P1 --> S1 --> B1
    P2 --> S2 --> B2
    P3 --> S3

    style B1 fill:#10B981,color:#fff
    style B2 fill:#10B981,color:#fff

Opción B: Importación Masiva (Bulk)

Para importar varias propiedades a la vez:

1. Selecciona múltiples propiedades con el checkbox
2. Clic en Importar Seleccionadas
3. Espera mientras se procesan

Opción C: Importación Completa (Full Import)

Para traer todo tu inventario de golpe:

1. Clic en Importar Todo
2. Selecciona filtros opcionales:
   • Estado: Publicadas, No publicadas, Vendidas, Rentadas, Todas
   • Tag: Si usas tags en EasyBroker, filtra por uno específico
3. El sistema calcula cuántas hay que importar
4. Clic en Iniciar Importación

sequenceDiagram
    participant U as 👤 Usuario
    participant B as 🖥️ Brokar
    participant API as 🔌 EasyBroker API
    participant DB as 💾 Base de Datos

    U->>B: Clic "Importar Todo"
    B->>API: GET /properties?status=published
    API->>B: 150 propiedades encontradas
    B->>U: "150 propiedades, 12 ya importadas. ¿Continuar?"
    U->>B: Confirmar

    loop Cada lote de 50
        B->>API: GET /properties?page=1
        API->>B: 50 propiedades con detalles
        B->>DB: Crear propiedades + fotos + amenidades
        B->>U: Progreso: 33%...
    end

    B->>U: ✅ ¡138 propiedades importadas!

Proceso Técnico de Importación

¿Qué Datos se Importan?

Mapeo de Estados

Mapeo de Ubicaciones

El sistema intenta mapear automáticamente:

flowchart TD
    subgraph EasyBroker["📍 Ubicación EasyBroker"]
        E1["state: Ciudad de México"]
        E2["city: Cuauhtémoc"]
        E3["neighborhood: Condesa"]
    end

    subgraph Proceso["🔄 Proceso"]
        P1["Buscar estado por nombre"]
        P2["Buscar municipio"]
        P3["Buscar o crear colonia"]
    end

    subgraph Brokar["💾 Brokar"]
        B1["Estado: CDMX"]
        B2["Municipio: Cuauhtémoc"]
        B3["Colonia: Condesa"]
    end

    E1 --> P1 --> B1
    E2 --> P2 --> B2
    E3 --> P3 --> B3

Panel de Estado de Importación

Durante la importación verás:

┌─────────────────────────────────────────────────────────────┐
│  📦 Importación en Progreso                                 │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━    │
│                                                             │
│  [████████████████░░░░░░░░░░░░░░] 67%                      │
│                                                             │
│  ✅ Importadas: 85                                         │
│  ⏭️ Omitidas (duplicadas): 8                               │
│  ❌ Fallidas: 2                                            │
│  ⏳ Restantes: 43                                          │
│                                                             │
│  Procesando: Casa en Polanco #EB-1234567                   │
│                                                             │
│  [🚫 Cancelar]                                              │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Resultados Posibles

Sincronización Automática

Si activas Sync Automático:

• Cada 24 horas el sistema revisa cambios en EasyBroker
• Nuevas propiedades se importan automáticamente
• Cambios de precio/estado se reflejan en Brokar
• Propiedades eliminadas en EB → Se marcan inactivas en Brokar

Identificación de Propiedades Importadas

Las propiedades importadas desde EasyBroker muestran:

• Badge "Importado de EasyBroker" en la lista
• ID EasyBroker en los detalles de la propiedad
• Fecha de importación registrada

Esto permite:

• Evitar duplicados
• Rastrear el origen
• Mantener sincronización

Filtros Avanzados

Por Estado EasyBroker

Por Tag

Si organizas con tags en EasyBroker (premium, destacada, urgente):

1. Selecciona el tag en el filtro
2. Solo se importarán propiedades con ese tag
3. Útil para importar solo cierto inventario

Solución de Problemas

Métricas de Importación

En Integraciones → EasyBroker verás:

Flujo Completo Recomendado

journey
    title Mi Primera Importación desde EasyBroker
    section Configurar
        Obtener API Key de EasyBroker: 5: Usuario
        Pegar en Brokar: 5: Usuario
        Probar conexión: 5: Sistema
    section Importar
        Ver lista de propiedades: 4: Usuario
        Filtrar por estado/tag: 4: Usuario
        Iniciar importación masiva: 5: Sistema
        Esperar procesamiento: 3: Usuario
    section Verificar
        Revisar propiedades importadas: 5: Usuario
        Completar datos faltantes: 4: Usuario
        Activar sync automático: 5: Sistema

Mejores Prácticas