@revenexx/sdk 0.0.4 → 0.0.5

package/types/services/prices.d.ts

@@ -1,5 +1,7 @@
 import { Client } from '../client';
 import type { Models } from '../models';
+import { PriceListStatus } from '../enums/price-list-status';
+import { PriceEntryType } from '../enums/price-entry-type';
 export declare class Prices {
     client: Client;
     constructor(client: Client);
@@ -11,10 +13,66 @@ export declare class Prices {
     pricesListsList(): Promise<{}>;
     /**
      *
+     * @param {string} params.code - Unique list code per tenant.
+     * @param {string} params.name -
+     * @param {string} params.channelId - Scope: only this channel.
+     * @param {string} params.contactId - Scope: only this contact — beats every other scope.
+     * @param {string} params.currency - ISO 4217 code (default EUR) — resolution only considers lists matching the requested currency.
+     * @param {string} params.description -
+     * @param {boolean} params.isDefault - Default lists resolve last within their group.
+     * @param {object} params.labels - Localised names ({de, en, …}).
+     * @param {string} params.marketId - Scope: only this market.
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {string} params.organizationId - Scope: only this organization.
+     * @param {number} params.priority - Tie-breaker within a specificity group (higher wins, default 0).
+     * @param {PriceListStatus} params.status - Default 'active' — only active lists resolve.
+     * @param {boolean} params.taxIncluded - Gross (true) or net (false, default) prices.
+     * @param {string} params.validFrom - Validity window start.
+     * @param {string} params.validUntil - Validity window end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceList>}
      */
-    pricesListsCreate(): Promise<Models.PriceList>;
+    pricesListsCreate(params: {
+        code: string;
+        name: string;
+        channelId?: string;
+        contactId?: string;
+        currency?: string;
+        description?: string;
+        isDefault?: boolean;
+        labels?: object;
+        marketId?: string;
+        metadata?: object;
+        organizationId?: string;
+        priority?: number;
+        status?: PriceListStatus;
+        taxIncluded?: boolean;
+        validFrom?: string;
+        validUntil?: string;
+    }): Promise<Models.PriceList>;
+    /**
+     *
+     * @param {string} code - Unique list code per tenant.
+     * @param {string} name -
+     * @param {string} channelId - Scope: only this channel.
+     * @param {string} contactId - Scope: only this contact — beats every other scope.
+     * @param {string} currency - ISO 4217 code (default EUR) — resolution only considers lists matching the requested currency.
+     * @param {string} description -
+     * @param {boolean} isDefault - Default lists resolve last within their group.
+     * @param {object} labels - Localised names ({de, en, …}).
+     * @param {string} marketId - Scope: only this market.
+     * @param {object} metadata - Free-form metadata.
+     * @param {string} organizationId - Scope: only this organization.
+     * @param {number} priority - Tie-breaker within a specificity group (higher wins, default 0).
+     * @param {PriceListStatus} status - Default 'active' — only active lists resolve.
+     * @param {boolean} taxIncluded - Gross (true) or net (false, default) prices.
+     * @param {string} validFrom - Validity window start.
+     * @param {string} validUntil - Validity window end.
+     * @throws {RevenexxException}
+     * @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, marketId?: string, metadata?: object, organizationId?: string, priority?: number, status?: PriceListStatus, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
     /**
      *
      * @throws {RevenexxException}
@@ -58,20 +116,68 @@ export declare class Prices {
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.channelId - Scope: only this channel.
+     * @param {string} params.code - Unique list code per tenant.
+     * @param {string} params.contactId - Scope: only this contact — beats every other scope.
+     * @param {string} params.currency - ISO 4217 code (default EUR) — resolution only considers lists matching the requested currency.
+     * @param {string} params.description -
+     * @param {boolean} params.isDefault - Default lists resolve last within their group.
+     * @param {object} params.labels - Localised names ({de, en, …}).
+     * @param {string} params.marketId - Scope: only this market.
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {string} params.name -
+     * @param {string} params.organizationId - Scope: only this organization.
+     * @param {number} params.priority - Tie-breaker within a specificity group (higher wins, default 0).
+     * @param {PriceListStatus} params.status - Default 'active' — only active lists resolve.
+     * @param {boolean} params.taxIncluded - Gross (true) or net (false, default) prices.
+     * @param {string} params.validFrom - Validity window start.
+     * @param {string} params.validUntil - Validity window end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceList>}
      */
     pricesListsUpdate(params: {
         id: string;
+        channelId?: string;
+        code?: string;
+        contactId?: string;
+        currency?: string;
+        description?: string;
+        isDefault?: boolean;
+        labels?: object;
+        marketId?: string;
+        metadata?: object;
+        name?: string;
+        organizationId?: string;
+        priority?: number;
+        status?: PriceListStatus;
+        taxIncluded?: boolean;
+        validFrom?: string;
+        validUntil?: string;
     }): Promise<Models.PriceList>;
     /**
      *
      * @param {string} id -
+     * @param {string} channelId - Scope: only this channel.
+     * @param {string} code - Unique list code per tenant.
+     * @param {string} contactId - Scope: only this contact — beats every other scope.
+     * @param {string} currency - ISO 4217 code (default EUR) — resolution only considers lists matching the requested currency.
+     * @param {string} description -
+     * @param {boolean} isDefault - Default lists resolve last within their group.
+     * @param {object} labels - Localised names ({de, en, …}).
+     * @param {string} marketId - Scope: only this market.
+     * @param {object} metadata - Free-form metadata.
+     * @param {string} name -
+     * @param {string} organizationId - Scope: only this organization.
+     * @param {number} priority - Tie-breaker within a specificity group (higher wins, default 0).
+     * @param {PriceListStatus} status - Default 'active' — only active lists resolve.
+     * @param {boolean} taxIncluded - Gross (true) or net (false, default) prices.
+     * @param {string} validFrom - Validity window start.
+     * @param {string} validUntil - Validity window end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesListsUpdate(id: string): Promise<Models.PriceList>;
+    pricesListsUpdate(id: string, channelId?: string, code?: string, contactId?: string, currency?: string, description?: string, isDefault?: boolean, labels?: object, marketId?: string, metadata?: object, name?: string, organizationId?: string, priority?: number, status?: PriceListStatus, taxIncluded?: boolean, validFrom?: string, validUntil?: string): Promise<Models.PriceList>;
     /**
      *
      * @param {string} params.listId -
@@ -92,37 +198,67 @@ export declare class Prices {
     /**
      *
      * @param {string} params.listId -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {PriceEntryType} params.priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it stops resolution and answers "price on request".
+     * @param {string} params.productId - Priced product.
+     * @param {number} params.quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity (default 1).
+     * @param {string} params.sku - Priced SKU (alternative to product_id).
+     * @param {string} params.unit -
+     * @param {number} params.unitPrice - Per-unit price (default 0).
+     * @param {string} params.validFrom - Per-entry validity start (promo prices).
+     * @param {string} params.validUntil - Per-entry validity end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceEntry>}
      */
     pricesEntriesCreate(params: {
         listId: string;
+        metadata?: object;
+        priceType?: PriceEntryType;
+        productId?: string;
+        quantityMin?: number;
+        sku?: string;
+        unit?: string;
+        unitPrice?: number;
+        validFrom?: string;
+        validUntil?: string;
     }): Promise<Models.PriceEntry>;
     /**
      *
      * @param {string} listId -
+     * @param {object} metadata - Free-form metadata.
+     * @param {PriceEntryType} priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it stops resolution and answers "price on request".
+     * @param {string} productId - Priced product.
+     * @param {number} quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity (default 1).
+     * @param {string} sku - Priced SKU (alternative to product_id).
+     * @param {string} unit -
+     * @param {number} unitPrice - Per-unit price (default 0).
+     * @param {string} validFrom - Per-entry validity start (promo prices).
+     * @param {string} validUntil - Per-entry validity end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceEntry>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesCreate(listId: string): Promise<Models.PriceEntry>;
+    pricesEntriesCreate(listId: string, metadata?: object, priceType?: PriceEntryType, productId?: string, quantityMin?: number, sku?: string, unit?: string, unitPrice?: number, validFrom?: string, validUntil?: string): Promise<Models.PriceEntry>;
     /**
      *
      * @param {string} params.listId -
+     * @param {Models.PriceEntryCreateRequest[]} params.entries - The complete new entry set (set semantics).
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
     pricesEntriesReplace(params: {
         listId: string;
+        entries: Models.PriceEntryCreateRequest[];
     }): Promise<{}>;
     /**
      *
      * @param {string} listId -
+     * @param {Models.PriceEntryCreateRequest[]} entries - The complete new entry set (set semantics).
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesReplace(listId: string): Promise<{}>;
+    pricesEntriesReplace(listId: string, entries: Models.PriceEntryCreateRequest[]): Promise<{}>;
     /**
      *
      * @param {string} params.listId -
@@ -167,26 +303,82 @@ export declare class Prices {
      *
      * @param {string} params.listId -
      * @param {string} params.id -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {PriceEntryType} params.priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it stops resolution and answers "price on request".
+     * @param {string} params.productId - Priced product.
+     * @param {number} params.quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity (default 1).
+     * @param {string} params.sku - Priced SKU (alternative to product_id).
+     * @param {string} params.unit -
+     * @param {number} params.unitPrice - Per-unit price (default 0).
+     * @param {string} params.validFrom - Per-entry validity start (promo prices).
+     * @param {string} params.validUntil - Per-entry validity end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceEntry>}
      */
     pricesEntriesUpdate(params: {
         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>;
     /**
      *
      * @param {string} listId -
      * @param {string} id -
+     * @param {object} metadata - Free-form metadata.
+     * @param {PriceEntryType} priceType - Default 'standard'; 'on_request' is the explicit no-price marker — it stops resolution and answers "price on request".
+     * @param {string} productId - Priced product.
+     * @param {number} quantityMin - Tier threshold (Staffelpreis): this price applies from this quantity (default 1).
+     * @param {string} sku - Priced SKU (alternative to product_id).
+     * @param {string} unit -
+     * @param {number} unitPrice - Per-unit price (default 0).
+     * @param {string} validFrom - Per-entry validity start (promo prices).
+     * @param {string} validUntil - Per-entry validity end.
      * @throws {RevenexxException}
      * @returns {Promise<Models.PriceEntry>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    pricesEntriesUpdate(listId: string, id: string): Promise<Models.PriceEntry>;
+    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>;
     /**
      *
+     * @param {Models.PriceResolveItem[]} params.items - Items to price (at most 200 per call).
+     * @param {string} params.at - Point in time for validity windows (ISO 8601 timestamp, default now).
+     * @param {string} params.channelId - Buyer context: channel.
+     * @param {string} params.contactId - Buyer context: contact — most specific scope.
+     * @param {string} params.currency - ISO 4217 code (default EUR) — only lists in this currency resolve.
+     * @param {string} params.marketId - Buyer context: market.
+     * @param {string} params.organizationId - Buyer context: organization.
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
-    pricesResolve(): Promise<{}>;
+    pricesResolve(params: {
+        items: Models.PriceResolveItem[];
+        at?: string;
+        channelId?: string;
+        contactId?: string;
+        currency?: string;
+        marketId?: string;
+        organizationId?: string;
+    }): Promise<{}>;
+    /**
+     *
+     * @param {Models.PriceResolveItem[]} items - Items to price (at most 200 per call).
+     * @param {string} at - Point in time for validity windows (ISO 8601 timestamp, default now).
+     * @param {string} channelId - Buyer context: channel.
+     * @param {string} contactId - Buyer context: contact — most specific scope.
+     * @param {string} currency - ISO 4217 code (default EUR) — only lists in this currency resolve.
+     * @param {string} marketId - Buyer context: market.
+     * @param {string} organizationId - Buyer context: organization.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     * @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<{}>;
 }