La API pública (una puerta técnica para que otros programas hablen con barcasti) sirve para conectar sistemas externos con tu empresa: que tu tienda online consulte tus facturas, que un panel de tu desarrollador lea el balance, o que otro software cree borradores de factura por ti. Si no tienes un sistema que conectar ni un desarrollador a mano, puedes ignorar esta sección tranquilamente.
Está disponible en los planes Pyme y Firma (no en Emprende ni durante la prueba). Las peticiones van a /api/v1 con la clave en el encabezado Authorization: Bearer bk_….
Crear una clave
Necesitas permiso de administración de facturación (el dueño lo tiene siempre).
- Ve a Ajustes → API (la página se titula "API pública").
- En Nueva clave, escribe un nombre descriptivo (p.ej. "Integración tienda") y elige el alcance.
- Pulsa Crear clave.
- La clave completa (empieza por
bk_) aparece una sola vez, con un botón Copiar. Cópiala ya y guárdala en un lugar seguro (un gestor de contraseñas, no un chat ni un correo). Si la pierdes, no se puede recuperar: tendrás que revocarla y crear una nueva.
También puedes pedírsela al asistente: "Créame una clave API de solo lectura llamada Integración tienda." Como crear una clave da acceso externo a los datos de tu empresa, el asistente primero te muestra la propuesta y espera tu confirmación antes de crearla.
Los alcances: cuánto puede hacer cada clave
Regla de oro: dale a cada integración el mínimo que necesite. Si tu tienda solo consulta facturas, con solo lectura basta. Ninguna clave puede emitir documentos ante la DIAN ni tocar tu configuración — eso queda para las personas, dentro de la plataforma.
Revocar una clave
En la misma página ves la lista de claves con su prefijo (los primeros caracteres, p.ej. bk_a1b2c3d4), su alcance y su último uso — si una clave dice "Nunca" o lleva meses sin usarse, es candidata a salir.
- Pulsa Revocar en la fila de la clave.
- Confirma. La revocación es irreversible: cualquier integración que la use deja de funcionar de inmediato.
Por chat: "Revoca la clave API con prefijo bk_a1b2c3d4." — el asistente te pedirá confirmación antes de ejecutarla.
Revoca sin pensarlo dos veces si sospechas que una clave se filtró (quedó en un correo, un repositorio, un pantallazo). Crear una nueva toma un minuto; una clave filtrada expone tus datos.
Relacionado: Planes y prueba gratis: qué incluye cada uno