¿Bsale tiene una API pública?
Sí. Bsale documenta su API REST para Chile, Perú y México, con una cuenta de pruebas para desarrollar. El token de producción se pide a Bsale o se obtiene con OAuth 2.0.
Guía · Integraciones con ERP
¿Cómo integrar HubSpot con Bsale?
La ruta más directa es la API REST de Bsale, que está documentada y avisa por webhooks cuando se emite un documento o cambia el stock; también puedes usar un middleware o un intercambio de archivos. Lo típico es que el negocio ganado en HubSpot cree la nota de venta o el documento en Bsale, y que la factura vuelva con su folio y su PDF. Antes de comprometer, revisa tu acceso a la API, sus límites y qué documentos emites en Chile, Perú o México.
- 6 minutos de lectura
- API REST de Bsale
- Webhooks de documentos
- Chile y Latinoamérica
Del negocio ganado a la factura
- Negocio ganado en HubSpot
Cliente con RUT, productos con su código de variante y condiciones de pago.
- Documento en Bsale
La API crea la nota de venta o el documento electrónico y lo declara al SII si se indica.
- Webhook de documento
Bsale avisa a una URL de la integración cada vez que se emite un documento.
- Factura de vuelta en HubSpot
Folio, monto, PDF y estado en el negocio y la empresa.
¿Qué permite la API de Bsale?
Bsale publica una API REST documentada para Chile, Perú y México. Cada llamada lleva un token de acceso en el encabezado; puedes desarrollar en una cuenta de pruebas, y el token de producción se pide a Bsale o se obtiene con OAuth 2.0 si registras tu integración. Las respuestas vienen paginadas, con un máximo de 50 registros por página.
Cubre lo que una integración comercial necesita: clientes, cuyo código es el RUT; productos y variantes con su código; stock disponible y reservado; listas de precios; tipos de documento con su código del SII; y documentos de venta, incluidas facturas y boletas electrónicas, notas de venta y cotizaciones.
¿Qué conviene sincronizar y en qué dirección?
Los productos, precios y stock viajan desde Bsale, para que las cotizaciones de HubSpot usen el mismo código de variante. El cliente nace en HubSpot y se busca por RUT en Bsale antes de crearlo. El negocio ganado crea en Bsale la nota de venta o el documento, según tu proceso.
De vuelta, el documento emitido actualiza el negocio y la empresa con folio, monto, enlace al PDF y estado. Bsale manda en lo facturado y en el stock; HubSpot, en el pipeline. Cada número se cuadra contra su propio registro.
¿Qué cuidar con los documentos tributarios?
Al crear un documento por API, un campo indica si se declara al SII, y Bsale responde con el número asignado y los enlaces al PDF y al XML. Revisa antes los tipos de documento que tienes habilitados y los folios disponibles: la API permite consultarlos.
Los errores típicos son de datos: RUT con formato distinto, productos sin código de variante, precios con y sin impuestos mezclados o un tipo de documento equivocado. Valida esos campos en HubSpot antes de ganar el negocio y prueba en la cuenta de pruebas con documentos reales de tu operación.
¿Cómo saber que la integración sigue funcionando?
Los webhooks de Bsale avisan cuando se crea un documento o cambian el stock, un producto, una variante o un precio, y se activan escribiendo a Bsale con la URL de destino. No hay webhook de clientes, así que esos cambios se consultan cada cierto tiempo. La API admite hasta 8 llamadas por segundo: las cargas grandes deben respetar ese ritmo.
En HubSpot, la propiedad Fuente del registro muestra qué creó la integración, y un informe diario por fuente dice si los documentos siguen llegando. Agrega una alerta de silencio: si un día hábil con ventas no llega ningún documento, alguien recibe el aviso. En Chile y Latinoamérica, un webhook que deja de responder puede pasar días sin que nadie lo vea.
Paso a paso en HubSpot
Cómo evaluar la integración con Bsale
Seis pasos antes de comprometer plazos.
- 01
Consigue el acceso a la API
Una cuenta de pruebas para desarrollar y el token de producción solicitado a Bsale o vía OAuth 2.0, a nombre de tu empresa.
- 02
Define qué sistema manda en cada dato
Cliente, producto, variante, precio, stock, negocio y documento: una tabla con el dueño de cada dato y el momento en que viaja.
- 03
Prepara HubSpot
En la empresa, el RUT como propiedad única; en el producto, el código de variante; en el negocio, tipo de documento, folio, monto y enlace al PDF.
- 04
Elige qué crea el negocio ganado
Nota de venta, cotización o documento electrónico, y si se declara al SII de inmediato o después de una revisión.
- 05
Pide los webhooks y prueba
Activa los de documentos, stock y precios hacia una URL de la integración, y prueba con ventas reales en la cuenta de pruebas.
- 06
Deja dueño, documentación y alerta
Código y token a nombre de tu empresa, un documento de qué se sincroniza y una alerta si los documentos dejan de llegar.
Cómo se ve cuando queda bien
Qué cambia cuando ventas y Bsale hablan
- El vendedor ve en el negocio el folio y el PDF de la factura.
- Las cotizaciones usan el mismo código y el mismo precio que Bsale.
- El stock disponible se ve en HubSpot antes de prometer una entrega.
- Si los documentos dejan de llegar, alguien lo sabe ese mismo día.
Errores comunes
Lo que vemos más seguido en portales de Chile y Latinoamérica
Productos sin código de variante en HubSpot, que obligan a corregir cada documento.
Mezclar precios con y sin impuestos entre la cotización y la factura.
Cargas masivas que superan el límite de llamadas por segundo y quedan a medias.
Webhooks activos sin monitoreo: dejan de llegar y nadie lo nota.
¿Quieres saber si esto aplica a tu caso?
Agendar diagnóstico de 30 minutos30 minutos con Roberto. Sin demo y sin acceso a tu CRM.
Cómo lo resolvemos en Revenue Hub Latam
Evaluamos la ruta antes de comprometer
Revisamos tu acceso a la API de Bsale, los documentos que emites y el volumen de ventas, y clasificamos cada punto como confirmado, condicional o no soportado antes de cotizar. Si avanzamos, es con precio cerrado, y entregamos código, token y manual a tu nombre, con la alerta de silencio activa.
Integraciones con dueño
ERP, facturación, WhatsApp y APIs, con código y manual a tu nombre y alerta si dejan de traer datos.
Ver IntegracionesDiagnóstico de HubSpot
En 10 horas inventariamos integraciones, workflows y propiedades, con la lista de riesgos.
Ver el DiagnósticoMonitoreo en Operar
La alerta se revisa cada semana en HubSpot Gestionado y cada día en HubSpot Dedicado.
Ver planes de operación
Las garantías que aplican
- Avisa.
Una alerta automática te avisa si una integración o un formulario deja de traer datos. Te enteras por nosotros.
- Es tuyo.
Workflows, integraciones, código y llaves documentados y a tu nombre. Si cambias de partner, no pierdes nada.
Las ponemos por escrito porque son lo que controlamos.
Respuestas directas
Preguntas frecuentes
¿Se puede emitir una factura de Bsale desde HubSpot?
La integración puede crear el documento en Bsale cuando se gana el negocio, y Bsale lo declara al SII si así se indica. HubSpot no emite el documento tributario: recibe el folio, el monto y el PDF.
¿Bsale avisa cuando cambia algo?
Sí, con webhooks para documentos, stock, productos, variantes y precios, entre otros. No hay webhook de clientes. Se activan escribiendo a Bsale con la URL de destino.
¿Qué límites tiene la API de Bsale?
Hasta 8 llamadas por segundo y un máximo de 50 registros por página. Una carga inicial grande debe hacerse por lotes y respetando ese ritmo.
¿Cuánto cuesta integrar HubSpot con Bsale?
Depende de los objetos, del volumen de documentos y de si necesitas stock y precios en HubSpot; por eso conviene evaluarlo antes de cotizar. Pide precio cerrado, código a tu nombre y una alerta si la integración deja de traer datos.
Quién escribeRoberto Guerra
Diseña la arquitectura del CRM, las integraciones y la operación de cada cuenta. Escribe estas guías con lo que ve cada semana en portales de HubSpot de empresas B2B de Chile y Latinoamérica.
Conoce al equipo30 minutos con Roberto.
Revisamos un problema concreto, su impacto y el punto de partida. Sin demo y sin acceso a tu CRM.