Soporte

Sincroniza stock y documentos con Bsale y Jumpseller

En este tutorial, podrás ver cómo se sincroniza Bsale con 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.

Bsale Banner

Índice

  1. ¿Qué hace esta integración?

  2. Limitaciones

  3. ¿Cómo se instala?

  4. ¿Cómo se vinculan los productos?

  5. Preguntas Frecuentes

  6. Soporte


¿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 definir en ese momento el tipo


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 Packs de forma nativa, 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.

¿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:

    Crear documentos

    Crear pagos

  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. Bsale API Key

  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” en el despacho.
    • Elige el tipo de boleta: Es el documento que se generará si el cliente elige “boleta” en el despacho.
    • 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.
    • Elige el tipo de despacho: Es el documento que se generará en Bsale cuando ocurre un despacho, lo más común es una guía de despacho electrónica.
    • 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. Campos Obligatorios del Checkout para Bsale

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.

    faq

  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 y luego deberás hacer click en vincular. Con esta acción tus productos quedarán vinculados.

    faq

  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.

    faq

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.

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 importas en 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.

  • 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 Configuración 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.

    faq

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

    Flujo Stock

  • 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 y tienes seleccionada la casilla Precio, 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.

    Bsale Precio Lista de Precios

  • ¿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.

    Bsale Stock Tomado

  • 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.

    Bsale Tipo Documento

  • 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.


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.