@be-link/ecommerce-trade-service-node-sdk 0.1.89 → 0.1.91

package/enums.d.ts

@@ -62,6 +62,15 @@ export declare namespace ENUM {
         /** 支付失败 */
         FAILED = "FAILED"
     }
+    /** 微信支付方式 */
+    enum WePayWay {
+        /** H5支付 */
+        H5 = "H5",
+        /** 小程序JSAPI支付 */
+        JSAPI = "JSAPI",
+        /** APP支付 */
+        APP = "APP"
+    }
     /** 退款状态 */
     enum OrderRefundStatus {
         /** 无售后 */
@@ -167,6 +176,28 @@ export declare namespace ENUM {
         /** 商家主动退款 */
         MERCHANT_MANUAL = "MERCHANT_MANUAL"
     }
+    /** 批量退款模式 */
+    enum BatchRefundMode {
+        /** 退货退款（全单退） */
+        RETURN_AND_REFUND = "RETURN_AND_REFUND",
+        /** 仅退款-按每份固定金额退款 */
+        REFUND_ONLY_FIXED = "REFUND_ONLY_FIXED",
+        /** 仅退款-按每份可退金额退款（退订单剩余全部金额） */
+        REFUND_ONLY_MAX = "REFUND_ONLY_MAX"
+    }
+    /** 批量退款批次状态 */
+    enum BatchRefundStatus {
+        /** 待处理 */
+        PENDING = "PENDING",
+        /** 处理中 */
+        PROCESSING = "PROCESSING",
+        /** 已完成 */
+        COMPLETED = "COMPLETED",
+        /** 失败 */
+        FAILED = "FAILED",
+        /** 部分失败 */
+        PARTIAL_FAILED = "PARTIAL_FAILED"
+    }
     /** 支付渠道 */
     enum PayChannel {
         /** 微信支付 */
@@ -394,4 +425,8 @@ export declare namespace ENUM_CN {
     const ReverseRefundType: Record<ENUM.ReverseRefundType, string>;
     /** 退款方式中文映射 */
     const ReverseRefundWay: Record<ENUM.ReverseRefundWay, string>;
+    /** 批量退款模式中文映射 */
+    const BatchRefundMode: Record<ENUM.BatchRefundMode, string>;
+    /** 批量退款批次状态中文映射 */
+    const BatchRefundStatus: Record<ENUM.BatchRefundStatus, string>;
 }

package/enums.js

@@ -71,6 +71,16 @@ var ENUM;
         /** 支付失败 */
         OrderPayStatus["FAILED"] = "FAILED";
     })(OrderPayStatus = ENUM.OrderPayStatus || (ENUM.OrderPayStatus = {}));
+    /** 微信支付方式 */
+    let WePayWay;
+    (function (WePayWay) {
+        /** H5支付 */
+        WePayWay["H5"] = "H5";
+        /** 小程序JSAPI支付 */
+        WePayWay["JSAPI"] = "JSAPI";
+        /** APP支付 */
+        WePayWay["APP"] = "APP";
+    })(WePayWay = ENUM.WePayWay || (ENUM.WePayWay = {}));
     /** 退款状态 */
     let OrderRefundStatus;
     (function (OrderRefundStatus) {
@@ -185,6 +195,30 @@ var ENUM;
         /** 商家主动退款 */
         ReverseRefundWay["MERCHANT_MANUAL"] = "MERCHANT_MANUAL";
     })(ReverseRefundWay = ENUM.ReverseRefundWay || (ENUM.ReverseRefundWay = {}));
+    /** 批量退款模式 */
+    let BatchRefundMode;
+    (function (BatchRefundMode) {
+        /** 退货退款（全单退） */
+        BatchRefundMode["RETURN_AND_REFUND"] = "RETURN_AND_REFUND";
+        /** 仅退款-按每份固定金额退款 */
+        BatchRefundMode["REFUND_ONLY_FIXED"] = "REFUND_ONLY_FIXED";
+        /** 仅退款-按每份可退金额退款（退订单剩余全部金额） */
+        BatchRefundMode["REFUND_ONLY_MAX"] = "REFUND_ONLY_MAX";
+    })(BatchRefundMode = ENUM.BatchRefundMode || (ENUM.BatchRefundMode = {}));
+    /** 批量退款批次状态 */
+    let BatchRefundStatus;
+    (function (BatchRefundStatus) {
+        /** 待处理 */
+        BatchRefundStatus["PENDING"] = "PENDING";
+        /** 处理中 */
+        BatchRefundStatus["PROCESSING"] = "PROCESSING";
+        /** 已完成 */
+        BatchRefundStatus["COMPLETED"] = "COMPLETED";
+        /** 失败 */
+        BatchRefundStatus["FAILED"] = "FAILED";
+        /** 部分失败 */
+        BatchRefundStatus["PARTIAL_FAILED"] = "PARTIAL_FAILED";
+    })(BatchRefundStatus = ENUM.BatchRefundStatus || (ENUM.BatchRefundStatus = {}));
     /** 支付渠道 */
     let PayChannel;
     (function (PayChannel) {
@@ -523,4 +557,18 @@ var ENUM_CN;
         [ENUM.ReverseRefundWay.FAST]: '极速退款',
         [ENUM.ReverseRefundWay.MERCHANT_MANUAL]: '商家主动退款',
     };
+    /** 批量退款模式中文映射 */
+    ENUM_CN.BatchRefundMode = {
+        [ENUM.BatchRefundMode.RETURN_AND_REFUND]: '退货退款（全单退）',
+        [ENUM.BatchRefundMode.REFUND_ONLY_FIXED]: '仅退款-按固定金额',
+        [ENUM.BatchRefundMode.REFUND_ONLY_MAX]: '仅退款-按可退金额',
+    };
+    /** 批量退款批次状态中文映射 */
+    ENUM_CN.BatchRefundStatus = {
+        [ENUM.BatchRefundStatus.PENDING]: '待处理',
+        [ENUM.BatchRefundStatus.PROCESSING]: '处理中',
+        [ENUM.BatchRefundStatus.COMPLETED]: '已完成',
+        [ENUM.BatchRefundStatus.FAILED]: '失败',
+        [ENUM.BatchRefundStatus.PARTIAL_FAILED]: '部分失败',
+    };
 })(ENUM_CN || (exports.ENUM_CN = ENUM_CN = {}));

package/modules/pos/orderCore/types.d.ts

@@ -113,6 +113,8 @@ export declare namespace PosCoreService {
                 appId?: string;
                 /** 用户 openId（可选） */
                 openId?: string;
+                /** 微信支付方式（可选） */
+                wePayWay?: ENUM.WePayWay;
             }
             interface IUpdateAddress {
                 userId: string;

package/modules/pos/orderQuery/types.d.ts

@@ -284,6 +284,10 @@ export declare namespace PosOrderQueryService {
                 productDispatch: string;
                 orderType: ENUM.OrderType;
                 liveRoomGroupName?: string;
+                /** 直播间ID */
+                liveRoomId?: string;
+                /** 直播间名称 */
+                liveRoomName?: string;
                 /** 门店ID */
                 storeId?: string;
                 /** 门店名称 */
@@ -476,6 +480,8 @@ export declare namespace PosOrderQueryService {
                     orderType: ENUM.OrderType;
                     dispatchWay: string;
                     productPick: string;
+                    /** 直播间名称 */
+                    liveRoomName?: string;
                     store: {
                         storeId: string;
                         storeName: string;

package/modules/ros/orderCore/types.d.ts

@@ -63,10 +63,29 @@ export declare namespace RosOrderCoreService {
                 /** 未核销份数 */
                 unVerifiedNum?: number;
             }
+            interface IBatchRefundByExcel {
+                /** Excel文件URL（腾讯COS链接） */
+                fileUrl: string;
+                /** 退款模式 */
+                refundMode: ENUM.BatchRefundMode;
+                /** 操作人ID */
+                operatorId: string;
+                /** 操作人姓名 */
+                operatorName: string;
+            }
         }
         namespace Response {
             type IOrderApproval = void;
             type IOrderCreate = void;
+            interface IBatchRefundByExcel {
+                /** 批次ID（仅校验通过时返回） */
+                batchId?: string;
+                /** 错误详情（如果有校验错误） */
+                msgErrors?: Array<{
+                    row: number;
+                    error: string;
+                }>;
+            }
         }
     }
     namespace ByJob {
@@ -116,6 +135,8 @@ export declare namespace RosOrderCoreService {
         orderApproval(request: ByWeb.Request.IOrderApproval, req: any): Promise<ByWeb.Response.IOrderApproval>;
         /** 商家主动发起逆向退款订单 */
         orderCreate(request: ByWeb.Request.IOrderCreate, req: any): Promise<ByWeb.Response.IOrderCreate>;
+        /** 批量退款（通过Excel） */
+        batchRefundByExcel(request: ByWeb.Request.IBatchRefundByExcel, req: any): Promise<ByWeb.Response.IBatchRefundByExcel>;
     }
     interface CoreByJobController {
         autoApprove(request: ByJob.Request.IAutoApprove, req: any): Promise<void>;

package/modules/ros/orderCore/webService.d.ts

@@ -4,6 +4,7 @@ declare class RosOrderCoreByWebService extends BaseService implements RosOrderCo
     protected prefixUrl: string;
     orderApproval(request: RosOrderCoreService.ByWeb.Request.IOrderApproval): Promise<RosOrderCoreService.ByWeb.Response.IOrderApproval>;
     orderCreate(request: RosOrderCoreService.ByWeb.Request.IOrderCreate): Promise<RosOrderCoreService.ByWeb.Response.IOrderCreate>;
+    batchRefundByExcel(request: RosOrderCoreService.ByWeb.Request.IBatchRefundByExcel): Promise<RosOrderCoreService.ByWeb.Response.IBatchRefundByExcel>;
 }
 export declare const orderCoreByWebService: RosOrderCoreByWebService;
 export default orderCoreByWebService;

package/modules/ros/orderCore/webService.js

@@ -27,6 +27,9 @@ let RosOrderCoreByWebService = class RosOrderCoreByWebService extends BaseServic
     orderCreate(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.orderCreate), request);
     }
+    batchRefundByExcel(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.batchRefundByExcel), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('批量审批退款订单'),
@@ -38,6 +41,11 @@ __decorate([
     (0, tsoa_1.Post)('order-create'),
     __param(0, (0, tsoa_1.Body)())
 ], RosOrderCoreByWebService.prototype, "orderCreate", null);
+__decorate([
+    (0, tsoa_1.OperationId)('批量退款（通过Excel）'),
+    (0, tsoa_1.Post)('batch-refund-by-excel'),
+    __param(0, (0, tsoa_1.Body)())
+], RosOrderCoreByWebService.prototype, "batchRefundByExcel", null);
 RosOrderCoreByWebService = __decorate([
     (0, tsoa_1.Route)('ros/core/web'),
     (0, tsoa_1.Tags)('RosOrderCore')

package/modules/ros/orderQuery/types.d.ts

@@ -129,6 +129,17 @@ export declare namespace RosOrderQueryService {
             /** 退款份数 */
             quantity: number;
         }
+        interface IBatchRefundList {
+            /** 操作人ID（可选） */
+            operatorId?: string;
+            /** 批次状态（可选） */
+            status?: ENUM.BatchRefundStatus;
+            /** 分页参数 */
+            pagination: {
+                pageIndex: number;
+                pageSize: number;
+            };
+        }
     }
     namespace Response {
         interface IOrderList {
@@ -276,6 +287,53 @@ export declare namespace RosOrderQueryService {
             /** 待商家审核的订单数量 */
             count: number;
         }
+        interface IBatchRefundListItem {
+            /** 批次ID */
+            id: string;
+            /** 操作人ID */
+            operatorId: string;
+            /** 操作人姓名 */
+            operatorName: string;
+            /** 退款模式 */
+            refundMode: ENUM.BatchRefundMode;
+            /** 订单数量 */
+            orderCount: number;
+            /** 成功数量 */
+            successCount: number;
+            /** 失败数量 */
+            failCount: number;
+            /** 批次状态 */
+            status: ENUM.BatchRefundStatus;
+            /** 预计退款金额（分） */
+            expectedRefundAmount: number;
+            /** 实际退款金额（分） */
+            actualRefundAmount: number;
+            /** 预计退还优惠券数量 */
+            expectedRefundCouponCount: number;
+            /** 实际退还优惠券数量 */
+            actualRefundCouponCount: number;
+            /** 预计退还积分 */
+            expectedRefundPoints: number;
+            /** 实际退还积分 */
+            actualRefundPoints: number;
+            /** Excel文件URL */
+            excelFileUrl: string;
+            /** 错误详情 */
+            msgErrors: Array<{
+                row: number;
+                error: string;
+            }>;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+        }
+        interface IBatchRefundList {
+            /** 列表数据 */
+            list: IBatchRefundListItem[];
+            /** 总记录数 */
+            total: number;
+        }
     }
     interface QueryByWebController {
         orderList(request: RosOrderQueryService.Request.IOrderList): Promise<DTO.ReverseQueryResult[]>;
@@ -287,6 +345,8 @@ export declare namespace RosOrderQueryService {
         getApplyRefundInfo(request: RosOrderQueryService.Request.IGetApplyRefundInfo): Promise<RosOrderQueryService.Response.IGetApplyRefundInfo>;
         /** 统计待商家审核的订单数量 */
         countPendingOrders(): Promise<RosOrderQueryService.Response.ICountPendingOrders>;
+        /** 查询批量退款批次列表 */
+        batchRefundList(request: RosOrderQueryService.Request.IBatchRefundList, req: any): Promise<RosOrderQueryService.Response.IBatchRefundList>;
     }
     namespace ByUser {
         namespace Request {

package/modules/ros/orderQuery/webService.d.ts

@@ -9,6 +9,7 @@ declare class OrderQueryByWebService extends BaseService implements RosOrderQuer
     orderExportByIds(request: RosOrderQueryService.Request.IExportOrderDataByIds): Promise<RosOrderQueryService.Response.IExportOrderDataByIds>;
     getApplyRefundInfo(request: RosOrderQueryService.Request.IGetApplyRefundInfo): Promise<RosOrderQueryService.Response.IGetApplyRefundInfo>;
     countPendingOrders(): Promise<RosOrderQueryService.Response.ICountPendingOrders>;
+    batchRefundList(request: RosOrderQueryService.Request.IBatchRefundList): Promise<RosOrderQueryService.Response.IBatchRefundList>;
 }
 export declare const orderQueryByWebService: OrderQueryByWebService;
 export default orderQueryByWebService;

package/modules/ros/orderQuery/webService.js

@@ -39,6 +39,9 @@ let OrderQueryByWebService = class OrderQueryByWebService extends BaseService_1.
     countPendingOrders() {
         return (0, http_1.callApi)(this.getApiUrl(this.countPendingOrders));
     }
+    batchRefundList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.batchRefundList), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('订单列表查询, 给外部服务使用'),
@@ -69,6 +72,11 @@ __decorate([
     (0, tsoa_1.OperationId)('统计待商家审核的订单数量'),
     (0, tsoa_1.Post)('count-pending-orders')
 ], OrderQueryByWebService.prototype, "countPendingOrders", null);
+__decorate([
+    (0, tsoa_1.OperationId)('查询批量退款批次列表'),
+    (0, tsoa_1.Post)('batch-refund-list'),
+    __param(0, (0, tsoa_1.Body)())
+], OrderQueryByWebService.prototype, "batchRefundList", null);
 OrderQueryByWebService = __decorate([
     (0, tsoa_1.Route)('ros/query/web'),
     (0, tsoa_1.Tags)('RosOrderQuery')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-trade-service-node-sdk",
-  "version": "0.1.89",
+  "version": "0.1.91",
   "description": "EcommerceTradeService Node.js SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/types.d.ts

@@ -200,6 +200,8 @@ export interface IBizExtraInfo {
     skuId: string;
     /** 退款金额（资金类型时） */
     amount?: number;
+    /** 订单总金额（资金类型时） */
+    totalAmount?: number;
     /** 退款积分数量（积分类型时） */
     pointNum?: number;
     /** 退款券列表（优惠券类型时） */
@@ -208,6 +210,10 @@ export interface IBizExtraInfo {
         name: string;
         code: string;
     }[];
+    /** 小程序 appId（资金类型时，从支付记录获取） */
+    appId?: string;
+    /** 支付渠道（资金类型时，用于退款） */
+    payChannel?: ENUM.PayChannel;
     /** 商户号信息（资金类型时，用于退款） */
     merchantInfo?: IMerchantInfo;
 }
@@ -274,6 +280,8 @@ export interface PosOrderPayload {
     quantity?: number;
     /** 订单实付金额 */
     actualAmount?: number;
+    /** 剩余可退金额 */
+    remainingAmount?: number;
     /** 直播间ID */
     liveRoomId?: string;
 }