# Node.js / TypeScript SDK

Official Node.js / TypeScript SDK on npm as `@beel_es/sdk`, fully typed from the spec.

Jun 11, 2026 · New

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

- [Node.js SDK docs](/sdks/node)
- [npm package](https://www.npmjs.com/package/@beel_es/sdk)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi