Implementa
Detecta tu stack, configura el SDK oficial o un cliente tipado e implementa los flujos que necesitas contra la spec en vivo.
Plugin oficial para Claude Code
Claude monta tu integración
Instala el plugin y pídele a Claude Code que integre la facturación: detecta tu stack, escribe el código contra la API en vivo y lo verifica en el sandbox con la CLI. Esto no lo tiene nadie.
Requiere Claude Code + tu API key · se instala y actualiza solo
Claude Code
Cinco skills, una integración impecable
Claude activa la skill adecuada según lo que le pides. No hay que invocarlas a mano.
Audita
Revisa tu integración contra las reglas de BeeL. —idempotencia, seguridad de claves, manejo de errores, rate limits, verificación de webhooks, ciclo de la factura— y reporta hallazgos con severidad y arreglos listos para aplicar.
Webhooks
Construye un receptor de webhooks correcto: verificación de firma, manejo del raw body, deduplicación y procesado tolerante a reintentos.
Actualiza
Comprueba tu integración contra la OpenAPI en vivo y las releases del SDK: cambios incompatibles, patrones obsoletos y novedades que conviene adoptar.
Guía siempre al día
Reglas de oro, auth y recetas (cliente tipado o SDK, webhooks, flujo de factura, contexto fiscal, depuración, CLI). Claude lee los docs en el momento de usarlos, así nunca se queda obsoleto.
Cómo se usa
Pídeselo en lenguaje natural
Sin comandos que memorizar: describe lo que quieres y Claude elige la skill y lo monta.
Pídeselo en lenguaje natural
De instalar a producción en 4 pasos
Instala el plugin una vez y deja que Claude haga el trabajo, verificándolo en sandbox antes de tocar producción.
- 1
Instala el plugin
Dos comandos en Claude Code: añade el marketplace e instala beel-api@beel. Se actualiza solo cuando hay versión nueva.
Claude Code - 2
Pídele la integración
Describe lo que necesitas —«añade la facturación a mi checkout»— y Claude detecta el stack e implementa los flujos contra la API en vivo.
- 3
Verifica en sandbox
Las skills usan la CLI con tu clave beel_sk_test_ para crear facturas de prueba y confirmar el flujo de extremo a extremo. Nada llega a la AEAT.
Verificación en sandbox - 4
Pasa a producción
Cuando todo cuadra, cambias a tu clave de producción. Y con la skill de actualizar mantienes la integración al día sin esfuerzo.
La suite de desarrollador
¿Quieres la integración montada sola?
La CLI, el SDK tipado y el plugin de Claude Code son la misma caja de herramientas. Instala el plugin y Claude monta la integración por ti —y la verifica con la CLI contra el sandbox antes de tocar producción.
SDK de Node/TypeScript
El código que tu producto envía a producción: tipado, con reintentos automáticos e idempotencia.
$npm i @beel_es/sdk
VerCLI
Opera y automatiza desde la terminal o tu CI. Agent-first y sandbox por defecto.
$npx @beel_es/cli invoices create
VerPlugin de Claude Code
Claude lee la doc y monta la integración por ti, y la verifica con la CLI contra el sandbox.
$/plugin install beel-api@beel
El plugin es gratis. Pagas por facturas emitidas.
Úsalo y prueba en sandbox sin coste. Solo pagas cuando emites en producción.
Preguntas frecuentes
¿Qué es exactamente el plugin de Claude Code?
Un toolkit para Claude Code: una guía de integración siempre actualizada más skills dedicadas para implementar, auditar, construir webhooks y mantener tu integración con la API de BeeL. Tú describes lo que quieres y Claude lo monta.
¿Se queda obsoleto cuando cambia la API?
No. El plugin solo guarda en local los invariantes estables (auth, idempotencia, envelope de respuesta, ciclo de la factura); los endpoints, esquemas y eventos los lee Claude de la documentación en vivo en el momento de usarlos. Y se actualiza solo cuando se publica una versión nueva.
¿Toca producción mientras desarrolla?
No. Para verificar los flujos, las skills usan la CLI con sandbox por defecto: con una clave beel_sk_test_ Claude crea facturas de prueba y confirma que todo funciona, sin escribir scripts de usar y tirar y sin enviar nada a la AEAT.
¿Qué puede hacer por mí?
Implementar la integración detectando tu stack, auditarla contra las reglas de producción (idempotencia, seguridad, webhooks, rate limits), construir un receptor de webhooks correcto y comprobar si tu código está al día con la API actual.
¿En qué se diferencia de integrarlo a mano?
Claude parte de una guía siempre actualizada y de la spec en vivo, así que no copia ejemplos viejos ni inventa endpoints. Implementa, se autoaudita y verifica en sandbox —el tipo de trabajo que te llevaría horas de leer docs y montar pruebas.
¿Cuánto cuesta el plugin?
El plugin es gratis. Solo pagas por las facturas que emites en producción, según tu plan. Necesitas Claude Code instalado y una API key de BeeL.
Tu integración, montada por Claude
Instala el plugin, pruébalo en sandbox gratis y pasa a producción cuando quieras.
Claude Code + API key · sandbox gratis · sin tarjeta