@viu/emporix-sdk 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, l as ResolvedConfig, E as EmporixConfig, h as LogLevel, m as ServiceName } from './context-CQFcPZnt.js';
-export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, D as DEFAULT_HOST, d as DefaultTokenProvider, H as HttpClient, e as HttpClientOptions, L as LEVEL, f as LevelResolver, g as LogFields, i as Logger, j as LoggerConfig, k as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, n as StorefrontCredentials, o as auth, p as createConsoleLogger, q as createNoopLogger, r as iterateAll, s as redact, t as resolveToken, v as validateConfig } from './context-CQFcPZnt.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, l as ResolvedConfig, E as EmporixConfig, h as LogLevel, m as ServiceName } from './context-hksRbb95.js';
+export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, D as DEFAULT_HOST, d as DefaultTokenProvider, H as HttpClient, e as HttpClientOptions, L as LEVEL, f as LevelResolver, g as LogFields, i as Logger, j as LoggerConfig, k as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, n as StorefrontCredentials, o as auth, p as createConsoleLogger, q as createNoopLogger, r as iterateAll, s as redact, t as resolveToken, v as validateConfig } from './context-hksRbb95.js';
 import { CustomerService } from './customer.js';
 export { Address, AddressCreateInput, AddressUpdateInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput } from './customer.js';
 import { ProductService } from './product.js';
@@ -67,7 +67,7 @@ declare function errorFromResponse(status: number, message: string, body: unknow
  * One site as returned by the Site Settings Service. Mirrors the public
  * SiteDto schema with the fields a storefront actually consumes.
  */
-interface Site {
+interface Site$1 {
     code: string;
     name: string;
     active: boolean;
@@ -102,14 +102,14 @@ declare class SiteService {
     private readonly ctx;
     constructor(ctx: ClientContext);
     /** Lists active sites. */
-    list(authCtx?: AuthContext): Promise<Site[]>;
+    list(authCtx?: AuthContext): Promise<Site$1[]>;
     /** Retrieves one site by code. */
-    get(code: string, authCtx?: AuthContext): Promise<Site>;
+    get(code: string, authCtx?: AuthContext): Promise<Site$1>;
     /**
      * Returns the tenant's default site (the one with `default: true`).
      * Throws if no default is configured — a tenant should always have one.
      */
-    current(authCtx?: AuthContext): Promise<Site>;
+    current(authCtx?: AuthContext): Promise<Site$1>;
 }
 
 /**
@@ -601,7 +601,7 @@ declare class SequentialIdService {
 type Localized$1 = string | {
     [key: string]: string;
 };
-type Fee$1 = {
+type Fee$2 = {
     /**
      * Unique identifier of the fee.
      */
@@ -620,7 +620,7 @@ type Fee$1 = {
      * The fee rate in percentage. Required if feeType is 'PERCENT'.
      */
     feePercentage?: number;
-    feeAbsolute?: MonetaryAmount;
+    feeAbsolute?: MonetaryAmount$1;
     /**
      * The itemtype the fee can belong to. It could be a product or
      * paymenttype.
@@ -648,7 +648,7 @@ type Fee$1 = {
 /**
  * Schema defining monetary amount in given currency.
  */
-type MonetaryAmount = {
+type MonetaryAmount$1 = {
     /**
      * The amount in the specified currency
      */
@@ -690,7 +690,7 @@ type ItemFee$1 = {
 type Yrn = string;
 
 /** A fee definition as returned by the API (`id`/`yrn` server-assigned). */
-type Fee = Fee$1;
+type Fee$1 = Fee$2;
 /** An item-fee (or product-fee) mapping as returned by the API. */
 type ItemFee = ItemFee$1;
 /**
@@ -698,7 +698,7 @@ type ItemFee = ItemFee$1;
  * server-assigned `id`/`yrn`. (The upstream spec reuses the `Fee` schema as the
  * request body; the SDK exposes this narrower draft type.)
  */
-type FeeDraft = Omit<Fee, "id" | "yrn">;
+type FeeDraft = Omit<Fee$1, "id" | "yrn">;
 /** Body for `POST /itemFees` — {@link ItemFee} minus the server `id`. */
 type ItemFeeDraft = Omit<ItemFee, "id">;
 /** Body of `POST /itemFees/search`. */
@@ -750,13 +750,13 @@ declare class FeeService {
      * returned page is full). Defaults match Emporix server defaults
      * (`pageNumber: 1`, `pageSize: 60`).
      */
-    list(query?: ListFeesQuery, auth?: AuthContext): Promise<PaginatedItems<Fee>>;
+    list(query?: ListFeesQuery, auth?: AuthContext): Promise<PaginatedItems<Fee$1>>;
     /** Retrieve one fee definition by id. */
-    get(id: string, auth?: AuthContext): Promise<Fee>;
+    get(id: string, auth?: AuthContext): Promise<Fee$1>;
     /** Create a fee definition. */
-    create(draft: FeeDraft, auth?: AuthContext): Promise<Fee>;
+    create(draft: FeeDraft, auth?: AuthContext): Promise<Fee$1>;
     /** Update a fee definition by id. */
-    update(id: string, draft: FeeDraft, auth?: AuthContext): Promise<Fee>;
+    update(id: string, draft: FeeDraft, auth?: AuthContext): Promise<Fee$1>;
     /** Delete a fee definition by id. */
     delete(id: string, auth?: AuthContext): Promise<void>;
     /** List all item-fee mappings. */
@@ -946,7 +946,7 @@ type WebhookEvent = {
  */
 type WebhookSubscription$1 = {
     event?: WebhookEvent;
-    metadata?: Metadata;
+    metadata?: Metadata$4;
     /**
      * Status of the subscription.
      */
@@ -981,7 +981,7 @@ type WebhookSubscriptionUpdateItem$1 = {
 /**
  * Auditing details.
  */
-type Metadata = {
+type Metadata$4 = {
     /**
      * Date and time when the document was created.
      */
@@ -1552,7 +1552,7 @@ type ExpandedTokenResponse = InnerTokenResponse & {
      * Name of the token.
      */
     name?: string;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 /**
  * The full response representing token. If the `expand=token` is **not** used, then only `id` field is returned, otherwise all fields are returned.
@@ -1723,7 +1723,7 @@ type SlackNativeToolResponse = BaseNativeTool & {
      */
     type?: unknown;
     config?: SlackNativeToolConfigResponse;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 type RagCustomNativeToolResponse = BaseNativeTool & {
     /**
@@ -1735,7 +1735,7 @@ type RagCustomNativeToolResponse = BaseNativeTool & {
      */
     type?: unknown;
     config?: RagCustomNativeToolConfigResponse;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 type RagEmporixNativeToolResponse = BaseNativeTool & {
     /**
@@ -1747,7 +1747,7 @@ type RagEmporixNativeToolResponse = BaseNativeTool & {
      */
     type?: unknown;
     config?: RagEmporixNativeToolConfigResponse;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 /**
  * List of native tools which agents should have access to.
@@ -1782,7 +1782,7 @@ type BaseMcpServer = {
 };
 type McpServerResponse = BaseMcpServer & {
     config?: McpServerConfigResponse;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 /**
  * Type of the MCP server. The `custom` type allows you to integrate with your own MCP server instance, while the `predefined` type allows you to integrate with one of the instances provided by Emporix.
@@ -2014,7 +2014,7 @@ type AgentResponse = BaseForAgentRequestAndResponse & {
      * Prompt which is inherited from the template (if agent is created based on the template). The prompt provided by the user is then concatenated with this prompt.
      */
     templatePrompt?: string;
-    metadata?: MetadataResponse;
+    metadata?: MetadataResponse$1;
 };
 type MetadataRequest = {
     /**
@@ -2022,7 +2022,7 @@ type MetadataRequest = {
      */
     version: number;
 };
-type MetadataResponse = MetadataRequest & {
+type MetadataResponse$1 = MetadataRequest & {
     /**
      * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
      */
@@ -2174,6 +2174,3074 @@ declare class AiService {
     chatAsync(input: ChatRequest, auth?: AuthContext): Promise<JobIdResponse[]>;
 }
 
+type Metadata$3 = {
+    /**
+     * Date and time when the object was created.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified.
+     */
+    modifiedAt?: string;
+    /**
+     * Version of the object.
+     */
+    version?: number;
+};
+/**
+ * Tax configuration for a specified location. It consists of a country code and a list of tax classes applicable in that country.
+ */
+type TaxCreation = {
+    location: Location;
+    /**
+     * List of tax classes applicable in the specified country.
+     */
+    taxClasses: Array<TaxClass>;
+};
+/**
+ * Tax configuration for a specified location. It consists of a country code and a list of tax classes applicable in that country.
+ */
+type TaxRetrieval = {
+    locationCode?: string;
+    location?: Location;
+    /**
+     * List of tax classes applicable in the specified country.
+     */
+    taxClasses?: Array<TaxClass>;
+    metadata?: Metadata$3;
+};
+/**
+ * Single tax class.
+ */
+type TaxClass = {
+    /**
+     * Unique tax class code.
+     */
+    code: string;
+    /**
+     * Tax class name.
+     *
+     * * If the `Content-Language` header is set to `*`, then the name should be provided as a map of translations, where each key is a language code and the value is the name in its respective language.
+     * * If the `Content-Language` header is set to a specific language, the name should be provided as a string.
+     * * If the `Content-Language` header is empty, the endpoint will asume that the name is provided in the default language defined in the Configuration Service.
+     *
+     * **Note**: You can provide the names only in languages defined in the Configuration Service. In case the name is provided in a language that is not defined in the Configuration Service, the request will be rejected.
+     */
+    name: {
+        [key: string]: string;
+    } | string;
+    /**
+     * Tax class description.
+     *
+     * * If the `Content-Language` header is set to `*`, then the description should be provided as a map of translations, where each key is a language code and the value is the description in its respective language.
+     * * If the `Content-Language` header is set to a specific language, the description should be provided as a string.
+     * * If the `Content-Language` header is empty, the endpoint will asume that the description is provided in the default language defined in the Configuration Service.
+     *
+     * **Note**: You can provide the descriptions only in languages defined in the Configuration Service. In case the description is provided in a language that is not defined in the Configuration Service, the request will be rejected.
+     */
+    description?: {
+        [key: string]: string;
+    } | string;
+    /**
+     * Number indicating the position on the tax class list. Tax classes in a configuration are sorted based on their `order` values in ascending order.
+     */
+    order?: number;
+    /**
+     * Tax rate, expressed as a number.
+     *
+     * For example, if the tax rate is 23%, this field should be set to `23`.
+     */
+    rate: number;
+    /**
+     * Indicates that the tax class is a default tax class for the tax configuration. Only one tax class can be marked as a default for a particular tax configuration.
+     */
+    isDefault?: boolean;
+};
+type TaxCreationResponse = {
+    /**
+     * Code of country for which the tax configuration has been created.
+     */
+    locationCode?: string;
+};
+type TaxCalculationRequest = {
+    /**
+     * Calculation command's unique identifier.
+     *
+     * **Note**: This field is optional. If not specified, the `commandUuid` will be generated by the server.
+     */
+    commandUuid?: string;
+    /**
+     * Information based on which the price will be calculated.
+     */
+    input: {
+        /**
+         * Country for which the provided price is originally defined.
+         *
+         * **Note**: This field is only mandatory if the `includesTax` field is set to `true`.
+         */
+        sourceLocation?: Location;
+        /**
+         * Tax class originally applied to the provided price.
+         *
+         * **Note**: This field is only mandatory if the `includesTax` field is set to `true`.
+         */
+        sourceTaxClass?: string;
+        /**
+         * Country for which the price should be calculated.
+         */
+        targetLocation: Location;
+        /**
+         * Tax class that should be applied when calculating the price.
+         */
+        targetTaxClass: string;
+        /**
+         * Flag indicating whether the value provided in the `price` field is expressed as net or gross.
+         *
+         * | Value | Description |
+         * | --- | --- |
+         * | `true` | Prices are expressed as gross values. |
+         * | `false` | Prices are expressed as net values. |
+         */
+        includesTax?: boolean;
+        /**
+         * Original price value.
+         *
+         * This field should contain by a number where the cent part is separated by a dot sign - such as `12.99`.
+         *
+         * **Note**: The cent part of the price is not limited to two digits. You can specify the price with any precision.
+         */
+        price: number;
+    };
+};
+type TaxCalculationResponse = {
+    /**
+     * Calculation command's unique identifier.
+     */
+    commandUuid?: string;
+    /**
+     * Information based on which the price was calculated.
+     */
+    input?: {
+        /**
+         * Country for which the provided price was originally defined.
+         */
+        sourceLocation?: Location;
+        /**
+         * Tax class originally applied to the provided price.
+         */
+        sourceTaxClass?: string;
+        /**
+         * Country for which the price was calculated.
+         */
+        targetLocation?: Location;
+        /**
+         * Tax class that was applied when calculating the price.
+         */
+        targetTaxClass?: string;
+        /**
+         * Flag indicating whether the price provided in the request was expressed as net or gross.
+         *
+         * | Value | Description |
+         * | --- | --- |
+         * | `true` | Prices will be expressed as gross values. |
+         * | `false` | Prices will be expressed as net values. |
+         */
+        includesTax?: boolean;
+        /**
+         * Original price value.
+         */
+        price?: number;
+    };
+    /**
+     * Calculation results.
+     */
+    output?: {
+        /**
+         * Calculated net price.
+         */
+        netPrice?: number;
+        /**
+         * Calculated gross price.
+         */
+        grossPrice?: number;
+        /**
+         * Tax rate originally applied to the provided price.
+         */
+        sourceTaxRate?: number;
+        /**
+         * Tax rate that was applied when calculating the price.
+         */
+        targetTaxRate?: number;
+    };
+};
+type Location = {
+    /**
+     * Code of the country for which the tax classes are specified, as defined in the Country Service.
+     */
+    countryCode: string;
+};
+type TaxUpdate = TaxCreation & {
+    metadata: Metadata$3;
+};
+
+/**
+ * Public types for the Tax Service — stable names re-exported over the
+ * generated `tax-service` types. The only refinements are narrowing the
+ * always-present read fields (`locationCode`, `taxClasses`) from the loosely
+ * optional generated shape; everything else aliases the generated types so the
+ * codegen stays the single source of truth.
+ */
+
+/** A country/location reference (`{ countryCode }`). */
+type TaxLocation = Location;
+/**
+ * A per-location tax configuration (read shape — `GET /taxes` /
+ * `/taxes/{locationCode}`). Built on the generated `TaxRetrieval`, with
+ * `locationCode` and `taxClasses` narrowed to required (a persisted
+ * configuration always carries both).
+ */
+type TaxConfig = Omit<TaxRetrieval, "locationCode" | "taxClasses"> & {
+    locationCode: string;
+    taxClasses: TaxClass[];
+};
+/** `POST /taxes` response — only the created `{ locationCode }`. */
+type TaxConfigCreated = Required<TaxCreationResponse>;
+/** Calculation command input (the `input` member of the request). */
+type TaxCalculationInput = TaxCalculationRequest["input"];
+/** Result of `calculateTax` — `output` carries `netPrice` / `grossPrice` / `*TaxRate`. */
+type TaxCalculationResult = TaxCalculationResponse;
+
+/**
+ * Emporix Tax Service (`/tax/{tenant}/…`): CRUD over per-location tax
+ * configurations and the net/gross tax-calculation command. Every endpoint
+ * requires a backend `tax.tax_read` / `tax.tax_manage` scope and the
+ * **service (clientCredentials) token** — default auth: service.
+ *
+ * Server-side use only; the service token must never reach a browser.
+ */
+declare class TaxService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List all per-location tax configurations. */
+    listTaxConfigs(auth?: AuthContext): Promise<TaxConfig[]>;
+    /** Retrieve one tax configuration by its location (country) code. */
+    getTaxConfig(locationCode: string, auth?: AuthContext): Promise<TaxConfig>;
+    /** Create a tax configuration (`POST`). Returns the created `{ locationCode }`. */
+    createTaxConfig(input: TaxCreation, auth?: AuthContext): Promise<TaxConfigCreated>;
+    /**
+     * Update a tax configuration by location code (`PUT`). `metadata.version` is
+     * required (optimistic locking — a stale version yields 409).
+     */
+    updateTaxConfig(locationCode: string, input: TaxUpdate, auth?: AuthContext): Promise<TaxConfig>;
+    /** Delete a tax configuration by location code. */
+    deleteTaxConfig(locationCode: string, auth?: AuthContext): Promise<void>;
+    /**
+     * Calculate net/gross values for a price (`PUT /taxes/calculation-commands`).
+     * Single command in, single result out.
+     */
+    calculateTax(request: TaxCalculationRequest, auth?: AuthContext): Promise<TaxCalculationResult>;
+}
+
+type Coupons = Array<CouponWithIdAndStatus>;
+/**
+ * Coupons describe voucher alike commerce capabilities, e.g. 10% off winter accessories.
+ */
+type BaseCoupon = {
+    /**
+     * Coupon name.
+     */
+    name?: string;
+    /**
+     * Coupon description.
+     */
+    description?: string;
+    /**
+     * 'PERCENT' for relative values, 'ABSOLUTE' for float values, referring to a specific currency, 'FREE_SHIPPING' for reducing the shipping cost to 0.
+     */
+    discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * A discount percentage within the range [0.00, 100.00]. Must be specified only if type is 'PERCENT'.
+     */
+    discountPercentage?: number;
+    /**
+     * Must be specified only if type is 'ABSOLUTE'. Defines the amount that should be substracted from the cart subtotal.
+     */
+    discountAbsolute?: {
+        /**
+         * Total amount in the specified currency.
+         */
+        amount?: number;
+        /**
+         * ISO 4217 currency code, e.g.: USD, EUR, CHF.
+         */
+        currency?: string;
+    };
+    /**
+     * Specifies if the coupon can be redeemed by anonymous user. If set to false, only logged-in customers can redeem it.
+     */
+    allowAnonymous?: boolean;
+    /**
+     * Maximum number of redemptions; -1  designates 'unlimited' (seller-only).
+     */
+    maxRedemptions?: number;
+    /**
+     * Maximum number of redemptions per customer; -1 designates 'unlimited'. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    maxRedemptionsPerCustomer?: number;
+    /**
+     * Determines whether the coupon is applied to the total or subtotal value of the order.
+     */
+    discountCalculationType?: 'TOTAL' | 'SUBTOTAL';
+    categoryRestricted?: CategoryRestricted;
+    segmentRestricted?: SegmentRestricted;
+    restrictions?: Restrictions$1;
+    /**
+     * The Id of the customer who originally received the coupon (seller-only).
+     */
+    issuedTo?: string;
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Version of the document. Set to 0 after creating a document. Increments by 1 after every update.
+         */
+        version?: number;
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: string;
+        };
+    };
+};
+type Coupon$2 = BaseCoupon & {
+    legalEntityRedemptions?: Array<{
+        /**
+         * The id of the legal entity to which customer is assigned.
+         */
+        legalEntityId?: string;
+        /**
+         * The number of times a specific coupon has been redeemed in the context of the given legal entity.
+         */
+        count?: number;
+    }>;
+    /**
+     * The number of times a specific coupon has been redeemed. Read-only, set through server. (seller-only).
+     */
+    redemptionCount?: number;
+    referralCoupon?: ReferralCouponProperty;
+    /**
+     * Flag to mark a coupon as deleted (a.k.a. Soft delete). It is a read-only and seller-only attribute.
+     */
+    deleted?: boolean;
+};
+/**
+ * Coupon creation schema.
+ */
+type CouponCreation = {
+    /**
+     * e.g.: WINTER-SALE, 10OFF. If not provided, a code will be auto generated.
+     */
+    code?: string;
+    /**
+     * Coupon name.
+     */
+    name: string;
+    /**
+     * Coupon description.
+     */
+    description?: string;
+    /**
+     * 'PERCENT' for relative values, 'ABSOLUTE' for float values, referring to a specific currency, 'FREE_SHIPPING' for reducing the shipping cost to 0.
+     */
+    discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * A discount percentage within the range [0.00, 100.00]. Must be specified only if type is 'PERCENT'.
+     */
+    discountPercentage?: number;
+    discountAbsolute?: CurrencyAmount & unknown;
+    /**
+     * Specifies if the coupon can be redeemed by anonymous user. If set to false, only logged-in customers can redeem it.
+     */
+    allowAnonymous?: boolean;
+    /**
+     * Maximum number of redemptions; -1 designates 'unlimited' (seller-only).
+     */
+    maxRedemptions?: number;
+    /**
+     * Maximum number of redemptions per customer; -1 designates 'unlimited'. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    maxRedemptionsPerCustomer?: number;
+    /**
+     * Determines whether the coupon is applied to the total or subtotal value of the order.
+     */
+    discountCalculationType?: 'TOTAL' | 'SUBTOTAL';
+    categoryRestricted?: CategoryRestricted;
+    segmentRestricted?: SegmentRestricted;
+    restrictions?: Restrictions$1;
+    /**
+     * The Id of the customer who originally received the coupon (seller-only).
+     */
+    issuedTo?: string;
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Version of the document. Set to 0 after creating a document. Increments by 1 after every update.
+         */
+        version?: number;
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: string;
+        };
+    };
+};
+/**
+ * Defines if the coupon has segment restrictions. If the value is set to `true`, the `restrictions.segments` must be provided.
+ * ***
+ * Info: Cannot be combined neither with the category restrictions nor with customers restrictions.
+ *
+ */
+type SegmentRestricted = boolean;
+/**
+ * Defines if the coupon has category restrictions.
+ * ***
+ * Info: Cannot be combined together with the segment restrictions.
+ *
+ */
+type CategoryRestricted = boolean;
+/**
+ * Defines an amount in a specific currency.
+ */
+type CurrencyAmount = {
+    /**
+     * Total amount in the specified currency.
+     */
+    amount?: number;
+    /**
+     * ISO 4217 currency code, e.g.: USD, EUR, CHF.
+     */
+    currency?: string;
+};
+/**
+ * Defines a coupon redemption response.
+ */
+type Redemption = RedemptionCreation & {
+    /**
+     * Unique identifier of the redemption.
+     */
+    id?: string;
+    /**
+     * Timestamp of the redemption.
+     */
+    redeemedAt?: string;
+};
+/**
+ * Defines a coupon redemption request payload that affects a coupon instance.
+ */
+type RedemptionCreation = {
+    /**
+     * Code of the associated order.
+     */
+    orderCode?: string;
+    /**
+     * The customer Id of the user, e.g. C0123456789. Can be specified only if coupon.coupon_redeem_on_behalf scope is present.
+     */
+    customerNumber?: string;
+    /**
+     * The id of the legal entity to which customer is assigned. When customer is assigned to many legal entities then he can redeem the same coupon separately for each legal entity.
+     */
+    legalEntityId?: string;
+    orderTotal: CurrencyAmount & unknown;
+    discount: CurrencyAmount & unknown;
+};
+/**
+ * Restrictions of the coupon.
+ */
+type Restrictions$1 = {
+    /**
+     * A list of customer identifiers for whom the coupon can be redeemed. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    validFor?: Array<string>;
+    /**
+     * Must be provided in ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'.
+     */
+    validFrom?: string;
+    /**
+     * Must be provided in ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'.
+     */
+    validUntil?: string;
+    minOrderValue?: CurrencyAmount;
+    /**
+     * The list of product's categories to which this coupon applies to. Must be defined only if the `categoryRestricted` flag is set to true. Must be disjoint with excludedCategories list.
+     */
+    includedCategories?: Array<string>;
+    /**
+     * The list of product's categories to which this coupon does not apply to. Can be defined only if the `categoryRestricted` flag is set to true. Must be disjoint with includedCategories list.
+     */
+    excludedCategories?: Array<string>;
+    /**
+     * The list of segments to which this coupon applies to. Can be defined only if the `segmentRestricted` flag is set to true.
+     */
+    segments?: Array<string>;
+};
+type ResourceLocation = {
+    /**
+     * Identifier of the link.
+     */
+    id?: string;
+    /**
+     * Identifier of the link in the system's notation.
+     */
+    yrn?: string;
+};
+type CouponWithIdAndStatus = Coupon$2 & {
+    /**
+     * e.g.: WINTER-SALE, 10OFF (read-only).
+     */
+    code?: string;
+    referralCoupon?: ReferralCouponProperty;
+    /**
+     * Current status of the coupon (read-only). 'INACTIVE': the coupon is only valid in the future; 'VALID': can be used; 'EXPIRED': the coupon validity period has expired; 'USED': the maximum number of redemptions for the coupon has been reached.
+     */
+    status?: 'VALID' | 'INACTIVE' | 'EXPIRED' | 'USED';
+};
+/**
+ * Coupons describe voucher alike commerce capabilities.
+ */
+type ReferralCoupon = {
+    /**
+     * e.g.: WINTER-SALE, 10OFF (read-only)
+     */
+    code?: string;
+    /**
+     * Coupon name.
+     */
+    name: string;
+    /**
+     * Coupon description.
+     */
+    description?: string;
+    /**
+     * `PERCENT` for relative values, `ABSOLUTE` for float values, referring to a specific currency, `FREE_SHIPPING` for reducing the shipping cost to 0.
+     *
+     */
+    discountType: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * A discount percentage within the range [0.00, 100.00]. Must be specified only if type is `PERCENT`.
+     */
+    discountPercentage?: number;
+    discountAbsolute?: CurrencyAmount;
+    /**
+     * Specifies if the coupon can be redeemed by anonymous users.
+     */
+    allowAnonymous?: boolean;
+    /**
+     * Maximum number of redemptions; -1 designates 'unlimited' (seller-only).
+     */
+    maxRedemptions?: number;
+    /**
+     * Maximum number of redemptions per customer; -1 designates 'unlimited'. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    maxRedemptionsPerCustomer?: number;
+    restrictions?: {
+        /**
+         * A list of customer identifiers for whom the coupon can be redeemed. Cannot be specified for coupons which can be redeemed by anonymous users.
+         */
+        validFor?: Array<string>;
+        /**
+         * Must be provided in ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'
+         */
+        validFrom?: string;
+        /**
+         * Must be provided in ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'
+         */
+        validUntil?: string;
+        minOrderValue?: CurrencyAmount;
+    };
+    /**
+     * The Id of the customer who originally received the coupon (seller-only).
+     */
+    issuedTo: string;
+    referralCoupon?: ReferralCouponProperty;
+    /**
+     * The number of times a specific coupon has been redeemed. Read-only, set through server (seller-only).
+     */
+    redemptionCount?: number;
+    /**
+     * Current status of the coupon (read-only). `INACTIVE`: the coupon is only valid in the future; `VALID`: can be used; `EXPIRED`: the coupon validity period has expired; `USED`: the maximum number of redemptions for the coupon has been reached.
+     */
+    status: 'INACTIVE' | 'VALID' | 'EXPIRED' | 'USED';
+    /**
+     * Flag to mark a coupon as deleted (a.k.a. Soft delete). It is a read-only and seller-only attribute
+     */
+    deleted?: boolean;
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Version of the document. Set to 0 after creating a document. Increments by 1 after every update.
+         */
+        version?: number;
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: string;
+        };
+    };
+};
+/**
+ * Indicates if the coupon is type of referral coupon. This property is read only.
+ */
+type ReferralCouponProperty = boolean;
+
+/**
+ * Public types for the Coupon Service — stable names aliased over the generated
+ * `coupon` types (single source of truth; faithful required/optional flags).
+ */
+
+/** A coupon (read shape — includes the read-only `code` and `status`). */
+type Coupon$1 = CouponWithIdAndStatus;
+/** Response of `listCoupons` — a plain array of coupons. */
+type CouponList = Coupons;
+/** Create body (`POST /coupons`). `name` is required; `code` is auto-generated when omitted. */
+type CouponInput = CouponCreation;
+/** Update / patch body (`PUT` / `PATCH /coupons/{code}`). */
+type CouponUpdate = BaseCoupon;
+/**
+ * Redemption request body (`validation` / `redemptions`). Requires `orderTotal`
+ * and `discount`; `customerNumber` is honored only with the
+ * `coupon.coupon_redeem_on_behalf` scope.
+ */
+type RedemptionInput = RedemptionCreation;
+/** `POST /redemptions` 201 response — the created redemption's `{ id?, yrn? }`. */
+type RedemptionCreated = ResourceLocation;
+/** `POST /coupons` 201 response — the created coupon's `{ id?, yrn? }`. */
+type CouponCreated = ResourceLocation;
+
+/**
+ * Emporix Coupon Service (`/coupon/{tenant}/…`): coupon CRUD, validation,
+ * redemptions, and referral coupons.
+ *
+ * Every method defaults to the **service (clientCredentials) token**. For
+ * customer-driven validation/redemption, pass `auth.customer(token)` as the
+ * trailing argument (the React hooks do this with the browser context). The
+ * service token must never reach a browser.
+ */
+declare class CouponService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List coupons by criteria. Returns a plain array. */
+    listCoupons(query?: Record<string, string | number>, auth?: AuthContext): Promise<CouponList>;
+    /** Retrieve one coupon by code. */
+    getCoupon(code: string, auth?: AuthContext): Promise<Coupon$1>;
+    /** Create a coupon (`POST`, HTTP 201). Returns the created resource's `{ id?, yrn? }`. */
+    createCoupon(input: CouponInput, auth?: AuthContext): Promise<CouponCreated>;
+    /** Replace a coupon by code (`PUT`). Resolves once the update is accepted. */
+    updateCoupon(code: string, input: CouponUpdate, auth?: AuthContext): Promise<void>;
+    /** Partially update a coupon by code (`PATCH` merge body). */
+    patchCoupon(code: string, patch: CouponUpdate, auth?: AuthContext): Promise<void>;
+    /** Delete a coupon by code. */
+    deleteCoupon(code: string, auth?: AuthContext): Promise<void>;
+    /**
+     * Check whether a coupon can be redeemed (`POST /validation`). Resolves when
+     * redeemable; throws an `EmporixError` otherwise (no response body).
+     */
+    validateCoupon(code: string, redemption: RedemptionInput, auth?: AuthContext): Promise<void>;
+    /** List a coupon's redemptions by criteria. */
+    listRedemptions(code: string, query?: Record<string, string | number>, auth?: AuthContext): Promise<Redemption[]>;
+    /** Redeem a coupon by creating a redemption (`POST`, HTTP 201). Returns the resource location. */
+    redeemCoupon(code: string, redemption: RedemptionInput, auth?: AuthContext): Promise<RedemptionCreated>;
+    /** Retrieve one redemption by id. */
+    getRedemption(code: string, id: string, auth?: AuthContext): Promise<Redemption>;
+    /** Delete a redemption by id. */
+    deleteRedemption(code: string, id: string, auth?: AuthContext): Promise<void>;
+    /** Retrieve a customer's referral coupon (resolves to an empty body when none exists). */
+    getReferralCoupon(customerNumber: string, auth?: AuthContext): Promise<ReferralCoupon>;
+    /** Create a referral coupon code for a customer (no request body). */
+    createReferralCoupon(customerNumber: string, auth?: AuthContext): Promise<ReferralCoupon>;
+}
+
+type CustomerSummaryBatchOut = Array<PointsSummaryOut>;
+type PointsSummaryOut = {
+    /**
+     * Id of the customer to whom the points are assigned
+     */
+    customerId?: string;
+    /**
+     * Active points that can be redeemed
+     */
+    activePoints?: number;
+    summary?: CustomerSummary;
+};
+type AddedPoints = {
+    id?: string;
+    /**
+     * Order Id for which the points were created
+     */
+    'reference-id'?: string | null;
+    /**
+     * Auto-generated description
+     */
+    description?: string;
+    /**
+     * Number of points added in the operation
+     */
+    points: number;
+    createdAt?: string;
+    /**
+     * The date until when the points can be redeemed
+     */
+    validUntil?: string;
+    /**
+     * Number of points after creation
+     */
+    allPointsAfterCreation?: number;
+    /**
+     * Number of points already used
+     */
+    usedPoints?: number;
+    usedWith?: Array<string>;
+};
+type RedeemedPoints = {
+    /**
+     * Identifier of the redeemed points
+     */
+    id?: string;
+    /**
+     * A comment for the redeem operation
+     */
+    description?: string;
+    /**
+     * The amount of the redeemed points
+     */
+    points: number;
+    /**
+     * Timestamp when the points were redeemed
+     */
+    createdAt?: string;
+    /**
+     * Number of points after creation
+     */
+    allPointsAfterCreation?: number;
+};
+type CustomerSummary = {
+    addedPointsList: Array<AddedPoints>;
+    redeemedPointsList?: Array<RedeemedPoints>;
+};
+type RedeemOptions = Array<RedeemOption>;
+type RedeemOption = {
+    /**
+     * ID of the redemption option to be used at reward points exchange
+     */
+    id?: string;
+    /**
+     * Option type, typically 'coupon'.
+     */
+    type: string;
+    /**
+     * Name of the redeem option that can be presented to customer
+     */
+    name: string;
+    /**
+     * Description of the redeem option that can be presented to customer
+     */
+    description?: string;
+    /**
+     * Points to deduct from customer's account at coupon creation
+     */
+    points: number;
+    coupon?: Coupon;
+    pointsAfterCoupon?: number;
+    metadata?: {
+        /**
+         * Version of the redeem option
+         */
+        version?: number;
+        /**
+         * Timestamp when the redeem option has been created.
+         */
+        createdAt?: string;
+        /**
+         * Timestamp when the redeem option has been modified.
+         */
+        modifiedAt?: string;
+    };
+};
+type RedeemCouponOut = {
+    /**
+     * Coupon code received after exchanging points
+     */
+    code?: string;
+};
+/**
+ * Coupons describe voucher-like commerce capabilities.
+ */
+type Coupon = {
+    /**
+     * Coupon code, for example: WINTER-SALE, 10OFF (read-only)
+     */
+    code?: string;
+    /**
+     * Localized coupon name
+     */
+    name: string;
+    /**
+     * Localized coupon description
+     */
+    description?: string;
+    /**
+     * 'PERCENT' for relative values, 'ABSOLUTE' for float values referring to a specific currency, 'FREE_SHIPPING' for reducing the shipping cost to 0.
+     */
+    discountType: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * Discount percentage within a range [0.00, 100.00]. Must be specified only if type is 'PERCENT'.
+     */
+    discountPercentage?: number;
+    /**
+     * Must be specified only if type is 'ABSOLUTE'
+     */
+    discountAbsolute?: {
+        /**
+         * Total amount in the specified currency.
+         */
+        amount?: number;
+        /**
+         * ISO 4217 currency code, e.g.: USD, EUR, CHF
+         */
+        currency?: string;
+    };
+    /**
+     * Defines if the coupon can be redeemed by anonymous users
+     */
+    allowAnonymous?: boolean;
+    /**
+     * Maximum number of redemptions; -1 designates 'unlimited' (seller-only)
+     */
+    maxRedemptions?: number;
+    /**
+     * Maximum number of redemptions per customer; -1 designates 'unlimited'. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    maxRedemptionsPerCustomer?: number;
+    restrictions?: Restrictions;
+    /**
+     * Id of the customer who originally received the coupon (seller-only).
+     */
+    issuedTo?: string;
+    /**
+     * The number of times a specific coupon has been redeemed. Read-only, set through server. (seller-only)
+     */
+    redemptionCount?: number;
+    /**
+     * Current status of the coupon (read-only). 'INACTIVE': the coupon is only valid in the future; 'VALID': can be used; 'EXPIRED': the coupon validity period has expired; 'USED': the maximum number of redemptions for the coupon has been reached.
+     */
+    status?: 'INACTIVE' | 'VALID' | 'EXPIRED' | 'USED';
+    /**
+     * Hypermedia reference to coupon actions (read-only, customer-only)
+     */
+    links?: Array<{
+        /**
+         * Link relation type
+         */
+        rel: string;
+        /**
+         * Link title
+         */
+        title: string;
+        /**
+         * Target URI of the link
+         */
+        href: string;
+        /**
+         * Content type of the referenced resource
+         */
+        type: string;
+    }>;
+    /**
+     * Flag to mark a coupon as deleted (a.k.a. Soft delete). It is a read-only and seller-only attribute
+     */
+    deleted?: boolean;
+};
+type NewCustomerIn = {
+    customerId?: string;
+    startPoints?: AddedPoints;
+};
+type Restrictions = {
+    /**
+     * A list of identifiers of customers that can redeem the coupon. Cannot be specified for coupons which can be redeemed by anonymous users.
+     */
+    validFor?: Array<string>;
+    /**
+     * Must be provided in the ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'
+     */
+    validFrom?: string;
+    /**
+     * Must be provided in the ISO 8601 format (http://www.iso.org/iso/home/standards/iso8601.htm), e.g. '2015-01-31T23:59:59.999Z'
+     */
+    validUntil?: string;
+    /**
+     * Minimum order value which entitles the customer to redeem the coupon
+     */
+    minOrderValue?: {
+        /**
+         * Total amount in the specified currency
+         */
+        amount?: number;
+        /**
+         * ISO 4217 currency code, e.g.: USD, EUR, CHF
+         */
+        currency?: string;
+    };
+};
+
+/**
+ * Public types for the Reward Points Service — stable names aliased over the
+ * generated `reward-points` types (single source of truth). Structural only for
+ * the inlined public-redeem body.
+ *
+ * Note: point *balances* (`getCustomerPoints` / `getMyPoints`) are returned as a
+ * bare `number` by the upstream API, so they have no dedicated type here.
+ */
+
+/** Batch summary across all customers (`GET /summaryBatch`) — an array of summaries. */
+type CustomerSummaryBatch = CustomerSummaryBatchOut;
+/** Points summary for one customer / the signed-in customer. */
+type PointsSummary = PointsSummaryOut;
+/** Create-entry body (`POST /customer/{id}`). */
+type NewPointsEntry = NewCustomerIn;
+/** List of redeem options (`GET`/`POST /{tenant}/redeemOptions`). */
+type RedeemOptionList = RedeemOptions;
+/** Result of redeeming points — the issued coupon `{ code? }`. */
+type RedeemCouponResult = RedeemCouponOut;
+/** Body for `redeemMyPoints` — inlined upstream, so defined structurally. */
+interface RedeemMyPointsInput {
+    redeemOptionId: string;
+}
+
+/**
+ * Emporix Reward Points Service (`/reward-points/…`): admin customer-points
+ * management, the signed-in customer's own points, and redeem options.
+ *
+ * Auth differs per group: admin and redeem-option management default to the
+ * **service token**; the `/public/*` methods require a **customer token** (they
+ * accept only `CustomerAccessToken`). Note the mixed base paths — customer/
+ * public/batch endpoints omit `{tenant}`, redeem options include it. A point
+ * balance (`getCustomerPoints` / `getMyPoints`) is returned as a bare `number`.
+ */
+declare class RewardPointsService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Base without tenant (customer / public / batch endpoints). */
+    private base;
+    /** Tenant-scoped base (redeem options only). */
+    private tenantBase;
+    /** Batch summary across all customers. */
+    listAllSummaries(query?: Record<string, string | number>, auth?: AuthContext): Promise<CustomerSummaryBatch>;
+    /** Retrieve one customer's reward-points balance. */
+    getCustomerPoints(customerId: string, auth?: AuthContext): Promise<number>;
+    /** Create a reward-points entry for a customer. */
+    createCustomerPoints(customerId: string, input: NewPointsEntry, auth?: AuthContext): Promise<void>;
+    /** Delete a customer's reward points. */
+    deleteCustomerPoints(customerId: string, auth?: AuthContext): Promise<void>;
+    /** Retrieve a reward-points summary for one customer. */
+    getCustomerSummary(customerId: string, auth?: AuthContext): Promise<PointsSummary>;
+    /** Add reward points for a customer. */
+    addPoints(customerId: string, input: AddedPoints, auth?: AuthContext): Promise<void>;
+    /** Redeem a customer's reward points (on behalf). */
+    redeemPoints(customerId: string, input: RedeemedPoints, auth?: AuthContext): Promise<void>;
+    /** The signed-in customer's reward-points balance. Requires a customer `auth`. */
+    getMyPoints(auth: AuthContext): Promise<number>;
+    /** The signed-in customer's reward-points summary. Requires a customer `auth`. */
+    getMySummary(auth: AuthContext): Promise<PointsSummary>;
+    /**
+     * Redeem the signed-in customer's points for a coupon code. Requires a
+     * customer `auth`. Returns the issued coupon `{ code }`.
+     */
+    redeemMyPoints(input: RedeemMyPointsInput, auth: AuthContext): Promise<RedeemCouponResult>;
+    /** List redeem options. Defaults to the service token; pass a customer `auth` for storefront reads. */
+    listRedeemOptions(auth?: AuthContext): Promise<RedeemOptionList>;
+    /** Create a redeem option. Returns the updated options list. */
+    createRedeemOption(input: RedeemOption, auth?: AuthContext): Promise<RedeemOptionList>;
+    /** Update a redeem option by id. Resolves once accepted (no response body). */
+    updateRedeemOption(redeemOptionId: string, input: RedeemOption, auth?: AuthContext): Promise<void>;
+    /** Delete a redeem option by id. */
+    deleteRedeemOption(redeemOptionId: string, auth?: AuthContext): Promise<void>;
+}
+
+type Brands = Array<BrandResponse>;
+type Brand$1 = {
+    /**
+     * Unique identifier of a brand.
+     */
+    id?: string;
+    /**
+     * Brand name.
+     */
+    name?: string;
+    /**
+     * Brand description.
+     */
+    description?: string;
+    /**
+     * Map of key-value pairs containing localized names of the brand.
+     */
+    localizedName?: {
+        [key: string]: string;
+    };
+    /**
+     * Map of key-value pairs containing localized descriptions of the brand.
+     */
+    localizedDescription?: {
+        [key: string]: string;
+    };
+};
+type UpdateBrand = {
+    /**
+     * Brand name.
+     */
+    name?: string;
+    /**
+     * Brand description.
+     */
+    description?: string;
+    /**
+     * Map of key-value pairs containing localized names of the brand.
+     */
+    localizedName?: {
+        [key: string]: string;
+    };
+    /**
+     * Map of key-value pairs containing localized descriptions of the brand.
+     */
+    localizedDescription?: {
+        [key: string]: string;
+    };
+    metadata?: UpdateMetaData;
+};
+type BrandResponse = {
+    /**
+     * Brand name.
+     */
+    name?: string;
+    /**
+     * Id of the associated media file.
+     */
+    cloudinaryUrl?: string;
+    /**
+     * Brand description.
+     */
+    description?: string;
+    /**
+     * Map of key-value pairs containing localized names of the brand.
+     */
+    localizedName?: {
+        [key: string]: string;
+    };
+    /**
+     * Map of key-value pairs containing localized descriptions of the brand.
+     */
+    localizedDescription?: {
+        [key: string]: string;
+    };
+    /**
+     * Link to the associated media file.
+     */
+    image?: string;
+    /**
+     * Id of the media.
+     */
+    mediaId?: string;
+    /**
+     * Unique identifier of a brand.
+     */
+    id?: string;
+    metadata?: MetaData$1;
+};
+type MetaData$1 = {
+    /**
+     * Date and time when the object was created compliant with the ISO 8601 standard.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified compliant with the ISO 8601 standard.
+     */
+    modifiedAt?: string;
+    /**
+     * Object version.
+     */
+    version?: number;
+};
+type UpdateMetaData = {
+    /**
+     * Object version.
+     */
+    version?: number;
+};
+
+/**
+ * Public types for the Brand Service — stable names aliased over the generated
+ * `brand-service` types.
+ */
+
+/** A brand (read shape). */
+type Brand = BrandResponse;
+/** List of brands (`GET /brand/brands`) — a plain array. */
+type BrandList = Brands;
+/** Create body (`POST /brand/brands`). */
+type BrandInput = Brand$1;
+/** Update / patch body (`PUT` / `PATCH /brand/brands/{id}`). */
+type BrandUpdate = UpdateBrand;
+
+/**
+ * Emporix Brand Service (`/brand/brands`): CRUD over brands. Server-side;
+ * defaults to the service token (reads also work with an anonymous token).
+ * The path carries no `{tenant}` segment — the tenant comes from the token.
+ */
+declare class BrandService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List all brands. */
+    listBrands(query?: Record<string, string | number>, auth?: AuthContext): Promise<BrandList>;
+    /** Retrieve one brand by id. */
+    getBrand(brandId: string, auth?: AuthContext): Promise<Brand>;
+    /** Create a brand. */
+    createBrand(input: BrandInput, auth?: AuthContext): Promise<Brand>;
+    /** Replace a brand by id. */
+    updateBrand(brandId: string, input: BrandUpdate, auth?: AuthContext): Promise<Brand>;
+    /** Partially update a brand by id. */
+    patchBrand(brandId: string, patch: BrandUpdate, auth?: AuthContext): Promise<Brand>;
+    /** Delete a brand by id. */
+    deleteBrand(brandId: string, auth?: AuthContext): Promise<void>;
+}
+
+type LabelUpdate$1 = {
+    /**
+     * Name of the label.
+     */
+    name: string;
+    overlay?: Overlay;
+    /**
+     * Localized resource description in a form of a map of translations.
+     */
+    description: string | {
+        [key: string]: string;
+    };
+};
+type LabelCreation = {
+    /**
+     * Unique ID of the label. It will be auto-generated if not provided.
+     */
+    id?: string;
+} & LabelUpdate$1;
+type Label$1 = {
+    /**
+     * Unique ID of the label.
+     */
+    id?: string;
+    /**
+     * Name of the label.
+     */
+    name?: string;
+    /**
+     * Id of the media.
+     */
+    mediaId?: string;
+    /**
+     * Image URL.
+     */
+    image?: string;
+    /**
+     * Cludinary path.
+     */
+    cloudinaryUrl?: string;
+    overlay?: Overlay;
+    /**
+     * Localized resource description in a form of a map of translations.
+     */
+    description?: string | {
+        [key: string]: string;
+    };
+    metadata?: Metadata$2;
+};
+/**
+ * If present and `isTrue` is actually true the label should be printed on associated products on the described position.
+ */
+type Overlay = {
+    isTrue?: boolean;
+    position: number;
+};
+/**
+ * Metadata
+ */
+type Metadata$2 = {
+    /**
+     * The creation date.
+     */
+    createdAt?: string;
+    /**
+     * The modification date.
+     */
+    modifiedAt?: string;
+    /**
+     * The document version number.
+     */
+    version?: number;
+};
+
+/**
+ * Public types for the Label Service — stable names aliased over the generated
+ * `label-service` types. The list endpoint returns a plain `Label[]` (no named
+ * list schema upstream).
+ */
+
+/** A label (read shape). */
+type Label = Label$1;
+/** List of labels (`GET /label/labels`) — a plain array. */
+type LabelList = Label[];
+/** Create body (`POST /label/labels`). */
+type LabelInput = LabelCreation;
+/** Update / patch body (`PUT` / `PATCH /label/labels/{id}`). */
+type LabelUpdate = LabelUpdate$1;
+
+/**
+ * Emporix Label Service (`/label/labels`): CRUD over product labels (e.g.
+ * "Sale", "New"). Server-side; defaults to the service token. The path carries
+ * no `{tenant}` segment — the tenant comes from the token.
+ */
+declare class LabelService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List all labels. */
+    listLabels(query?: Record<string, string | number>, auth?: AuthContext): Promise<LabelList>;
+    /** Retrieve one label by id. */
+    getLabel(labelId: string, auth?: AuthContext): Promise<Label>;
+    /** Create a label. */
+    createLabel(input: LabelInput, auth?: AuthContext): Promise<Label>;
+    /** Replace a label by id. */
+    updateLabel(labelId: string, input: LabelUpdate, auth?: AuthContext): Promise<Label>;
+    /** Partially update a label by id. */
+    patchLabel(labelId: string, patch: LabelUpdate, auth?: AuthContext): Promise<Label>;
+    /** Delete a label by id. */
+    deleteLabel(labelId: string, auth?: AuthContext): Promise<void>;
+}
+
+type Metadata$1 = {
+    /**
+     * Date and time when the document was created.
+     */
+    createdAt: string;
+    /**
+     * Date and time when the document was last modified.
+     */
+    modifiedAt: string;
+    /**
+     * Version of the document.
+     */
+    version: number;
+};
+type Country$1 = {
+    /**
+     * The country code which consists of two capital letters and is compliant with ISO-3166-1 specification.
+     */
+    code?: string;
+    /**
+     * Localized name of the country. The value is returned as a map where the key is a language code and the value is a translation for the given language.
+     */
+    name?: {
+        [key: string]: string;
+    };
+    /**
+     * A list of regions to which the given country belongs to.
+     */
+    regions?: Array<string>;
+    /**
+     * The field indicating whether the given country is active for the tenant or not. Only active countries are visible in the system.
+     */
+    active?: boolean;
+    metadata?: Metadata$1;
+};
+type Region$1 = {
+    /**
+     * The region code.
+     */
+    code?: string;
+    /**
+     * The localized name of the region. The value is returned as a map where the key is a language code and the value is a translation for the given language.
+     */
+    name?: {
+        [key: string]: string;
+    };
+    metadata?: Metadata$1;
+};
+type CountryUpdate$1 = {
+    /**
+     * The field indicates whether the given country is active for the tenant or not. Only active countries are visible in the system.
+     */
+    active?: boolean;
+    metadata: {
+        /**
+         * Version of the document. The version is used for optimistic locking mechanism during the update request.
+         */
+        version: number;
+    };
+};
+
+/**
+ * Public types for the Country Service — stable names aliased over the generated
+ * `country-service` types. The list endpoints return plain arrays upstream.
+ */
+
+/** A country (read shape). */
+type Country = Country$1;
+/** List of countries (`GET /countries`) — a plain array. */
+type CountryList = Country[];
+/** PATCH body for a country. */
+type CountryUpdate = CountryUpdate$1;
+/** A region (read shape). */
+type Region = Region$1;
+/** List of regions (`GET /regions`) — a plain array. */
+type RegionList = Region[];
+
+/**
+ * Emporix Country Service (`/country/{tenant}/…`): countries and regions
+ * master data. Server-side; defaults to the service token (reads also work
+ * with an anonymous token). Countries are predefined — list/get/patch only
+ * (no create/delete).
+ */
+declare class CountryService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List all countries. */
+    listCountries(query?: Record<string, string | number>, auth?: AuthContext): Promise<CountryList>;
+    /** Retrieve one country by code. */
+    getCountry(countryCode: string, auth?: AuthContext): Promise<Country>;
+    /** Partially update a country by code. Resolves once accepted (no response body). */
+    patchCountry(countryCode: string, patch: CountryUpdate, auth?: AuthContext): Promise<void>;
+    /** List all regions. */
+    listRegions(query?: Record<string, string | number>, auth?: AuthContext): Promise<RegionList>;
+    /** Retrieve one region by code. */
+    getRegion(regionCode: string, auth?: AuthContext): Promise<Region>;
+}
+
+type Metadata = {
+    /**
+     * Time of document creation.
+     */
+    createdAt?: string;
+    /**
+     * Time of document modification.
+     */
+    modifiedAt?: string;
+    /**
+     * Document version.
+     */
+    version?: number;
+};
+type UpdateMetadata = {
+    /**
+     * Current version of the updated document.
+     */
+    version: number;
+};
+/**
+ * Represents a single currency creation. The currency consists of a code compliant with the ISO-4217 standard (https://www.iso.org/iso-4217-currency-codes.html) and a currency name. The `name` field is localized.
+ */
+type CurrencyCreation = {
+    /**
+     * Currency code. The currency symbol must consist of three capital letters and must be a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html).
+     *
+     */
+    code: string;
+    /**
+     * Currency name. If the `Content-Language` is set to `*`, the field should be provided as a map that contains all translations in the `key:value` pairs format, where `key` is the language code and `value` is the translation. If the `Content-Language` contains a single language, the translation should be passed as a string value. If the `Accept-Language` header is empty, the translation will be returned in the language defined in the `Configuration service` as default.
+     *
+     * **Note:** Only the languages defined in the system are allowed to be used here. If a language code not defined in the system is provided, the request will be rejected.
+     */
+    name: string | {
+        [key: string]: string;
+    };
+};
+/**
+ * Represents a single currency update.
+ */
+type CurrencyUpdate$1 = {
+    /**
+     * The currency name. If the `Content-Language` is set to `*`, the field should be provided as a map that contains all translations in the format of `key:value` pairs, where `key` is the language code and `value` is the translation. If the `Content-Language` contains a single language, the translation should be passed as a string value. If the `Content-Language` header is empty, the default language defined in the `Configuration service` is taken.
+     *
+     * Only the languages defined in the system are allowed to be used here. If a language code not defined in the system is provided, the request will be rejected.
+     */
+    name: string | {
+        [key: string]: string;
+    };
+    metadata: UpdateMetadata;
+};
+/**
+ * Represents the response after a successful currency creation.
+ */
+type CurrencyCreationResponse = {
+    /**
+     * Code of the newly created currency.
+     *
+     */
+    code?: string;
+};
+/**
+ * Represents the response after a successful exchange rate creation.
+ */
+type ExchangeRateResponse = {
+    /**
+     * Code of the newly created exchange rate in the following format: `sourceCurrency_targetCurrency`.
+     *
+     */
+    code?: string;
+};
+/**
+ * Represents a single currency. The currency consists of a code compliant with ISO-4217 (https://www.iso.org/iso-4217-currency-codes.html) and a currency name. The name field is localized.
+ */
+type CurrencyRetrieval = {
+    /**
+     * Currency code. The currency symbol consists of three capital letters and is a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html).
+     *
+     */
+    code?: string;
+    /**
+     * The currency name.
+     * If the `Accept-Language` is set to `*`, each internationalized field is returned as a map that contains all translations in the format of `key:value` pairs, where `key` is the language code and `value` is the translation.
+     * The `Accept-Language` can contain the priority list of languages which should be returned. Always one language is returned as a single string field. Example: 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7'
+     * If the `Accept-Language` header is empty, the translation will be returned in the language defined in the `Configuration service` as default.
+     */
+    name?: string | {
+        [key: string]: string;
+    };
+    metadata?: Metadata;
+};
+type ExchangeRateUpdateRequest = {
+    /**
+     * Represents the exchange rate.
+     *
+     * The value of the field is represented by a number where the cent part is separated by a comma. For example, `1.09`. The cent part is not limited just to two digits. A rate with any precision can be returned. For example: `1.09193421`
+     */
+    rate: string;
+    metadata: UpdateMetadata;
+};
+type ExchangeRateCreationRequest = {
+    /**
+     * The source currency code. The currency symbol must consist of three capital letters and must be a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html) defined in the system.
+     */
+    sourceCurrency: string;
+    /**
+     * The target currency code. The currency symbol must consist of three capital letters and must be a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html) defined in the system.
+     */
+    targetCurrency: string;
+    /**
+     * Represents the exchange rate.
+     *
+     * The value of the field is represented by a number where the cent part is separated by a comma. For example `1.09`. The cent part is not limited just to two digits. A rate with any precision can be returned. For example: `1.091934212`
+     */
+    rate: string;
+};
+type ExchangeRateRetrieval = {
+    /**
+     * Identifier of the exchange rate. The identifier consists of the source currency and the target currency separated by an underscore.
+     */
+    code?: string;
+    /**
+     * Source currency code. The currency symbol must consist of three capital letters and must be a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html) defined in the system.
+     */
+    sourceCurrency?: string;
+    /**
+     * Target currency code. The currency symbol must consist of three capital letters and must be a valid ISO-4217 code (https://www.iso.org/iso-4217-currency-codes.html) defined in the system.
+     */
+    targetCurrency?: string;
+    /**
+     * Represents the exchange rate.
+     *
+     * The value of the field is represented by a number where the cent part is separated by a dot. For example `1.09`. The cent part is not limited just to two digits. A rate with any precision can be returned. For example: `1.091934212`
+     */
+    rate?: string;
+    metadata?: Metadata;
+};
+
+/**
+ * Public types for the Currency Service — stable names aliased over the
+ * generated `currency-service` types. The list endpoints return plain arrays.
+ */
+
+/** A currency (read shape). */
+type Currency = CurrencyRetrieval;
+/** List of currencies (`GET /currencies`) — a plain array. */
+type CurrencyList = CurrencyRetrieval[];
+/** Create body (`POST /currencies`). */
+type CurrencyInput = CurrencyCreation;
+/** Update body (`PUT /currencies/{code}`). */
+type CurrencyUpdate = CurrencyUpdate$1;
+/** `POST /currencies` (201) response. */
+type CurrencyCreated = CurrencyCreationResponse;
+/** An exchange rate (read shape). */
+type ExchangeRate = ExchangeRateRetrieval;
+/** List of exchange rates (`GET /exchanges`) — a plain array. */
+type ExchangeRateList = ExchangeRateRetrieval[];
+/** Create body (`POST /exchanges`). */
+type ExchangeRateInput = ExchangeRateCreationRequest;
+/** Update body (`PUT /exchanges/{code}`). */
+type ExchangeRateUpdate = ExchangeRateUpdateRequest;
+/** `POST /exchanges` (201) response. */
+type ExchangeRateCreated = ExchangeRateResponse;
+
+/**
+ * Emporix Currency Service (`/currency/{tenant}/…`): currencies and exchange
+ * rates. Server-side; defaults to the service token.
+ */
+declare class CurrencyService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List all currencies. */
+    listCurrencies(query?: Record<string, string | number>, auth?: AuthContext): Promise<CurrencyList>;
+    /** Retrieve one currency by code. */
+    getCurrency(code: string, auth?: AuthContext): Promise<Currency>;
+    /** Create a currency. */
+    createCurrency(input: CurrencyInput, auth?: AuthContext): Promise<CurrencyCreated>;
+    /** Update a currency by code. */
+    updateCurrency(code: string, input: CurrencyUpdate, auth?: AuthContext): Promise<Currency>;
+    /** Delete a currency by code. */
+    deleteCurrency(code: string, auth?: AuthContext): Promise<void>;
+    /** List all exchange rates. */
+    listExchangeRates(query?: Record<string, string | number>, auth?: AuthContext): Promise<ExchangeRateList>;
+    /** Retrieve one exchange rate by code. */
+    getExchangeRate(code: string, auth?: AuthContext): Promise<ExchangeRate>;
+    /** Create an exchange rate. */
+    createExchangeRate(input: ExchangeRateInput, auth?: AuthContext): Promise<ExchangeRateCreated>;
+    /** Update an exchange rate by code. */
+    updateExchangeRate(code: string, input: ExchangeRateUpdate, auth?: AuthContext): Promise<ExchangeRate>;
+    /** Delete an exchange rate by code. */
+    deleteExchangeRate(code: string, auth?: AuthContext): Promise<void>;
+}
+
+type ActualDeliveryWindows = Array<ActualDeliveryWindow>;
+type Patch = Array<{
+    /**
+     * Indicates an operation which should be done. Available operations: `add`, `remove` and `replace`
+     */
+    op?: string;
+    /**
+     * Indicates a path for which the value should be applied. For example: `/shippingMethod`, `/cutOffTime/day`
+     */
+    path?: string;
+    /**
+     * Indicates a value that should be changed or added. The value can be of a primitive type, like string, number, boolean or it can be an object or an array.
+     */
+    value?: string | {
+        [key: string]: unknown;
+    };
+}>;
+/**
+ * Delivery window is a range of times when the shipment can be delivered to the customers.
+ */
+type ActualDeliveryWindow = {
+    /**
+     * Delivery window’s unique identifier.
+     */
+    id?: string;
+    /**
+     * Delivery date compliant with the ISO 8601 standard.
+     */
+    deliveryDate: string;
+    deliveryTimeRange?: TimeRange;
+    /**
+     * Delivery cycle.
+     */
+    deliveryCycle?: string;
+    /**
+     * Delivery zone’s unique identifier.
+     */
+    zoneId?: string;
+    /**
+     * Delivery method name.
+     */
+    deliveryMethod?: string;
+    /**
+     * This denotes the latest point in time by which an action (such as an order or request) must be completed for a specific Delivery Time. Date is compliant with the ISO 8601 standard.
+     */
+    cutOffTime?: string;
+    /**
+     * Delivery time slot's unique identifier.
+     */
+    slotId?: string;
+    metadata?: MetaData;
+};
+type BasicDeliveryTime = {
+    /**
+     * Delivery Time ID: Autogenerated (if not provided in request) or User-Defined
+     */
+    id?: string;
+    /**
+     * Optional name for Delivery Time
+     */
+    name?: string;
+    /**
+     * Site code for which the Delivery Time is assigned
+     */
+    siteCode: string;
+    /**
+     * `true` indicates that the Delivery Time holds delivery date information, whereas `false` represents that the Delivery Time configuration has disabled delivery for a specific date or time period.
+     */
+    isDeliveryDay: boolean;
+    /**
+     * ID of the delivery zone for which the Delivery Time is valid
+     */
+    zoneId?: string;
+    day: DeliveryDay;
+    /**
+     * This attribute holds information about the established timeslots and cut-off times that are set up for a specific Delivery Time
+     */
+    slots?: Array<SlotCreation>;
+    /**
+     * Flag which indicates if the non-delivery time is defined for the same day, period or weekday for all zones of the site
+     */
+    isForAllZones?: boolean;
+    /**
+     * Id of the time zone for which the Delivery Time should be created (e.g. Europe/Warsaw).
+     */
+    timeZoneId: string;
+    /**
+     * Indicates in how many days the order has been delivered when the order has been completed before cut-off time.
+     */
+    deliveryDayShift?: number;
+};
+type DeliveryTime$1 = BasicDeliveryTime & {
+    metadata?: MetaData;
+};
+type UpdateDeliveryTime = BasicDeliveryTime & {
+    /**
+     * metadata of the document
+     */
+    metadata?: {
+        /**
+         * version of the document
+         */
+        version: number;
+    };
+};
+type SlotCreation = {
+    /**
+     * Delivery Time Slot ID: Autogenerated (if not provided in request) or User-Defined
+     */
+    id?: string;
+    /**
+     * Selected shipping method which is available for the Delivery Time in the given Time Slot
+     */
+    shippingMethod: string;
+    deliveryTimeRange: DeliveryTimeRange;
+    cutOffTime: CutOffTIme;
+    /**
+     * A capacity determines how many orders the given Delivery Time Slot can handle
+     */
+    capacity: number;
+};
+/**
+ * Object which encapsulates all the fields needed to generate delivery cycle.
+ */
+type DeliveryCycle = {
+    /**
+     * A unique identifier for the overall delivery time period or range.
+     */
+    deliveryTimeId: string;
+    /**
+     * A unique identifier that represents a specific delivery slot within the delivery time.
+     */
+    slotId: string;
+    /**
+     * The selected delivery date.
+     */
+    deliveryDate: string;
+};
+/**
+ * This attribute holds the time configuration for which the Delivery Time is valid. Only a single attribute can be set at any given moment.
+ */
+type DeliveryDay = {
+    /**
+     * Enum containing names of weekdays, possible values: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
+     */
+    weekday?: string;
+    /**
+     * Date for which the delivery time is valid, compliant with the ISO 8601 standard. Dates should be provided at 12:00:00 local time and send in ISO 8601 standard (e.g. For Europe/Warsaw timezone, the 10:00 should be sent - 2023-06-12T10:00:00.000Z).
+     */
+    singleDate?: string;
+    /**
+     * Date period for which the Delivery Time is valid. Dates should be provided at 12:00:00 local time and send in ISO 8601 standard (e.g. For Europe/Warsaw timezone, the 10:00 should be sent - 2023-06-12T10:00:00.000Z).
+     */
+    datePeriod?: {
+        /**
+         * Date from which the delivery time is valid, compliant with the ISO 8601 standard.
+         */
+        dateFrom: string;
+        /**
+         * Date to which the delivery time is valid, compliant with the ISO 8601 standard.
+         */
+        dateTo: string;
+    };
+};
+/**
+ * This denotes the latest point in time by which an action (such as an order or request) must be completed for a specific Delivery Time. This attribute is key in determining the end of a time window for certain operations and helps maintain efficiency in the delivery process.
+ */
+type CutOffTIme = {
+    /**
+     * The cut-off time refers to the deadline by which an order must be placed to be eligible for same-day processing and shipping. Date is compliant with the ISO 8601 standard, but only time is taking into account.
+     */
+    time: string;
+    /**
+     * Indicates in how many days the order has been delivered when the order has been completed before cut-off time. Property is only available for delivery times of weekday type.
+     */
+    cutOffDayShift?: number;
+    /**
+     * An optional suffix that is added to delivery cycle name
+     */
+    deliveryCycleName?: string;
+};
+/**
+ * A `from` to `to` time range for which the object is valid
+ */
+type TimeRange = {
+    /**
+     * Time from which the object is valid, provided in local time (e.g. 10:00)
+     */
+    startTime: string;
+    /**
+     * Time to which the object is valid, provided in local time (e.g. 10:00).
+     */
+    endTime: string;
+};
+/**
+ * A `from` to `to` time range for which the object is valid
+ */
+type DeliveryTimeRange = {
+    /**
+     * Time from which the object is valid, provided in local time (e.g. 10:00)
+     */
+    timeFrom: string;
+    /**
+     * Time to which the object is valid, provided in local time (e.g. 10:00).
+     */
+    timeTo: string;
+};
+type MetaData = {
+    /**
+     * Date and time when the object was created, compliant with the ISO 8601 format.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified, compliant with the ISO 8601 format.
+     */
+    modifiedAt?: string;
+    version?: number;
+};
+type Sites = Array<Site>;
+/**
+ * A site is a specific virtual or real shop.
+ */
+type Site = {
+    /**
+     * Site unique identifier.
+     */
+    id?: string;
+    /**
+     * Default shippingzone’s unique identifier. A shipping zone is an area where shipments can be delivered.
+     */
+    defaultZoneId?: string;
+    zones?: Array<ZoneWithActualDeliveryWindows>;
+    metadata?: MetaData;
+};
+type Zones = Array<Zone$1>;
+/**
+ * The zone is an area where shipments can be delivered.
+ */
+type Zone$1 = {
+    /**
+     * Delivery zone's unique identifier.
+     */
+    id: string;
+    /**
+     * Flag indicating whether the zone is the default delivery zone for the site.
+     */
+    default?: boolean;
+    name: LocalizedValue;
+    shipTo: ShipTo;
+    methods?: Methods;
+};
+type ZoneWithActualDeliveryWindows = Zone$1 & {
+    actualDeliveryWindows?: ActualDeliveryWindows;
+};
+/**
+ * Link to created resource with unique resource identifier.
+ */
+type ResourceCreatedResponse = {
+    /**
+     * Created resource’s unique identifier.
+     */
+    id?: string;
+};
+type Methods = Array<Method>;
+/**
+ * Shipping methods define the types of deliveries and properties such as delivery fees.
+ */
+type Method = {
+    id: string;
+    name: LocalizedValue;
+    maxOrderValue?: MonetaryAmount;
+    /**
+     * Flag indicating whether the shipping method is active.
+     */
+    active?: boolean;
+    fees: Fees;
+    /**
+     * Shipping method's tax code.
+     */
+    shippingTaxCode?: string;
+    /**
+     * Shipping groups unique identifier.
+     */
+    shippingGroupId?: string;
+};
+type Fees = Array<Fee>;
+/**
+ * Fee is a shipping cost for a given shipping method and parameters.
+ */
+type Fee = {
+    cost: MonetaryAmount;
+    minOrderValue: MonetaryAmount;
+    /**
+     * Shipping group unique identifier.
+     */
+    shippingGroupId?: string;
+};
+/**
+ * Amount of money in a given currency.
+ */
+type MonetaryAmount = {
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency: string;
+    /**
+     * Amount in specified currency.
+     */
+    amount: number;
+};
+/**
+ * Payload with parameters for price finding.
+ */
+type FindSiteRequest = {
+    /**
+     * Postal code containing numbers and/or letters.
+     */
+    postalCode: string;
+    /**
+     * ISO2 or ISO3 formatted country code.
+     */
+    country?: string;
+};
+/**
+ * Collection of shipping destinations
+ */
+type ShipTo = Array<ShipToItem>;
+/**
+ * Shipping destination containing country and postal code.
+ */
+type ShipToItem = {
+    /**
+     * ISO2 or ISO3 formatted country code.
+     */
+    country: string;
+    /**
+     * PostalCode containing numbers and/or letters. Can be incomplete and followed by single '*' to match all the postalCodes starting with the same numbers/letters.
+     */
+    postalCode?: string;
+};
+/**
+ * Example of payload for shipping cost calculation.
+ */
+type QuotePayload = {
+    /**
+     * Customer unique identifier.
+     */
+    customerId?: string;
+    /**
+     * Total amount for the given cart.
+     */
+    cartTotal: {
+        /**
+         * Amount in specified currency.
+         */
+        amount: number;
+        /**
+         * Three-letter currency code, compliant with the ISO 4217 standard.
+         */
+        currency: string;
+    };
+    shipFromAddress?: Address;
+    shipToAddress: Address;
+};
+/**
+ * Example of payload for shipping cost calculation.
+ */
+type QuoteSlot = {
+    /**
+     * Customer unique identifier.
+     */
+    customerId?: string;
+    /**
+     * Total amount for the given cart.
+     */
+    cartTotal: {
+        /**
+         * Amount in specified currency.
+         */
+        amount: number;
+        /**
+         * Three-letter currency code, compliant with the ISO 4217 standard.
+         */
+        currency: string;
+    };
+    shipFromAddress?: Address;
+    shipToAddress?: Address;
+    /**
+     * The `slotId`` which the quote should be calculated for.
+     */
+    slotId: string;
+    /**
+     * The delivery window id which the slot with selected shipping method exists for.
+     */
+    deliveryWindowId: string;
+};
+/**
+ * Address of billing or delivery that contains customer or company name and location including street, street number, zipcode, and country.
+ */
+type Address = {
+    /**
+     * Name of the street.
+     */
+    street?: string;
+    streetNumber?: string;
+    extraLine1?: string;
+    extraLine2?: string;
+    extraLine3?: string;
+    extraLine4?: string;
+    zipCode: string;
+    city?: string;
+    state?: string;
+    country: string;
+};
+/**
+ * Example quote response which contains a list of fees for various methods and delivery zone.
+ */
+type QuoteResponse = Array<QuoteResponseItem>;
+/**
+ * Example quote response which contains fee for specific method and zone.
+ */
+type QuoteResponseItem = {
+    zone?: {
+        /**
+         * Delivery zone's unique identifier.
+         */
+        id?: string;
+        name?: LocalizedValue;
+    };
+    methods?: Array<QuoteResponseMethods>;
+};
+/**
+ * Example quote response which contains fee for specific method.
+ */
+type QuoteResponseMethods = {
+    id?: string;
+    name?: LocalizedValue;
+    fee?: MonetaryAmount;
+    shippingTaxCode?: string;
+};
+type LocalizedValue = string | {
+    [key: string]: string;
+};
+/**
+ * Minimum available delivery fee for given parameters.
+ */
+type MinimumFee$1 = {
+    fee?: MonetaryAmount;
+};
+/**
+ * Shipping groups can be used for customer grouping with use customer group relations.
+ */
+type Group = {
+    /**
+     * Delivery group unique identifier.
+     */
+    id: string;
+    description?: LocalizedValue;
+};
+/**
+ * Collection of shipping groups.
+ */
+type GroupList = Array<Group>;
+/**
+ * Customer-group relation allows to assign user for specific group.
+ */
+type CgRelation$1 = {
+    /**
+     * Customer unique identifier.
+     */
+    customerId?: string;
+    /**
+     * Group's unique identifier.
+     */
+    groupId?: string;
+};
+type CgRelationList$1 = Array<CgRelation$1>;
+type DeliveryWindowValidationDto = {
+    /**
+     * The selected delivery window
+     */
+    deliveryWindowId: string;
+    /**
+     * The selected delivery date
+     */
+    deliveryDate: string;
+    /**
+     * The slot that was selected for the delivery.
+     */
+    slotId?: string;
+};
+
+/**
+ * Public types for the Shipping Service (Phase 1 — config). Stable names aliased
+ * over the generated `shipping` types. Zone/Method/Group/CgRelation use the same
+ * schema for read and write bodies; creates return `ResourceCreated`.
+ */
+
+/** `findSites` response (array of sites). */
+type SiteList = Sites;
+/** `findSites` request body. */
+type FindSiteInput = FindSiteRequest;
+/** A shipping zone (read + write body). */
+type Zone = Zone$1;
+/** List of shipping zones. */
+type ZoneList = Zones;
+/** A shipping method (read + write body). */
+type ShippingMethod = Method;
+/** List of shipping methods. */
+type ShippingMethodList = Methods;
+/** A shipping group (read + write body). */
+type ShippingGroup = Group;
+/** List of shipping groups. */
+type ShippingGroupList = GroupList;
+/** A customer-group relation (read + write body). */
+type CgRelation = CgRelation$1;
+/** List of customer-group relations. */
+type CgRelationList = CgRelationList$1;
+/** Body for `quote` / `quoteMinimum`. */
+type QuoteInput = QuotePayload;
+/** `quote` result. */
+type QuoteResult = QuoteResponse;
+/** Body for `quoteSlot`. */
+type QuoteSlotInput = QuoteSlot;
+/** `quoteMinimum` / `quoteSlot` result. */
+type MinimumFee = MinimumFee$1;
+/** Shared create response (resource location). */
+type ResourceCreated = ResourceCreatedResponse;
+/** A delivery window for a cart/area. */
+type DeliveryWindow = ActualDeliveryWindow;
+/** List of delivery windows. */
+type DeliveryWindowList = ActualDeliveryWindows;
+/** Body for delivery-window validation / counter increment. */
+type DeliveryWindowValidation = DeliveryWindowValidationDto;
+/** A delivery time (read shape). */
+type DeliveryTime = DeliveryTime$1;
+/** List of delivery times (`GET /delivery-times`). */
+type DeliveryTimeList = DeliveryTime[];
+/** Create body (`POST /delivery-times`). */
+type DeliveryTimeInput = BasicDeliveryTime;
+/** Update body (`PUT /delivery-times/{id}`). */
+type DeliveryTimeUpdate = UpdateDeliveryTime;
+/** A delivery time slot (read + write body). */
+type DeliverySlot = SlotCreation;
+/** List of delivery time slots. */
+type DeliverySlotList = DeliverySlot[];
+/** Body for `generateDeliveryCycle`. */
+type DeliveryCycleInput = DeliveryCycle;
+/** JSON-Patch op-array (used by `patchDeliveryTime` / `patchSlot`). */
+type ShippingPatch = Patch;
+/** Inline create response — the created resource's `{ id }`. */
+interface DeliveryCreated {
+    id?: string;
+}
+
+/**
+ * Emporix Shipping Service (`/shipping/{tenant}/…`), Phase 1 — config: sites,
+ * zones, methods, cost/quote, groups, customer-group relations. Server-side;
+ * defaults to the service token. Most methods are site-scoped and take `site`
+ * first; `findSites` is tenant-level. Delivery scheduling is Phase 2.
+ */
+declare class ShippingService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    private siteBase;
+    /** Find shipping-related sites by postal code (`POST /findSite`). */
+    findSites(input: FindSiteInput, auth?: AuthContext): Promise<SiteList>;
+    /** List shipping zones for a site. */
+    listZones(site: string, query?: Record<string, string | number>, auth?: AuthContext): Promise<ZoneList>;
+    /** Retrieve one shipping zone. */
+    getZone(site: string, zoneId: string, auth?: AuthContext): Promise<Zone>;
+    /** Create a shipping zone. */
+    createZone(site: string, zone: Zone, auth?: AuthContext): Promise<ResourceCreated>;
+    /** Replace a shipping zone. */
+    updateZone(site: string, zoneId: string, zone: Zone, auth?: AuthContext): Promise<void>;
+    /** Partially update a shipping zone. */
+    patchZone(site: string, zoneId: string, patch: Zone, auth?: AuthContext): Promise<void>;
+    /** Delete a shipping zone. */
+    deleteZone(site: string, zoneId: string, auth?: AuthContext): Promise<void>;
+    /** List shipping methods of a zone. */
+    listMethods(site: string, zoneId: string, query?: Record<string, string | number>, auth?: AuthContext): Promise<ShippingMethodList>;
+    /** Retrieve one shipping method. */
+    getMethod(site: string, zoneId: string, methodId: string, auth?: AuthContext): Promise<ShippingMethod>;
+    /** Create a shipping method in a zone. */
+    createMethod(site: string, zoneId: string, method: ShippingMethod, auth?: AuthContext): Promise<ResourceCreated>;
+    /** Replace a shipping method. */
+    updateMethod(site: string, zoneId: string, methodId: string, method: ShippingMethod, auth?: AuthContext): Promise<void>;
+    /** Partially update a shipping method. */
+    patchMethod(site: string, zoneId: string, methodId: string, patch: ShippingMethod, auth?: AuthContext): Promise<void>;
+    /** Delete a shipping method. */
+    deleteMethod(site: string, zoneId: string, methodId: string, auth?: AuthContext): Promise<void>;
+    /** Calculate the final shipping cost (`POST /quote`). */
+    quote(site: string, input: QuoteInput, auth?: AuthContext): Promise<QuoteResult>;
+    /** Calculate the minimum shipping cost (`POST /quote/minimum`). */
+    quoteMinimum(site: string, input: QuoteInput, auth?: AuthContext): Promise<MinimumFee>;
+    /** Calculate the shipping cost for a given slot (`POST /quote/slot`). */
+    quoteSlot(site: string, input: QuoteSlotInput, auth?: AuthContext): Promise<MinimumFee>;
+    /** List shipping groups for a site. */
+    listGroups(site: string, query?: Record<string, string | number>, auth?: AuthContext): Promise<ShippingGroupList>;
+    /** Retrieve one shipping group. */
+    getGroup(site: string, groupId: string, auth?: AuthContext): Promise<ShippingGroup>;
+    /** Create a shipping group. */
+    createGroup(site: string, group: ShippingGroup, auth?: AuthContext): Promise<ResourceCreated>;
+    /** Replace a shipping group. */
+    updateGroup(site: string, groupId: string, group: ShippingGroup, auth?: AuthContext): Promise<void>;
+    /** Delete a shipping group. */
+    deleteGroup(site: string, groupId: string, auth?: AuthContext): Promise<void>;
+    /** List customer-group relations for a site. */
+    listCgRelations(site: string, query?: Record<string, string | number>, auth?: AuthContext): Promise<CgRelationList>;
+    /** Retrieve a customer's customer-group relations. */
+    getCgRelations(site: string, customerId: string, auth?: AuthContext): Promise<CgRelation>;
+    /** Create a customer-group relation. */
+    createCgRelation(site: string, relation: CgRelation, auth?: AuthContext): Promise<ResourceCreated>;
+    /** Update a customer's customer-group relations. */
+    updateCgRelations(site: string, customerId: string, relation: CgRelation, auth?: AuthContext): Promise<void>;
+    /** Delete a customer's customer-group relation. */
+    deleteCgRelation(site: string, customerId: string, auth?: AuthContext): Promise<void>;
+    /** Retrieve delivery windows for a delivery area + cart. */
+    getAreaDeliveryWindows(deliveryAreaId: string, cartId: string, auth?: AuthContext): Promise<DeliveryWindowList>;
+    /** Retrieve delivery windows for a cart. */
+    getCartDeliveryWindows(cartId: string, auth?: AuthContext): Promise<DeliveryWindowList>;
+    /** Increment the delivery-window counter. */
+    incrementDeliveryWindowCounter(input: DeliveryWindowValidation, auth?: AuthContext): Promise<void>;
+    /** Validate a delivery window. Resolves when valid; throws otherwise. */
+    validateDeliveryWindow(input: DeliveryWindowValidation, auth?: AuthContext): Promise<void>;
+    /** List all delivery times. */
+    listDeliveryTimes(query?: Record<string, string | number>, auth?: AuthContext): Promise<DeliveryTimeList>;
+    /** Retrieve one delivery time. */
+    getDeliveryTime(deliveryTimeId: string, auth?: AuthContext): Promise<DeliveryTime>;
+    /** Create a delivery time. */
+    createDeliveryTime(input: DeliveryTimeInput, auth?: AuthContext): Promise<DeliveryCreated>;
+    /** Create multiple delivery times (`POST /delivery-times/bulk`). */
+    createDeliveryTimesBulk(inputs: DeliveryTimeInput[], auth?: AuthContext): Promise<DeliveryCreated[]>;
+    /** Replace a delivery time. */
+    updateDeliveryTime(deliveryTimeId: string, input: DeliveryTimeUpdate, auth?: AuthContext): Promise<void>;
+    /** Partially update a delivery time (JSON-Patch op array). */
+    patchDeliveryTime(deliveryTimeId: string, ops: ShippingPatch, auth?: AuthContext): Promise<void>;
+    /** Delete a delivery time. */
+    deleteDeliveryTime(deliveryTimeId: string, auth?: AuthContext): Promise<void>;
+    /** List slots of a delivery time. */
+    listSlots(deliveryTimeId: string, auth?: AuthContext): Promise<DeliverySlotList>;
+    /** Retrieve one slot. */
+    getSlot(deliveryTimeId: string, slotId: string, auth?: AuthContext): Promise<DeliverySlot>;
+    /** Create a slot in a delivery time. */
+    createSlot(deliveryTimeId: string, input: DeliverySlot, auth?: AuthContext): Promise<DeliveryCreated>;
+    /** Replace a slot. */
+    updateSlot(deliveryTimeId: string, slotId: string, input: DeliverySlot, auth?: AuthContext): Promise<void>;
+    /** Partially update a slot (JSON-Patch op array). */
+    patchSlot(deliveryTimeId: string, slotId: string, ops: ShippingPatch, auth?: AuthContext): Promise<void>;
+    /** Delete a slot. */
+    deleteSlot(deliveryTimeId: string, slotId: string, auth?: AuthContext): Promise<void>;
+    /** Delete all slots of a delivery time. */
+    deleteAllSlots(deliveryTimeId: string, auth?: AuthContext): Promise<void>;
+    /** Generate a delivery cycle (`POST /delivery-cycles/generate`). Returns the cycle id. */
+    generateDeliveryCycle(input: DeliveryCycleInput, auth?: AuthContext): Promise<string>;
+}
+
+/**
+ * Price calculation derived from the order entry `calculatedPrice.finalPrice`. The `finalPrice` reflects already applied discounts and fees.
+ */
+type CalculatedPrice = {
+    /**
+     * Net value of the price.
+     */
+    netValue?: number;
+    /**
+     * Gross value of the price.
+     */
+    grossValue?: number;
+    /**
+     * Tax value of the price.
+     */
+    taxValue?: number;
+    /**
+     * Tax code applied to the price. Set to `null` when items with different tax codes are aggregated.
+     */
+    taxCode?: string;
+    /**
+     * Tax rate applied to the price. Set to `null` when items with different tax rates are aggregated.
+     */
+    taxRate?: number;
+};
+/**
+ * Wrapper for the calculated price containing the final price after discounts and fees.
+ */
+type CalculatedFinalPrice = {
+    finalPrice?: CalculatedPrice;
+};
+/**
+ * Core metadata fields shared across multiple objects.
+ */
+type MetadataCore = {
+    /**
+     * Links to the mixin schemas.
+     */
+    mixins?: {
+        [key: string]: string;
+    };
+};
+/**
+ * Metadata fields required when updating an existing object.
+ */
+type MetadataUpdate = MetadataCore & {
+    /**
+     * Version of the object. The version is required during the update operation because of the optimistic locking mechanism.
+     */
+    version: number;
+};
+/**
+ * Metadata fields returned by the API.
+ * Extends `metadataUpdate` with timestamps indicating when the object
+ * was created and last modified.
+ *
+ */
+type MetadataResponse = MetadataUpdate & {
+    /**
+     * Date and time when the object was created. The value is returned as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified. The value is returned as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     */
+    modifiedAt?: string;
+};
+/**
+ * Base schema for a return.
+ */
+type BasicReturn = {
+    /**
+     * A list of orders that contain items to be returned. All the orders must have the same currency.
+     */
+    orders: Array<Order>;
+    /**
+     * A reason why the return is created. One of the values needs to be provided: `code` or `details`.
+     */
+    reason: {
+        /**
+         * Code of a particular reason for return. A number which represents a reason why an order has been (fully or partially) returned.
+         */
+        code?: string;
+        /**
+         * Details why an order has been (fully or partially) returned.
+         */
+        details?: string;
+    };
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataCore;
+};
+type BasicCustomerReturn = BasicReturn;
+/**
+ * Base schema for returns created by an employee FOR A REGISTERED CUSTOMER.
+ */
+type BasicEmployeeReturn = BasicEmployeeReturnBase & {
+    /**
+     * Indicates who requested the return. The field can be set and updated only by an employee, that is a person who has a `returns.returns_manage` scope granted. For a customer, who has the `returns.returns_manage_own` scope granted, the value is populated automatically based on an auth token.
+     */
+    requestor?: {
+        /**
+         * Identifier of a customer to whom the order and return belong.
+         */
+        customerId: string;
+    };
+};
+/**
+ * Base schema for returns created by an employee for an ANONYMOUS ORDER.
+ */
+type EmployeeReturnForAnonymousOrder = BasicEmployeeReturnBase & {
+    /**
+     * Indicates who requested the return. The field can be set and updated only by an employee, that is a person who has a `returns.returns_manage` scope granted. For a customer, who has the `returns.returns_manage_own` scope granted, the value is populated automatically based on an auth token.
+     */
+    requestor?: {
+        /**
+         * Indicates that the request is related with anonymous orders
+         */
+        anonymous: boolean;
+        /**
+         * Email which has been used for anonymous order
+         */
+        email: string;
+        /**
+         * Identifier of a customer to whom the order and return belong.
+         */
+        customerId?: string;
+    };
+};
+/**
+ * Common structure for returns created by an employee on behalf of a customer.
+ */
+type BasicEmployeeReturnBase = BasicReturn & {
+    /**
+     * Indicates who requested the return. The field can be set and updated only by an employee,
+     * that is a person who has the `returns.returns_manage` scope granted.
+     * For a customer with the `returns.returns_manage_own` scope, the value is populated
+     * automatically based on an auth token.
+     *
+     */
+    requestor: {
+        [key: string]: unknown;
+    };
+    /**
+     * Indicates who submitted the return. The return can be submitted by an employee
+     * on behalf of a customer. In that case, the submitter and requestor are different entities.
+     * This field can be set and updated only by an employee with the
+     * `returns.returns_manage` scope granted.
+     *
+     */
+    submitter: {
+        /**
+         * Requestor first name.
+         */
+        firstName: string;
+        /**
+         * Requestor last name.
+         */
+        lastName: string;
+        /**
+         * Requestor email address.
+         */
+        email: string;
+    };
+    /**
+     * Information about the approver of the return. The return can be approved
+     * by a particular user or a group of users. The field can be set and updated
+     * only by an employee with the `returns.returns_manage` scope granted.
+     *
+     * The provided value is validated against the `iam-service`:
+     * * If `type` is equal to `USER`, then the provided `id` must be a valid employee identifier
+     * * If `type` is equal to `GROUP`, then the provided `id` must be a valid employee group identifier
+     *
+     */
+    approver?: {
+        /**
+         * Indicates whether the return must be approved by a user or a group. Possible values: `USER` or `GROUP`.
+         */
+        type?: 'USER' | 'GROUP';
+        /**
+         * Identifier of a user or a user group depending on the `type` value.
+         */
+        id?: string;
+    };
+    /**
+     * 'The date when a return expires. The field can be set and updated only by an employee
+     * with the `returns.returns_manage` scope granted.
+     *
+     * If the value is not provided, the default value is fetched from the
+     * `configuration-service` under the `return.defaultExpiryDate` key.
+     *
+     * If the configuration does not exist, a fallback of 30 days is applied.
+     *
+     */
+    expiryDate?: string;
+};
+/**
+ * Base schema for a return requested by a customer.
+ */
+type UpdateCustomerReturn = {
+    /**
+     * Unique identifier of a return.
+     */
+    id?: string;
+} & BasicReturn & {
+    metadata: MetadataUpdate;
+};
+/**
+ * Base schema for a return requested by an employee.
+ */
+type UpdateEmployeeReturn = UpdateCustomerReturn & {
+    /**
+     * Indicates the current status of the order. When an order is being created, its status is automatically set to PENDING. An approver can change the status to `APPROVED` or `REJECTED`. A customer can change the status to `CLOSED`.
+     */
+    approvalStatus: 'PENDING' | 'APPROVED' | 'REJECTED' | 'CLOSED';
+    /**
+     * Indicates whether the items from the return have been received.
+     */
+    received?: boolean;
+    /**
+     * Indicates who requested the return. The field can be updated only by an employee, that is a person who has the `returns.returns_manage` scope granted.
+     */
+    requestor: {
+        /**
+         * Identifier of a customer to whom the order and return belong.
+         */
+        customerId: string;
+    };
+    /**
+     * Indicates who submitted the return. The return can be submitted by an employee on behalf of a customer. In that case, the submitter and requestor data is different. The field can be set and updated only by an employee, that is a person who has the `returns.returns_manage` scope granted. For a customer, who has the `returns.returns_manage_own` scope granted, the value is populated automatically based on an auth token.
+     */
+    submitter: {
+        /**
+         * Requestor first name.
+         */
+        firstName: string;
+        /**
+         * Requestor last name.
+         */
+        lastName: string;
+        /**
+         * Requestor email address.
+         */
+        email: string;
+    };
+    /**
+     * Information about the approver of the return. The return can be approved by a particular user or a group of users. The field can be set and updated only by an employee, that is a person who has the `returns.returns_manage` scope granted. The provided value is validated agains the `iam-service`:
+     * * If `type` is equal to `USER`, then the provided `id` must be a valid employee identifier
+     * * If `type` is equal to `GROUP`, then the provided `id` must be a valid employee group identifier
+     */
+    approver?: {
+        /**
+         * Indicates whether the return needs to be approved by a particular user or a user group. Possible values: `USER` or `GROUP`.
+         */
+        type?: 'USER' | 'GROUP';
+        /**
+         * Identifier of a user or a user group, depending on the `type` value.
+         */
+        id?: string;
+    };
+    /**
+     * The date when the return expires. The field can be set and updated only by an employee, that is a person who has the `returns.returns_manage` scope granted. If the value is not provided, then the default value is fetched from the `configuration-service` under the `return.defaultExpiryDate` key. The value should be provided in the number format. The value specifies for how many days the return will be valid. If the configuration does not exist, then a `30` days offset is taken as a fallback.
+     */
+    expiryDate?: string;
+};
+/**
+ * Schema for retrieving returns by a customer.
+ */
+type FullCustomerReturn = BasicCustomerReturn & AssistedBuying & {
+    /**
+     * Unique identifier of a return, represented as a UUID string.
+     */
+    id?: string;
+    metadata?: MetadataResponse;
+    /**
+     * Indicates whether the items from the return have been received.
+     */
+    received?: boolean;
+    approvalStatus?: 'APPROVED' | 'PENDING' | 'REJECTED' | 'CLOSED';
+    /**
+     * A date when the return will expire. The value is returned as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
+     */
+    expiryDate?: string;
+    orders?: Array<FullReturnOrder>;
+    total?: {
+        value?: number;
+        currency?: string;
+    };
+    calculatedPrice?: CalculatedFinalPrice;
+};
+/**
+ * Schema for retrieving returns by an employee.
+ */
+type FullEmployeeReturn = FullCustomerReturn & {
+    /**
+     * Indicates who requested the return. The field is visible only to an employee, that is a person who has the returns.returns_read scope.
+     */
+    requestor?: {
+        /**
+         * Identifier of a customer to whom the order and return belong.
+         */
+        customerId?: string;
+        /**
+         * Requestor first name.
+         */
+        firstName?: string;
+        /**
+         * Requestor's last name.
+         *
+         */
+        lastName?: string;
+        /**
+         * Requestor email.
+         */
+        email?: string;
+    };
+    /**
+     * Indicates who submitted the return. The return can be submitted by an employee on behalf of a customer. In that case, the submitter and requestor data is different. The field can be retrieved only by an employee, that is a person who has the `returns.returns_manage scope` granted.
+     */
+    submitter?: {
+        /**
+         * Indicates who sent the return request. Information whether the request has been sent by a customer or by someone else on behalf of a customer.
+         */
+        userType?: string;
+        /**
+         * Submitter first name.
+         */
+        firstName?: string;
+        /**
+         * Submitter last name.
+         */
+        lastName?: string;
+        /**
+         * Submitter email name.
+         */
+        email?: string;
+    };
+    /**
+     * Information about the approver of the return. The return can be approved by a particular user or a group of users. The field can be retrieved only by an employee, that is a person who has the `returns.returns_read` scope granted.
+     */
+    approver?: {
+        /**
+         * Indicates whether the return needs to be approved by a particular user or user group.
+         */
+        type?: 'USER' | 'GROUP';
+        /**
+         * Identifier of a user or a user group, depending on the `type` value.
+         */
+        id?: string;
+    };
+};
+type FullReturnOrder = Order & {
+    items?: Array<FullReturnItem>;
+};
+type FullReturnItem = OrderItem & {
+    /**
+     * Name of a product.
+     */
+    name?: string;
+    /**
+     * The value represents a price (value and currency) of a single unit of the product.
+     */
+    unitPrice?: {
+        /**
+         * The value represents a price value of a single unit of the product.
+         */
+        value?: number;
+        /**
+         * The value represents the currency associated with the price. The currency is compliant with the ISO-4217 standard.
+         */
+        currency?: string;
+    };
+    /**
+     * The value represents the total price (value and currency) of all returned products related to the order.
+     */
+    total?: {
+        /**
+         * The value represents the total price value of all returned products.
+         */
+        value?: number;
+        /**
+         * The value represents the currency associated with the price. The currency is compliant with the ISO-4217 standard.
+         */
+        currency?: string;
+    };
+    /**
+     * Unit price derived from the order entry `calculatedPrice.finalPrice` divided by the order entry amount. Includes discounts and fees. Present only if the order entry has a valid `calculatedPrice.finalPrice`.
+     */
+    calculatedUnitPrice?: CalculatedPrice;
+    /**
+     * Total calculated price for the returned quantity of this item. Computed as `calculatedUnitPrice` multiplied by the returned quantity. Present only if the order entry has a valid `calculatedPrice.finalPrice`.
+     */
+    calculatedPrice?: CalculatedFinalPrice;
+};
+/**
+ * Represents the order which is being (fully or partially) returned.
+ */
+type Order = {
+    /**
+     * Unique identifier of an order.
+     */
+    id: string;
+    /**
+     * Represents a list of items included in the order. In the `order` entity, the field is called `entries`.
+     */
+    items: Array<OrderItem>;
+};
+/**
+ * Represents an item included in the order.
+ */
+type OrderItem = {
+    /**
+     * Unique identifier of an item. In the order entity, the field is called `order.entries[].id`.
+     */
+    id: string;
+    /**
+     * Quantity of the items in the order. In the order entity, the field is called `order.entries[].amount`.
+     */
+    quantity: number;
+    /**
+     * A reason why the item needs to be returned.
+     */
+    reason?: {
+        /**
+         * Code representing the reason for return.
+         */
+        code?: string;
+        /**
+         * Details why the item is being returned.
+         */
+        details?: string;
+    };
+};
+type ReturnId = {
+    /**
+     * Unique identifier of the created return.
+     */
+    id?: string;
+};
+type PatchOperation = {
+    /**
+     * Indicates an operation which should be done on a return. Available operations: `add` `remove` and `replace`
+     */
+    op: 'add' | 'remove' | 'replace';
+    /**
+     * Indicates a path for which the value should be applied. For example: `/mixins/additionalAttributes/externalId`, `/approvalStatus`, `/requestor/customerId`
+     */
+    path: string;
+    /**
+     * Indicates a value that should be changed or added. The value can be of a primitive type, like string, number, boolean or it can be an object or an array.
+     */
+    value?: {
+        [key: string]: unknown;
+    } | string;
+};
+type AssistedBuyingEntry = {
+    /**
+     * Identifier of an employee who performed an action on behalf of a customer.
+     */
+    employeeId?: string;
+    /**
+     * Indicates an operation type done by an employee on behalf of a customer. Available options: `CREATE` and `UPDATE_STATUS`.
+     */
+    operation?: 'CREATE' | 'UPDATE_STATUS';
+    /**
+     * Indicates a timestamp when an operation was performed.
+     */
+    timestamp?: string;
+};
+/**
+ * The field is populated only if an assisted buying operation was performed. The field is read-only. There is no possibility to update it by PUT/PATCH operation.
+ */
+type AssistedBuying = {
+    /**
+     * List of operations done by an employee on behalf of a customer.
+     */
+    entries?: Array<AssistedBuyingEntry>;
+};
+type ReturnCreateBody = BasicCustomerReturn | BasicEmployeeReturn | EmployeeReturnForAnonymousOrder;
+type ReturnUpdateBody = UpdateCustomerReturn | UpdateEmployeeReturn;
+
+/**
+ * Public types for the Returns Service — stable names aliased over the generated
+ * `returns` types. `Return` is the read shape (customer/employee variant union).
+ * The list endpoint is typed as a single return upstream (spec inaccuracy); it
+ * actually returns an array, so `ReturnList` overrides to `Return[]`.
+ */
+
+/** A return (read shape) — customer or employee variant. */
+type Return = FullCustomerReturn | FullEmployeeReturn;
+/** List of returns (`GET /returns`, paged). */
+type ReturnList = Return[];
+/** Create body (`POST /returns`). */
+type ReturnInput = ReturnCreateBody;
+/** Replace body (`PUT /returns/{id}`). */
+type ReturnUpdate = ReturnUpdateBody;
+/** Partial-update body (`PATCH /returns/{id}`) — a JSON-Patch op-array. */
+type ReturnPatch = PatchOperation[];
+/** `POST /returns` response — the created return's `{ id }`. */
+type ReturnCreated = ReturnId;
+
+/**
+ * Emporix Returns Service (`/return/{tenant}/returns`): CRUD over returns
+ * (RMA). Defaults to the service token; for customer self-service (own returns)
+ * pass `auth.customer(token)` (the React hooks do this).
+ */
+declare class ReturnsService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List returns (paged; supports `pageSize`/`pageNumber`/`sort`/`q`). */
+    listReturns(query?: Record<string, string | number>, auth?: AuthContext): Promise<ReturnList>;
+    /** Retrieve one return by id. */
+    getReturn(returnId: string, auth?: AuthContext): Promise<Return>;
+    /** Create a return. Returns the created `{ id }`. */
+    createReturn(input: ReturnInput, auth?: AuthContext): Promise<ReturnCreated>;
+    /** Replace a return by id (`PUT`). */
+    updateReturn(returnId: string, input: ReturnUpdate, auth?: AuthContext): Promise<void>;
+    /** Partially update a return by id (`PATCH`, JSON-Patch op-array). */
+    patchReturn(returnId: string, ops: ReturnPatch, auth?: AuthContext): Promise<void>;
+    /** Delete a return by id. */
+    deleteReturn(returnId: string, auth?: AuthContext): Promise<void>;
+}
+
+type CreateJob = {
+    siteCode: string;
+};
+type JobDetails = {
+    jobId?: string;
+    status?: string;
+    siteCode?: string;
+    fileId?: string;
+    active?: boolean;
+    ordersExportedCount?: number;
+    createdAt?: string;
+    completedAt?: string;
+};
+type JobId = {
+    id: string;
+};
+
+/**
+ * Public types for the SEPA Export Service — stable names aliased over the
+ * generated `sepa-export` types.
+ */
+
+/** A SEPA export job (read / list item). */
+type SepaJob = JobDetails;
+/** Create-job body (`POST /jobs`). */
+type SepaJobInput = CreateJob;
+/** `POST /jobs` response — the created job's id. */
+type SepaJobCreated = JobId;
+
+/**
+ * Emporix SEPA Export Service (`/sepa-export/{tenant}/…`): export jobs and file
+ * retrieval. Server-side; defaults to the service token.
+ */
+declare class SepaExportService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Retrieve a SEPA export file by id. Returns the raw file content (text). */
+    getFile(fileId: string, auth?: AuthContext): Promise<string>;
+    /** List export jobs. */
+    listJobs(query?: Record<string, string | number>, auth?: AuthContext): Promise<SepaJob[]>;
+    /** Create an export job. */
+    createJob(input: SepaJobInput, auth?: AuthContext): Promise<SepaJobCreated>;
+}
+
+type IndexPublicConfiguration = {
+    /**
+     * API Key used for search purposes.
+     */
+    searchKey?: string;
+    /**
+     * Application id of an indexer provider.
+     */
+    applicationId?: string;
+    /**
+     * Identifier of an index.
+     */
+    indexName?: string;
+    /**
+     * Index provider name. Supported providers: `ALGOLIA` (https://www.algolia.com), `BATTERY_INCLUDED` (https://www.batteryincluded.io). Only one provider can be active per tenant at a time.
+     */
+    provider?: 'ALGOLIA' | 'BATTERY_INCLUDED';
+    /**
+     * Indicates if the configuration is active or not.
+     */
+    active?: boolean;
+};
+type IndexConfiguration = IndexPublicConfiguration & {
+    /**
+     * API key used for write purposes.
+     */
+    writeKey?: string;
+    /**
+     * Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the `BATTERY_INCLUDED` provider; ignored for `ALGOLIA`.
+     */
+    excludedMixinKeys?: Array<string>;
+};
+type IndexCreationResponse = {
+    /**
+     * Identifier of a newly created configuration.
+     */
+    id?: string;
+};
+type Reindex = {
+    /**
+     * Indicates reindex mode. Supported modes: `FULL`.
+     */
+    mode?: 'FULL';
+};
+
+/**
+ * Public types for the Indexing Service — stable names aliased over the
+ * generated `indexing-service` types.
+ */
+
+/** An indexing configuration (read + write body). */
+type IndexConfig = IndexConfiguration;
+/** `POST /configurations` response. */
+type IndexConfigCreated = IndexCreationResponse;
+/** A public indexing configuration. */
+type IndexPublicConfig = IndexPublicConfiguration;
+/** Body for `reindex`. */
+type ReindexInput = Reindex;
+
+/**
+ * Emporix Indexing Service (`/indexing/{tenant}/…`): search-index provider
+ * configurations and reindex. Server-side; defaults to the service token.
+ */
+declare class IndexingService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List indexing configurations. */
+    listConfigurations(auth?: AuthContext): Promise<IndexConfig[]>;
+    /** Get a configuration by provider name. */
+    getConfiguration(provider: string, auth?: AuthContext): Promise<IndexConfig>;
+    /** Create a configuration. */
+    createConfiguration(input: IndexConfig, auth?: AuthContext): Promise<IndexConfigCreated>;
+    /** Update a configuration by provider name. */
+    updateConfiguration(provider: string, input: IndexConfig, auth?: AuthContext): Promise<void>;
+    /** Delete a configuration by provider name. */
+    deleteConfiguration(provider: string, auth?: AuthContext): Promise<void>;
+    /** List public indexing configurations. */
+    listPublicConfigurations(auth?: AuthContext): Promise<IndexPublicConfig[]>;
+    /** Get a public configuration by provider name. */
+    getPublicConfiguration(provider: string, auth?: AuthContext): Promise<IndexPublicConfig>;
+    /** Trigger a reindex. */
+    reindex(input: ReindexInput, auth?: AuthContext): Promise<void>;
+}
+
+type BaseUnit = {
+    /**
+     * The unit code.
+     */
+    code: string;
+    /**
+     * The name of the unit in the form of a map (language, value) or string.
+     */
+    name: string | {
+        [key: string]: string;
+    };
+    /**
+     * The type of a unit.
+     */
+    type: string;
+    /**
+     * The symbol of a unit.
+     */
+    symbol?: string;
+    /**
+     * The base unit flag.
+     */
+    baseUnit: boolean;
+    /**
+     * The conversion factor. The factor value must be greater than zero.
+     */
+    factor: number;
+};
+type Unit$1 = BaseUnit & {
+    metadata?: UnitMetadata;
+};
+type UpdateUnit = BaseUnit & {
+    metadata?: UpdateUnitMetadata;
+};
+/**
+ * The metadata of the unit.
+ */
+type UnitMetadata = {
+    /**
+     * The version of the document.
+     */
+    version?: number;
+    /**
+     * Timestamp of the unit creation compliant with the ISO 8601 standard.
+     */
+    createdAt?: string;
+    /**
+     * Timestamp of the unit last modification compliant with the ISO 8601 standard.
+     */
+    modifiedAt?: string;
+};
+/**
+ * The metadata of the unit.
+ */
+type UpdateUnitMetadata = {
+    /**
+     * The version of the document.
+     */
+    version?: number;
+};
+/**
+ * The input is the conversion parameters object containing the source unit code, target unit code, and the amount to convert (amount required for convert-unit, optional for conversion-factor).
+ */
+type ConversionFactorInput$1 = {
+    sourceUnitAmount?: number;
+    /**
+     * The source unit code.
+     */
+    sourceUnit: string;
+    /**
+     * The target unit code.
+     */
+    targetUnit: string;
+};
+/**
+ * The input payload for conversion. Contains the source unit code, target unit code, and optionally the source unit amount to convert.
+ */
+type ConversionInput = {
+    /**
+     * The source unit quantity.
+     */
+    sourceUnitAmount?: number;
+    /**
+     * The source unit code.
+     */
+    sourceUnit: string;
+    /**
+     * The target unit code.
+     */
+    targetUnit: string;
+};
+/**
+ * Output payload
+ */
+type ConversionFactorOutput = {
+    /**
+     * The conversion factor.
+     */
+    conversionFactor?: number;
+};
+/**
+ * Output payload. Contains the computed result of a conversion factor - conversionFactor (number) and unit conversion - targetUnitAmount (number) and targetUnit (string).
+ */
+type ConversionOutput = {
+    /**
+     * The amount in the target unit after conversion from the source unit.
+     */
+    targetUnitAmount?: number;
+    /**
+     * The target unit.
+     */
+    targetUnit?: string;
+};
+type ConversionFactorPayload = {
+    /**
+     * Optional client-generated identifier used to correlate a conversion command across request, response, and logs.
+     */
+    commandUuid?: string;
+    input: ConversionFactorInput$1;
+};
+type ConversionFactorResponse = {
+    commandUuid?: string;
+    input?: ConversionFactorInput$1;
+    output?: ConversionFactorOutput;
+};
+type ConversionPayload = {
+    commandUuid?: string;
+    input: ConversionInput;
+};
+type ConversionResponse = {
+    commandUuid?: string;
+    input?: ConversionInput;
+    output?: ConversionOutput;
+};
+type CreateUnitResponse = {
+    code?: string;
+};
+
+/**
+ * Public types for the Unit Handling Service — stable names aliased over the
+ * generated `unit-handling-service` types.
+ */
+
+/** A unit (read shape). */
+type Unit = Unit$1;
+/** Create body (`POST /units`). */
+type UnitInput = BaseUnit;
+/** Update body (`PUT /units/{code}`). */
+type UnitUpdate = UpdateUnit;
+/** `POST /units` response. */
+type UnitCreated = CreateUnitResponse;
+/** Body for `getConversionFactor`. */
+type ConversionFactorInput = ConversionFactorPayload;
+/** Result of `getConversionFactor`. */
+type ConversionFactorResult = ConversionFactorResponse;
+/** Body for `convertUnit`. */
+type ConvertUnitInput = ConversionPayload;
+/** Result of `convertUnit`. */
+type ConvertUnitResult = ConversionResponse;
+
+/**
+ * Emporix Unit Handling Service (`/unit-handling/{tenant}/…`): units CRUD, unit
+ * types, and conversion commands. Server-side; defaults to the service token.
+ */
+declare class UnitHandlingService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Find units (filter/sort/page). */
+    listUnits(query?: Record<string, string | number>, auth?: AuthContext): Promise<Unit[]>;
+    /** Retrieve a unit by code. */
+    getUnit(unitCode: string, auth?: AuthContext): Promise<Unit>;
+    /** Add a new unit. */
+    createUnit(input: UnitInput, auth?: AuthContext): Promise<UnitCreated>;
+    /** Update a unit by code. */
+    updateUnit(unitCode: string, input: UnitUpdate, auth?: AuthContext): Promise<void>;
+    /** Delete a unit by code. */
+    deleteUnit(unitCode: string, auth?: AuthContext): Promise<void>;
+    /** Delete multiple units by code (bulk). The codes are sent as the request body. */
+    deleteUnits(codes: string[], auth?: AuthContext): Promise<void>;
+    /** Fetch a conversion factor (`PUT /units/conversion-factor-commands`). */
+    getConversionFactor(input: ConversionFactorInput, auth?: AuthContext): Promise<ConversionFactorResult>;
+    /** Convert a value between units (`PUT /units/convert-unit-commands`). */
+    convertUnit(input: ConvertUnitInput, auth?: AuthContext): Promise<ConvertUnitResult>;
+    /** List all unit types. */
+    listUnitTypes(auth?: AuthContext): Promise<string[]>;
+}
+
 /** The Emporix SDK entry point. One instance safely serves many concurrent shoppers. */
 declare class EmporixClient {
     readonly customers: CustomerService;
@@ -2203,6 +5271,18 @@ declare class EmporixClient {
     readonly webhooks: WebhookService;
     readonly schemas: SchemaService;
     readonly ai: AiService;
+    readonly taxes: TaxService;
+    readonly coupons: CouponService;
+    readonly rewardPoints: RewardPointsService;
+    readonly brands: BrandService;
+    readonly labels: LabelService;
+    readonly countries: CountryService;
+    readonly currencies: CurrencyService;
+    readonly shipping: ShippingService;
+    readonly returns: ReturnsService;
+    readonly sepaExport: SepaExportService;
+    readonly indexing: IndexingService;
+    readonly units: UnitHandlingService;
     /** The validated tenant this client is bound to. */
     readonly tenant: string;
     /**
@@ -2229,4 +5309,4 @@ declare class EmporixClient {
     getLogLevel(service: ServiceName): LogLevel;
 }
 
-export { type Agent, type AgentInput, type AgentPatchOp, type AgentSearchQuery, AiService, AuthContext, AvailabilityService, type BatchNextIdEntry, CartService, CategoryService, type ChatRequest, type ChatResponse, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerGroupsService, CustomerService, type DeleteAgentOptions, type DeleteConfigOptions, EmporixAuthError, EmporixClient, EmporixConfig, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNotFoundError, EmporixServerError, EmporixValidationError, type Fee, type FeeDraft, FeeService, type InstanceSearchBody, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type JobIdResponse, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListSchemasQuery, LocationsService, LogLevel, MediaService, type MetadataFilter, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, OrdersService, PaginatedItems, PaymentGatewayService, PriceService, ProductService, RagIndexerService, type RagType, ResolvedConfig, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, SegmentService, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site, SiteService, TenantConfigService, type TextRequest, type TextResponse, TokenProvider, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, errorFromResponse };
+export { type AddedPoints, type Agent, type AgentInput, type AgentPatchOp, type AgentSearchQuery, AiService, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, CartService, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNotFoundError, EmporixServerError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListSchemasQuery, LocationsService, LogLevel, MediaService, type MetadataFilter, type MinimumFee, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, OrdersService, PaginatedItems, PaymentGatewayService, type PointsSummary, PriceService, ProductService, type QuoteInput, type QuoteResult, type QuoteSlotInput, RagIndexerService, type RagType, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexInput, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteList, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, TokenProvider, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, errorFromResponse };