@revenexx/node 0.1.1 → 0.2.0

package/dist/services/cost-centers.d.mts

@@ -1,8 +1,13 @@
 import { Client } from '../client.mjs';
 import { Models } from '../models.mjs';
+import { BudgetType } from '../enums/budget-type.mjs';
 import { Conditions } from '../enums/conditions.mjs';
 import { CostCentersRestrictionsCreateType } from '../enums/cost-centers-restrictions-create-type.mjs';
+import { CostCentersVocabularyName } from '../enums/cost-centers-vocabulary-name.mjs';
 import '../query.mjs';
+import '../enums/accept-line-decision.mjs';
+import '../enums/accept-result-origin.mjs';
+import '../enums/accept-result-status.mjs';
 import '../enums/address-type-row-tone.mjs';
 import '../enums/address-type-row-create-request-tone.mjs';
 import '../enums/address-type-row-update-request-tone.mjs';
@@ -16,12 +21,23 @@ import '../enums/approval-rule-update-request-approver-type.mjs';
 import '../enums/approval-rule-update-request-condition.mjs';
 import '../enums/approval-rule-update-request-effect.mjs';
 import '../enums/assets-source.mjs';
+import '../enums/assignment-role-tone.mjs';
+import '../enums/assignment-role-create-request-tone.mjs';
+import '../enums/assignment-role-update-request-tone.mjs';
+import '../enums/attach-request-direction.mjs';
+import '../enums/attach-request-visibility.mjs';
 import '../enums/attribute-value-bucket.mjs';
 import '../enums/auth-mail-source.mjs';
+import '../enums/auth-mfa-challenge-request-factor.mjs';
 import '../enums/recovery-mail-source.mjs';
 import '../enums/registration-status.mjs';
+import '../enums/availability-state-tone.mjs';
+import '../enums/banner-draft-layout.mjs';
+import '../enums/banner-draft-update-request-layout.mjs';
 import '../enums/budget-change-reason.mjs';
 import '../enums/budget-movement-result-status.mjs';
+import '../enums/budget-release-scope.mjs';
+import '../enums/budget-release-status.mjs';
 import '../enums/cart-status.mjs';
 import '../enums/cart-merge-strategy.mjs';
 import '../enums/cart-price-snapshot-mode.mjs';
@@ -49,18 +65,43 @@ import '../enums/channel-vocabulary-tone.mjs';
 import '../enums/channel-vocabulary-name.mjs';
 import '../enums/channel-vocabulary-source.mjs';
 import '../enums/channel-vocabulary-ref-name.mjs';
+import '../enums/consent-record-action.mjs';
+import '../enums/consent-record-surface.mjs';
+import '../enums/consent-record-create-request-action.mjs';
+import '../enums/consent-record-create-request-surface.mjs';
+import '../enums/consent-vocabulary-source.mjs';
+import '../enums/contact-order-approval-mode.mjs';
 import '../enums/contact-registration-status.mjs';
 import '../enums/contact-status.mjs';
 import '../enums/contact-activity-kind.mjs';
+import '../enums/order-approval-mode.mjs';
 import '../enums/contact-create-request-registration-status.mjs';
 import '../enums/contact-event-kind-tone.mjs';
 import '../enums/contact-event-kind-create-request-tone.mjs';
 import '../enums/contact-event-kind-update-request-tone.mjs';
-import '../enums/contact-update-request-registration-status.mjs';
+import '../enums/contact-point-kind-tone.mjs';
+import '../enums/contact-point-kind-create-request-tone.mjs';
+import '../enums/contact-point-kind-update-request-tone.mjs';
+import '../enums/cookie-kind.mjs';
+import '../enums/cookie-create-request-kind.mjs';
+import '../enums/cookie-update-request-kind.mjs';
 import '../enums/cost-center-budget-type.mjs';
+import '../enums/cost-center-create-request-budget-type.mjs';
 import '../enums/cost-center-restriction-type.mjs';
 import '../enums/cost-center-restriction-create-request-type.mjs';
 import '../enums/cost-center-restriction-update-request-type.mjs';
+import '../enums/cost-center-update-request-budget-type.mjs';
+import '../enums/cost-centers-vocabulary-tone.mjs';
+import '../enums/cost-centers-vocabulary-source.mjs';
+import '../enums/cost-centers-vocabulary-summary-name.mjs';
+import '../enums/direct-order-status.mjs';
+import '../enums/document-source.mjs';
+import '../enums/document-visibility.mjs';
+import '../enums/document-kind-tone.mjs';
+import '../enums/document-vocabulary-default-tone.mjs';
+import '../enums/document-vocabulary-name.mjs';
+import '../enums/document-vocabulary-source.mjs';
+import '../enums/document-vocabulary-tone.mjs';
 import '../enums/payment-fee-type.mjs';
 import '../enums/payment-method-kind.mjs';
 import '../enums/form-status.mjs';
@@ -70,6 +111,7 @@ import '../enums/form-submission-prune-request-status.mjs';
 import '../enums/forms-vocabulary-tone.mjs';
 import '../enums/forms-vocabulary-name.mjs';
 import '../enums/forms-vocabulary-summary-name.mjs';
+import '../enums/inventory-receive-warning-code.mjs';
 import '../enums/inventory-vocabulary-default-tone.mjs';
 import '../enums/inventory-vocabulary-source.mjs';
 import '../enums/cart-io-apply-mode.mjs';
@@ -77,6 +119,7 @@ import '../enums/cart-io-direction.mjs';
 import '../enums/cart-io-entity.mjs';
 import '../enums/io-profile-resource-apply-mode.mjs';
 import '../enums/io-profile-resource-direction.mjs';
+import '../enums/inventory-unorderable-reason.mjs';
 import '../enums/lifecycle-stage-tone.mjs';
 import '../enums/lifecycle-stage-create-request-tone.mjs';
 import '../enums/lifecycle-stage-update-request-tone.mjs';
@@ -93,28 +136,40 @@ import '../enums/markets-vocabulary-tone.mjs';
 import '../enums/markets-vocabulary-name.mjs';
 import '../enums/markets-vocabulary-source.mjs';
 import '../enums/markets-vocabulary-summary-name.mjs';
+import '../enums/note-request-visibility.mjs';
 import '../enums/order-fulfillment-status.mjs';
 import '../enums/order-payment-status.mjs';
 import '../enums/order-status.mjs';
 import '../enums/order-cancellation-scope.mjs';
 import '../enums/order-comment-visibility.mjs';
+import '../enums/order-discount-target.mjs';
+import '../enums/order-discount-effect-kind.mjs';
+import '../enums/order-discount-placement.mjs';
+import '../enums/order-discount-source.mjs';
+import '../enums/order-discount-value-type.mjs';
 import '../enums/order-item-type.mjs';
 import '../enums/order-list-kind-tone.mjs';
 import '../enums/order-list-kind-row-tone.mjs';
+import '../enums/order-list-skip-reason.mjs';
 import '../enums/order-list-cart-mode.mjs';
 import '../enums/order-list-vocabulary-default-tone.mjs';
 import '../enums/order-list-vocabulary-name.mjs';
 import '../enums/order-list-vocabulary-source.mjs';
 import '../enums/order-list-vocabulary-tone.mjs';
+import '../enums/order-return-refund-mode.mjs';
 import '../enums/order-return-status.mjs';
 import '../enums/order-return-settlement.mjs';
-import '../enums/order-return-refusal.mjs';
 import '../enums/order-vocabulary-tone.mjs';
+import '../enums/order-return-refusal.mjs';
 import '../enums/order-vocabulary-name.mjs';
 import '../enums/order-vocabulary-source.mjs';
 import '../enums/order-vocabulary-summary-name.mjs';
 import '../enums/order-resolution-stage.mjs';
+import '../enums/organization-credit-limit-mode.mjs';
+import '../enums/organization-shipping-advice.mjs';
 import '../enums/organization-status.mjs';
+import '../enums/credit-limit-mode.mjs';
+import '../enums/shipping-advice.mjs';
 import '../enums/page-status.mjs';
 import '../enums/pages-vocabulary-app.mjs';
 import '../enums/pages-vocabulary-tone.mjs';
@@ -136,6 +191,7 @@ import '../enums/price-entries-adjust-response-rounding-mode.mjs';
 import '../enums/price-entries-bulk-mode.mjs';
 import '../enums/price-rounding-mode.mjs';
 import '../enums/price-entry-type.mjs';
+import '../enums/price-line-price-reason.mjs';
 import '../enums/price-list-status.mjs';
 import '../enums/price-list-tax-basis.mjs';
 import '../enums/price-currency-source.mjs';
@@ -147,22 +203,86 @@ import '../enums/price-vocabulary-tone.mjs';
 import '../enums/price-vocabulary-name.mjs';
 import '../enums/price-vocabulary-source.mjs';
 import '../enums/price-vocabulary-ref-name.mjs';
+import '../enums/procurement-vocabulary-default-tone.mjs';
+import '../enums/procurement-vocabulary-name.mjs';
+import '../enums/procurement-vocabulary-source.mjs';
+import '../enums/procurement-vocabulary-summary-name.mjs';
+import '../enums/procurement-vocabulary-value-tone.mjs';
 import '../enums/product-categories-source.mjs';
 import '../enums/product-grid-column-source.mjs';
 import '../enums/product-label-source.mjs';
 import '../enums/product-label-attribute-source.mjs';
 import '../enums/products-kind.mjs';
+import '../enums/promotion-condition-match.mjs';
+import '../enums/promotion-reach.mjs';
+import '../enums/promotion-recurrence-kind.mjs';
+import '../enums/promotion-return-behaviour.mjs';
+import '../enums/promotion-status.mjs';
+import '../enums/promotion-bundle-allocation.mjs';
+import '../enums/promotion-bundle-patch-allocation.mjs';
+import '../enums/promotion-bundle-write-allocation.mjs';
+import '../enums/promotion-condition-kind.mjs';
+import '../enums/promotion-condition-match-mode.mjs';
+import '../enums/promotion-condition-patch-kind.mjs';
+import '../enums/promotion-condition-patch-match-mode.mjs';
+import '../enums/promotion-condition-write-kind.mjs';
+import '../enums/promotion-condition-write-match-mode.mjs';
+import '../enums/promotion-effect-kind.mjs';
+import '../enums/promotion-effect-target-scope.mjs';
+import '../enums/promotion-effect-unit-choice.mjs';
+import '../enums/promotion-effect-value-type.mjs';
+import '../enums/promotion-effect-patch-kind.mjs';
+import '../enums/promotion-effect-patch-target-scope.mjs';
+import '../enums/promotion-effect-patch-unit-choice.mjs';
+import '../enums/promotion-effect-patch-value-type.mjs';
+import '../enums/promotion-effect-write-kind.mjs';
+import '../enums/promotion-effect-write-target-scope.mjs';
+import '../enums/promotion-effect-write-unit-choice.mjs';
+import '../enums/promotion-effect-write-value-type.mjs';
+import '../enums/promotion-patch-condition-match.mjs';
+import '../enums/promotion-patch-reach.mjs';
+import '../enums/promotion-patch-recurrence-kind.mjs';
+import '../enums/promotion-patch-return-behaviour.mjs';
+import '../enums/promotion-patch-status.mjs';
+import '../enums/promotion-release-request-reason.mjs';
+import '../enums/promotion-write-condition-match.mjs';
+import '../enums/promotion-write-reach.mjs';
+import '../enums/promotion-write-recurrence-kind.mjs';
+import '../enums/promotion-write-return-behaviour.mjs';
+import '../enums/promotion-write-status.mjs';
+import '../enums/punchout-entry-probe-result-entry-probe-status.mjs';
+import '../enums/punchout-entry-test-result-protocol.mjs';
+import '../enums/punchout-field-mapping-import-request-protocol.mjs';
+import '../enums/punchout-return-preview-protocol.mjs';
 import '../enums/purchase-request-status.mjs';
 import '../enums/purchase-request-event-name.mjs';
 import '../enums/purchase-request-item-type.mjs';
 import '../enums/purchase-request-item-create-request-type.mjs';
 import '../enums/purchase-request-item-update-request-type.mjs';
+import '../enums/purpose-legal-basis.mjs';
+import '../enums/purpose-create-request-legal-basis.mjs';
+import '../enums/purpose-update-request-legal-basis.mjs';
+import '../enums/quote-origin.mjs';
+import '../enums/quote-status.mjs';
+import '../enums/quote-attachment-direction.mjs';
+import '../enums/quote-attachment-visibility.mjs';
+import '../enums/quote-detail-origin.mjs';
+import '../enums/quote-detail-status.mjs';
+import '../enums/quote-event-visibility.mjs';
+import '../enums/quote-item-decision.mjs';
+import '../enums/quote-item-price-reason.mjs';
+import '../enums/quote-line-input-price-reason.mjs';
+import '../enums/redemption-state.mjs';
 import '../enums/reorder-point-source.mjs';
 import '../enums/reservation-status.mjs';
 import '../enums/price-on-request-reason.mjs';
 import '../enums/price-tax-basis.mjs';
 import '../enums/price-tax-basis-source.mjs';
 import '../enums/role-catalog-response-source.mjs';
+import '../enums/sales-rep-vocabulary-default-tone.mjs';
+import '../enums/sales-rep-vocabulary-source.mjs';
+import '../enums/seed-request-mode.mjs';
+import '../enums/seed-result-mode.mjs';
 import '../enums/segment-rule-match.mjs';
 import '../enums/segment-member-source.mjs';
 import '../enums/segment-rule-operator.mjs';
@@ -192,14 +312,35 @@ import '../enums/shipping-vocabulary-tone.mjs';
 import '../enums/shipping-weight-unit-create-request-tone.mjs';
 import '../enums/shipping-weight-unit-row-tone.mjs';
 import '../enums/shipping-weight-unit-update-request-tone.mjs';
+import '../enums/stacking-group-mode.mjs';
+import '../enums/stacking-group-patch-mode.mjs';
+import '../enums/stacking-group-write-mode.mjs';
 import '../enums/stock-movement-type.mjs';
 import '../enums/store-asset-request-visibility.mjs';
 import '../enums/submit-item-type.mjs';
 import '../enums/submit-result-outcome.mjs';
+import '../enums/tag-manager-container-check-reason.mjs';
+import '../enums/tag-manager-marketing-tag-kind.mjs';
+import '../enums/tag-manager-marketing-tag-load.mjs';
+import '../enums/tag-manager-marketing-tag-input-kind.mjs';
+import '../enums/tag-manager-marketing-tag-input-load.mjs';
+import '../enums/tag-manager-trigger-kind.mjs';
+import '../enums/tag-manager-trigger-input-kind.mjs';
+import '../enums/tag-manager-variable-kind.mjs';
+import '../enums/tag-manager-variable-input-kind.mjs';
 import '../enums/validation-failed-response-status.mjs';
+import '../enums/vendor-legal-basis-override.mjs';
+import '../enums/vendor-create-request-legal-basis-override.mjs';
+import '../enums/vendor-update-request-legal-basis-override.mjs';
 import '../enums/vocabulary-default-tone.mjs';
 import '../enums/vocabulary-source.mjs';
 import '../enums/vocabulary-tone.mjs';
+import '../enums/voucher-status.mjs';
+import '../enums/voucher-batch-status.mjs';
+import '../enums/voucher-batch-patch-status.mjs';
+import '../enums/voucher-batch-write-status.mjs';
+import '../enums/voucher-patch-status.mjs';
+import '../enums/voucher-write-status.mjs';
 import '../enums/attribute-boolean-status.mjs';
 import '../enums/attribute-datetime-status.mjs';
 import '../enums/attribute-email-status.mjs';
@@ -469,35 +610,39 @@ declare class CostCenters {
     /**
      *
      * @param {object[]} params.allocations -
-     * @param {string} params.orderId -
      * @param {string} params.contactId -
      * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {boolean} params.dryRun - true runs the pre-flight (currency, no active budget, tracking-only centres) and answers as the real call would — same status, skipped and refusal — while writing nothing and claiming no key. The purchase request / order id may then be omitted.
      * @param {string} params.note -
+     * @param {string} params.orderId -
      * @throws {RevenexxException}
      * @returns {Promise<Models.BudgetMovementResult>}
      */
     costCentersCommit(params: {
         allocations: object[];
-        orderId: string;
         contactId?: string;
         currency?: string;
+        dryRun?: boolean;
         note?: string;
+        orderId?: string;
     }): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {object[]} allocations -
-     * @param {string} orderId -
      * @param {string} contactId -
      * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {boolean} dryRun - true runs the pre-flight (currency, no active budget, tracking-only centres) and answers as the real call would — same status, skipped and refusal — while writing nothing and claiming no key. The purchase request / order id may then be omitted.
      * @param {string} note -
+     * @param {string} orderId -
      * @throws {RevenexxException}
      * @returns {Promise<Models.BudgetMovementResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersCommit(allocations: object[], orderId: string, contactId?: string, currency?: string, note?: string): Promise<Models.BudgetMovementResult>;
+    costCentersCommit(allocations: object[], contactId?: string, currency?: string, dryRun?: boolean, note?: string, orderId?: string): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {string} params.purchaseRequestId -
+     * @param {object[]} params.allocations - Optional: the request's allocations (the reserve's shape; an empty array is the same as none, and only cost_center_id is read), used only to classify its cost centres by budget type. A request holding no reservation whose every centre is tracking-only is then settled with nothing written; one naming a monetary centre, or naming none, is refused with 409 as before. Amounts are read from the ledger, never from here.
      * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
      * @param {string} params.note -
      * @param {string} params.orderId -
@@ -506,6 +651,7 @@ declare class CostCenters {
      */
     costCentersConfirm(params: {
         purchaseRequestId: string;
+        allocations?: object[];
         currency?: string;
         note?: string;
         orderId?: string;
@@ -513,6 +659,7 @@ declare class CostCenters {
     /**
      *
      * @param {string} purchaseRequestId -
+     * @param {object[]} allocations - Optional: the request's allocations (the reserve's shape; an empty array is the same as none, and only cost_center_id is read), used only to classify its cost centres by budget type. A request holding no reservation whose every centre is tracking-only is then settled with nothing written; one naming a monetary centre, or naming none, is refused with 409 as before. Amounts are read from the ledger, never from here.
      * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
      * @param {string} note -
      * @param {string} orderId -
@@ -520,7 +667,7 @@ declare class CostCenters {
      * @returns {Promise<Models.BudgetMovementResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersConfirm(purchaseRequestId: string, currency?: string, note?: string, orderId?: string): Promise<Models.BudgetMovementResult>;
+    costCentersConfirm(purchaseRequestId: string, allocations?: object[], currency?: string, note?: string, orderId?: string): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {number} params.limit - Page size (default 50, max 200).
@@ -638,6 +785,8 @@ declare class CostCenters {
      * @param {number} params.limit - Page size (default 50, max 200).
      * @param {number} params.offset - Row offset for pagination (default 0).
      * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
+     * @param {string} params.punchoutAccountCode - Code of the punchout account the list is read for. Centres a punchout restriction keeps out of reach of that account are left out (and the total counts only what is returned). Omit for the administrative list, which holds nothing back. A value that is not a non-empty string is refused with 400.
+     * @param {string} params.externalId - Exact-match filter on the key the system that OWNS the centre knows it by — how an import finds the row it wrote last run instead of opening a second centre and splitting a budget across the two. Unique per tenant, so this answers at most one centre; a centre nobody imported matches nothing.
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
@@ -645,26 +794,35 @@ declare class CostCenters {
         limit?: number;
         offset?: number;
         order?: string;
+        punchoutAccountCode?: string;
+        externalId?: string;
     }): Promise<{}>;
     /**
      *
      * @param {number} limit - Page size (default 50, max 200).
      * @param {number} offset - Row offset for pagination (default 0).
      * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
+     * @param {string} punchoutAccountCode - Code of the punchout account the list is read for. Centres a punchout restriction keeps out of reach of that account are left out (and the total counts only what is returned). Omit for the administrative list, which holds nothing back. A value that is not a non-empty string is refused with 400.
+     * @param {string} externalId - Exact-match filter on the key the system that OWNS the centre knows it by — how an import finds the row it wrote last run instead of opening a second centre and splitting a budget across the two. Unique per tenant, so this answers at most one centre; a centre nobody imported matches nothing.
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersCostCentersList(limit?: number, offset?: number, order?: string): Promise<{}>;
+    costCentersCostCentersList(limit?: number, offset?: number, order?: string, punchoutAccountCode?: string, externalId?: string): Promise<{}>;
     /**
      *
      * @param {string} params.code -
      * @param {string} params.name -
      * @param {string} params.accountableContactId -
      * @param {boolean} params.active -
+     * @param {BudgetType} params.budgetType -
      * @param {string} params.currency -
+     * @param {string} params.externalId - The key this cost centre has in the system that OWNS it — the dimension value an ERP books against, which is rarely the `code` a controller types here. Unique per tenant where it is set, so a repeated import upserts on it instead of matching on a name; a centre opened in the Cockpit carries none and never will.
+     * @param {object} params.externalRefs - Every OTHER system that knows this cost centre, keyed by system name — a second ERP, the procurement platform a punchout session comes from, the shop this tenant migrated off. `external_id` names the leading system; this is the rest, and the next one costs no column. Answered on read and carrying no query parameter: the store compares such a field as a WHOLE document, so a filter over part of one is refused. Look the centre up by `external_id` and read this off the answer.
      * @param {object} params.metadata -
      * @param {string} params.organizationId -
+     * @param {object} params.sourceData - What the source said about this cost centre, kept as it said it: `{"system": …, "etag": …, "raw": {…}}`. The `etag` is what a write-back has to send back in `If-Match`, and there is nowhere else to keep it between two runs. `raw` holds the source fields this app does not model — a responsible department, an account range — so an edit here does not silently throw them away.
+     * @param {string} params.sourceSyncedAt - When this cost centre was last confirmed against its source. A delta run asks the source for what changed since it, and a controller reads it to see that a feed has gone quiet. An edit made HERE does not touch it — it records when the source was last seen, not when the row changed — so a stale value beside a fresh `updated_at` means somebody is maintaining by hand what the ERP has stopped delivering.
      * @throws {RevenexxException}
      * @returns {Promise<Models.CostCenter>}
      */
@@ -673,9 +831,14 @@ declare class CostCenters {
         name: string;
         accountableContactId?: string;
         active?: boolean;
+        budgetType?: BudgetType;
         currency?: string;
+        externalId?: string;
+        externalRefs?: object;
         metadata?: object;
         organizationId?: string;
+        sourceData?: object;
+        sourceSyncedAt?: string;
     }): Promise<Models.CostCenter>;
     /**
      *
@@ -683,14 +846,19 @@ declare class CostCenters {
      * @param {string} name -
      * @param {string} accountableContactId -
      * @param {boolean} active -
+     * @param {BudgetType} budgetType -
      * @param {string} currency -
+     * @param {string} externalId - The key this cost centre has in the system that OWNS it — the dimension value an ERP books against, which is rarely the `code` a controller types here. Unique per tenant where it is set, so a repeated import upserts on it instead of matching on a name; a centre opened in the Cockpit carries none and never will.
+     * @param {object} externalRefs - Every OTHER system that knows this cost centre, keyed by system name — a second ERP, the procurement platform a punchout session comes from, the shop this tenant migrated off. `external_id` names the leading system; this is the rest, and the next one costs no column. Answered on read and carrying no query parameter: the store compares such a field as a WHOLE document, so a filter over part of one is refused. Look the centre up by `external_id` and read this off the answer.
      * @param {object} metadata -
      * @param {string} organizationId -
+     * @param {object} sourceData - What the source said about this cost centre, kept as it said it: `{"system": …, "etag": …, "raw": {…}}`. The `etag` is what a write-back has to send back in `If-Match`, and there is nowhere else to keep it between two runs. `raw` holds the source fields this app does not model — a responsible department, an account range — so an edit here does not silently throw them away.
+     * @param {string} sourceSyncedAt - When this cost centre was last confirmed against its source. A delta run asks the source for what changed since it, and a controller reads it to see that a feed has gone quiet. An edit made HERE does not touch it — it records when the source was last seen, not when the row changed — so a stale value beside a fresh `updated_at` means somebody is maintaining by hand what the ERP has stopped delivering.
      * @throws {RevenexxException}
      * @returns {Promise<Models.CostCenter>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersCostCentersCreate(code: string, name: string, accountableContactId?: string, active?: boolean, currency?: string, metadata?: object, organizationId?: string): Promise<Models.CostCenter>;
+    costCentersCostCentersCreate(code: string, name: string, accountableContactId?: string, active?: boolean, budgetType?: BudgetType, currency?: string, externalId?: string, externalRefs?: object, metadata?: object, organizationId?: string, sourceData?: object, sourceSyncedAt?: string): Promise<Models.CostCenter>;
     /**
      *
      * @param {string} params.id -
@@ -730,11 +898,16 @@ declare class CostCenters {
      * @param {string} params.id -
      * @param {string} params.accountableContactId -
      * @param {boolean} params.active -
+     * @param {BudgetType} params.budgetType -
      * @param {string} params.code -
      * @param {string} params.currency -
+     * @param {string} params.externalId - The key this cost centre has in the system that OWNS it — the dimension value an ERP books against, which is rarely the `code` a controller types here. Unique per tenant where it is set, so a repeated import upserts on it instead of matching on a name; a centre opened in the Cockpit carries none and never will.
+     * @param {object} params.externalRefs - Every OTHER system that knows this cost centre, keyed by system name — a second ERP, the procurement platform a punchout session comes from, the shop this tenant migrated off. `external_id` names the leading system; this is the rest, and the next one costs no column. Answered on read and carrying no query parameter: the store compares such a field as a WHOLE document, so a filter over part of one is refused. Look the centre up by `external_id` and read this off the answer.
      * @param {object} params.metadata -
      * @param {string} params.name -
      * @param {string} params.organizationId -
+     * @param {object} params.sourceData - What the source said about this cost centre, kept as it said it: `{"system": …, "etag": …, "raw": {…}}`. The `etag` is what a write-back has to send back in `If-Match`, and there is nowhere else to keep it between two runs. `raw` holds the source fields this app does not model — a responsible department, an account range — so an edit here does not silently throw them away.
+     * @param {string} params.sourceSyncedAt - When this cost centre was last confirmed against its source. A delta run asks the source for what changed since it, and a controller reads it to see that a feed has gone quiet. An edit made HERE does not touch it — it records when the source was last seen, not when the row changed — so a stale value beside a fresh `updated_at` means somebody is maintaining by hand what the ERP has stopped delivering.
      * @throws {RevenexxException}
      * @returns {Promise<Models.CostCenter>}
      */
@@ -742,27 +915,37 @@ declare class CostCenters {
         id: string;
         accountableContactId?: string;
         active?: boolean;
+        budgetType?: BudgetType;
         code?: string;
         currency?: string;
+        externalId?: string;
+        externalRefs?: object;
         metadata?: object;
         name?: string;
         organizationId?: string;
+        sourceData?: object;
+        sourceSyncedAt?: string;
     }): Promise<Models.CostCenter>;
     /**
      *
      * @param {string} id -
      * @param {string} accountableContactId -
      * @param {boolean} active -
+     * @param {BudgetType} budgetType -
      * @param {string} code -
      * @param {string} currency -
+     * @param {string} externalId - The key this cost centre has in the system that OWNS it — the dimension value an ERP books against, which is rarely the `code` a controller types here. Unique per tenant where it is set, so a repeated import upserts on it instead of matching on a name; a centre opened in the Cockpit carries none and never will.
+     * @param {object} externalRefs - Every OTHER system that knows this cost centre, keyed by system name — a second ERP, the procurement platform a punchout session comes from, the shop this tenant migrated off. `external_id` names the leading system; this is the rest, and the next one costs no column. Answered on read and carrying no query parameter: the store compares such a field as a WHOLE document, so a filter over part of one is refused. Look the centre up by `external_id` and read this off the answer.
      * @param {object} metadata -
      * @param {string} name -
      * @param {string} organizationId -
+     * @param {object} sourceData - What the source said about this cost centre, kept as it said it: `{"system": …, "etag": …, "raw": {…}}`. The `etag` is what a write-back has to send back in `If-Match`, and there is nowhere else to keep it between two runs. `raw` holds the source fields this app does not model — a responsible department, an account range — so an edit here does not silently throw them away.
+     * @param {string} sourceSyncedAt - When this cost centre was last confirmed against its source. A delta run asks the source for what changed since it, and a controller reads it to see that a feed has gone quiet. An edit made HERE does not touch it — it records when the source was last seen, not when the row changed — so a stale value beside a fresh `updated_at` means somebody is maintaining by hand what the ERP has stopped delivering.
      * @throws {RevenexxException}
      * @returns {Promise<Models.CostCenter>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersCostCentersUpdate(id: string, accountableContactId?: string, active?: boolean, code?: string, currency?: string, metadata?: object, name?: string, organizationId?: string): Promise<Models.CostCenter>;
+    costCentersCostCentersUpdate(id: string, accountableContactId?: string, active?: boolean, budgetType?: BudgetType, code?: string, currency?: string, externalId?: string, externalRefs?: object, metadata?: object, name?: string, organizationId?: string, sourceData?: object, sourceSyncedAt?: string): Promise<Models.CostCenter>;
     /**
      *
      * @param {string} params.id -
@@ -805,6 +988,7 @@ declare class CostCenters {
      * @param {string} params.contactId -
      * @param {string} params.costCenterId -
      * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {string} params.punchoutAccountCode - Code of the punchout account the request is made in. Omit outside a punchout session: a cost centre restricted with mode 'only' is then out of reach, and one restricted with 'except' is offered. A value that is not a non-empty string is refused with 400.
      * @throws {RevenexxException}
      * @returns {Promise<Models.EvaluateResult>}
      */
@@ -814,6 +998,7 @@ declare class CostCenters {
         contactId?: string;
         costCenterId?: string;
         currency?: string;
+        punchoutAccountCode?: string;
     }): Promise<Models.EvaluateResult>;
     /**
      *
@@ -822,40 +1007,76 @@ declare class CostCenters {
      * @param {string} contactId -
      * @param {string} costCenterId -
      * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {string} punchoutAccountCode - Code of the punchout account the request is made in. Omit outside a punchout session: a cost centre restricted with mode 'only' is then out of reach, and one restricted with 'except' is offered. A value that is not a non-empty string is refused with 400.
      * @throws {RevenexxException}
      * @returns {Promise<Models.EvaluateResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersEvaluate(amount: number, conditions?: Conditions[], contactId?: string, costCenterId?: string, currency?: string): Promise<Models.EvaluateResult>;
+    costCentersEvaluate(amount: number, conditions?: Conditions[], contactId?: string, costCenterId?: string, currency?: string, punchoutAccountCode?: string): Promise<Models.EvaluateResult>;
+    /**
+     *
+     * @param {string} params.key - Idempotency key of this cancellation within the order (e.g. the cancellation id, or cancellation_id:item_id for one item). A repeat under the same key gives nothing back again.
+     * @param {string} params.orderId -
+     * @param {object[]} params.allocations - Optional: the amount to give back per cost centre, capped at what the order booked there. Omit to give back everything still booked for the order.
+     * @param {string} params.contactId -
+     * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {string} params.note -
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.BudgetMovementResult>}
+     */
+    costCentersRelease(params: {
+        key: string;
+        orderId: string;
+        allocations?: object[];
+        contactId?: string;
+        currency?: string;
+        note?: string;
+    }): Promise<Models.BudgetMovementResult>;
+    /**
+     *
+     * @param {string} key - Idempotency key of this cancellation within the order (e.g. the cancellation id, or cancellation_id:item_id for one item). A repeat under the same key gives nothing back again.
+     * @param {string} orderId -
+     * @param {object[]} allocations - Optional: the amount to give back per cost centre, capped at what the order booked there. Omit to give back everything still booked for the order.
+     * @param {string} contactId -
+     * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {string} note -
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.BudgetMovementResult>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    costCentersRelease(key: string, orderId: string, allocations?: object[], contactId?: string, currency?: string, note?: string): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {object[]} params.allocations -
-     * @param {string} params.purchaseRequestId -
      * @param {string} params.contactId -
      * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {boolean} params.dryRun - true runs the pre-flight (currency, no active budget, tracking-only centres) and answers as the real call would — same status, skipped and refusal — while writing nothing and claiming no key. The purchase request / order id may then be omitted.
      * @param {string} params.note -
+     * @param {string} params.purchaseRequestId -
      * @throws {RevenexxException}
      * @returns {Promise<Models.BudgetMovementResult>}
      */
     costCentersReserve(params: {
         allocations: object[];
-        purchaseRequestId: string;
         contactId?: string;
         currency?: string;
+        dryRun?: boolean;
         note?: string;
+        purchaseRequestId?: string;
     }): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {object[]} allocations -
-     * @param {string} purchaseRequestId -
      * @param {string} contactId -
      * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
+     * @param {boolean} dryRun - true runs the pre-flight (currency, no active budget, tracking-only centres) and answers as the real call would — same status, skipped and refusal — while writing nothing and claiming no key. The purchase request / order id may then be omitted.
      * @param {string} note -
+     * @param {string} purchaseRequestId -
      * @throws {RevenexxException}
      * @returns {Promise<Models.BudgetMovementResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersReserve(allocations: object[], purchaseRequestId: string, contactId?: string, currency?: string, note?: string): Promise<Models.BudgetMovementResult>;
+    costCentersReserve(allocations: object[], contactId?: string, currency?: string, dryRun?: boolean, note?: string, purchaseRequestId?: string): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {object[]} params.allocations -
@@ -1002,6 +1223,7 @@ declare class CostCenters {
      * @param {object[]} params.lines -
      * @param {string} params.contactId -
      * @param {string} params.organizationId -
+     * @param {string} params.punchoutAccountCode - Code of the punchout account the request is made in. Omit outside a punchout session: a cost centre restricted with mode 'only' is then out of reach, and one restricted with 'except' is offered. A value that is not a non-empty string is refused with 400.
      * @param {string[]} params.roles -
      * @throws {RevenexxException}
      * @returns {Promise<Models.UsableResult>}
@@ -1010,6 +1232,7 @@ declare class CostCenters {
         lines: object[];
         contactId?: string;
         organizationId?: string;
+        punchoutAccountCode?: string;
         roles?: string[];
     }): Promise<Models.UsableResult>;
     /**
@@ -1017,15 +1240,40 @@ declare class CostCenters {
      * @param {object[]} lines -
      * @param {string} contactId -
      * @param {string} organizationId -
+     * @param {string} punchoutAccountCode - Code of the punchout account the request is made in. Omit outside a punchout session: a cost centre restricted with mode 'only' is then out of reach, and one restricted with 'except' is offered. A value that is not a non-empty string is refused with 400.
      * @param {string[]} roles -
      * @throws {RevenexxException}
      * @returns {Promise<Models.UsableResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersUsable(lines: object[], contactId?: string, organizationId?: string, roles?: string[]): Promise<Models.UsableResult>;
+    costCentersUsable(lines: object[], contactId?: string, organizationId?: string, punchoutAccountCode?: string, roles?: string[]): Promise<Models.UsableResult>;
+    /**
+     *
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CostCentersVocabularyIndex>}
+     */
+    costCentersVocabularies(): Promise<Models.CostCentersVocabularyIndex>;
+    /**
+     *
+     * @param {CostCentersVocabularyName} params.name - Which vocabulary to read. The enum is exhaustive; anything else is a 404.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CostCentersVocabulary>}
+     */
+    costCentersVocabulary(params: {
+        name: CostCentersVocabularyName;
+    }): Promise<Models.CostCentersVocabulary>;
+    /**
+     *
+     * @param {CostCentersVocabularyName} name - Which vocabulary to read. The enum is exhaustive; anything else is a 404.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CostCentersVocabulary>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    costCentersVocabulary(name: CostCentersVocabularyName): Promise<Models.CostCentersVocabulary>;
     /**
      *
      * @param {string} params.purchaseRequestId -
+     * @param {object[]} params.allocations - Optional: the request's allocations (the reserve's shape; an empty array is the same as none, and only cost_center_id is read), used only to classify its cost centres by budget type. A request holding no reservation whose every centre is tracking-only is then settled with nothing written; one naming a monetary centre, or naming none, is refused with 409 as before. Amounts are read from the ledger, never from here.
      * @param {string} params.currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
      * @param {string} params.note -
      * @throws {RevenexxException}
@@ -1033,19 +1281,21 @@ declare class CostCenters {
      */
     costCentersWithdraw(params: {
         purchaseRequestId: string;
+        allocations?: object[];
         currency?: string;
         note?: string;
     }): Promise<Models.BudgetMovementResult>;
     /**
      *
      * @param {string} purchaseRequestId -
+     * @param {object[]} allocations - Optional: the request's allocations (the reserve's shape; an empty array is the same as none, and only cost_center_id is read), used only to classify its cost centres by budget type. A request holding no reservation whose every centre is tracking-only is then settled with nothing written; one naming a monetary centre, or naming none, is refused with 409 as before. Amounts are read from the ledger, never from here.
      * @param {string} currency - ISO 4217 code the amount is stated in. Omit to be read in the cost centre's (or the personal limit's) own currency; a code that differs from it is refused with 409 currency_mismatch.
      * @param {string} note -
      * @throws {RevenexxException}
      * @returns {Promise<Models.BudgetMovementResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    costCentersWithdraw(purchaseRequestId: string, currency?: string, note?: string): Promise<Models.BudgetMovementResult>;
+    costCentersWithdraw(purchaseRequestId: string, allocations?: object[], currency?: string, note?: string): Promise<Models.BudgetMovementResult>;
 }
 
 export { CostCenters };