Integraciones

Conectar Bling ERP y sincronizar clientes, productos, pedidos y facturas

Conecta tu cuenta de Bling (un ERP brasileño) al CRM vía OAuth y sincroniza clientes, productos, pedidos de venta y facturas en ambos sentidos, sin crear duplicados.

Puedes conectar tu cuenta de Bling al CRM. Una vez conectada, el CRM trae de Bling los clientes (como Contacto o Empresa), los productos, los pedidos de venta y las facturas, manteniendo todo vinculado por el id de Bling. Volver a sincronizar nunca crea duplicados: actualiza el registro que ya existe.

El modelo es BYO ("trae tu cuenta"): usas tu propia cuenta de Bling y tu app OAuth. Nunca vemos tus credenciales y no hay costo de nuestra parte. La integración nace inerte: nada ocurre hasta que configuras las credenciales y la activas.

Requisitos

Una cuenta en Bling con acceso a la API v3.
Una aplicación creada en Bling (área de desarrollador), de la que obtienes el Client ID y el Client Secret y autorizas para obtener el refresh token OAuth.
En Sellio, ser administrador (permiso de gestionar configuraciones) para guardar las credenciales en Configuración → Integraciones.

Paso 1: crea la aplicación en Bling

En Bling, abre el área de aplicaciones/desarrollador y crea una nueva aplicación usando la API v3.
Copia el Client ID y el Client Secret de la aplicación.
Realiza la autorización OAuth de la aplicación para tu cuenta y guarda el refresh token generado. El CRM usa el refresh token para renovar el acceso por sí mismo.

Paso 2: pega las credenciales en el CRM

Abre Configuración → Integraciones y localiza la tarjeta "Bling ERP".
Pega el Client ID, el Client Secret y el refresh token. Las credenciales se guardan cifradas y nunca se muestran de vuelta.
En "Entidades y dirección", elige para clientes, productos, pedidos y facturas si quieres traer de Bling, enviar a Bling, en ambos sentidos o no sincronizar.
Haz clic en "Guardar conexión" y luego en "Activar".

Paso 3: sincroniza y recibe actualizaciones

Haz clic en "Sincronizar ahora" para traer los datos de Bling de inmediato. También se ejecuta una sincronización automática a diario.
Para recibir cambios casi en tiempo real, apunta las notificaciones (webhook) de Bling a la URL que aparece en la tarjeta. Contiene un token secreto: mantenla en privado.
Recomendamos encarecidamente completar el "Secreto del webhook" en la tarjeta y usar el mismo valor en Bling. Como este webhook ESCRIBE registros en tu CRM (contactos, pedidos, facturas), el secreto garantiza la autenticidad de cada llamada mediante una firma (HMAC).

Los clientes personas físicas se convierten en Contactos y las personas jurídicas en Empresas. Cada producto se convierte en un Producto, cada pedido de venta en un Pedido de venta (vinculado al cliente) y cada factura en una actividad con el número, el importe y el enlace del DANFE.

Seguridad y privacidad

El Client Secret y el refresh token se guardan cifrados y nunca se muestran. El token de acceso se renueva automáticamente al expirar, sin volver a autorizar. La conexión nace inerte y solo sincroniza tras configurarla y activarla.

💡 Recomendación de seguridad: configura el "Secreto del webhook". El webhook de Bling ESCRIBE registros en tu CRM (contactos, pedidos, facturas), así que trátalo como una puerta de entrada de datos. Con el secreto, cada llamada se valida mediante una firma (HMAC) y solo pasa quien conoce el secreto. Sin él, la única protección es el token de la URL: si ese token se filtra, alguien podría inyectar datos en tu cuenta. No es obligatorio, pero es muy recomendable.

Ejemplo: URL del webhook para registrar en Bling: https://app.tuempresa.com/api/inbound/bling/TU-TOKEN (copia el valor exacto que aparece en la tarjeta).

Cómo probar

Después de guardar y activar, haz clic en "Sincronizar ahora" y espera la confirmación.
Abre las listas de Contactos, Productos y Pedidos de venta y comprueba que los registros de Bling aparecieron.
En la tarjeta, observa cómo crece el conteo de "Vínculos por entidad" a medida que se sincronizan los datos.

Solución de problemas

No sincroniza nada: confirma que la integración está "Activada" y que al menos una entidad está en "Traer de Bling" o "En ambos sentidos".
Error de credenciales al sincronizar: vuelve a ingresar el Client ID, el Client Secret y el refresh token (el Secret y el token nunca vuelven del servidor, así que pégalos por completo).
Los registros no aparecen: confirma que los objetos Contacto, Empresa, Producto y Pedido de venta existen en tu cuenta (son estándar).
El webhook no llega: verifica que la URL registrada en Bling sea idéntica a la que aparece en la tarjeta y, si usaste un secreto del webhook, que sea el mismo en ambos lados.

Abrir este artículo dentro del sistema →