@beel_es/sdk 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -782,6 +782,8 @@ interface paths {
          *     - **`mode`:** the only value is `DUPLICATE`, which copies the source into a fresh draft. Recipient, lines,
          *       payment method, series and observations are copied; number, status, dates, VeriFactu
          *       data and PDF are reset.
+         *     - **Custom fields:** copied from the source, each with the label the field has now. A
+         *       field the company has archived since is left out instead of failing the call.
          *     - **Series:** the one sent in `series_id`, or the source's when omitted. It is validated
          *       against the type of the copy, which is not always the source's: the copy of a
          *       `CORRECTIVE` is born `STANDARD`. An incompatible series fails with
@@ -920,6 +922,15 @@ interface paths {
          *     - **Values:** the status, payment method, tax type and line type columns carry the same
          *       values the API returns (`ISSUED`, `BANK_TRANSFER`, `IVA`, `SUPLIDO`…). A proforma past
          *       its validity is exported as `ACTIVE`, not `EXPIRED`.
+         *     - **Custom fields:** the `SUMMARY` and `ITEMS` sheets get one extra column per custom
+         *       field `key` carried by at least one exported invoice, after the fixed columns and
+         *       ordered by `key`, so the position of the fixed columns never changes. The header is
+         *       the label saved on the invoices; when the same `key` was saved under different labels
+         *       (the field was renamed between invoices), the label of the most recently created of
+         *       them is used. A cell is empty when its invoice does not carry that field, and every
+         *       line of an invoice repeats the invoice's values in `ITEMS`. The `Suplidos` sheet has
+         *       no custom field columns. With no custom fields on any exported invoice the workbook is
+         *       the same as without them.
          *     - **Limit:** up to 50000 invoices per export. Going over it is rejected with
          *       `422 EXPORT_LIMIT_EXCEEDED` — narrow the date range or split the selection. The
          *       export is never silently truncated.
@@ -1340,6 +1351,9 @@ interface paths {
          *     - **Original rejected by the AEAT:** when VeriFactu rejected the original's record and it
          *       has not been resubmitted, the original is not in the AEAT's books: fix and resubmit it
          *       first. Until then the request fails with `422 CORRECTIVE_ORIGINAL_RECORD_REJECTED`.
+         *     - **Custom fields:** the corrective carries those of the original, each with the label the
+         *       field has now; a field the company has archived since is left out. Like on any invoice,
+         *       they are not part of its VeriFactu record.
          *     - **Exchange invoice recorded as F3:** correcting a full invoice issued in exchange for
          *       simplified invoices is not available yet: `422 EXCHANGE_INVOICE_NOT_CORRECTABLE`.
          *       Contact support.
@@ -1414,6 +1428,8 @@ interface paths {
          *       includes `400 SERIES_NUMBER_COLLISION`: the number the series would assign is already
          *       used by another invoice of the same company, and the series needs review, so contact
          *       support.
+         *     - **Custom fields:** the new invoice copies those of the proforma, each with the label
+         *       the field has now; a field the company has archived since is left out.
          *     - **Errors:** `422 CONVERSION_REQUIRES_PROFORMA` when the document is not a proforma,
          *       `422 PROFORMA_NOT_CONVERTIBLE` when it is not `ACTIVE`, and
          *       `409 PROFORMA_ALREADY_CONVERTED` when it has already been converted — a second call
@@ -1915,6 +1931,9 @@ interface paths {
          *     - **VeriFactu:** the template does not carry it. Whether each generated invoice is
          *       registered with AEAT is decided when that invoice is issued, against the company's
          *       regime at that moment.
+         *     - **`custom_fields`:** copied to every invoice the template generates. A field archived
+         *       later is left out of the invoices generated from then on, and the template keeps
+         *       generating.
          */
         post: operations["createCompanyRecurringInvoice"];
         delete?: never;
@@ -2007,6 +2026,8 @@ interface paths {
          *       the ones already in effect changes nothing. Changing `frequency` recalculates it on
          *       the new grid and discards a pending skip. `start_date` is only editable while the
          *       template has not generated any invoice yet.
+         *     - **`custom_fields`:** replaced as a whole; omit it to keep the current ones, send `null`
+         *       or `[]` to remove them all. Invoices already generated keep theirs.
          */
         patch: operations["patchCompanyRecurringInvoice"];
         trace?: never;
@@ -2092,7 +2113,8 @@ interface paths {
          * Get the next occurrence of a recurring invoice
          * @description Returns the invoice that would be produced by the next generation of this recurring
          *     template, computed from the current issuer, recipient and series data. Nothing is
-         *     persisted and no numbering is consumed.
+         *     persisted and no numbering is consumed. Its `custom_fields` are the ones the generated
+         *     invoice would carry, so a field archived since the template was saved is already left out.
          */
         get: operations["getCompanyRecurringInvoiceNextOccurrence"];
         put?: never;
@@ -2156,8 +2178,9 @@ interface paths {
         put?: never;
         /**
          * Derive a recurring invoice from an existing invoice
-         * @description Creates a recurring invoice template of this company taking its lines, recipient, series
-         *     and payment data from an existing invoice, so only the recurrence has to be described.
+         * @description Creates a recurring invoice template of this company taking its lines, recipient, series,
+         *     payment data and custom fields from an existing invoice, so only the recurrence has to be
+         *     described.
          *
          *     - **`from_invoice_id`:** the source invoice. It must belong to the company in the path,
          *       and one you cannot reach is reported the same way as one that does not exist. It is
@@ -2169,6 +2192,9 @@ interface paths {
          *       It governs the step from the first invoice onwards, not where that first one lands.
          *     - **VeriFactu:** not inherited from the source invoice. Each generated invoice is
          *       registered with AEAT, or not, according to the company's regime when it is issued.
+         *     - **`custom_fields`:** the template takes those of the source invoice, each with the label
+         *       the field has now; a field the company has archived since is left out instead of
+         *       failing the call.
          */
         post: operations["createCompanyRecurringInvoiceDerivation"];
         delete?: never;
@@ -2213,6 +2239,9 @@ interface paths {
          *       invoice, or derive a draft from one the template already generated with
          *       `POST /v1/companies/{company_id}/invoices/derivations`. Either way the schedule stays
          *       where it was.
+         *     - **Custom fields:** the invoice copies those of the template, each with the label the
+         *       field has now. A field archived since the template was saved is left out; it does not
+         *       make the generation fail.
          */
         post: operations["generateCompanyRecurringInvoiceNow"];
         delete?: never;
@@ -3099,6 +3128,169 @@ interface paths {
         patch: operations["patchCompanyProduct"];
         trace?: never;
     };
+    "/v1/companies/{company_id}/custom-fields": {
+        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: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * List the custom fields of a company
+         * @description Returns the invoice custom fields of this company, each one with the options that apply
+         *     to the query, ordered by `key`. A field with `suggest_values: false` carries no options.
+         *
+         *     - **Options per customer:** with `customer_id`, each field carries the common options and
+         *       those of that customer, which is what an invoice for that customer can offer. Without
+         *       it, only the common options. To page through every option of a field, use
+         *       `GET /v1/companies/{company_id}/custom-fields/{key}/options`.
+         *     - **Archived:** archived fields and options are left out unless `include_archived=true`.
+         *
+         *     **Closed catalogue.** A company defines a small set of fields: this collection carries no
+         *     `pagination`, takes no `page`/`limit`, and every response holds the whole set.
+         */
+        get: operations["listCompanyCustomFields"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/custom-fields/{key}": {
+        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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Get a custom field of a company
+         * @description Returns one custom field of this company, archived or not, with the options that apply to the query: the common ones plus, with `customer_id`, those of that customer. Archived options are left out unless `include_archived=true`. A field with `suggest_values: false` carries no options; list them with `GET /v1/companies/{company_id}/custom-fields/{key}/options`.
+         */
+        get: operations["getCompanyCustomField"];
+        /**
+         * Create or update a custom field of a company
+         * @description Creates the custom field with this `key`, or updates it if the company already has one.
+         *     Repeating the request leaves the same state, so it is safe to run on every deployment to
+         *     seed a catalogue.
+         *
+         *     - **Status:** `201` when the field is created, `200` when it already existed.
+         *     - **Key:** it is the path, never the body, and it never changes. To stop using a field,
+         *       archive it (`is_archived: true`); fields are never deleted.
+         *     - **Archive state:** omitting `is_archived` keeps the current one, so repeating the
+         *       request never reactivates a field someone archived.
+         *     - **Suggestions:** omitting `suggest_values` keeps the current setting; a new field starts
+         *       with `true`. Use `false` for a value that changes on every invoice, such as an order
+         *       number: invoices store the text as sent and no options are created. Turning it off
+         *       deletes no option, and turning it back on offers them again.
+         *     - **Options:** the response carries the common options of the field, or none when
+         *       `suggest_values` is `false`.
+         */
+        put: operations["upsertCompanyCustomField"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/custom-fields/{key}/options": {
+        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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        /**
+         * List the options of a custom field
+         * @description Returns a paginated list of the options of this custom field, ordered by `value`.
+         *
+         *     - **Customer:** without `customer_id`, every option of the field, common and of every
+         *       customer. With it, the common options and those of that customer.
+         *     - **Archived:** archived options are left out unless `include_archived=true`.
+         *     - **Suggestions off:** the options of a field with `suggest_values: false` are listed
+         *       too. They are not offered on invoices while the setting is off.
+         */
+        get: operations["listCompanyCustomFieldOptions"];
+        put?: never;
+        /**
+         * Add an option to a custom field
+         * @description Adds a value to the options of this custom field, for one customer or, without
+         *     `customer_id`, common to every customer. Use it to seed a catalogue before the first
+         *     invoice; values used on invoices are added on their own.
+         *
+         *     - **Equivalent values:** two values are equivalent when they match ignoring case, accents
+         *       and repeated spaces. If the field already has an equivalent option — of that customer
+         *       or a common one — no option is created: the response is `200` with the existing option,
+         *       and its text is kept. Only when nothing equivalent exists is the option created, with
+         *       `201`.
+         *     - **Archived options:** an equivalent archived option counts as existing. It comes back
+         *       with `200` and stays archived; reactivate it with
+         *       `PATCH /v1/companies/{company_id}/custom-fields/{key}/options/{option_id}`.
+         *     - **Suggestions off:** a field with `suggest_values: false` accepts options in the same
+         *       way, so a catalogue can be prepared before turning suggestions on. They are not
+         *       offered on invoices while the setting is off.
+         */
+        post: operations["createCompanyCustomFieldOption"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/companies/{company_id}/custom-fields/{key}/options/{option_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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+                /** @description Unique identifier of the option. */
+                option_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Get an option of a custom field
+         * @description Returns one option of this custom field, archived or not.
+         */
+        get: operations["getCompanyCustomFieldOption"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Rename, archive or reactivate an option
+         * @description Updates only the properties present in the body. Invoices already saved keep the text
+         *     they were saved with: renaming or archiving an option never changes an invoice.
+         *
+         *     - **Rename:** `value` replaces the text. If another option of the field in the same scope
+         *       — the same customer, or the common options for a common one — is equivalent to the new
+         *       text (ignoring case, accents and repeated spaces), the answer is `409` with
+         *       `CUSTOM_FIELD_OPTION_DUPLICATE` and nothing changes.
+         *     - **Archive or reactivate:** `is_archived`. Options are never deleted.
+         */
+        patch: operations["patchCompanyCustomFieldOption"];
+        trace?: never;
+    };
     "/v1/accounts/{account_id}/members": {
         parameters: {
             query?: never;
@@ -6782,6 +6974,21 @@ interface components {
             created_at: string;
             /** Format: date-time */
             updated_at: string;
+            /**
+             * @description The company's custom fields saved on this invoice, each with the label and value it
+             *     was saved with; an empty array when it carries none. They are informational: they
+             *     are not part of the VeriFactu record sent to the AEAT and do not enter its hash.
+             *     Unlike `metadata`, which holds identifiers for your integration, they are what a
+             *     person reads, filters and exports.
+             * @example [
+             *       {
+             *         "key": "store",
+             *         "label": "Store",
+             *         "value": "Gran Vía 12"
+             *       }
+             *     ]
+             */
+            custom_fields: components["schemas"]["InvoiceCustomField"][];
         };
         SeriesInfo: {
             /**
@@ -7581,6 +7788,23 @@ interface components {
              */
             external_ref?: components["schemas"]["ExternalRef"];
             metadata?: components["schemas"]["InvoiceMetadata"];
+            /**
+             * @description Values for the company's custom fields, at most one per `key`; a repeated `key` answers
+             *     `422 VALIDATION_ERROR`. A `key` the company does not have answers
+             *     `422 CUSTOM_FIELD_UNKNOWN`, and an archived field answers `409 CUSTOM_FIELD_ARCHIVED`;
+             *     in both cases nothing is created. Omit it for an invoice without custom fields.
+             *
+             *     They are informational: they are not part of the VeriFactu record sent to the AEAT,
+             *     do not enter its hash and cannot express any mention the invoicing regulations require.
+             *     Use `metadata` for identifiers your integration needs and people do not see.
+             * @example [
+             *       {
+             *         "key": "store",
+             *         "value": "Gran Vía 12"
+             *       }
+             *     ]
+             */
+            custom_fields?: components["schemas"]["InvoiceCustomFieldInput"][];
             options?: components["schemas"]["InvoiceProcessingOptions"];
         };
         /**
@@ -7792,6 +8016,23 @@ interface components {
              */
             payment_info?: components["schemas"]["PaymentInfo"];
             notes?: string;
+            /**
+             * @description Replaces the custom fields of the invoice as a whole: the list sent becomes the new
+             *     list. Omit it to keep the current ones; send `null` or `[]` to remove them all. The
+             *     same rules as on creation apply: at most one value per `key`, a `key` the company does
+             *     not have answers `422 CUSTOM_FIELD_UNKNOWN` and an archived field answers
+             *     `409 CUSTOM_FIELD_ARCHIVED`, even when the draft already carries it. Every field in
+             *     the list is saved again with the label it has now. Only a draft, a scheduled invoice
+             *     or an active proforma can change them; any other status answers
+             *     `422 STATUS_NOT_MODIFIABLE`.
+             *
+             *     When the request changes the recipient and omits `custom_fields`, the saved fields are
+             *     carried over to the new customer; one archived since is left out, with no error.
+             *
+             *     They are informational: they are not part of the VeriFactu record sent to the AEAT and
+             *     do not enter its hash.
+             */
+            custom_fields?: components["schemas"]["InvoiceCustomFieldInput"][] | null;
             /**
              * @description Processing options for the draft. Fields are optional and follow partial update
              *     semantics: omitted fields preserve the existing value.
@@ -10008,6 +10249,24 @@ interface components {
              */
             payment_term_days?: number | null;
             notes?: string | null;
+            /**
+             * @description The company's custom fields saved on this template, each with the label and value it was
+             *     saved with; an empty array when it carries none.
+             *
+             *     Every invoice the template generates copies them. The generated invoice saves each field
+             *     with the label it has at that moment; a field archived after the template was saved stays
+             *     listed here, but the invoices generated from then on are created without it and the
+             *     template keeps generating: it is not paused for that reason. They are informational: they
+             *     are not part of the VeriFactu record sent to the AEAT and do not enter its hash.
+             * @example [
+             *       {
+             *         "key": "project",
+             *         "label": "Project",
+             *         "value": "Corporate website"
+             *       }
+             *     ]
+             */
+            custom_fields: components["schemas"]["InvoiceCustomField"][];
             send_automatically?: boolean;
             email_configuration?: components["schemas"]["RecurringEmailConfigResponse"];
             generated_invoices?: number;
@@ -10106,6 +10365,10 @@ interface components {
          *     `payment_swift` and `payment_term_days`), `notes` and `email_configuration` are
          *     cleared when you leave them out. To change a few fields and keep the rest
          *     untouched, use `PATCH /v1/recurring-invoices/{recurring_invoice_id}`.
+         *
+         *     `custom_fields` is not part of this request: a replacement keeps the template's custom
+         *     fields as they are. Change them with
+         *     `PATCH /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}`.
          */
         UpdateRecurringInvoiceRequest: {
             name?: string;
@@ -10324,6 +10587,24 @@ interface components {
             payment_swift?: string | null;
             payment_term_days?: number | null;
             notes?: string | null;
+            /**
+             * @description Values for the company's custom fields that every generated invoice copies, at most one
+             *     per `key`; a repeated `key` answers `422 VALIDATION_ERROR`. A `key` the company does not
+             *     have answers `422 CUSTOM_FIELD_UNKNOWN`, and an archived field answers
+             *     `409 CUSTOM_FIELD_ARCHIVED`; in both cases no template is created. Each value follows the
+             *     same rules as on an invoice, with the template's `customer_id` as the customer. Omit it
+             *     for a template without custom fields.
+             *
+             *     They are informational: they are not part of the VeriFactu record sent to the AEAT, do
+             *     not enter its hash and cannot express any mention the invoicing regulations require.
+             * @example [
+             *       {
+             *         "key": "project",
+             *         "value": "Corporate website"
+             *       }
+             *     ]
+             */
+            custom_fields?: components["schemas"]["InvoiceCustomFieldInput"][];
             /** @default false */
             send_automatically?: boolean;
             email_configuration?: components["schemas"]["RecurringEmailConfigRequest"];
@@ -12356,6 +12637,32 @@ interface components {
             /** Format: date-time */
             deleted_at?: string | null;
         };
+        /**
+         * @description Identifier of the custom field within the company, chosen when the field is created: lowercase letters, digits and `_`, up to 64 characters. It never changes. BeeL. gives it no meaning of its own.
+         * @example store
+         */
+        CustomFieldKey: string;
+        /**
+         * @description A custom field as it was saved on an invoice or on a recurring invoice template: a copy of the field label and of the value at that moment. Renaming or archiving the field or its options later does not change it.
+         * @example {
+         *       "key": "store",
+         *       "label": "Store",
+         *       "value": "Gran Vía 12"
+         *     }
+         */
+        InvoiceCustomField: {
+            key: components["schemas"]["CustomFieldKey"];
+            /**
+             * @description Label of the field when the invoice was saved.
+             * @example Store
+             */
+            label: string;
+            /**
+             * @description Text stored on the invoice. It is the text the `custom_fields` filter of the invoice list compares.
+             * @example Gran Vía 12
+             */
+            value: string;
+        };
         /**
          * @description A phone number as this API accepts it: 9 to 20 characters, and only digits, spaces,
          *     dashes, parentheses and an optional leading `+`. Every request that takes a phone number
@@ -12382,6 +12689,8 @@ interface components {
          * @description Your own key/value pairs to cross-reference this invoice with records in
          *     your system (order ids, tenants, internal codes). Namespace them to avoid
          *     clashing with the system keys BeeL adds on payment-generated invoices.
+         *     Metadata is not printed on the PDF; for values people read, filter or export,
+         *     such as a store or a cost centre, use `custom_fields`.
          * @example {
          *       "external_order_id": "ORD-2025-0042",
          *       "tenant": "acme",
@@ -12391,6 +12700,21 @@ interface components {
         InvoiceMetadata: {
             [key: string]: unknown;
         };
+        /**
+         * @description The value of one custom field of the company on an invoice. The field must exist in the company and be active; the label is taken from it when the invoice is saved.
+         * @example {
+         *       "key": "store",
+         *       "value": "Gran Vía 12"
+         *     }
+         */
+        InvoiceCustomFieldInput: {
+            key: components["schemas"]["CustomFieldKey"];
+            /**
+             * @description Text of the value. Leading and trailing spaces are removed; a value that is empty after that answers `422`. When an option of the field is equivalent (it matches ignoring case, accents and repeated spaces), the invoice stores the text of that option, archived options included. Otherwise the text is stored as sent and, when the invoice has a registered customer (`recipient.customer_id`), it is added as an option of that customer; with recipient data sent inline, no option is created. On a field with `suggest_values: false` the value is never compared with the options and never creates one: the invoice stores the text as sent, without the leading and trailing spaces.
+             * @example Gran Vía 12
+             */
+            value: string;
+        };
         /** @description Outcome of a bulk operation processed invoice by invoice. */
         BulkOperationResult: {
             /**
@@ -12586,6 +12910,7 @@ interface components {
              * @description Issue date to (inclusive).
              */
             date_to?: string;
+            /** @description Only the invoices of this customer. Combines with the other filters, including `custom_fields`. */
             customer_id?: components["schemas"]["UUID"];
             /** @description Partial match on the recipient name. */
             recipient_name?: string;
@@ -12593,6 +12918,21 @@ interface components {
             recipient_nif?: string;
             /** @description Exact series code. */
             series_code?: string;
+            /**
+             * @description Filter by the custom fields saved on the invoice, as an object from field `key` to
+             *     value. It behaves like the `custom_fields` filter of the invoice list: the value is
+             *     compared with the text stored on the invoice, exactly (case and accents included), and
+             *     several keys are combined with AND, and with the other filters. Max 20 keys; more
+             *     answers `422 CUSTOM_FIELD_FILTER_TOO_MANY_KEYS`. A key the company does not have
+             *     matches no invoice. An empty object filters nothing and does not count as a selection
+             *     criterion.
+             * @example {
+             *       "store": "Gran Vía 12"
+             *     }
+             */
+            custom_fields?: {
+                [key: string]: string;
+            };
         };
         /**
          * @description An export of the invoices of this company. The format travels in the body, not in the URL,
@@ -13035,6 +13375,24 @@ interface components {
             payment_term_days?: number | null;
             /** @description Notes printed on the generated invoices. Send `null` to clear them. */
             notes?: string | null;
+            /**
+             * @description Replaces the custom fields of the template as a whole: the list sent becomes the new
+             *     list. Omit it to keep the current ones; send `null` or `[]` to remove them all. The same
+             *     rules as on an invoice apply: at most one value per `key` (a repeated `key` answers
+             *     `422 VALIDATION_ERROR`), a `key` the company does not have answers
+             *     `422 CUSTOM_FIELD_UNKNOWN` and an archived field answers `409 CUSTOM_FIELD_ARCHIVED`,
+             *     even when the template already carries it; in every case nothing is written. Every field
+             *     in the list is saved again with the label it has now, and each value follows the same
+             *     rules as on an invoice, with the template's `customer_id` as the customer.
+             *
+             *     When the request changes `customer_id` and omits `custom_fields`, the saved fields are
+             *     carried over to the new customer; one archived since is left out, with no error.
+             *
+             *     Invoices already generated keep the fields they were created with; the change applies
+             *     from the next generation. They are informational: they are not part of the VeriFactu
+             *     record sent to the AEAT and do not enter its hash.
+             */
+            custom_fields?: components["schemas"]["InvoiceCustomFieldInput"][] | null;
             send_automatically?: boolean;
             /**
              * @description Email delivery settings, replaced as a whole. Send `null` to stop sending the
@@ -13058,6 +13416,13 @@ interface components {
             invoice_number?: string | null;
             /** @description Always `null` here, for the same reason as `invoice_number`. */
             number?: number | null;
+            /**
+             * @description The custom fields the generated invoice would carry: those of the template, each
+             *     with the label the field has now. A field archived after the template was saved is
+             *     left out, as it will be on the generated invoice. An empty array when there are
+             *     none.
+             */
+            custom_fields: components["schemas"]["InvoiceCustomField"][];
         };
         /**
          * @description What happened in one scheduled slot of the schedule.
@@ -13129,9 +13494,9 @@ interface components {
             stopped: components["schemas"]["RecurringInvoiceStatsBlock"];
         };
         /**
-         * @description Derives a recurring invoice template from an existing invoice: lines, recipient, series and
-         *     payment data are taken from it, so only the recurrence is described here. The source invoice
-         *     is not modified.
+         * @description Derives a recurring invoice template from an existing invoice: lines, recipient, series,
+         *     payment data and custom fields are taken from it, so only the recurrence is described here.
+         *     The source invoice is not modified.
          *
          *     Deliberately not a variant of `CreateRecurringInvoiceRequest`: that one requires `series_id`,
          *     `invoice_type` and `lines`, which this call does not carry. Relaxing them there would let a
@@ -13800,6 +14165,171 @@ interface components {
              */
             summary?: components["schemas"]["ProductBulkCreateLegacySummary"];
         };
+        /** @description A value of a custom field, offered when filling it in. An option belongs to one customer or, without `customer_id`, is common to every customer of the company. */
+        CustomFieldOption: {
+            /**
+             * Format: uuid
+             * @description Unique identifier of the option.
+             * @example c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f
+             */
+            id: string;
+            /**
+             * @description Text of the option, exactly as it is shown and copied onto an invoice.
+             * @example Gran Vía 12
+             */
+            value: string;
+            /**
+             * Format: uuid
+             * @description Customer the option belongs to, or `null` for an option common to every customer. It is set when the option is created and never changes.
+             * @example 4f244735-980b-4d9c-80e8-6331fa0b1958
+             */
+            customer_id: string | null;
+            /**
+             * @description An archived option is no longer offered and is left out of listings unless `include_archived=true`. Invoices that already carry its text keep it.
+             * @example false
+             */
+            is_archived: boolean;
+        };
+        /**
+         * @description A custom field of the company's invoices, with the options that apply to the query that returned it.
+         * @example {
+         *       "id": "7d2f8a40-3c1e-4b6a-9f0d-2e5b8c1a4d77",
+         *       "key": "store",
+         *       "label": "Store",
+         *       "show_on_pdf": true,
+         *       "suggest_values": true,
+         *       "is_archived": false,
+         *       "options": [
+         *         {
+         *           "id": "0b6c1e2f-5a4d-4c3b-8e7f-1a2b3c4d5e6f",
+         *           "value": "Online store",
+         *           "customer_id": null,
+         *           "is_archived": false
+         *         },
+         *         {
+         *           "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
+         *           "value": "Gran Vía 12",
+         *           "customer_id": "4f244735-980b-4d9c-80e8-6331fa0b1958",
+         *           "is_archived": false
+         *         }
+         *       ]
+         *     }
+         */
+        CustomField: {
+            /**
+             * Format: uuid
+             * @description Unique identifier of the custom field.
+             * @example 7d2f8a40-3c1e-4b6a-9f0d-2e5b8c1a4d77
+             */
+            id: string;
+            key: components["schemas"]["CustomFieldKey"];
+            /**
+             * @description Name people see next to the value, on screen and, if `show_on_pdf`, on the PDF.
+             * @example Store
+             */
+            label: string;
+            /**
+             * @description Whether the PDF of the invoice prints this field, in a block of its own under the notes. It applies to invoices saved from then on: an invoice keeps the setting it was saved with.
+             * @example true
+             */
+            show_on_pdf: boolean;
+            /**
+             * @description Whether the field offers the values already used as options. With `true`, saving an invoice reuses an equivalent option or adds the value as a new one. With `false`, for a value that changes on every invoice such as an order number, the invoice stores the text as sent (without leading and trailing spaces), no option is created, and `options` comes back empty. Turning it off deletes no option: the existing ones are kept, can still be listed and managed under `GET /v1/companies/{company_id}/custom-fields/{key}/options`, and are offered again when it is turned back on.
+             * @example true
+             */
+            suggest_values: boolean;
+            /**
+             * @description An archived field cannot be added to new invoices and is left out of listings unless `include_archived=true`. Invoices that already carry it keep it.
+             * @example false
+             */
+            is_archived: boolean;
+            /** @description The options of this field that apply to the query: the common ones plus, when the query names a `customer_id`, the ones of that customer. Archived options appear only with `include_archived=true`. Always empty when `suggest_values` is `false`. To page through every option of the field, of every customer, use `GET /v1/companies/{company_id}/custom-fields/{key}/options`. */
+            options: components["schemas"]["CustomFieldOption"][];
+        };
+        CustomFieldListResponse: components["schemas"]["SuccessResponse"] & {
+            data?: {
+                custom_fields: components["schemas"]["CustomField"][];
+            };
+        };
+        CustomFieldResponse: components["schemas"]["SuccessResponse"] & {
+            data?: components["schemas"]["CustomField"];
+        };
+        /**
+         * @description The state of the custom field. `label` and `show_on_pdf` are always replaced. `suggest_values` and `is_archived`, when omitted, keep their current value (a new field is created with `suggest_values: true` and active), so repeating a request never undoes a change someone made to them.
+         * @example {
+         *       "label": "Store",
+         *       "show_on_pdf": true
+         *     }
+         */
+        UpsertCustomFieldRequest: {
+            /**
+             * @description Name people see next to the value. Leading and trailing spaces are removed; a label that is empty after that answers `422`.
+             * @example Store
+             */
+            label: string;
+            /**
+             * @description Whether the PDF of invoices saved from now on prints this field.
+             * @example true
+             */
+            show_on_pdf: boolean;
+            /**
+             * @description `true` offers the values already used as options and adds new ones as invoices are saved; `false` stores each value as sent and creates no options. Omit it to keep the current setting; a new field starts with `true`. Turning it off deletes no option.
+             * @example true
+             */
+            suggest_values?: boolean;
+            /**
+             * @description `true` archives the field, `false` reactivates it. Omit it to keep the current state.
+             * @example false
+             */
+            is_archived?: boolean;
+        };
+        CustomFieldOptionListResponse: components["schemas"]["SuccessResponse"] & {
+            data?: {
+                options: components["schemas"]["CustomFieldOption"][];
+                pagination: components["schemas"]["Pagination"];
+            };
+        };
+        /**
+         * @description A value to add to the options of the field, for one customer or, without `customer_id`, common to every customer.
+         * @example {
+         *       "value": "Gran Vía 12",
+         *       "customer_id": "4f244735-980b-4d9c-80e8-6331fa0b1958"
+         *     }
+         */
+        CreateCustomFieldOptionRequest: {
+            /**
+             * @description Text of the option. Leading and trailing spaces are removed; a value that is empty after that answers `422`. Two values are equivalent when they match ignoring case, accents and repeated spaces (`Gran  Via 12` and `gran vía 12`).
+             * @example Gran Vía 12
+             */
+            value: string;
+            /**
+             * Format: uuid
+             * @description Customer of the company the option belongs to. Omit it for an option common to every customer.
+             * @example 4f244735-980b-4d9c-80e8-6331fa0b1958
+             */
+            customer_id?: string;
+        };
+        CustomFieldOptionResponse: components["schemas"]["SuccessResponse"] & {
+            data?: components["schemas"]["CustomFieldOption"];
+        };
+        /**
+         * @description JSON Merge Patch of an option: an omitted property is left as it is. Neither property can be cleared. The customer an option belongs to cannot be changed.
+         * @example {
+         *       "value": "Gran Vía 12, Madrid"
+         *     }
+         */
+        PatchCustomFieldOptionRequest: {
+            /**
+             * @description New text of the option. Leading and trailing spaces are removed. Invoices already saved keep the text they were saved with.
+             * @example Gran Vía 12, Madrid
+             */
+            value?: string;
+            /**
+             * @description `true` archives the option, `false` reactivates it.
+             * @example true
+             */
+            is_archived?: boolean;
+        };
         /**
          * @description Who administers the account. Independent of `access_level`, which says how much access someone has to a given company.
          *
@@ -16235,7 +16765,8 @@ interface components {
          *       `MEMBER_ALREADY_IN_ACCOUNT`, `INVOICE_DUPLICATE_EXTERNAL_REFERENCE`).
          *     - **Lifecycle** — the transition does not apply from where the resource is
          *       (`INVOICE_ALREADY_VOIDED`, `PROFORMA_ALREADY_CONVERTED`, `CLIENT_HAS_INVOICES`,
-         *       `RECURRING_ALREADY_ENDED`, `RECURRING_OCCURRENCE_ALREADY_CONSUMED` — the occurrence the
+         *       `RECURRING_ALREADY_ENDED`, `CUSTOM_FIELD_ARCHIVED` — the custom field is archived and
+         *       cannot be assigned, `RECURRING_OCCURRENCE_ALREADY_CONSUMED` — the occurrence the
          *       recurring template points at has already been billed; read its history instead of
          *       retrying).
          *       Read the resource before retrying: the state you assumed is not its state.
@@ -17360,6 +17891,11 @@ interface operations {
              *     - `INVOICE_DUPLICATE_EXTERNAL_REFERENCE`: a live invoice with the same
              *       `external_ref` already exists. Fetch it via
              *       `GET /v1/invoices?external_ref=...`. Deleting it lets you recreate.
+             *     - `CUSTOM_FIELD_ARCHIVED`: a `key` in `custom_fields` names a field the company has
+             *       archived. Nothing is created.
+             *     - `CONCURRENT_MODIFICATION`: another invoice of the same customer saved the same custom
+             *       field value written differently a moment earlier; nothing is created, send the request
+             *       again.
              */
             409: {
                 headers: {
@@ -17413,6 +17949,7 @@ interface operations {
              *     Other `error.code` values with this status:
              *
              *     - `CORRECTIVE_INVOICE_INCOMPLETE` — `type: CORRECTIVE` is not accepted when creating an invoice; create correctives from the original with `POST …/invoices/{invoice_id}/corrective`.
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `DUE_DATE_BEFORE_ISSUE_DATE` — `due_date` is earlier than the issue date (today on create, the stored one on edit); send a due date on or after it.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
@@ -17682,6 +18219,19 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /**
+             * @description `CUSTOM_FIELD_ARCHIVED` — a `key` in `custom_fields` names a field the company has
+             *     archived, even one the draft already carries. Nothing changes. Also
+             *     `CONCURRENT_MODIFICATION`, `IDEMPOTENCY_KEY_PROCESSING` and `IDEMPOTENCY_KEY_MISMATCH`.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /**
              * @description Validation error.
              *     Separately: on a line priced by declared total (`total_excluding_tax` or
@@ -17699,6 +18249,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `DUE_DATE_BEFORE_ISSUE_DATE` — `due_date` is earlier than the issue date (today on create, the stored one on edit); send a due date on or after it.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
@@ -19797,10 +20348,21 @@ interface operations {
                  *     Repeat the bracket-style param to filter on multiple keys.
                  *     Max 50 pairs per request. Keys must match `^[A-Za-z0-9_\-.]{1,64}$`.
                  *     Example: `?metadata[external_order_id]=ORD-42&metadata[tenant]=acme`
+                 *     To filter by a custom field, use `custom_fields[<key>]`.
                  */
                 metadata?: {
                     [key: string]: string;
                 };
+                /**
+                 * @description Filter by the custom fields saved on the invoice, written as `custom_fields[<key>]=<value>`.
+                 *     The value is compared with the text stored on the invoice, exactly (case and accents
+                 *     included); several keys are combined with AND, and with the other filters. Max 20 keys
+                 *     per request. A key the company does not have matches no invoice.
+                 *     Example: `?custom_fields[project]=North&custom_fields[cost_centre]=CC-12`
+                 */
+                custom_fields?: {
+                    [key: string]: string;
+                };
                 /**
                  * @description Field to sort by: `issue_date` (default), `operation_date`, `due_date`,
                  *     `invoice_number`, `series_code`, `status`, `invoice_total`, `taxable_base`,
@@ -19864,6 +20426,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_FILTER_TOO_MANY_KEYS` — the query sends more than 20 distinct `custom_fields[key]` filters; narrow the filter to 20 keys or fewer.
              *     - `METADATA_FILTER_TOO_MANY_KEYS` — the query sends more than 50 distinct `metadata[key]` filters; narrow the filter to 50 keys or fewer.
              */
             422: {
@@ -20020,6 +20583,12 @@ interface operations {
              *     - Idempotency key already processed, or duplicate invoice number.
              *     - `INVOICE_DUPLICATE_EXTERNAL_REFERENCE`: a live invoice with the same
              *       `external_ref` already exists.
+             *     - `CUSTOM_FIELD_ARCHIVED`: a `key` in `custom_fields` names a field the company has
+             *       archived. Archived fields cannot be added to invoices; reactivate the field or drop
+             *       it from the request. Nothing is created.
+             *     - `CONCURRENT_MODIFICATION`: another invoice of the same customer saved the same custom
+             *       field value written differently a moment earlier; nothing is created, send the request
+             *       again and the stored text will be the existing one.
              */
             409: {
                 headers: {
@@ -20087,6 +20656,7 @@ interface operations {
              *     Other `error.code` values with this status:
              *
              *     - `CORRECTIVE_INVOICE_INCOMPLETE` — `type: CORRECTIVE` is not accepted when creating an invoice; create correctives from the original with `POST …/invoices/{invoice_id}/corrective`.
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `DUE_DATE_BEFORE_ISSUE_DATE` — `due_date` is earlier than the issue date (today on create, the stored one on edit); send a due date on or after it.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IVA_SURCHARGE_PAIR` — the equivalence surcharge does not match the line's VAT rate (21↔5.2, 10↔1.4, 5↔0.62, 4↔0.5); fix either rate.
@@ -20664,7 +21234,37 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            422: components["responses"]["ValidationError"];
+            /**
+             * @description The body parses but the export cannot be produced as asked. Nothing is exported.
+             *
+             *     - `VALIDATION_ERROR` — a field fails validation; `error.details` maps each offending
+             *       property to what is wrong with it.
+             *     - `EXPORT_LIMIT_EXCEEDED` — the selection matches more than 50000 invoices; narrow the
+             *       date range or split the selection.
+             *     - `CUSTOM_FIELD_FILTER_TOO_MANY_KEYS` — `filters.custom_fields` has more than 20 keys;
+             *       narrow the filter to 20 keys or fewer.
+             */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CUSTOM_FIELD_FILTER_TOO_MANY_KEYS",
+                     *         "message": "The custom fields filter accepts at most 20 keys per request"
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-10-18T10:30:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             429: components["responses"]["TooManyRequests"];
             500: components["responses"]["InternalServerError"];
             default: components["responses"]["UnexpectedError"];
@@ -20921,7 +21521,40 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            409: components["responses"]["StateConflict"];
+            /**
+             * @description The request is well formed but collides with the state that is already there, told
+             *     apart by `error.code`:
+             *
+             *     - `CUSTOM_FIELD_ARCHIVED` — a `key` in `custom_fields` names a field the company has
+             *       archived, even one the draft already carries. Reactivate the field, or send
+             *       `custom_fields` without it. Nothing changes.
+             *     - `CONCURRENT_MODIFICATION` — another write changed the invoice first; read it again
+             *       and retry.
+             *     - `IDEMPOTENCY_KEY_PROCESSING` — the `Idempotency-Key` you sent is still in flight;
+             *       retry after a moment. `IDEMPOTENCY_KEY_MISMATCH` — it was already used for a
+             *       different body; use a new key.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CUSTOM_FIELD_ARCHIVED",
+                     *         "message": "The custom field store is archived and cannot be added to an invoice."
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-10-17T10:30:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /**
              * @description Validation error.
              *     Separately: on a line priced by declared total (`total_excluding_tax` or
@@ -20952,6 +21585,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `DUE_DATE_BEFORE_ISSUE_DATE` — `due_date` is earlier than the issue date (today on create, the stored one on edit); send a due date on or after it.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IVA_SURCHARGE_PAIR` — the equivalence surcharge does not match the line's VAT rate (21↔5.2, 10↔1.4, 5↔0.62, 4↔0.5); fix either rate.
@@ -23002,6 +23636,19 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /**
+             * @description `CUSTOM_FIELD_ARCHIVED` — a `key` in `custom_fields` names a field the company has
+             *     archived. Nothing is created. Also `CONCURRENT_MODIFICATION`,
+             *     `IDEMPOTENCY_KEY_PROCESSING` and `IDEMPOTENCY_KEY_MISMATCH`.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /**
              * @description Validation error.
              *     A line whose `exemption_reason` requires the recipient to carry a specific alternate
@@ -23034,6 +23681,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IRPF` — the `irpf_rate` is not a withholding rate in force (see `IrpfPercentage`); send one of the published rates.
@@ -23461,6 +24109,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IRPF` — the `irpf_rate` is not a withholding rate in force (see `IrpfPercentage`); send one of the published rates.
@@ -24386,6 +25035,40 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /**
+             * @description The request is well formed but collides with the state that is already there, told
+             *     apart by `error.code`:
+             *
+             *     - `CUSTOM_FIELD_ARCHIVED` — a `key` in `custom_fields` names a field the company has
+             *       archived. Reactivate the field, or send `custom_fields` without it. No template is
+             *       created.
+             *     - `CONCURRENT_MODIFICATION` — another write changed the template first; read it again
+             *       and retry.
+             *     - `IDEMPOTENCY_KEY_PROCESSING` — the `Idempotency-Key` you sent is still in flight;
+             *       retry after a moment. `IDEMPOTENCY_KEY_MISMATCH` — it was already used for a
+             *       different body; use a new key.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CUSTOM_FIELD_ARCHIVED",
+                     *         "message": "The custom field project is archived and cannot be added to an invoice"
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-10-17T10:30:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /**
              * @description Validation error.
              *     A line whose `exemption_reason` requires the recipient to carry a specific alternate
@@ -24424,6 +25107,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IRPF` — the `irpf_rate` is not a withholding rate in force (see `IrpfPercentage`); send one of the published rates.
@@ -24815,6 +25499,7 @@ interface operations {
              *
              *     Other `error.code` values with this status:
              *
+             *     - `CUSTOM_FIELD_UNKNOWN` — a `key` in `custom_fields` is not a custom field of this company in this environment; create it with `PUT …/custom-fields/{key}` or fix the key.
              *     - `EXEMPTION_NOT_FOR_ISSUED_INVOICE` — `EXENTA_ART_26` exempts the buyer's intra-community acquisition, not a sale you invoice; use `EXENTA_ART_25` for the intra-community supply.
              *     - `EXEMPT_ZERO_RATE_REQUIRES_REASON` — a 0 % IVA or IPSI line is the exemption sentinel and needs an `exemption_reason`; add one or use a real rate.
              *     - `INVALID_IRPF` — the `irpf_rate` is not a withholding rate in force (see `IrpfPercentage`); send one of the published rates.
@@ -28360,6 +29045,530 @@ interface operations {
             default: components["responses"]["UnexpectedError"];
         };
     };
+    listCompanyCustomFields: {
+        parameters: {
+            query?: {
+                /** @description Adds the options of this customer to the common ones. A value that names no customer of this company is not an error: only the common options come back. */
+                customer_id?: string;
+                /** @description Include archived fields and archived options. */
+                include_archived?: boolean;
+            };
+            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: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Custom fields of the company. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldListResponse"];
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    getCompanyCustomField: {
+        parameters: {
+            query?: {
+                /** @description Adds the options of this customer to the common ones. A value that names no customer of this company is not an error: only the common options come back. */
+                customer_id?: string;
+                /** @description Include archived options. */
+                include_archived?: boolean;
+            };
+            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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The custom field. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldResponse"];
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description `CUSTOM_FIELD_NOT_FOUND` — this company has no custom field with this `key` in the environment of the credential. Test and Live keep separate catalogues. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CUSTOM_FIELD_NOT_FOUND",
+                     *         "message": "Custom field not found: store"
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-10-17T10:30:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            422: components["responses"]["UnprocessableQueryParameter"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    upsertCompanyCustomField: {
+        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, check whether the operation took effect before retrying with a **new** key
+                 *     - 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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpsertCustomFieldRequest"];
+            };
+        };
+        responses: {
+            /** @description The custom field already existed and was updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldResponse"];
+                };
+            };
+            /** @description The custom field was created. */
+            201: {
+                headers: {
+                    Location: components["headers"]["CreatedResourceLocation"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: components["responses"]["StateConflict"];
+            422: components["responses"]["ValidationError"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    listCompanyCustomFieldOptions: {
+        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 Limits the list to the common options and those of this customer. A value that names no customer of this company is not an error: only the common options come back. */
+                customer_id?: string;
+                /** @description Include archived options. */
+                include_archived?: boolean;
+            };
+            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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Options of the custom field. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldOptionListResponse"];
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description `CUSTOM_FIELD_NOT_FOUND` — this company has no custom field with this `key` in the environment of the credential. Test and Live keep separate catalogues. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            422: components["responses"]["UnprocessableQueryParameter"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    createCompanyCustomFieldOption: {
+        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, check whether the operation took effect before retrying with a **new** key
+                 *     - 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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomFieldOptionRequest"];
+            };
+        };
+        responses: {
+            /** @description An equivalent option already existed; this is that option, unchanged. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldOptionResponse"];
+                };
+            };
+            /** @description The option was created. */
+            201: {
+                headers: {
+                    Location: components["headers"]["CreatedResourceLocation"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldOptionResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Two causes, told apart by `error.code`: `CUSTOM_FIELD_NOT_FOUND` (this company has no custom field with this `key`) and `INVOICE_CLIENT_NOT_FOUND` (the `customer_id` of the body is not a customer of this company, or was deleted). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: components["responses"]["StateConflict"];
+            422: components["responses"]["ValidationError"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    getCompanyCustomFieldOption: {
+        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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+                /** @description Unique identifier of the option. */
+                option_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The option. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldOptionResponse"];
+                };
+            };
+            400: components["responses"]["InvalidRequestTarget"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Two causes, told apart by `error.code`: `CUSTOM_FIELD_NOT_FOUND` (this company has no custom field with this `key`) and `CUSTOM_FIELD_OPTION_NOT_FOUND` (the field has no option with this `option_id`; an option of another field answers the same way). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            422: components["responses"]["UnprocessableQueryParameter"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
+    patchCompanyCustomFieldOption: {
+        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, check whether the operation took effect before retrying with a **new** key
+                 *     - 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: string;
+                /** @description Key of the custom field: lowercase letters, digits and `_`, up to 64 characters. A key outside that format answers `422`. */
+                key: components["schemas"]["CustomFieldKey"];
+                /** @description Unique identifier of the option. */
+                option_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PatchCustomFieldOptionRequest"];
+            };
+        };
+        responses: {
+            /** @description The option, updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomFieldOptionResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            /**
+             * @description Your account does not own or manage this company, or does not hold the required
+             *     access over it. A company that does not exist answers the same way.
+             *     That case answers `error.code` `ACTIVE_COMPANY_NOT_ACCESSIBLE`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Two causes, told apart by `error.code`: `CUSTOM_FIELD_NOT_FOUND` (this company has no custom field with this `key`) and `CUSTOM_FIELD_OPTION_NOT_FOUND` (the field has no option with this `option_id`; an option of another field answers the same way). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /**
+             * @description `CUSTOM_FIELD_OPTION_DUPLICATE` — another option of this field in the same scope is
+             *     equivalent to the new `value`, archived or not; nothing changed. Use that option
+             *     instead, reactivating it if it is archived.
+             *     The idempotency codes of `StateConflict` (`IDEMPOTENCY_KEY_PROCESSING`,
+             *     `IDEMPOTENCY_KEY_MISMATCH`) and `CONCURRENT_MODIFICATION` share this status.
+             */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "success": false,
+                     *       "error": {
+                     *         "code": "CUSTOM_FIELD_OPTION_DUPLICATE",
+                     *         "message": "This field already has an equivalent option",
+                     *         "details": {}
+                     *       },
+                     *       "meta": {
+                     *         "timestamp": "2026-10-17T10:30:00Z",
+                     *         "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            422: components["responses"]["ValidationError"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["InternalServerError"];
+            default: components["responses"]["UnexpectedError"];
+        };
+    };
     listAccountMembers: {
         parameters: {
             query?: {
@@ -35223,6 +36432,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Get an invoice by ID.
@@ -35280,6 +36490,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Update a draft invoice. Only draft invoices can be updated.
@@ -35338,6 +36549,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Delete a draft invoice. Only draft invoices can be deleted.
@@ -35405,6 +36617,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Issue a draft invoice. Assigns an invoice number and triggers VeriFactu submission.
@@ -35465,6 +36678,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Mark an invoice as paid.
@@ -35526,6 +36740,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Mark an invoice as sent (e.g. delivered by other means).
@@ -35586,6 +36801,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Revert a paid/sent invoice back to issued status.
@@ -35643,6 +36859,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Void an issued invoice. Requires a reason (min 10 chars).
@@ -35707,6 +36924,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Create a corrective invoice that references the original.
@@ -35765,6 +36983,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Schedule a draft invoice to be issued on a future date.
@@ -35826,6 +37045,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Cancel a scheduled invoice, returning it to draft.
@@ -35883,6 +37103,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Change the scheduled date of a scheduled invoice.
@@ -35943,6 +37164,7 @@ declare class InvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Get a pre-signed URL to download the invoice PDF.
@@ -37869,6 +39091,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     private path;
     /**
@@ -37965,6 +39188,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Create a standard or simplified invoice once per `external_ref`, safe to call again
@@ -38049,6 +39273,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Get one invoice, including its `status` and its `verifactu` block
@@ -38108,6 +39333,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Update a `DRAFT` or `SCHEDULED` invoice (or an `ACTIVE` proforma). Only the fields
@@ -38168,6 +39394,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Delete a draft invoice. Deleting frees its `external_ref` for a new invoice.
@@ -38235,6 +39462,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Void an invoice issued by mistake. The document is kept and its number never reused. If
@@ -38295,6 +39523,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Create a corrective invoice (rectificativa) for an issued invoice.
@@ -38366,6 +39595,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Convert a proforma into an invoice.
@@ -38425,6 +39655,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Issue a full invoice in exchange for one or more issued simplified invoices, when the
@@ -38494,6 +39725,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * The VeriFactu records of an invoice, oldest first: its registration and, if it was
@@ -38573,6 +39805,7 @@ declare class CompanyInvoicesResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: components["schemas"]["InvoiceCustomField"][];
     }>;
     /**
      * Get a short-lived download URL for the invoice PDF.
@@ -38811,6 +40044,11 @@ declare class CompanyInvoiceScheduleResource {
         id: string;
         created_at: string;
         updated_at: string;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
     } | undefined>;
     /**
      * Clear the schedule, returning the invoice to a plain draft — the canonical form of
@@ -39309,6 +40547,11 @@ declare class CompanyRecurringInvoicesResource {
             payment_swift?: string | null | undefined;
             payment_term_days?: number | null | undefined;
             notes?: string | null | undefined;
+            custom_fields: {
+                key: components["schemas"]["CustomFieldKey"];
+                label: string;
+                value: string;
+            }[];
             send_automatically?: boolean | undefined;
             email_configuration?: {
                 recipients?: string[] | undefined;
@@ -39395,6 +40638,11 @@ declare class CompanyRecurringInvoicesResource {
         payment_swift?: string | null | undefined;
         payment_term_days?: number | null | undefined;
         notes?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
         send_automatically?: boolean | undefined;
         email_configuration?: {
             recipients?: string[] | undefined;
@@ -39472,6 +40720,11 @@ declare class CompanyRecurringInvoicesResource {
         payment_swift?: string | null | undefined;
         payment_term_days?: number | null | undefined;
         notes?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
         send_automatically?: boolean | undefined;
         email_configuration?: {
             recipients?: string[] | undefined;
@@ -39550,6 +40803,11 @@ declare class CompanyRecurringInvoicesResource {
         payment_swift?: string | null | undefined;
         payment_term_days?: number | null | undefined;
         notes?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
         send_automatically?: boolean | undefined;
         email_configuration?: {
             recipients?: string[] | undefined;
@@ -39635,6 +40893,11 @@ declare class CompanyRecurringInvoicesResource {
         payment_swift?: string | null | undefined;
         payment_term_days?: number | null | undefined;
         notes?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
         send_automatically?: boolean | undefined;
         email_configuration?: {
             recipients?: string[] | undefined;
@@ -39712,6 +40975,11 @@ declare class CompanyRecurringInvoicesResource {
         payment_swift?: string | null | undefined;
         payment_term_days?: number | null | undefined;
         notes?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
         send_automatically?: boolean | undefined;
         email_configuration?: {
             recipients?: string[] | undefined;
@@ -39921,6 +41189,11 @@ declare class CompanyRecurringInvoicesResource {
             reason?: string | null | undefined;
         } | undefined;
         deleted_at?: string | null | undefined;
+        custom_fields: {
+            key: components["schemas"]["CustomFieldKey"];
+            label: string;
+            value: string;
+        }[];
     } | undefined>;
     /**
      * The generation history of the template: generated, skipped and failed occurrences.