Gestión e inteligencia artificial
Cómo conectar Bsale con ChatGPT usando una skill
Solicita tu API token de Bsale, configura una skill en ChatGPT y empieza a consultar ventas, stock y reposiciones. Una guía basada en nuestra experiencia.
01Solicita el API token a Bsale.
02Pide a ChatGPT que configure una skill.
03Consulta ventas y stock con tus propias palabras.
Así lo hicimos en Meat Deli
El punto de partida fue sencillo: solicitamos el API token de Bsale y pedimos configurar una skill para utilizarlo. Después pudimos preguntar qué productos se habían vendido más y revisar el stock para preparar una reposición.
Una skill guarda las instrucciones que el asistente debe seguir: cómo consultar Bsale, dónde encontrar el acceso guardado y cómo presentar los resultados. En nuestra configuración, la credencial queda cifrada en el equipo y las instrucciones indican cómo utilizarla.
La documentación de OpenAI explica que las skills pueden incluir instrucciones, referencias y scripts, y que están disponibles en los entornos compatibles de ChatGPT y Codex. Cómo funcionan las skills.
Paso 1. Solicita tu API token a Bsale
Pide el acceso desde la empresa titular de la cuenta o con su autorización. La documentación de Bsale indica que puedes solicitar el token de producción a ayuda@bsale.app.
Puedes usar este texto como referencia para tu solicitud:
Hola, necesito solicitar el API token de la cuenta Bsale de mi empresa para consultar ventas, productos e inventario mediante un asistente de ChatGPT. Por favor, indíquenme el procedimiento y los antecedentes necesarios para autorizar el acceso.
Cuando Bsale responda, confirma que el acceso corresponde a tu empresa y al ambiente de producción. Si ya tienes un token autorizado, pide a ChatGPT que reutilice la configuración existente. Accesos de producción de Bsale.
Paso 2. Pide a ChatGPT que cree la skill
Abre el proyecto de tu negocio en el entorno de escritorio que usarás para trabajar. En ChatGPT Work, puedes invocar @skill-creator si está disponible; en Codex se utiliza $skill-creator. Describe la tarea en lenguaje cotidiano.
Copia este mensaje, todavía sin incluir el token:
Crea una skill llamada «Bsale de mi negocio» para consultar ventas, productos e inventario. Ya solicité el API token. Comprueba qué herramientas tienes para conectarte a la API de Bsale y ayúdame a configurar el acceso de forma segura en este equipo.
Quiero pedirte reportes con mis propias palabras. Guarda las instrucciones para reutilizar la conexión y empieza con consultas de lectura. No emitas facturas, registres pagos ni muevas stock durante la configuración.
Si ya usas una skill de gestión de tu negocio, puedes pedir que incorpore este procedimiento allí. Una descripción clara ayuda al asistente a encontrarla cuando le pidas trabajar con Bsale. Creación e invocación de skills.
Paso 3. Configura el token una sola vez
Solicita que el asistente prepare una forma de introducir la credencial de manera privada en el equipo. Por ejemplo, una entrada local oculta que la guarde en el almacén seguro del sistema. En nuestra configuración de Windows, se guarda cifrada para el usuario que la configuró.
La skill debe conservar la referencia a la credencial y el procedimiento de consulta. Evita incluir el valor del token en el texto de la skill, en una conversación compartida o en archivos que vayas a publicar.
Prepara una entrada segura para guardar mi token y dime dónde introducirlo. No lo muestres en pantalla ni en tus respuestas. Guarda en la skill cómo recuperar la credencial para futuras consultas y verifica que no quede dentro de los archivos públicos del proyecto.
Para la conexión, Bsale utiliza la dirección https://api.bsale.io/v1 y recibe la credencial en la cabecera access_token. El asistente puede preparar esa parte a partir de la documentación oficial; no necesitas escribir cada consulta manualmente. Autenticación y primeros pasos de Bsale.
Paso 4. Comprueba que realmente está conectado
Haz una primera consulta pequeña y fácil de revisar:
Comprueba la conexión con Bsale. Muéstrame las sucursales disponibles y cinco productos con su nombre y código. No cambies ningún dato.
Compara esos productos con los de tu cuenta. Luego pide el stock de un producto conocido, en una sucursal concreta, y revisa que coincida. El asistente debe decirte si la consulta funcionó, cuándo la realizó y si faltó información.
La respuesta «skill creada» confirma que se guardaron instrucciones. La prueba con datos reales confirma que la conexión también funciona. Si hay un error de acceso, revisa la credencial, los permisos del entorno y la conexión a internet antes de confiar en un reporte.
Paso 5. Guarda las reglas de tu negocio
Pide que estas reglas queden incorporadas a la skill para no tener que repetirlas en cada consulta:
- Fuente: consultar Bsale en vivo y mostrar fecha, período y sucursal.
- Ventas: separar cantidades de importes y neto de IVA; no sumar una nota de venta y su factura como dos ventas.
- Ajustes: explicar las notas de crédito descontadas y revisar todas las páginas del período.
- Inventario: distinguir existencias, reservas y disponible; marcar los productos sin control de stock.
- Formatos: conservar kilos, unidades, bolsas y cajas, sin inventar equivalencias.
- Acciones: una revisión o un cálculo de reposición no autoriza compras, facturas, pagos ni movimientos de stock.
- Errores: informar una consulta fallida o incompleta y no reemplazarla por cifras inventadas.
Esas reglas convierten una conexión técnica en una herramienta útil para tu operación. Puedes agregar tus nombres de sucursales y formatos verificados sin guardar ventas diarias ni datos de clientes dentro de la skill.
Paso 6. Empieza a preguntar por tu negocio
Una vez configurada y probada la skill, puedes usar solicitudes como estas:
| Objetivo | Qué pedirle a ChatGPT |
|---|---|
| Más vendidos | Revisa en Bsale los productos más vendidos del mes pasado, por cantidad y por monto sin IVA. Descuenta las notas de crédito y separa unidades de venta diferentes. |
| Stock actual | Consulta el stock de mi sucursal. Muéstrame existencias, reservas y disponible. Destaca saldos negativos y productos cuyo stock no se pueda confirmar. |
| Reposición | Calcula una propuesta para cubrir 30 días. Usa las ventas del último mes, revisa las reservas vigentes y considera las compras confirmadas por recibir. |
| Comparación | Compara las ventas de este mes con el anterior usando períodos equivalentes. Explica qué productos subieron o bajaron y muestra las cifras. |
Si el asistente no activa la skill, selecciónala explícitamente. Antes de interpretar el resultado, comprueba período, sucursal y unidad. Para períodos grandes, pide que indique si terminó de consultar todos los registros.
Cómo pasar del stock a una compra
Una propuesta de reposición combina demanda futura, existencias y compromisos vigentes. El stock negativo merece una revisión: puede reflejar reservas que superan las existencias registradas, no necesariamente una compra que debas hacer de inmediato.
Si las reservas ya están incluidas en la demanda prevista, no se suman nuevamente. Si usas el stock disponible, las reservas ya están descontadas. Y si verificaste que una caja contiene 20 bolsas, puedes redondear las 70 bolsas a 4 cajas, dejando 10 adicionales.
Confirma también el conteo físico, los pedidos pendientes, la temporada y el espacio de almacenamiento. En Bsale, las reservas pueden corresponder a borradores o documentos pendientes de despacho. Campos de stock de Bsale · Documentos y filtros de consulta.
Para decidir el surtido de tu siguiente compra, revisa nuestra guía de reposición para minimarkets.
Conserva la conexión para la próxima consulta
Pide al asistente que deje anotados el nombre de la skill, el proyecto donde opera, la referencia al acceso protegido y la última prueba satisfactoria. En el próximo uso, la consulta debe reutilizar esa configuración.
Este procedimiento trabaja bajo petición. Crear la skill no programa una sincronización automática ni la habilita en todos tus dispositivos. Si depende del equipo local, ese equipo debe estar disponible. Para continuar desde otro dispositivo, verifica una conexión remota compatible y pruébala. Conexiones remotas en ChatGPT.
Si compartes la skill con otro negocio, entrega únicamente las instrucciones: cada empresa configura su propio token y sus permisos.
Preguntas frecuentes
¿Necesito saber programar?
Puedes pedir al asistente que prepare la skill y las consultas. Debes contar con acceso autorizado a Bsale y con un entorno capaz de ejecutar esas consultas. Si faltan herramientas o permisos, el asistente debe explicarlo antes de afirmar que está conectado.
¿Tengo que poner el token dentro de SKILL.md?
La configuración recomendada guarda la credencial por separado y de forma protegida. La skill conserva las instrucciones y la referencia para utilizarla. Así puedes reutilizar o compartir el procedimiento sin compartir el acceso a tu empresa.
¿Funciona en cualquier conversación de ChatGPT?
Necesita un entorno con la skill disponible y herramientas autorizadas para consultar la API. Pegar instrucciones en un chat sin esas herramientas no establece una conexión.
¿Por qué no tengo que volver a entregar el token cada vez?
Porque el acceso queda guardado en el entorno configurado y la skill explica cómo reutilizarlo. Si cambia el equipo, vence o se revoca la credencial, hay que revisar la configuración.
¿Subir una planilla equivale a consultar Bsale en vivo?
Una planilla contiene los datos del momento en que se exportó. La conexión de esta guía permite volver a consultar Bsale cuando haces una nueva solicitud.
¿Una consulta puede emitir facturas o mover stock?
Las reglas de esta guía limitan el trabajo a consultas. La credencial puede tener permisos más amplios: la skill no reduce por sí sola los permisos de Bsale. Cualquier operación de escritura requiere una solicitud expresa y una configuración adecuada.
Guía del equipo Meat Deli basada en su experiencia de conexión local y en documentación oficial. No implica afiliación con OpenAI o Bsale. El ejemplo de reposición es ficticio. Conoce quiénes somos.
