@beel_es/sdk 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-09-28
+
+Contract resynced with the API as it runs in production today and types regenerated.
+
+### Added
+- **The VeriFactu status webhook says which record changed.** The `verifactu.status.updated`
+  payload (`WebhookEventDataVeriFactuStatusUpdated`) carries `operation`: `REGISTRATION` for
+  the invoice's registration, `VOID` for the cancellation of a voided invoice. The API always
+  sends it. The enum is exported as `VeriFactuRecordOperation`.
+
+### Changed
+- **`province` is optional in the `Address` you send.** It is only required for an address in
+  Spain (`country_code` `ES`, or no country); the API rejects a Spanish address without it with
+  a `422`. Code that sets it still compiles.
+- Recurring invoices: `payment_term_days` documents how the due date of each generated invoice
+  is computed.
+
 ## [2.1.0] - 2026-09-28
 
 ### Fixed

package/dist/index.d.mts

@@ -6482,10 +6482,12 @@ interface components {
              */
             city: string;
             /**
-             * @description Province or state - Latin characters only
+             * @description Province or state - Latin characters only. Required for an address in Spain
+             *     (`country_code` `ES`, or no country at all); optional elsewhere, where many addresses
+             *     have none. A Spanish address without it is rejected with a `422`.
              * @example Madrid
              */
-            province: string;
+            province?: string;
             /**
              * @description Country of the address, as its ISO 3166-1 alpha-2 code (`GB`) or its official name
              *     in Spanish, English or Catalan (`Reino Unido`, `United Kingdom`, `Regne Unit`;
@@ -6545,7 +6547,7 @@ interface components {
              */
             city?: string;
             /**
-             * @description Province or state
+             * @description Province or state. Outside Spain an address may have none.
              * @example Madrid
              */
             province?: string;
@@ -9880,6 +9882,10 @@ interface components {
             /**
              * @description Payment term, in days, of the template's own payment method. `null` when the template
              *     has no payment method, or when it has one without a declared term.
+             *
+             *     Each generated invoice is due on its issue date plus this term. When it is `null`, the
+             *     company's default `payment_term_days` (tax configuration) applies, or 30 days if the
+             *     company has none.
              */
             payment_term_days?: number | null;
             notes?: string | null;
@@ -15348,6 +15354,12 @@ interface components {
             invoice_number?: string | null;
             /** Format: uuid */
             verifactu_registration_id: string;
+            /**
+             * @description Which record changed status: the registration (`REGISTRATION`) or the cancellation of a
+             *     voided invoice (`VOID`). It is the record `verifactu_registration_id` identifies, the
+             *     same one `verifactu-records` lists with that `operation`.
+             */
+            operation: components["schemas"]["VeriFactuRecordOperation"];
             /**
              * @description Status of this registration before the change. Omitted on the first notification of a
              *     registration, because there is no earlier status: the submission was just accepted for
@@ -34719,7 +34731,7 @@ declare class CompanyCustomersResource {
                     door?: string | undefined;
                     postal_code: string;
                     city: string;
-                    province: string;
+                    province?: string | undefined;
                     country?: string | undefined;
                     country_code?: string | undefined;
                 } | undefined;
@@ -36372,6 +36384,19 @@ type WebhookEventDataRepresentationSigned = (WebhookEventDataAccountBase & {
     signed_at: string;
 });
 
+/**
+ * Which record changed status: the invoice's registration or, if it was voided, its
+ * cancellation. The same value as `operation` in the invoice's `verifactu-records`.
+ *
+ * * `REGISTRATION` — registration of the invoice.
+ * * `VOID` — cancellation of a previously registered invoice.
+ *
+ */
+declare enum VeriFactuRecordOperation {
+    REGISTRATION = "REGISTRATION",
+    VOID = "VOID"
+}
+
 /**
  * VeriFactu registration status. Every value is also a value of `verifactu.submission_status`
  * on the invoice resource, so a status read from a webhook can be fed straight back into the
@@ -36408,6 +36433,7 @@ type WebhookEventDataVeriFactuStatusUpdated = {
      * BeeL. VeriFactu registration identifier.
      */
     verifactu_registration_id: string;
+    operation: VeriFactuRecordOperation;
     /**
      * Status of this registration before the change. Omitted on the first notification of a
      * registration, because there is no earlier status: the submission was just accepted for
@@ -36837,4 +36863,4 @@ type VeriFactuStatusUpdatedData = WebhookEventDataVeriFactuStatusUpdated;
 /** @deprecated Renamed in the contract — use `VeriFactuSubmissionStatus`. */
 type VeriFactuStatus = VeriFactuSubmissionStatus;
 
-export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };
+export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, VeriFactuRecordOperation, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };

package/dist/index.d.ts

@@ -6482,10 +6482,12 @@ interface components {
              */
             city: string;
             /**
-             * @description Province or state - Latin characters only
+             * @description Province or state - Latin characters only. Required for an address in Spain
+             *     (`country_code` `ES`, or no country at all); optional elsewhere, where many addresses
+             *     have none. A Spanish address without it is rejected with a `422`.
              * @example Madrid
              */
-            province: string;
+            province?: string;
             /**
              * @description Country of the address, as its ISO 3166-1 alpha-2 code (`GB`) or its official name
              *     in Spanish, English or Catalan (`Reino Unido`, `United Kingdom`, `Regne Unit`;
@@ -6545,7 +6547,7 @@ interface components {
              */
             city?: string;
             /**
-             * @description Province or state
+             * @description Province or state. Outside Spain an address may have none.
              * @example Madrid
              */
             province?: string;
@@ -9880,6 +9882,10 @@ interface components {
             /**
              * @description Payment term, in days, of the template's own payment method. `null` when the template
              *     has no payment method, or when it has one without a declared term.
+             *
+             *     Each generated invoice is due on its issue date plus this term. When it is `null`, the
+             *     company's default `payment_term_days` (tax configuration) applies, or 30 days if the
+             *     company has none.
              */
             payment_term_days?: number | null;
             notes?: string | null;
@@ -15348,6 +15354,12 @@ interface components {
             invoice_number?: string | null;
             /** Format: uuid */
             verifactu_registration_id: string;
+            /**
+             * @description Which record changed status: the registration (`REGISTRATION`) or the cancellation of a
+             *     voided invoice (`VOID`). It is the record `verifactu_registration_id` identifies, the
+             *     same one `verifactu-records` lists with that `operation`.
+             */
+            operation: components["schemas"]["VeriFactuRecordOperation"];
             /**
              * @description Status of this registration before the change. Omitted on the first notification of a
              *     registration, because there is no earlier status: the submission was just accepted for
@@ -34719,7 +34731,7 @@ declare class CompanyCustomersResource {
                     door?: string | undefined;
                     postal_code: string;
                     city: string;
-                    province: string;
+                    province?: string | undefined;
                     country?: string | undefined;
                     country_code?: string | undefined;
                 } | undefined;
@@ -36372,6 +36384,19 @@ type WebhookEventDataRepresentationSigned = (WebhookEventDataAccountBase & {
     signed_at: string;
 });
 
+/**
+ * Which record changed status: the invoice's registration or, if it was voided, its
+ * cancellation. The same value as `operation` in the invoice's `verifactu-records`.
+ *
+ * * `REGISTRATION` — registration of the invoice.
+ * * `VOID` — cancellation of a previously registered invoice.
+ *
+ */
+declare enum VeriFactuRecordOperation {
+    REGISTRATION = "REGISTRATION",
+    VOID = "VOID"
+}
+
 /**
  * VeriFactu registration status. Every value is also a value of `verifactu.submission_status`
  * on the invoice resource, so a status read from a webhook can be fed straight back into the
@@ -36408,6 +36433,7 @@ type WebhookEventDataVeriFactuStatusUpdated = {
      * BeeL. VeriFactu registration identifier.
      */
     verifactu_registration_id: string;
+    operation: VeriFactuRecordOperation;
     /**
      * Status of this registration before the change. Omitted on the first notification of a
      * registration, because there is no earlier status: the submission was just accepted for
@@ -36837,4 +36863,4 @@ type VeriFactuStatusUpdatedData = WebhookEventDataVeriFactuStatusUpdated;
 /** @deprecated Renamed in the contract — use `VeriFactuSubmissionStatus`. */
 type VeriFactuStatus = VeriFactuSubmissionStatus;
 
-export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };
+export { type AccountClaimedEvent, AccountCompaniesResource, AccountInvitationsResource, AccountMembersResource, AccountScope, AccountWebhooksResource, AccountsResource, BeeL, BeeLApiError, BeeLAuthError, type BeeLConfig, BeeLConflictError, type BeeLErrorCode, BeeLErrorCodes, BeeLNotFoundError, BeeLRateLimitError, BeeLValidationError, CatalogsResource, type CompanyCreatedEvent, CompanyCustomersResource, CompanyInvoiceScheduleResource, CompanyInvoicesResource, CompanyPaymentConnectionsResource, CompanyPaymentEventsResource, CompanyProductsResource, CompanyRecurringInvoicesResource, CompanyScope, CompanySeriesResource, CompanyTaxConfigurationResource, CompanyVeriFactuConfigurationResource, type CreateInvoiceOnceParams, type CreateInvoiceOnceRequest, CustomerBuilder, EXTERNAL_REF_UNIQUE_INVOICE_TYPES, type ExternalRefUniqueInvoiceType, InvoiceBuilder, type InvoiceEmailSentEvent, type InvoiceIssuedEvent, type InvoicePdfGeneratedEvent, type InvoiceScheduleFailedEvent, type InvoiceVoidedEvent, type RecurringInvoicePausedEvent, type RepresentationSignedEvent, type RequestOptions, VeriFactuRecordOperation, type VeriFactuStatus, type VeriFactuStatusUpdatedData, type VeriFactuStatusUpdatedEvent, VeriFactuSubmissionStatus, type WebhookEvent, type WebhookEventDataAccountClaimed, type WebhookEventDataCompanyCreated, type WebhookEventDataInvoiceEmailSent, type WebhookEventDataInvoiceIssued, type WebhookEventDataInvoicePdfGenerated, type WebhookEventDataInvoiceScheduleFailed, type WebhookEventDataInvoiceVoided, type WebhookEventDataRecurringInvoicePaused, type WebhookEventDataRepresentationSigned, type WebhookEventDataTest, type WebhookEventDataVeriFactuStatusUpdated, type WebhookEventEnvelope, WebhookEventType, type WebhookTestEvent, WebhookVerificationError, WebhookVerifier, type components, type operations, type paths };

package/dist/index.js

@@ -59,6 +59,7 @@ __export(index_exports, {
   CustomerBuilder: () => CustomerBuilder,
   EXTERNAL_REF_UNIQUE_INVOICE_TYPES: () => EXTERNAL_REF_UNIQUE_INVOICE_TYPES,
   InvoiceBuilder: () => InvoiceBuilder,
+  VeriFactuRecordOperation: () => VeriFactuRecordOperation,
   VeriFactuSubmissionStatus: () => VeriFactuSubmissionStatus,
   WebhookEventType: () => WebhookEventType,
   WebhookVerificationError: () => WebhookVerificationError,
@@ -2761,6 +2762,13 @@ var RepresentationSignedEvent;
   })(type = RepresentationSignedEvent2.type || (RepresentationSignedEvent2.type = {}));
 })(RepresentationSignedEvent || (RepresentationSignedEvent = {}));
 
+// src/generated-webhooks/models/VeriFactuRecordOperation.ts
+var VeriFactuRecordOperation = /* @__PURE__ */ ((VeriFactuRecordOperation2) => {
+  VeriFactuRecordOperation2["REGISTRATION"] = "REGISTRATION";
+  VeriFactuRecordOperation2["VOID"] = "VOID";
+  return VeriFactuRecordOperation2;
+})(VeriFactuRecordOperation || {});
+
 // src/generated-webhooks/models/VeriFactuStatusUpdatedEvent.ts
 var VeriFactuStatusUpdatedEvent;
 ((VeriFactuStatusUpdatedEvent2) => {
@@ -3079,6 +3087,7 @@ var InvoiceBuilder = class _InvoiceBuilder {
   CustomerBuilder,
   EXTERNAL_REF_UNIQUE_INVOICE_TYPES,
   InvoiceBuilder,
+  VeriFactuRecordOperation,
   VeriFactuSubmissionStatus,
   WebhookEventType,
   WebhookVerificationError,