Guía

Cómo integrar bsale con tu sistema

Con la API de bsale, el cobro en tu sistema puede emitir la boleta electrónica en el mismo paso. Lo importante es decidir quién manda en cada dato.

bsale es uno de los sistemas de punto de venta y facturación electrónica más usados por pymes en Chile. Funciona muy bien para vender y emitir documentos, pero muchas empresas tienen además un sistema propio (una ficha clínica, un sistema de reservas, una plataforma de pedidos) y terminan digitando cada venta dos veces. La integración elimina ese paso.

Qué se puede automatizar

  • Emitir la boleta o factura automáticamente cuando se cobra en tu sistema.
  • Sincronizar productos y precios para mantener un solo catálogo.
  • Descontar stock cuando se vende o se usa un insumo en tu sistema.
  • Traer las ventas de bsale a tus reportes internos.
  • Asociar el documento tributario al cliente, la atención o el pedido que lo originó.

Cómo funciona, sin tecnicismos

bsale ofrece una API: una forma para que otro sistema le pida cosas de manera automática (“emite esta boleta”, “dame las ventas de hoy”). Tu sistema se conecta con un token de acceso que se genera desde tu cuenta de bsale. Con eso, cada vez que alguien cobra en tu sistema, este le pide a bsale que emita el documento y guarda el número y el PDF.

Lo que hay que decidir antes de programar

¿Quién manda en cada dato?

Es la decisión más importante. Por ejemplo:

  • Productos y precios: ¿se crean en bsale y tu sistema los lee, o al revés?
  • Clientes: ¿dónde se registra el RUT y la razón social?
  • Stock: ¿qué sistema tiene la cifra correcta?

Si los dos sistemas pueden modificar el mismo dato, tarde o temprano se descuadran. Cada dato debe tener un solo dueño.

¿Qué pasa si bsale no responde?

Cualquier servicio externo puede fallar por unos minutos. Un buen diseño no pierde el cobro: lo registra, deja la emisión pendiente y la reintenta automáticamente, avisando si algo queda sin emitir.

¿Cómo se anulan y corrigen documentos?

Las notas de crédito y las devoluciones deben estar contempladas desde el inicio, no como un parche.

Qué cuidar

  • No duplicar documentos. Si el sistema reintenta una emisión, debe asegurarse de no emitir dos boletas por el mismo cobro.
  • Guardar el vínculo. Cada cobro en tu sistema debe quedar asociado al documento emitido, para poder rastrearlo.
  • Proteger el token. El acceso a bsale nunca debe quedar expuesto en el navegador ni en el código compartido.
  • Conciliar. Un reporte diario que compare cobros con documentos detecta cualquier descuadre antes de que crezca.

Un caso real

En Petwild integramos la caja de la clínica con bsale: al cobrar una atención, la boleta electrónica se emite en el mismo acto, sin volver a digitar. También sumamos avisos a los clientes por WhatsApp. Si te interesa esa parte, revisa la guía de WhatsApp Business API.

¿Usas bsale y un sistema que no conversa con él? Cuéntanos qué necesitas conectar.

Conversemos tu proyecto

Por WhatsApp o por correo, directo con el equipo que construye. Escríbenos tal cual, o llena el formulario y te armamos el mensaje con lo que necesitamos saber.

+56 9 3052 8123

Lunes a viernes, 9:00 a 18:30. Fuera de ese horario, respondemos el siguiente día hábil.

¿Prefieres dejarlo por escrito? Completa esto y se abre WhatsApp con el mensaje armado. Tú decides si lo envías.

¿Prefieres contarnos todo de una vez? Llena el brief de proyecto. Unos 10 minutos.