@djust-b2b/djust-front-sdk 3.0.0-beta.9 → 3.0.0

package/lib/services/commercial-order/commercial-order.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commercial-order.service.d.ts","sourceRoot":"","sources":["../../../src/services/commercial-order/commercial-order.service.ts"],"names":[],"mappings":"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"}

package/lib/services/commercial-order/commercial-order.service.js

@@ -0,0 +1,690 @@
+"use strict";
+/**
+ * # Commercial Order Service
+ *
+ * Complete order management for B2B commerce workflows.
+ *
+ * ## Features
+ * - Order creation and lifecycle management
+ * - Payment processing and card registration
+ * - Shipping and billing configuration
+ * - Order line management
+ * - Punchout/OCI integration
+ *
+ * @module services/commercial-order
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommercialOrderService = void 0;
+const base_service_1 = require("../base.service");
+const endpoints_1 = require("./endpoints");
+/**
+ * Service for commercial order management.
+ *
+ * Handles the complete order lifecycle from creation to fulfillment:
+ * - Order creation from carts or quotes
+ * - Payment processing
+ * - Shipping and billing configuration
+ * - Order status management
+ *
+ * @example
+ * ```typescript
+ * import { createDjustClient } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({ baseUrl, clientId, apiKey });
+ *
+ * // Get orders
+ * const { content: orders } = await client.commercialOrder.getCommercialOrdersV2({
+ *   locale: 'en-US',
+ *   page: 0,
+ *   size: 10,
+ * });
+ *
+ * // Get single order details
+ * const order = await client.commercialOrder.getCommercialOrder({
+ *   orderId: 'ORD-12345',
+ *   locale: 'en-US',
+ * });
+ * ```
+ */
+class CommercialOrderService extends base_service_1.BaseService {
+    constructor() {
+        super(...arguments);
+        this.serviceName = "commercial-order";
+    }
+    /**
+     * Get paginated list of commercial orders (v1).
+     *
+     * **Endpoint**: `GET /v1/shop/commercial-orders [ORD-100]`
+     *
+     * | Parameter            | Type       | Required | Description                    |
+     * |----------------------|------------|----------|--------------------------------|
+     * | `locale`             | `string`   | Yes      | Locale for translations        |
+     * | `page`               | `number`   | No       | Page number (0-based)          |
+     * | `size`               | `number`   | No       | Items per page                 |
+     * | `sort`               | `string`   | No       | Sort criteria                  |
+     * | `connectedUserOnly`  | `boolean`  | No       | Filter to current user's orders|
+     * | `customerAccountIds` | `string[]` | No       | Filter by customer accounts    |
+     * | `sourceTypes`        | `string[]` | No       | Filter by order source         |
+     * | `isValidated`        | `boolean`  | No       | Filter by validation status    |
+     *
+     * @param params - Query parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If locale is missing
+     * @returns Paginated order list
+     */
+    async getCommercialOrders(params, context) {
+        this.required(params, ["locale"]);
+        return this.request({
+            method: "GET",
+            path: endpoints_1.CommercialOrderEndpoints.ORDERS_V1,
+            params: this.buildParams({
+                locale: params.locale,
+                nbPreviewLines: params.nbPreviewLines,
+                page: params.page,
+                size: params.size,
+                sort: params.sort,
+                connectedUserOnly: params.connectedUserOnly,
+                customerAccountIds: params.customerAccountIds,
+                sourceTypes: params.sourceTypes,
+                isValidated: params.isValidated,
+            }),
+        }, context);
+    }
+    /**
+     * Get paginated list of commercial orders (v2).
+     *
+     * Enhanced version with additional filtering capabilities.
+     *
+     * **Endpoint**: `GET /v2/shop/commercial-orders [ORD-101]`
+     *
+     * | Parameter            | Type       | Required | Description                    |
+     * |----------------------|------------|----------|--------------------------------|
+     * | `locale`             | `string`   | Yes      | Locale for translations        |
+     * | `page`               | `number`   | No       | Page number (0-based)          |
+     * | `size`               | `number`   | No       | Items per page                 |
+     * | `sort`               | `string`   | No       | Sort criteria                  |
+     * | `sourceIds`          | `string[]` | No       | Filter by source IDs           |
+     * | `sourceTypes`        | `string[]` | No       | Filter by source types         |
+     *
+     * @example
+     * ```typescript
+     * const { content: orders, totalElements } = await client.commercialOrder.getCommercialOrdersV2({
+     *   locale: 'fr-FR',
+     *   page: 0,
+     *   size: 20,
+     *   sort: 'createdAt,desc',
+     * });
+     *
+     * orders.forEach(order => {
+     *   console.log(`${order.businessId}: ${order.status} - ${order.total}`);
+     * });
+     * ```
+     *
+     * @param params - Query parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If locale is missing
+     * @returns Paginated order list
+     */
+    async getCommercialOrdersV2(params, context) {
+        this.required(params, ["locale"]);
+        return this.request({
+            method: "GET",
+            path: endpoints_1.CommercialOrderEndpoints.ORDERS_V2,
+            params: this.buildParams({
+                page: params.page,
+                size: params.size,
+                sort: params.sort,
+                locale: params.locale,
+                connectedUserOnly: params.connectedUserOnly,
+                customerAccountIds: params.customerAccountIds,
+                sourceTypes: params.sourceTypes,
+                sourceIds: params.sourceIds,
+                isValidated: params.isValidated,
+                nbPreviewLines: params.nbPreviewLines,
+            }),
+        }, context);
+    }
+    /**
+     * Create a new commercial order from a cart or quote.
+     *
+     * **Endpoint**: `POST /v1/shop/commercial-orders [ORD-102]`
+     *
+     * | Parameter      | Type     | Required | Description                    |
+     * |----------------|----------|----------|--------------------------------|
+     * | `locale`       | `string` | Yes      | Locale for the order           |
+     * | `origin`       | `string` | Yes      | Origin type (CART, QUOTE)      |
+     * | `originId`     | `string` | Yes      | ID of the cart or quote        |
+     * | `channel`      | `string` | No       | Sales channel                  |
+     * | `customFields` | `object` | No       | Custom field values            |
+     * | `paymentInfo`  | `object` | No       | Payment configuration          |
+     *
+     * @example
+     * ```typescript
+     * const order = await client.commercialOrder.createCommercialOrder({
+     *   locale: 'en-US',
+     *   origin: 'CART',
+     *   originId: 'cart-123',
+     *   paymentInfo: { method: 'INVOICE' },
+     * });
+     *
+     * console.log(`Order created: ${order.businessId}`);
+     * ```
+     *
+     * @param params - Order creation parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Created order details
+     */
+    async createCommercialOrder(params, context) {
+        this.required(params, ["locale", "origin", "originId"]);
+        return this.request({
+            method: "POST",
+            path: endpoints_1.CommercialOrderEndpoints.ORDERS_V1,
+            params: this.buildParams({ nbPreviewLines: params.nbPreviewLines }),
+            body: {
+                channel: params.channel,
+                customFields: params.customFields,
+                locale: params.locale,
+                origin: params.origin,
+                originId: params.originId,
+                paymentInfo: params.paymentInfo,
+            },
+        }, context);
+    }
+    /**
+     * Create a commercial order (v2).
+     *
+     * Enhanced creation endpoint with more flexibility.
+     *
+     * **Endpoint**: `POST /v2/shop/commercial-orders [ORD-103]`
+     *
+     * | Parameter           | Type     | Required | Description                    |
+     * |---------------------|----------|----------|--------------------------------|
+     * | `sourceType`        | `string` | No       | Source type (CART, QUOTE)      |
+     * | `sourceId`          | `string` | No       | Source ID                      |
+     * | `customFields`      | `object` | No       | Custom field values            |
+     * | `customFieldIdType` | `string` | No       | ID type for custom fields      |
+     * | `isFull`            | `boolean`| No       | Include full order details     |
+     *
+     * @param params - Order creation parameters
+     * @param context - Optional SSR request context
+     * @returns Created order details
+     */
+    async createCommercialOrderV2(params, context) {
+        return this.request({
+            method: "POST",
+            path: endpoints_1.CommercialOrderEndpoints.ORDERS_V2,
+            body: {
+                customFieldIdType: params.customFieldIdType,
+                customFields: params.customFields,
+                isFull: params.isFull,
+                sourceId: params.sourceId,
+                sourceType: params.sourceType,
+            },
+        }, context);
+    }
+    /**
+     * Get detailed information about a specific order.
+     *
+     * **Endpoint**: `GET /v1/shop/commercial-orders/{orderId} [ORD-104]`
+     *
+     * | Parameter  | Type     | Required | Description                    |
+     * |------------|----------|----------|--------------------------------|
+     * | `orderId`  | `string` | Yes      | Order ID or business ID        |
+     * | `locale`   | `string` | Yes      | Locale for translations        |
+     * | `idType`   | `string` | No       | ID type (id, businessId)       |
+     *
+     * @example
+     * ```typescript
+     * const order = await client.commercialOrder.getCommercialOrder({
+     *   orderId: 'ORD-2024-001234',
+     *   locale: 'en-US',
+     *   idType: 'businessId',
+     * });
+     *
+     * console.log(`Order: ${order.businessId}`);
+     * console.log(`Status: ${order.status}`);
+     * console.log(`Total: ${order.totalAmount} ${order.currency}`);
+     * ```
+     *
+     * @param params - Order identification parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @throws {NotFoundError} If order doesn't exist
+     * @returns Full order details
+     */
+    async getCommercialOrder(params, context) {
+        this.required(params, ["orderId", "locale"]);
+        return this.request({
+            method: "GET",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.ORDER_V1, {
+                orderId: params.orderId,
+            }),
+            params: this.buildParams({
+                locale: params.locale,
+                idType: params.idType,
+                nbPreviewLines: params.nbPreviewLines,
+            }),
+        }, context);
+    }
+    /**
+     * Update commercial order custom fields.
+     *
+     * **Endpoint**: `PUT /v2/shop/commercial-orders/{orderId} [ORD-105]`
+     *
+     * @param params - Update parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If commercialOrderId is missing
+     */
+    async updateCommercialOrder(params, context) {
+        this.required(params, ["commercialOrderId"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.ORDER_V2, {
+                commercialOrderId: params.commercialOrderId,
+            }),
+            body: {
+                customFieldIdType: params.customFieldIdType,
+                customFields: params.customFields,
+            },
+        }, context);
+    }
+    /**
+     * Create a card registration for payment.
+     *
+     * Initiates the card registration process with the payment provider.
+     *
+     * **Endpoint**: `POST /v1/shop/commercial-orders/{orderId}/card-registration [PAY-100]`
+     *
+     * | Parameter         | Type     | Required | Description              |
+     * |-------------------|----------|----------|--------------------------|
+     * | `orderId`         | `string` | Yes      | Order ID                 |
+     * | `paymentProvider` | `string` | Yes      | Provider (MANGOPAY, etc) |
+     * | `currency`        | `string` | Yes      | Currency code            |
+     *
+     * @example
+     * ```typescript
+     * const registration = await client.commercialOrder.createCardRegistration({
+     *   orderId: 'order-123',
+     *   paymentProvider: 'MANGOPAY',
+     *   currency: 'EUR',
+     * });
+     *
+     * // Use registration data to tokenize card
+     * console.log(registration.cardRegistrationUrl);
+     * ```
+     *
+     * @param params - Card registration parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Card registration details
+     */
+    async createCardRegistration(params, context) {
+        this.required(params, ["orderId", "paymentProvider", "currency"]);
+        return this.request({
+            method: "POST",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.CARD_REGISTRATION, {
+                orderId: params.orderId,
+            }),
+            body: {
+                paymentProvider: params.paymentProvider,
+                currency: params.currency,
+            },
+        }, context);
+    }
+    /**
+     * Update billing information for an order.
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/billing-information [ORD-106]`
+     *
+     * | Parameter          | Type     | Required | Description              |
+     * |--------------------|----------|----------|--------------------------|
+     * | `orderId`          | `string` | Yes      | Order ID                 |
+     * | `billingAddressId` | `string` | Yes      | Billing address ID       |
+     *
+     * @param params - Billing update parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     */
+    async updateBillingInformation(params, context) {
+        this.required(params, ["orderId", "billingAddressId"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.BILLING_INFORMATION, {
+                orderId: params.orderId,
+            }),
+            body: { billingAddressId: params.billingAddressId },
+        }, context);
+    }
+    /**
+     * Set order status to CREATED (finalize order).
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/set-status-as-created [ORD-107]`
+     *
+     * @example
+     * ```typescript
+     * await client.commercialOrder.setStatusAsCreated({
+     *   orderId: 'order-123',
+     *   paymentInfo: { method: 'CARD', transactionId: 'txn-456' },
+     * });
+     * ```
+     *
+     * @param params - Status update parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If orderId is missing
+     */
+    async setStatusAsCreated(params, context) {
+        this.required(params, ["orderId"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.STATUS_CREATED, {
+                orderId: params.orderId,
+            }),
+            body: params.paymentInfo ?? null,
+        }, context);
+    }
+    /**
+     * Set order status to ON_HOLD.
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/set-status-as-hold [ORD-108]`
+     *
+     * @param params - Order identification
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If orderId is missing
+     */
+    async setStatusAsOnHold(params, context) {
+        this.required(params, ["orderId"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.STATUS_HOLD, {
+                orderId: params.orderId,
+            }),
+        }, context);
+    }
+    /**
+     * Synchronize order with external systems (ORDER-223).
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/sync`
+     *
+     * Returns the set of synchronisation warnings. Empty array if no warning.
+     *
+     * @param params - Order identification (REFERENCE only; business/external IDs not supported)
+     * @param context - Optional SSR request context
+     * @returns Synchronisation warnings; empty array if none
+     * @throws {ValidationError} If orderId is missing
+     */
+    async syncCommercialOrder(params, context) {
+        this.required(params, ["orderId"]);
+        return this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.SYNC, {
+                orderId: params.orderId,
+            }),
+            body: {},
+        }, context);
+    }
+    /**
+     * Get payment page URL for online payment.
+     *
+     * **Endpoint**: `GET /v1/shop/commercial-orders/{orderId}/payment-page [PAY-101]`
+     *
+     * | Parameter         | Type     | Required | Description              |
+     * |-------------------|----------|----------|--------------------------|
+     * | `orderId`         | `string` | Yes      | Order ID                 |
+     * | `paymentOption`   | `string` | Yes      | Payment option selected  |
+     * | `paymentProvider` | `string` | No       | Specific provider        |
+     *
+     * @example
+     * ```typescript
+     * const paymentUrl = await client.commercialOrder.getPaymentPageUrl({
+     *   orderId: 'order-123',
+     *   paymentOption: 'CARD',
+     * });
+     *
+     * // Redirect user to payment page
+     * window.location.href = paymentUrl;
+     * ```
+     *
+     * @param params - Payment page parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Payment page URL
+     */
+    async getPaymentPageUrl(params, context) {
+        this.required(params, ["orderId", "paymentOption"]);
+        const response = await this.request({
+            method: "GET",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.PAYMENT_PAGE, {
+                orderId: params.orderId,
+            }),
+            params: this.buildParams({
+                paymentOption: params.paymentOption,
+                paymentProvider: params.paymentProvider,
+            }),
+        }, context);
+        return response.url;
+    }
+    /**
+     * Create a payment preauthorization.
+     *
+     * **Endpoint**: `POST /v1/shop/commercial-orders/{orderId}/preauthorization [PAY-102]`
+     *
+     * @param params - Preauthorization parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Preauthorization result
+     */
+    async createPreauthorization(params, context) {
+        this.required(params, ["orderId", "paymentProvider", "paymentCardInfo"]);
+        return this.request({
+            method: "POST",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.PREAUTHORIZATION, {
+                orderId: params.orderId,
+            }),
+            body: {
+                paymentProvider: params.paymentProvider,
+                authorId: params.authorId,
+                browserInfo: params.browserInfo,
+                ipAddress: params.ipAddress,
+                paymentCardInfo: params.paymentCardInfo,
+            },
+        }, context);
+    }
+    /**
+     * Update shipping address for an order.
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/shipping-address [ORD-110]`
+     *
+     * @param params - Shipping address update parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     */
+    async updateShippingAddress(params, context) {
+        this.required(params, ["orderId", "shippingAddressId"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.SHIPPING_ADDRESS, {
+                orderId: params.orderId,
+            }),
+            body: { shippingAddressId: params.shippingAddressId },
+        }, context);
+    }
+    /**
+     * Update complete shipping information.
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/shipping-information [ORD-111]`
+     *
+     * @param params - Shipping information parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     */
+    async updateShippingInformation(params, context) {
+        this.required(params, ["orderId", "shippingAddressId", "shippingType"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.SHIPPING_INFORMATION, {
+                orderId: params.orderId,
+            }),
+            body: {
+                shippingAddressId: params.shippingAddressId,
+                shippingType: params.shippingType,
+            },
+        }, context);
+    }
+    /**
+     * Update shipping type only.
+     *
+     * **Endpoint**: `PUT /v1/shop/commercial-orders/{orderId}/shipping-type [ORD-112]`
+     *
+     * @param params - Shipping type parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     */
+    async updateShippingType(params, context) {
+        this.required(params, ["orderId", "shippingType"]);
+        await this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.SHIPPING_TYPE, {
+                orderId: params.orderId,
+            }),
+            body: { shippingType: params.shippingType },
+        }, context);
+    }
+    /**
+     * Delete a commercial order.
+     *
+     * **Endpoint**: `DELETE /v2/shop/commercial-orders/{orderId} [ORD-113]`
+     *
+     * @param params - Order identification
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If commercialOrderId is missing
+     * @throws {NotFoundError} If order doesn't exist
+     */
+    async deleteCommercialOrder(params, context) {
+        this.required(params, ["commercialOrderId"]);
+        await this.request({
+            method: "DELETE",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.ORDER_V2, {
+                commercialOrderId: params.commercialOrderId,
+            }),
+        }, context);
+    }
+    /**
+     * Get order lines with pagination.
+     *
+     * **Endpoint**: `GET /v1/shop/commercial-orders/{orderId}/lines [ORD-114]`
+     *
+     * @example
+     * ```typescript
+     * const { content: lines } = await client.commercialOrder.getCommercialOrderLines({
+     *   commercialOrderId: 'order-123',
+     *   page: 0,
+     *   size: 50,
+     *   locale: 'en-US',
+     * });
+     *
+     * lines.forEach(line => {
+     *   console.log(`${line.productName}: ${line.quantity} x ${line.unitPrice}`);
+     * });
+     * ```
+     *
+     * @param params - Query parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If commercialOrderId is missing
+     * @returns Paginated order lines
+     */
+    async getCommercialOrderLines(params, context) {
+        this.required(params, ["commercialOrderId"]);
+        return this.request({
+            method: "GET",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.LINES_V1, {
+                commercialOrderId: params.commercialOrderId,
+            }),
+            params: this.buildParams({
+                page: params.page,
+                size: params.size,
+                sort: params.sort,
+                supplierIds: params.supplierIds,
+                productVariantIds: params.productVariantIds,
+                offerPriceIds: params.offerPriceIds,
+                idType: params.idType,
+                locale: params.locale,
+            }),
+        }, context);
+    }
+    /**
+     * Update order lines (quantities, custom fields).
+     *
+     * **Endpoint**: `PUT /v2/shop/commercial-orders/{orderId}/lines [ORD-115]`
+     *
+     * @param params - Update parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If commercialOrderId is missing
+     * @returns Updated lines information
+     */
+    async updateCommercialOrderLines(params, context) {
+        this.required(params, ["commercialOrderId"]);
+        return this.request({
+            method: "PUT",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.LINES_V2, {
+                commercialOrderId: params.commercialOrderId,
+            }),
+            body: {
+                customFieldIdType: params.customFieldIdType,
+                lineIdType: params.lineIdType,
+                lineType: params.lineType,
+                updateOrderCommercialLines: params.updateOrderCommercialLines,
+                metadata: params.metadata,
+            },
+        }, context);
+    }
+    /**
+     * Delete order lines.
+     *
+     * **Endpoint**: `DELETE /v2/shop/commercial-orders/{orderId}/lines [ORD-116]`
+     *
+     * @param params - Deletion parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If commercialOrderId is missing
+     * @returns Deletion result
+     */
+    async deleteCommercialOrderLines(params, context) {
+        this.required(params, ["commercialOrderId"]);
+        return this.request({
+            method: "DELETE",
+            path: this.buildPath(endpoints_1.CommercialOrderEndpoints.LINES_V2, {
+                commercialOrderId: params.commercialOrderId,
+            }),
+            body: params.body || [],
+        }, context);
+    }
+    /**
+     * Get OCI punchout data for procurement integration.
+     *
+     * Returns order data in OCI format for SAP Ariba, Coupa, etc.
+     *
+     * **Endpoint**: `GET /cxml/punchout/oci/{configKey}/commercial-orders/{orderId} [PUNCHOUT-100]`
+     *
+     * | Parameter                  | Type     | Required | Description              |
+     * |---------------------------|----------|----------|--------------------------|
+     * | `commercialOrderId`       | `string` | Yes      | Order ID                 |
+     * | `tenantConfigurationKey`  | `string` | Yes      | OCI configuration key    |
+     * | `locale`                  | `string` | No       | Locale for data          |
+     *
+     * @param params - Punchout parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns OCI field mapping for the order
+     */
+    async punchoutOci(params, context) {
+        this.required(params, ["commercialOrderId", "tenantConfigurationKey"]);
+        return this.request({
+            method: "GET",
+            path: `/cxml/punchout/oci/${params.tenantConfigurationKey}/commercial-orders/${params.commercialOrderId}`,
+            params: this.buildParams({ locale: params.locale }),
+        }, context);
+    }
+}
+exports.CommercialOrderService = CommercialOrderService;
+//# sourceMappingURL=commercial-order.service.js.map