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

package/lib/services/cart/types.d.ts

@@ -0,0 +1,236 @@
+/**
+ * DJUST SDK Cart Service - Types
+ * Type definitions for cart operations.
+ *
+ * @module services/cart/types
+ * @since 2.17.0
+ */
+import type { Pageable, PaginatedResponse } from "../types";
+/**
+ * Cart status values.
+ */
+export type CartStatus = "ACTIVE" | "ORDERED" | "ARCHIVED" | "DELETED";
+/**
+ * Cart type values.
+ */
+export type CartType = "CART" | "BUYING_LIST";
+/**
+ * Line update action.
+ */
+export type UpdateAction = "add" | "update" | "delete";
+/**
+ * Parameters for getting all carts.
+ */
+export interface GetCartsParams {
+    /** Currency for price display */
+    currency: string;
+    /** Pagination options */
+    pageable: Pageable;
+    /** Filter by cart status */
+    status?: CartStatus[];
+    /** Filter by cart type */
+    type?: CartType[];
+}
+/**
+ * Parameters for creating a cart.
+ */
+export interface CreateCartParams {
+    /** Cart name */
+    name: string;
+    /** Cart type (default: CART) */
+    type?: CartType;
+}
+/**
+ * Parameters for deleting a cart.
+ */
+export interface DeleteCartParams {
+    /** Cart ID to delete */
+    cartId: string;
+}
+/**
+ * Parameters for getting a cart.
+ */
+export interface GetCartParams {
+    /** Cart ID */
+    cartId: string;
+    /** Currency for price display */
+    currency: string;
+    /** Number of first lines to retrieve */
+    nbFirstLines?: number;
+}
+/**
+ * Parameters for updating a cart.
+ */
+export interface UpdateCartParams {
+    /** Cart ID */
+    cartId: string;
+    /** New cart name */
+    name: string;
+    /** Cart type */
+    type?: CartType;
+}
+/**
+ * Parameters for initializing orders from cart.
+ */
+export interface InitializeOrdersParams {
+    /** Cart ID */
+    cartId: string;
+}
+/**
+ * Parameters for getting cart lines.
+ */
+export interface GetCartLinesParams {
+    /** Cart ID */
+    cartId: string;
+    /** Currency for price display */
+    currency: string;
+    /** Pagination options */
+    pageable: Pageable;
+    /** Filter by supplier IDs */
+    supplierId?: string[];
+    /** Filter by product variant IDs */
+    productVariantId?: string[];
+    /** Filter by offer price IDs */
+    offerPriceId?: string[];
+}
+/**
+ * Line to add or update.
+ */
+export interface CartLineToAdd {
+    /** Offer price ID */
+    offerPriceId: string;
+    /** Quantity */
+    quantity: number;
+    /** Update action */
+    updateAction?: UpdateAction;
+}
+/**
+ * Line to add by variant.
+ */
+export interface CartLineToAddByVariant {
+    /** Product variant ID */
+    productVariantId: string;
+    /** Quantity */
+    quantity: number;
+    /** Update action */
+    updateAction?: UpdateAction;
+}
+/**
+ * Parameters for updating cart lines.
+ */
+export interface UpdateCartLinesParams {
+    /** Cart ID */
+    cartId: string;
+    /** Lines to update */
+    linesToUpdate: CartLineToAdd[];
+}
+/**
+ * Parameters for updating cart lines by variant.
+ */
+export interface UpdateCartLinesByVariantParams {
+    /** Cart ID */
+    cartId: string;
+    /** Lines to update */
+    linesToUpdate: CartLineToAddByVariant[];
+}
+/**
+ * Offer to delete.
+ */
+export interface OfferToDelete {
+    /** Offer price ID */
+    offerPriceId: string;
+}
+/**
+ * Parameters for deleting cart lines.
+ */
+export interface DeleteCartLinesParams {
+    /** Cart ID */
+    cartId: string;
+    /** Line IDs to delete */
+    lineIdsToDelete: string[];
+}
+/**
+ * Cart line item.
+ */
+export interface CartLine {
+    id: string;
+    offerPriceId: string;
+    productVariantId: string;
+    quantity: number;
+    unitPrice: number;
+    totalPrice: number;
+    productName: string;
+    sku: string;
+    supplierId: string;
+    supplierName: string;
+}
+/**
+ * Cart summary.
+ */
+export interface CartSummary {
+    id: string;
+    name: string;
+    type: CartType;
+    status: CartStatus;
+    totalItems: number;
+    totalPrice: number;
+    currency: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Full cart details.
+ */
+export interface Cart extends CartSummary {
+    lines: CartLine[];
+}
+/**
+ * Response for getting multiple carts.
+ */
+export interface GetCartsResponse extends PaginatedResponse<CartSummary> {
+}
+/**
+ * Response for creating a cart.
+ */
+export interface CreateCartResponse extends Cart {
+}
+/**
+ * Response for getting a cart.
+ */
+export interface GetCartResponse extends Cart {
+}
+/**
+ * Response for deleting carts.
+ */
+export interface DeleteCartsResponse {
+    deletedCount: number;
+    deletedIds: string[];
+}
+/**
+ * Response for getting cart lines.
+ */
+export interface GetCartLinesResponse extends PaginatedResponse<CartLine> {
+}
+/**
+ * Response for updating cart lines.
+ */
+export interface UpdateCartLinesResponse {
+    updatedLines: CartLine[];
+    errors?: Array<{
+        offerPriceId: string;
+        error: string;
+    }>;
+}
+/**
+ * Response for updating cart lines by variant.
+ */
+export interface UpdateCartLinesByVariantResponse extends UpdateCartLinesResponse {
+}
+/**
+ * Response for deleting cart lines.
+ */
+export interface DeleteCartLinesResponse {
+    deletedCount: number;
+    deletedIds: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/services/cart/types.d.ts.map

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

package/lib/services/cart/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * DJUST SDK Cart Service - Types
+ * Type definitions for cart operations.
+ *
+ * @module services/cart/types
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/services/cart/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/cart/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,435 @@
+/**
+ * # 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
+ */
+import { BaseService } from "../base.service";
+import type { RequestContext } from "../../client/transport";
+import type { GetCommercialOrdersParams, GetCommercialOrdersV2Params, CreateCommercialOrderParams, CreateCommercialOrderV2Params, GetCommercialOrderParams, UpdateCommercialOrderParams, CreateCardRegistrationParams, UpdateBillingInformationParams, SetStatusAsCreatedParams, SetStatusAsOnHoldParams, SyncCommercialOrderParams, GetPaymentPageUrlParams, CreatePreauthorizationParams, UpdateShippingAddressParams, UpdateShippingInformationParams, UpdateShippingTypeParams, DeleteCommercialOrderParams, GetCommercialOrderLinesParams, UpdateCommercialOrderLinesParams, DeleteCommercialOrderLinesParams, PunchoutOciParams, GetCommercialOrdersResponse, GetCommercialOrdersV2Response, CreateCommercialOrderResponse, CreateCommercialOrderV2Response, GetCommercialOrderResponse, CreateCardRegistrationResponse, CreatePreauthorizationResponse, GetCommercialOrderLinesResponse, UpdateCommercialOrderLinesResponse, DeleteCommercialOrderLinesResponse, SyncCommercialOrderResponse } from "./types";
+/**
+ * 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',
+ * });
+ * ```
+ */
+export declare class CommercialOrderService extends BaseService {
+    readonly 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
+     */
+    getCommercialOrders(params: GetCommercialOrdersParams, context?: RequestContext): Promise<GetCommercialOrdersResponse>;
+    /**
+     * 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
+     */
+    getCommercialOrdersV2(params: GetCommercialOrdersV2Params, context?: RequestContext): Promise<GetCommercialOrdersV2Response>;
+    /**
+     * 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
+     */
+    createCommercialOrder(params: CreateCommercialOrderParams, context?: RequestContext): Promise<CreateCommercialOrderResponse>;
+    /**
+     * 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
+     */
+    createCommercialOrderV2(params: CreateCommercialOrderV2Params, context?: RequestContext): Promise<CreateCommercialOrderV2Response>;
+    /**
+     * 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
+     */
+    getCommercialOrder(params: GetCommercialOrderParams, context?: RequestContext): Promise<GetCommercialOrderResponse>;
+    /**
+     * 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
+     */
+    updateCommercialOrder(params: UpdateCommercialOrderParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    createCardRegistration(params: CreateCardRegistrationParams, context?: RequestContext): Promise<CreateCardRegistrationResponse>;
+    /**
+     * 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
+     */
+    updateBillingInformation(params: UpdateBillingInformationParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    setStatusAsCreated(params: SetStatusAsCreatedParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    setStatusAsOnHold(params: SetStatusAsOnHoldParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    syncCommercialOrder(params: SyncCommercialOrderParams, context?: RequestContext): Promise<SyncCommercialOrderResponse>;
+    /**
+     * 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
+     */
+    getPaymentPageUrl(params: GetPaymentPageUrlParams, context?: RequestContext): Promise<string>;
+    /**
+     * 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
+     */
+    createPreauthorization(params: CreatePreauthorizationParams, context?: RequestContext): Promise<CreatePreauthorizationResponse>;
+    /**
+     * 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
+     */
+    updateShippingAddress(params: UpdateShippingAddressParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    updateShippingInformation(params: UpdateShippingInformationParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    updateShippingType(params: UpdateShippingTypeParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    deleteCommercialOrder(params: DeleteCommercialOrderParams, context?: RequestContext): Promise<void>;
+    /**
+     * 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
+     */
+    getCommercialOrderLines(params: GetCommercialOrderLinesParams, context?: RequestContext): Promise<GetCommercialOrderLinesResponse>;
+    /**
+     * 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
+     */
+    updateCommercialOrderLines(params: UpdateCommercialOrderLinesParams, context?: RequestContext): Promise<UpdateCommercialOrderLinesResponse>;
+    /**
+     * 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
+     */
+    deleteCommercialOrderLines(params: DeleteCommercialOrderLinesParams, context?: RequestContext): Promise<DeleteCommercialOrderLinesResponse>;
+    /**
+     * 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
+     */
+    punchoutOci(params: PunchoutOciParams, context?: RequestContext): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=commercial-order.service.d.ts.map