Sincronización de Jumpseller y Bsale

Bsale es un sistema de gestión de ventas líder en Chile que permite centralizar el control de inventario, reportes y la emisión de documentos tributarios electrónicos (DTE).

Al integrar Bsale con Jumpseller, estableces un ecosistema donde Bsale actúa como la única fuente de verdad. Esto significa que el stock, los precios y los impuestos se gestionan en Bsale, y Jumpseller se encarga de reflejar esa información en tu tienda online y capturar las ventas.

Ventajas de la integración profesional

Muchos negocios migran su ecommerce a Jumpseller buscando una comunicación infalible con Bsale. Esta unión resuelve los desafíos operativos más comunes:

• Sincronización de Inventario: Evita ventas de productos sin stock real. Jumpseller consulta la disponibilidad en Bsale antes de confirmar un pedido.
• Gestión B2B Simplificada: Cuando activas la solicitud de factura en el checkout, se emite boleta o factura según los datos que completa el cliente. Esta opción no viene activada por defecto.
• Precisión Tributaria: Al delegar el cálculo de IVA a Bsale, te aseguras de que cada DTE cumpla estrictamente con la normativa vigente.
• Automatización de Procesos: Los documentos se generan y asocian a la orden sin intervención manual.

Sobre los tiempos de sincronización

La comunicación entre Bsale y Jumpseller está diseñada para ser instantánea, funcionando a través de eventos en tiempo real. Sin embargo, para garantizar la integridad total de tus datos, contamos con un sistema de respaldo:

• Sincronización en Tiempo Real: Cada vez que ocurre una venta o un cambio de stock en Bsale, se envía una notificación inmediata a Jumpseller para actualizar la tienda.
• Procesos de Respaldo (Backup): Como medida de seguridad, el sistema ejecuta procesos automáticos (Crons) en intervalos definidos. Estos procesos validan que el stock en Jumpseller coincida exactamente con Bsale, corrigiendo cualquier discrepancia que pudiera haber surgido por caídas de conexión o latencia en la API.
• Validación de Integridad: El sistema no solo copia el dato, sino que verifica que el SKU sea correcto antes de aplicar cambios. Debido a estos procesos de validación y colas de procesamiento en eventos masivos (como CyberDays), algunos cambios específicos podrían reflejarse desde unos minutos después hasta el día siguiente.

Preparación en la plataforma Bsale

Antes de activar la aplicación en Jumpseller, debes configurar tu cuenta de Bsale para recibir los datos:

1. Documentos: Define tus folios para Boleta y Factura Electrónica.

1. Pagos: Crea un método de pago (ej: “Ecommerce”) para identificar las ventas web en tus reportes.

1. API Key y Webhooks: Solicita tu API KEY a ayuda@bsale.app. Pide también que registren la URL de notificaciones: https://app.jumpseller.com/bsale/notifications.

Configuración en Jumpseller

Una vez tengas tus credenciales de Bsale, sigue estos pasos para conectar tu tienda:

1. Instalación: Instala la App de Bsale en tu panel de Jumpseller e ingresa tu API Key.

1. Configuración de la App: Completa la ubicación, la lista de precios, el tipo de boleta, el tipo de factura, el medio de pago y el tipo de nota de crédito. Si la app emite documentos, los cuatro últimos son obligatorios: si tu cuenta de Bsale no tiene un tipo de nota de crédito, créalo en Bsale antes de continuar. Solo puedes elegir un medio de pago por configuración, así que elige el que más usan tus clientes.
2. Activación de RUT: Ve a Configuración > Checkout > Formulario y habilita el campo RUT. Jumpseller validará automáticamente el formato y dígito verificador.
3. Versión de Checkout: En la misma sección, confirma que estás utilizando la versión Estándar.

Seguimiento de Documentos y Automatización de Correos

Una vez que se genera un pedido, podrás visualizar el estado del documento tributario directamente en el detalle de la orden dentro de tu Panel de Jumpseller. Esto te permite confirmar en tiempo real si la boleta o factura se emitió correctamente en Bsale.

Optimización de notificaciones al cliente

Cuando el documento queda registrado en la orden, todas las comunicaciones automáticas posteriores (como el correo de Pedido Enviado) incluirán una copia del DTE.

Para una experiencia óptima y profesional, te recomendamos lo siguiente:

• Evita duplicidad: Desactiva el envío de documentos por correo desde el panel de Bsale. Jumpseller se encargará de centralizar esta comunicación, evitando que tu cliente reciba dos correos por la misma compra.
• Plantillas de Jumpseller: Esta automatización funciona correctamente siempre que utilices las versiones predeterminadas (o no modificadas estructuralmente) de los correos electrónicos en Jumpseller.

Sincronización de packs

Puedes vincular un pack de Bsale con un Pack de Productos de Jumpseller. El vínculo es siempre entre un pack y un Pack de Productos: si intentas vincular un pack con un producto normal, o un Pack de Productos con un producto normal de Bsale, la app muestra un error.

La importación inicial no crea Packs de Productos en Jumpseller a partir de los packs de Bsale. Los packs se cargan en la app para que puedas vincularlos, pero el Pack de Productos lo creas tú en Jumpseller.

Pasos para vincular un pack

1. Sincroniza todo el catálogo desde la app de Bsale, para que los productos que forman el pack estén importados.
2. Revisa los componentes: cada producto del pack debe existir en Jumpseller y estar vinculado con Bsale.
3. Crea el Pack de Productos en Jumpseller con esos componentes. Debe tener exactamente un componente por cada producto del pack de Bsale.
4. Vincula el Pack de Productos con el pack de Bsale, de forma automática o manual:
   • Automática (por SKU): si el SKU del Pack de Productos es igual al SKU del pack en Bsale, la app los vincula al importar o al actualizar el producto. Los componentes también se vinculan por SKU con los productos del pack.
   • Manual: en Sincronizar productos, elige el Pack de Productos y el pack de Bsale. La app muestra los componentes del Pack de Productos y eliges, para cada uno, el producto del pack que le corresponde. En este caso los SKU no necesitan coincidir.

Al vincular un pack, ten en cuenta que:

• Las cantidades de cada componente las define Bsale: las que configuraste en Jumpseller se reemplazan por las del pack.
• Si un componente ya estaba vinculado con otro producto de Bsale, ese vínculo se reemplaza por el del producto del pack.
• Si un componente tiene variantes (talla, color, etc.), el Pack de Productos debe usar una variante específica. Si apunta al producto sin elegir variante, el pack muestra stock 0.

Cómo funcionan el stock y los documentos

• Stock: la app no lee el stock del pack en Bsale. Lo calcula a partir de sus componentes en la ubicación configurada: es la cantidad de packs completos que alcanzas a armar con el componente más limitado. Si todos los componentes tienen stock ilimitado, el pack también. Los componentes siguen sincronizando su stock como siempre.
• Boletas y facturas: el documento muestra el pack en una sola línea, no cada componente por separado. El precio de esa línea es la suma de lo que se cobró por sus componentes, con descuentos incluidos.

Limitaciones

• Packs con componentes sin variante definida: si un producto del pack no tiene una variante fija en Bsale, el vínculo falla. Ajusta el pack en Bsale para que cada componente use una variante específica.
• Cambios en el pack: si cambias los componentes o las cantidades del pack en Bsale, la app intenta actualizar el vínculo y las cantidades en Jumpseller. Si no lo logra, marca el producto con un aviso de componentes desalineados: revisa el Pack de Productos y vuelve a vincularlo.
• Packs armados como producto normal: si antes vendías un pack como un producto normal con su propio SKU, créalo de nuevo como Pack de Productos. Así el stock se descuenta de los componentes y no dos veces.

Preguntas Frecuentes

¿Dónde debo actualizar mis precios, stock e impuestos? Siempre en Bsale. Como es tu fuente de verdad, cualquier cambio manual en Jumpseller será sobrescrito por los datos de Bsale en la próxima sincronización. No configures impuestos manualmente en Jumpseller.

¿Puedo sincronizar packs? Sí. Un pack de Bsale se vincula con un Pack de Productos de Jumpseller. Revisa los pasos en Sincronización de packs.

Agregué una variante nueva y no se sincroniza, ¿qué hago? La integración vincula los productos por SKU, así que la variante no se vincula sola. Crea en Bsale un producto con el mismo SKU de la variante y luego usa Sincronizar productos en la app de Bsale.

¿Puedo sincronizar productos serializados? No. La integración no soporta productos con series. Se recomienda utilizar SKUs para productos simples.

¿Qué ocurre si un cliente pide retiro en tienda? Para evitar errores de emisión por falta de datos, debes activar la solicitud de información de facturación para retiros en Configuración > General > Formulario.

¿La integración tiene algún costo? La integración es gratuita para tiendas con plan Pro o superior. Las tiendas con planes Basic y Plus pueden utilizar la integración mediante un costo mensual adicional, el cual se mostrará antes de instalar la integración en tu tienda.

Soporte Técnico

• Problemas con la API o Stock en Bsale: Contacta a ayuda@bsale.app.
• Problemas con la App en Jumpseller: Escribe a nuestro equipo de soporte especializado.