Integraciones
OmniBuy se integra con CRMs, ERPs y proveedores de identidad para sincronizar datos comerciales. Todas las integraciones siguen el mismo patrón de configuración y operación.
Integraciones disponibles
| Integración | Tipo | Entidades sincronizadas | Modo |
|---|---|---|---|
| HubSpot | CRM | Contactos, deals (órdenes), productos | Bidireccional |
| Salesforce | CRM | Contactos, oportunidades, productos | Bidireccional |
| SAP ERP | ERP | Órdenes, productos, contactos | Bidireccional |
| SSO SAML 2.0 | Identidad | Autenticación federada | Unidireccional |
Flujo común
Todas las integraciones de datos (CRM/ERP) siguen el mismo patrón:
- Configurar — Credenciales y opciones de sincronización
- Probar conexión — Verificar que las credenciales son válidas
- Sincronizar individual — Sync de un registro específico por ID
- Sincronizar todo — Sync bulk de todos los registros de un tipo
- Consultar registros — Ver estado de sync (exitoso, fallido, pendiente)
- Reintentar fallidos — Reintentar registros que fallaron
API común
Todas las integraciones exponen estos endpoints (reemplaza {integration} con hubspot, salesforce, o sap):
| Método | Ruta | Descripción |
|---|---|---|
POST | /api/v1/integrations/{integration} | Guardar configuración |
GET | /api/v1/integrations/{integration} | Obtener configuración |
POST | /api/v1/integrations/{integration}/test-connection | Probar conexión |
GET | /api/v1/integrations/{integration}/sync/records | Listar registros de sync |
POST | /api/v1/integrations/{integration}/sync/retry | Reintentar fallidos |
Estados de sincronización
| Estado | Descripción |
|---|---|
pending | Pendiente de sincronización |
synced | Sincronizado exitosamente |
failed | Falló la sincronización |
Filtros de registros
Los endpoints de registros soportan filtros por query params:
| Param | Tipo | Descripción |
|---|---|---|
status | string | Filtrar por estado: pending, synced, failed |
entity_type | string | Filtrar por tipo: contact, deal, product, order |
Gestión desde el Admin Panel
Todas las integraciones se gestionan desde Admin → Integraciones. El panel ofrece:
- Formulario de configuración con campos específicos por integración
- Botón de test de conexión en tiempo real
- Tabla de registros de sync con filtros
- Acción de retry masivo para registros fallidos