API de Bling: qué puedes hacer y cómo usarla con agentes de IA
Bling es un ERP brasileño. Su API da acceso a los registros y movimientos del sistema: productos, stock, pedidos, facturas, contactos y finanzas. La usan tiendas online, integradores y empresas que conectan marketplaces y sistemas con Bling. La versión actual exige una aplicación registrada y la autorización OAuth de la cuenta del cliente.
Qué ofrece la API de Bling
Productos
Alta de productos, variaciones, precios y estructuras.
Stock
Consulta de saldos por almacén y registro de movimientos.
Pedidos de venta
Creación, consulta y cambio de estado de pedidos, incluidos los que llegan de tiendas integradas.
Facturas electrónicas
Emisión y consulta de NF-e y NFC-e, las facturas electrónicas fiscales de Brasil, a partir de los pedidos.
Contactos
Clientes, proveedores y transportistas.
Cuentas por pagar y por cobrar
Títulos financieros, bajas y categorías.
Webhooks
Avisos de cambios en pedidos, productos y stock para reaccionar sin consultar de forma continua.
Cómo acceder a la API de Bling
- Con las credenciales de tu empresaOAuth 2.0: registras una aplicación en el área de desarrolladores de Bling y la cuenta de la empresa autoriza los alcances; el token de acceso se renueva con un refresh token.
- La API tiene un límite de solicitudes por segundo y por día; las sincronizaciones grandes deben usar webhooks.
- La API antigua, con clave, fue sustituida por la v3 con OAuth; las integraciones antiguas deben migrar.
- Las facturas emitidas tienen efecto fiscal: mantén la aprobación humana en ese paso.
Documentación oficial: developer.bling.com.br
Qué hace un agente de iTeam con la API de Bling
Pedido bloqueado sin factura
El agente encuentra pedidos facturables desde hace más de un día sin NF-e emitida y avisa al área fiscal con el motivo probable, como un registro incompleto del cliente.
Rotura de stock antes de que ocurra
Cruzando las ventas recientes y el saldo por almacén, el agente señala los productos que se agotarán esta semana y prepara la sugerencia de compra para que la apruebe el comprador.
Estado del pedido por WhatsApp
El cliente B2B pregunta por su pedido y el agente consulta el estado, la factura y el transportista en Bling, y responde sin recurrir al área comercial.
Cobro de títulos vencidos
El agente lista las cuentas por cobrar vencidas, las agrupa por cliente y envía el recordatorio con la copia del documento, registrando el contacto.
De la credencial al agente trabajando, con aprobación
Registra la aplicación en Bling
En el área de desarrolladores, crea la app con los alcances mínimos (por ejemplo pedidos y stock) y autoriza con un usuario administrador.
Guarda la autorización en la bóveda de iTeam
iTeam renueva el token y cada agente recibe permisos propios: atención lee pedidos, compras lee stock, finanzas lee títulos.
Valida con aprobación humana
La emisión de facturas, la baja de títulos y la modificación de stock empiezan con aprobación y quedan auditadas.
Equipos de IA listos que usan Bling
Preguntas sobre la API de Bling
¿La API de Bling es gratuita?
En general, el acceso a la API viene con la suscripción de Bling, dentro de los límites del plan. Confirma en tu plan si hay restricciones.
¿Necesito programar para usar la API de Bling con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación de Bling y el equipo de implantación configura los flujos.
¿Se puede emitir una factura electrónica por la API?
Sí, la API permite emitir y consultar facturas a partir de los pedidos, según la configuración fiscal de la cuenta.
