@congminh1254/shopee-sdk 0.10.0 → 1.0.0

package/lib/managers/returns.manager.d.ts

@@ -0,0 +1,200 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetReturnListParams, GetReturnListResponse, GetReturnDetailParams, GetReturnDetailResponse, ConfirmParams, ConfirmResponse, DisputeParams, DisputeResponse, OfferParams, OfferResponse, AcceptOfferParams, AcceptOfferResponse, GetAvailableSolutionsParams, GetAvailableSolutionsResponse, CancelDisputeParams, CancelDisputeResponse, GetReturnDisputeReasonParams, GetReturnDisputeReasonResponse, ConvertImageParams, ConvertImageResponse, UploadProofParams, UploadProofResponse, QueryProofParams, QueryProofResponse, GetShippingCarrierParams, GetShippingCarrierResponse, UploadShippingProofParams, UploadShippingProofResponse } from "../schemas/returns.js";
+export declare class ReturnsManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Use this API to get detail information of many returns by shop ID.
+     *
+     * @param params - Parameters for getting return list
+     * @param params.page_no - Page number (required)
+     * @param params.page_size - Page size, max 100 (required)
+     * @param params.create_time_from - Filter by create time from (timestamp)
+     * @param params.create_time_to - Filter by create time to (timestamp)
+     * @param params.update_time_from - Filter by update time from (timestamp)
+     * @param params.update_time_to - Filter by update time to (timestamp)
+     * @param params.status - Filter by return status
+     * @param params.negotiation_status - Filter by negotiation status
+     * @param params.seller_proof_status - Filter by seller proof status
+     * @param params.seller_compensation_status - Filter by seller compensation status
+     *
+     * @returns A promise that resolves to the return list response containing:
+     * - more: Whether there are more pages
+     * - return: List of return details
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getReturnList(params: GetReturnListParams): Promise<GetReturnListResponse>;
+    /**
+     * Use this API to get detail information of a return by return serial number.
+     *
+     * @param params - Parameters for getting return detail
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the return detail response containing:
+     * - Complete return information including items, user, status, etc.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getReturnDetail(params: GetReturnDetailParams): Promise<GetReturnDetailResponse>;
+    /**
+     * Confirm refund for a return request.
+     *
+     * @param params - Parameters for confirming return
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the confirm response containing:
+     * - return_sn: The confirmed return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    confirm(params: ConfirmParams): Promise<ConfirmResponse>;
+    /**
+     * Dispute a return request. Support raising dispute when return_status is REQUESTED/PROCESSING/ACCEPTED.
+     *
+     * @param params - Parameters for disputing return
+     * @param params.return_sn - Return serial number (required)
+     * @param params.email - Email for contact (required)
+     * @param params.dispute_reason - Dispute reason ID (required)
+     * @param params.dispute_text_reason - Text explanation for dispute
+     * @param params.images - Image URLs for dispute evidence
+     *
+     * @returns A promise that resolves to the dispute response containing:
+     * - return_sn: The disputed return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    dispute(params: DisputeParams): Promise<DisputeResponse>;
+    /**
+     * Offer a solution to the buyer during negotiation.
+     *
+     * @param params - Parameters for offering solution
+     * @param params.return_sn - Return serial number (required)
+     * @param params.solution - Solution to offer (required)
+     * @param params.refund_amount - Refund amount (if applicable)
+     *
+     * @returns A promise that resolves to the offer response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    offer(params: OfferParams): Promise<OfferResponse>;
+    /**
+     * Accept an offer from the buyer.
+     *
+     * @param params - Parameters for accepting offer
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the accept offer response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    acceptOffer(params: AcceptOfferParams): Promise<AcceptOfferResponse>;
+    /**
+     * Get the available solutions offered to buyers.
+     *
+     * @param params - Parameters for getting available solutions
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the available solutions response containing:
+     * - solution: List of available solution options with max refund amounts
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getAvailableSolutions(params: GetAvailableSolutionsParams): Promise<GetAvailableSolutionsResponse>;
+    /**
+     * Cancel a compensation dispute. Sellers can only cancel compensation disputes, not normal disputes.
+     * This means sellers can only cancel disputes when return_status is ACCEPTED and compensation_status is COMPENSATION_REQUESTED.
+     *
+     * @param params - Parameters for cancelling dispute
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the cancel dispute response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    cancelDispute(params: CancelDisputeParams): Promise<CancelDisputeResponse>;
+    /**
+     * Get the dispute return reasons available for a return.
+     *
+     * @param params - Parameters for getting dispute reasons
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the dispute reason response containing:
+     * - dispute_reason: List of available dispute reasons with IDs and text
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getReturnDisputeReason(params: GetReturnDisputeReasonParams): Promise<GetReturnDisputeReasonResponse>;
+    /**
+     * Convert image files to URLs. Supports specific formats and pictures within 10MB.
+     *
+     * @param params - Parameters for converting images
+     * @param params.images - Array of images to convert (required)
+     *
+     * @returns A promise that resolves to the convert image response containing:
+     * - images: Array of converted image URLs
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    convertImage(params: ConvertImageParams): Promise<ConvertImageResponse>;
+    /**
+     * Upload evidence for a return, including text, pictures, and videos.
+     *
+     * @param params - Parameters for uploading proof
+     * @param params.return_sn - Return serial number (required)
+     * @param params.proof_text - Array of text evidence
+     * @param params.proof_image - Array of image URLs as evidence
+     * @param params.proof_video - Array of video URLs as evidence
+     *
+     * @returns A promise that resolves to the upload proof response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    uploadProof(params: UploadProofParams): Promise<UploadProofResponse>;
+    /**
+     * Query the evidence uploaded through the upload evidence API.
+     *
+     * @param params - Parameters for querying proof
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the query proof response containing:
+     * - proof_text: Uploaded text evidence
+     * - proof_image: Uploaded image evidence
+     * - proof_video: Uploaded video evidence
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    queryProof(params: QueryProofParams): Promise<QueryProofResponse>;
+    /**
+     * Get the list of shipping carriers and required parameters for uploading shipping proof.
+     * Only for TW and BR returns with is_seller_arrange = true.
+     *
+     * @param params - Parameters for getting shipping carriers
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the shipping carrier response containing:
+     * - carrier_list: List of available shipping carriers with required fields
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getShippingCarrier(params: GetShippingCarrierParams): Promise<GetShippingCarrierResponse>;
+    /**
+     * Upload shipping proof for seller-arranged returns.
+     * Only for TW and BR returns with is_seller_arrange = true. This is not to upload evidence for disputes.
+     *
+     * @param params - Parameters for uploading shipping proof
+     * @param params.return_sn - Return serial number (required)
+     * @param params.carrier_id - Carrier ID (required)
+     * @param params.tracking_number - Tracking number (required)
+     *
+     * @returns A promise that resolves to the upload shipping proof response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    uploadShippingProof(params: UploadShippingProofParams): Promise<UploadShippingProofResponse>;
+}

package/lib/managers/returns.manager.js

@@ -0,0 +1,300 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class ReturnsManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Use this API to get detail information of many returns by shop ID.
+     *
+     * @param params - Parameters for getting return list
+     * @param params.page_no - Page number (required)
+     * @param params.page_size - Page size, max 100 (required)
+     * @param params.create_time_from - Filter by create time from (timestamp)
+     * @param params.create_time_to - Filter by create time to (timestamp)
+     * @param params.update_time_from - Filter by update time from (timestamp)
+     * @param params.update_time_to - Filter by update time to (timestamp)
+     * @param params.status - Filter by return status
+     * @param params.negotiation_status - Filter by negotiation status
+     * @param params.seller_proof_status - Filter by seller proof status
+     * @param params.seller_compensation_status - Filter by seller compensation status
+     *
+     * @returns A promise that resolves to the return list response containing:
+     * - more: Whether there are more pages
+     * - return: List of return details
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getReturnList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/get_return_list", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Use this API to get detail information of a return by return serial number.
+     *
+     * @param params - Parameters for getting return detail
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the return detail response containing:
+     * - Complete return information including items, user, status, etc.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getReturnDetail(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/get_return_detail", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Confirm refund for a return request.
+     *
+     * @param params - Parameters for confirming return
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the confirm response containing:
+     * - return_sn: The confirmed return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async confirm(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/confirm", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Dispute a return request. Support raising dispute when return_status is REQUESTED/PROCESSING/ACCEPTED.
+     *
+     * @param params - Parameters for disputing return
+     * @param params.return_sn - Return serial number (required)
+     * @param params.email - Email for contact (required)
+     * @param params.dispute_reason - Dispute reason ID (required)
+     * @param params.dispute_text_reason - Text explanation for dispute
+     * @param params.images - Image URLs for dispute evidence
+     *
+     * @returns A promise that resolves to the dispute response containing:
+     * - return_sn: The disputed return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async dispute(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/dispute", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Offer a solution to the buyer during negotiation.
+     *
+     * @param params - Parameters for offering solution
+     * @param params.return_sn - Return serial number (required)
+     * @param params.solution - Solution to offer (required)
+     * @param params.refund_amount - Refund amount (if applicable)
+     *
+     * @returns A promise that resolves to the offer response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async offer(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/offer", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Accept an offer from the buyer.
+     *
+     * @param params - Parameters for accepting offer
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the accept offer response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async acceptOffer(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/accept_offer", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get the available solutions offered to buyers.
+     *
+     * @param params - Parameters for getting available solutions
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the available solutions response containing:
+     * - solution: List of available solution options with max refund amounts
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getAvailableSolutions(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/get_available_solutions", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Cancel a compensation dispute. Sellers can only cancel compensation disputes, not normal disputes.
+     * This means sellers can only cancel disputes when return_status is ACCEPTED and compensation_status is COMPENSATION_REQUESTED.
+     *
+     * @param params - Parameters for cancelling dispute
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the cancel dispute response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async cancelDispute(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/cancel_dispute", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get the dispute return reasons available for a return.
+     *
+     * @param params - Parameters for getting dispute reasons
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the dispute reason response containing:
+     * - dispute_reason: List of available dispute reasons with IDs and text
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getReturnDisputeReason(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/get_return_dispute_reason", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Convert image files to URLs. Supports specific formats and pictures within 10MB.
+     *
+     * @param params - Parameters for converting images
+     * @param params.images - Array of images to convert (required)
+     *
+     * @returns A promise that resolves to the convert image response containing:
+     * - images: Array of converted image URLs
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async convertImage(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/convert_image", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Upload evidence for a return, including text, pictures, and videos.
+     *
+     * @param params - Parameters for uploading proof
+     * @param params.return_sn - Return serial number (required)
+     * @param params.proof_text - Array of text evidence
+     * @param params.proof_image - Array of image URLs as evidence
+     * @param params.proof_video - Array of video URLs as evidence
+     *
+     * @returns A promise that resolves to the upload proof response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async uploadProof(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/upload_proof", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Query the evidence uploaded through the upload evidence API.
+     *
+     * @param params - Parameters for querying proof
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the query proof response containing:
+     * - proof_text: Uploaded text evidence
+     * - proof_image: Uploaded image evidence
+     * - proof_video: Uploaded video evidence
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async queryProof(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/query_proof", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get the list of shipping carriers and required parameters for uploading shipping proof.
+     * Only for TW and BR returns with is_seller_arrange = true.
+     *
+     * @param params - Parameters for getting shipping carriers
+     * @param params.return_sn - Return serial number (required)
+     *
+     * @returns A promise that resolves to the shipping carrier response containing:
+     * - carrier_list: List of available shipping carriers with required fields
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getShippingCarrier(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/get_shipping_carrier", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Upload shipping proof for seller-arranged returns.
+     * Only for TW and BR returns with is_seller_arrange = true. This is not to upload evidence for disputes.
+     *
+     * @param params - Parameters for uploading shipping proof
+     * @param params.return_sn - Return serial number (required)
+     * @param params.carrier_id - Carrier ID (required)
+     * @param params.tracking_number - Tracking number (required)
+     *
+     * @returns A promise that resolves to the upload shipping proof response containing:
+     * - return_sn: The return serial number
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async uploadShippingProof(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/returns/upload_shipping_proof", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=returns.manager.js.map

package/lib/managers/returns.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"returns.manager.js","sourceRoot":"","sources":["../../src/managers/returns.manager.ts"],"names":[],"mappings":"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"}

package/lib/managers/sbs.manager.d.ts

@@ -0,0 +1,112 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetBoundWhsInfoParams, GetBoundWhsInfoResponse, GetCurrentInventoryParams, GetCurrentInventoryResponse, GetExpiryReportParams, GetExpiryReportResponse, GetStockAgingParams, GetStockAgingResponse, GetStockMovementParams, GetStockMovementResponse } from "../schemas/sbs.js";
+export declare class SbsManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Get bound warehouse by shop id.
+     *
+     * @param params - Parameters for getting bound warehouse info (empty object)
+     *
+     * @returns A promise that resolves to the bound warehouse info response containing:
+     * - list: List of shops with bound warehouses
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getBoundWhsInfo(params?: GetBoundWhsInfoParams): Promise<GetBoundWhsInfoResponse>;
+    /**
+     * Get Seller Center Current Inventory Page Data.
+     * This API provides detailed inventory information including sellable, reserved,
+     * and unsellable quantities across different warehouses.
+     *
+     * @param params - Parameters for getting current inventory
+     * @param params.whs_region - Warehouse region (required): BR, CN, ID, MY, MX, TH, TW, PH, VN, SG
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, 1-100 (default: 10)
+     * @param params.search_type - Search type: 0=All data; 1=Product Name; 2=SKU ID; 3=Variations; 4=Item ID
+     * @param params.keyword - Search keyword
+     * @param params.whs_ids - Warehouse IDs, comma-separated
+     * @param params.not_moving_tag - Not moving tag: Blank=All; 0=No; 1=Yes
+     * @param params.inbound_pending_approval - Inbound pending approval: Blank=All; 0=No; 1=Yes
+     * @param params.products_with_inventory - Products with inventory: Blank=All; 0=No; 1=Yes
+     * @param params.category_id - Category id (first-tier)
+     * @param params.stock_levels - Stock levels (comma-separated): 1=Low Stock & No Sellable stock; 2=Low Stock & To replenish; 3=Low Stock & Replenished; 4=Excess
+     *
+     * @returns A promise that resolves to the current inventory response containing:
+     * - cursor: Pagination cursor
+     * - item_list: List of items with inventory details
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getCurrentInventory(params: GetCurrentInventoryParams): Promise<GetCurrentInventoryResponse>;
+    /**
+     * Get Seller Center Expiry Report page data.
+     * This API provides information about expiring, expired, and damaged stocks.
+     *
+     * @param params - Parameters for getting expiry report
+     * @param params.whs_region - Warehouse region (required): BR, CN, ID, MY, MX, TH, TW, PH, VN, SG
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, 1-40 (default: 10)
+     * @param params.whs_ids - Warehouse IDs, comma-separated
+     * @param params.expiry_status - Expiry status (comma-separated): 0=Expired, 2=Expiring, 4=expiry_blocked, 5=damaged, 6=normal
+     * @param params.category_id_l1 - Only Level 1 Category can be filtered
+     * @param params.sku_id - SKU ID
+     * @param params.item_id - Item ID
+     * @param params.variation - Variation
+     * @param params.item_name - Item name
+     *
+     * @returns A promise that resolves to the expiry report response containing:
+     * - item_list: List of items with expiry information
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getExpiryReport(params: GetExpiryReportParams): Promise<GetExpiryReportResponse>;
+    /**
+     * Get Seller Center Stock Aging page data.
+     * This API provides stock aging information showing how long items have been in stock.
+     *
+     * @param params - Parameters for getting stock aging
+     * @param params.whs_region - Warehouse region (required): BR, CN, ID, MY, MX, TH, TW, PH, VN, SG
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, 1-100 (default: 10)
+     * @param params.search_type - Search type: 1=Product Name; 2=SKU ID; 3=Variations; 4=Item ID
+     * @param params.keyword - Search keyword
+     * @param params.whs_ids - Warehouse IDs, comma-separated
+     * @param params.aging_storage_tag - Aging storage tag: 0=false; 1=true
+     * @param params.excess_storage_tag - Excess storage tag: 0=false; 1=true
+     * @param params.category_id - L1-level product category ID
+     *
+     * @returns A promise that resolves to the stock aging response containing:
+     * - item_list: List of items with stock aging details
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getStockAging(params: GetStockAgingParams): Promise<GetStockAgingResponse>;
+    /**
+     * Get Seller Center Stock Movement page data.
+     * This API provides stock movement information including inbound, outbound, and adjustments.
+     *
+     * @param params - Parameters for getting stock movement
+     * @param params.start_time - Start date in YYYY-MM-DD format (required)
+     * @param params.end_time - End date in YYYY-MM-DD format (required)
+     * @param params.whs_region - Warehouse region (required): BR, CN, ID, MY, MX, TH, TW, PH, VN, SG
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, 1-20 (default: 10)
+     * @param params.whs_ids - Warehouse IDs, comma-separated
+     * @param params.category_id_l1 - L1-level category_id
+     * @param params.sku_id - SKU ID
+     * @param params.item_id - Item ID
+     * @param params.item_name - Item name
+     * @param params.variation - Variation
+     *
+     * @returns A promise that resolves to the stock movement response containing:
+     * - total: Total number of items
+     * - start_time: Start time
+     * - end_time: End time
+     * - query_end_time: Query end time
+     * - item_list: List of items with stock movement details
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getStockMovement(params: GetStockMovementParams): Promise<GetStockMovementResponse>;
+}