Bsale emite tus boletas. No lleva tu operación.
El punto de venta, el inventario y el documento tributario ya están resueltos, y ya los estás pagando. Esta página es sobre la línea donde esa cuenta se detiene, y qué se puede construir al otro lado sin tocar nada de lo que hoy funciona.
La parte difícil ya la hace, y la hace bien.
Emitir un documento tributario válido en Chile no es un problema de software: es un problema de cumplimiento, y se resuelve una vez. Si ya lo tienes resuelto, no hay ninguna razón para volver a resolverlo.
- La boleta y la factura electrónica, con sus impuestos, sus referencias y sus notas de crédito.
- El inventario y el stock por sucursal, con sus variantes y sus listas de precio.
- Los clientes, con sus contactos, sus direcciones y sus puntos.
- Los documentos y los resúmenes de venta, consultables por fecha, por folio y por sucursal.
- Un ambiente de pruebas propio, sin límite de tiempo, para no ensayar sobre la contabilidad real.
Todo lo de arriba tiene su propia ruta en la API y se puede leer desde afuera. El trabajo, entonces, no está en los datos: está en lo que nadie puede ver con ellos.
Cinco cosas que conviene saber antes de planificar.
Ninguna es un defecto. Son las decisiones de un sistema que resuelve la venta y la boleta, y que no pretende resolver tu operación completa. El problema es descubrirlas a mitad del proyecto.
Cuatro detalles que cuestan una tarde cada uno.
Nada de esto aparece en una presentación comercial, y los cuatro están en su documentación oficial. Son el tipo de cosa que separa una integración que aguanta de una que hay que vigilar.
Cinco cosas, y la contabilidad no se toca.
Una base propia con sus mantenedores, para el estado de tu proceso, la observación de quien atendió o el campo que tu rubro necesita. Se cruza con el dato de Bsale por identificador y sale como si fuera uno solo.
No el resumen de ventas que ya viene, sino lo que tú revisas un lunes a primera hora, que casi nunca es lo mismo que revisa la empresa de al lado. En solo lectura, así nada se rompe desde ahí.
Que cada cliente entre con su clave y vea sus documentos, su historial y su estado de cuenta, en tu dominio y con tu marca. Leyendo de Bsale, sin que nadie tenga que mandar un PDF por correo.
Que la venta de tu sitio emita el documento en Bsale en el momento, en vez de que alguien lo repita a mano al día siguiente. Con control de duplicados, que su API soporta por un identificador de venta propio.
Stock en cero, un documento grande, una venta de un producto que querías seguir. Al correo, a Slack, a Telegram o a WhatsApp, con una revisión periódica debajo por si el aviso no llega.
De su documentación, no de una promesa.
Todo lo que dice esta página sale de la documentación oficial de Bsale, leída el 21 de noviembre de 2026. Las secciones que no alcanzamos a leer no se afirman: no vamos a cotizar contra algo que no verificamos.
La arquitectura, en cambio, sí es trabajo propio, solo que sobre otra plataforma: una tienda chilena que corre con el sitio por delante y su sistema de siempre por detrás, con el pago en el propio sitio desde febrero de 2026. Está en la ficha del proyecto. Lo que cambia entre una plataforma y otra es qué expone su API; lo que no cambia es que el sistema se queda donde está.
¿Bsale tiene API?
Sí. La base es api.bsale.io y las rutas van bajo /v1, con algunas bajo /v2. El token viaja en una cabecera llamada access_token, sin la palabra Bearer delante, y su documentación aclara que el token «es único para cada usuario». Hay un ambiente de pruebas con cuenta propia y sin límite de tiempo.
¿Se puede emitir una boleta desde mi sitio web?
Sí. Los documentos se crean con un POST a /v1/documents.json. Hay dos advertencias que su propia documentación marca y que conviene tomar en serio: el valor unitario neto no admite números negativos porque el SII los rechaza, y los impuestos hay que enviarlos por cada línea del detalle, porque si no, esa línea sale exenta.
¿Bsale avisa cuando cambia el stock?
Sí, por webhooks. Bsale manda un POST a la dirección que definas, con el recurso, su identificador, el tema y la acción. Los temas de productos incluyen producto, variante, precio y stock. Hay un detalle operativo importante: el registro no es automático, se pide por correo al soporte de Bsale indicando la dirección y el RUT de la empresa.
¿Puedo agregar un campo que Bsale no tiene?
No en Bsale, y por eso se construye al lado. El dato nuevo vive en una base de datos propia, con un mantenedor para que lo cargue tu equipo, y se cruza con el dato de Bsale por su identificador. Bsale sigue siendo la fuente de verdad de lo suyo: productos, stock, clientes y documentos tributarios.
¿Se puede borrar un producto por API?
No del todo, y es mejor saberlo antes de diseñar nada. Su documentación dice que «en Bsale no es posible borrar un producto, sólo se desactiva», y lo mismo pasa con los clientes: al darlos de baja, «sus documentos asociados NO se eliminarán». Cualquier sincronización tiene que tratar la baja como un estado, no como una desaparición.
Trae tu cuenta, y el dato que no te deja guardar.
Veinte minutos suelen bastar para saber si es un desarrollo, una opción que nadie activó, o algo que mejor no hagas.