@be-link/ecommerce-plan-allocation-service-node-sdk 0.0.52 → 0.0.54

package/modules/preAllocationOrder/types.d.ts

@@ -211,6 +211,7 @@ export declare namespace PreAllocationOrderTypes {
             operator: string;
             storeIds?: string[];
             productIds?: string[];
+            skuIds?: string[];
             skuCodes?: string[];
             deliveryModes?: number[];
             sourceTypes?: number[];
@@ -237,6 +238,7 @@ export declare namespace PreAllocationOrderTypes {
             batchNos?: string[];
             preAllocationOrderIds?: string[];
             productIds?: string[];
+            skuIds?: string[];
             skuCodes?: string[];
             pageIndex?: number;
             pageSize?: number;
@@ -259,6 +261,7 @@ export declare namespace PreAllocationOrderTypes {
             warehouseId: string;
             batchNos?: string[];
             preAllocationOrderIds?: string[];
+            skuIds?: string[];
             pickingRemark: string;
             operator: string;
         }

package/modules/productStatistics/service.d.ts

@@ -3,6 +3,9 @@ import BaseService from '../BaseService';
 declare class ProductStatisticsService extends BaseService implements ProductStatisticsTypes.ProductStatisticsController {
     protected prefixUrl: string;
     getStockInProductStats(request: ProductStatisticsTypes.Request.GetStockInProductStats): Promise<ProductStatisticsTypes.Response.GetStockInProductStats>;
+    searchStockInProductStats(request: ProductStatisticsTypes.Request.SearchStockInProductStats): Promise<ProductStatisticsTypes.Response.GetStockInProductStats>;
+    getProductTradeStats(request: ProductStatisticsTypes.Request.GetProductTradeStats): Promise<ProductStatisticsTypes.Response.GetProductTradeStats>;
+    getSkuTradeStatsByProduct(request: ProductStatisticsTypes.Request.GetSkuTradeStatsByProduct): Promise<ProductStatisticsTypes.Response.GetSkuTradeStatsByProduct>;
 }
 export declare const productStatisticsService: ProductStatisticsService;
 export default productStatisticsService;

package/modules/productStatistics/service.js

@@ -24,11 +24,32 @@ let ProductStatisticsService = class ProductStatisticsService extends BaseServic
     getStockInProductStats(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.getStockInProductStats), request);
     }
+    searchStockInProductStats(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.searchStockInProductStats), request);
+    }
+    getProductTradeStats(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getProductTradeStats), request);
+    }
+    getSkuTradeStatsByProduct(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getSkuTradeStatsByProduct), request);
+    }
 };
 __decorate([
     (0, tsoa_1.Post)('get-stock-in-product-stats'),
     __param(0, (0, tsoa_1.Body)())
 ], ProductStatisticsService.prototype, "getStockInProductStats", null);
+__decorate([
+    (0, tsoa_1.Post)('search-stock-in-product-stats'),
+    __param(0, (0, tsoa_1.Body)())
+], ProductStatisticsService.prototype, "searchStockInProductStats", null);
+__decorate([
+    (0, tsoa_1.Post)('get-product-trade-stats'),
+    __param(0, (0, tsoa_1.Body)())
+], ProductStatisticsService.prototype, "getProductTradeStats", null);
+__decorate([
+    (0, tsoa_1.Post)('get-sku-trade-stats-by-product'),
+    __param(0, (0, tsoa_1.Body)())
+], ProductStatisticsService.prototype, "getSkuTradeStatsByProduct", null);
 ProductStatisticsService = __decorate([
     (0, tsoa_1.Route)('ProductStatistics'),
     (0, tsoa_1.Tags)('productStatistics')

package/modules/productStatistics/types.d.ts

@@ -1,6 +1,22 @@
 export declare namespace ProductStatisticsTypes {
     /** 实体定义 */
     namespace Entity {
+        /**
+         * 入库单商品下的 SKU 行：商品中心规格 + POS orderList(itemInfo) 销量 + 核销流水
+         */
+        interface StockInProductSkuStat {
+            skuId: string;
+            skuCode?: string;
+            attrs?: ProductAttr[];
+            /** orderList 返回的 itemInfo 聚合销量（每条商品行计 1 份） */
+            salesVolume: number;
+            /** getVerificationRecords 汇总已核销数量 */
+            verifiedCount: number;
+            /** max(0, salesVolume - verifiedCount) */
+            unverifiedCount: number;
+            /** 退货量 */
+            refundCount: number;
+        }
         /** 入库单商品统计项 */
         interface StockInProductStat {
             productId: string;
@@ -12,18 +28,104 @@ export declare namespace ProductStatisticsTypes {
             dispatchType: string;
             pickType: string;
             isCombo?: number;
+            /** 该商品下全部 SKU（商品中心），并映射本门店下单时间范围内的订单销量与核销 */
+            skus: StockInProductSkuStat[];
+        }
+        /** 商品属性（规格） */
+        interface ProductAttr {
+            attrName: string;
+            attrValue: string;
+        }
+        /**
+         * 商品 + 交易统计（字段与 Trade getProductStats 对齐，并附带商品中心展示信息）
+         */
+        interface ProductTradeStatItem {
+            productId: string;
+            productName: string;
+            price: number;
+            productImage: string;
+            classification: string;
+            storageMethod: string;
+            dispatchType: string;
+            pickType: string;
+            isCombo?: number;
+            productPrice: number;
+            gmv: number;
+            salesVolume: number;
+            buyerCount: number;
+            verifiedCount: number;
+            unverifiedCount: number;
+            refundCount: number;
+            refundAmount: number;
+        }
+        /**
+         * SKU + 交易统计（字段与 Trade getSkuStatsByProduct 对齐，并附带规格展示信息）
+         */
+        interface SkuTradeStatItem {
+            productId: string;
+            skuId: string;
+            salesVolume: number;
+            verifiedCount: number;
+            unverifiedCount: number;
+            refundCount: number;
+            gmv: number;
+            buyerCount: number;
+            refundAmount: number;
+            productName?: string;
+            productImage?: string;
+            skuCode?: string;
+            attrs?: ProductAttr[];
         }
     }
     /** 请求定义 */
     namespace Request {
-        /** 查询入库单商品统计请求 */
+        /**
+         * 查询入库单商品统计请求
+         * orderTimeStart/orderTimeEnd：下单时间（订单创建时间，毫秒），用于拉 POS orderList 与核销流水；必填
+         */
         interface GetStockInProductStats {
             storeId: string;
             updatedAtStart?: number;
             updatedAtEnd?: number;
+            orderTimeStart: number;
+            orderTimeEnd: number;
             pageIndex: number;
             pageSize: number;
         }
+        /**
+         * 入库单商品统计搜索（按商品 ID 筛选后分页；出参与 GetStockInProductStats 一致）
+         */
+        interface SearchStockInProductStats {
+            storeId: string;
+            productIds: string[];
+            orderTimeStart: number;
+            orderTimeEnd: number;
+            pageIndex: number;
+            pageSize: number;
+        }
+        /**
+         * 分页查询商品交易统计。
+         * 未传 productIds：先 Trade getProductStats 分页，再按返回 id 查商品中心；total 与 Trade 一致。
+         * 传入 productIds：先商品中心 queryProductList 分页（可选 classifications），再 Trade；total 与商品中心一致。
+         * classification 与 Trade productCate 同义（商品服务 PRODUCT_ENUM.CLASSIFICATION 字符串，如 DEPARTMENT_STORE）。
+         */
+        interface GetProductTradeStats {
+            storeId: string;
+            startTime: number;
+            endTime: number;
+            pageIndex: number;
+            pageSize: number;
+            productIds?: string[];
+            classification?: string;
+        }
+        /** 按商品查 SKU 维度交易统计 */
+        interface GetSkuTradeStatsByProduct {
+            storeId: string;
+            productId: string;
+            startTime: number;
+            endTime: number;
+            skuIds?: string[];
+        }
     }
     /** 响应定义 */
     namespace Response {
@@ -31,10 +133,28 @@ export declare namespace ProductStatisticsTypes {
         interface GetStockInProductStats {
             products: Entity.StockInProductStat[];
         }
+        /**
+         * 分页查询商品交易统计响应。
+         * total：无 productIds 时为 Trade 总条数；有 productIds 时为商品中心分页总条数。
+         */
+        interface GetProductTradeStats {
+            total: number;
+            list: Entity.ProductTradeStatItem[];
+        }
+        /** SKU 维度交易统计响应 */
+        interface GetSkuTradeStatsByProduct {
+            list: Entity.SkuTradeStatItem[];
+        }
     }
     /** ProductStatistics Controller 接口定义 */
     interface ProductStatisticsController {
         /** 查询入库单商品统计 */
         getStockInProductStats(request: ProductStatisticsTypes.Request.GetStockInProductStats): Promise<ProductStatisticsTypes.Response.GetStockInProductStats>;
+        /** 入库单商品统计搜索（出参与 getStockInProductStats 相同） */
+        searchStockInProductStats(request: ProductStatisticsTypes.Request.SearchStockInProductStats): Promise<ProductStatisticsTypes.Response.GetStockInProductStats>;
+        /** 分页查询商品交易统计 */
+        getProductTradeStats(request: ProductStatisticsTypes.Request.GetProductTradeStats): Promise<ProductStatisticsTypes.Response.GetProductTradeStats>;
+        /** 查询指定商品下 SKU 交易统计 */
+        getSkuTradeStatsByProduct(request: ProductStatisticsTypes.Request.GetSkuTradeStatsByProduct): Promise<ProductStatisticsTypes.Response.GetSkuTradeStatsByProduct>;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-plan-allocation-service-node-sdk",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "description": "EcommercePlanAllocationService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",

package/utils/http-copy.d.ts

@@ -1,6 +1,6 @@
 declare module '@fastify/request-context' {
     interface RequestContextData {
-        requestId?: string;
+        requestId: string;
         traceMessageId?: string;
         pandoraUserId?: string;
         beLinkUserId?: string;

package/utils/http.d.ts

@@ -1,6 +1,6 @@
 declare module '@fastify/request-context' {
     interface RequestContextData {
-        requestId?: string;
+        requestId: string;
         traceMessageId?: string;
         pandoraUserId?: string;
         beLinkUserId?: string;