@be-link/ecommerce-plan-allocation-service-node-sdk 0.0.14 → 0.0.16

package/modules/logistics/service.d.ts

@@ -11,6 +11,7 @@ declare class LogisticsService extends BaseService implements Service.LogisticsC
     getStoreStockInOrderLogisticsList(request: Service.Request.GetStoreStockInOrderLogisticsList): Promise<Service.Response.GetStoreStockInOrderLogisticsList>;
     getProductList(request: Service.Request.GetProductList): Promise<Service.Response.GetProductList>;
     subscribeWayBill(request: Service.Request.SubscribeWayBill): Promise<void>;
+    logisticsWebhookCallback(request: Service.Request.LogisticsWebhookCallback): Promise<Service.Response.LogisticsWebhookCallbackResponse>;
 }
 export declare const logisticsService: LogisticsService;
 export default logisticsService;

package/modules/logistics/service.js

@@ -48,6 +48,9 @@ let LogisticsService = class LogisticsService extends BaseService_1.default {
     subscribeWayBill(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.subscribeWayBill), request);
     }
+    logisticsWebhookCallback(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.logisticsWebhookCallback), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('批量导入运货单'),
@@ -94,6 +97,11 @@ __decorate([
     (0, tsoa_1.Post)('subscribe-way-bill'),
     __param(0, (0, tsoa_1.Body)())
 ], LogisticsService.prototype, "subscribeWayBill", null);
+__decorate([
+    (0, tsoa_1.OperationId)('物流状态回调'),
+    (0, tsoa_1.Post)('webhook-callback'),
+    __param(0, (0, tsoa_1.Body)())
+], LogisticsService.prototype, "logisticsWebhookCallback", null);
 LogisticsService = __decorate([
     (0, tsoa_1.Route)('logistics'),
     (0, tsoa_1.Tags)('Logistics')

package/modules/logistics/types.d.ts

@@ -1,3 +1,4 @@
+import type { ExpressDeliveryApiResponseEnvelope, RealTimeQueryData } from '@be-link/express-delivery-api-sdk';
 import { FastifyRequest } from 'fastify';
 export declare namespace Service {
     /** 物流信息实体 */
@@ -196,6 +197,15 @@ export declare namespace Service {
         interface SubscribeWayBill {
             num: string;
         }
+        /** 物流状态回调（Webhook）- 快递100推送的原始请求格式 */
+        interface LogisticsWebhookCallback {
+            /** 业务内容 JSON 字符串（需要解析为 ExpressDeliveryPushBody） */
+            param: string;
+            /** 签名值（sign），用于验证消息合法性 */
+            sign: string;
+            /** 其他扩展字段（如 timestamp/salt 等） */
+            [extra: string]: unknown;
+        }
     }
     namespace Response {
         /** 批量导入运货单结果 */
@@ -253,20 +263,23 @@ export declare namespace Service {
             /** 位置信息 */
             location?: string | null;
         }
-        /** 物流单号信息 */
-        interface LogisticsInfo {
-            /** 快递公司名称（如：顺丰速运、中通快递） */
+        /** 物流单号信息（快递100 实时查询返回的完整响应信息，包含 raw 字段，并补充快递公司名称） */
+        interface LogisticsInfo extends ExpressDeliveryApiResponseEnvelope<RealTimeQueryData> {
+            /** 快递公司名称（根据 com 字段从 CarrierCompany 表查询，如果查询不到则为空字符串） */
             carrierName: string;
-            /** 物流单号 */
-            trackingNumber: string;
-            /** 物流事件列表（按时间倒序，最新的在前） */
-            events: LogisticsEvent[];
         }
-        /** 门店入库单运货单物流信息列表 */
+        /** 门店入库单运货单物流信息列表（直接返回每个运单实时查询结果的完整响应信息） */
         interface GetStoreStockInOrderLogisticsList {
             /** 物流信息列表 */
             data: LogisticsInfo[];
         }
+        /** 物流状态回调响应 */
+        interface LogisticsWebhookCallbackResponse {
+            /** 响应码，0表示成功 */
+            code: number;
+            /** 响应消息 */
+            message: string;
+        }
     }
     interface LogisticsController {
         /** 批量导入运货单 */
@@ -287,5 +300,7 @@ export declare namespace Service {
         getProductList(request: Request.GetProductList, req?: FastifyRequest): Promise<Response.GetProductList>;
         /** 测试订阅运单号 */
         subscribeWayBill(request: Request.SubscribeWayBill, req?: FastifyRequest): Promise<void>;
+        /** 物流状态回调（Webhook） */
+        logisticsWebhookCallback(request: Request.LogisticsWebhookCallback, req?: FastifyRequest): Promise<Response.LogisticsWebhookCallbackResponse>;
     }
 }

package/package.json

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