Conexión
-
Configuración de tu conexión de Bsale en Multivende
En este artículo aprenderás a conectar tu cuenta de Bsale con Multivende y a configurar la emisión automática de boletas y facturas electrónicas para tus ventas. Con esta integración, cada venta de los canales que actives genera su documento tributario en Bsale sin pasos manuales.
ℹ️ Nota: Por el momento, la integración con Bsale está disponible solo para Chile.¿Qué encontrarás en este artículo?
¿Qué hace la integración con Bsale?
Bsale es un sistema de ventas y facturación electrónica autorizado por el SII. Al conectarlo con Multivende:
Multivende envía a Bsale los datos de las ventas de los canales que actives, para que se emita automáticamente la boleta o factura electrónica de cada pedido.
El inventario de tus sucursales de Bsale llega a tus bodegas de Multivende, en tiempo real a través de webhooks o mediante una sincronización periódica.
Puedes seguir el estado de cada documento desde el Monitor de Facturación, sin salir de Multivende.
Antes de comenzar
Necesitas una cuenta de Bsale activa y con el DTE (facturación electrónica) habilitado.
Ten a mano tu token de Bsale. Bsale te lo envía por correo al finalizar tu onboarding con ellos, y también puedes copiarlo en account.bsale.dev (te mostramos cómo más abajo). Si prefieres, puedes conectarte sin token usando OAuth con el RUT de tu comercio.
Tus canales de venta ya deben estar conectados en Multivende, con sus bodegas y listas de precios configuradas.
1. Conecta tu cuenta de Bsale
Ingresa a Multivende y ve al menú Sistemas > Bsale.
Haz clic en Nueva conexión.
-
En la ventana Conectar con Bsale, elige cómo conectarte:
Conectar: selecciona tu País, pega tu token en el campo Ingresa tu token de Bsale y haz clic en Conectar.
Conectar con OAuth: ingresa el RUT del comercio en Bsale (debe coincidir con el RUT registrado en tu cuenta Bsale) y haz clic en Conectar con OAuth. Serás redirigido a Bsale, donde debes autorizar la conexión en la ventana emergente.
ℹ️ Nota: Una vez creada la conexión, su tarjeta aparece en Sistemas > Bsale. Desde ahí accedes a su configuración y al Monitor de Facturación.2. Configura los webhooks de Bsale
Los webhooks permiten que Bsale notifique a Multivende en tiempo real los cambios de stock y precio. Es muy importante configurarlos como primer paso.
Abre la configuración de tu conexión. En la pestaña 1 General verás la Información General de tu empresa en Bsale: nombre, status, DTE, ID, nickname y país.
En la sección Notificaciones en tiempo real, copia la URL de destino (callback) con el botón Copiar.
Ingresa a tu cuenta en account.bsale.dev con tus credenciales de Bsale. En esta página también puedes copiar tu token (columna Access token).
Ve a la sección de Webhooks.
Pega la URL copiada en el campo URL de destino.
En Selecciona los recursos a notificar, marca Stock y Precio (dentro de Notificaciones Base).
En Selecciona las acciones a notificar, marca Crear y Actualizar.
Haz clic en Agregar Hook. El webhook quedará visible en el Listado de Webhooks para la empresa.
3. Configura la facturación paso a paso
La configuración de Bsale consta de 10 pasos: General, Canales, Bodegas, Precios, Atributos Custom, Despacho, Documentos, Medios de Pago, Impuestos y Vendedores. Avanza entre ellos con los botones Anterior y Siguiente.
Canales
En 2 Canales activa la facturación en cada canal de venta con su interruptor. Al activar un canal, define su Fecha de inicio de facturación.
⚠️ Importante: Multivende enviará a Bsale solo las ventas generadas desde la Fecha de inicio de facturación en adelante. Aunque se amplíe la ventana de sincronización, no se facturarán ventas anteriores a esa fecha.Bodegas
En 3 Bodegas, relaciona cada Sucursal Bsale con una Bodega Multivende usando Añadir relación. El inventario de esa sucursal de Bsale llegará a la bodega de Multivende que elijas.
ℹ️ Nota: El stock se actualiza de dos maneras: en tiempo real, a través del webhook que configuraste, y mediante una consulta automática de Multivende a Bsale cada 4 horas.Precios
En 4 Precios, relaciona cada Lista de precios Multivende (aparecen todas las que estén configuradas en algún canal de venta) con una Lista de precios en Bsale. Varias listas de Multivende pueden apuntar a la misma lista de Bsale.
⚠️ Importante: Este paso es obligatorio: Bsale exige indicar la lista de precios al momento de generar cada documento.Atributos Custom
En 5 Atributos Custom puedes alimentar los atributos personalizados creados en Bsale con campos de Multivende, por ejemplo: origen de la venta (canal), nombre, apellido, correo, RUT y teléfono del cliente, dirección, ciudad, región, país, código postal, números de orden, cantidad de ítems o costo de despacho, entre otros.
ℹ️ Nota: Este paso no es obligatorio, pero permite que esos datos aparezcan luego en la boleta o factura.Despacho
En 6 Despacho defines cómo se registrará el costo de envío en tus documentos, cuando el canal lo informe. En Tipo de ítem elige:
Texto plano (sin SKU): escribe el texto que aparecerá en el documento, por ejemplo "Despacho".
Variante de servicio Bsale: selecciona uno de los productos de servicio disponibles en tu cuenta de Bsale.
También puedes crear reglas por canal con Agregar regla; si no defines una regla para un canal, se aplica el ítem estándar.
Documentos
En 7 Documentos defines qué documento se emitirá. En Tipo de Documento a Emitir elige entre:
Boleta o Factura según lo especifique la configuración de cada canal de venta: si el pedido llega del canal indicando que el cliente pidió factura, se emite factura; si no, boleta.
FACTURA ELECTRÓNICA: todos los pedidos se emiten con factura.
BOLETA ELECTRÓNICA: todos los pedidos se emiten con boleta.
Además puedes definir reglas por canal (por ejemplo, que un canal siempre emita boleta). Si no existe regla para un canal, se usa la configuración general.
Medios de Pago
En 8 Medios de Pago seleccionas cómo registrar el pago de tus ventas en Bsale. Define un Medio de Pago Global para todos los documentos (por ejemplo, transferencia bancaria) y, si quieres, reglas por canal que lo sobreescriben (por ejemplo, que las ventas de un marketplace usen su propio medio de pago).
ℹ️ Nota: La lista muestra los medios de pago ya creados en tu cuenta de Bsale.Impuestos
En 9 Impuestos defines el Impuesto por defecto para tus boletas y facturas. Por el momento la opción disponible es IVA (19%), que aplica a la gran mayoría de los productos y servicios en Chile.
Vendedores
En 10 Vendedores asignas el Vendedor por defecto de Bsale que aparecerá en los documentos emitidos, y puedes crear reglas por canal para usar un vendedor distinto en cada uno. Al terminar, haz clic en Finalizar.
4. Revisa tus ventas en el Monitor de Facturación
Desde la tarjeta de tu conexión en Sistemas > Bsale puedes entrar al Monitor de Facturación, donde se listan las ventas de los canales con facturación activa y sus documentos tributarios electrónicos.
Usa el buscador y los filtros Desde, Hasta, Origen, Estado de documento y DTE emitido para encontrar un pedido.
En cada venta verás el canal, el cliente, la fecha, el despacho, la bodega, el monto y el Estado documento: qué documento se generó (por ejemplo, Boleta Electrónica con su folio) y si está Sincronizado con Bsale, pendiente o con error.
Desde la columna Acciones puedes abrir el documento emitido (PDF) y revisar la Bitácora del documento, el historial de sincronización con el facturador.
ℹ️ Nota: El botón Ajustar polling muestra cada cuánto Multivende busca nuevas ventas para procesar y permite mover la fecha de inicio de esa búsqueda.⚠️ Importante: Ajustar el polling mueve el punto de inicio del procesamiento: el sistema procesará las ventas desde la fecha que indiques, siempre respetando la Fecha de inicio de facturación de cada canal.Si tienes dudas o necesitas ayuda, escríbenos a través de nuestros canales de soporte y con gusto te acompañaremos.
Equipo Multivende.