Crea apps para los negocios que usan OneBooks
Una API OAuth y MCP, páginas incrustadas directamente en OneBooks, datos de app sobre registros reales y funciones alojadas — llega a todas las empresas de OneBooks con una única ficha revisada en el marketplace.
Cuatro formas de ampliar OneBooks
API OAuth y webhooks
Una API REST OAuth 2.0 con permisos sobre facturas, pagos, clientes, informes y más, además de MCP para agentes de IA. Recibe más de 40 eventos por webhook o desde la API de eventos — con escrituras idempotentes, versiones por fecha y documentación de referencia completa.
Apps dentro de OneBooks
Tus propias páginas dentro de OneBooks, además de acciones y tarjetas en 15 lugares — el panel y siete tipos de registro, de las facturas a las devoluciones de compra — en un marco aislado, autenticadas con tokens de sesión de corta duración.
Datos de app en los registros
Guarda tus propios campos tipados en 12 tipos de registro — clientes, facturas, artículos y más — visibles para el comercio justo en el registro, donde ya trabaja.
Funciones alojadas
Ejecuta tu código con los eventos en un entorno aislado sobre la infraestructura de OneBooks. Solo alcanza los destinos que declares — y no hay servidor que operar para automatizaciones sencillas.
De la página incrustada a los datos contables
App Bridge entrega a tu página incrustada un token de sesión de corta duración. Tu servidor lo cambia por un token de acceso — y a partir de ahí es una llamada normal a la API. Sin redirección y sin necesidad de SDK.
Lee la guía de intercambio de tokens (se abre en una pestaña nueva)
curl -X POST https://api.getonebooks.com/oauth/token \
-u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
-d grant_type=urn:ietf:params:oauth:grant-type:token-exchange \
-d subject_token=SESSION_TOKEN \
-d subject_token_type=urn:ietf:params:oauth:token-type:jwtcurl https://api.getonebooks.com/invoices \
-H "Authorization: Bearer ACCESS_TOKEN"Hecho para desarrolladores que lanzan
- ✓ Todos los planes — incluido el Gratis — incluyen acceso a la API, así que cualquier comercio puede instalar tu app
- ✓ Cinco idiomas incluido el árabe, totalmente de derecha a izquierda
- ✓ Una ficha revisada en el marketplace, con distribución dentro de la app que cada comercio ya usa
- ✓ Empresas sandbox gratuitas para construir y probar, sin riesgo para una contabilidad real
- ✓ Cobras a tus clientes directamente y te quedas con el 100% de tus ingresos
- ✓ Límites de uso por app y por empresa, así el tráfico de otras apps nunca consume tu cuota
- ✓ Versionado de API por fecha, con 12 meses de soporte tras cada nueva versión
De la idea al marketplace
- 01
Crea una cuenta de desarrollador
Regístrate en la consola de desarrollador — es gratis y toma un par de minutos.
- 02
Construye en una sandbox
Registra tu app y construye con empresas sandbox gratuitas, sin riesgo para la contabilidad real de nadie.
- 03
Supera la revisión de la app
Hasta que se aprueba, tu app solo puede conectarse a tus propias sandboxes. La revisión de la app la comprueba antes de que la usen empresas reales.
- 04
Supera la revisión de la ficha
Envía tu ficha del marketplace. Cuando la revisión de la ficha la aprueba, se publica — y cualquier empresa de OneBooks puede encontrar e instalar tu app.
Mínimo privilegio, por defecto
- ✓ Las páginas incrustadas se ejecutan en iframes aislados de origen cruzado, autenticadas con tokens de sesión de corta duración — nunca una cookie compartida
- ✓ Cada instalación se limita exactamente a los permisos que solicita, consentidos por el comercio, y nada más
- ✓ Las funciones alojadas se ejecutan en workers aislados con una lista declarada y aplicada de destinos a los que pueden acceder
- ✓ Cada escritura que hace tu app queda atribuida a ella en el registro de auditoría del comercio
- ✓ Los comercios pueden desinstalar tu app cuando quieran — el acceso termina de inmediato, en todas partes
Lanza más rápido con las herramientas oficiales
App Bridge
La librería de navegador para páginas incrustadas: tokens de sesión, navegación, avisos, selectores y diálogos de confirmación.
SDK de Node
Un cliente de servidor tipado para la API OAuth, con reintentos, intercambio de tokens y verificación de tokens de sesión y de webhooks.
SDK de Functions
Tipos para escribir funciones alojadas, más un ejecutor local para probarlas antes de desplegarlas.
CLI
Crea el andamiaje de una app, despliega y prueba funciones alojadas contra una sandbox, y publica nuevas versiones desde tu terminal.
Plantilla inicial
Una app incrustada lista para ejecutar que la CLI genera por ti — OAuth, App Bridge, una acción y una tarjeta en la factura, un receptor de webhooks y una función alojada de ejemplo, ya conectados.
Los SDKs y la CLI están en versión preliminar: instálalos desde el código fuente hasta que se publiquen en npm.
Tu app, frente a cada comercio de OneBooks.
Crea una cuenta de desarrollador gratuita, construye contra una sandbox, y publica en un marketplace en el que los comercios ya confían.