@revenexx/sdk 0.0.4 → 0.0.5

package/types/services/orders.d.ts

@@ -1,5 +1,7 @@
 import { Client } from '../client';
 import type { Models } from '../models';
+import { OrderCommentVisibility } from '../enums/order-comment-visibility';
+import { OrderPaymentStatus } from '../enums/order-payment-status';
 export declare class Orders {
     client: Client;
     constructor(client: Client);
@@ -17,10 +19,45 @@ export declare class Orders {
     ordersNumberRangesList(): Promise<{}>;
     /**
      *
+     * @param {string} params.code - Range key drawn by the app ('order', 'delivery', 'return') — unique per tenant.
+     * @param {string} params.channelId -
+     * @param {number} params.counter - Current counter value (default 0) — the next number draws counter+step.
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {number} params.padding - Zero-padding width of the counter (default 6).
+     * @param {number} params.positionStep - Position numbering increment for order items (default 10).
+     * @param {string} params.prefix - Default ''.
+     * @param {number} params.step - Counter increment per drawn number (default 1).
+     * @param {string} params.suffix - Default ''.
      * @throws {RevenexxException}
      * @returns {Promise<Models.NumberRange>}
      */
-    ordersNumberRangesCreate(): Promise<Models.NumberRange>;
+    ordersNumberRangesCreate(params: {
+        code: string;
+        channelId?: string;
+        counter?: number;
+        metadata?: object;
+        padding?: number;
+        positionStep?: number;
+        prefix?: string;
+        step?: number;
+        suffix?: string;
+    }): Promise<Models.NumberRange>;
+    /**
+     *
+     * @param {string} code - Range key drawn by the app ('order', 'delivery', 'return') — unique per tenant.
+     * @param {string} channelId -
+     * @param {number} counter - Current counter value (default 0) — the next number draws counter+step.
+     * @param {object} metadata - Free-form metadata.
+     * @param {number} padding - Zero-padding width of the counter (default 6).
+     * @param {number} positionStep - Position numbering increment for order items (default 10).
+     * @param {string} prefix - Default ''.
+     * @param {number} step - Counter increment per drawn number (default 1).
+     * @param {string} suffix - Default ''.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.NumberRange>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    ordersNumberRangesCreate(code: string, channelId?: string, counter?: number, metadata?: object, padding?: number, positionStep?: number, prefix?: string, step?: number, suffix?: string): Promise<Models.NumberRange>;
     /**
      *
      * @throws {RevenexxException}
@@ -64,26 +101,112 @@ export declare class Orders {
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.channelId -
+     * @param {string} params.code - Range key drawn by the app ('order', 'delivery', 'return') — unique per tenant.
+     * @param {number} params.counter - Current counter value (default 0) — the next number draws counter+step.
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {number} params.padding - Zero-padding width of the counter (default 6).
+     * @param {number} params.positionStep - Position numbering increment for order items (default 10).
+     * @param {string} params.prefix - Default ''.
+     * @param {number} params.step - Counter increment per drawn number (default 1).
+     * @param {string} params.suffix - Default ''.
      * @throws {RevenexxException}
      * @returns {Promise<Models.NumberRange>}
      */
     ordersNumberRangesUpdate(params: {
         id: string;
+        channelId?: string;
+        code?: string;
+        counter?: number;
+        metadata?: object;
+        padding?: number;
+        positionStep?: number;
+        prefix?: string;
+        step?: number;
+        suffix?: string;
     }): Promise<Models.NumberRange>;
     /**
      *
      * @param {string} id -
+     * @param {string} channelId -
+     * @param {string} code - Range key drawn by the app ('order', 'delivery', 'return') — unique per tenant.
+     * @param {number} counter - Current counter value (default 0) — the next number draws counter+step.
+     * @param {object} metadata - Free-form metadata.
+     * @param {number} padding - Zero-padding width of the counter (default 6).
+     * @param {number} positionStep - Position numbering increment for order items (default 10).
+     * @param {string} prefix - Default ''.
+     * @param {number} step - Counter increment per drawn number (default 1).
+     * @param {string} suffix - Default ''.
      * @throws {RevenexxException}
      * @returns {Promise<Models.NumberRange>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersNumberRangesUpdate(id: string): Promise<Models.NumberRange>;
+    ordersNumberRangesUpdate(id: string, channelId?: string, code?: string, counter?: number, metadata?: object, padding?: number, positionStep?: number, prefix?: string, step?: number, suffix?: string): Promise<Models.NumberRange>;
+    /**
+     *
+     * @param {Models.OrderItemCreateRequest[]} params.items - The order positions (at most 500).
+     * @param {object} params.billingAddress - Frozen billing address.
+     * @param {object} params.buyer - Frozen buyer snapshot (name, email, …).
+     * @param {string} params.cartId - Source cart (the carts.order hand-over).
+     * @param {string} params.channelId -
+     * @param {string} params.contactId - Ordering customer contact.
+     * @param {string} params.currency - ISO 4217 code (default EUR).
+     * @param {string} params.customerOrderNumber - The buyer's own order/PO number.
+     * @param {number} params.grandTotal - Override — computed as subtotal + shipping + tax when omitted.
+     * @param {string} params.marketId -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {string} params.organizationId - B2B organization.
+     * @param {object} params.payment - Frozen payment snapshot — a known 'payment.status' seeds payment_status (otherwise 'open').
+     * @param {object} params.shipping - Frozen shipping snapshot — 'shipping.price' seeds shipping_total.
+     * @param {object} params.shippingAddress - Frozen shipping address.
+     * @param {number} params.shippingTotal - Shipping total (fallback when 'shipping.price' is absent).
+     * @param {object} params.userData - Free-form user data.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.OrderDetail>}
+     */
+    ordersPlace(params: {
+        items: Models.OrderItemCreateRequest[];
+        billingAddress?: object;
+        buyer?: object;
+        cartId?: string;
+        channelId?: string;
+        contactId?: string;
+        currency?: string;
+        customerOrderNumber?: string;
+        grandTotal?: number;
+        marketId?: string;
+        metadata?: object;
+        organizationId?: string;
+        payment?: object;
+        shipping?: object;
+        shippingAddress?: object;
+        shippingTotal?: number;
+        userData?: object;
+    }): Promise<Models.OrderDetail>;
     /**
      *
+     * @param {Models.OrderItemCreateRequest[]} items - The order positions (at most 500).
+     * @param {object} billingAddress - Frozen billing address.
+     * @param {object} buyer - Frozen buyer snapshot (name, email, …).
+     * @param {string} cartId - Source cart (the carts.order hand-over).
+     * @param {string} channelId -
+     * @param {string} contactId - Ordering customer contact.
+     * @param {string} currency - ISO 4217 code (default EUR).
+     * @param {string} customerOrderNumber - The buyer's own order/PO number.
+     * @param {number} grandTotal - Override — computed as subtotal + shipping + tax when omitted.
+     * @param {string} marketId -
+     * @param {object} metadata - Free-form metadata.
+     * @param {string} organizationId - B2B organization.
+     * @param {object} payment - Frozen payment snapshot — a known 'payment.status' seeds payment_status (otherwise 'open').
+     * @param {object} shipping - Frozen shipping snapshot — 'shipping.price' seeds shipping_total.
+     * @param {object} shippingAddress - Frozen shipping address.
+     * @param {number} shippingTotal - Shipping total (fallback when 'shipping.price' is absent).
+     * @param {object} userData - Free-form user data.
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderDetail>}
+     * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersPlace(): Promise<Models.OrderDetail>;
+    ordersPlace(items: Models.OrderItemCreateRequest[], billingAddress?: object, buyer?: object, cartId?: string, channelId?: string, contactId?: string, currency?: string, customerOrderNumber?: string, grandTotal?: number, marketId?: string, metadata?: object, organizationId?: string, payment?: object, shipping?: object, shippingAddress?: object, shippingTotal?: number, userData?: object): Promise<Models.OrderDetail>;
     /**
      *
      * @param {string} params.id -
@@ -104,54 +227,81 @@ export declare class Orders {
     /**
      *
      * @param {string} params.id -
+     * @param {object} params.billingAddress -
+     * @param {object} params.buyer -
+     * @param {string} params.customerOrderNumber -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {object} params.shippingAddress -
+     * @param {object} params.userData - Free-form user data.
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersUpdate(params: {
         id: string;
+        billingAddress?: object;
+        buyer?: object;
+        customerOrderNumber?: string;
+        metadata?: object;
+        shippingAddress?: object;
+        userData?: object;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {object} billingAddress -
+     * @param {object} buyer -
+     * @param {string} customerOrderNumber -
+     * @param {object} metadata - Free-form metadata.
+     * @param {object} shippingAddress -
+     * @param {object} userData - Free-form user data.
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersUpdate(id: string): Promise<Models.Order>;
+    ordersUpdate(id: string, billingAddress?: object, buyer?: object, customerOrderNumber?: string, metadata?: object, shippingAddress?: object, userData?: object): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.externalRef - The fulfilling system's order reference (e.g. the ERP order number).
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersAcknowledge(params: {
         id: string;
+        externalRef?: string;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {string} externalRef - The fulfilling system's order reference (e.g. the ERP order number).
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersAcknowledge(id: string): Promise<Models.Order>;
+    ordersAcknowledge(id: string, externalRef?: string): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.cancelledBy - Acting user/system.
+     * @param {string} params.reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersCancel(params: {
         id: string;
+        cancelledBy?: string;
+        reason?: string;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {string} cancelledBy - Acting user/system.
+     * @param {string} reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersCancel(id: string): Promise<Models.Order>;
+    ordersCancel(id: string, cancelledBy?: string, reason?: string): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
@@ -172,20 +322,29 @@ export declare class Orders {
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.body -
+     * @param {string} params.author -
+     * @param {OrderCommentVisibility} params.visibility - Default 'internal'.
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderComment>}
      */
     ordersCommentsCreate(params: {
         id: string;
+        body: string;
+        author?: string;
+        visibility?: OrderCommentVisibility;
     }): Promise<Models.OrderComment>;
     /**
      *
      * @param {string} id -
+     * @param {string} body -
+     * @param {string} author -
+     * @param {OrderCommentVisibility} visibility - Default 'internal'.
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderComment>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersCommentsCreate(id: string): Promise<Models.OrderComment>;
+    ordersCommentsCreate(id: string, body: string, author?: string, visibility?: OrderCommentVisibility): Promise<Models.OrderComment>;
     /**
      *
      * @param {string} params.id -
@@ -206,163 +365,226 @@ export declare class Orders {
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.reason - Why the order is blocked (shown on the shipping guard).
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersHold(params: {
         id: string;
+        reason?: string;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {string} reason - Why the order is blocked (shown on the shipping guard).
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersHold(id: string): Promise<Models.Order>;
+    ordersHold(id: string, reason?: string): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
+     * @param {Models.OrderCancelPosition[]} params.positions -
+     * @param {string} params.cancelledBy - Acting user/system.
+     * @param {string} params.reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersItemsCancel(params: {
         id: string;
+        positions: Models.OrderCancelPosition[];
+        cancelledBy?: string;
+        reason?: string;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {Models.OrderCancelPosition[]} positions -
+     * @param {string} cancelledBy - Acting user/system.
+     * @param {string} reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersItemsCancel(id: string): Promise<Models.Order>;
+    ordersItemsCancel(id: string, positions: Models.OrderCancelPosition[], cancelledBy?: string, reason?: string): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
+     * @param {OrderPaymentStatus} params.status - The new payment dimension value.
+     * @param {string} params.paymentId - Reference into the payment system — merged into the order's payment snapshot.
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersPaymentStatusUpdate(params: {
         id: string;
+        status: OrderPaymentStatus;
+        paymentId?: string;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {OrderPaymentStatus} status - The new payment dimension value.
+     * @param {string} paymentId - Reference into the payment system — merged into the order's payment snapshot.
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersPaymentStatusUpdate(id: string): Promise<Models.Order>;
+    ordersPaymentStatusUpdate(id: string, status: OrderPaymentStatus, paymentId?: string): Promise<Models.Order>;
     /**
      *
      * @param {string} params.id -
+     * @param {Models.OrderReturnPosition[]} params.positions -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {string} params.reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      */
     ordersReturn(params: {
         id: string;
+        positions: Models.OrderReturnPosition[];
+        metadata?: object;
+        reason?: string;
     }): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} id -
+     * @param {Models.OrderReturnPosition[]} positions -
+     * @param {object} metadata - Free-form metadata.
+     * @param {string} reason -
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersReturn(id: string): Promise<Models.OrderReturn>;
+    ordersReturn(id: string, positions: Models.OrderReturnPosition[], metadata?: object, reason?: string): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} params.id -
      * @param {string} params.rid -
+     * @param {string} params.resolution - How the return was settled (refund, replacement, …).
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      */
     ordersReturnsComplete(params: {
         id: string;
         rid: string;
+        resolution?: string;
     }): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} id -
      * @param {string} rid -
+     * @param {string} resolution - How the return was settled (refund, replacement, …).
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersReturnsComplete(id: string, rid: string): Promise<Models.OrderReturn>;
+    ordersReturnsComplete(id: string, rid: string, resolution?: string): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} params.id -
      * @param {string} params.rid -
+     * @param {object} params.data - Request body
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      */
     ordersReturnsReceive(params: {
         id: string;
         rid: string;
+        data: object;
     }): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} id -
      * @param {string} rid -
+     * @param {object} data - Request body
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersReturnsReceive(id: string, rid: string): Promise<Models.OrderReturn>;
+    ordersReturnsReceive(id: string, rid: string, data: object): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} params.id -
      * @param {string} params.rid -
+     * @param {string} params.reason - Fallback for 'resolution'.
+     * @param {string} params.resolution - Why the return was rejected.
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      */
     ordersReturnsReject(params: {
         id: string;
         rid: string;
+        reason?: string;
+        resolution?: string;
     }): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} id -
      * @param {string} rid -
+     * @param {string} reason - Fallback for 'resolution'.
+     * @param {string} resolution - Why the return was rejected.
      * @throws {RevenexxException}
      * @returns {Promise<Models.OrderReturn>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersReturnsReject(id: string, rid: string): Promise<Models.OrderReturn>;
+    ordersReturnsReject(id: string, rid: string, reason?: string, resolution?: string): Promise<Models.OrderReturn>;
     /**
      *
      * @param {string} params.id -
+     * @param {string} params.carrier -
+     * @param {object} params.metadata - Free-form metadata.
+     * @param {string} params.number - Delivery note number — drawn from the 'delivery' range when omitted.
+     * @param {Models.OrderShipmentPosition[]} params.positions - Omitted = every position with open quantity, in full.
+     * @param {string} params.shippedAt - Defaults to now.
+     * @param {string} params.trackingCode -
+     * @param {string} params.trackingUrl -
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
     ordersShip(params: {
         id: string;
+        carrier?: string;
+        metadata?: object;
+        number?: string;
+        positions?: Models.OrderShipmentPosition[];
+        shippedAt?: string;
+        trackingCode?: string;
+        trackingUrl?: string;
     }): Promise<{}>;
     /**
      *
      * @param {string} id -
+     * @param {string} carrier -
+     * @param {object} metadata - Free-form metadata.
+     * @param {string} number - Delivery note number — drawn from the 'delivery' range when omitted.
+     * @param {Models.OrderShipmentPosition[]} positions - Omitted = every position with open quantity, in full.
+     * @param {string} shippedAt - Defaults to now.
+     * @param {string} trackingCode -
+     * @param {string} trackingUrl -
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersShip(id: string): Promise<{}>;
+    ordersShip(id: string, carrier?: string, metadata?: object, number?: string, positions?: Models.OrderShipmentPosition[], shippedAt?: string, trackingCode?: string, trackingUrl?: string): Promise<{}>;
     /**
      *
      * @param {string} params.id -
+     * @param {object} params.data - Request body
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      */
     ordersUnhold(params: {
         id: string;
+        data: object;
     }): Promise<Models.Order>;
     /**
      *
      * @param {string} id -
+     * @param {object} data - Request body
      * @throws {RevenexxException}
      * @returns {Promise<Models.Order>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersUnhold(id: string): Promise<Models.Order>;
+    ordersUnhold(id: string, data: object): Promise<Models.Order>;
 }