Sincroniza stock y documentos con Bsale y Jumpseller

Bsale es un software de ventas que ayuda a ordenar y apoyar el crecimiento de pymes con distintos planes que incluyen: control de inventario, reportes de ventas en línea, POS y documentos tributarios electrónicos (DTE), como boletas y facturas.

---

¿Qué hace esta integración?

Sincroniza el stock de los productos desde Bsale hacia Jumpseller. En caso de haber una compra en Jumpseller, el stock de los productos vendidos se actualiza en Bsale. En caso de haber un cambio en el stock en BSale, los productos en Jumpseller serán actualizados con este nuevo stock.

Genera facturas o boletas de los pedidos realizados en Jumpseller. Puedes configurar que sea automático o generar los documentos manualmente luego de cada orden creada en tu tienda.

---

Limitaciones

• Aparecerán los campos opcionales Giro y Razón Social en la sección Otros del Formulario de Checkout. Estos campos no admiten cambios y siempre serán visibles.
• Aparecerá el campo obligatorio “Tipo de Documento” con las opciones “boleta” y “factura” en la sección Otros del formulario de Checkout. Este campo no admite cambios.
• Para la generación de DTE, el sistema asumirá que los productos incluyen IVA. La sección de Impuestos de tu Panel de Administración es incompatible con esta integración, no debes añadir impuestos en esta sección.
• El campo RUT debe ser activado manualmente en tu Panel de Administración: Configuración > Checkout > Identificador Fiscal. Se recomienda marcarlo como campo obligatorio.
• El campo RUT aparecerá en la dirección de envío y dirección de facturación del checkout, no se puede cambiar de posición.
• El campo RUT no será validado por defecto, puedes insertar este script en tu Panel de Administración: Temas > Editor de Código > Pagos > Checkout para validarlo.
• Para ocultar o mostrar los campos razón social y giro en función del tipo de documento, puedes utilizar el mismo script y activar la sección comentada.
• Sólo se generará un DTE si todos los productos de la compra se encuentran sincronizados
• Si se generó un DTE con información de facturación errónea (RUT, Giro o Razón Social), no se podrá corregir desde Jumpseller.
• La sincronización de stock en productos vinculados no es instantánea, puede tardar desde minutos a un día.
• Jumpseller no soporta de forma nativa productos de tipo packs, por lo tanto la integración con Bsale no soporta sincronización de packs. Es decir, si tienes un producto “pack”, al ser comprado en Jumpseller, el stock de los productos que lo componen no se actualizará en Bsale.
• Sólo se permite conectar una tienda de Jumpseller a una única sucursal en Bsale. Si conectas dos tiendas de Jumpseller a la misma sucursal de BSale, sólo se sincronizará una de estas dos tiendas.
• Esta integración no soporta productos con series, solo podemos sincronizar productos con variantes en BSale sin serie.

---

¿Cómo se instala?

1. Debes contar con el plan Pro o Premium en Jumpseller y el plan estándar en Bsale, ya que es necesario para poder sincronizar stock.

2. Debes tener una cuenta con Bsale. En caso de que aún no la tengas puedes ir a su sitio.

3. Una vez estés en Bsale, debes crear los documentos y tipos de pagos que deseas sincronizar (esto en caso de que no estén creados aún). Puedes ver las imágenes como ejemplo:

   

4. Ahora, debes pedir a Bsale el API KEY de tu cuenta. Para ello, debes escribir a su soporte: ayuda@bsale.app

5. Solicita a ayuda@bsale.app que agregue la URL: https://jumpseller-apps.herokuapp.com/bsale/notifications para que reciba los webhooks de tu cuenta.

6. En Jumpseller, ingresa tu API KEY en el campo indicado.
7. Haz click en el botón Configurar y ajusta tus preferencias de acuerdo a esta pequeña guía:
   • Elige el tipo de factura: Es el documento que se generará si el cliente elige “factura”.
   • Elige el tipo de boleta: Es el documento que se generará si el cliente elige “boleta”.
   • Elige el tipo de pago: Esto es para control interno en Bsale. Te recomendamos que crees un tipo de pago llamado “Tienda Web” o similar para que puedas identificar de dónde proviene el pago.
   • Elige el tipo de nota de crédito: Es el documento que se generará en caso de que canceles un pedido.
   • En tu Panel de Administrador: Configuración > Checkout deberás activar el Identificador Fiscal y (opcionalmente) hacerlo obligatorio. Verás que aparecerán tres campos: Boleta o Factura, Giro y Razón Social. No debes modificar estos campos, ya que si cambias el nombre o la posición, tu aplicación no generará facturas ni boletas.

Revisa el video tutorial para apoyarte si es necesario.

---

¿Cómo se vinculan los productos?

El primer paso es siempre agregar tus productos en Bsale. Luego, agrega tus productos en Jumpseller con el mismo SKU de Bsale. Finalmente, espera a que el sistema vincule automáticamente tanto el producto de Bsale como de Jumpseller.

También tienes la opción de ingresar a la aplicación de Bsale y hacer click en el botón: “Sincroniza manualmente tus productos”. Tendrás tres opciones de vinculación:

1. Mediante SKU: Este método vinculará tus productos de Bsale con tus Productos de Jumpseller utilizando el SKU. Es decir, si tienes un producto en Bsale con el SKU XXXX01 y en Jumpseller un producto tiene el SKU (o Núm. de Ref.) XXXX01, entonces quedarán vinculados. Si existen varios productos en Jumpseller con el mismo SKU, entonces estos no serán vinculados con este método, sólo podrás hacerlo de forma manual.

   

2. De forma manual: En la lista de la izquierda verás todos tus productos de Bsale de la sucursal seleccionada. En la lista de la derecha podrás seleccionar manualmente el producto y la variante correspondiente en Jumpseller y luego deberás hacer click en vincular. Con esta acción tus productos quedarán vinculados.

   

3. Mediante Importación: Este método importará todos los productos que tienes en Bsale hacia tu tienda Jumpseller. Sólo se importará el nombre, precio, stock y serán creados con el estado Deshabilitado. Se creará una categoria de productos en tu tienda Jumpseller, llamada “Bsale”. Bajo es categoría quedarán todos los productos importados de manera que puedas identificarlos más fácilmente.

   

Se importarán y mostrarán todos los productos que tienes en Bsale. Aquellos que no pertenezcan a la sucursal seleccionada estarán deshabiltiados con stock 0, tambien productos inactivos o eliminados en Bsale. En caso de que los actives en la sucursal seleccionada, se activarán en tu tienda de Jumpseller.

¿Cómo revisar por qué no se generó el documento correspondiente para una orden?

En ocasiones puede ocurrir, que luego de haberse marcado una orden como pagada de manera exitosa en tu tienda virtual, no se genera el documento correspondiente (boleta o factura).

Para conocer qué pudo haber producido esto, puedes revisar los detalles de cada documento en la siguiente opción:

Podrás detectar errores muy comunes como el de productos no sincronizados (ver imagen). En este caso podrás sincronizar los productos y reintentar emitir el documento en esa misma opción.

Preguntas frecuentes

• ¿Esta integración está disponible en todos los planes?

  No, solamente está disponible para el plan Pro y Premium. Puedes ver nuestros planes aquí.

• ¿Cuando hago una venta en mi tienda de Jumpseller, se creará una factura o boleta?

  Cada vez que una venta se realice en tu tienda de Jumpseller tu cliente podrá elegir si quiere boleta o factura, estos datos serán enviados a Bsale para hacer la creación del documento como corresponde.

  Importante: esto solamente funcionará si activas la casilla creación de documento cuando configuras la app de Bsale en Jumpseller.

• ¿Dónde debo actualizar el stock y precio de mis productos?

  Debes tener en cuenta que tanto los precios como el stock de los productos deben ser actualizados en Bsale directamente. Si se realiza cualquier cambio manual de stock o precio desde el Panel de Administración de Jumpseller, la API lo va a sobreescribir al poco tiempo con la información que está en Bsale.

• El stock Stock de uno (o más) de mis productos no se encuentra sincronizado ¿Qué debo hacer?

  Primero deberás verificar que la sucursal con la que estás sincronizando tus productos es la correcta. Para hacerlo ingresa a la opción de configuración de la app y, si se encuentra otra sucursal seleccionada, elige la correcta y haz click en guardar. Luego deberás sincronizar automáticamente todos los productos. Si esto no resuelve el problema, verifica que los productos se encuentren vinculados en la lista de productos sincronizados. Si éstos no se encuentran vinculados, deberás realizar la conexión como se indican en este articulo.

  Si los productos se encuentran vinculados, pero aún existe una diferencia de stock, confirma con Bsale que se están enviando los webhooks a tu tienda como se indica en el paso número cuatro de este artículo. Si el webhook se encuentra configurado en Bsale y aún así existe una diferencia de stock, puedes forzar una actualización haciendo click en “Sincronizar Automáticamente” y contactar a nuestro soporte indicando el SKU y nombre de por lo menos un producto afectado.

• ¿Qué pasa cuando un producto tiene marcada la opción venta sin stock en Bsale?

  Si marcas la casilla de Pre-Venta en las opciones de creación de documento, los productos en Bsale que permitan ventas sin stock serán definidos como productos con stock infinito en Jumpseller. Si no la marcas, tus productos en Jumpseller no podrán ser vendidos si no tienen stock.

  

  Revisa este diagrama que explica el flujo de la sincronización considerando las opciones “Venta Sin Stock” y “Pre-Venta”:

  

• En la configuración, ¿qué pasa si selecciono “Precio”?

  Este campo hace referencia al valor en Bsale. Si está seleccionado, significa que el precio de Bsale será actualizado y sobreescribirá el valor en Jumpseller. Si el precio de un producto es modificado de forma manual en el panel de administrador de tu tienda y tienes seleccionada la casilla precio en la configuración de la app de Bsale, el valor del producto se actualizará automáticamente luego de unos minutos al precio de Bsale. Es importante también mencionar en este punto que se debe seleccionar la lista de precios correspondiente.

  

• ¿Puedo ocultar los campos opcionales Giro y Razón Social si es que el cliente selecciona Boleta como tipo de documento?

  Es posible insertar un código Javascript que genere esa mecánica.

• Mi aplicación Bsale - Jumpseller tiene un mensaje: Tu tienda no está recibiendo actualizaciones desde Bsale ¿Qué significa?

  Esto quiere decir que tu tienda no ha recibido una notificación desde Bsale en algún tiempo. Una notificación ocurre cuando existe un movimiento de stock relacionado a un producto vinculado dentro de Bsale. Si tu tienda está conectada con Bsale, luego del primer movimiento de stock en esa plataforma el mensaje desaparecerá.

• Hice una importación pero no aparecen todos los productos en mi tienda

  Puedes buscar por SKU en tu Panel de Administración: Productos > Todos los Productos. Si no encuentras productos que están en BSale que deberían estar en tu tienda de Jumpseller, envíanos el SKU del producto y el nombre de tu tienda a nuestro canal de soporte.

• No se están sincronizando los Packs

  Jumpseller no soporta la creación de Packs de forma nativa. Entendemos por Pack “un producto que al ser comprado, descuenta el stock de otros productos”. Si tienes un Pack en un servicio externo, éste no se sincronizará con tu tienda.

• ¿Qué significa el stock entre paréntesis que aparece en la sección de Jumpseller dentro de Bsale?

  Esto significa que hay pedidos pendientes que tienen tomado el stock en Jumpseller.

  

• Recibí el error “< Nombre del producto > no está sincronizado”

  Este es un problema bastante recurrente, pero la forma de solucionarlo es sencilla. Sólo debes sincronizar el producto en cuestión y hacer click en “Reintentar”.

• El sistema está pidiendo un RUT a mi cliente para una boleta electrónica

  Esto puede suceder porque en la configuración de Bsale se seleccionó el tipo de boleta incorrecto (por ejemplo: factura electrónica). Es muy importante que se seleccionen los tipos de documentos correspondientes para evitar este problema.

  

• Estoy recibiendo errores asociados con el stock

  Por ejemplo: “Error en Bsale: The quantity returned (10.0) is higher than the available (0.0) for detail: 91268”, “Error en Bsale: insufficient stock” o errores similares.

  Este tipo de errores se pueden deber a diversas razones. Te recomendamos enviar un correo a support@jumpseller.com con la mayor cantidad de detalles posible y nosotros lo canalizaremos con el equipo de aplicaciones.

• Tengo un pedido que tiene un producto de valor cero. ¿Qué pasa?

  Si su pedido solo tiene 1 producto y tiene un valor cero, entonces no se creará un documento en Bsale porque Bsale no acepta pedidos que solo tengan productos con un valor cero.

  Si su pedido tiene muchos productos y algunos de ellos tienen el valor cero, entonces solo el producto con el valor cero será eliminado del documento que se generará.

• ¿Qué pasa con el inventario de estos productos de valor cero?

  El cliente deberá reducir el número de stock directamente en la plataforma Bsale.

• ¿Puedo conectar más de una sucursal de Bsale a mi tienda Jumpseller?

  No, sólo es posible conectar a una sola sucursal tu tienda.

• No aparecen los productos de Bsale para sincronizarlos manualmente dentro de la App ¿Qué ocurre?

  Asegúrate de que la App esté conectada con la sucursal correcta de Bsale. Recuerda que la sincronización sólo se hace hacía una sucursal.

• No pude emitir una factura con la integración, me aparece el siguiente error: Error en Bsale: Use ‘comment’ to specify the serie of detailId to dispatch.

  Esta integración no soporta productos con series, solo podemos sincronizar productos con variantes en BSale sin serie. En este caso debes generar el documento manualmente en Bsale y liberar el stock pendiente en Jumpseller también de manera manual.

  

---

Soporte

• Si tienes preguntas con respecto a Bsale y su servicio puedes comunicarte directamente a: ayuda@bsale.app

• Si tienes alguna pregunta con respecto a la APP o la integración en sí misma, puedes contactar a nuestro soporte.

---

Para obtener información actualizada sobre el estado de nuestro sistema y todos sus servicios, por favor visite status.jumpseller.com. También puede suscribirse para recibir notificaciones sobre cualquier actualización o mantenimiento del sitio