@beel_es/sdk 2.0.0 → 2.1.0

package/docs/reference/README.md

@@ -0,0 +1,233 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# @beel_es/sdk API reference
+
+Typed reference of the SDK, generated from its source and the OpenAPI contract (version `1.9.0`).
+Start with the [README](../../README.md) for setup and common tasks.
+
+## How this reference is organised
+
+- **One page per resource**, named after how you reach it: `beel.company(companyId).invoices`
+  is `company-invoices.md`. The client is `client.md`, errors `errors.md`, exported types
+  `types.md`.
+- **One stable anchor per method**: `<page>-<method-in-kebab-case>`, for example
+  `company-invoices.md#company-invoices-create-once`. Anchors and file names only change when
+  the SDK renames the resource or the method.
+- **Every method** lists its HTTP operation, the scopes it needs, whether it accepts an
+  `Idempotency-Key`, its parameters (with the exact type to import), what it returns (the
+  `data` of the successful response, as the contract names it), the error class thrown per
+  status, and an example where one helps.
+- **Types**: `components['schemas'][Name]` and `operations[operationId]` are exported by the
+  package: `import type { components, operations } from '@beel_es/sdk'`. A schema name in
+  a *Returns* line is `components['schemas'][Name]`.
+- The table below lists every method of every page: method, HTTP operation, one line.
+
+## Pages
+
+| Page | Reached as | Summary |
+|---|---|---|
+| [`BeeL`](client.md) | `beel` | The BeeL API client. |
+| [`AccountScope`](account.md) | `beel.account(accountId)` | Operations scoped to one account: its companies (NIFs), members, invitations, webhooks and usage. |
+| [`AccountCompaniesResource`](account-companies.md) | `beel.account(accountId).companies` | Companies (NIFs) of an account — where the `companyId` of `beel.company(companyId)` comes from. |
+| [`AccountInvitationsResource`](account-invitations.md) | `beel.account(accountId).invitations` | Invitations to join an account. |
+| [`AccountMembersResource`](account-members.md) | `beel.account(accountId).members` | Members of an account and their per-company grants. |
+| [`AccountWebhooksResource`](account-webhooks.md) | `beel.account(accountId).webhooks` | Webhook subscriptions of an account. |
+| [`AccountsResource`](accounts.md) | `beel.accounts` | Accounts you provisioned and manage (multi-account provisioning for platforms and advisory firms). |
+| [`CatalogsResource`](catalogs.md) | `beel.catalogs` | Account-wide catalogs, the credential's identity and personal preferences, on their canonical paths. |
+| [`CompanyScope`](company.md) | `beel.company(companyId)` | Operations scoped to a single company (NIF). |
+| [`CompanyCustomersResource`](company-customers.md) | `beel.company(companyId).customers` | Customers of one company. |
+| [`CompanyInvoicesResource`](company-invoices.md) | `beel.company(companyId).invoices` | Invoice lifecycle of one company: create a draft (or issue it directly), issue, void, correct, list and read, PDF and email. |
+| [`CompanyInvoiceScheduleResource`](company-invoices-schedule.md) | `beel.company(companyId).invoices.schedule` | Scheduled issuing of one invoice: read it, set it, clear it. |
+| [`CompanyPaymentConnectionsResource`](company-payment-connections.md) | `beel.company(companyId).paymentConnections` | Payment connections of a company (NIF): the Stripe Connect link whose charges auto-generate invoices under that NIF. |
+| [`CompanyPaymentEventsResource`](company-payment-connections-events.md) | `beel.company(companyId).paymentConnections.events(connectionId)` | Payment events received through a connection, and the recovery levers for the ones that did not produce an invoice. |
+| [`CompanyProductsResource`](company-products.md) | `beel.company(companyId).products` | Products and services of one company. |
+| [`CompanyRecurringInvoicesResource`](company-recurring-invoices.md) | `beel.company(companyId).recurringInvoices` | Recurring invoice templates of one company. |
+| [`CompanySeriesResource`](company-series.md) | `beel.company(companyId).series` | Invoice series (numbering) of one company. |
+| [`CompanyTaxConfigurationResource`](company-tax-configuration.md) | `beel.company(companyId).taxConfiguration` | Tax defaults of one company (main tax, IRPF, equivalence surcharge). |
+| [`CompanyVeriFactuConfigurationResource`](company-verifactu-configuration.md) | `beel.company(companyId).verifactuConfiguration` | VeriFactu configuration of one company. |
+| [`NifResource`](nif.md) | `beel.nif` | NIF validation against the AEAT register. |
+| [`CustomerBuilder`](customer-builder.md) | — | Fluent builder for the body of `customers.create`. |
+| [`InvoiceBuilder`](invoice-builder.md) | — | Fluent builder for the body of `invoices.create`. |
+| [`WebhookVerifier`](webhook-verifier.md) | — | Webhook signature verification for BeeL webhooks |
+| [`ConfigurationResource`](configuration.md) | `beel.configuration` | **Deprecated.** Account-wide configuration on the flat `/v1/configuration/*` routes. |
+| [`CustomersResource`](customers.md) | `beel.customers` | **Deprecated.** Customers of the focused company, on the flat `/v1/customers` routes. |
+| [`InvoicesResource`](invoices.md) | `beel.invoices` | **Deprecated.** Invoices of the focused company, on the flat `/v1/invoices` routes. |
+| [`ProductsResource`](products.md) | `beel.products` | **Deprecated.** Products of the focused company, on the flat `/v1/products` routes. |
+| [`SeriesResource`](series.md) | `beel.series` | **Deprecated.** Invoice series of the focused company, on the flat `/v1/configuration/series` routes. |
+| [Errors](errors.md) | — | Error classes and the API error codes the SDK reacts to. |
+| [Types](types.md) | — | Interfaces, type aliases and constants exported by the package. |
+
+## Every method
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.company(companyId)`](client.md#client-company) | — | Returns a facade scoped to one company (NIF) — the explicit multi-NIF surface. |
+| [`beel.account(accountId)`](client.md#client-account) | — | Returns a facade scoped to one account — companies, members, invitations, account webhooks, usage. |
+| [`beel.downloadPdf(invoiceId)`](client.md#client-download-pdf) | — | **Deprecated.** Download an invoice PDF as a Buffer. |
+| [`beel.account(accountId).get()`](account.md#account-get) | `GET /v1/accounts/{account_id}` | Get the account summary. |
+| [`beel.account(accountId).usage()`](account.md#account-usage) | `GET /v1/accounts/{account_id}/usage` | Provisioning usage counters for billing: provisioned accounts and NIFs. |
+| [`beel.account(accountId).changeAccessLevel(body)`](account.md#account-change-access-level) | `PATCH /v1/accounts/{account_id}/access-level` | Change the access level you keep over this account. |
+| [`beel.account(accountId).endManagement()`](account.md#account-end-management) | `DELETE /v1/accounts/{account_id}/management` | End your management of this account: you lose access, and the holder keeps the account, its NIFs and its invoices. |
+| [`beel.account(accountId).createClaimToken(body?)`](account.md#account-create-claim-token) | `POST /v1/accounts/{account_id}/claim-tokens` | Issue a single-use claim token so the account's holder can take ownership. |
+| [`beel.account(accountId).setOwner(body)`](account.md#account-set-owner) | `PUT /v1/accounts/{account_id}/owner` | Make an existing member the account's owner. |
+| [`beel.account(accountId).companies.list(params?)`](account-companies.md#account-companies-list) | `GET /v1/accounts/{account_id}/companies` | List the account's companies, primary first. |
+| [`beel.account(accountId).companies.create(body)`](account-companies.md#account-companies-create) | `POST /v1/accounts/{account_id}/companies` | Register a new company (NIF) under the account. |
+| [`beel.account(accountId).companies.stats()`](account-companies.md#account-companies-stats) | `GET /v1/accounts/{account_id}/companies/stats` | Per-company invoice stats: how many fiscal documents each issued, and when last. |
+| [`beel.account(accountId).invitations.list()`](account-invitations.md#account-invitations-list) | `GET /v1/accounts/{account_id}/invitations` | List the account's invitations. |
+| [`beel.account(accountId).invitations.create(body)`](account-invitations.md#account-invitations-create) | `POST /v1/accounts/{account_id}/invitations` | Invite someone to join the account. |
+| [`beel.account(accountId).invitations.get(invitationId)`](account-invitations.md#account-invitations-get) | `GET /v1/accounts/{account_id}/invitations/{invitation_id}` | Get one invitation. |
+| [`beel.account(accountId).invitations.revoke(invitationId)`](account-invitations.md#account-invitations-revoke) | `DELETE /v1/accounts/{account_id}/invitations/{invitation_id}` | Revoke a `PENDING` invitation, so its link stops working. |
+| [`beel.account(accountId).members.list()`](account-members.md#account-members-list) | `GET /v1/accounts/{account_id}/members` | List the account's members. |
+| [`beel.account(accountId).members.get(memberId)`](account-members.md#account-members-get) | `GET /v1/accounts/{account_id}/members/{member_id}` | Get one member. |
+| [`beel.account(accountId).members.update(memberId, body)`](account-members.md#account-members-update) | `PATCH /v1/accounts/{account_id}/members/{member_id}` | Change a member's account role. |
+| [`beel.account(accountId).members.remove(memberId)`](account-members.md#account-members-remove) | `DELETE /v1/accounts/{account_id}/members/{member_id}` | Remove a member from the account. |
+| [`beel.account(accountId).members.listGrants(memberId)`](account-members.md#account-members-list-grants) | `GET /v1/accounts/{account_id}/members/{member_id}/grants` | List a member's per-company grants. |
+| [`beel.account(accountId).members.putGrant(memberId, companyId, body)`](account-members.md#account-members-put-grant) | `PUT /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` | Grant a member access to one company, or replace the grant it has. |
+| [`beel.account(accountId).members.removeGrant(memberId, companyId)`](account-members.md#account-members-remove-grant) | `DELETE /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` | Revoke a member's access to one company. |
+| [`beel.account(accountId).webhooks.list(params?)`](account-webhooks.md#account-webhooks-list) | `GET /v1/accounts/{account_id}/webhooks` | List the webhook subscriptions. |
+| [`beel.account(accountId).webhooks.create(body)`](account-webhooks.md#account-webhooks-create) | `POST /v1/accounts/{account_id}/webhooks` | Subscribe an HTTPS endpoint to events. |
+| [`beel.account(accountId).webhooks.get(webhookId)`](account-webhooks.md#account-webhooks-get) | `GET /v1/accounts/{account_id}/webhooks/{webhook_id}` | Get one webhook subscription. |
+| [`beel.account(accountId).webhooks.update(webhookId, body)`](account-webhooks.md#account-webhooks-update) | `PATCH /v1/accounts/{account_id}/webhooks/{webhook_id}` | Update a webhook subscription. |
+| [`beel.account(accountId).webhooks.delete(webhookId)`](account-webhooks.md#account-webhooks-delete) | `DELETE /v1/accounts/{account_id}/webhooks/{webhook_id}` | Delete a webhook subscription. |
+| [`beel.account(accountId).webhooks.test(webhookId)`](account-webhooks.md#account-webhooks-test) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/test` | Send a test event to the endpoint. |
+| [`beel.account(accountId).webhooks.rotateSecret(webhookId)`](account-webhooks.md#account-webhooks-rotate-secret) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/secret` | Rotate the signing secret. |
+| [`beel.account(accountId).webhooks.listDeliveries(webhookId, params?)`](account-webhooks.md#account-webhooks-list-deliveries) | `GET /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries` | List the delivery attempts of a subscription. |
+| [`beel.account(accountId).webhooks.retryDelivery(webhookId, deliveryId)`](account-webhooks.md#account-webhooks-retry-delivery) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries/{delivery_id}/retry` | Retry a failed delivery. |
+| [`beel.accounts.list(params?)`](accounts.md#accounts-list) | `GET /v1/accounts` | List the accounts you provisioned, newest first. |
+| [`beel.accounts.provision(body)`](accounts.md#accounts-provision) | `POST /v1/accounts` | Provision a new managed account. |
+| [`beel.accounts.get(accountId)`](accounts.md#accounts-get) | `GET /v1/accounts/{account_id}` | Get a managed account. |
+| [`beel.accounts.scope(accountId)`](accounts.md#accounts-scope) | — | Alias of `beel.account(accountId)`: the operations scoped to one account. |
+| [`beel.catalogs.identity()`](catalogs.md#catalogs-identity) | `GET /v1/me/identity` | Who the API key belongs to: its `account_id` — the starting point to list the account's companies — plus the person's email, name and language, and the credential. |
+| [`beel.catalogs.taxTypes()`](catalogs.md#catalogs-tax-types) | `GET /v1/tax-types` | Tax types the API accepts. |
+| [`beel.catalogs.invoiceCustomizationOptions()`](catalogs.md#catalogs-invoice-customization-options) | `GET /v1/invoice-customization-options` | Invoice PDF templates and customization options. |
+| [`beel.catalogs.updateMe(body)`](catalogs.md#catalogs-update-me) | `PATCH /v1/me` | Update the signed-in person's preferences. |
+| [`beel.company(companyId).get(params?)`](company.md#company-get) | `GET /v1/companies/{company_id}` | Get the company: its fiscal identity, address and settings. |
+| [`beel.company(companyId).update(body)`](company.md#company-update) | `PATCH /v1/companies/{company_id}` | Update the company's data. |
+| [`beel.company(companyId).delete()`](company.md#company-delete) | `DELETE /v1/companies/{company_id}` | Remove the company from its account. |
+| [`beel.company(companyId).fiscalSummary(params?)`](company.md#company-fiscal-summary) | `GET /v1/companies/{company_id}/fiscal-summary` | Fiscal summary of the company for a period: taxable base, VAT and IRPF aggregates. |
+| [`beel.company(companyId).issuingReadiness()`](company.md#company-issuing-readiness) | `GET /v1/companies/{company_id}/issuing-readiness` | Whether the company can issue invoices now, and what blocks it if not. |
+| [`beel.company(companyId).customers.list(params?)`](company-customers.md#company-customers-list) | `GET /v1/companies/{company_id}/customers` | List the company's customers, paginated and searchable. |
+| [`beel.company(companyId).customers.create(body)`](company-customers.md#company-customers-create) | `POST /v1/companies/{company_id}/customers` | Create a customer. |
+| [`beel.company(companyId).customers.createBulk(body)`](company-customers.md#company-customers-create-bulk) | `POST /v1/companies/{company_id}/customers/bulk` | Create several customers in one call. |
+| [`beel.company(companyId).customers.get(customerId)`](company-customers.md#company-customers-get) | `GET /v1/companies/{company_id}/customers/{customer_id}` | Get one customer. |
+| [`beel.company(companyId).customers.update(customerId, body)`](company-customers.md#company-customers-update) | `PATCH /v1/companies/{company_id}/customers/{customer_id}` | Update a customer. |
+| [`beel.company(companyId).customers.delete(customerId)`](company-customers.md#company-customers-delete) | `DELETE /v1/companies/{company_id}/customers/{customer_id}` | Delete a customer that has no invoices. |
+| [`beel.company(companyId).invoices.derive(body, options?)`](company-invoices.md#company-invoices-derive) | `POST /v1/companies/{company_id}/invoices/derivations` | Derive a new draft invoice from an existing one — the canonical form of `duplicate`. |
+| [`beel.company(companyId).invoices.list(params?, options?)`](company-invoices.md#company-invoices-list) | `GET /v1/companies/{company_id}/invoices` | List the company's invoices, paginated, with filters: status, type, customer, dates, `external_ref` (exact match), VeriFactu status and more. |
+| [`beel.company(companyId).invoices.create(body, params?, options?)`](company-invoices.md#company-invoices-create) | `POST /v1/companies/{company_id}/invoices` | Create an invoice: a `DRAFT` by default, or numbered and issued in the same call with `options.issue_directly: true`. |
+| [`beel.company(companyId).invoices.createOnce(body, params?, options?)`](company-invoices.md#company-invoices-create-once) | via `list`, `create` | Create a standard or simplified invoice once per `external_ref`, safe to call again after any failure. |
+| [`beel.company(companyId).invoices.get(invoiceId, options?)`](company-invoices.md#company-invoices-get) | `GET /v1/companies/{company_id}/invoices/{invoice_id}` | Get one invoice, including its `status` and its `verifactu` block (`submission_status`, `qr_url`, `error_code`…). |
+| [`beel.company(companyId).invoices.update(invoiceId, body, options?)`](company-invoices.md#company-invoices-update) | `PATCH /v1/companies/{company_id}/invoices/{invoice_id}` | Update a `DRAFT` or `SCHEDULED` invoice (or an `ACTIVE` proforma). |
+| [`beel.company(companyId).invoices.delete(invoiceId, options?)`](company-invoices.md#company-invoices-delete) | `DELETE /v1/companies/{company_id}/invoices/{invoice_id}` | Delete a draft invoice. |
+| [`beel.company(companyId).invoices.issue(invoiceId, params?, options?)`](company-invoices.md#company-invoices-issue) | `POST /v1/companies/{company_id}/invoices/{invoice_id}/issue` | Issue a draft: assigns its definitive number and makes it immutable. |
+| [`beel.company(companyId).invoices.void(invoiceId, body, options?)`](company-invoices.md#company-invoices-void) | `POST /v1/companies/{company_id}/invoices/{invoice_id}/void` | Void an invoice issued by mistake. |
+| [`beel.company(companyId).invoices.createCorrective(invoiceId, body, options?)`](company-invoices.md#company-invoices-create-corrective) | `POST /v1/companies/{company_id}/invoices/{invoice_id}/corrective` | Create a corrective invoice (rectificativa) for an issued invoice. |
+| [`beel.company(companyId).invoices.convertToInvoice(invoiceId, body?, options?)`](company-invoices.md#company-invoices-convert-to-invoice) | `POST /v1/companies/{company_id}/invoices/{invoice_id}/convert-to-invoice` | Convert a proforma into an invoice. |
+| [`beel.company(companyId).invoices.createSimplifiedExchange(body, options?)`](company-invoices.md#company-invoices-create-simplified-exchange) | `POST /v1/companies/{company_id}/invoices/simplified-exchanges` | Issue a full invoice in exchange for one or more issued simplified invoices, when the customer asks for an invoice with their details. |
+| [`beel.company(companyId).invoices.verifactuRecords(invoiceId, options?)`](company-invoices.md#company-invoices-verifactu-records) | `GET /v1/companies/{company_id}/invoices/{invoice_id}/verifactu-records` | The VeriFactu records of an invoice, oldest first: its registration and, if it was voided, its cancellation. |
+| [`beel.company(companyId).invoices.setStatus(invoiceId, body, options?)`](company-invoices.md#company-invoices-set-status) | `PUT /v1/companies/{company_id}/invoices/{invoice_id}/status` | Set the commercial status: `PAID` (from `ISSUED`, `SENT`, `OVERDUE`), `SENT` (from `ISSUED`) or back to `ISSUED` (from `SENT`). |
+| [`beel.company(companyId).invoices.getPdf(invoiceId, options?)`](company-invoices.md#company-invoices-get-pdf) | `GET /v1/companies/{company_id}/invoices/{invoice_id}/pdf` | Get a short-lived download URL for the invoice PDF. |
+| [`beel.company(companyId).invoices.send(invoiceId, body, options?)`](company-invoices.md#company-invoices-send) | `POST /v1/companies/{company_id}/invoices/{invoice_id}/send` | Send the invoice by email with its PDF. |
+| [`beel.company(companyId).invoices.schedule.get(invoiceId)`](company-invoices-schedule.md#company-invoices-schedule-get) | `GET /v1/companies/{company_id}/invoices/{invoice_id}/schedule` | Get the schedule of an invoice. |
+| [`beel.company(companyId).invoices.schedule.set(invoiceId, body)`](company-invoices-schedule.md#company-invoices-schedule-set) | `PUT /v1/companies/{company_id}/invoices/{invoice_id}/schedule` | Set or move the schedule. |
+| [`beel.company(companyId).invoices.schedule.clear(invoiceId)`](company-invoices-schedule.md#company-invoices-schedule-clear) | `DELETE /v1/companies/{company_id}/invoices/{invoice_id}/schedule` | Clear the schedule, returning the invoice to a plain draft — the canonical form of `unschedule`. |
+| [`beel.company(companyId).paymentConnections.list()`](company-payment-connections.md#company-payment-connections-list) | `GET /v1/companies/{company_id}/payment-connections` | Every payment connection of this company. |
+| [`beel.company(companyId).paymentConnections.authorize(body)`](company-payment-connections.md#company-payment-connections-authorize) | `POST /v1/companies/{company_id}/payment-connections/authorizations` | Start an authorization and get the URL where the NIF's holder approves it. |
+| [`beel.company(companyId).paymentConnections.update(connectionId, body)`](company-payment-connections.md#company-payment-connections-update) | `PATCH /v1/companies/{company_id}/payment-connections/{connection_id}` | Update the settings of one connection, addressed by its UUID. |
+| [`beel.company(companyId).paymentConnections.disconnect(connectionId)`](company-payment-connections.md#company-payment-connections-disconnect) | `DELETE /v1/companies/{company_id}/payment-connections/{connection_id}` | Disconnect one connection. |
+| [`beel.company(companyId).paymentConnections.events(connectionId)`](company-payment-connections.md#company-payment-connections-events) | — | The payment events of one connection — where you audit what did and didn't invoice. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).list(params?)`](company-payment-connections-events.md#company-payment-connections-events-list) | `GET /v1/companies/{company_id}/payment-connections/{connection_id}/events` | Events of the connection, most recent first. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).get(eventId)`](company-payment-connections-events.md#company-payment-connections-events-get) | `GET /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}` | Get one event. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).retry(eventId)`](company-payment-connections-events.md#company-payment-connections-events-retry) | `POST /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/retry` | Reprocess an event whose automatic invoicing didn't complete, applying the NIF's **current** configuration. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).draft(eventId)`](company-payment-connections-events.md#company-payment-connections-events-draft) | `POST /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/draft` | Build a **draft** invoice from an event that couldn't be invoiced automatically, so you can review it before issuing. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).resolve(eventId)`](company-payment-connections-events.md#company-payment-connections-events-resolve) | `POST /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/resolve` | Mark an event as dealt with outside the automatic flow. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).discard(eventId)`](company-payment-connections-events.md#company-payment-connections-events-discard) | `POST /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/discard` | Discard an event so it stops asking for attention. |
+| [`beel.company(companyId).paymentConnections.events(connectionId).restore(eventId)`](company-payment-connections-events.md#company-payment-connections-events-restore) | `POST /v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/restore` | Bring a discarded event back into the list. |
+| [`beel.company(companyId).products.list(params?)`](company-products.md#company-products-list) | `GET /v1/companies/{company_id}/products` | List the company's products, paginated and searchable. |
+| [`beel.company(companyId).products.create(body)`](company-products.md#company-products-create) | `POST /v1/companies/{company_id}/products` | Create a product or service. |
+| [`beel.company(companyId).products.get(productId)`](company-products.md#company-products-get) | `GET /v1/companies/{company_id}/products/{product_id}` | Get one product. |
+| [`beel.company(companyId).products.update(productId, body)`](company-products.md#company-products-update) | `PATCH /v1/companies/{company_id}/products/{product_id}` | Update a product. |
+| [`beel.company(companyId).products.delete(productId)`](company-products.md#company-products-delete) | `DELETE /v1/companies/{company_id}/products/{product_id}` | Delete a product from the catalog. |
+| [`beel.company(companyId).recurringInvoices.list(params?)`](company-recurring-invoices.md#company-recurring-invoices-list) | `GET /v1/companies/{company_id}/recurring-invoices` | List the recurring invoices. |
+| [`beel.company(companyId).recurringInvoices.create(body)`](company-recurring-invoices.md#company-recurring-invoices-create) | `POST /v1/companies/{company_id}/recurring-invoices` | Create a recurring invoice template. |
+| [`beel.company(companyId).recurringInvoices.get(recurringInvoiceId)`](company-recurring-invoices.md#company-recurring-invoices-get) | `GET /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}` | Get one recurring invoice. |
+| [`beel.company(companyId).recurringInvoices.update(recurringInvoiceId, body)`](company-recurring-invoices.md#company-recurring-invoices-update) | `PATCH /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}` | Update a recurring invoice. |
+| [`beel.company(companyId).recurringInvoices.delete(recurringInvoiceId)`](company-recurring-invoices.md#company-recurring-invoices-delete) | `DELETE /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}` | Delete a recurring invoice and cancel its pending generations. |
+| [`beel.company(companyId).recurringInvoices.setStatus(recurringInvoiceId, body)`](company-recurring-invoices.md#company-recurring-invoices-set-status) | `PUT /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/status` | Pause, resume or end the template. |
+| [`beel.company(companyId).recurringInvoices.skip(recurringInvoiceId)`](company-recurring-invoices.md#company-recurring-invoices-skip) | `POST /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/skip` | Skip the next scheduled occurrence. |
+| [`beel.company(companyId).recurringInvoices.generateNow(recurringInvoiceId)`](company-recurring-invoices.md#company-recurring-invoices-generate-now) | `POST /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/generate` | Generate the next invoice now instead of waiting for the schedule. |
+| [`beel.company(companyId).recurringInvoices.nextOccurrence(recurringInvoiceId)`](company-recurring-invoices.md#company-recurring-invoices-next-occurrence) | `GET /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/next-occurrence` | Preview the next invoice the template will generate. |
+| [`beel.company(companyId).recurringInvoices.history(recurringInvoiceId, params?)`](company-recurring-invoices.md#company-recurring-invoices-history) | `GET /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/history` | The generation history of the template: generated, skipped and failed occurrences. |
+| [`beel.company(companyId).series.list(params?)`](company-series.md#company-series-list) | `GET /v1/companies/{company_id}/series` | List the company's series. |
+| [`beel.company(companyId).series.create(body)`](company-series.md#company-series-create) | `POST /v1/companies/{company_id}/series` | Create a series. |
+| [`beel.company(companyId).series.update(seriesId, body)`](company-series.md#company-series-update) | `PATCH /v1/companies/{company_id}/series/{series_id}` | Update a series. |
+| [`beel.company(companyId).series.delete(seriesId)`](company-series.md#company-series-delete) | `DELETE /v1/companies/{company_id}/series/{series_id}` | Delete (soft-delete) a series. |
+| [`beel.company(companyId).series.getDefaults()`](company-series.md#company-series-get-defaults) | `GET /v1/companies/{company_id}/series/defaults` | The current default series per document type. |
+| [`beel.company(companyId).series.ensureDefaults()`](company-series.md#company-series-ensure-defaults) | `PUT /v1/companies/{company_id}/series/defaults` | Ensure a default series exists per document type, creating the missing ones. |
+| [`beel.company(companyId).series.setDefault(seriesId)`](company-series.md#company-series-set-default) | `PUT /v1/companies/{company_id}/series/{series_id}/default` | Mark a series as the default for its document type. |
+| [`beel.company(companyId).taxConfiguration.get()`](company-tax-configuration.md#company-tax-configuration-get) | `GET /v1/companies/{company_id}/tax-configuration` | Get the tax configuration. |
+| [`beel.company(companyId).taxConfiguration.update(body)`](company-tax-configuration.md#company-tax-configuration-update) | `PUT /v1/companies/{company_id}/tax-configuration` | Replace the tax configuration — this is a `PUT`, not a merge: send the whole state. |
+| [`beel.company(companyId).verifactuConfiguration.get()`](company-verifactu-configuration.md#company-verifactu-configuration-get) | `GET /v1/companies/{company_id}/verifactu-configuration` | Get the VeriFactu configuration of this NIF. |
+| [`beel.company(companyId).verifactuConfiguration.update(body)`](company-verifactu-configuration.md#company-verifactu-configuration-update) | `PUT /v1/companies/{company_id}/verifactu-configuration` | Turn VeriFactu on or off for this NIF. |
+| [`beel.nif.validate(nif)`](nif.md#nif-validate) | `POST /v1/nif/validate` | Validate a Spanish NIF/CIF against the AEAT tax registry. |
+| [`CustomerBuilder.create()`](customer-builder.md#customer-builder-create) | — | Start a new builder. |
+| [`CustomerBuilder.name(name)`](customer-builder.md#customer-builder-name) | — | Legal name of the customer. |
+| [`CustomerBuilder.nif(nif)`](customer-builder.md#customer-builder-nif) | — | NIF/CIF of the customer. |
+| [`CustomerBuilder.email(email)`](customer-builder.md#customer-builder-email) | — | Contact email. |
+| [`CustomerBuilder.phone(phone)`](customer-builder.md#customer-builder-phone) | — | Contact phone: 9 to 20 characters of digits, spaces, dashes, parentheses and a leading `+`. |
+| [`CustomerBuilder.address(street, number, postalCode, city, province, country, countryCode?)`](customer-builder.md#customer-builder-address) | — | Fiscal address. |
+| [`CustomerBuilder.notes(notes)`](customer-builder.md#customer-builder-notes) | — | Internal notes about the customer. |
+| [`CustomerBuilder.build()`](customer-builder.md#customer-builder-build) | — | Build the request body. |
+| [`InvoiceBuilder.create()`](invoice-builder.md#invoice-builder-create) | — | Start a new builder. |
+| [`InvoiceBuilder.type(type)`](invoice-builder.md#invoice-builder-type) | — | Set the invoice type. |
+| [`InvoiceBuilder.forCustomer(customerId)`](invoice-builder.md#invoice-builder-for-customer) | — | Invoice a registered customer. |
+| [`InvoiceBuilder.operationDate(date)`](invoice-builder.md#invoice-builder-operation-date) | — | Date the operation took place, when it differs from the issue date. |
+| [`InvoiceBuilder.dueDate(date)`](invoice-builder.md#invoice-builder-due-date) | — | Payment due date. |
+| [`InvoiceBuilder.mainTax(tax)`](invoice-builder.md#invoice-builder-main-tax) | — | Main tax applied to every line added with `addLine` after this call, unless the line passes its own. |
+| [`InvoiceBuilder.addLine(description, quantity, unitPrice, discountPercentage?, mainTax?)`](invoice-builder.md#invoice-builder-add-line) | — | Add a `NORMAL` line. |
+| [`InvoiceBuilder.addLineObject(line)`](invoice-builder.md#invoice-builder-add-line-object) | — | Add a line exactly as given — any line type or pricing mode. |
+| [`InvoiceBuilder.notes(notes)`](invoice-builder.md#invoice-builder-notes) | — | Notes printed on the invoice. |
+| [`InvoiceBuilder.series(id)`](invoice-builder.md#invoice-builder-series) | — | Number the invoice in this series instead of the default one. |
+| [`InvoiceBuilder.metadata(data)`](invoice-builder.md#invoice-builder-metadata) | — | Your own key/value pairs, filterable when listing. |
+| [`InvoiceBuilder.build()`](invoice-builder.md#invoice-builder-build) | — | Build the request body. |
+| [`WebhookVerifier.verify(rawBody, signatureHeader)`](webhook-verifier.md#webhook-verifier-verify) | via `parseSignatureHeader`, `computeSignature`, `secureCompare` | Verify a webhook signature and return the parsed event |
+| [`beel.configuration.getTaxConfig()`](configuration.md#configuration-get-tax-config) | `GET /v1/configuration/taxes` | Get the tax configuration (default VAT, IRPF…) of the focused company. |
+| [`beel.configuration.updateTaxConfig(body)`](configuration.md#configuration-update-tax-config) | `PUT /v1/configuration/taxes` | Replace the tax configuration of the focused company. |
+| [`beel.configuration.getTaxTypes()`](configuration.md#configuration-get-tax-types) | `GET /v1/configuration/tax-types` | Tax types the API accepts (IVA/IGIC rates, IRPF types, equivalence surcharges). |
+| [`beel.configuration.getInvoiceCustomizationOptions()`](configuration.md#configuration-get-invoice-customization-options) | `GET /v1/configuration/invoice-customization-options` | Invoice customization options (templates, colors…). |
+| [`beel.configuration.updateLanguage(language)`](configuration.md#configuration-update-language) | `PUT /v1/configuration/language` | Update the preferred language of the signed-in person. |
+| [`beel.configuration.getVerifactu()`](configuration.md#configuration-get-verifactu) | `GET /v1/configuration/verifactu` | Get the VeriFactu configuration of the focused company. |
+| [`beel.configuration.updateVerifactu(body)`](configuration.md#configuration-update-verifactu) | `PUT /v1/configuration/verifactu` | Update the VeriFactu configuration of the focused company. |
+| [`beel.customers.list(params?)`](customers.md#customers-list) | `GET /v1/customers` | List customers with optional filters and pagination. |
+| [`beel.customers.create(body)`](customers.md#customers-create) | `POST /v1/customers` | Create a new customer. |
+| [`beel.customers.get(id)`](customers.md#customers-get) | `GET /v1/customers/{customer_id}` | Get a customer by ID. |
+| [`beel.customers.update(id, body)`](customers.md#customers-update) | `PUT /v1/customers/{customer_id}` | Update a customer. |
+| [`beel.customers.deactivate(id)`](customers.md#customers-deactivate) | `DELETE /v1/customers/{customer_id}` | Deactivate (soft-delete) a customer. |
+| [`beel.invoices.list(params?)`](invoices.md#invoices-list) | `GET /v1/invoices` | List invoices with optional filters and pagination. |
+| [`beel.invoices.create(body)`](invoices.md#invoices-create) | `POST /v1/invoices` | Create a new invoice. |
+| [`beel.invoices.get(id)`](invoices.md#invoices-get) | `GET /v1/invoices/{invoice_id}` | Get an invoice by ID. |
+| [`beel.invoices.update(id, body)`](invoices.md#invoices-update) | `PUT /v1/invoices/{invoice_id}` | Update a draft invoice. |
+| [`beel.invoices.delete(id)`](invoices.md#invoices-delete) | `DELETE /v1/invoices/{invoice_id}` | Delete a draft invoice. |
+| [`beel.invoices.duplicate(id, options?)`](invoices.md#invoices-duplicate) | `POST /v1/invoices/{invoice_id}/duplicate` | Duplicate an invoice, optionally into a different series. |
+| [`beel.invoices.issue(id, options?)`](invoices.md#invoices-issue) | `POST /v1/invoices/{invoice_id}/issue` | Issue a draft invoice. |
+| [`beel.invoices.markPaid(id, options?)`](invoices.md#invoices-mark-paid) | `POST /v1/invoices/{invoice_id}/mark-paid` | Mark an invoice as paid. |
+| [`beel.invoices.markSent(id, options?)`](invoices.md#invoices-mark-sent) | `POST /v1/invoices/{invoice_id}/mark-sent` | Mark an invoice as sent (e.g. delivered by other means). |
+| [`beel.invoices.revertToIssued(id)`](invoices.md#invoices-revert-to-issued) | `POST /v1/invoices/{invoice_id}/revert-to-issued` | Revert a paid/sent invoice back to issued status. |
+| [`beel.invoices.void(id, params)`](invoices.md#invoices-void) | `POST /v1/invoices/{invoice_id}/void` | Void an issued invoice. |
+| [`beel.invoices.createCorrective(id, body)`](invoices.md#invoices-create-corrective) | `POST /v1/invoices/{invoice_id}/corrective` | Create a corrective invoice that references the original. |
+| [`beel.invoices.schedule(id, params)`](invoices.md#invoices-schedule) | `POST /v1/invoices/{invoice_id}/schedule` | Schedule a draft invoice to be issued on a future date. |
+| [`beel.invoices.unschedule(id)`](invoices.md#invoices-unschedule) | `POST /v1/invoices/{invoice_id}/unschedule` | Cancel a scheduled invoice, returning it to draft. |
+| [`beel.invoices.reschedule(id, params)`](invoices.md#invoices-reschedule) | `PATCH /v1/invoices/{invoice_id}/reschedule` | Change the scheduled date of a scheduled invoice. |
+| [`beel.invoices.getPdf(id)`](invoices.md#invoices-get-pdf) | `GET /v1/invoices/{invoice_id}/pdf` | Get a pre-signed URL to download the invoice PDF. |
+| [`beel.invoices.sendEmail(id, options?)`](invoices.md#invoices-send-email) | `POST /v1/invoices/{invoice_id}/send` | Send an invoice by email. |
+| [`beel.products.list(params?)`](products.md#products-list) | `GET /v1/products` | List products with optional filters and pagination. |
+| [`beel.products.create(body)`](products.md#products-create) | `POST /v1/products` | Create a new product or service. |
+| [`beel.products.get(id)`](products.md#products-get) | `GET /v1/products/{product_id}` | Get a product by ID. |
+| [`beel.products.update(id, body)`](products.md#products-update) | `PUT /v1/products/{product_id}` | Update a product. |
+| [`beel.products.delete(id)`](products.md#products-delete) | `DELETE /v1/products/{product_id}` | Delete a product permanently. |
+| [`beel.products.search(q, limit?)`](products.md#products-search) | `GET /v1/products/search` | Search products by name or code. |
+| [`beel.series.list(active?)`](series.md#series-list) | `GET /v1/configuration/series` | List all invoice series. |
+| [`beel.series.create(body)`](series.md#series-create) | `POST /v1/configuration/series` | Create a new invoice series (e.g. "A-2026", "RECT"). |
+| [`beel.series.update(id, body)`](series.md#series-update) | `PUT /v1/configuration/series/{series_id}` | Update a series (name, description, etc.). |
+| [`beel.series.delete(id)`](series.md#series-delete) | `DELETE /v1/configuration/series/{series_id}` | Delete an invoice series. |
+| [`beel.series.setDefault(id)`](series.md#series-set-default) | `POST /v1/configuration/series/{series_id}/default` | Set a series as the default for new invoices. |

package/docs/reference/account-companies.md

@@ -0,0 +1,55 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.account(accountId).companies` — `AccountCompaniesResource`
+
+[Reference index](README.md)
+
+Companies (NIFs) of an account — where the `companyId` of `beel.company(companyId)`
+comes from. Reach it as `beel.account(accountId).companies`.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.account(accountId).companies.list(params?)`](#account-companies-list) | `GET /v1/accounts/{account_id}/companies` | List the account's companies, primary first. |
+| [`beel.account(accountId).companies.create(body)`](#account-companies-create) | `POST /v1/accounts/{account_id}/companies` | Register a new company (NIF) under the account. |
+| [`beel.account(accountId).companies.stats()`](#account-companies-stats) | `GET /v1/accounts/{account_id}/companies/stats` | Per-company invoice stats: how many fiscal documents each issued, and when last. |
+
+<a id="account-companies-list"></a>
+### `list(params?)`
+
+List the account's companies, primary first. Always paginated (20 by default).
+
+- **HTTP:** `GET /v1/accounts/{account_id}/companies` · operation `listCompanies` · scopes `companies:list`
+- **Parameters:**
+  - `params?: operations['listCompanies']['parameters']['query']` — `search`, `include`, `page`, `limit`.
+- **Returns:** The `companies` of the page and its `pagination`. Response `200` `data`: `{ companies: CompanyData[]; pagination: Pagination }`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+**Example**
+
+```typescript
+const { account_id } = await beel.catalogs.identity();
+const { companies } = await beel.account(account_id).companies.list({ search: 'B12345678' });
+const company = beel.company(companies[0].id!);
+```
+
+<a id="account-companies-create"></a>
+### `create(body)`
+
+Register a new company (NIF) under the account.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/companies` · operation `createCompany` · scopes `companies:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `body: components['schemas']['CreateCompanyRequest']` — NIF, legal name, entity type and address.
+- **Returns:** The created company. Response `201` `data`: `CompanyCreatedData`.
+- **Throws:** `400`/`402`/`500`/`502` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `409` `BeeLConflictError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-companies-stats"></a>
+### `stats()`
+
+Per-company invoice stats: how many fiscal documents each issued, and when last.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/companies/stats` · operation `listCompanyStats` · scopes `companies:list`
+- **Returns:** One entry per company. Response `200` `data`: `{ stats: CompanyStatsData[]; pagination: Pagination }`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`

package/docs/reference/account-invitations.md

@@ -0,0 +1,57 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.account(accountId).invitations` — `AccountInvitationsResource`
+
+[Reference index](README.md)
+
+Invitations to join an account. Reach it as `beel.account(accountId).invitations`.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.account(accountId).invitations.list()`](#account-invitations-list) | `GET /v1/accounts/{account_id}/invitations` | List the account's invitations. |
+| [`beel.account(accountId).invitations.create(body)`](#account-invitations-create) | `POST /v1/accounts/{account_id}/invitations` | Invite someone to join the account. |
+| [`beel.account(accountId).invitations.get(invitationId)`](#account-invitations-get) | `GET /v1/accounts/{account_id}/invitations/{invitation_id}` | Get one invitation. |
+| [`beel.account(accountId).invitations.revoke(invitationId)`](#account-invitations-revoke) | `DELETE /v1/accounts/{account_id}/invitations/{invitation_id}` | Revoke a `PENDING` invitation, so its link stops working. |
+
+<a id="account-invitations-list"></a>
+### `list()`
+
+List the account's invitations.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/invitations` · operation `listAccountInvitations` · scopes `members:read`
+- **Returns:** The invitations. Response `200` `data`: `{ invitations: InvitationSummary[]; pagination: Pagination }`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-invitations-create"></a>
+### `create(body)`
+
+Invite someone to join the account.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/invitations` · operation `createAccountInvitation` · scopes `members:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `body: operations['createAccountInvitation']['requestBody']['content']['application/json']` — `invited_email` and the `account_role` to grant.
+- **Returns:** The invitation. Response `201` `data`: `Invitation`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `409` `BeeLConflictError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-invitations-get"></a>
+### `get(invitationId)`
+
+Get one invitation.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/invitations/{invitation_id}` · operation `getAccountInvitation` · scopes `members:read`
+- **Parameters:**
+  - `invitationId: string` — Invitation UUID.
+- **Returns:** The invitation. Response `200` `data`: `InvitationSummary`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-invitations-revoke"></a>
+### `revoke(invitationId)`
+
+Revoke a `PENDING` invitation, so its link stops working.
+
+- **HTTP:** `DELETE /v1/accounts/{account_id}/invitations/{invitation_id}` · operation `deleteAccountInvitation` · scopes `members:write`
+- **Parameters:**
+  - `invitationId: string` — Invitation UUID.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`

package/docs/reference/account-members.md

@@ -0,0 +1,97 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.account(accountId).members` — `AccountMembersResource`
+
+[Reference index](README.md)
+
+Members of an account and their per-company grants. Reach it as
+`beel.account(accountId).members`.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.account(accountId).members.list()`](#account-members-list) | `GET /v1/accounts/{account_id}/members` | List the account's members. |
+| [`beel.account(accountId).members.get(memberId)`](#account-members-get) | `GET /v1/accounts/{account_id}/members/{member_id}` | Get one member. |
+| [`beel.account(accountId).members.update(memberId, body)`](#account-members-update) | `PATCH /v1/accounts/{account_id}/members/{member_id}` | Change a member's account role. |
+| [`beel.account(accountId).members.remove(memberId)`](#account-members-remove) | `DELETE /v1/accounts/{account_id}/members/{member_id}` | Remove a member from the account. |
+| [`beel.account(accountId).members.listGrants(memberId)`](#account-members-list-grants) | `GET /v1/accounts/{account_id}/members/{member_id}/grants` | List a member's per-company grants. |
+| [`beel.account(accountId).members.putGrant(memberId, companyId, body)`](#account-members-put-grant) | `PUT /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` | Grant a member access to one company, or replace the grant it has. |
+| [`beel.account(accountId).members.removeGrant(memberId, companyId)`](#account-members-remove-grant) | `DELETE /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` | Revoke a member's access to one company. |
+
+<a id="account-members-list"></a>
+### `list()`
+
+List the account's members.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/members` · operation `listAccountMembers` · scopes `members:read`
+- **Returns:** The members (`data.members` of the response), as an array. Response `200` `data`: `{ members: AccountMember[]; pagination: Pagination }`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-members-get"></a>
+### `get(memberId)`
+
+Get one member.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/members/{member_id}` · operation `getAccountMember` · scopes `members:read`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+- **Returns:** The member. Response `200` `data`: `AccountMember`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError`
+
+<a id="account-members-update"></a>
+### `update(memberId, body)`
+
+Change a member's account role.
+
+- **HTTP:** `PATCH /v1/accounts/{account_id}/members/{member_id}` · operation `patchAccountMember` · scopes `members:write`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+  - `body: operations['patchAccountMember']['requestBody']['content']['application/json']` — The new `account_role`.
+- **Returns:** The updated member. Response `200` `data`: `AccountMember`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-members-remove"></a>
+### `remove(memberId)`
+
+Remove a member from the account.
+
+- **HTTP:** `DELETE /v1/accounts/{account_id}/members/{member_id}` · operation `deleteAccountMember` · scopes `members:write`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError`
+
+<a id="account-members-list-grants"></a>
+### `listGrants(memberId)`
+
+List a member's per-company grants.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/members/{member_id}/grants` · operation `listAccountMemberGrants` · scopes `members:read`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+- **Returns:** The `grants` and their `pagination`. Response `200` `data`: `{ grants: MemberGrant[]; pagination: Pagination }`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-members-put-grant"></a>
+### `putGrant(memberId, companyId, body)`
+
+Grant a member access to one company, or replace the grant it has.
+
+- **HTTP:** `PUT /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` · operation `putAccountMemberGrant` · scopes `members:write`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+  - `companyId: string` — Company UUID.
+  - `body: operations['putAccountMemberGrant']['requestBody']['content']['application/json']` — The `access_level` to grant.
+- **Returns:** The grant. Response `200` `data`: `GrantAssignment`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-members-remove-grant"></a>
+### `removeGrant(memberId, companyId)`
+
+Revoke a member's access to one company.
+
+- **HTTP:** `DELETE /v1/accounts/{account_id}/members/{member_id}/grants/{company_id}` · operation `deleteAccountMemberGrant` · scopes `members:write`
+- **Parameters:**
+  - `memberId: string` — Member UUID.
+  - `companyId: string` — Company UUID.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`

package/docs/reference/account-webhooks.md

@@ -0,0 +1,123 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.account(accountId).webhooks` — `AccountWebhooksResource`
+
+[Reference index](README.md)
+
+Webhook subscriptions of an account. Reach it as `beel.account(accountId).webhooks`;
+verify deliveries with `WebhookVerifier`.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.account(accountId).webhooks.list(params?)`](#account-webhooks-list) | `GET /v1/accounts/{account_id}/webhooks` | List the webhook subscriptions. |
+| [`beel.account(accountId).webhooks.create(body)`](#account-webhooks-create) | `POST /v1/accounts/{account_id}/webhooks` | Subscribe an HTTPS endpoint to events. |
+| [`beel.account(accountId).webhooks.get(webhookId)`](#account-webhooks-get) | `GET /v1/accounts/{account_id}/webhooks/{webhook_id}` | Get one webhook subscription. |
+| [`beel.account(accountId).webhooks.update(webhookId, body)`](#account-webhooks-update) | `PATCH /v1/accounts/{account_id}/webhooks/{webhook_id}` | Update a webhook subscription. |
+| [`beel.account(accountId).webhooks.delete(webhookId)`](#account-webhooks-delete) | `DELETE /v1/accounts/{account_id}/webhooks/{webhook_id}` | Delete a webhook subscription. |
+| [`beel.account(accountId).webhooks.test(webhookId)`](#account-webhooks-test) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/test` | Send a test event to the endpoint. |
+| [`beel.account(accountId).webhooks.rotateSecret(webhookId)`](#account-webhooks-rotate-secret) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/secret` | Rotate the signing secret. |
+| [`beel.account(accountId).webhooks.listDeliveries(webhookId, params?)`](#account-webhooks-list-deliveries) | `GET /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries` | List the delivery attempts of a subscription. |
+| [`beel.account(accountId).webhooks.retryDelivery(webhookId, deliveryId)`](#account-webhooks-retry-delivery) | `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries/{delivery_id}/retry` | Retry a failed delivery. |
+
+<a id="account-webhooks-list"></a>
+### `list(params?)`
+
+List the webhook subscriptions.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/webhooks` · operation `listAccountWebhookSubscriptions` · scopes `webhooks:read`
+- **Parameters:**
+  - `params?: operations['listAccountWebhookSubscriptions']['parameters']['query']` — Pagination.
+- **Returns:** The `webhooks` and their `pagination`. Response `200` `data`: `{ webhooks?: WebhookSubscription[]; pagination?: Pagination }`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-webhooks-create"></a>
+### `create(body)`
+
+Subscribe an HTTPS endpoint to events.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/webhooks` · operation `createAccountWebhookSubscription` · scopes `webhooks:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `body: operations['createAccountWebhookSubscription']['requestBody']['content']['application/json']` — `url` and the `events` to receive.
+- **Returns:** The subscription, with its signing secret. Response `201` `data`: `WebhookSubscriptionWithSecret`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-webhooks-get"></a>
+### `get(webhookId)`
+
+Get one webhook subscription.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/webhooks/{webhook_id}` · operation `getAccountWebhookSubscription` · scopes `webhooks:read`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+- **Returns:** The subscription. Response `200` `data`: `WebhookSubscription`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-webhooks-update"></a>
+### `update(webhookId, body)`
+
+Update a webhook subscription. Only the fields present in `body` change.
+
+- **HTTP:** `PATCH /v1/accounts/{account_id}/webhooks/{webhook_id}` · operation `patchAccountWebhookSubscription` · scopes `webhooks:write`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+  - `body: operations['patchAccountWebhookSubscription']['requestBody']['content']['application/json']` — Fields to change.
+- **Returns:** The updated subscription. Response `200` `data`: `WebhookSubscription`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError`
+
+<a id="account-webhooks-delete"></a>
+### `delete(webhookId)`
+
+Delete a webhook subscription.
+
+- **HTTP:** `DELETE /v1/accounts/{account_id}/webhooks/{webhook_id}` · operation `deleteAccountWebhookSubscription` · scopes `webhooks:write`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-webhooks-test"></a>
+### `test(webhookId)`
+
+Send a test event to the endpoint. Test deliveries carry `test: true`.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/test` · operation `testAccountWebhookSubscription` · scopes `webhooks:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+- **Returns:** The outcome of the delivery. Response `200` `data`: `WebhookTestResult`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-webhooks-rotate-secret"></a>
+### `rotateSecret(webhookId)`
+
+Rotate the signing secret. The old secret stops working immediately.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/secret` · operation `rotateAccountWebhookSecret` · scopes `webhooks:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+- **Returns:** The subscription with its new secret. Response `200` `data`: `WebhookSubscriptionWithSecret`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-webhooks-list-deliveries"></a>
+### `listDeliveries(webhookId, params?)`
+
+List the delivery attempts of a subscription.
+
+- **HTTP:** `GET /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries` · operation `listAccountWebhookDeliveries` · scopes `webhooks:read`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+  - `params?: operations['listAccountWebhookDeliveries']['parameters']['query']` — Filters and pagination.
+- **Returns:** The deliveries. Response `200` `data`: `{ deliveries?: WebhookDeliveryLog[]; pagination?: Pagination }`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`
+
+<a id="account-webhooks-retry-delivery"></a>
+### `retryDelivery(webhookId, deliveryId)`
+
+Retry a failed delivery.
+
+- **HTTP:** `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/deliveries/{delivery_id}/retry` · operation `retryAccountWebhookDelivery` · scopes `webhooks:write` · accepts `Idempotency-Key`
+- **Parameters:**
+  - `webhookId: string` — Subscription UUID.
+  - `deliveryId: string` — Delivery UUID.
+- **Returns:** The new delivery attempt. Response `200` `data`: `WebhookDeliveryLog`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `429` `BeeLRateLimitError` · `500` `BeeLApiError`