Conectar Bling

Con Bling conectado, cada pedido pagado en Vipter se convierte en un pedido de venta en Bling, con el contacto, los ítems, el envío, el descuento y las cuotas. Bling puede generar la NF-e y descontar el stock, y la factura y el seguimiento vuelven al pedido en Vipter.

Antes de empezar, conviene leer cómo funciona la integración con el ERP: qué va en el pedido de venta, cómo se encuentran los productos y qué pasa en el reembolso.

Dos formas de conectarCopiar enlace de la sección

• Por la aplicación de Vipter: cuando la tarjeta Conexión muestra el interruptor Usar mi propia aplicación de Bling, déjalo apagado. Haz clic en Conectar y autoriza a Vipter en tu cuenta de Bling. No necesitas crear ninguna aplicación. Los avisos de factura y seguimiento también llegan solos. Ve directo al paso 2.
• Por una aplicación tuya: cuando la tarjeta no muestra el interruptor, o cuando tu empresa exige una aplicación propia y enciendes el interruptor. Sigue todos los pasos.

Cambiar de una forma a la otra deshace la conexión. Después de guardar, el panel avisa la aplicación cambió, conecta de nuevo: haz clic en Reconectar.

Paso 1: crear la aplicación en BlingCopiar enlace de la sección

1. En el panel de Vipter, abre General›Integraciones›ERP›Bling y copia la URL de retorno (redirección) de la tarjeta Conexión, con el botón de copiar.
2. En Bling, abre Central de Extensões›Área do Integrador (central de extensiones › área del integrador) y haz clic en Criar aplicativo (crear aplicación).
3. Elige la aplicación de uso privado (uso privado) y completa los datos que pide Bling, como el nombre.
4. En Link de redirecionamento (enlace de redirección), pega la URL que copiaste de Vipter, sin cambiar nada.
5. En Lista de escopos (lista de alcances), haz clic en Adicionar (agregar) e incluye: Contatos, Produtos, Pedidos de venda, Notas fiscais eletrônicas, Formas de pagamento, Situações, Logísticas y Dados básicos da empresa (contactos, productos, pedidos de venta, facturas electrónicas, formas de pago, situaciones, logística y datos básicos de la empresa).
6. Guarda la aplicación. En la pestaña Informações do app (información de la app), copia el Client ID y el Client Secret y guárdalos para el paso 2.

Paso 2: conectar en VipterCopiar enlace de la sección

1. Abre General›Integraciones›ERP›Bling.
2. Con una aplicación tuya, completa los campos de la tarjeta Conexión:

3. Haz clic en Conectar a Bling. Vipter guarda la página y abre Bling.
4. Entra en la cuenta de Bling de tu empresa y autoriza el acceso.

El acceso a Bling dura algunas horas y Vipter lo renueva solo, antes de que venza. La línea debajo del estado muestra hasta cuándo vale el acceso actual.

Paso 3: registrar los avisos en BlingCopiar enlace de la sección

Este paso es solo para quien conecta con aplicación propia. Con la aplicación de Vipter, la tarjeta dice La aplicación de Vipter recibe los avisos de Bling por sí sola. No necesitas registrar nada.

Los avisos llevan la NF-e y el seguimiento de Bling a Vipter en cuanto cambian.

1. Después de guardar, la tarjeta Conexión muestra la URL de avisos, en Avisos del ERP (webhooks). Copia la URL.
2. En Bling, abre tu aplicación en la Área do Integrador y entra en la pestaña Webhooks.
3. Registra la URL de Vipter como servidor.
4. Activa los recursos Pedido de venda (pedido de venta) y Nota fiscal (factura), con las acciones de creación y de modificación, en la versión 1 del contenido.
5. Guarda.

Bling firma cada aviso con el Client Secret de la aplicación, y Vipter rechaza los avisos con otra firma. Si generas un Client Secret nuevo en Bling, pega el nuevo en Vipter y guarda.

Cuando llega el primer aviso, la tarjeta muestra Último aviso recibido el 04/10/2026 15:42. Sin avisos, Vipter consulta Bling cada 3 horas, así que la factura y el seguimiento llegan igual, solo que más tarde.

Paso 4: elegir qué enviarCopiar enlace de la sección

La tarjeta Qué enviar dice qué pedidos van y qué hace Bling con ellos.

• Pedidos enviados (1): Solo pedidos con envío, lo predeterminado, o Todos los pedidos pagados.
• Generar la NF-e en el ERP (2): Bling genera la NF-e del pedido de venta. Encendido, aparecen Transmitir la NF-e a la SEFAZ, para transmitir al instante en vez de dejar un borrador, y El ERP envía la NF-e por correo al cliente.
• Registrar el stock del pedido (3): Vipter registra la salida del stock en Bling. Enciéndelo solo si Bling no descuenta el stock solo al emitir la factura.
• Cancelar en el ERP cuando se reembolse el pedido (4): viene encendido. En el reembolso total o el contracargo, el pedido de venta pasa a la situación Cancelado y el stock registrado por Vipter vuelve.
• Crear en el ERP los productos que falten (5): Apagado, el pedido queda con error hasta que informes el código del producto en Bling en Productos. Encendido, Vipter crea en Bling el producto que falta.
• Integración activa: apagado, nada va a Bling y los nuevos intentos se detienen.

Cada opción se explica en cómo funciona la integración con el ERP.

Paso 5: completar los datos de BlingCopiar enlace de la sección

La tarjeta Datos del ERP recibe los números de registros del propio Bling. Deja en blanco lo que no usas: Vipter descubre solo la situación Cancelado y las formas de pago.

Debajo, en Formas de pago, hay un campo por método de pago de Vipter: Tarjeta de crédito, Tarjeta de débito, PIX, Boleto y Billetera digital. En blanco, Vipter usa la forma de pago activa del tipo correcto, la predeterminada primero. Sin ninguna forma, Bling aplica su propia condición de pago y el pedido va sin cuotas.

Todos los ID aceptan solo números. Haz clic en Guardar.

Paso 6: informar los códigos de los productosCopiar enlace de la sección

La tarjeta Productos lista los productos de Vipter, los que tienen envío primero. Vipter encuentra cada producto en Bling por su código (SKU). En blanco, el código es el ID del producto en Vipter.

1. Junto a cada producto, escribe el código que tiene en Bling. Deja en blanco los productos cuyo código en Bling ya es el ID de Vipter.
2. Haz clic en Guardar códigos.

Después de la primera venta de cada producto, la línea muestra vinculado al ID 16123456789 en el ERP.

Paso 7: probarCopiar enlace de la sección

1. Haz clic en Probar conexión. Aparece La conexión funciona, con el nombre y el CNPJ de la empresa.
2. Haz una compra de prueba de un producto con envío, o abre un pedido pagado y haz clic en Enviar a Bling en la tarjeta ERP.
3. Mira el pedido en Pedidos enviados, al final de la página de la integración.

El pedido de prueba es un pedido de venta de verdad en Bling. Después de revisarlo, cancélalo en Bling. Con todo en orden, enciende la NF-e y el stock, si los vas a usar, y guarda.

Encender, apagar y quitarCopiar enlace de la sección

• Integración activa: apagado, nada va a Bling, los nuevos intentos se detienen y los avisos se ignoran. Los pedidos pagados en ese período no van después solos: vuelve a encenderlo y envía cada uno desde la tarjeta del pedido.
• Quitar integración: ¿Quitar la integración con Bling? Se borran la conexión y el historial de pedidos enviados. Los pedidos que ya están en el ERP siguen allí.

Problemas comunesCopiar enlace de la sección

• La conexión no se completó: el ERP no aceptó el código de autorización

  El panel muestra La conexión no terminó: … con el motivo. Ese motivo quiere decir que el Client ID o el Client Secret están mal: cópialos de nuevo de la pestaña Informações do app, guarda y haz clic en Conectar a Bling.

• Después de autorizar, Bling te llevó a otra dirección

  El Link de redirecionamento de la aplicación es distinto de la URL de retorno (redirección). Pega la URL de Vipter en la aplicación, guarda en Bling y conecta de nuevo.

• La conexión no se completó: el enlace de autorización venció

  El enlace vale 20 minutos. Haz clic en Conectar a Bling de nuevo y autoriza enseguida.

• Informa el Client ID y el Client Secret de tu aplicación y guarda.

  Falta el Client ID o el Client Secret de la aplicación. Completa los dos y guarda antes de conectar.

• La tarjeta muestra Vencida

  La autorización de Bling venció. Haz clic en Reconectar y autoriza de nuevo. Los pedidos que fallen mientras tanto se reenvían después. Esto pasa cuando la aplicación se borró o se le cambió el Client Secret en Bling, o cuando el acceso se revocó. Los pedidos que agoten los nuevos intentos mientras tanto necesitan Reenviar.

• No hay ningún producto con este código en el ERP. Informa el código en Productos o enciende la creación de productos

  Bling no tiene un producto activo con el código que aparece en el error. Registra el producto en Bling o informa el código correcto en el paso 6. Después, haz clic en Reenviar.

• El pedido quedó como Falló con un mensaje de Bling

  Bling rechazó un dato, y el mensaje dice cuál, como un ID de tienda o de naturaleza que no existe en tu cuenta. Corrige el campo en el paso 5, guarda y haz clic en Reenviar.

• Errores 429, de límite de llamadas

  Bling acepta hasta 3 llamadas por segundo en cada cuenta. Vipter espera su turno entre una llamada y otra e intenta de nuevo cuando Bling le pide esperar. Si otro sistema usa mucho la misma cuenta, un pedido puede fallar así: los nuevos intentos lo resuelven solos.

• El reembolso quedó como Falló la cancelación

  Bling rechazó el cambio de situación. Revisa el ID de la situación Cancelado, o déjalo en blanco para usar la situación Cancelado, guarda y haz clic en Reenviar.

• Todavía no llegó ningún aviso. Sin avisos, Vipter consulta el ERP cada pocas horas.

  Revisa si la URL está en la pestaña Webhooks de la aplicación, con Pedido de venda y Nota fiscal activos. Bling desactiva un webhook que falla durante días seguidos: en ese caso, actívalo de nuevo allí. Si cambiaste el Client Secret, actualízalo en Vipter.

Qué hacer a continuaciónCopiar enlace de la sección

• Entiende el pedido de venta, la NF-e, el reembolso y los nuevos intentos en cómo funciona la integración con el ERP.
• Mira la tarjeta ERP en la página de un pedido en Detalle del pedido.