Node.js / TypeScript SDK now available
The official BeeL. SDK for Node.js and TypeScript is now published on npm as @beel_es/sdk. It is fully typed from the OpenAPI spec, with automatic retries, idempotency keys, typed errors, and webhook signature verification built in.
The official BeeL. SDK for Node.js and TypeScript is now published on npm as @beel_es/sdk. It is fully typed from the OpenAPI spec, with automatic retries, idempotency keys, typed errors, and webhook signature verification built in.
What else changed
- Install with
npm install @beel_es/sdk— Node.js 18+, ships both ESM and CommonJS with a single runtime dependency. - Fully-typed client auto-generated from the OpenAPI spec — invoices, customers, products, configuration, series, and NIF validation.
- Automatic retries with exponential backoff on 429 and 5xx, plus auto idempotency keys on every POST so retries never create duplicates.
- Typed errors — catch
BeeLNotFoundError,BeeLValidationError, and friends instead of checking status codes. - Webhook signature verification with HMAC-SHA256 and PDF download as a Buffer.
Where to go next
BeeL. CLI — run the API from your terminal
The official BeeL. CLI is now published on npm as @beel_es/cli. Run any API endpoint straight from the terminal — sandbox by default — with nothing to install thanks to npx. Commands are derived at runtime from the OpenAPI spec bundled with the installed version, so the CLI always matches the API surface of that release.
API v1.3.0 — contract fixes: flexible idempotency keys, optional country, HTTPS-only webhooks
Contract-correctness wave from an API test pass. Idempotency keys no longer have to be UUIDs, address country becomes optional, webhook endpoints must be HTTPS, and several error responses are now more accurate (correct codes, correct status, and a previously-opaque 500 turned into an actionable 422).