@revenexx/node 0.1.1 → 0.2.0

package/dist/services/prices.d.mts

@@ -7,6 +7,9 @@ import { PriceEndingRule } from '../enums/price-ending-rule.mjs';
 import { PriceEntriesBulkMode } from '../enums/price-entries-bulk-mode.mjs';
 import { PricesVocabulariesGetName } from '../enums/prices-vocabularies-get-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';
@@ -20,12 +23,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';
@@ -53,18 +67,44 @@ 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-name.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';
@@ -74,6 +114,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';
@@ -81,6 +122,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';
@@ -97,28 +139,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';
@@ -137,6 +191,7 @@ import '../enums/pending-approval-status.mjs';
 import '../enums/price-entries-adjust-response-rounding.mjs';
 import '../enums/price-entries-adjust-response-rounding-mode.mjs';
 import '../enums/price-rounding-mode.mjs';
+import '../enums/price-line-price-reason.mjs';
 import '../enums/price-currency-source.mjs';
 import '../enums/price-list-tiebreak.mjs';
 import '../enums/price-tax-inclusive-default.mjs';
@@ -146,22 +201,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';
@@ -191,14 +310,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';
@@ -265,11 +405,14 @@ declare class Prices {
      * @param {boolean} params.requiresAuth - Filter to the lists that resolve only for an authenticated buyer — what an anonymous storefront will never see.
      * @param {string} params.contactId - Filter to the lists scoped to one contact — the most specific buyer scope there is.
      * @param {string} params.organizationId - Filter to the lists scoped to one organization.
+     * @param {string} params.segmentCode - Filter to the lists scoped to one buyer segment — the graduated price book a whole group of organizations is on. Exact match on the segment’s own code; a list scoped to no segment is never answered by it.
      * @param {string} params.channelId - Filter to the lists scoped to one sales channel.
      * @param {string} params.validFrom - Exact equality on the start of the list’s validity window — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.validUntil - Exact equality on the end of the list’s validity window — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.createdAt - Exact equality on the creation instant — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.updatedAt - Exact equality on the last change — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
+     * @param {string} params.externalId - Filter by the key the system that OWNS the price list knows it by — how an import finds the row it wrote last run. Exact match; a price list maintained here carries none and is never answered by it.
+     * @param {string} params.sourceSyncedAt - Filter to the price lists last confirmed against their source at exactly this instant. A filter is an equality, so bounding a period means sorting with `order` and paging.
      * @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 by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
@@ -290,11 +433,14 @@ declare class Prices {
         requiresAuth?: boolean;
         contactId?: string;
         organizationId?: string;
+        segmentCode?: string;
         channelId?: string;
         validFrom?: string;
         validUntil?: string;
         createdAt?: string;
         updatedAt?: string;
+        externalId?: string;
+        sourceSyncedAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
@@ -319,11 +465,14 @@ declare class Prices {
      * @param {boolean} requiresAuth - Filter to the lists that resolve only for an authenticated buyer — what an anonymous storefront will never see.
      * @param {string} contactId - Filter to the lists scoped to one contact — the most specific buyer scope there is.
      * @param {string} organizationId - Filter to the lists scoped to one organization.
+     * @param {string} segmentCode - Filter to the lists scoped to one buyer segment — the graduated price book a whole group of organizations is on. Exact match on the segment’s own code; a list scoped to no segment is never answered by it.
      * @param {string} channelId - Filter to the lists scoped to one sales channel.
      * @param {string} validFrom - Exact equality on the start of the list’s validity window — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} validUntil - Exact equality on the end of the list’s validity window — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} createdAt - Exact equality on the creation instant — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} updatedAt - Exact equality on the last change — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
+     * @param {string} externalId - Filter by the key the system that OWNS the price list knows it by — how an import finds the row it wrote last run. Exact match; a price list maintained here carries none and is never answered by it.
+     * @param {string} sourceSyncedAt - Filter to the price lists last confirmed against their source at exactly this instant. A filter is an equality, so bounding a period means sorting with `order` and paging.
      * @param {number} limit - Page size (default 50, max 200).
      * @param {number} offset - Row offset for pagination (default 0).
      * @param {string} order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
@@ -331,7 +480,7 @@ declare class Prices {
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesListsList(id?: string, code?: string, name?: string, description?: string, currency?: string, status?: PriceListStatus, priority?: number, isDefault?: boolean, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, requiresAuth?: boolean, contactId?: string, organizationId?: string, channelId?: string, validFrom?: string, validUntil?: string, createdAt?: string, updatedAt?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    pricesListsList(id?: string, code?: string, name?: string, description?: string, currency?: string, status?: PriceListStatus, priority?: number, isDefault?: boolean, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, requiresAuth?: boolean, contactId?: string, organizationId?: string, segmentCode?: string, channelId?: string, validFrom?: string, validUntil?: string, createdAt?: string, updatedAt?: string, externalId?: string, sourceSyncedAt?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
     /**
      * Opens an empty book, and states in one row the four things that decide whether it will ever price anything: its currency, its priority within a specificity group, its validity window, and its buyer scope (contact, organization or channel — leave all three empty for a list open to everyone).
      *
@@ -339,22 +488,23 @@ declare class Prices {
      *
      * Everything else has a default, and two of them are worth choosing rather than accepting. `currency` defaults to EUR and is the currency of every amount in the list, since entries carry none; a resolve call only considers lists in the currency it is asked about, and nothing is ever converted. `tax_basis` defaults to NOTHING, which means the amounts inherit the tenant's `tax_inclusive_default` — state net or gross here and the answer stops depending on a tenant setting somebody may change later.
      *
-     * `is_default: true` here does NOT demote the list that currently holds the flag: you end up with two defaults, and which of them prices an item is left to the tenant's tie-break. Create the list, then move the flag with `POST /prices/lists/{list_id}/make-default`.
+     * `is_default: true` is taken only while no list of the tenant carries the flag — the first list, the seed. Once a default exists the create is refused with 409 `default_exists`: create the list without the flag, then move it with `POST /prices/lists/{list_id}/make-default`, which demotes the incumbent in the same call. That is what keeps the flag on exactly one list.
      *
      * A new list prices nothing at all until it has entries, so it is inert until you add them — which makes it safe to create one ahead of the prices that will fill it.
      *
      * @param {string} params.code - Unique list code per tenant — the handle every import and integration addresses this list by. A code already in use answers 409.
      * @param {string} params.name - Operator-facing name, shown wherever a human picks a list.
-     * @param {string} params.channelId - Scope: only this sales channel. Beats the open lists, loses to contact and organization.
+     * @param {string} params.channelId - Scope: only this sales channel. Beats the open lists, loses to contact, organization and segment.
      * @param {string} params.contactId - Scope: only this contact. The most specific scope there is — it beats organization, channel and every open list, whatever their priority.
      * @param {string} params.currency - ISO 4217 code (default EUR) — the currency of EVERY amount in this list, since entries carry none of their own. Resolution only considers lists matching the currency of the call; nothing is ever converted.
      * @param {string} params.description - Free text for whoever maintains the list — why it exists and who it is for. Never shown to a buyer.
-     * @param {boolean} params.isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Use prices.lists.make-default to move the flag rather than setting it here — two defaults leave a tie to row order.
+     * @param {boolean} params.isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Taken on a create only while no list carries the flag (409 default_exists otherwise); a change may restate it but never move it (400 default_via_make_default). prices.lists.make-default moves it.
      * @param {object} params.labels - Localised names, keyed by language tag — {"de": "Händlerpreise", "en": "Dealer prices"}. Omit to show `name` everywhere.
      * @param {object} params.metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours — ERP provenance is the usual content.
      * @param {string} params.organizationId - Scope: only buyers of this organization. Beats channel-scoped and open lists.
      * @param {number} params.priority - Tie-break WITHIN a specificity group (higher wins, default 0). It never beats scope: an organization list at 0 still wins over an open list at 100.
      * @param {boolean} params.requiresAuth - Gate: when true the list resolves only for an authenticated buyer (contact or organization context); anonymous resolve calls get on_request. Default false (open to everyone).
+     * @param {string} params.segmentCode - Scope: every buyer in this buyer segment — a GROUP of organizations, which is how a graduated price book is expressed without one list per organization. The segment’s own code, matched exactly against the segment_codes a resolve call states. Ranks between organization and channel.
      * @param {PriceListStatus} params.status - Default 'active' — only active lists resolve. 'inactive' retires a list without deleting its prices.
      * @param {PriceListTaxBasis} params.taxBasis - Whether the amounts in this list are net (tax excluded) or gross (tax included) — the one fact a price cannot be without. Omit (null) to inherit the tenant's tax_inclusive_default setting; the resolve answer names which of the two decided under tax_basis_source.
      * @param {boolean} params.taxIncluded - LEGACY mirror of tax_basis. false is the column default and is NOT read as a statement of intent; true is read as gross, and only where tax_basis is null. Prefer tax_basis.
@@ -376,6 +526,7 @@ declare class Prices {
         organizationId?: string;
         priority?: number;
         requiresAuth?: boolean;
+        segmentCode?: string;
         status?: PriceListStatus;
         taxBasis?: PriceListTaxBasis;
         taxIncluded?: boolean;
@@ -389,22 +540,23 @@ declare class Prices {
      *
      * Everything else has a default, and two of them are worth choosing rather than accepting. `currency` defaults to EUR and is the currency of every amount in the list, since entries carry none; a resolve call only considers lists in the currency it is asked about, and nothing is ever converted. `tax_basis` defaults to NOTHING, which means the amounts inherit the tenant's `tax_inclusive_default` — state net or gross here and the answer stops depending on a tenant setting somebody may change later.
      *
-     * `is_default: true` here does NOT demote the list that currently holds the flag: you end up with two defaults, and which of them prices an item is left to the tenant's tie-break. Create the list, then move the flag with `POST /prices/lists/{list_id}/make-default`.
+     * `is_default: true` is taken only while no list of the tenant carries the flag — the first list, the seed. Once a default exists the create is refused with 409 `default_exists`: create the list without the flag, then move it with `POST /prices/lists/{list_id}/make-default`, which demotes the incumbent in the same call. That is what keeps the flag on exactly one list.
      *
      * A new list prices nothing at all until it has entries, so it is inert until you add them — which makes it safe to create one ahead of the prices that will fill it.
      *
      * @param {string} code - Unique list code per tenant — the handle every import and integration addresses this list by. A code already in use answers 409.
      * @param {string} name - Operator-facing name, shown wherever a human picks a list.
-     * @param {string} channelId - Scope: only this sales channel. Beats the open lists, loses to contact and organization.
+     * @param {string} channelId - Scope: only this sales channel. Beats the open lists, loses to contact, organization and segment.
      * @param {string} contactId - Scope: only this contact. The most specific scope there is — it beats organization, channel and every open list, whatever their priority.
      * @param {string} currency - ISO 4217 code (default EUR) — the currency of EVERY amount in this list, since entries carry none of their own. Resolution only considers lists matching the currency of the call; nothing is ever converted.
      * @param {string} description - Free text for whoever maintains the list — why it exists and who it is for. Never shown to a buyer.
-     * @param {boolean} isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Use prices.lists.make-default to move the flag rather than setting it here — two defaults leave a tie to row order.
+     * @param {boolean} isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Taken on a create only while no list carries the flag (409 default_exists otherwise); a change may restate it but never move it (400 default_via_make_default). prices.lists.make-default moves it.
      * @param {object} labels - Localised names, keyed by language tag — {"de": "Händlerpreise", "en": "Dealer prices"}. Omit to show `name` everywhere.
      * @param {object} metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours — ERP provenance is the usual content.
      * @param {string} organizationId - Scope: only buyers of this organization. Beats channel-scoped and open lists.
      * @param {number} priority - Tie-break WITHIN a specificity group (higher wins, default 0). It never beats scope: an organization list at 0 still wins over an open list at 100.
      * @param {boolean} requiresAuth - Gate: when true the list resolves only for an authenticated buyer (contact or organization context); anonymous resolve calls get on_request. Default false (open to everyone).
+     * @param {string} segmentCode - Scope: every buyer in this buyer segment — a GROUP of organizations, which is how a graduated price book is expressed without one list per organization. The segment’s own code, matched exactly against the segment_codes a resolve call states. Ranks between organization and channel.
      * @param {PriceListStatus} status - Default 'active' — only active lists resolve. 'inactive' retires a list without deleting its prices.
      * @param {PriceListTaxBasis} taxBasis - Whether the amounts in this list are net (tax excluded) or gross (tax included) — the one fact a price cannot be without. Omit (null) to inherit the tenant's tax_inclusive_default setting; the resolve answer names which of the two decided under tax_basis_source.
      * @param {boolean} taxIncluded - LEGACY mirror of tax_basis. false is the column default and is NOT read as a statement of intent; true is read as gross, and only where tax_basis is null. Prefer tax_basis.
@@ -414,7 +566,7 @@ declare class Prices {
      * @returns {Promise<Models.PriceList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesListsCreate(code: string, name: string, channelId?: string, contactId?: string, currency?: string, description?: string, isDefault?: boolean, labels?: object, metadata?: object, organizationId?: string, priority?: number, requiresAuth?: boolean, status?: PriceListStatus, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
+    pricesListsCreate(code: string, name: string, channelId?: string, contactId?: string, currency?: string, description?: string, isDefault?: boolean, labels?: object, metadata?: object, organizationId?: string, priority?: number, requiresAuth?: boolean, segmentCode?: string, status?: PriceListStatus, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
     /**
      * Gives a tenant the one open list every tenant needs, so nothing has to exist before the first price can be written. Almost nobody calls it: the app runs it by itself on `app.installed`, and the route is the manual re-run — for a tenant installed before that hook existed, or one whose standard list was deleted. Because it is idempotent it is also safe to call from a provisioning script that cannot know which of the two is the case.
      *
@@ -429,7 +581,7 @@ declare class Prices {
     /**
      * Deletes the list AND every price in it. `price_entries.price_list_id` references this row ON DELETE CASCADE, so the entries go in the same statement: nothing asks, nothing blocks, a book of 40 000 prices deletes exactly as fast as an empty one, and the answer is a bare `{deleted, id}` that never says how many prices went with it.
      *
-     * What that means while a storefront is quoting: from the next resolve call the items this list priced fall through to the next candidate list, and where there is none the answer is `on_request` — "price on request" for something that had a price a second ago, never €0. If the deleted list held the default flag the tenant has no default until one is moved onto another list; re-running `POST /prices/lists/defaults` recreates the standard list only while no other default exists.
+     * What that means while a storefront is quoting: from the next resolve call the items this list priced fall through to the next candidate list, and where there is none the answer is `on_request` — "price on request" for something that had a price a second ago, never €0. The default list itself is never deleted: move the flag with `POST /prices/lists/{list_id}/make-default` first, otherwise the delete answers 409 `default_price_list`.
      *
      * This is not the way to take a list out of circulation. `status: "inactive"` does that immediately and reversibly and keeps the prices; deleting is for a list whose contents you are prepared to import again, because nothing here is recoverable.
      *
@@ -443,7 +595,7 @@ declare class Prices {
     /**
      * Deletes the list AND every price in it. `price_entries.price_list_id` references this row ON DELETE CASCADE, so the entries go in the same statement: nothing asks, nothing blocks, a book of 40 000 prices deletes exactly as fast as an empty one, and the answer is a bare `{deleted, id}` that never says how many prices went with it.
      *
-     * What that means while a storefront is quoting: from the next resolve call the items this list priced fall through to the next candidate list, and where there is none the answer is `on_request` — "price on request" for something that had a price a second ago, never €0. If the deleted list held the default flag the tenant has no default until one is moved onto another list; re-running `POST /prices/lists/defaults` recreates the standard list only while no other default exists.
+     * What that means while a storefront is quoting: from the next resolve call the items this list priced fall through to the next candidate list, and where there is none the answer is `on_request` — "price on request" for something that had a price a second ago, never €0. The default list itself is never deleted: move the flag with `POST /prices/lists/{list_id}/make-default` first, otherwise the delete answers 409 `default_price_list`.
      *
      * This is not the way to take a list out of circulation. `status: "inactive"` does that immediately and reversibly and keeps the prices; deleting is for a list whose contents you are prepared to import again, because nothing here is recoverable.
      *
@@ -477,21 +629,22 @@ declare class Prices {
      *
      * Three edits do more than their field names suggest. `currency` re-denominates without converting: entries carry no currency of their own, so 19.90 EUR becomes 19.90 CHF and the whole book is re-priced by one edit. `status: "inactive"` takes the list out of every quote immediately while keeping its prices — the reversible way to stop selling on a list, and the one to reach for instead of deleting it. `code` is the handle imports and integrations address the list by, and a code another list already holds is a 409.
      *
-     * `is_default` behaves here exactly as it does on create: setting it true leaves the incumbent default in place, so use `POST /prices/lists/{list_id}/make-default`, which demotes in the same call.
+     * `is_default` may be restated as it stands, never changed: a change that sets or clears it is refused with 400 `default_via_make_default`. `POST /prices/lists/{list_id}/make-default` moves the flag and demotes in the same call. On every write rule a change is checked only where a value changes, so a list stored before a rule existed can be saved back as it is.
      *
      * @param {string} params.id - The price list, by id.
-     * @param {string} params.channelId - Scope: only this sales channel. Beats the open lists, loses to contact and organization.
+     * @param {string} params.channelId - Scope: only this sales channel. Beats the open lists, loses to contact, organization and segment.
      * @param {string} params.code - Unique list code per tenant — the handle every import and integration addresses this list by. A code already in use answers 409.
      * @param {string} params.contactId - Scope: only this contact. The most specific scope there is — it beats organization, channel and every open list, whatever their priority.
      * @param {string} params.currency - ISO 4217 code (default EUR) — the currency of EVERY amount in this list, since entries carry none of their own. Resolution only considers lists matching the currency of the call; nothing is ever converted.
      * @param {string} params.description - Free text for whoever maintains the list — why it exists and who it is for. Never shown to a buyer.
-     * @param {boolean} params.isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Use prices.lists.make-default to move the flag rather than setting it here — two defaults leave a tie to row order.
+     * @param {boolean} params.isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Taken on a create only while no list carries the flag (409 default_exists otherwise); a change may restate it but never move it (400 default_via_make_default). prices.lists.make-default moves it.
      * @param {object} params.labels - Localised names, keyed by language tag — {"de": "Händlerpreise", "en": "Dealer prices"}. Omit to show `name` everywhere.
      * @param {object} params.metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours — ERP provenance is the usual content.
      * @param {string} params.name - Operator-facing name, shown wherever a human picks a list.
      * @param {string} params.organizationId - Scope: only buyers of this organization. Beats channel-scoped and open lists.
      * @param {number} params.priority - Tie-break WITHIN a specificity group (higher wins, default 0). It never beats scope: an organization list at 0 still wins over an open list at 100.
      * @param {boolean} params.requiresAuth - Gate: when true the list resolves only for an authenticated buyer (contact or organization context); anonymous resolve calls get on_request. Default false (open to everyone).
+     * @param {string} params.segmentCode - Scope: every buyer in this buyer segment — a GROUP of organizations, which is how a graduated price book is expressed without one list per organization. The segment’s own code, matched exactly against the segment_codes a resolve call states. Ranks between organization and channel.
      * @param {PriceListStatus} params.status - Default 'active' — only active lists resolve. 'inactive' retires a list without deleting its prices.
      * @param {PriceListTaxBasis} params.taxBasis - Whether the amounts in this list are net (tax excluded) or gross (tax included) — the one fact a price cannot be without. Omit (null) to inherit the tenant's tax_inclusive_default setting; the resolve answer names which of the two decided under tax_basis_source.
      * @param {boolean} params.taxIncluded - LEGACY mirror of tax_basis. false is the column default and is NOT read as a statement of intent; true is read as gross, and only where tax_basis is null. Prefer tax_basis.
@@ -514,6 +667,7 @@ declare class Prices {
         organizationId?: string;
         priority?: number;
         requiresAuth?: boolean;
+        segmentCode?: string;
         status?: PriceListStatus;
         taxBasis?: PriceListTaxBasis;
         taxIncluded?: boolean;
@@ -525,21 +679,22 @@ declare class Prices {
      *
      * Three edits do more than their field names suggest. `currency` re-denominates without converting: entries carry no currency of their own, so 19.90 EUR becomes 19.90 CHF and the whole book is re-priced by one edit. `status: "inactive"` takes the list out of every quote immediately while keeping its prices — the reversible way to stop selling on a list, and the one to reach for instead of deleting it. `code` is the handle imports and integrations address the list by, and a code another list already holds is a 409.
      *
-     * `is_default` behaves here exactly as it does on create: setting it true leaves the incumbent default in place, so use `POST /prices/lists/{list_id}/make-default`, which demotes in the same call.
+     * `is_default` may be restated as it stands, never changed: a change that sets or clears it is refused with 400 `default_via_make_default`. `POST /prices/lists/{list_id}/make-default` moves the flag and demotes in the same call. On every write rule a change is checked only where a value changes, so a list stored before a rule existed can be saved back as it is.
      *
      * @param {string} id - The price list, by id.
-     * @param {string} channelId - Scope: only this sales channel. Beats the open lists, loses to contact and organization.
+     * @param {string} channelId - Scope: only this sales channel. Beats the open lists, loses to contact, organization and segment.
      * @param {string} code - Unique list code per tenant — the handle every import and integration addresses this list by. A code already in use answers 409.
      * @param {string} contactId - Scope: only this contact. The most specific scope there is — it beats organization, channel and every open list, whatever their priority.
      * @param {string} currency - ISO 4217 code (default EUR) — the currency of EVERY amount in this list, since entries carry none of their own. Resolution only considers lists matching the currency of the call; nothing is ever converted.
      * @param {string} description - Free text for whoever maintains the list — why it exists and who it is for. Never shown to a buyer.
-     * @param {boolean} isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Use prices.lists.make-default to move the flag rather than setting it here — two defaults leave a tie to row order.
+     * @param {boolean} isDefault - The fallback list. Within its group it sorts LAST, so it wins only where nothing more specific priced the item. Taken on a create only while no list carries the flag (409 default_exists otherwise); a change may restate it but never move it (400 default_via_make_default). prices.lists.make-default moves it.
      * @param {object} labels - Localised names, keyed by language tag — {"de": "Händlerpreise", "en": "Dealer prices"}. Omit to show `name` everywhere.
      * @param {object} metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours — ERP provenance is the usual content.
      * @param {string} name - Operator-facing name, shown wherever a human picks a list.
      * @param {string} organizationId - Scope: only buyers of this organization. Beats channel-scoped and open lists.
      * @param {number} priority - Tie-break WITHIN a specificity group (higher wins, default 0). It never beats scope: an organization list at 0 still wins over an open list at 100.
      * @param {boolean} requiresAuth - Gate: when true the list resolves only for an authenticated buyer (contact or organization context); anonymous resolve calls get on_request. Default false (open to everyone).
+     * @param {string} segmentCode - Scope: every buyer in this buyer segment — a GROUP of organizations, which is how a graduated price book is expressed without one list per organization. The segment’s own code, matched exactly against the segment_codes a resolve call states. Ranks between organization and channel.
      * @param {PriceListStatus} status - Default 'active' — only active lists resolve. 'inactive' retires a list without deleting its prices.
      * @param {PriceListTaxBasis} taxBasis - Whether the amounts in this list are net (tax excluded) or gross (tax included) — the one fact a price cannot be without. Omit (null) to inherit the tenant's tax_inclusive_default setting; the resolve answer names which of the two decided under tax_basis_source.
      * @param {boolean} taxIncluded - LEGACY mirror of tax_basis. false is the column default and is NOT read as a statement of intent; true is read as gross, and only where tax_basis is null. Prefer tax_basis.
@@ -549,7 +704,7 @@ declare class Prices {
      * @returns {Promise<Models.PriceList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesListsUpdate(id: string, channelId?: string, code?: string, contactId?: string, currency?: string, description?: string, isDefault?: boolean, labels?: object, metadata?: object, name?: string, organizationId?: string, priority?: number, requiresAuth?: boolean, status?: PriceListStatus, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
+    pricesListsUpdate(id: string, channelId?: string, code?: string, contactId?: string, currency?: string, description?: string, isDefault?: boolean, labels?: object, metadata?: object, name?: string, organizationId?: string, priority?: number, requiresAuth?: boolean, segmentCode?: string, status?: PriceListStatus, taxBasis?: PriceListTaxBasis, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
     /**
      * The prices inside one list, a page at a time. An entry is a rung rather than "the price of a product": it carries a quantity threshold, an amount and a unit, its own validity window, and — where the answer is deliberately no number at all — an `on_request` marker instead of one. So this page is where the quantity tiers, the promo windows and the "ask us" markers of a book are read.
      *
@@ -563,10 +718,16 @@ declare class Prices {
      * @param {number} params.quantityMin - Filter to one exact tier threshold — `?quantity_min=1` is the base rung of every ladder in the list.
      * @param {number} params.unitPrice - Filter to entries at one exact amount, in the list’s currency and on its tax basis. Equality, not a range — `?unit_price=0` finds the rows nobody has priced yet.
      * @param {string} params.unit - Filter by exact unit of measure.
+     * @param {number} params.priceQuantity - Filter to the entries whose amount is the price of exactly this many units — `?price_quantity=100` is every line priced per hundred. Equality, not a range.
+     * @param {string} params.priceQuantityUnit - Filter by the exact unit the price quantity counts in. It is not the same column as `unit`: a line can be priced per 100 kg for an article sold by the piece.
+     * @param {number} params.discountPercent - Filter to the entries carrying exactly this stated line discount. The column is never applied to a price, so this audits what a source sent, not what a buyer pays.
+     * @param {string} params.description - Filter by the exact label the source gave the line. Exact match, not a search.
      * @param {string} params.validFrom - Exact equality on the start of the entry’s own validity — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.validUntil - Exact equality on the end of the entry’s own validity — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.createdAt - Exact equality on the creation instant — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} params.updatedAt - Exact equality on the last change — a bulk adjust only writes the rows whose price actually moved — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
+     * @param {string} params.externalId - Filter by the key the system that OWNS the price entry knows it by — how an import finds the row it wrote last run. Exact match; a price entry maintained here carries none and is never answered by it.
+     * @param {string} params.sourceSyncedAt - Filter to the price entrys last confirmed against their source at exactly this instant. A filter is an equality, so bounding a period means sorting with `order` and paging.
      * @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 by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
@@ -582,10 +743,16 @@ declare class Prices {
         quantityMin?: number;
         unitPrice?: number;
         unit?: string;
+        priceQuantity?: number;
+        priceQuantityUnit?: string;
+        discountPercent?: number;
+        description?: string;
         validFrom?: string;
         validUntil?: string;
         createdAt?: string;
         updatedAt?: string;
+        externalId?: string;
+        sourceSyncedAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
@@ -603,10 +770,16 @@ declare class Prices {
      * @param {number} quantityMin - Filter to one exact tier threshold — `?quantity_min=1` is the base rung of every ladder in the list.
      * @param {number} unitPrice - Filter to entries at one exact amount, in the list’s currency and on its tax basis. Equality, not a range — `?unit_price=0` finds the rows nobody has priced yet.
      * @param {string} unit - Filter by exact unit of measure.
+     * @param {number} priceQuantity - Filter to the entries whose amount is the price of exactly this many units — `?price_quantity=100` is every line priced per hundred. Equality, not a range.
+     * @param {string} priceQuantityUnit - Filter by the exact unit the price quantity counts in. It is not the same column as `unit`: a line can be priced per 100 kg for an article sold by the piece.
+     * @param {number} discountPercent - Filter to the entries carrying exactly this stated line discount. The column is never applied to a price, so this audits what a source sent, not what a buyer pays.
+     * @param {string} description - Filter by the exact label the source gave the line. Exact match, not a search.
      * @param {string} validFrom - Exact equality on the start of the entry’s own validity — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} validUntil - Exact equality on the end of the entry’s own validity — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} createdAt - Exact equality on the creation instant — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
      * @param {string} updatedAt - Exact equality on the last change — a bulk adjust only writes the rows whose price actually moved — matched to the stored microsecond, not a range. This app publishes no from/until query; narrow a period client-side, or by `order` plus `limit`.
+     * @param {string} externalId - Filter by the key the system that OWNS the price entry knows it by — how an import finds the row it wrote last run. Exact match; a price entry maintained here carries none and is never answered by it.
+     * @param {string} sourceSyncedAt - Filter to the price entrys last confirmed against their source at exactly this instant. A filter is an equality, so bounding a period means sorting with `order` and paging.
      * @param {number} limit - Page size (default 50, max 200).
      * @param {number} offset - Row offset for pagination (default 0).
      * @param {string} order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
@@ -614,18 +787,22 @@ declare class Prices {
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesList(listId: string, id?: string, productId?: string, sku?: string, priceType?: PriceEntryType, quantityMin?: number, unitPrice?: number, unit?: string, validFrom?: string, validUntil?: string, createdAt?: string, updatedAt?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    pricesEntriesList(listId: string, id?: string, productId?: string, sku?: string, priceType?: PriceEntryType, quantityMin?: number, unitPrice?: number, unit?: string, priceQuantity?: number, priceQuantityUnit?: string, discountPercent?: number, description?: string, validFrom?: string, validUntil?: string, createdAt?: string, updatedAt?: string, externalId?: string, sourceSyncedAt?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
     /**
      * Adds ONE rung to one item's quantity ladder in this list. The only thing an entry must have is an identity — `product_id` or `sku`, which the row CHECK enforces; everything else defaults, and one of those defaults deserves a warning.
      *
      * `unit_price` defaults to **0**. That is the one door through which a zero price enters an app whose whole doctrine is that a missing price is `on_request` and never €0: a create that forgets the amount publishes a free item, and the storefront shows 0.00 instead of "price on request". Send the amount, or send `price_type: "on_request"` where there genuinely is none. The amount is per ONE unit of `unit`, in the LIST's currency (entries carry none) and on the LIST's tax basis, as a decimal in major units — 19.90, never 1990.
      *
-     * Nothing enforces one rung per (item, quantity): create the same `quantity_min` twice and both rows come back in the resolved `tiers`, with the last of them setting the price — an ambiguous ladder no error ever mentions. `quantity_min` defaults to 1 and `price_type` to `standard`.
+     * Nothing enforces one rung per (item, quantity) on this route: create the same `quantity_min` twice and both rows come back in the resolved `tiers`, with the last of them setting the price — an ambiguous ladder no error ever mentions (a replace or an import refuses such a payload as `duplicate_tier`). `quantity_min` defaults to 1 and `price_type` to `standard`.
      *
      * This route is for a rung at a time. A whole ladder in one call is `POST …/entries/ladder`, an import is `POST …/entries/bulk`, and a complete rewrite of the book is `PUT …/entries`. An unknown `list_id` answers 404 rather than attaching a price to nothing.
      *
      * @param {string} params.listId - The price list the entries belong to. An id no list in this tenant has answers 404 rather than an empty page.
+     * @param {string} params.description - The source’s own label for this price line — what a price book prints next to the amount. Free text, never read into a price, and not the LIST’s description.
+     * @param {number} params.discountPercent - The line discount the SOURCE stated, kept so a document can show it. NEVER APPLIED: unit_price is the authoritative amount and resolution never computes with this field. Import it as it arrived and subtract nothing.
      * @param {object} params.metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours.
+     * @param {number} params.priceQuantity - How many units unit_price is the price OF — 100 for a price per 100 m. Omit (null) for one, the ordinary case. Nothing divides by it: unit_price stays the number a resolve answer quotes.
+     * @param {string} params.priceQuantityUnit - The unit price_quantity counts in — NOT a duplicate of `unit`. A line can be priced per 100 kg for an article sold by the piece, and both come off the same source line.
      * @param {PriceEntryType} params.priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it STOPS resolution for this item on this list and answers "price on request" even where a cheaper list exists.
      * @param {string} params.productId - The product this rung prices. An entry needs product_id or sku — the row CHECK enforces it.
      * @param {number} params.quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity upwards (default 1). The rungs of one item are the entries sharing its identity; the highest threshold at or below the requested quantity wins.
@@ -639,7 +816,11 @@ declare class Prices {
      */
     pricesEntriesCreate(params: {
         listId: string;
+        description?: string;
+        discountPercent?: number;
         metadata?: object;
+        priceQuantity?: number;
+        priceQuantityUnit?: string;
         priceType?: PriceEntryType;
         productId?: string;
         quantityMin?: number;
@@ -654,12 +835,16 @@ declare class Prices {
      *
      * `unit_price` defaults to **0**. That is the one door through which a zero price enters an app whose whole doctrine is that a missing price is `on_request` and never €0: a create that forgets the amount publishes a free item, and the storefront shows 0.00 instead of "price on request". Send the amount, or send `price_type: "on_request"` where there genuinely is none. The amount is per ONE unit of `unit`, in the LIST's currency (entries carry none) and on the LIST's tax basis, as a decimal in major units — 19.90, never 1990.
      *
-     * Nothing enforces one rung per (item, quantity): create the same `quantity_min` twice and both rows come back in the resolved `tiers`, with the last of them setting the price — an ambiguous ladder no error ever mentions. `quantity_min` defaults to 1 and `price_type` to `standard`.
+     * Nothing enforces one rung per (item, quantity) on this route: create the same `quantity_min` twice and both rows come back in the resolved `tiers`, with the last of them setting the price — an ambiguous ladder no error ever mentions (a replace or an import refuses such a payload as `duplicate_tier`). `quantity_min` defaults to 1 and `price_type` to `standard`.
      *
      * This route is for a rung at a time. A whole ladder in one call is `POST …/entries/ladder`, an import is `POST …/entries/bulk`, and a complete rewrite of the book is `PUT …/entries`. An unknown `list_id` answers 404 rather than attaching a price to nothing.
      *
      * @param {string} listId - The price list the entries belong to. An id no list in this tenant has answers 404 rather than an empty page.
+     * @param {string} description - The source’s own label for this price line — what a price book prints next to the amount. Free text, never read into a price, and not the LIST’s description.
+     * @param {number} discountPercent - The line discount the SOURCE stated, kept so a document can show it. NEVER APPLIED: unit_price is the authoritative amount and resolution never computes with this field. Import it as it arrived and subtract nothing.
      * @param {object} metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours.
+     * @param {number} priceQuantity - How many units unit_price is the price OF — 100 for a price per 100 m. Omit (null) for one, the ordinary case. Nothing divides by it: unit_price stays the number a resolve answer quotes.
+     * @param {string} priceQuantityUnit - The unit price_quantity counts in — NOT a duplicate of `unit`. A line can be priced per 100 kg for an article sold by the piece, and both come off the same source line.
      * @param {PriceEntryType} priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it STOPS resolution for this item on this list and answers "price on request" even where a cheaper list exists.
      * @param {string} productId - The product this rung prices. An entry needs product_id or sku — the row CHECK enforces it.
      * @param {number} quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity upwards (default 1). The rungs of one item are the entries sharing its identity; the highest threshold at or below the requested quantity wins.
@@ -672,11 +857,11 @@ declare class Prices {
      * @returns {Promise<Models.PriceEntry>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesCreate(listId: string, metadata?: object, priceType?: PriceEntryType, productId?: string, quantityMin?: number, sku?: string, unit?: string, unitPrice?: number, validFrom?: string, validUntil?: string): Promise<Models.PriceEntry>;
+    pricesEntriesCreate(listId: string, description?: string, discountPercent?: number, metadata?: object, priceQuantity?: number, priceQuantityUnit?: string, priceType?: PriceEntryType, productId?: string, quantityMin?: number, sku?: string, unit?: string, unitPrice?: number, validFrom?: string, validUntil?: string): Promise<Models.PriceEntry>;
     /**
      * Set semantics over the WHOLE list, not over one item: every entry of the list is deleted and the payload becomes the complete new book. It exists for the two callers that genuinely hold the whole book in hand — the Cockpit's table editor, whose save is this call, and a small import. `entries: []` is a legal payload and empties the list — the items it priced then resolve from the next candidate list, or come back `on_request`.
      *
-     * Two consequences of "delete, then insert". Every row is inserted fresh, so all entry ids change and anything holding one is stale afterwards. And it is not a transaction: the deletes go out before the inserts, so a payload that fails part-way through leaves the list holding the rows that landed and none of the ones it had. What protects you is that the whole payload is normalized and validated BEFORE the first delete — a malformed row is a 400 with the list untouched.
+     * Two consequences of "insert, then delete". Every row is inserted fresh, so all entry ids change and anything holding one is stale afterwards. And it is not a transaction: the new rows go out in bulk first and the old ones are removed after, so a write the store refuses leaves the list as it was, and a failure between the two leaves both sets — repeat the call. The whole payload is normalized and validated BEFORE the first write — a malformed row is a 400 with the list untouched.
      *
      * For a book of any size, or for adding to one you want to keep, use `POST …/entries/bulk`: it upserts in chunks and never wipes.
      *
@@ -692,7 +877,7 @@ declare class Prices {
     /**
      * Set semantics over the WHOLE list, not over one item: every entry of the list is deleted and the payload becomes the complete new book. It exists for the two callers that genuinely hold the whole book in hand — the Cockpit's table editor, whose save is this call, and a small import. `entries: []` is a legal payload and empties the list — the items it priced then resolve from the next candidate list, or come back `on_request`.
      *
-     * Two consequences of "delete, then insert". Every row is inserted fresh, so all entry ids change and anything holding one is stale afterwards. And it is not a transaction: the deletes go out before the inserts, so a payload that fails part-way through leaves the list holding the rows that landed and none of the ones it had. What protects you is that the whole payload is normalized and validated BEFORE the first delete — a malformed row is a 400 with the list untouched.
+     * Two consequences of "insert, then delete". Every row is inserted fresh, so all entry ids change and anything holding one is stale afterwards. And it is not a transaction: the new rows go out in bulk first and the old ones are removed after, so a write the store refuses leaves the list as it was, and a failure between the two leaves both sets — repeat the call. The whole payload is normalized and validated BEFORE the first write — a malformed row is a 400 with the list untouched.
      *
      * For a book of any size, or for adding to one you want to keep, use `POST …/entries/bulk`: it upserts in chunks and never wipes.
      *
@@ -874,7 +1059,11 @@ declare class Prices {
      *
      * @param {string} params.listId - The price list the entries belong to. An id no list in this tenant has answers 404 rather than an empty page.
      * @param {string} params.id - The price entry, by id. An entry that belongs to a different list answers 404.
+     * @param {string} params.description - The source’s own label for this price line — what a price book prints next to the amount. Free text, never read into a price, and not the LIST’s description.
+     * @param {number} params.discountPercent - The line discount the SOURCE stated, kept so a document can show it. NEVER APPLIED: unit_price is the authoritative amount and resolution never computes with this field. Import it as it arrived and subtract nothing.
      * @param {object} params.metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours.
+     * @param {number} params.priceQuantity - How many units unit_price is the price OF — 100 for a price per 100 m. Omit (null) for one, the ordinary case. Nothing divides by it: unit_price stays the number a resolve answer quotes.
+     * @param {string} params.priceQuantityUnit - The unit price_quantity counts in — NOT a duplicate of `unit`. A line can be priced per 100 kg for an article sold by the piece, and both come off the same source line.
      * @param {PriceEntryType} params.priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it STOPS resolution for this item on this list and answers "price on request" even where a cheaper list exists.
      * @param {string} params.productId - The product this rung prices. An entry needs product_id or sku — the row CHECK enforces it.
      * @param {number} params.quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity upwards (default 1). The rungs of one item are the entries sharing its identity; the highest threshold at or below the requested quantity wins.
@@ -889,7 +1078,11 @@ declare class Prices {
     pricesEntriesUpdate(params: {
         listId: string;
         id: string;
+        description?: string;
+        discountPercent?: number;
         metadata?: object;
+        priceQuantity?: number;
+        priceQuantityUnit?: string;
         priceType?: PriceEntryType;
         productId?: string;
         quantityMin?: number;
@@ -908,7 +1101,11 @@ declare class Prices {
      *
      * @param {string} listId - The price list the entries belong to. An id no list in this tenant has answers 404 rather than an empty page.
      * @param {string} id - The price entry, by id. An entry that belongs to a different list answers 404.
+     * @param {string} description - The source’s own label for this price line — what a price book prints next to the amount. Free text, never read into a price, and not the LIST’s description.
+     * @param {number} discountPercent - The line discount the SOURCE stated, kept so a document can show it. NEVER APPLIED: unit_price is the authoritative amount and resolution never computes with this field. Import it as it arrived and subtract nothing.
      * @param {object} metadata - Free-form bag: whatever JSON object you write round-trips exactly, and this app never reads it. Its keys are yours.
+     * @param {number} priceQuantity - How many units unit_price is the price OF — 100 for a price per 100 m. Omit (null) for one, the ordinary case. Nothing divides by it: unit_price stays the number a resolve answer quotes.
+     * @param {string} priceQuantityUnit - The unit price_quantity counts in — NOT a duplicate of `unit`. A line can be priced per 100 kg for an article sold by the piece, and both come off the same source line.
      * @param {PriceEntryType} priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it STOPS resolution for this item on this list and answers "price on request" even where a cheaper list exists.
      * @param {string} productId - The product this rung prices. An entry needs product_id or sku — the row CHECK enforces it.
      * @param {number} quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity upwards (default 1). The rungs of one item are the entries sharing its identity; the highest threshold at or below the requested quantity wins.
@@ -921,7 +1118,7 @@ declare class Prices {
      * @returns {Promise<Models.PriceEntry>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesUpdate(listId: string, id: string, metadata?: object, priceType?: PriceEntryType, productId?: string, quantityMin?: number, sku?: string, unit?: string, unitPrice?: number, validFrom?: string, validUntil?: string): Promise<Models.PriceEntry>;
+    pricesEntriesUpdate(listId: string, id: string, description?: string, discountPercent?: number, metadata?: object, priceQuantity?: number, priceQuantityUnit?: string, priceType?: PriceEntryType, productId?: string, quantityMin?: number, sku?: string, unit?: string, unitPrice?: number, validFrom?: string, validUntil?: string): Promise<Models.PriceEntry>;
     /**
      * Promotes this list AND demotes whoever held the flag, in one call. The flag is a single answer, not a per-row opinion: resolution uses it as the last tie-break, so two defaults leave the winner to row order and none leaves a tie unsettled. Promote-then-demote as two PATCHes from a client produces exactly those two states whenever the second call does not land.
      *
@@ -954,7 +1151,7 @@ declare class Prices {
      * Which price wins when several match is the whole value of this app, and it is not guessable from the field types. The order, in full:
      *
      * 1. **Candidates.** A list is a candidate when it is `active`, its currency EQUALS the currency of the call (nothing is ever converted — a list in another currency simply does not price the item), the instant `at` falls inside its validity window, it is visible in the buyer’s market (the `X-Revenexx-Market` header scopes the list view; lists assigned to no market are global and always visible), and its buyer scope matches or is open. A `requires_auth` list is dropped for a buyer with neither `contact_id` nor `organization_id`.
-     * 2. **Specificity decides first, and priority never overrules it.** contact-scoped (4) beats organization-scoped (3) beats channel-scoped (2) beats open (0). An organization list at `priority: 0` therefore wins over an open list at `priority: 100`.
+     * 2. **Specificity decides first, and priority never overrules it.** contact-scoped beats organization-scoped beats segment-scoped beats channel-scoped beats open. An organization list at `priority: 0` therefore wins over an open list at `priority: 100`.
      * 3. **Within one specificity level:** `priority` descending, then non-default before default — the default list is deliberately last, so it prices only what nothing else did.
      * 4. **A genuine tie** (same specificity, same priority, same default flag) is settled by the tenant’s `price_list_priority_tiebreak` setting — `lowest_price`, `highest_price`, `newest` or `code` — never by the order the database happened to return rows in. The setting in force is echoed in `basis.price_list_priority_tiebreak`.
      * 5. **The first list that prices the item wins, and the search stops there** — even if a later, less specific list is cheaper. Its FULL tier ladder comes back in `tiers`; the rung with the highest `quantity_min` at or below the requested `quantity` sets `unit_price`, and below the first rung the first rung applies.
@@ -963,6 +1160,8 @@ declare class Prices {
      *
      * Amounts: `unit_price` is per ONE unit of the entry’s `unit`, in `currency`, as a decimal in MAJOR units (19.90) — never minor units/cents — and on the basis `tax_basis` names. `tax_basis` comes from the list’s own column, else from a legacy `tax_included: true` on it, else from the tenant’s `tax_inclusive_default`; `tax_basis_source` says which of the three. Read `unit_price_net`/`unit_price_gross` where you need an unambiguous number.
      *
+     * Whose prices: a request acting for a contact (the gateway resolved the principal) is priced for THAT contact and its organization, taken from the platform. The body may restate them; a `contact_id` or `organization_id` naming anybody else is refused with 400 `buyer_mismatch`, and `segment_codes` with 400 `segments_not_accepted`, because the platform does not state segment membership yet. A call acting for no contact — the back office, another app — states its buyer context in the body. The market and the channel are the caller's to choose on either plane.
+     *
      * Tax is never guessed. The market comes from the `X-Revenexx-Market` header (a market CODE) or from `market_id` in the body; with several markets whose rates differ and no signal, the answer is `tax.resolved: false`, `reason: market_required` rather than another market’s VAT. `tax_rate: null` means UNKNOWN, not 0 %.
      *
      * An item that cannot be priced never fails the call: it comes back on_request with its reason, so one bad line in a cart does not cost the other lines their prices.
@@ -972,10 +1171,11 @@ declare class Prices {
      * @param {Models.PriceResolveItem[]} params.items - Items to price, at most 200 per call — a whole cart or a whole product listing in one round trip. The answer holds one entry per item, in this order.
      * @param {string} params.at - The instant every validity window — list and entry — is evaluated at (ISO 8601). Default now. This is how a promo price is previewed before it starts, and it is echoed as `basis.evaluated_at`.
      * @param {string} params.channelId - Buyer context: the sales channel. Third scope — beats the open lists, loses to contact and organization.
-     * @param {string} params.contactId - Buyer context: the contact this quote is for. The most specific scope — a list naming this contact beats every other list, whatever their priority. Sending it (or organization_id) is also what makes the buyer AUTHENTICATED for `requires_auth` lists and for the tenant’s anonymous_resolve_allowed setting.
+     * @param {string} params.contactId - Buyer context: the contact this quote is for. The most specific scope — a list naming this contact beats every other list, whatever their priority. Sending it (or organization_id) is also what makes the buyer AUTHENTICATED for `requires_auth` lists and for the tenant’s anonymous_resolve_allowed setting. On a buyer's own call it is the acting contact, taken from the platform: the body may restate it, and naming another one is refused with 400 `buyer_mismatch`.
      * @param {string} params.currency - ISO 4217 code the quote is wanted in. ONLY lists in this currency are candidates and nothing is ever converted, so a wrong value here is not a rounding difference — it is no price at all. Omit to take the buyer market’s currency, then the tenant’s default_currency; `basis.currency_source` names which applied.
      * @param {string} params.marketId - Buyer context: the market, as a uuid pin for older callers. Prefer the `X-Revenexx-Market` header, which carries a market CODE and is what scopes the visible price lists. The market decides the tax rates AND which per-market settings (rounding, tie-break, anonymous access) apply — with several markets and no signal at all the answer says `tax.resolved: false`, `reason: market_required` rather than quoting another market’s VAT.
-     * @param {string} params.organizationId - Buyer context: the organization the buyer belongs to. Second most specific scope; also counts as authenticated.
+     * @param {string} params.organizationId - Buyer context: the organization the buyer belongs to. Second most specific scope; also counts as authenticated. On a buyer's own call it is the acting contact's organization, taken from the platform: the body may restate it, and naming another one is refused with 400 `buyer_mismatch`.
+     * @param {string[]} params.segmentCodes - Buyer context: the buyer segments this buyer is in, by code. A list scoped to any of them is a candidate, and ranks BETWEEN organization and channel — a segment is a group of organizations, so it is less specific than one and more specific than a channel. Refused with 400 `segments_not_accepted` on a buyer's own call (one acting for a contact), because the platform does not state membership yet. Membership is not read here: a call that states no segment never matches a segment-scoped list. At most 50 codes, matched exactly; anything that is not a list of non-empty codes is refused with 400.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceResolveResponse>}
      */
@@ -987,6 +1187,7 @@ declare class Prices {
         currency?: string;
         marketId?: string;
         organizationId?: string;
+        segmentCodes?: string[];
     }): Promise<Models.PriceResolveResponse>;
     /**
      * The live price call. Everything else in this app configures prices; this is the one route that ANSWERS them, and a storefront reaches it on every listing, every product page and every cart. Send up to 200 items and the buyer context they are for — contact, organization, market and channel — and get back, per item, the unit price this buyer pays, the net/gross pair, the tax rate, the list that decided it and that item's full quantity ladder.
@@ -994,7 +1195,7 @@ declare class Prices {
      * Which price wins when several match is the whole value of this app, and it is not guessable from the field types. The order, in full:
      *
      * 1. **Candidates.** A list is a candidate when it is `active`, its currency EQUALS the currency of the call (nothing is ever converted — a list in another currency simply does not price the item), the instant `at` falls inside its validity window, it is visible in the buyer’s market (the `X-Revenexx-Market` header scopes the list view; lists assigned to no market are global and always visible), and its buyer scope matches or is open. A `requires_auth` list is dropped for a buyer with neither `contact_id` nor `organization_id`.
-     * 2. **Specificity decides first, and priority never overrules it.** contact-scoped (4) beats organization-scoped (3) beats channel-scoped (2) beats open (0). An organization list at `priority: 0` therefore wins over an open list at `priority: 100`.
+     * 2. **Specificity decides first, and priority never overrules it.** contact-scoped beats organization-scoped beats segment-scoped beats channel-scoped beats open. An organization list at `priority: 0` therefore wins over an open list at `priority: 100`.
      * 3. **Within one specificity level:** `priority` descending, then non-default before default — the default list is deliberately last, so it prices only what nothing else did.
      * 4. **A genuine tie** (same specificity, same priority, same default flag) is settled by the tenant’s `price_list_priority_tiebreak` setting — `lowest_price`, `highest_price`, `newest` or `code` — never by the order the database happened to return rows in. The setting in force is echoed in `basis.price_list_priority_tiebreak`.
      * 5. **The first list that prices the item wins, and the search stops there** — even if a later, less specific list is cheaper. Its FULL tier ladder comes back in `tiers`; the rung with the highest `quantity_min` at or below the requested `quantity` sets `unit_price`, and below the first rung the first rung applies.
@@ -1003,6 +1204,8 @@ declare class Prices {
      *
      * Amounts: `unit_price` is per ONE unit of the entry’s `unit`, in `currency`, as a decimal in MAJOR units (19.90) — never minor units/cents — and on the basis `tax_basis` names. `tax_basis` comes from the list’s own column, else from a legacy `tax_included: true` on it, else from the tenant’s `tax_inclusive_default`; `tax_basis_source` says which of the three. Read `unit_price_net`/`unit_price_gross` where you need an unambiguous number.
      *
+     * Whose prices: a request acting for a contact (the gateway resolved the principal) is priced for THAT contact and its organization, taken from the platform. The body may restate them; a `contact_id` or `organization_id` naming anybody else is refused with 400 `buyer_mismatch`, and `segment_codes` with 400 `segments_not_accepted`, because the platform does not state segment membership yet. A call acting for no contact — the back office, another app — states its buyer context in the body. The market and the channel are the caller's to choose on either plane.
+     *
      * Tax is never guessed. The market comes from the `X-Revenexx-Market` header (a market CODE) or from `market_id` in the body; with several markets whose rates differ and no signal, the answer is `tax.resolved: false`, `reason: market_required` rather than another market’s VAT. `tax_rate: null` means UNKNOWN, not 0 %.
      *
      * An item that cannot be priced never fails the call: it comes back on_request with its reason, so one bad line in a cart does not cost the other lines their prices.
@@ -1012,15 +1215,16 @@ declare class Prices {
      * @param {Models.PriceResolveItem[]} items - Items to price, at most 200 per call — a whole cart or a whole product listing in one round trip. The answer holds one entry per item, in this order.
      * @param {string} at - The instant every validity window — list and entry — is evaluated at (ISO 8601). Default now. This is how a promo price is previewed before it starts, and it is echoed as `basis.evaluated_at`.
      * @param {string} channelId - Buyer context: the sales channel. Third scope — beats the open lists, loses to contact and organization.
-     * @param {string} contactId - Buyer context: the contact this quote is for. The most specific scope — a list naming this contact beats every other list, whatever their priority. Sending it (or organization_id) is also what makes the buyer AUTHENTICATED for `requires_auth` lists and for the tenant’s anonymous_resolve_allowed setting.
+     * @param {string} contactId - Buyer context: the contact this quote is for. The most specific scope — a list naming this contact beats every other list, whatever their priority. Sending it (or organization_id) is also what makes the buyer AUTHENTICATED for `requires_auth` lists and for the tenant’s anonymous_resolve_allowed setting. On a buyer's own call it is the acting contact, taken from the platform: the body may restate it, and naming another one is refused with 400 `buyer_mismatch`.
      * @param {string} currency - ISO 4217 code the quote is wanted in. ONLY lists in this currency are candidates and nothing is ever converted, so a wrong value here is not a rounding difference — it is no price at all. Omit to take the buyer market’s currency, then the tenant’s default_currency; `basis.currency_source` names which applied.
      * @param {string} marketId - Buyer context: the market, as a uuid pin for older callers. Prefer the `X-Revenexx-Market` header, which carries a market CODE and is what scopes the visible price lists. The market decides the tax rates AND which per-market settings (rounding, tie-break, anonymous access) apply — with several markets and no signal at all the answer says `tax.resolved: false`, `reason: market_required` rather than quoting another market’s VAT.
-     * @param {string} organizationId - Buyer context: the organization the buyer belongs to. Second most specific scope; also counts as authenticated.
+     * @param {string} organizationId - Buyer context: the organization the buyer belongs to. Second most specific scope; also counts as authenticated. On a buyer's own call it is the acting contact's organization, taken from the platform: the body may restate it, and naming another one is refused with 400 `buyer_mismatch`.
+     * @param {string[]} segmentCodes - Buyer context: the buyer segments this buyer is in, by code. A list scoped to any of them is a candidate, and ranks BETWEEN organization and channel — a segment is a group of organizations, so it is less specific than one and more specific than a channel. Refused with 400 `segments_not_accepted` on a buyer's own call (one acting for a contact), because the platform does not state membership yet. Membership is not read here: a call that states no segment never matches a segment-scoped list. At most 50 codes, matched exactly; anything that is not a list of non-empty codes is refused with 400.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceResolveResponse>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesResolve(items: Models.PriceResolveItem[], at?: string, channelId?: string, contactId?: string, currency?: string, marketId?: string, organizationId?: string): Promise<Models.PriceResolveResponse>;
+    pricesResolve(items: Models.PriceResolveItem[], at?: string, channelId?: string, contactId?: string, currency?: string, marketId?: string, organizationId?: string, segmentCodes?: string[]): Promise<Models.PriceResolveResponse>;
     /**
      * Discovery for the vocabulary routes: the enums this app enforces, each with its name, its title and its description — and deliberately WITHOUT its values, so a UI can cache this one small answer and then fetch only the value sets it actually renders. Names: list-statuses, price-types, tax-bases. Fetch one with GET /prices/vocabularies/{name}; a client holding the qualified pair 'prices.<name>' builds that URL from the pair alone.
      *