@be-link/ecommerce-trade-service-node-sdk 0.1.86 → 0.1.87

package/enums.d.ts

@@ -88,6 +88,15 @@ export declare namespace ENUM {
         /** 无需核销 */
         NONE = "NONE"
     }
+    /** 优惠券核销状态 */
+    enum CouponVerificationStatus {
+        /** 未核销 */
+        UNVERIFIED = "UNVERIFIED",
+        /** 已核销 */
+        VERIFIED = "VERIFIED",
+        /** 已过期 */
+        EXPIRED = "EXPIRED"
+    }
     /** 逆向资源类型 */
     enum ReverseResourceType {
         /** 资金 */
@@ -357,6 +366,8 @@ export declare namespace ENUM_CN {
     const OrderRefundStatus: Record<ENUM.OrderRefundStatus, string>;
     /** 核销状态中文映射 */
     const OrderVerificationStatus: Record<ENUM.OrderVerificationStatus, string>;
+    /** 优惠券核销状态中文映射 */
+    const CouponVerificationStatus: Record<ENUM.CouponVerificationStatus, string>;
     /** 支付渠道中文映射 */
     const PayChannel: Record<ENUM.PayChannel, string>;
     /** 支付平台中文映射 */

package/enums.js

@@ -99,6 +99,16 @@ var ENUM;
         /** 无需核销 */
         OrderVerificationStatus["NONE"] = "NONE";
     })(OrderVerificationStatus = ENUM.OrderVerificationStatus || (ENUM.OrderVerificationStatus = {}));
+    /** 优惠券核销状态 */
+    let CouponVerificationStatus;
+    (function (CouponVerificationStatus) {
+        /** 未核销 */
+        CouponVerificationStatus["UNVERIFIED"] = "UNVERIFIED";
+        /** 已核销 */
+        CouponVerificationStatus["VERIFIED"] = "VERIFIED";
+        /** 已过期 */
+        CouponVerificationStatus["EXPIRED"] = "EXPIRED";
+    })(CouponVerificationStatus = ENUM.CouponVerificationStatus || (ENUM.CouponVerificationStatus = {}));
     /** 逆向资源类型 */
     let ReverseResourceType;
     (function (ReverseResourceType) {
@@ -417,6 +427,12 @@ var ENUM_CN;
         [ENUM.OrderVerificationStatus.EXPIRED]: '已过期',
         [ENUM.OrderVerificationStatus.NONE]: '无需核销',
     };
+    /** 优惠券核销状态中文映射 */
+    ENUM_CN.CouponVerificationStatus = {
+        [ENUM.CouponVerificationStatus.UNVERIFIED]: '未核销',
+        [ENUM.CouponVerificationStatus.VERIFIED]: '已核销',
+        [ENUM.CouponVerificationStatus.EXPIRED]: '已过期',
+    };
     /** 支付渠道中文映射 */
     ENUM_CN.PayChannel = {
         [ENUM.PayChannel.WX_PAY]: '微信支付',

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

@@ -188,6 +188,72 @@ export declare namespace PosOrderQueryService {
                 /** 分页 */
                 pagination: Dto.IPagination;
             }
+            interface ICountOrderByStoreIdAndStatus {
+                /** 门店ID */
+                storeId: string;
+                /** 订单状态（可选，不传则统计所有状态） */
+                status?: ENUM.OrderStatus;
+                /** 时间范围开始时间（时间戳，可选） */
+                startTime?: number;
+                /** 时间范围结束时间（时间戳，可选） */
+                endTime?: number;
+            }
+            interface IGetVerifyCouponOrderStatistics {
+                /** 门店ID */
+                storeId: string;
+                /** 开始时间（时间戳） */
+                startTime: number;
+                /** 结束时间（时间戳） */
+                endTime: number;
+                /** 分页参数（必选） */
+                pagination: {
+                    /** 页码(从0开始) */
+                    pageIndex: number;
+                    /** 每页数量 */
+                    pageSize: number;
+                };
+                /** 搜索条件（可选） */
+                search?: {
+                    /** 券ID */
+                    couponId?: string;
+                    /** 券名称（模糊匹配） */
+                    couponName?: string;
+                };
+            }
+            interface IGetVerifyCouponUserDetails {
+                /** 券模板ID */
+                couponId: string;
+                /** 门店ID */
+                storeId: string;
+                /** 开始时间（时间戳） */
+                startTime: number;
+                /** 结束时间（时间戳） */
+                endTime: number;
+                /** 分页参数（必选） */
+                pagination: {
+                    /** 页码(从0开始) */
+                    pageIndex: number;
+                    /** 每页数量 */
+                    pageSize: number;
+                };
+                /** 筛选条件（必选） */
+                filter: {
+                    /** 核销状态：UNVERIFIED-未核销，VERIFIED-已核销，EXPIRED-已过期 */
+                    status: ENUM.CouponVerificationStatus;
+                    /** 用户ID列表（可选，用于精确查询指定用户） */
+                    userIds?: string[];
+                    /** 用户名称（可选，模糊匹配） */
+                    userName?: string;
+                };
+            }
+            interface IGetUserCouponDetails {
+                /** 用户ID */
+                userId: string;
+                /** 券模板ID */
+                couponId: string;
+                /** 核销状态：UNVERIFIED-未核销，VERIFIED-已核销，EXPIRED-已过期 */
+                status: ENUM.CouponVerificationStatus;
+            }
         }
         namespace Response {
             interface IListItem {
@@ -305,6 +371,91 @@ export declare namespace PosOrderQueryService {
             }
             interface IExportOrderDataByIds extends IExportOrderData {
             }
+            interface IGetVerifyCouponOrderStatistics {
+                /** 券统计列表 */
+                statistics: Array<{
+                    /** 券模板ID */
+                    couponId: string;
+                    /** 券名称 */
+                    couponName: string;
+                    /** 领取数量（总订单数） */
+                    totalCount: number;
+                    /** 已核销数量 */
+                    verifiedCount: number;
+                    /** 未核销数量（待使用） */
+                    unverifiedCount: number;
+                    /** 已过期数量 */
+                    expiredCount: number;
+                }>;
+                /** 分页信息（必选） */
+                pagination: {
+                    /** 当前页码 */
+                    pageIndex: number;
+                    /** 每页数量 */
+                    pageSize: number;
+                    /** 总记录数 */
+                    total: number;
+                };
+            }
+            interface IGetVerifyCouponUserDetails {
+                /** 用户详情列表 */
+                users: Array<{
+                    /** 用户ID */
+                    userId: string;
+                    /** 用户姓名 */
+                    userName: string;
+                    /** 用户手机号 */
+                    userPhone: string;
+                    /** 核销状态：UNVERIFIED-未核销，VERIFIED-已核销，EXPIRED-已过期 */
+                    status: ENUM.CouponVerificationStatus;
+                }>;
+                /** 分页信息（必选） */
+                pagination: {
+                    /** 当前页码 */
+                    pageIndex: number;
+                    /** 每页数量 */
+                    pageSize: number;
+                    /** 总记录数 */
+                    total: number;
+                };
+            }
+            interface IGetUserCouponDetails {
+                /** 券信息列表 */
+                coupons: Array<{
+                    /** 记录ID */
+                    id: string;
+                    /** 订单ID */
+                    orderId: string;
+                    /** 用户ID */
+                    userId: string;
+                    /** 券模板ID */
+                    couponId: string;
+                    /** 券名称 */
+                    couponName: string;
+                    /** 券code */
+                    couponCode: string;
+                    /** 券有效期开始时间 */
+                    couponStartTime: number;
+                    /** 券有效期结束时间 */
+                    couponEndTime: number;
+                    /** 创建时间 */
+                    createdAt: number;
+                    /** 更新时间 */
+                    updatedAt: number;
+                }>;
+            }
+            interface ICountOrderByStoreIdAndStatus {
+                /** 门店ID */
+                storeId: string;
+                /** 订单状态 */
+                status?: ENUM.OrderStatus;
+                /** 订单总数 */
+                total: number;
+                /** 时间范围开始时间 */
+                startTime?: number;
+                /** 时间范围结束时间 */
+                endTime?: number;
+            }
             interface IOrderDetail {
                 order: {
                     orderId: string;
@@ -562,6 +713,14 @@ export declare namespace PosOrderQueryService {
             orderExport(request: Request.IExportOrderData, req: any): Promise<Response.IExportOrderData>;
             /** 按订单IDs导出订单数据 */
             orderExportByIds(request: Request.IExportOrderDataByIds, req: any): Promise<Response.IExportOrderDataByIds>;
+            /** 查询核销券订单统计 */
+            getVerifyCouponOrderStatistics(request: Request.IGetVerifyCouponOrderStatistics, req: any): Promise<Response.IGetVerifyCouponOrderStatistics>;
+            /** 查询核销券用户详情 */
+            getVerifyCouponUserDetails(request: Request.IGetVerifyCouponUserDetails, req: any): Promise<Response.IGetVerifyCouponUserDetails>;
+            /** 查询指定用户和优惠券ID的券详情 */
+            getUserCouponDetails(request: Request.IGetUserCouponDetails, req: any): Promise<Response.IGetUserCouponDetails>;
+            /** 根据门店ID和订单状态统计订单数量 */
+            countOrderByStoreIdAndStatus(request: Request.ICountOrderByStoreIdAndStatus, req: any): Promise<Response.ICountOrderByStoreIdAndStatus>;
         }
     }
     namespace ByUser {

package/package.json

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