Integrar Shopify con Bsale y el SII sin digitar nada

Una venta entra a tu tienda Shopify a las 23:40. Al día siguiente alguien abre el pedido, copia los productos y montos en Bsale, emite la boleta, la envía por correo y ajusta el stock a mano. Multiplícalo por 60 pedidos diarios y son unas dos horas diarias de alguien copiando datos de una pantalla a otra. Integrar Shopify con Bsale y el SII elimina ese paso: el pedido pagado genera su documento tributario electrónico solo, el inventario se descuenta donde corresponde y nadie transcribe nada.

Esta guía explica qué se conecta exactamente, qué decisiones hay que tomar antes de escribir una línea de código y cuándo conviene una app enlatada frente a una integración a medida.

Qué significa integrar Shopify con Bsale y el SII

Shopify no emite documentos tributarios en Chile. No es un facturador autorizado y su checkout estándar no pregunta RUT ni giro. Bsale sí: es punto de venta y software de facturación electrónica autorizado por el SII, con el que tu empresa emite los DTE bajo su propio RUT. Tiene API pública documentada y un listado de integradores externos que Bsale publica como referencia, no como recomendación.

Integrar los dos significa poner una capa que escucha lo que pasa en Shopify y lo traduce a operaciones en Bsale. Cuando un pedido queda pagado, esa capa toma los datos, decide si corresponde boleta o factura, la emite en Bsale, guarda el número del DTE de vuelta en el pedido y descuenta el stock. El SII queda al medio: es Bsale quien reporta el documento, pero la calidad del dato que llega depende enteramente de la integración.

La regla mental es simple: Shopify manda la venta, Bsale manda el documento y el inventario, y la integración es el traductor entre ambos.

Los tres flujos que hay que conectar

No es una conexión, son tres. Y se rompen por separado.

1. Pedido pagado → documento tributario

Es el flujo obvio y el que más ahorra tiempo. Shopify avisa por webhook que un pedido quedó pagado; la integración arma el detalle —productos, cantidades, descuentos, despacho, impuestos— y pide a Bsale que emita el DTE.

El punto delicado es el despacho: el costo de envío también va en la boleta y muchas integraciones improvisadas lo omiten, lo que deja el total del documento distinto al total cobrado. Ese descuadre aparece meses después, en el cierre.

2. Stock: quién es la fuente de verdad

Si vendes solo online, Shopify puede llevar el stock. Si además tienes tienda física o vendes por WhatsApp, la fuente de verdad debería ser Bsale, porque ahí se registran todas las salidas. La integración entonces empuja el stock de Bsale hacia Shopify cada pocos minutos.

Elegir mal esta dirección es la causa más común de sobreventa: dos canales descontando del mismo inventario sin hablarse. Lo tratamos en detalle en la guía sobre automatizar el inventario en retail y eCommerce.

3. Catálogo y precios

Crear el producto una sola vez y que aparezca en ambos lados. Suena menor hasta que un producto existe en Shopify con un SKU y en Bsale con otro: ahí la integración deja de encontrar el ítem y los pedidos empiezan a fallar en silencio.

Boleta o factura: el dato que se pierde en el checkout

Este es el problema chileno específico y el que ninguna documentación internacional te va a resolver.

El checkout de Shopify pide nombre, correo y dirección. No pide RUT, ni giro, ni razón social. Para emitir una factura electrónica necesitas los tres. Hay tres formas de conseguirlos:

• Campos adicionales en el checkout. Una casilla “necesito factura” que despliega RUT, razón social y giro. Es lo más limpio: el dato llega junto con el pedido y no hay ida y vuelta.
• Formulario posterior. El cliente pide la factura por correo y alguien la emite después. Funciona con volúmenes bajos, pero reintroduce el trabajo manual que estabas eliminando.
• Boleta por defecto y nota de crédito si piden factura. Es la peor opción: multiplica documentos y ensucia la contabilidad.

Además hay que validar el RUT antes de emitir, no después. Un dígito verificador mal escrito rechaza el DTE en el SII y deja el pedido a medio camino: cobrado, sin documento y con el stock ya descontado. La validación en el checkout cuesta poco y evita ese estado inconsistente. Si te interesa el detalle normativo de la emisión, lo cubrimos en la guía sobre boleta electrónica por medios digitales.

App conectora, middleware o integración a medida

Hay tres caminos y la diferencia real no es el precio, es hasta dónde llega cada uno.

Si vendes solo boletas, con una bodega y un catálogo simple, empieza por una app. Es lo más barato y resuelve la mayor parte del trabajo manual. Nadie debería pagar un desarrollo para algo que una suscripción cubre.

La integración a medida se justifica cuando aparecen las excepciones: factura B2B, varias bodegas, packs que descuentan tres SKU distintos, un marketplace además de la tienda propia, o una regla contable que solo existe en tu empresa. Ahí las apps se quedan cortas y la alternativa suele ser volver a la digitación para los casos que no cubren — que es exactamente el problema original. El mismo criterio aplica cuando el ERP entra en juego: si además de Shopify necesitas que la contabilidad viva en Defontana, revisa la guía de integrar Bsale y Defontana por API, que cubre el lado ERP de esta misma cadena. En Softdigital construimos esta capa como software a medida con precio fijo definido antes de empezar, y el código queda en tu repositorio.

Qué revisar antes de conectar nada

La mitad de las integraciones que fallan no fallan por código. Fallan porque los datos no estaban listos. Antes de conectar:

1. Facturación electrónica habilitada en Bsale y activa en el SII, con folios (CAF) vigentes y suficientes. Sin folios, la integración funciona y los documentos no salen.
2. SKU únicos y coincidentes entre Shopify y Bsale. Un solo código repetido basta para desalinear el stock.
3. Bodega definida. Cuál descuenta las ventas online y qué pasa si queda en cero.
4. Tipo de documento por defecto y qué gatilla la factura.
5. Tratamiento del despacho como línea del documento.
6. Flujo de devoluciones: quién genera la nota de crédito y cómo vuelve el stock.
7. Qué hace el sistema cuando algo falla: reintentos, alerta a una persona, y un pedido marcado como pendiente en vez de perdido.

Ese último punto separa una integración seria de un script. Toda integración se cae alguna vez —la API del proveedor responde lento, el SII no está disponible, el RUT viene malo—. Lo que importa es que el sistema reintente con idempotencia: si el pedido ya tiene DTE, no emite un segundo documento. Boletas duplicadas son un problema tributario, no un bug.

Cuánto se recupera realmente

Con 60 pedidos diarios y un par de minutos de digitación por pedido, hablamos de dos horas diarias que desaparecen. En automatizaciones de este tipo el rango habitual es reducir entre 60% y 80% del tiempo dedicado a la tarea, y el resto queda en revisar excepciones: pedidos con RUT inválido, devoluciones, casos que la regla no contempla.

Pero el ahorro de tiempo no suele ser lo que más pesa. Lo que cambia la operación es que el stock deja de mentir y que el cierre mensual deja de empezar con una semana de cuadratura. Cuando cada venta genera su documento en el momento, el Registro de Compras y Ventas del SII cuadra solo.

Si además vendes en más de un canal, el patrón se repite: la integración deja de ser un puente entre dos sistemas y pasa a ser la capa que ordena toda la operación de retail y eCommerce. Y si la tienda además está lenta, conviene mirar la velocidad de carga y su efecto en la conversión antes de invertir en más tráfico.

Por dónde partir

No partas por el código. Parte por escribir en una hoja qué pasa hoy, paso a paso, desde que entra el pedido hasta que el cliente recibe su boleta. Ese mapa muestra dónde está el trabajo manual real, y casi siempre revela que el problema no era Shopify ni Bsale, sino una decisión que nunca se tomó: qué documento se emite, qué bodega descuenta, qué se hace con las devoluciones.

Con ese mapa, elegir entre una app y un desarrollo a medida toma quince minutos.

Si quieres ayuda para armarlo, agenda un diagnóstico gratuito de 15 minutos: revisamos tu flujo actual, te decimos con franqueza si una app te resuelve el problema, y si hace falta desarrollo, te llega una propuesta con precio fijo en menos de 24 horas.