@beel_es/sdk 2.5.0 → 2.6.0

package/dist/index.d.ts

@@ -5018,6 +5018,161 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/companies/{company_id}/connections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+            };
+            cookie?: never;
+        };
+        /**
+         * List connections
+         * @description Returns the connections of the company in the environment of the credential, most recent
+         *     first, including the disconnected ones.
+         */
+        get: operations["listCompanyConnections"];
+        put?: never;
+        /**
+         * Connect a service
+         * @description Connects a service that needs no authorization, with the `capabilities` you choose or the
+         *     provider's default. The connection is `ACTIVE` at once and `connection.connected` is delivered.
+         */
+        post: operations["createCompanyConnection"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/connections/{connection_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the connection, as returned by the list, by `POST .../connections`, by the `connection.*` webhooks or as the `connection_id` of a reply. */
+                connection_id: components["parameters"]["CompanyConnectionIdParam"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Get a connection
+         * @description Returns a connection of the company, also when it is `DISCONNECTED`.
+         */
+        get: operations["getCompanyConnection"];
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect a service
+         * @description Disconnects the connection: BeeL. stops doing what its `capabilities` allowed, the
+         *     connection stays readable as `DISCONNECTED` and `connection.disconnected` is delivered.
+         *     Repeating it answers `204` and delivers nothing.
+         */
+        delete: operations["disconnectCompanyConnection"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/invoice-replies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+            };
+            cookie?: never;
+        };
+        /**
+         * List invoice replies
+         * @description Returns the replies of the customers of the company about its invoices, on every channel,
+         *     most recent first, each with a masked `excerpt`. Read one with its `text` in
+         *     `GET .../invoice-replies/{reply_id}`.
+         */
+        get: operations["listCompanyInvoiceReplies"];
+        put?: never;
+        /**
+         * Register an invoice reply
+         * @description Registers a message that a customer sent you on a channel of your own about an invoice
+         *     of the company. It is stored with `authenticated_by` `API_KEY` and without a `connection_id`.
+         */
+        post: operations["createCompanyInvoiceReply"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/invoice-replies/{reply_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+                reply_id: components["parameters"]["ReplyIdParam"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Get an invoice reply
+         * @description Returns a reply with its full `text`, without masking and without the quoted original
+         *     message.
+         */
+        get: operations["getCompanyInvoiceReply"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete an invoice reply
+         * @description Erases the text, subject, sender, attachments, `external_id` and `connection_id` of the reply, to answer an
+         *     erasure request, and delivers `invoice.reply.deleted`. Repeating it answers `204` and delivers
+         *     nothing. The same `channel` and `external_id` can no longer be registered: a new attempt answers
+         *     `409` without `reply_id`. Retrying the original registration with its same `Idempotency-Key`
+         *     within 24 hours still replays the original response.
+         */
+        delete: operations["deleteCompanyInvoiceReply"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/invoice-replies/{reply_id}/attachments/{attachment_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+                reply_id: components["parameters"]["ReplyIdParam"];
+                /** @description Unique identifier (UUID) of the attachment, as returned in `attachments` by the reply. */
+                attachment_id: components["parameters"]["AttachmentIdParam"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Get an attachment of an invoice reply
+         * @description Returns the attachment with a temporary `download_url` for its file. BeeL. does not store the file:
+         *     the link is requested when you call this operation and stays valid for about an hour, so call it again
+         *     for a fresh one rather than keeping it. `download_url` and `download_url_expires_at` are `null`
+         *     when there is no file to download: the attachment was registered with `POST .../invoice-replies`,
+         *     or its file is no longer available (see `file_expires_at`).
+         */
+        get: operations["getCompanyInvoiceReplyAttachment"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/email-template-variables": {
         parameters: {
             query?: never;
@@ -5967,6 +6122,9 @@ interface paths {
          *     - **History:** the outcome is recorded as a new entry and the original entry is kept
          *       as it was. `attempt_number` continues the same sequence, so it can exceed the number
          *       of automatic attempts.
+         *     - **Cleared payload:** an `invoice.reply.received` delivery whose `payload` is omitted because
+         *       its reply is past its retention or was deleted cannot be re-sent and answers `404`
+         *       `DELIVERY_LOG_NOT_FOUND`.
          *
          *     **Retires on 9 December 2026.** See the [migration guide](https://docs.beel.es/changelog/resources-under-the-nif) for what moved where and what changes when you switch.
          */
@@ -6072,6 +6230,8 @@ interface paths {
          *       field is `null` when the test could not be run at all.
          *     - **`account_relationship`:** which accounts the subscription receives events from —
          *       `own` (the default), `managed`, or `all`.
+         *     - **Read scope:** subscribing to an event requires the scope that reads what it carries:
+         *       `connections:read` for `connection.*`, `invoice-replies:read` for `invoice.reply.*`. Other events need only `webhooks:write`.
          *     - **Limits:** an account holds at most **10 active subscriptions**; creating an
          *       eleventh is rejected with `400` `WEBHOOK_ACTIVE_SUBSCRIPTION_LIMIT_REACHED`. Registering the same URL twice creates two subscriptions, and
          *       the endpoint then receives each event twice.
@@ -6123,6 +6283,9 @@ interface paths {
          *       successful test delivery before it can be turned back on. Turning a subscription
          *       back on counts towards the limit of 10 active subscriptions, and is rejected with
          *       `400` `WEBHOOK_ACTIVE_SUBSCRIPTION_LIMIT_REACHED` when ten are already active.
+         *     - **Read scope:** any change to a subscription to `connection.*` requires
+         *       `connections:read`, and to `invoice.reply.*` `invoice-replies:read`, whichever field
+         *       changes.
          *     - **Signing secret:** not touched here. Rotate it with
          *       `POST /v1/accounts/{account_id}/webhooks/{webhook_id}/secret`.
          */
@@ -6184,6 +6347,9 @@ interface paths {
          *     - **History:** the outcome is recorded as a new entry and the original entry is kept
          *       as it was. `attempt_number` continues the same sequence, so it can exceed the number
          *       of automatic attempts.
+         *     - **Cleared payload:** an `invoice.reply.received` delivery whose `payload` is omitted because
+         *       its reply is past its retention or was deleted cannot be re-sent and answers `404`
+         *       `DELIVERY_LOG_NOT_FOUND`.
          */
         post: operations["retryAccountWebhookDelivery"];
         delete?: never;
@@ -16058,6 +16224,359 @@ interface components {
             /** @description The defaults of the invoice emails. Omitted keeps them; `null` removes them. */
             defaults?: components["schemas"]["UpdateCompanyEmailDefaults"] | null;
         };
+        /**
+         * @description The service the connection is with. More providers will be added: ignore a connection
+         *     whose provider you do not know.
+         *
+         *     - `beel_email`: replies to the email of each invoice, received at an address of BeeL.
+         *       Supports `receive_customer_replies`; one per company and environment.
+         * @example beel_email
+         */
+        CompanyConnectionProvider: string;
+        /**
+         * @description Whether the connection works. More values may be added: treat an unknown one as a
+         *     connection that does nothing.
+         *
+         *     - `ACTIVE`: it works with all its `capabilities`.
+         *     - `DISCONNECTED`: final. It does nothing and stays readable for traceability.
+         * @example ACTIVE
+         */
+        CompanyConnectionStatus: string;
+        /**
+         * @description How BeeL. authenticates on the service, set by the provider. More values will be added.
+         *
+         *     - `NONE`: no credential; creating the connection turns it on.
+         * @example NONE
+         */
+        CompanyConnectionAuthType: string;
+        /**
+         * @description Something BeeL. may do through the connection, chosen when connecting among the ones the
+         *     provider supports. More values will be added: ignore one you do not know.
+         *
+         *     - `receive_customer_replies`: receive the replies of the customers of the company about
+         *       its invoices, listed in `.../invoice-replies` with the `connection_id`.
+         * @example receive_customer_replies
+         */
+        CompanyConnectionCapability: string;
+        /**
+         * @description Details of a `beel_email` connection. It needs the `email` of the company: BeeL. adds an
+         *     address at `reply_domain` after it in the `Reply-To` of the email of each invoice.
+         */
+        CompanyConnectionBeelEmail: {
+            /**
+             * @description Domain of the reply address of BeeL. Allow it in any filter that checks the replies
+             *     of your customers.
+             * @example reply.beel.es
+             */
+            reply_domain: string;
+        };
+        /**
+         * @description A service the company has connected, in the environment of the credential that created
+         *     it. Credentials are never part of it. The details of each provider go under a property
+         *     named like it, present only on its connections.
+         */
+        CompanyConnection: {
+            /**
+             * Format: uuid
+             * @description Unique identifier of the connection, the `{connection_id}` that addresses it.
+             * @example 8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41
+             */
+            id: string;
+            provider: components["schemas"]["CompanyConnectionProvider"];
+            auth_type: components["schemas"]["CompanyConnectionAuthType"];
+            /**
+             * @description What BeeL. may do through the connection, as chosen when it was connected.
+             * @example [
+             *       "receive_customer_replies"
+             *     ]
+             */
+            capabilities: components["schemas"]["CompanyConnectionCapability"][];
+            status: components["schemas"]["CompanyConnectionStatus"];
+            /**
+             * Format: date-time
+             * @description When the connection was created, in UTC.
+             * @example 2026-11-03T08:00:00Z
+             */
+            created_at: string;
+            /**
+             * Format: date-time
+             * @description When the connection was disconnected, in UTC; `null` while it is not `DISCONNECTED`.
+             * @example null
+             */
+            disconnected_at: string | null;
+            beel_email?: components["schemas"]["CompanyConnectionBeelEmail"];
+        };
+        CreateCompanyConnectionRequest: {
+            provider: components["schemas"]["CompanyConnectionProvider"];
+            /**
+             * @description What BeeL. may do through the connection. Omit it, or send it empty, to get the
+             *     provider's default (`receive_customer_replies` for `beel_email`).
+             * @example [
+             *       "receive_customer_replies"
+             *     ]
+             */
+            capabilities?: components["schemas"]["CompanyConnectionCapability"][];
+        };
+        /**
+         * @description Where the customer wrote: the medium, not the `provider` of the connection that brought
+         *     it (an email is `EMAIL` whatever received it). More values may be added: treat an
+         *     unknown one like `OTHER`.
+         *
+         *     - `EMAIL`: an email; `sender.address` is an email address.
+         *     - `WHATSAPP`: `sender.address` is a phone number in E.164 format.
+         *     - `TELEGRAM`: `sender.address` is the user identifier on Telegram.
+         *     - `SLACK`: `sender.address` is the user identifier on Slack.
+         *     - `SMS`: `sender.address` is a phone number in E.164 format.
+         *     - `OTHER`: any other channel, such as the chat of your product.
+         * @example EMAIL
+         */
+        InvoiceReplyChannel: string;
+        /**
+         * @description What links the message to its invoice, never who wrote it (`sender` is not verified).
+         *     More values may be added: treat an unknown one like `API_KEY`.
+         *
+         *     - `REPLY_TOKEN`: an answer to the email of one invoice, sent to the address unique to
+         *       that email.
+         *     - `API_KEY`: registered by an integrator with `POST .../invoice-replies`, who chose the
+         *       invoice.
+         * @example REPLY_TOKEN
+         */
+        InvoiceReplyAuthentication: string;
+        /**
+         * @description Where the reply is in its lifecycle. More values will be added: treat an unknown value as
+         *     an open reply.
+         *
+         *     - `RECEIVED`: the reply is stored.
+         * @example RECEIVED
+         */
+        InvoiceReplyStatus: string;
+        /**
+         * @description What every view of a reply carries. 12 months after `received_at`, its content, subject,
+         *     sender, attachments and `external_id` become `null`; the rest stays.
+         */
+        InvoiceReplyBase: {
+            /**
+             * Format: uuid
+             * @example 3f0c9a1e-6b2d-4c8f-a1e5-7d9b0c2e4f61
+             */
+            id: string;
+            channel: components["schemas"]["InvoiceReplyChannel"];
+            authenticated_by: components["schemas"]["InvoiceReplyAuthentication"];
+            /**
+             * Format: uuid
+             * @description The connection of the company the message arrived through (`.../connections/{connection_id}`). `null` when it was registered with `POST .../invoice-replies`: you received it, not BeeL.
+             * @example 8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41
+             */
+            connection_id: string | null;
+            /**
+             * Format: uuid
+             * @description The invoice the message is about. Every reply has one today; channels added in the future may store a reply without it, so handle `null`.
+             * @example b71d5e2a-9c3f-4a7b-8e10-2f6d4c8a9b13
+             */
+            invoice_id: string | null;
+            /**
+             * @description Number of that invoice; `null` when `invoice_id` is `null`.
+             * @example F2026-0142
+             */
+            invoice_number: string | null;
+            /**
+             * Format: uuid
+             * @description The customer of the invoice; `null` when the invoice has a one-off recipient or `invoice_id` is `null`.
+             * @example 7a2c9e14-3b5d-4f6a-8c0e-1d2b3a4c5e6f
+             */
+            customer_id: string | null;
+            status: components["schemas"]["InvoiceReplyStatus"];
+            /**
+             * Format: date-time
+             * @description When the message was received, in UTC: when BeeL. received it, or the moment given when it was registered.
+             * @example 2026-11-03T09:12:44Z
+             */
+            received_at: string;
+            /**
+             * @description Subject of the message, with tax IDs, IBANs, email addresses and phone numbers masked. `null` when the message has none, as on every channel but `EMAIL`, and once the reply is past its retention of 12 months after `received_at`.
+             * @example RE: Factura F2026-0142
+             */
+            subject: string | null;
+            /**
+             * @description First paragraph of the text of the message, without the quoted original email, with tax IDs, IBANs, email addresses and phone numbers replaced by `[NIF]`, `[IBAN]`, `[EMAIL]` and `[PHONE]`. `null` when the message has no text, and once the reply is past its retention of 12 months after `received_at`.
+             * @example Hola, el CIF que aparece no es el nuestro, es [NIF]. ¿Podéis corregirla?
+             */
+            excerpt: string | null;
+        };
+        /** @description Who the message says it comes from, with the same masking as the webhook: the address only, masked by type. It is not verified: never use it alone to authorize a change. The name is in the detail. */
+        InvoiceReplySummarySender: {
+            /**
+             * @description Masked as `[EMAIL]`, `[PHONE]` or `[ID]` according to `channel`. `null` once the reply is past its retention of 12 months after `received_at`.
+             * @example [EMAIL]
+             */
+            address: string | null;
+        };
+        /** @description An attachment of the reply. BeeL. does not store the file: a temporary download link is requested when you read the attachment at its `url`. */
+        InvoiceReplyAttachmentSummary: {
+            /**
+             * Format: uuid
+             * @description Identifier of the attachment, stable across reads.
+             * @example 5b0e2c7a-91d4-4f3e-8a6b-2c1d9e0f7a34
+             */
+            id: string;
+            /**
+             * Format: uri-reference
+             * @description Relative URL of the attachment resource. Relative to the API base URL (e.g., https://app.beel.es/api). Note it is a link to a link: reading it returns a temporary download link, or `download_url: null` when there is no file or it has expired.
+             * @example /v1/companies/9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f/invoice-replies/3f0c9a1e-6b2d-4c8f-a1e5-7d9b0c2e4f61/attachments/5b0e2c7a-91d4-4f3e-8a6b-2c1d9e0f7a34
+             */
+            url: string;
+            /**
+             * Format: date-time
+             * @description Estimate of when the file stops being available. `null` when the attachment has no downloadable file, as with those registered with `POST .../invoice-replies`.
+             * @example 2026-11-18T10:15:00Z
+             */
+            file_expires_at: string | null;
+            /**
+             * @description Media type declared by the channel.
+             * @example application/pdf
+             */
+            content_type: string;
+            /**
+             * Format: int64
+             * @description Size of the file; `null` when the channel does not report it.
+             * @example 48213
+             */
+            size_bytes: number | null;
+        };
+        /** @description A reply as listed, with the same masking as the webhook: masked `excerpt`, `subject` and `sender.address`, no sender name, no `external_id`, and attachments without file names. */
+        InvoiceReplySummary: components["schemas"]["InvoiceReplyBase"] & {
+            sender: components["schemas"]["InvoiceReplySummarySender"];
+            /** @description Attachments of the message. Empty when it has none; `null` once the reply is past its retention of 12 months after `received_at`. */
+            attachments: components["schemas"]["InvoiceReplyAttachmentSummary"][] | null;
+        };
+        InvoiceReplySenderRequest: {
+            /**
+             * @description Identifier of the sender on the channel. With `EMAIL` it must be an email address, and with `WHATSAPP` and `SMS` a phone number in E.164 format (`+34600000000`); otherwise `422` `VALUE_OUT_OF_RANGE`. With the other channels, the user identifier the channel gives.
+             * @example +34600123456
+             */
+            address: string;
+            /**
+             * @description Display name of the sender. Omit the field when there is none.
+             * @example Laura Gómez
+             */
+            name?: string;
+        };
+        InvoiceReplyAttachmentRequest: {
+            /**
+             * @description Name of the file. Omit the field when there is none.
+             * @example justificante-transferencia.pdf
+             */
+            filename?: string;
+            /**
+             * @description Media type of the file.
+             * @example application/pdf
+             */
+            content_type: string;
+            /**
+             * Format: int64
+             * @description Size of the file. Omit the field when you do not know it.
+             * @example 48213
+             */
+            size_bytes?: number;
+        };
+        CreateInvoiceReplyRequest: {
+            /**
+             * Format: uuid
+             * @description An invoice or proforma of the company that is not a draft or scheduled, in the environment of the credential.
+             * @example b71d5e2a-9c3f-4a7b-8e10-2f6d4c8a9b13
+             */
+            invoice_id: string;
+            channel: components["schemas"]["InvoiceReplyChannel"];
+            /**
+             * @description Identifier of the message on its channel: the `Message-ID` for `EMAIL`, the message identifier of the provider for messaging channels, your own for `OTHER`. A second message with the same `channel` and `external_id` answers `409` `INVOICE_REPLY_DUPLICATE`.
+             * @example wamid.EXAMPLE0001
+             */
+            external_id: string;
+            sender: components["schemas"]["InvoiceReplySenderRequest"];
+            /**
+             * Format: date-time
+             * @description When you received the message. Omit it to use the moment of the call. A moment more than 5 minutes ahead answers `422` `VALUE_OUT_OF_RANGE`.
+             * @example 2026-11-03T09:12:44Z
+             */
+            received_at?: string;
+            /**
+             * @description Subject of the message. Omit the field when the channel has none.
+             * @example RE: Factura F2026-0142
+             */
+            subject?: string;
+            /**
+             * @description Text of the message, without the quoted messages it answers. Omit it when the message has no text; then `attachments` is required.
+             * @example Hola, ¿podéis mandarme la factura a nombre de Distribuciones Ejemplo S.L.?
+             */
+            text?: string;
+            /** @description Attachments to describe. Only their description is stored, never a file. */
+            attachments?: components["schemas"]["InvoiceReplyAttachmentRequest"][];
+        };
+        /** @description Who the message says it comes from, as the channel reported it or as the integrator sent it. It is not verified: never use it alone to authorize a change. */
+        InvoiceReplySender: {
+            /**
+             * @description Identifier of the sender on the channel: an email address for `EMAIL`, a phone number in E.164 format for `WHATSAPP` and `SMS`, the user identifier of the channel otherwise. Masked as `[EMAIL]`, `[PHONE]` or `[ID]` according to `channel`. `null` once the reply is past its retention of 12 months after `received_at`.
+             * @example [EMAIL]
+             */
+            address: string | null;
+            /**
+             * @description Display name of the sender, when the channel carries one. `null` otherwise, and once the reply is past its retention of 12 months after `received_at`.
+             * @example Laura Gómez
+             */
+            name: string | null;
+        };
+        /** @description An attachment of the reply, with its file name. */
+        InvoiceReplyAttachment: components["schemas"]["InvoiceReplyAttachmentSummary"] & {
+            /**
+             * @description Name of the file; `null` when the channel gives none, as with a photo.
+             * @example justificante-transferencia.pdf
+             */
+            filename: string | null;
+        };
+        /** @description A reply about an invoice, with its full text, `external_id` and file names. */
+        InvoiceReply: components["schemas"]["InvoiceReplyBase"] & {
+            sender: components["schemas"]["InvoiceReplySender"];
+            /**
+             * @description Identifier of the message on its channel: the `Message-ID` of the email, without angle brackets, or the identifier sent when it was registered. A message is stored once per `channel` and `external_id` in each company and environment. `null` once the reply is past its retention of 12 months after `received_at`; the message still cannot be registered again.
+             * @example CAH7xQ2b9pLk3mZ0@mail.distribuciones-ejemplo.es
+             */
+            external_id: string | null;
+            /** @description Attachments of the message. Empty when it has none; `null` once the reply is past its retention of 12 months after `received_at`. */
+            attachments: components["schemas"]["InvoiceReplyAttachment"][] | null;
+            /**
+             * @description Text of the message without the quoted original email and without masking. HTML is converted to plain text. On the `EMAIL` channel, link annotations such as `<mailto:...>` that only repeat the text before them are removed. `null` when the message has no text, as a photo without a caption, and once the reply is past its retention of 12 months after `received_at`.
+             * @example Hola, el CIF que aparece no es el nuestro, es B87654315. ¿Podéis corregirla?
+             *     Gracias,
+             *     Laura
+             */
+            text: string | null;
+            /**
+             * @description `true` when the text was longer than 20,000 characters and was cut.
+             * @example false
+             */
+            is_text_truncated: boolean;
+        };
+        InvoiceReplyResponse: components["schemas"]["SuccessResponse"] & {
+            data: components["schemas"]["InvoiceReply"];
+        };
+        /** @description An attachment of the reply with a temporary link to download its file. */
+        InvoiceReplyAttachmentDetail: components["schemas"]["InvoiceReplyAttachment"] & {
+            /**
+             * Format: uri
+             * @description Temporary link to the file. `null` when there is no file to download or it is no longer available.
+             * @example https://files.example.com/attachments/5b0e2c7a/justificante-transferencia.pdf?signature=abc123
+             */
+            download_url: string | null;
+            /**
+             * Format: date-time
+             * @description When `download_url` stops working, about an hour after the request. `null` with it.
+             * @example 2026-11-09T11:15:00Z
+             */
+            download_url_expires_at: string | null;
+        };
+        InvoiceReplyAttachmentResponse: components["schemas"]["SuccessResponse"] & {
+            data: components["schemas"]["InvoiceReplyAttachmentDetail"];
+        };
         /**
          * @description Name of a variable of the email templates.
          *
@@ -16559,17 +17078,24 @@ interface components {
          *     - `email_domain.failed` — A sending domain of the account became `FAILED`; sent once per transition
          *     - `email_domain.removed` — A sending domain of the account was removed, with a `reason` (`EXPIRED`,
          *       `DELETED_BY_USER` or `DELETED_AT_PROVIDER`); sent once per removal
+         *     - `connection.connected` — A service of a company was connected
+         *     - `connection.disconnected` — A service of a company was disconnected; sent once
+         *     - `invoice.reply.received` — A customer replied about an invoice, on any channel
+         *     - `invoice.reply.deleted` — The company deleted a reply about an invoice; sent once
          *     - `invoice.email.bounced` — The email of an invoice bounced or was marked as spam, with a `reason`
          *       (`BOUNCED` or `COMPLAINED`); sent once per email
          *
          *     The `email_domain.*` events belong to the account: they are delivered only to its live
          *     endpoints, never to the account that manages it, and `company_id` and `nif` are not set (absent or `null`).
          *
+         *     The `connection.*` and `invoice.reply.*` events are delivered only to the endpoints of the account that
+         *     owns the company, never to an account that manages it.
+         *
          *     The `account.*` events are delivered only to the **provisioner** that created the
          *     account; a subscription on any other account never receives them.
          * @enum {string}
          */
-        WebhookEventTypeEnum: "invoice.issued" | "invoice.email.sent" | "invoice.pdf.generated" | "invoice.voided" | "recurring_invoice.paused" | "invoice.schedule_failed" | "verifactu.status.updated" | "account.claimed" | "company.created" | "representation.signed" | "email_domain.verified" | "email_domain.failed" | "email_domain.removed" | "invoice.email.bounced";
+        WebhookEventTypeEnum: "invoice.issued" | "invoice.email.sent" | "invoice.pdf.generated" | "invoice.voided" | "recurring_invoice.paused" | "invoice.schedule_failed" | "verifactu.status.updated" | "account.claimed" | "company.created" | "representation.signed" | "email_domain.verified" | "email_domain.failed" | "email_domain.removed" | "connection.connected" | "connection.disconnected" | "invoice.reply.received" | "invoice.reply.deleted" | "invoice.email.bounced";
         CreateWebhookSubscriptionRequest: {
             /**
              * Format: uri
@@ -16895,6 +17421,49 @@ interface components {
             last_checked_at?: string | null;
             reason: components["schemas"]["EmailDomainRemovalReason"];
         };
+        /** @description Data payload for `connection.connected` and `connection.disconnected` events: the connection as it is after the change. Credentials are never part of it. */
+        WebhookEventDataConnection: {
+            /** Format: uuid */
+            connection_id: string;
+            provider: components["schemas"]["CompanyConnectionProvider"];
+            auth_type: components["schemas"]["CompanyConnectionAuthType"];
+            capabilities: components["schemas"]["CompanyConnectionCapability"][];
+            status: components["schemas"]["CompanyConnectionStatus"];
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            disconnected_at: string | null;
+        };
+        /** @description Data payload for `invoice.reply.received` events: the reply as a summary. `subject`, `excerpt` and `sender.address` are masked, and it carries no `external_id`, sender name or file names; the full reply is in `GET /v1/companies/{company_id}/invoice-replies/{reply_id}`. */
+        WebhookEventDataInvoiceReplyReceived: {
+            /** Format: uuid */
+            reply_id: string;
+            channel: components["schemas"]["InvoiceReplyChannel"];
+            /** Format: uuid */
+            connection_id: string | null;
+            /** Format: uuid */
+            invoice_id: string | null;
+            invoice_number: string | null;
+            authenticated_by: components["schemas"]["InvoiceReplyAuthentication"];
+            /** Format: uuid */
+            customer_id: string | null;
+            /** Format: date-time */
+            received_at: string;
+            sender: components["schemas"]["InvoiceReplySummarySender"];
+            subject: string | null;
+            /** @description First paragraph of the text of the message, without the quoted original email, with tax IDs, IBANs, email addresses and phone numbers replaced by `[NIF]`, `[IBAN]`, `[EMAIL]` and `[PHONE]`. `null` when the message has no text. */
+            excerpt: string | null;
+            attachments: components["schemas"]["InvoiceReplyAttachmentSummary"][];
+        };
+        /** @description Data payload for `invoice.reply.deleted` events. Identifiers only. An `invoice.reply.received` with the same `reply_id` that arrives after it is a late retry: discard it. */
+        WebhookEventDataInvoiceReplyDeleted: {
+            /** Format: uuid */
+            reply_id: string;
+            /** Format: uuid */
+            invoice_id: string | null;
+            /** Format: date-time */
+            deleted_at: string;
+        };
         /**
          * @description Why the email was not delivered: the recipient's server rejected it (`BOUNCED`) or the recipient
          *     marked it as spam (`COMPLAINED`).
@@ -16941,7 +17510,7 @@ interface components {
              */
             company_id?: string | null;
             /**
-             * @description NIF of the company the event is about.
+             * @description NIF of the company the event is about, or `null` (or absent) if the company has none.
              * @example B12345674
              */
             nif?: string | null;
@@ -16959,7 +17528,7 @@ interface components {
              */
             account_external_ref?: string | null;
             account_relationship?: components["schemas"]["WebhookEventAccountRelationship"];
-            data: components["schemas"]["WebhookEventDataInvoiceIssued"] | components["schemas"]["WebhookEventDataInvoiceEmailSent"] | components["schemas"]["WebhookEventDataInvoicePdfGenerated"] | components["schemas"]["WebhookEventDataInvoiceVoided"] | components["schemas"]["WebhookEventDataRecurringInvoicePaused"] | components["schemas"]["WebhookEventDataInvoiceScheduleFailed"] | components["schemas"]["WebhookEventDataVeriFactuStatusUpdated"] | components["schemas"]["WebhookEventDataAccountClaimed"] | components["schemas"]["WebhookEventDataCompanyCreated"] | components["schemas"]["WebhookEventDataRepresentationSigned"] | components["schemas"]["WebhookEventDataEmailDomain"] | components["schemas"]["WebhookEventDataEmailDomainRemoved"] | components["schemas"]["WebhookEventDataInvoiceEmailBounced"];
+            data: components["schemas"]["WebhookEventDataInvoiceIssued"] | components["schemas"]["WebhookEventDataInvoiceEmailSent"] | components["schemas"]["WebhookEventDataInvoicePdfGenerated"] | components["schemas"]["WebhookEventDataInvoiceVoided"] | components["schemas"]["WebhookEventDataRecurringInvoicePaused"] | components["schemas"]["WebhookEventDataInvoiceScheduleFailed"] | components["schemas"]["WebhookEventDataVeriFactuStatusUpdated"] | components["schemas"]["WebhookEventDataAccountClaimed"] | components["schemas"]["WebhookEventDataCompanyCreated"] | components["schemas"]["WebhookEventDataRepresentationSigned"] | components["schemas"]["WebhookEventDataEmailDomain"] | components["schemas"]["WebhookEventDataEmailDomainRemoved"] | components["schemas"]["WebhookEventDataConnection"] | components["schemas"]["WebhookEventDataInvoiceReplyReceived"] | components["schemas"]["WebhookEventDataInvoiceReplyDeleted"] | components["schemas"]["WebhookEventDataInvoiceEmailBounced"];
         };
         UpdateWebhookSubscriptionRequest: {
             /**
@@ -16994,7 +17563,7 @@ interface components {
              * @example 200
              */
             http_status?: number | null;
-            /** @description Body returned by your endpoint, kept for troubleshooting. Stored up to 2048 characters; longer responses are cut and `response_body_truncated` is true. */
+            /** @description Body returned by your endpoint, kept for troubleshooting. Stored up to 2048 characters; longer responses are cut and `response_body_truncated` is true. Omitted when your credential lacks the read scope of the event type, like `payload`, and once `payload` is cleared; `response_body_truncated` then keeps its last value. */
             response_body?: string | null;
             /** @description True when your endpoint returned more than 2048 characters and `response_body` holds only the beginning of it. */
             response_body_truncated?: boolean;
@@ -17006,9 +17575,9 @@ interface components {
             /** @description Delivery duration in milliseconds. */
             duration_ms?: number | null;
             success?: boolean;
-            /** @description Error description for failed deliveries (timeout, connection error, etc.) */
+            /** @description Error description for failed deliveries (timeout, connection error, etc.). It starts with `EVENT_UNSUBSCRIBED` when the subscription no longer included the event type by the time it was due, so nothing was sent. */
             error_message?: string | null;
-            /** @description The JSON payload that was sent (or attempted) to your endpoint. */
+            /** @description The JSON payload that was sent (or attempted) to your endpoint. Omitted when your credential lacks the read scope of the event type (`connections:read` for `connection.*`, `invoice-replies:read` for `invoice.reply.*`). For `invoice.reply.received` events, also omitted once the reply is past its retention of 12 months after `received_at`, and shortly after the reply is deleted; such a delivery can no longer be retried. `invoice.reply.deleted` deliveries carry identifiers only and are kept. */
             payload?: string | null;
             /**
              * @description HTTP headers sent to your endpoint with this delivery attempt.
@@ -17913,6 +18482,61 @@ interface components {
                 "application/json": components["schemas"]["ErrorResponse"];
             };
         };
+        /**
+         * @description One of:
+         *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+         *     - `COMPANY_READ_ONLY`: only the `OWNER` and `ADMIN` members of the account that owns the
+         *       company read its connections.
+         *     - `INSUFFICIENT_SCOPE`: the credential lacks the scope of the operation, a privileged
+         *       `connections:*` scope.
+         */
+        ConnectionCompanyForbidden: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        /**
+         * @description The connection does not exist or belongs to another company or environment
+         *     (`COMPANY_CONNECTION_NOT_FOUND`).
+         */
+        CompanyConnectionNotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                /**
+                 * @example {
+                 *       "success": false,
+                 *       "error": {
+                 *         "code": "COMPANY_CONNECTION_NOT_FOUND",
+                 *         "message": "Connection not found."
+                 *       },
+                 *       "meta": {
+                 *         "timestamp": "2026-11-03T09:20:03Z",
+                 *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        /**
+         * @description One of:
+         *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+         *     - `INSUFFICIENT_SCOPE`: the credential lacks `invoice-replies:read`, a privileged scope
+         *       that a key created without selecting scopes does not hold.
+         */
+        InvoiceReplyReadForbidden: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
         /** @description `CONNECTION_NOT_FOUND` — no connection of this NIF carries this `{connection_id}`. It speaks of the connection, never of the NIF: a NIF you cannot reach answers `403`, while a connection of another NIF answers this same `404` so that naming it reveals nothing. */
         PaymentConnectionNotFound: {
             headers: {
@@ -18160,6 +18784,14 @@ interface components {
         AccountIdPath: string;
         /** @description Membership unique UUID. */
         MemberIdPath: string;
+        /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+        CompanyIdPathParam: string;
+        /** @description Unique identifier (UUID) of the connection, as returned by the list, by `POST .../connections`, by the `connection.*` webhooks or as the `connection_id` of a reply. */
+        CompanyConnectionIdParam: string;
+        /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+        ReplyIdParam: string;
+        /** @description Unique identifier (UUID) of the attachment, as returned in `attachments` by the reply. */
+        AttachmentIdParam: string;
         /** @description Unique identifier (UUID) of the payment connection the operation acts on, as returned by `GET /v1/companies/{company_id}/payment-connections`. A NIF can hold several connections of the same provider, so the provider slug alone does not name one. A connection of another NIF answers `404`, exactly like one that does not exist. */
         PaymentConnectionIdParam: string;
         /** @description Unique identifier (UUID) of the company the events belong to — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
@@ -34217,51 +34849,586 @@ interface operations {
             };
             path: {
                 /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
-                company_id: string;
+                company_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "sender": {
+                 *         "source": "EMAIL_DOMAIN",
+                 *         "email_domain_id": "550e8400-e29b-41d4-a716-446655440000",
+                 *         "local_part": "cobros"
+                 *       },
+                 *       "defaults": {
+                 *         "subject": "Invoice {invoiceNumber}",
+                 *         "message": "Dear {customerName}, please find attached invoice {invoiceNumber}.",
+                 *         "cc": [
+                 *           "administracion@ejemplo.com"
+                 *         ]
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["UpdateCompanyEmailConfigurationRequest"];
+            };
+        };
+        responses: {
+            /** @description Email configuration of the company after the change */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"] & {
+                        data: components["schemas"]["CompanyEmailConfiguration"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, does not hold write access over it,
+             *     or the credential is a test one (`LIVE_CREDENTIAL_REQUIRED`). Not owning the company answers
+             *     `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`; a credential without the `companies:write`
+             *     scope answers `INSUFFICIENT_SCOPE`. Sending `defaults` without the email customization
+             *     plan answers `FEATURE_NOT_AVAILABLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description The email domain does not exist, belongs to another account or was removed
+             *     (`error.code` `EMAIL_DOMAIN_NOT_FOUND`).
+             */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description The email domain is still being registered and cannot be chosen yet
+             *     (`error.code` `EMAIL_DOMAIN_NOT_READY`).
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description A property is not valid, or the combination of `source`, `email_domain_id` and
+             *     `local_part` is not allowed (`error.code` `VALIDATION_ERROR`). Send values that follow
+             *     the format described for the operation.
+             */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    listCompanyConnections: {
+        parameters: {
+            query?: {
+                /**
+                 * @description Page number, starting at 1. The response echoes it back as `pagination.current_page`.
+                 * @example 1
+                 */
+                page?: components["parameters"]["PageParam"];
+                /**
+                 * @description How many items to return per page. The response echoes it back as `pagination.items_per_page`.
+                 * @example 20
+                 */
+                limit?: components["parameters"]["LimitParam"];
+                /** @description Keep only the connections with these providers. Accepts a comma-separated list. */
+                provider?: components["schemas"]["CompanyConnectionProvider"][];
+                /**
+                 * @description Keep only the connections in these statuses. Accepts a comma-separated list, for
+                 *     example `status=ACTIVE`.
+                 */
+                status?: components["schemas"]["CompanyConnectionStatus"][];
+            };
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connections of the company */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": true,
+                     *       "data": {
+                     *         "connections": [
+                     *           {
+                     *             "id": "8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41",
+                     *             "provider": "beel_email",
+                     *             "auth_type": "NONE",
+                     *             "capabilities": [
+                     *               "receive_customer_replies"
+                     *             ],
+                     *             "status": "ACTIVE",
+                     *             "created_at": "2026-11-03T08:00:00Z",
+                     *             "disconnected_at": null,
+                     *             "beel_email": {
+                     *               "reply_domain": "reply.beel.es"
+                     *             }
+                     *           }
+                     *         ],
+                     *         "pagination": {
+                     *           "current_page": 1,
+                     *           "total_pages": 1,
+                     *           "total_items": 1,
+                     *           "items_per_page": 20,
+                     *           "has_next": false,
+                     *           "has_previous": false
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SuccessResponse"] & {
+                        data: {
+                            connections: components["schemas"]["CompanyConnection"][];
+                            pagination: components["schemas"]["Pagination"];
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["ConnectionCompanyForbidden"];
+            422: components["responses"]["UnprocessableQueryParameter"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    createCompanyConnection: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Idempotency key to prevent duplicates in sensitive operations.
+                 *
+                 *     - Any unique client-generated string (e.g. an order id). A UUID also works but is not required
+                 *     - Allowed characters: letters, digits, `_` and `-` (max 255 chars)
+                 *     - Retrying with the same key replays the first response when it was a success (2xx) or a
+                 *       server error (5xx): same status and body, plus the header `Idempotency-Replay: true`.
+                 *       After a 5xx other than 503, check whether the operation took effect before retrying with a **new** key
+                 *     - After a `503`, retry first with the **same** key. If the response carries `Idempotency-Replay: true`,
+                 *       the operation may have taken effect: check the resource before using a new key. Without that header,
+                 *       the retry runs the operation once
+                 *     - A 4xx is not stored: the key is released, so the corrected request can reuse it
+                 *     - Stored responses expire 24 hours after processing
+                 *
+                 *     The key is scoped per user and environment, and bound to the request body, so retrying after
+                 *     a network timeout replays the stored response instead of repeating the operation.
+                 *
+                 *     | Status | Code | When |
+                 *     |---|---|---|
+                 *     | `400` | `INVALID_IDEMPOTENCY_KEY` | The key breaks the format rules above. |
+                 *     | `409` | `IDEMPOTENCY_KEY_PROCESSING` | The first request is still in flight. Wait for the `Retry-After` seconds (2) and retry with the same key. |
+                 *     | `409` | `IDEMPOTENCY_KEY_MISMATCH` | The key was already used with a **different** body. Use a new key. |
+                 * @example invoice-order-12345
+                 */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKeyHeader"];
+            };
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "provider": "beel_email",
+                 *       "capabilities": [
+                 *         "receive_customer_replies"
+                 *       ]
+                 *     }
+                 */
+                "application/json": components["schemas"]["CreateCompanyConnectionRequest"];
+            };
+        };
+        responses: {
+            /** @description Service connected. `Location` points at the connection. */
+            201: {
+                headers: {
+                    Location: components["headers"]["CreatedResourceLocation"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": true,
+                     *       "data": {
+                     *         "id": "8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41",
+                     *         "provider": "beel_email",
+                     *         "auth_type": "NONE",
+                     *         "capabilities": [
+                     *           "receive_customer_replies"
+                     *         ],
+                     *         "status": "ACTIVE",
+                     *         "created_at": "2026-11-03T08:00:00Z",
+                     *         "disconnected_at": null,
+                     *         "beel_email": {
+                     *           "reply_domain": "reply.beel.es"
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SuccessResponse"] & {
+                        data: components["schemas"]["CompanyConnection"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description One of:
+             *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+             *     - `COMPANY_READ_ONLY`: only the `OWNER` and `ADMIN` members of the account that owns
+             *       the company manage its connections.
+             *     - `INSUFFICIENT_SCOPE`: the credential lacks `connections:write`, a privileged
+             *       scope.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description One of:
+             *     - `CONNECTION_DUPLICATE`: the provider allows one live connection per company and
+             *       environment, and it exists; see `error.details.connection_id`.
+             *     - The idempotency conflicts of `Idempotency-Key`.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CONNECTION_DUPLICATE",
+                     *         "message": "The company already has a connection with this provider.",
+                     *         "details": {
+                     *           "connection_id": "8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41",
+                     *           "provider": "beel_email"
+                     *         }
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-11-03T08:00:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description One of:
+             *     - `CONNECTION_PROVIDER_NOT_SUPPORTED`: BeeL. does not connect that `provider`.
+             *     - `CONNECTION_CAPABILITY_NOT_SUPPORTED`: the provider does not support a capability;
+             *       see `error.details.capability`.
+             *     - `CONNECTION_REPLY_TO_REQUIRED`: `beel_email` needs the `email` of the company. It
+             *       is checked before `409`.
+             *     - `VALIDATION_ERROR`: the body breaks a declared constraint; see `error.details`.
+             */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CONNECTION_REPLY_TO_REQUIRED",
+                     *         "message": "Set the email of the company before connecting the reply capture by email."
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-11-03T08:00:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    getCompanyConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the connection, as returned by the list, by `POST .../connections`, by the `connection.*` webhooks or as the `connection_id` of a reply. */
+                connection_id: components["parameters"]["CompanyConnectionIdParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The connection */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"] & {
+                        data: components["schemas"]["CompanyConnection"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["ConnectionCompanyForbidden"];
+            404: components["responses"]["CompanyConnectionNotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    disconnectCompanyConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the connection, as returned by the list, by `POST .../connections`, by the `connection.*` webhooks or as the `connection_id` of a reply. */
+                connection_id: components["parameters"]["CompanyConnectionIdParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Service disconnected */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description One of:
+             *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+             *     - `COMPANY_READ_ONLY`: only the `OWNER` and `ADMIN` members of the account that owns
+             *       the company manage its connections.
+             *     - `INSUFFICIENT_SCOPE`: the credential lacks `connections:write`, a privileged
+             *       scope.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: components["responses"]["CompanyConnectionNotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    listCompanyInvoiceReplies: {
+        parameters: {
+            query?: {
+                /**
+                 * @description Page number, starting at 1. The response echoes it back as `pagination.current_page`.
+                 * @example 1
+                 */
+                page?: components["parameters"]["PageParam"];
+                /**
+                 * @description How many items to return per page. The response echoes it back as `pagination.items_per_page`.
+                 * @example 20
+                 */
+                limit?: components["parameters"]["LimitParam"];
+                /** @description Keep only the replies about this invoice. */
+                invoice_id?: string;
+                /** @description Keep only the replies that arrived through this connection. The replies registered with `POST .../invoice-replies` have no connection, so they never match. */
+                connection_id?: string;
+                /** @description Keep only the replies about invoices of this customer. */
+                customer_id?: string;
+                /**
+                 * @description Keep only the replies received on these channels. Accepts a comma-separated list, for
+                 *     example `channel=WHATSAPP,SMS`. A value BeeL. does not know matches nothing.
+                 */
+                channel?: components["schemas"]["InvoiceReplyChannel"][];
+                /** @description Keep only the replies received at or after this instant. */
+                from?: string;
+                /** @description Keep only the replies received at or before this instant. */
+                to?: string;
+                /** @description Direction of the sort by `received_at`. Ties are broken by `id`. */
+                sort_order?: components["schemas"]["SortOrder"];
+            };
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Replies of the company */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": true,
+                     *       "data": {
+                     *         "replies": [
+                     *           {
+                     *             "id": "3f0c9a1e-6b2d-4c8f-a1e5-7d9b0c2e4f61",
+                     *             "channel": "EMAIL",
+                     *             "authenticated_by": "REPLY_TOKEN",
+                     *             "connection_id": "8c3e1f7a-2b4d-4e6f-9a1c-5d7b3e9f2a41",
+                     *             "invoice_id": "b71d5e2a-9c3f-4a7b-8e10-2f6d4c8a9b13",
+                     *             "invoice_number": "F2026-0142",
+                     *             "customer_id": "7a2c9e14-3b5d-4f6a-8c0e-1d2b3a4c5e6f",
+                     *             "status": "RECEIVED",
+                     *             "received_at": "2026-11-03T09:12:44Z",
+                     *             "sender": {
+                     *               "address": "[EMAIL]"
+                     *             },
+                     *             "subject": "RE: Factura F2026-0142",
+                     *             "excerpt": "Hola, el CIF que aparece no es el nuestro, es [NIF]. ¿Podéis corregirla?",
+                     *             "attachments": []
+                     *           }
+                     *         ],
+                     *         "pagination": {
+                     *           "current_page": 1,
+                     *           "total_pages": 1,
+                     *           "total_items": 1,
+                     *           "items_per_page": 20,
+                     *           "has_next": false,
+                     *           "has_previous": false
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SuccessResponse"] & {
+                        data: {
+                            replies: components["schemas"]["InvoiceReplySummary"][];
+                            pagination: components["schemas"]["Pagination"];
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["InvoiceReplyReadForbidden"];
+            422: components["responses"]["UnprocessableQueryParameter"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    createCompanyInvoiceReply: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Idempotency key to prevent duplicates in sensitive operations.
+                 *
+                 *     - Any unique client-generated string (e.g. an order id). A UUID also works but is not required
+                 *     - Allowed characters: letters, digits, `_` and `-` (max 255 chars)
+                 *     - Retrying with the same key replays the first response when it was a success (2xx) or a
+                 *       server error (5xx): same status and body, plus the header `Idempotency-Replay: true`.
+                 *       After a 5xx other than 503, check whether the operation took effect before retrying with a **new** key
+                 *     - After a `503`, retry first with the **same** key. If the response carries `Idempotency-Replay: true`,
+                 *       the operation may have taken effect: check the resource before using a new key. Without that header,
+                 *       the retry runs the operation once
+                 *     - A 4xx is not stored: the key is released, so the corrected request can reuse it
+                 *     - Stored responses expire 24 hours after processing
+                 *
+                 *     The key is scoped per user and environment, and bound to the request body, so retrying after
+                 *     a network timeout replays the stored response instead of repeating the operation.
+                 *
+                 *     | Status | Code | When |
+                 *     |---|---|---|
+                 *     | `400` | `INVALID_IDEMPOTENCY_KEY` | The key breaks the format rules above. |
+                 *     | `409` | `IDEMPOTENCY_KEY_PROCESSING` | The first request is still in flight. Wait for the `Retry-After` seconds (2) and retry with the same key. |
+                 *     | `409` | `IDEMPOTENCY_KEY_MISMATCH` | The key was already used with a **different** body. Use a new key. |
+                 * @example invoice-order-12345
+                 */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKeyHeader"];
+            };
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                /**
-                 * @example {
-                 *       "sender": {
-                 *         "source": "EMAIL_DOMAIN",
-                 *         "email_domain_id": "550e8400-e29b-41d4-a716-446655440000",
-                 *         "local_part": "cobros"
-                 *       },
-                 *       "defaults": {
-                 *         "subject": "Invoice {invoiceNumber}",
-                 *         "message": "Dear {customerName}, please find attached invoice {invoiceNumber}.",
-                 *         "cc": [
-                 *           "administracion@ejemplo.com"
-                 *         ]
-                 *       }
-                 *     }
-                 */
-                "application/json": components["schemas"]["UpdateCompanyEmailConfigurationRequest"];
+                "application/json": components["schemas"]["CreateInvoiceReplyRequest"];
             };
         };
         responses: {
-            /** @description Email configuration of the company after the change */
-            200: {
+            /** @description Reply registered. `Location` points at the reply. */
+            201: {
                 headers: {
+                    Location: components["headers"]["CreatedResourceLocation"];
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SuccessResponse"] & {
-                        data: components["schemas"]["CompanyEmailConfiguration"];
-                    };
+                    "application/json": components["schemas"]["InvoiceReplyResponse"];
                 };
             };
             400: components["responses"]["BadRequest"];
             401: components["responses"]["Unauthorized"];
             /**
-             * @description Your account does not own or manage this company, does not hold write access over it,
-             *     or the credential is a test one (`LIVE_CREDENTIAL_REQUIRED`). Not owning the company answers
-             *     `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`; a credential without the `companies:write`
-             *     scope answers `INSUFFICIENT_SCOPE`. Sending `defaults` without the email customization
-             *     plan answers `FEATURE_NOT_AVAILABLE`.
+             * @description One of:
+             *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+             *     - `COMPANY_READ_ONLY`: your account does not hold write access over it. Write access
+             *       is enough, also as an account that manages the company.
+             *     - `INSUFFICIENT_SCOPE`: the credential lacks `invoice-replies:write`, a privileged
+             *       scope that a key created without selecting scopes does not hold.
              */
             403: {
                 headers: {
@@ -34271,10 +35438,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /**
-             * @description The email domain does not exist, belongs to another account or was removed
-             *     (`error.code` `EMAIL_DOMAIN_NOT_FOUND`).
-             */
+            /** @description The invoice does not exist or belongs to another company (`INVOICE_NOT_FOUND`). */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -34284,21 +35448,43 @@ interface operations {
                 };
             };
             /**
-             * @description The email domain is still being registered and cannot be chosen yet
-             *     (`error.code` `EMAIL_DOMAIN_NOT_READY`).
+             * @description One of:
+             *     - `INVOICE_REPLY_DUPLICATE`: a reply with the same `channel` and `external_id` already
+             *       exists; its identifier is in `error.details.reply_id`, absent when that reply was
+             *       deleted.
+             *     - `INVOICE_REPLY_INVOICE_NOT_ISSUED`: the invoice is a draft or a scheduled invoice.
+             *     - The idempotency conflicts of `Idempotency-Key`.
              */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "INVOICE_REPLY_DUPLICATE",
+                     *         "message": "A reply with this channel and external identifier already exists.",
+                     *         "details": {
+                     *           "reply_id": "3f0c9a1e-6b2d-4c8f-a1e5-7d9b0c2e4f61"
+                     *         }
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-11-03T09:12:44Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             /**
-             * @description A property is not valid, or the combination of `source`, `email_domain_id` and
-             *     `local_part` is not allowed (`error.code` `VALIDATION_ERROR`). Send values that follow
-             *     the format described for the operation.
+             * @description `VALIDATION_ERROR` when the body breaks this schema, with the field in `error.details`.
+             *     A body that fits the schema but not the rules answers, with the field in `error.details`:
+             *     - `MISSING_REQUIRED_FIELD`: neither `text` nor `attachments`;
+             *     - `VALUE_OUT_OF_RANGE`: a `channel` BeeL. does not know, a `sender.address` that does
+             *       not fit its `channel`, or a `received_at` more than 5 minutes ahead.
              */
             422: {
                 headers: {
@@ -34313,6 +35499,161 @@ interface operations {
             default: components["responses"]["UnexpectedError"];
         };
     };
+    getCompanyInvoiceReply: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+                reply_id: components["parameters"]["ReplyIdParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The reply */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvoiceReplyResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["InvoiceReplyReadForbidden"];
+            /**
+             * @description The reply does not exist or belongs to another company or environment
+             *     (`INVOICE_REPLY_NOT_FOUND`).
+             */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    deleteCompanyInvoiceReply: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+                reply_id: components["parameters"]["ReplyIdParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Reply deleted, or already deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description One of:
+             *     - `ACTIVE_COMPANY_NOT_ACCESSIBLE`: your account does not own or manage this company.
+             *     - `COMPANY_READ_ONLY`: your account does not hold write access over it. Write access
+             *       is enough, also as an account that manages the company.
+             *     - `INSUFFICIENT_SCOPE`: the credential lacks `invoice-replies:write`, a privileged
+             *       scope that a key created without selecting scopes does not hold.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description The reply never existed or belongs to another company or environment
+             *     (`INVOICE_REPLY_NOT_FOUND`).
+             */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    getCompanyInvoiceReplyAttachment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Unique identifier (UUID) of the company the operation acts on: its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. */
+                company_id: components["parameters"]["CompanyIdPathParam"];
+                /** @description Unique identifier (UUID) of the reply, as returned by the list or by `POST .../invoice-replies`. */
+                reply_id: components["parameters"]["ReplyIdParam"];
+                /** @description Unique identifier (UUID) of the attachment, as returned in `attachments` by the reply. */
+                attachment_id: components["parameters"]["AttachmentIdParam"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The attachment, with its download link when there is a file. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvoiceReplyAttachmentResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["InvoiceReplyReadForbidden"];
+            /**
+             * @description One of:
+             *     - `INVOICE_REPLY_NOT_FOUND`: the reply does not exist or belongs to another company or environment.
+             *     - `INVOICE_REPLY_ATTACHMENT_NOT_FOUND`: the reply has no attachment with that identifier, or it
+             *       has been erased.
+             */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            /**
+             * @description `EXTERNAL_SERVICE_ERROR` — the download link could not be requested from the email service.
+             *     It is transient; repeat the request later.
+             */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
     listEmailTemplateVariables: {
         parameters: {
             query?: never;
@@ -36772,7 +38113,15 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
+            /** @description `INSUFFICIENT_SCOPE`: the credential lacks the read scope of an event of the subscription (`connections:read` for `connection.*`, `invoice-replies:read` for `invoice.reply.*`). `error.details.event_types` lists those events, comma-separated. The shared causes also apply. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             422: components["responses"]["WebhookSubscriptionValidationError"];
             429: components["responses"]["TooManyRequests"];
             500: components["responses"]["InternalServerError"];
@@ -36872,7 +38221,15 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
+            /** @description `INSUFFICIENT_SCOPE`: the credential lacks the read scope of an event of the subscription (`connections:read` for `connection.*`, `invoice-replies:read` for `invoice.reply.*`). `error.details.event_types` lists those events, comma-separated. The shared causes also apply. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             404: components["responses"]["NotFound"];
             422: components["responses"]["WebhookSubscriptionValidationError"];
             429: components["responses"]["TooManyRequests"];
@@ -38252,7 +39609,7 @@ declare function createBeeLClient(config: BeeLConfig): openapi_fetch.Client<path
 type BeeLClient = ReturnType<typeof createBeeLClient>;
 
 type Invoice$1 = components['schemas']['Invoice'];
-type Pagination$5 = components['schemas']['Pagination'];
+type Pagination$6 = components['schemas']['Pagination'];
 type ListParams$2 = operations['listInvoices']['parameters']['query'];
 /**
  * Invoices of the focused company, on the flat `/v1/invoices` routes.
@@ -38273,7 +39630,7 @@ declare class InvoicesResource {
      */
     list(params?: ListParams$2): Promise<{
         invoices: Invoice$1[];
-        pagination: Pagination$5;
+        pagination: Pagination$6;
     }>;
     /**
      * Create a new invoice. An idempotency key is automatically added.
@@ -39134,7 +40491,7 @@ declare class InvoicesResource {
 }
 
 type Customer$1 = components['schemas']['Customer'];
-type Pagination$4 = components['schemas']['Pagination'];
+type Pagination$5 = components['schemas']['Pagination'];
 type ListParams$1 = operations['listCustomers']['parameters']['query'];
 /**
  * Customers of the focused company, on the flat `/v1/customers` routes.
@@ -39155,7 +40512,7 @@ declare class CustomersResource {
      */
     list(params?: ListParams$1): Promise<{
         customers: Customer$1[];
-        pagination: Pagination$4;
+        pagination: Pagination$5;
     }>;
     /**
      * Create a new customer.
@@ -39249,7 +40606,7 @@ declare class CustomersResource {
 }
 
 type Product$1 = components['schemas']['Product'];
-type Pagination$3 = components['schemas']['Pagination'];
+type Pagination$4 = components['schemas']['Pagination'];
 type ListParams = operations['listProducts']['parameters']['query'];
 /**
  * Products of the focused company, on the flat `/v1/products` routes.
@@ -39270,7 +40627,7 @@ declare class ProductsResource {
      */
     list(params?: ListParams): Promise<{
         products: Product$1[];
-        pagination: Pagination$3;
+        pagination: Pagination$4;
     }>;
     /**
      * Create a new product or service.
@@ -39790,7 +41147,7 @@ declare class NifResource {
 type ManagedAccountSummary = components['schemas']['ManagedAccountSummary'];
 type WebhookSubscription = components['schemas']['WebhookSubscription'];
 type CompanyData = components['schemas']['CompanyData'];
-type Pagination$2 = components['schemas']['Pagination'];
+type Pagination$3 = components['schemas']['Pagination'];
 /**
  * Accounts you provisioned and manage (multi-account provisioning for platforms and
  * advisory firms). Reach it as `beel.accounts`; scope one with `beel.account(accountId)`.
@@ -40115,7 +41472,7 @@ declare class AccountWebhooksResource {
      */
     list(params?: operations['listAccountWebhookSubscriptions']['parameters']['query']): Promise<{
         webhooks?: WebhookSubscription[];
-        pagination?: Pagination$2;
+        pagination?: Pagination$3;
     }>;
     /**
      * Subscribe an HTTPS endpoint to events.
@@ -40319,7 +41676,7 @@ declare class AccountCompaniesResource {
      */
     list(params?: operations['listCompanies']['parameters']['query']): Promise<{
         companies: CompanyData[];
-        pagination: Pagination$2 | undefined;
+        pagination: Pagination$3 | undefined;
     }>;
     /**
      * Register a new company (NIF) under the account.
@@ -40422,7 +41779,7 @@ interface RequestOptions {
 
 type ManagedPaymentConnection = components['schemas']['ManagedPaymentConnection'];
 type ManagedPaymentEvent = components['schemas']['ManagedPaymentEvent'];
-type Pagination$1 = components['schemas']['Pagination'];
+type Pagination$2 = components['schemas']['Pagination'];
 type PaymentEventCounts = components['schemas']['PaymentEventCounts'];
 /**
  * Payment connections of a company (NIF): the Stripe Connect link whose charges
@@ -40527,7 +41884,7 @@ declare class CompanyPaymentEventsResource {
      */
     list(params?: operations['listCompanyPaymentEvents']['parameters']['query']): Promise<{
         events: ManagedPaymentEvent[];
-        pagination?: Pagination$1;
+        pagination?: Pagination$2;
         counts?: PaymentEventCounts;
     }>;
     /**
@@ -40749,6 +42106,148 @@ declare class CompanyPaymentEventsResource {
     }>;
 }
 
+type InvoiceReplySummary = components['schemas']['InvoiceReplySummary'];
+type Pagination$1 = components['schemas']['Pagination'];
+/**
+ * Replies of the customers of a company about its invoices, on any channel. Reach it as
+ * `beel.company(companyId).invoiceReplies`.
+ *
+ * The list masks personal data; {@link get} returns the full text. An attachment is read
+ * with {@link getAttachment}, which returns a temporary download link for its file.
+ *
+ * @example
+ * ```typescript
+ * const replies = beel.company('company-uuid').invoiceReplies;
+ * const { replies: page } = await replies.list({ invoice_id: 'invoice-uuid' });
+ * const reply = await replies.get(page[0].id);
+ * const attachment = await replies.getAttachment(reply.id, reply.attachments![0].id);
+ * if (attachment.download_url) console.log(attachment.download_url);
+ * ```
+ */
+declare class CompanyInvoiceRepliesResource {
+    private client;
+    private companyId;
+    constructor(client: BeeLClient, companyId: string);
+    private path;
+    /**
+     * List the replies of the company, most recent first, with masked `excerpt`, `subject`
+     * and sender.
+     *
+     * @param params - Filters (`invoice_id`, `customer_id`, `channel`, `from`, `to`…) and pagination.
+     * @param options - Per-call `idempotencyKey`, `signal` and `timeoutMs`.
+     * @returns The page of `replies` and its `pagination`.
+     *
+     * @example
+     * ```typescript
+     * const { replies } = await company.invoiceReplies.list({ invoice_id: 'invoice-uuid' });
+     * ```
+     */
+    list(params?: operations['listCompanyInvoiceReplies']['parameters']['query'], options?: RequestOptions): Promise<{
+        replies: InvoiceReplySummary[];
+        pagination: Pagination$1;
+    }>;
+    /**
+     * Register a message that a customer sent you on a channel of your own about an invoice.
+     *
+     * @param body - The invoice, `channel`, `external_id`, sender and the text or attachments.
+     * @param options - Per-call `idempotencyKey`, `signal` and `timeoutMs`.
+     * @returns The registered reply.
+     *
+     * @example
+     * ```typescript
+     * await company.invoiceReplies.create({
+     *   invoice_id: 'invoice-uuid',
+     *   channel: 'WHATSAPP',
+     *   external_id: 'wamid.EXAMPLE0001',
+     *   sender: { address: '+34600123456' },
+     *   text: 'Can you send it to Distribuciones Ejemplo S.L.?',
+     * });
+     * ```
+     */
+    create(body: components['schemas']['CreateInvoiceReplyRequest'], options?: RequestOptions): Promise<{
+        id: string;
+        channel: components["schemas"]["InvoiceReplyChannel"];
+        authenticated_by: components["schemas"]["InvoiceReplyAuthentication"];
+        connection_id: string | null;
+        invoice_id: string | null;
+        invoice_number: string | null;
+        customer_id: string | null;
+        status: components["schemas"]["InvoiceReplyStatus"];
+        received_at: string;
+        subject: string | null;
+        excerpt: string | null;
+    } & {
+        sender: components["schemas"]["InvoiceReplySender"];
+        external_id: string | null;
+        attachments: components["schemas"]["InvoiceReplyAttachment"][] | null;
+        text: string | null;
+        is_text_truncated: boolean;
+    }>;
+    /**
+     * Get one reply with its full text and the file names of its attachments.
+     *
+     * @param replyId - Reply UUID, from {@link list}.
+     * @param options - Per-call `idempotencyKey`, `signal` and `timeoutMs`.
+     * @returns The reply.
+     */
+    get(replyId: string, options?: RequestOptions): Promise<{
+        id: string;
+        channel: components["schemas"]["InvoiceReplyChannel"];
+        authenticated_by: components["schemas"]["InvoiceReplyAuthentication"];
+        connection_id: string | null;
+        invoice_id: string | null;
+        invoice_number: string | null;
+        customer_id: string | null;
+        status: components["schemas"]["InvoiceReplyStatus"];
+        received_at: string;
+        subject: string | null;
+        excerpt: string | null;
+    } & {
+        sender: components["schemas"]["InvoiceReplySender"];
+        external_id: string | null;
+        attachments: components["schemas"]["InvoiceReplyAttachment"][] | null;
+        text: string | null;
+        is_text_truncated: boolean;
+    }>;
+    /**
+     * Delete a reply: its content is erased. Deleting it again also succeeds.
+     *
+     * @param replyId - Reply UUID.
+     * @param options - Per-call `idempotencyKey`, `signal` and `timeoutMs`.
+     */
+    delete(replyId: string, options?: RequestOptions): Promise<void>;
+    /**
+     * Get an attachment of a reply with a temporary `download_url` for its file. The link is
+     * requested on each call and expires at `download_url_expires_at`: call again for a fresh
+     * one rather than storing it. Both are `null` when there is no file to download.
+     *
+     * @param replyId - Reply UUID.
+     * @param attachmentId - Attachment UUID, from the `attachments` of the reply.
+     * @param options - Per-call `idempotencyKey`, `signal` and `timeoutMs`.
+     * @returns The attachment, with `download_url` and `download_url_expires_at`.
+     *
+     * @example
+     * ```typescript
+     * const attachment = await company.invoiceReplies.getAttachment(replyId, attachmentId);
+     * if (attachment.download_url) {
+     *   const file = await fetch(attachment.download_url);
+     * }
+     * ```
+     */
+    getAttachment(replyId: string, attachmentId: string, options?: RequestOptions): Promise<{
+        id: string;
+        url: string;
+        file_expires_at: string | null;
+        content_type: string;
+        size_bytes: number | null;
+    } & {
+        filename: string | null;
+    } & {
+        download_url: string | null;
+        download_url_expires_at: string | null;
+    }>;
+}
+
 type CreateInvoiceRequest$1 = components['schemas']['CreateInvoiceRequest'];
 /**
  * Invoice types whose `external_ref` the API keeps unique: at most one live (not deleted)
@@ -40803,6 +42302,8 @@ declare class CompanyScope {
     readonly recurringInvoices: CompanyRecurringInvoicesResource;
     /** Payment provider connections (Stripe) that auto-generate invoices under this NIF. */
     readonly paymentConnections: CompanyPaymentConnectionsResource;
+    /** Replies of the customers of this company about its invoices, and their attachments. */
+    readonly invoiceReplies: CompanyInvoiceRepliesResource;
     /** Default taxes of this company. */
     readonly taxConfiguration: CompanyTaxConfigurationResource;
     /** Whether this NIF submits its invoices to AEAT under VeriFactu. */
@@ -43540,7 +45041,15 @@ declare enum WebhookEventType {
     INVOICE_SCHEDULE_FAILED = "invoice.schedule_failed",
     ACCOUNT_CLAIMED = "account.claimed",
     COMPANY_CREATED = "company.created",
-    REPRESENTATION_SIGNED = "representation.signed"
+    REPRESENTATION_SIGNED = "representation.signed",
+    EMAIL_DOMAIN_VERIFIED = "email_domain.verified",
+    EMAIL_DOMAIN_FAILED = "email_domain.failed",
+    EMAIL_DOMAIN_REMOVED = "email_domain.removed",
+    CONNECTION_CONNECTED = "connection.connected",
+    CONNECTION_DISCONNECTED = "connection.disconnected",
+    INVOICE_REPLY_RECEIVED = "invoice.reply.received",
+    INVOICE_REPLY_DELETED = "invoice.reply.deleted",
+    INVOICE_EMAIL_BOUNCED = "invoice.email.bounced"
 }
 
 /**
@@ -43681,6 +45190,105 @@ type WebhookEventDataInvoicePdfGenerated = {
     generation?: number;
 };
 
+/**
+ * Payload for `invoice.reply.deleted` events. Identifiers only. An `invoice.reply.received` with the same `reply_id` that arrives after it is a late retry: discard it.
+ */
+type WebhookEventDataInvoiceReplyDeleted = {
+    /**
+     * The deleted reply. Reading it answers `404`.
+     */
+    reply_id: string;
+    /**
+     * The invoice the reply was about, as in `invoice.reply.received`.
+     */
+    invoice_id: string | null;
+    /**
+     * When the reply was deleted, in UTC.
+     */
+    deleted_at: string;
+};
+
+/**
+ * What links the message to its invoice; it never verifies `sender`. Same values as `authenticated_by` in the Public API. Treat an unknown value like `API_KEY`.
+ */
+type WebhookInvoiceReplyAuthentication = string;
+
+/**
+ * Where the customer wrote the message. Same values as `channel` in the Public API. More values may be added: treat an unknown one like `OTHER`, and do not assume a subject or an email address.
+ */
+type WebhookInvoiceReplyChannel = string;
+
+/**
+ * Payload for `invoice.reply.received` events: the reply as a summary. `subject`, `excerpt`
+ * and `sender.address` are masked, and it carries no `external_id`, sender name or file
+ * names. The full reply is in `GET /v1/companies/{company_id}/invoice-replies/{reply_id}`.
+ *
+ */
+type WebhookEventDataInvoiceReplyReceived = {
+    /**
+     * The reply. Read it with `GET /v1/companies/{company_id}/invoice-replies/{reply_id}`.
+     */
+    reply_id: string;
+    channel: WebhookInvoiceReplyChannel;
+    /**
+     * The connection the message arrived through; `null` when it was registered with `POST .../invoice-replies`.
+     */
+    connection_id: string | null;
+    /**
+     * The invoice the message is about. Every reply has one today, so handle `null` for channels added later.
+     */
+    invoice_id: string | null;
+    /**
+     * Number of that invoice; `null` when `invoice_id` is `null`.
+     */
+    invoice_number: string | null;
+    authenticated_by: WebhookInvoiceReplyAuthentication;
+    /**
+     * The customer of the invoice; `null` for a one-off recipient or when `invoice_id` is `null`.
+     */
+    customer_id: string | null;
+    /**
+     * When the message was received, in UTC.
+     */
+    received_at: string;
+    /**
+     * Who the message says it comes from. It is not verified: never use it alone to authorize a change.
+     */
+    sender: {
+        /**
+         * Identifier of the sender on the channel, masked by type as `[EMAIL]`, `[PHONE]` or `[ID]`.
+         */
+        address: string;
+    };
+    /**
+     * Subject of the message, with tax IDs, IBANs, email addresses and phone numbers masked; `null` when the message has none, as on every channel but `EMAIL`.
+     */
+    subject: string | null;
+    /**
+     * First paragraph of the text, without the quoted original message, with tax IDs, IBANs, email addresses and phone numbers replaced by `[NIF]`, `[IBAN]`, `[EMAIL]` and `[PHONE]`. `null` when the message has no text.
+     */
+    excerpt: string | null;
+    /**
+     * Attachments of the message. The files are not stored; read each one at its `url` for a temporary download link.
+     */
+    attachments: Array<{
+        /**
+         * Identifier of the attachment, stable across reads.
+         */
+        id: string;
+        /**
+         * Relative URL of the attachment resource. Relative to the API base URL (e.g., https://app.beel.es/api). Note it is a link to a link: reading it returns a temporary download link, or `download_url: null` when there is no file or it has expired.
+         */
+        url: string;
+        /**
+         * Estimate of when the file stops being available. `null` when the attachment has no downloadable file, as with those registered with `POST .../invoice-replies`.
+         */
+        file_expires_at: string | null;
+        content_type: string;
+        size_bytes: number | null;
+    }>;
+};
+
 /**
  * Payload for `invoice.schedule_failed` events.
  */
@@ -44059,6 +45667,10 @@ type AccountClaimedEvent = BusinessEvent<'account.claimed', WebhookEventDataAcco
 type CompanyCreatedEvent = BusinessEvent<'company.created', WebhookEventDataCompanyCreated>;
 /** `representation.signed`: a representation document was signed. */
 type RepresentationSignedEvent = BusinessEvent<'representation.signed', WebhookEventDataRepresentationSigned>;
+/** `invoice.reply.received`: a customer replied about an invoice; the full reply is read with `invoiceReplies.get`. */
+type InvoiceReplyReceivedEvent = BusinessEvent<'invoice.reply.received', WebhookEventDataInvoiceReplyReceived>;
+/** `invoice.reply.deleted`: a reply was deleted; it carries identifiers only. */
+type InvoiceReplyDeletedEvent = BusinessEvent<'invoice.reply.deleted', WebhookEventDataInvoiceReplyDeleted>;
 /**
  * A delivery sent with "Send test": `test` is `true` and `data` is a synthetic message,
  * whatever `type` says. Check `event.test` before narrowing on `event.type`.
@@ -44071,7 +45683,7 @@ type WebhookTestEvent = Omit<WebhookEventEnvelope$1, 'type' | 'test'> & {
 /**
  * Union type of all possible webhook events
  */
-type WebhookEvent = VeriFactuStatusUpdatedEvent | InvoiceIssuedEvent | InvoiceVoidedEvent | InvoiceEmailSentEvent | InvoicePdfGeneratedEvent | InvoiceScheduleFailedEvent | RecurringInvoicePausedEvent | AccountClaimedEvent | CompanyCreatedEvent | RepresentationSignedEvent | WebhookTestEvent;
+type WebhookEvent = VeriFactuStatusUpdatedEvent | InvoiceIssuedEvent | InvoiceVoidedEvent | InvoiceEmailSentEvent | InvoicePdfGeneratedEvent | InvoiceScheduleFailedEvent | RecurringInvoicePausedEvent | AccountClaimedEvent | CompanyCreatedEvent | RepresentationSignedEvent | InvoiceReplyReceivedEvent | InvoiceReplyDeletedEvent | WebhookTestEvent;
 
 type CreateCustomerRequest = components['schemas']['CreateCustomerRequest'];
 /**
@@ -44287,4 +45899,4 @@ type VeriFactuStatusUpdatedData = WebhookEventDataVeriFactuStatusUpdated;
 /** @deprecated Renamed in the contract — use `VeriFactuSubmissionStatus`. */
 type VeriFactuStatus = VeriFactuSubmissionStatus;
 
-export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, VeriFactuRecordOperation, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };
+export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceRepliesResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceReplyDeletedEvent, type InvoiceReplyReceivedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, VeriFactuRecordOperation, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceReplyDeleted, type WebhookEventDataInvoiceReplyReceived, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };