From 2135f05b49736b1474f017edbc525920148a10b7 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Thu, 3 Sep 2026 17:04:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(methods):=20=E5=90=8C=E6=AD=A5=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E6=96=87=E6=A1=A3=E4=B8=8E=E8=B7=AF=E7=94=B1=E8=A1=A8?= =?UTF-8?q?=EF=BC=8C=E5=90=AB=E6=8B=A6=E6=88=AA=E9=94=81=E5=AE=9A=E3=80=81?= =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=88=86=E9=85=8D=E6=97=B6=E9=97=B4=E3=80=81?= =?UTF-8?q?=E6=89=93=E5=8C=85/=E9=80=80=E5=9B=9E=E5=AF=BC=E5=87=BA?= =?UTF-8?q?=E3=80=81=E6=8A=A5=E8=A1=A8=E7=BE=A4=E8=B7=AF=E7=94=B1=E3=80=81?= =?UTF-8?q?=E6=94=B6=E8=B4=A7=E8=B4=A7=E4=B8=BB=E5=90=8D=E7=A7=B0=E7=AD=89?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AI_METHOD_ROUTING.md | 100 ++-- methods/changes/system.json | 189 ++++++++ methods/system.json | 910 ++++++++++++++++++++++++++++++++++-- 3 files changed, 1104 insertions(+), 95 deletions(-) diff --git a/AI_METHOD_ROUTING.md b/AI_METHOD_ROUTING.md index 0ee6c9a..16a4e1c 100644 --- a/AI_METHOD_ROUTING.md +++ b/AI_METHOD_ROUTING.md @@ -172,7 +172,7 @@ rg "class .*Service|module.exports" app/service/qimenMethods - 临时清单输出:temp/tmp-service-method-inventory.md -自动生成时间: 2026-08-28T20:06:02.056Z +自动生成时间: 2026-09-03T09:03:55.176Z 扫描范围: app/service/**/*.js 文件数: 203 @@ -267,10 +267,10 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list - app/service/systemMethods/dashboard.js (17) - storeStats, storeSideStoreStats, queryWarehouseStats, mergeStoreStats, emptyStoreStats, warehouseStats, hot_order_rank, express_ratio, storeSideExpressRatio, queryWarehouseExpressRatio, mergeChartData, formatChartData, emptyChartData, platform_distribution, storeSidePlatformDistribution, queryWarehousePlatformDistribution, order_trend -- app/service/systemMethods/inbox.js (11) - - group, message, after_sales, bindCode, groupList, groupDisable, groupUpdate, groupReset, groupMessages, retry, reply -- app/service/systemMethods/index.js (55) - - fastWhereTree, loadStores, loadWarehouses, loadExpressInterfaces, getCOSUploadConfig, getImages, uploadSuccessNotify, recognizeLicensePlate, ReferenceFile, getMessageDetail, test, getI18nMessage, putI18nCollect, extractModule, tryAutoTranslateNewKeys, searchSpace, searchSpaces, listInterfaceTypes, getLocationTypeList, getQimenAppList, getExpressList, getExpressProductTypeList, getPlatformList, getPrintPlatformList, ensureShopPrintPlatformExists, buildShopPrintPlatformInclude, getShopList, requestPddWaybillSearch, requestPddStdTemplates, requestTbWaybillSearch, requestTbCainiaoStdTemplates, requestPolyStdTemplates, getShopExpressList, getCainiaoStfTemplates, normalizeTemplatePlatformCode, normalizeTemplateExpressCode, getExpressPlatformFieldName, getTemplateAllowedExpressCodeSet, filterPrintPlatformTemplateResponseData, getPrintPlatformTemplateCacheKey, requestPrintPlatformTemplateList, resolvePddTemplateWpCodeCandidates, requestPddTemplateSourceList, getPrintPlatformTemplateList, isPlatformOauthReservationDuplicateError, getPlatformOauthReservationCodePrefix, hasPlatformOauthReservationCodePrefix, normalizePlatformOauthReservationCode, generatePlatformOauthReservationCode, createPlatformOauthReservation, getPlatformOauthLink, listenPlatformOauthBind, loginToIm, polyapiAuthorizeUrl, toOrder +- app/service/systemMethods/inbox.js (13) + - group, message, after_sales, bindCode, groupList, groupQuickList, groupMembers, groupDisable, groupUpdate, groupReset, groupMessages, retry, reply +- app/service/systemMethods/index.js (57) + - fastWhereTree, loadStores, loadWarehouses, loadExpressInterfaces, getCOSUploadConfig, getImages, uploadSuccessNotify, recognizeLicensePlate, ReferenceFile, getMessageDetail, test, getI18nMessage, putI18nCollect, extractModule, tryAutoTranslateNewKeys, searchSpace, searchSpaces, listInterfaceTypes, getLocationTypeList, getQimenAppList, getExpressList, getExpressProductTypeList, getPlatformList, getPrintPlatformList, ensureShopPrintPlatformExists, buildShopPrintPlatformInclude, getShopList, requestPddWaybillSearch, requestPddStdTemplates, requestTbWaybillSearch, requestTbCainiaoStdTemplates, requestPolyStdTemplates, getShopExpressList, getCainiaoStfTemplates, normalizeTemplatePlatformCode, normalizeTemplateExpressCode, getExpressPlatformFieldName, getTemplateAllowedExpressCodeSet, filterPrintPlatformTemplateResponseData, getPrintPlatformTemplateCacheKey, requestPrintPlatformTemplateList, resolvePddTemplateWpCodeCandidates, requestPddTemplateSourceList, getPrintPlatformTemplateList, isPlatformOauthReservationDuplicateError, getPlatformOauthReservationCodePrefix, hasPlatformOauthReservationCodePrefix, normalizePlatformOauthReservationCode, generatePlatformOauthReservationCode, createPlatformOauthReservation, getPlatformOauthLink, listenPlatformOauthBind, loginToIm, polyapiAuthorizeUrl, toOrder, getWorkbenchBindCode, LoginWorkbenchByCode - app/service/systemMethods/order/archiveOrder.js (2) - list, detail - app/service/systemMethods/order/base.js (57) @@ -287,8 +287,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress, list, manualOutboundOrder, badgeCount, queryOrderLogs, queryOrderLogList, updateExpressWeighingWeight, bindExpressPackageMaterial, bindExpressPackageMaterialByWaybill, pullReviewDataByWaybill - app/service/systemMethods/order/outboundOrder.js (2) - list, manualOutboundOrder -- app/service/systemMethods/order/packing.js (4) - - list, get, setEndTime, forceRecord +- app/service/systemMethods/order/packing.js (11) + - list, get, setEndTime, forceRecord, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress - app/service/systemMethods/order/pendingOrder.js (41) - list, detail, reverseReviewOrder, assertOrdersWithoutWaybill, syncWavesAfterReverseReview, allocateStorage, allocateStorageProgress, normalizeAllocateStorageTaskProgress, normalizeAllocateStorageTaskCount, normalizeAllocateStorageTaskCounts, normalizeAllocateStorageRequestId, getAllocateStorageTaskCacheKey, setAllocateStorageTaskProgress, getAllocateStorageTaskProgress, getAllocateExpressTaskCacheKey, normalizeAllocateExpressTaskId, setAllocateExpressTaskProgress, getAllocateExpressTaskProgress, getSyncOrderIdsTaskCacheKey, normalizeSyncOrderIdsRequestId, setSyncOrderIdsTaskProgress, getSyncOrderIdsTaskProgress, cancelAllocateStorage, syncOrderIds, syncOrderIdsProgress, allocateExpressCode, allocateExpressCodeTaskProgress, markPendingOutboundOrder, cancelOrder, normalizePendingOutboundOrderIds, normalizePendingCancelOrderIds, isCancelablePendingOrder, updateOrderPlatform, updateOrderExpress, updateAddress, updateRemark, cloneOrder, parseAddress, _parseAddressBatchOneShot, _parseSingleAddress, catch - app/service/systemMethods/order/print.js (4) @@ -315,14 +315,16 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list - app/service/systemMethods/report.js (7) - generate, generateTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress +- app/service/systemMethods/report/definition.js (4) + - typeList, save, list, delete - app/service/systemMethods/report/deliveryLog.js (1) - list -- app/service/systemMethods/report/deliveryPlan.js (2) - - save, list -- app/service/systemMethods/returnReceived.js (5) - - _call, create, list, detail, delete -- app/service/systemMethods/returnUnpack.js (15) - - _call, create, addDetail, updateDetail, removeDetail, cancel, submit, forceRecord, list, detailList, videoList, detail, export, exportTaskProgress, delete +- app/service/systemMethods/report/deliveryPlan.js (3) + - save, copy, list +- app/service/systemMethods/returnReceived.js (12) + - _call, create, list, detail, delete, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress +- app/service/systemMethods/returnUnpack.js (20) + - _call, create, addDetail, updateDetail, removeDetail, cancel, submit, forceRecord, list, detailList, videoList, detail, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress, delete - app/service/systemMethods/returnWaybill.js (6) - _call, create, update, list, detail, delete - app/service/systemMethods/setting/account.js (7) @@ -383,8 +385,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - createStore, createWarehouse, joinStore, joinWarehouse, getStoreRoles, auditApply - app/service/systemMethods/storeWarehouse.js (0) - -- app/service/systemMethods/storeWarehouse/store.js (25) - - list, sign, confirmSign, rename, unbind, adjustPrintQuantity, queryPrintQuantityLogs, getPolicyConfig, getPolicyConfigFields, savePolicyConfig, listApiConfig, saveApiConfig, deleteQimenConfig, openAccount, createUser, exportPrintQuantityLogs, exportPrintQuantityLogsTaskProgress, queryStorePrintQuantityLogs, exportStorePrintQuantityLogs, exportStorePrintQuantityLogsTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress +- app/service/systemMethods/storeWarehouse/store.js (27) + - list, sign, confirmSign, rename, unbind, adjustPrintQuantity, queryPrintQuantityLogs, getPolicyConfig, getPolicyConfigFields, savePolicyConfig, listApiConfig, saveApiConfig, deleteQimenConfig, openAccount, createUser, export, exportTaskProgress, exportPrintQuantityLogs, exportPrintQuantityLogsTaskProgress, queryStorePrintQuantityLogs, exportStorePrintQuantityLogs, exportStorePrintQuantityLogsTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress - app/service/systemMethods/storeWarehouse/warehouse.js (3) - list, sign, confirmSign - app/service/systemMethods/user.js (9) @@ -393,8 +395,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - getWarehouseZones, getWarehouseTree, getChildren, create, update, delete, detail, checkBarcodeUnique, toggleActive, getPath, getPickPath, updateRackPosition, recalculatePickPath, updateNeighbors, getAreaRacks, getSpacesByRack, createRackWithSpaces, getSpaceInfo, updateSpaceInfo, getBatchFieldValue, hasBatchField, normalizeBatchString, getCurrentWarehouseCode, batchUpdateSpaceInfo, exportRackSpaces - app/service/systemMethods/waybill/warehouse.js (9) - list, detail, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress -- app/service/systemMethods/workbench.js (8) - - list, detail, create, update, delete, business, bindCamera, checkBarcode +- app/service/systemMethods/workbench.js (11) + - list, detail, create, update, delete, business, bindCamera, checkBarcode, bind, getWorkbenchInfo, resetLoginCode - app/service/systems/account_platform.js (11) - getActiveInclude, getPrimaryRoleBinding, formatActiveContext, switchActiveRole, getActiveRoleByPlatform, getMultiplePlatformActiveRoles, getAllPlatformActives, clearPlatformActive, clearPlatformCache, getAvailableRoles, getCurrentContext - app/service/systems/afterSale.js (29) @@ -413,12 +415,12 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list, detail, create, update, delete - app/service/systems/comboGoods.js (15) - fetchStockInfoMap, buildSimpleNotation, buildNameNotation, validateItems, getTargetStoreIdFromMap, checkCustomCodeUniqueForCreate, checkCustomCodeUniqueForUpdate, list, buildListWhere, create, update, delete, search, searchByIdOrCode, enrichComboList -- app/service/systems/delivery_order.js (48) - - getStoreSubjectConfigCacheKey, normalizeStoreSubjectConfig, getStoreSubjectConfig, findCodeOption, getOptionName, appendOrderOperationLog, getOrderLogOperator, getOrderLogWarehouseId, flushOrderOperationLogs, findPlatformOptionByCode, getPlatformSnapshotCode, getPlatformSnapshotName, resolvePlatformSnapshot, resolveExpressCodeFromSetting, resolveExpressSettingSnapshot, resolveEnableExternalExpressCode, resolveExpressSnapshot, addOrder, isPrimaryKeyDuplicate, formatOrderCreateError, resolveOrderStep, generateItemsHash, calculateCRC32, normalizeOrderFromKey, resolveOperatorName, prepareOrderData, addOrderLines, buildOrderItemSnapshot, safeParseFloat, withPatchedCtxUser, buildAsyncProcessContext, buildExpressAllocateRequest, enqueueAutoWaybillAllocation, buildStorageAllocateRequest, getStoreWarehousePolicyConfig, normalizePolicyFlag, resolveCutoffOrderConfig, isPastCutoffTime, buildAutoGroupingStructure, findAutoGroupingWaveId, appendOrderToWave, countCandidateGroupOrders, createGroupingWave, markWaveAutoGrouping, finishAutoGroupingIfNeeded, runAutoGrouping, runAsyncProcessStep, asyncProcessOrderCreated +- app/service/systems/delivery_order.js (50) + - getStoreSubjectConfigCacheKey, normalizeStoreSubjectConfig, getStoreSubjectConfig, findCodeOption, getOptionName, appendOrderOperationLog, getOrderLogOperator, getOrderLogWarehouseId, flushOrderOperationLogs, findPlatformOptionByCode, getPlatformSnapshotCode, getPlatformSnapshotName, resolvePlatformSnapshot, resolveExpressCodeFromSetting, resolveExpressSettingSnapshot, resolveEnableExternalExpressCode, resolveExpressSnapshot, addOrder, isPrimaryKeyDuplicate, formatOrderCreateError, resolveOrderStep, generateItemsHash, calculateCRC32, normalizeOrderFromKey, resolveOperatorName, prepareOrderData, addOrderLines, buildOrderItemSnapshot, safeParseFloat, withPatchedCtxUser, buildAsyncProcessContext, buildExpressAllocateRequest, enqueueAutoWaybillAllocation, buildStorageAllocateRequest, getStoreWarehousePolicyConfig, normalizePolicyFlag, resolveCutoffOrderConfig, isPastCutoffTime, Date, isAllocationWindowClosed, buildAutoGroupingStructure, findAutoGroupingWaveId, appendOrderToWave, countCandidateGroupOrders, createGroupingWave, markWaveAutoGrouping, finishAutoGroupingIfNeeded, runAutoGrouping, runAsyncProcessStep, asyncProcessOrderCreated - app/service/systems/entry_order.js (16) - addOrder, getLineCount, received, success, fail, findByOrderCode, findByStatus, getStatsByWarehouse, updateSyncStatus, updateOrderStatus, calculateReceivedQuantities, batchUpdateReceived, getOrderProgress, tryCreateEntryOrder, addItems, reviewEntry -- app/service/systems/excel.js (24) - - getContentType, sanitizeSheetName, normalizeHeaders, normalizeColumns, prepareSheetData, hasEmbeddedImages, buildWorksheet, buildWorkbook, buildExcelJsWorkbook, inferImageExtension, resolveImageSource, mergeCellStyle, applyStyledRows, addEmbeddedImages, generateBuffer, writeFile, writeAtomicBufferFile, sanitizeFilename, buildUploadKey, generateAndUpload, sendFile, parseBuffer, parseFile, workbookToJSON +- app/service/systems/excel.js (26) + - getContentType, sanitizeSheetName, normalizeHeaders, normalizeColumns, prepareSheetData, hasEmbeddedImages, buildWorksheet, buildWorkbook, buildExcelJsWorkbook, inferImageExtension, resolveImageSource, mergeCellStyle, applyStyledRows, applyTextColumnsToSheetJs, applyTextColumnsToExcelJs, addEmbeddedImages, generateBuffer, writeFile, writeAtomicBufferFile, sanitizeFilename, buildUploadKey, generateAndUpload, sendFile, parseBuffer, parseFile, workbookToJSON - app/service/systems/express_platform.js (16) - getOrderLogOperator, buildOrderExpressVerPatch, buildExpressPlatformTraceId, OrderExpress, cleanupFailedWaybillOrders, buildFailedOrderCleanupList, polyapi, cainiao, parsePlatformPrintData, stringifyPlatformPrintData, buildWaybillOrderMetaMap, buildWaybillSettlementRelationMap, lockAndDeductWaybillSettlement, persistWaybillSuccessUpdates, normalizePddExtData, pdd - app/service/systems/express_policy.js (10) @@ -429,10 +431,10 @@ rg "class .*Service|module.exports" app/service/qimenMethods - buildTree, getTreeByType, buildSubTree, getWithChildrenByType, getAllChildren, getByType, getGroups, getChildrenByPid, getTreeChildrenByPid, create, update, findById, delete - app/service/systems/file.js (2) - getImages, ReferenceFile -- app/service/systems/inbound_direct_log.js (11) - - getItems, _addSingleItem, _bindReceivingDetail, addItem, removeItem, commit, _sendOpenApiCallback, operationLog, qimenEntrySync, _syncReceivingStorageStatus, _applyReceivingStockOccupancy -- app/service/systems/inbox/group.js (8) - - list, disable, update, reset, validateExpressInterfaces, validateSystemExpressCode, findGroupsByExpress, findStoreAfterSalesGroups +- app/service/systems/inbound_direct_log.js (14) + - getItems, _addSingleItem, _bindReceivingDetail, addItem, removeItem, commit, notifyEntryOrderCompleted, _queryCompletedEntryItems, _buildCompletedItemLines, _sendOpenApiCallback, operationLog, qimenEntrySync, _syncReceivingStorageStatus, _applyReceivingStockOccupancy +- app/service/systems/inbox/group.js (10) + - list, quickList, members, disable, update, reset, validateExpressInterfaces, validateSystemExpressCode, findGroupsByExpress, findStoreAfterSalesGroups - app/service/systems/license_plate.js (7) - getTencentCloudConfig, getTencentCloudRegion, normalizeBase64Image, buildTencentCloudRequest, sendTencentCloudRequest, recognizeLicensePlate, formatLicensePlateResult - app/service/systems/location_space.js (16) @@ -461,16 +463,16 @@ rg "class .*Service|module.exports" app/service/qimenMethods - createBusinessError, normalizeOrderId, normalizeWaybillCode, normalizePackageMaterialCode, normalizePackageMaterialId, normalizeBindOrderId, getCurrentWarehouseId, findActivePackageMaterialById, findActivePackageMaterialByCode, findValidOrderExpressByOrderAndWaybill, findOrderInterceptStatus, assertOrderNotIntercepted, normalizeWeighingWeight, findValidOrderExpressRows, updateWeighingWeight, updateWeighingWeightByWaybill, _updateWaveAllOrdersWeight, _buildWaveWeighingSummary, _getStoreName, _getWaveSysLogisticsName, _updateSingleOrderWeight, _updateWaveOrderWeight, _writeWeighActionLog, _tryWaveCompatibility, _upsertPackageMaterialItemRelation, bindExpressPackageMaterial, bindExpressPackageMaterialByWaybill, _bindSingleExpressPackageMaterial, _bindWavePackageMaterialByBusinessKey, _writePackageMaterialActionLog - app/service/systems/order_outbound.js (1) - markOutboundOrder -- app/service/systems/order_packing.js (6) - - _getRecordingComputerId, _buildVideoUrl, list, get, setEndTime, forceRecord +- app/service/systems/order_packing.js (10) + - _getRecordingComputerId, _buildVideoUrl, createBusinessError, _buildListWhere, _buildListOrder, list, exportPackTask, get, setEndTime, forceRecord - app/service/systems/order_pending_exception.js (2) - markPendingException, reversePendingException -- app/service/systems/order_print.js (54) - - isOrderLocked, buildLockedWavePlatformResult, buildLockedOrderPlatformPrintItem, shouldLoadPickingDetails, normalizeItemSnapshot, getFirstNonEmptyFieldText, buildPrintItemAggregationKey, buildPrintOrderRowMapWithPicking, normalizeContractPolicyConfig, getWavePlatformPrintData, getOrderPrintData, getPrintDataByWaybillCodes, queryWaybillsByCodes, getMainWaybillMapByOrderIds, normalizeUnlockGroupRules, isOrderMatchedByUnlockGroupRule, unlockWavePlatformPrintDataByGroup, normalizeWaveIds, normalizeOrderIds, getContextWarehouseId, resolveWarehouseId, queryWavesByIds, queryOrdersByWaveIds, queryOrdersByIds, queryOrderExpressByOrderIds, queryWaveOrderIndexMapByOrderIds, queryWaveTotalOrderCountMap, assertBusinessWaybillCompleteness, buildOrderExpressMap, isCainiaoPlatformCode, isJdPlatformCode, isPddPlatformCode, isDouyinPlatformCode, collectCainiaoExpressLookupCodes, queryCainiaoCpCodeMap, queryCainiaoExpressInterfaceList, queryJdExpressInterfaceList, queryPddExpressInterfaceList, queryDouyinExpressInterfaceList, pickCainiaoExpressInterface, pickJdExpressInterface, pickPddExpressInterface, pickDouyinExpressInterface, enrichCainiaoOrderExpressRows, enrichJdOrderExpressRows, enrichPddDyOrderExpressRows, getPolicyConfigMapByStore, resolvePrintPlatformCode, loadTemplateSampleByPlatform, buildOrderPlatformPrintItem, extractSinglePlatformPrintData, groupOrderPrintItemsByPlatform, groupOrderPrintItemsByWaveAndPlatform, filterFullyAssignedExpressWaves +- app/service/systems/order_print.js (55) + - isOrderLocked, buildLockedWavePlatformResult, buildLockedOrderPlatformPrintItem, shouldLoadPickingDetails, normalizeItemSnapshot, getFirstNonEmptyFieldText, buildPrintItemAggregationKey, buildPrintOrderRowMapWithPicking, normalizeContractPolicyConfig, getWavePlatformPrintData, getOrderPrintData, getPrintDataByWaybillCodes, queryWaybillsByCodes, getMainWaybillMapByOrderIds, normalizeUnlockGroupRules, isOrderMatchedByUnlockGroupRule, unlockWavePlatformPrintDataByGroup, normalizeWaveIds, normalizeOrderIds, getContextWarehouseId, resolveWarehouseId, queryWavesByIds, queryOrdersByWaveIds, queryOrdersByIds, queryOrderExpressByOrderIds, queryWaveOrderIndexMapByOrderIds, querySmallGroupBoxNoMap, queryWaveTotalOrderCountMap, assertBusinessWaybillCompleteness, buildOrderExpressMap, isCainiaoPlatformCode, isJdPlatformCode, isPddPlatformCode, isDouyinPlatformCode, collectCainiaoExpressLookupCodes, queryCainiaoCpCodeMap, queryCainiaoExpressInterfaceList, queryJdExpressInterfaceList, queryPddExpressInterfaceList, queryDouyinExpressInterfaceList, pickCainiaoExpressInterface, pickJdExpressInterface, pickPddExpressInterface, pickDouyinExpressInterface, enrichCainiaoOrderExpressRows, enrichJdOrderExpressRows, enrichPddDyOrderExpressRows, getPolicyConfigMapByStore, resolvePrintPlatformCode, loadTemplateSampleByPlatform, buildOrderPlatformPrintItem, extractSinglePlatformPrintData, groupOrderPrintItemsByPlatform, groupOrderPrintItemsByWaveAndPlatform, filterFullyAssignedExpressWaves - app/service/systems/order_review.js (14) - createBusinessError, normalizeWaybillCode, isLockedStatus, isInterceptStatus, toPlainRecord, parseItemSnapshot, findOrderExpressByWaybill, findOrderById, findOrderItems, loadBarcodesByStockIds, loadImagesByStockIds, findWaveById, buildGroupInterceptList, pullReviewDataByWaybill -- app/service/systems/order_storage_allocation.js (4) - - allocatePicking, allocateStorage, syncOrderIds, cancelAllocateStorage +- app/service/systems/order_storage_allocation.js (5) + - allocatePicking, allocateStorage, syncOrderIds, cancelAllocateStorage, releaseInterceptLocksByOrderIds - app/service/systems/pack_task_auto_finish.js (1) - executeAutoFinishPackTasks - app/service/systems/pick_compensation.js (9) @@ -493,20 +495,18 @@ rg "class .*Service|module.exports" app/service/qimenMethods - qimenClient, send, sendRequest - app/service/systems/receiving_entry_match.js (12) - matchAfterEntryCompleted, _bindEntryOrderReceiving, bindEntryOrderReceiving, _getRecentReceivingOrders, _findReceivingByRemark, _compareDetails, _sendCallback, _sendQimenCallback, _sendOpenApiCallback, _markReceivingPartialStorage, _commitBinding, unbindEntryOrderReceiving -- app/service/systems/report.js (7) - - getDefinition, parseJsonField, resolveQuerier, buildFilename, buildWorkbookSheets, generate, generateBuffer -- app/service/systems/report/queries/generic.js (0) - - +- app/service/systems/report.js (16) + - getDefinition, parseFieldsField, definitionToView, resolveTypeEntry, resolveQuerier, listRegisteredTypes, validateTypeFields, resolveOrderedFields, buildFilename, buildWorkbookSheets, generate, generateBuffer, saveDefinition, findDefinitionById, listDefinitions, deleteDefinition - app/service/systems/report/queries/index.js (0) - - app/service/systems/report/queries/sevenDayStockFlow.js (0) - -- app/service/systems/reportDelivery.js (17) - - normalizeScheduleTimes, savePlan, planToView, listPlans, listLogs, hitTimePoints, bizDateOfTrigger, bizDateOfTimePoint, resolveStoreWarehouse, markDelivered, markFailed, markExporting, buildMessageContent, deliverByChannel, processOne, parseScheduleTimes, dispatch -- app/service/systems/return_received.js (15) - - createBusinessError, create, notifyPending, _handleInterceptAfterSale, _updateOrderInterceptStatus, list, detail, delete, _findByIdChecked, _enrichReturn, _resolveStoreRemark, _buildListWhere, _resolveConditionValue, _extractConditionValue, _buildListOrder -- app/service/systems/return_unpack.js (42) - - _getRecordingComputerId, _buildVideoUrl, createBusinessError, create, addDetail, updateDetail, removeDetail, cancel, submit, _notifyUnpacked, forceRecord, list, detailList, videoList, exportUnpack, _resolveStoreNameMap, _resolveExpressNameMap, _extractDetailColor, detail, _buildWaybillMatch, _findWaybillFlexible, queryByWaybill, _resolveWarehouseName, _resolveStoreIdByWaybill, _resolveReturnOrderInfo, delete, _findByIdChecked, _assertUnpacking, _findDetailChecked, _recalcMain, _enrichRow, _flattenVideos, _enrichDetailsWithStock, _resolveStoreRemark, VALUES, _generateUnpackNo, _buildListWhere, _buildDetailListWhere, _buildVideoListWhere, _buildVideoListOrder, _resolveConditionValue, _buildListOrder +- app/service/systems/reportDelivery.js (29) + - normalizeScheduleTimes, parseJsonArray, readJsonArray, readJsonObject, normalizeNotifyTemplate, normalizePlanName, normalizeNotifyGroupIds, normalizeNotifyMemberIds, validateNotifyGroupExists, savePlan, copyPlan, planToView, listPlans, listLogs, hitTimePoints, bizDateOfTrigger, bizDateOfTimePoint, resolveStoreWarehouse, markDelivered, markFailed, markExporting, buildMessageContent, resolveNotifyGroups, Date, deliverByChannel, sendNotifyIfConfigured, processOne, parseScheduleTimes, dispatch +- app/service/systems/return_received.js (18) + - createBusinessError, create, notifyPending, _handleInterceptAfterSale, _updateOrderInterceptStatus, list, exportList, _generateExportExcel, detail, delete, _findByIdChecked, _enrichReturn, _resolveStoreRemark, _resolveStoreRemarkMap, _buildListWhere, _resolveConditionValue, _extractConditionValue, _buildListOrder +- app/service/systems/return_unpack.js (43) + - _getRecordingComputerId, _buildVideoUrl, createBusinessError, create, addDetail, updateDetail, removeDetail, cancel, _resolveSubmitEndTime, submit, _notifyUnpacked, forceRecord, list, detailList, videoList, exportUnpack, _resolveStoreNameMap, _resolveExpressNameMap, _extractDetailColor, detail, _buildWaybillMatch, _findWaybillFlexible, queryByWaybill, _resolveWarehouseName, _resolveStoreIdByWaybill, _resolveReturnOrderInfo, delete, _findByIdChecked, _assertUnpacking, _findDetailChecked, _recalcMain, _enrichRow, _flattenVideos, _enrichDetailsWithStock, _resolveStoreRemark, VALUES, _generateUnpackNo, _buildListWhere, _buildDetailListWhere, _buildVideoListWhere, _buildVideoListOrder, _resolveConditionValue, _buildListOrder - app/service/systems/return_waybill.js (12) - createBusinessError, create, update, list, detail, delete, _findByIdChecked, _assertStoreContract, _formatRow, _buildListWhere, _resolveConditionValue, _buildListOrder - app/service/systems/setting/account.js (31) @@ -547,22 +547,22 @@ rg "class .*Service|module.exports" app/service/qimenMethods - normalizeExpenseRecordValue, normalizeExpenseRecordCondition, normalizeFilterValues, buildEntryStockTransactionExistsCondition, buildHasReceivingCondition, preprocessEntryListWhere, list, get, IN, enrichItemsWithAvailableReceivingDetails, normalizeCancelEntryOrderIds, getOwnedEntryOrderById, cancel, _rollbackReceivingStorageStatus, addItem, commit, removeItem, getReceivingDetailsForBind, containerList, _applyReceivingInboundUsage, quickInbound, receivingCompare, _buildMergedComparison, exportEntryOrders, exportStoreEntryOrders - app/service/systems/storage/expiry.js (1) - list -- app/service/systems/storage/index.js (10) - - findByStockAndBatch, findBySpace, findAvailableByWarehouse, findExpiringSoon, updateQuantity, lockQuantity, unlockQuantity, allocateQuantity, getStockSummary, getSpaceUsage +- app/service/systems/storage/index.js (15) + - findByStockAndBatch, findBySpace, findAvailableByWarehouse, findExpiringSoon, updateQuantity, lockQuantity, unlockQuantity, allocateQuantity, interceptLockQuantity, interceptReceiveQuantity, interceptUnlockQuantity, min, offsetGapOnInbound, getStockSummary, getSpaceUsage - app/service/systems/storage/inventory.js (13) - createTransferStockTransactions, transferLocation, transferByProduct, resolveStockQueryToStockIds, getInventoryList, getStorageListByStockId, _aggregateStorageRowsBySpace, _loadInventoryWarningRanges, _formatBatchStorageRows, quickPutaway, directPutaway, exportInventoryList, _generateEntryOrderCode - app/service/systems/storage/management.js (1) - replenishmentDemand -- app/service/systems/storage/receiving.js (43) - - getReceivingList, _resolveStockQueryReceivingIds, getStoreReceivingList, getReceivingDetail, batchCancelReceiving, rejectReceiving, reviewReceiving, buildReviewReportSheets, sendStoreBoundNotice, resolveReceivingCreatorName, sendReviewNotice, resolveReviewDetailItemCodeMap, isEmptyValue, buildSequelizeCondition, processConditionValue, buildReceivingNumberPrefix, generateNextReceivingNumber, isReceivingNumberDuplicateError, create, save, bindStore, get, addDetail, bindDetailProduct, updateDetail, getStockStoreInfo, updateReceivingStats, deleteDetail, detailChange, invalid, formatReportDate, formatDeliveryMethod, getCompletionContactFields, Map, buildCompletionReportSheets, uploadCompletionExcelReport, sendCompletionNotice, sendStoreUnmatchedNotice, completeReceiving, _syncProductDataFromReceiving, scanDetail, exportReceivingList, exportStoreReceivingList +- app/service/systems/storage/receiving.js (44) + - getReceivingList, _resolveStockQueryReceivingIds, _resolveReceivingStoreNameMap, getStoreReceivingList, getReceivingDetail, batchCancelReceiving, rejectReceiving, reviewReceiving, buildReviewReportSheets, sendStoreBoundNotice, resolveReceivingCreatorName, sendReviewNotice, resolveReviewDetailItemCodeMap, isEmptyValue, buildSequelizeCondition, processConditionValue, buildReceivingNumberPrefix, generateNextReceivingNumber, isReceivingNumberDuplicateError, create, save, bindStore, get, addDetail, bindDetailProduct, updateDetail, getStockStoreInfo, updateReceivingStats, deleteDetail, detailChange, invalid, formatReportDate, formatDeliveryMethod, getCompletionContactFields, Map, buildCompletionReportSheets, uploadCompletionExcelReport, sendCompletionNotice, sendStoreUnmatchedNotice, completeReceiving, _syncProductDataFromReceiving, scanDetail, exportReceivingList, exportStoreReceivingList - app/service/systems/storage/report.js (5) - loadReportReferenceMaps, buildExportFilename, export, _resolveKeywordToStockIds, search - app/service/systems/storage/stock_warehouse.js (3) - _buildStockDetailCacheKey, getStockDetails, invalidateStockDetailCache - app/service/systems/store_express_binding_policy.js (17) - getCurrentWarehouseId, createError, normalizeText, normalizeInteger, normalizeWeightType, normalizeJsonArray, ensureExpressExists, getListWhereSpecialFieldMap, buildListWhere, normalizePagination, formatPolicyRow, list, ensureCustomNameUnique, add, findPolicyById, edit, del -- app/service/systems/store_warehouse.js (78) - - createError, getCurrentStoreId, getCurrentAccountId, toPositiveNumber, normalizePage, normalizeStatusFlag, normalizeAuthStatus, normalizeNonNegativeInteger, normalizeInteger, normalizeText, normalizeIntegerRange, normalizeEmail, getPolicyConfigFieldList, getPolicyConfigFieldMetaList, normalizePolicyConfig, getPolicyConfigCacheKey, hasPolicyConfigColumn, loadPolicyConfigByContractId, savePolicyConfigByContractId, getPolicyConfigDefaults, mergePolicyConfigWithDefaults, getEffectivePolicyConfigByContractId, ensureWarehouseSubject, getNoticeService, sendPrintQuantityAdjustNotice, resolveRelationId, normalizeDate, normalizeSignAction, normalizeTempCode, getTempCodeCacheKey, createTempCode, pickRemaskField, resolveRemaskValue, buildCurrentRemaskPatch, requireCurrentRemaskPatch, saveTempSignPayload, getTempSignPayload, clearTempSignPayload, buildTempSignView, getCurrentSubject, getCounterparty, buildListWhereByStoreId, buildListWhere, getRelationIncludes, getQimenContractCacheKey, clearQimenContractCache, getApiInterfaceType, getQimenInterfaceType, resolveQimenCustomerIdByAppKey, getQimenErpNameMapByAppKeys, serializeQimenConfig, getQimenConfigMap, getSingleQimenConfig, resolvePairIds, serializeRelation, findScopedRelation, listForStore, listForWarehouse, list, sign, trimContract, confirmSign, rename, adjustPrintQuantity, queryPrintQuantityLogs, exportPrintQuantityLogs, getPolicyConfigFields, getPolicyConfig, savePolicyConfig, listApiConfig, saveApiConfig, deleteQimenConfig, unbind, getContractConfigCacheKey, invalidateContractConfigCache, getContractConfig, openAccount, createUser +- app/service/systems/store_warehouse.js (80) + - createError, getCurrentStoreId, getCurrentAccountId, toPositiveNumber, normalizePage, normalizeStatusFlag, normalizeAuthStatus, normalizeNonNegativeInteger, normalizeInteger, normalizeText, normalizeIntegerRange, normalizeEmail, getPolicyConfigFieldList, getPolicyConfigFieldMetaList, normalizePolicyConfig, getPolicyConfigCacheKey, hasPolicyConfigColumn, loadPolicyConfigByContractId, savePolicyConfigByContractId, getPolicyConfigDefaults, mergePolicyConfigWithDefaults, getEffectivePolicyConfigByContractId, ensureWarehouseSubject, getNoticeService, sendPrintQuantityAdjustNotice, resolveRelationId, normalizeDate, normalizeSignAction, normalizeTempCode, getTempCodeCacheKey, createTempCode, pickRemaskField, resolveRemaskValue, buildCurrentRemaskPatch, requireCurrentRemaskPatch, saveTempSignPayload, getTempSignPayload, clearTempSignPayload, buildTempSignView, getCurrentSubject, getCounterparty, buildListWhereByStoreId, buildListWhere, getRelationIncludes, getQimenContractCacheKey, clearQimenContractCache, getApiInterfaceType, getQimenInterfaceType, resolveQimenCustomerIdByAppKey, getQimenErpNameMapByAppKeys, serializeQimenConfig, getQimenConfigMap, getSingleQimenConfig, resolvePairIds, serializeRelation, findScopedRelation, buildListForStoreWhere, listForStore, exportListForStore, listForWarehouse, list, sign, trimContract, confirmSign, rename, adjustPrintQuantity, queryPrintQuantityLogs, exportPrintQuantityLogs, getPolicyConfigFields, getPolicyConfig, savePolicyConfig, listApiConfig, saveApiConfig, deleteQimenConfig, unbind, getContractConfigCacheKey, invalidateContractConfigCache, getContractConfig, openAccount, createUser - app/service/systems/store.js (22) - normalizeSubjectConfigInput, validateStoreData, checkCompanyNameExists, findByAccountId, findAllEnabled, findAllWarehouses, getStoreName, getStoreRemaskName, createStore, createWarehouse, joinStore, joinWarehouse, ensureEmployeeRoleBinding, assignAdminRoleToCreator, generateJoinToken, sendNotification, sendNotificationToAdmins, getStoreRoles, auditApply, loadStores, loadWarehouses, bindCode - app/service/systems/upload.js (18) @@ -573,8 +573,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - closeFinishedWaves - app/service/systems/waybill.js (5) - toOrder, list, detail, export, buildWaybillExportFile -- app/service/systems/workbench.js (20) - - list, detail, create, update, delete, bindCamera, business, _countWaveOrders, _getWaveOrderIds, Set, _buildPackChangeSummary, _writePackOperationLog, _updateOrderPackStatus, _packOrder, resolvePackTaskEndTime, _finishPack, _sendWeight, _writeWeighOpLog, _queryOrder, checkBarcodeExists +- app/service/systems/workbench.js (44) + - list, detail, create, update, delete, bindCamera, business, _countWaveOrders, _countWaveOrdersCached, _getWaveOrderIds, Set, _buildPackChangeSummary, _writePackOperationLog, _updateOrderPackStatus, _packOrder, resolvePackTaskEndTime, _finishPack, _sendWeight, _writeWeighOpLog, _queryOrder, checkBarcodeExists, getWorkbenchBindClientCacheKey, getWorkbenchBindCodeCacheKey, getWorkbenchTokenCacheKey, generateRandomChars, generateWorkbenchToken, generateWorkbenchLoginCode, normalizeWorkbenchBindCode, generateUniqueWorkbenchLoginCode, createUniqueWorkbenchClientCode, createUniqueWorkbenchBindCode, buildWorkbenchBindState, getWorkbenchBindRemainingSeconds, setWorkbenchBindState, createWorkbenchBindSession, refreshWorkbenchBindCode, formatWorkbenchBindData, waitForWorkbenchBindComplete, getWorkbenchBindCode, formatWorkbenchTokenInfo, bindWorkbench, getWorkbenchInfoByToken, loginWorkbenchByCode, resetLoginCode - app/service/warehouse.js (7) - resolveWarehouseMethod, getWarehouseMethodService, dispatchWarehouseMethod, validateWarehouseParams, parseJsonBody, normalizeSignFields, processRequest - app/service/warehouseMethods/inbox.js (2) @@ -588,3 +588,5 @@ rg "class .*Service|module.exports" app/service/qimenMethods + + diff --git a/methods/changes/system.json b/methods/changes/system.json index dc7452e..004fac3 100644 --- a/methods/changes/system.json +++ b/methods/changes/system.json @@ -1,4 +1,193 @@ [ + { + "version": "2026.09.03-workbench-login-code-token", + "date": "2026-09-03", + "type": "enhanced", + "summary": "工作台登录码/令牌与绑定登录能力:wms_workbench 新增 token、login_code 两个字段(VARCHAR(64),login_code 前缀 wblc + 随机段共 64 位、全局唯一;token 随机 64 位)。新增 5 个接口:index.getWorkbenchBindCode(免登录免鉴权,参考 user.getLoginWechatCode:返回 client_code 并在缓存生成绑定码,传入 client_code 时长轮询等待绑定完成返回 token,超时/缓存失效重新生成绑定码后才返回数据)、workbench.bind(需登录需权限:校验缓存绑定码 + 工作台ID 关联绑定,成功后写入随机 token,旧 workbench:token:{token} 缓存删除)、workbench.getWorkbenchInfo(免登录免鉴权:token 查缓存 workbench:token:{token},未命中查库,无信息返回失败 code=403)、index.LoginWorkbenchByCode(免登录免鉴权:wms_workbench.login_code 入参换取 token,无匹配返回失败 code=403)、workbench.resetLoginCode(需登录需权限:随机重置 login_code)。workbench.list 返回 login_code(不返回 token),workbench.update 不受理 login_code 传入,workbench.create 自动创建 login_code。", + "methods": [ + "index.getWorkbenchBindCode", + "index.LoginWorkbenchByCode", + "workbench.bind", + "workbench.getWorkbenchInfo", + "workbench.resetLoginCode", + "workbench.list", + "workbench.create", + "workbench.update" + ], + "notes": [ + "database/migrations/20260903100000-add-login-code-token-to-wms-workbench.js:新增 login_code/token 两列(幂等 describeTable 判断)+ uk_login_code 唯一索引 + idx_token 索引,up/down 对称,已在开发库执行并验证", + "app/model/workbench.js:新增 login_code/token 字段定义与 uk_login_code/idx_token 索引声明", + "app/service/systems/workbench.js:新增绑定码/令牌能力(getWorkbenchBindCode/bindWorkbench/getWorkbenchInfoByToken/loginWorkbenchByCode/resetLoginCode 与配套缓存/生成/轮询辅助方法);list/detail 排除 token;create 自动生成唯一 login_code;update 白名单不含 login_code/token(传入不受理);缓存 key:workbench:bind:client:{clientCode}、workbench:bind:code:{code}(TTL 120s)、workbench:token:{token}(TTL 300s);长轮询 60s、每秒轮询缓存状态", + "app/service/systemMethods/workbench.js:新增 bind/getWorkbenchInfo/resetLoginCode 薄出口,systemInit 免登录/免权限/免鉴权/免日志声明补充 getWorkbenchInfo(bind/resetLoginCode 走默认需登录需权限)", + "app/service/systemMethods/index.js:新增 getWorkbenchBindCode/LoginWorkbenchByCode 薄出口,systemInit 免登录/免权限/免鉴权声明补充两方法(_noNeedLog 本就为 *)", + "403 口径:/system 网关不支持方法内设置 HTTP 状态码,按现有惯例(stock/warehouse.js 同款)返回 flag=failure、code=403 业务失败", + "methods/system.json:工作台模块新增 workbench.bind / workbench.getWorkbenchInfo / workbench.resetLoginCode 条目并更新 list/create/update 条目(list 响应补 login_code);基础模块新增 index.getWorkbenchBindCode / index.LoginWorkbenchByCode 条目;版本 0.3.73 -> 0.3.74(docMeta.version),updatedAt 保持 2026-09-03", + "本次未执行任何直接 DDL/写库操作;仅通过迁移文件在开发库(127.0.0.1:3307)执行 schema 变更并验证列与索引;生产库迁移需发布时按标准流程执行" + ], + "module": "workbench" + }, + { + "version": "2026.09.03-receiving-store-name-enrich", + "date": "2026-09-03", + "type": "changed", + "summary": "storage.receiving.getReceivingList / getReceivingDetail 货主名称实时解析:列表每项与详情主单的 store_name 不再只依赖主表快照(约 26% 历史数据快照为空),改为优先取合约表 wms_store_warehouse.store_remask(货主备注名称,按 store_id + warehouse_id 维度),无合约或备注为空时回退 wms_store.company_name(公司全称),均无时保留主表快照(可能为空字符串)。", + "methods": [ + "storage.receiving.getReceivingList", + "storage.receiving.getReceivingDetail" + ], + "notes": [ + "app/service/systems/storage/receiving.js 新增 _resolveReceivingStoreNameMap(storeIds, warehouseId):批量解析货主名称映射——先查 wms_store_warehouse(store_id IN + warehouse_id)取 store_remask,再查 wms_store 取 company_name 兑底,返回 Map;口径与 afterSale._enrichListStoreNames / inventory.store_name 一致(store_remask 优先、company_name 兑底)", + "app/service/systems/storage/receiving.js getReceivingList:拉取列表后批量调用 _resolveReceivingStoreNameMap,processedData 每项 store_name = 实时解析值 || 主表快照 || ''(实时值优先,兼容未绑定货主的存量数据)", + "app/service/systems/storage/receiving.js getReceivingDetail:查到主单后按 receiving.store_id + receiving.warehouse_id 实时解析货主名称,解析有值时覆盖 receiving.store_name(否则保留快照)", + "methods/system.json 收货单模块(module=storage_receiving):getReceivingList description 补充列表项 store_name 实时解析口径;getReceivingDetail 响应新增 receiving.store_name 字段描述;版本 0.3.72 -> 0.3.73(docMeta.version),updatedAt 保持 2026-09-03", + "AI_METHOD_ROUTING.md / AI_TOOLBOX.md 本次未同步:两者仅登记服务方法名清单,不含字段级描述,无需改动", + "本次仅查询验证(wms_receiving 共 1238 条、store_name 为空 319 条、store_id 为空 317 条;抽检 store_id=1000000 可经 store_remask='测试货主' 解析),未执行任何数据库写操作/DDL/Redis 操作;业务代码已通过 ESLint" + ], + "module": "storage.receiving" + }, + { + "version": "2026.09.03-policy-allocate-start-time-cross-day", + "date": "2026-09-03", + "type": "enhanced", + "summary": "货主策略与仓库级设置新增「开始自动分配时间」allocate_start_time(默认 08:00),支持跨天窗口:截单时间作为最后允许时间,开始时间晚于截单时间时截单时间视为次日;当前时间早于开始自动分配时间与超过截单时间行为一致(不自动分配快递/储位、不自动加团)。保存时开始时间等于截单时间(自动分配窗口为空)报 400。", + "methods": [ + "storeWarehouse.store.getPolicyConfigFields", + "storeWarehouse.store.savePolicyConfig", + "setting.warehouse.getSettings", + "setting.warehouse.saveSettings" + ], + "notes": [ + "app/model/store_warehouse.js POLICY_CONFIG_FIELDS 新增 allocate_start_time(名称:开始自动分配时间,type string,default 08:00,min 00:00,max 23:59,maxLength 5);cutoff_order_time 的 min 从 12:00 放开为 00:00(支持凌晨截单/跨天窗口);cutoff_order_enabled/cutoff_order_time 描述补充跨天语义;normalizePolicyConfig 保存路径(sanitizeOnly=false)新增跨字段校验:allocate_start_time 与 cutoff_order_time 相同时抛错「policy_config.allocate_start_time 不能等于 policy_config.cutoff_order_time(自动分配窗口为空)」(400),读取路径(sanitizeOnly=true)不校验", + "app/model/store.js DEFAULT_SUBJECT_CONFIG 新增 allocate_start_time: '08:00';CUTOFF_ORDER_TIME_MIN 放开为 00:00;normalizeSubjectConfig 新增 HH:mm 格式校验(非法抛「subject_config.allocate_start_time 格式必须为 HH:mm(如 08:00)」)与相等校验(显式同时提交两个时间字段且相等时抛错),旧数据读取自动补默认 08:00", + "app/service/systems/setting/warehouse.js WAREHOUSE_SETTING_FIELDS 新增 allocate_start_time 字段元信息(default 08:00,min 00:00,max 23:59);cutoff_order_time 的 min 放开为 00:00;getFieldMeta 自动返回新字段元信息", + "app/service/systems/delivery_order.js resolveCutoffOrderConfig 返回值新增 allocateStartTime(默认 08:00,货主-仓库级优先、仓库级兜底);新增 isAllocationWindowClosed(allocateStartTimeStr, cutoffTimeStr, nowDate):同天窗口(start=cutoff 禁止;跨天窗口(start>cutoff,截单视为次日)now in [cutoff,start) 禁止;start==cutoff 防御性全天禁止;asyncProcessOrderCreated 用 isAllocationBlocked 替换 isCutoffActive 控制自动分配快递/储位/自动加团,日志补充 allocateStartTime/cutoffTime", + "methods/system.json:storeWarehouse.store.getPolicyConfigFields response 从空数组补充字段元信息说明(data[]、data[].allocate_start_time、data[].cutoff_order_time、data[].cutoff_order_enabled);storeWarehouse.store.savePolicyConfig params 补充 policy_config.cutoff_order_enabled/cutoff_order_time/allocate_start_time 字段文档与 400 错误说明,response 补充 data.policy_config.allocate_start_time;setting.warehouse.getSettings response 与 setting.warehouse.saveSettings params 补充 subject_config.allocate_start_time/subject_config.cutoff_order_time 字段文档(getFieldMeta 为通用字段元信息结构,无逐字段清单,无需改动);版本 0.3.71 -> 0.3.72(docMeta.version),updatedAt 更新为 2026-09-03", + "本次仅文档同步(业务代码由 wms-dev-agent 完成:新增字段、跨天窗口判定、保存校验,并已通过 ESLint 与单元测试),未修改 app/ 下任何代码,未执行数据库/Redis 操作" + ], + "module": "storeWarehouse.store" + }, + { + "version": "2026.09.02-order-packing-list-perf-export", + "date": "2026-09-02", + "type": "changed", + "summary": "order.packing.list 慢查询优化 + 新增导出与进度查询接口:list 查询将 findAndCountAll 拆分为 count(不带 include)+ findAll(带 include),避免 count 生成 COUNT(DISTINCT)+双 LEFT JOIN(生产实测 520ms,拆分后 count 走单表索引约 44ms);筛选/排序逻辑提取为 _buildListWhere/_buildListOrder 供列表与导出复用。新增 order.packing.export(提交异步导出任务,入参 where/sort 语义与 list 一致,warehouse_id 由服务端注入;后台生成单 Sheet Excel「打包任务列表」并上传 COS)与 order.packing.exportTaskProgress(按 task_id 查询进度与下载链接)。两接口免权限免日志免鉴权(与 order.export 口径一致,无 wms_permission 记录),需登录。", + "methods": [ + "order.packing.list", + "order.packing.export", + "order.packing.exportTaskProgress" + ], + "notes": [ + "app/service/systems/order_packing.js:list 查询拆分——findAndCountAll 改为 count({where})(不带 include)+ findAll({where, include, limit, offset}),修复 hasMany include(videos/expresses)导致 count 生成 COUNT(DISTINCT)+双 LEFT JOIN 的慢查询(生产实测 520ms → 44ms);where 构建逻辑(status/pack_mode/waybill_code/wave_no/order_id/workbench_id/quickWhere/has_video/video_enable/时间范围)原样提取为 _buildListWhere(list/export 共用),排序提取为 _buildListOrder(list/export 共用);新增 createBusinessError 与 exportPackTask", + "app/service/systems/order_packing.js exportPackTask:复用 _buildListWhere/_buildListOrder 并强制 warehouse_id(缺失抛 400 缺少仓库上下文);主表全量分页拉取(每页 500,无行数上限);批量关联工作台(wms_workbench)、视频(wms_pack_task_video,含 camera 名称)、运单(wms_order_express,按 order_id 分批 100);ExcelJS 流式单 Sheet「打包任务列表」18 列(任务ID/订单ID/波次号/运单号/关联运单号/打包模式/任务状态/打包数量/商品总数量/商品种类数/工作台/作业人员/开始打包时间/结束打包时间/创建时间/视频状态/录像可用/备注),经 systems.upload.uploadFile 上传(key=exports/pack_task/{warehouseId}/{timestamp}_{token}.xlsx,mimetype xlsx,category=document),结果含 filename/fileKey/url/cdnUrl/cosUrl/current_count/total_count/sheet_count", + "app/service/systemMethods/order/packing.js:新增 export/exportTaskProgress 与任务缓存辅助方法(generateExportTaskId/normalizeExportTaskId/getExportTaskCacheKey/setExportTaskProgress/getExportTaskProgress):缓存键前缀 packing_export_task_,Redis TTL 1800 秒;export 提交后 setImmediate 异步执行并逐阶段回写进度(submitted(0) → running(5) → 数据拉取 10~30(未命中数据时 85)→ 关联拉取 30~55 → Excel 55~90 → 上传 92 → success(100),失败 failed + error);exportTaskProgress 入参兼容 task_id/taskId,download_url 从 result.url/cdnUrl/cosUrl/fileKey 兜底取,未命中返回 status=not_found(正常响应非报错)", + "systemInit 权限声明:_noNeedRight/_noNeedLog/_noNeedAuth 由 'list,get' 扩展为 'list,get,export,exportTaskProgress'(导出异步任务免权限免日志免鉴权,与 order.export 口径一致);_noNeedLogin 不变", + "methods/system.json order.packing 模块:新增 order.packing.export 与 order.packing.exportTaskProgress 两个 method 条目(追加于 order.packing.list 之后),版本 0.3.70 -> 0.3.71(docMeta.version),updatedAt 更新为 2026-09-02", + "本次未修改 wms_pack_task 表结构,未执行数据库写操作/Redis 操作;未运行测试" + ], + "module": "order.packing" + }, + { + "version": "2026.09.01-report-delivery-notify-group-routing-fix", + "date": "2026-09-01", + "type": "changed", + "summary": "修复「补货预警报表定时投递群路由」缺陷(G1):生产上 3 条投递计划发出 5 条消息——报表文件消息被投递到投递计划未配置的「货主默认站内信群」(如 store-1000156 的收货群、store-1000159 的对接群被误发)。根因:deliverByChannel 未按计划配置解析群目标,按 group_type='store' 取任意货主默认群(与 notify_group_ids 配置无关)。修复:新增 resolveNotifyGroups 统一解析(过滤 is_blocked=1、软删、仓库维度一致)供投递与通知两路共用;配置了 notify_group_ids 的计划文件消息仅逐群投递到配置群,全部不可达(不存在/已删除/被屏蔽/仓库不一致)时抛错进入 failed 退避重试、不再回退未配置群;未配置通知群的历史计划保持旧行为回退货主默认站内信群;sendNotifyIfConfigured 复用 resolveNotifyGroups 删除重复查询逻辑。响应结构不变,仅群路由语义变更。", + "methods": [ + "report.deliveryPlan.save", + "report.deliveryPlan.list", + "report.deliveryPlan.copy" + ], + "notes": [ + "app/service/systems/reportDelivery.js 新增 resolveNotifyGroups({plan, warehouseId}):notify_group_ids → 有效群行统一解析(is_blocked=0、软删自动排除、warehouse_id 维度一致),投递(deliverByChannel)与文本通知(sendNotifyIfConfigured)两路共用,保证口径一致;未配置群或全部被过滤时返回空数组,InboxGroup 模型不可用时抛错", + "app/service/systems/reportDelivery.js deliverByChannel 群路由改造:计划配置 notify_group_ids 时报表文件消息只逐群投递到配置群,不再投递任意「货主默认群」(旧逻辑为 group_type='store' 按 id ASC 取最早一条,与计划配置无关);配置了群但全部不可达(不存在/已删除/被屏蔽/仓库不一致)时抛「货主 配置的通知群不可达…无法投递」进入 failed 退避重试(MAX_RETRY=3,退避 retry_count × 60s),不再静默回退到未配置群;未配置通知群的历史计划保持旧行为回退到货主默认站内信群(group_type='store',取最早一条)兼容存量计划", + "app/service/systems/reportDelivery.js sendNotifyIfConfigured 复用 resolveNotifyGroups 解析通知群,删除重复查询逻辑,投递与通知共用同一解析口径", + "methods/system.json 通用报表模块(module=report):report.deliveryPlan.save description 与 params/response 的 notify_group_ids 描述补充群路由口径(文件消息仅投递计划配置群、未配置回退货主默认站内信群、配置群全部不可达失败退避);report.deliveryPlan.list description 与 response 的 notify_group_ids 描述同步;report.deliveryPlan.copy description 补充复制计划通知群置空后投递回退目标货主默认站内信群语义;请求/响应结构、headers、errors 均不变;版本 0.3.69 -> 0.3.70(docMeta.version),updatedAt 保持 2026-09-01", + "docs/report-config-guide.md 第 5 节补充文件消息投递目标/群路由口径(配置群定向投递、未配置回退默认群、全部不可达失败退避),第 5.1.2 节 notify_group_ids 补充同时作为文件消息投递目标的说明", + "测试回归:140 测试全过(业务代码由开发任务完成并测试通过);本次仅文档同步,未修改 app/ 下任何代码,未执行数据库/Redis 操作,未运行测试" + ], + "module": "report" + }, + { + "version": "2026.09.01-returnReceived.export", + "date": "2026-09-01", + "type": "added", + "summary": "退回收到模块新增导出与进度查询接口:returnReceived.export(提交异步导出任务,入参 where/sort 语义与 returnReceived.list 一致,warehouse_id 由服务端注入 ctx.user.store_id;后台生成单 Sheet Excel「退回收到登记列表」并上传 COS)与 returnReceived.exportTaskProgress(按 task_id 查询任务进度与下载链接,未命中返回 status=not_found)。任务缓存 Redis TTL 30 分钟,全量分页拉取 500/页;两接口默认走 API 权限校验(需 wms_permission 存在类型为 api 的记录),需登录。", + "methods": [ + "returnReceived.export", + "returnReceived.exportTaskProgress" + ], + "notes": [ + "app/service/systemMethods/returnReceived.js 新增 export/exportTaskProgress 与任务缓存辅助方法(generateExportTaskId/normalizeExportTaskId/getExportTaskCacheKey/setExportTaskProgress/getExportTaskProgress):缓存键前缀 return_received_export_task_,Redis TTL 1800 秒(30 分钟);export 提交后 setImmediate 异步执行并逐阶段回写进度(submitted(0) → running(5) → 数据拉取 10~55(未命中数据时 85)→ Excel 生成 60 → success(100),失败 failed + error);exportTaskProgress 入参兼容 task_id/taskId,download_url 从 result.url/cdnUrl/cosUrl/fileKey 兜底取;task_id 为空或缓存未命中返回 status=not_found(正常响应非报错)", + "systemInit 权限声明:_noNeedRight 仅 detail(export/exportTaskProgress 未加入免权限列表,默认走 API 权限校验,需 wms_permission 存在 returnReceived.export / returnReceived.exportTaskProgress 类型为 api 的记录);_noNeedLogin 为空(两接口均需登录,isNeedAuth=true、isNeedLogin=true);_noNeedLog 为空(记录操作日志);_noNeedAuth 为空(走仓库有效期检查)", + "app/service/systems/return_received.js 新增 exportList/_generateExportExcel/_resolveStoreRemarkMap:复用 _buildListWhere/_buildListOrder(与 list 语义一致)并强制 warehouse_id=注入值(缺失抛 400 缺少仓库上下文);主表全量分页拉取(每页 500,无行数上限);货主备注批量解析(wms_store_warehouse.store_remask,失败降级空字符串不阻断导出)", + "导出 Excel:单 Sheet「退回收到登记列表」,列=运单号/扫描日期/扫描人员/是否原单退回(是/否)/订单ID/货主备注/备注/登记时间/更新时间;ExcelJS 流式写入临时文件后经 systems.upload.uploadFile 上传(key=exports/return_received/{warehouseId}/{timestamp}_{token}.xlsx,mimetype xlsx,category=document),结果含 filename/fileKey/url/cdnUrl/cosUrl/current_count/total_count", + "methods/system.json 退回收到模块(module=returnReceived)新增 returnReceived.export 与 returnReceived.exportTaskProgress 两个 method 条目(追加于 returnReceived.delete 之后),版本 0.3.68 -> 0.3.69(docMeta.version),updatedAt 保持 2026-09-01", + "AI_METHOD_ROUTING.md 同步:app/service/systemMethods/returnReceived.js 方法计数 (5) -> (7),方法清单补充 export/exportTaskProgress;AI_TOOLBOX.md 未涉及 returnReceived 清单,无需改动", + "本次仅文档同步(业务代码由开发任务完成),未修改 app/ 下任何代码,未执行数据库/Redis 操作,未运行测试" + ], + "module": "returnReceived" + }, + { + "version": "2026.09.01-intercept-locked-quantity-rework", + "date": "2026-09-01", + "type": "changed", + "summary": "库内拦截确认时库存不再归还可用、改移入拦截锁定字段的改造落地:wms_storage_transaction 新增 before_intercept_locked_quantity / after_intercept_locked_quantity 两个拦截锁定快照字段(migration 20260901000200,尚未上线);wms_storage 可用数量统一口径 available_quantity = quantity - locked_quantity - intercept_locked_quantity;拦截相关流水新增 order_type=INTERCEPT_LOCK(拦截锁迁移/实物返还并拦截锁定)与 INTERCEPT_UNLOCK(拦截锁释放回落可用);stock.warehouse.search(with_stock)与 stock.warehouse.getStockDetail 按库位合并明细响应新增 intercept_locked_quantity 字段(向后兼容);order.recheckOrder.confirmIntercept / interceptScan 确认拦截时以拦截模式释放储位分配(interceptMode=true,库存不归还可用、移入拦截锁定)。", + "methods": [ + "stock.warehouse.getStockDetail", + "stock.warehouse.search", + "order.recheckOrder.confirmIntercept", + "order.recheckOrder.interceptScan" + ], + "notes": [ + "database/migrations/20260901000200-add-intercept-locked-snapshots-to-wms-storage-transaction.js:describeTable 幂等检测,新增 before_intercept_locked_quantity / after_intercept_locked_quantity(INT NULL,comment 变更前/后拦截锁定数量,与既有 before/after_locked_quantity 风格一致、可空无默认值、由写入逻辑维护);该 migration 尚未上线", + "app/model/storage_transaction.js:在 after_locked_quantity 之后新增 before_intercept_locked_quantity / after_intercept_locked_quantity 字段定义(INTEGER(12)/allowNull=true,comment 变更前/变更后拦截锁定数量)", + "app/service/systems/storage/index.js updateQuantity:新增 options.interceptLockedChange 变化量参数,统一重算 available_quantity = quantity - locked_quantity - intercept_locked_quantity,并校验拦截锁定数量非负、不超过库存数量、与锁定数量之和不超过库存数量;新增 interceptLockQuantity(作业锁迁移为拦截锁:locked -q、intercept +q、available 不变)/ interceptReceiveQuantity(实物返还并拦截锁定:quantity +q、intercept +q、available 不变)/ interceptUnlockQuantity(拦截锁释放回落可用:intercept -q、available +q)三个专用方法", + "app/service/systems/order_storage_allocation.js cancelAllocateStorage:新增 interceptMode 开关——拦截确认模式下 pending 行执行作业锁迁移(locked -q、intercept +q、available 不变)、fin 行实物返还并拦截锁定(quantity +q、intercept +q、available 不变),流水 order_type 记为 INTERCEPT_LOCK 并记录 order_id 与 before/after_intercept_locked_quantity 快照;普通取消模式行为不变;新增 releaseInterceptLocksByOrderIds:按 INTERCEPT_LOCK 与 INTERCEPT_UNLOCK 流水按 (storage_id, order_id) 汇总净拦截量,净量大于 0 时逐库存行调用 interceptUnlockQuantity 释放拦截锁(intercept -q、available +q),写入 order_type=INTERCEPT_UNLOCK 流水并记录快照,重复调用幂等(净量归零后不再释放)", + "app/service/systemMethods/order/recheckOrder.js confirmIntercept/interceptScan:释放储位分配改走 cancelAllocateStorage({ order_ids, interceptMode: true }),确认拦截时库存不再归还可用而是移入拦截锁定字段 intercept_locked_quantity;运单标记、订单状态、订单锁、工单、日志等其余口径不变", + "app/service/systemMethods/order/pendingOrder.js runBatchUninterceptTask:解除拦截不操作拦截锁定数量字段(业务上拦截→取消拦截均不动库存口径,拦截锁定数量仅在库内拦截确定时占用,回落由后续特定入库处理链路接管)", + "app/service/systems/return_received.js create:退货登记不释放拦截锁定库存(拦截锁回落由退货货物后续入库处理接管)", + "app/service/systems/stock_store.js search(with_stock)与 getStockDetail:storage 查询 attributes 显式加入 intercept_locked_quantity,按库位合并模式累加拦截锁定数量并按统一口径重算 available_quantity;合并明细响应新增 intercept_locked_quantity(向后兼容,默认 0)", + "methods/system.json 同步:stock.warehouse.getStockDetail response storageList 描述补充 intercept_locked_quantity 与 available_quantity 统一口径;stock.warehouse.search response storage 字段的库位分组汇总(children_grouped)与批次明细(children_batch)字段清单均新增 intercept_locked_quantity、available_quantity 口径说明更新为 quantity - locked_quantity - intercept_locked_quantity;order.recheckOrder.confirmIntercept / interceptScan 描述更新为拦截模式释放储位分配(库存不归还可用、移入拦截锁定);版本 0.3.67 -> 0.3.68(docMeta.version),updatedAt 保持 2026-09-01", + "核查结论:methods/qimen.json 与 methods/openapi.json 无涉及本改造的接口(openapi.json 仅 order.cancel 描述中出现 intercept_status 字面量,与本改造无关),未同步;stock.transaction.list / stock.transaction.storeList / stock.transaction.export 使用显式 SQL 列白名单(不含拦截锁定快照字段),响应不受影响,文档无需同步;storage.transaction.list(group_by_batch=true)明细模式因模型整行序列化隐含新增 before/after_intercept_locked_quantity,但其 response 文档为对象结构(更新脚本要求数组格式,与既有处理一致),本次未改写,其 list_detail 示例本非全量字段清单", + "本次仅文档同步,未修改 app/ 与 database/ 下任何代码与 migration,未执行数据库/Redis 操作,未运行测试" + ], + "module": "storage" + }, + { + "version": "2026.09.01-receiving-detail-stock-id", + "date": "2026-09-01", + "type": "changed", + "summary": "storage.receiving.getReceivingDetail 与 deleteDetail 明细项新增 stock_id 字段(与 system_product_id 语义一致,向后兼容)", + "methods": [ + "storage.receiving.getReceivingDetail", + "storage.receiving.deleteDetail" + ], + "notes": [ + "app/service/systems/storage/receiving.js getReceivingDetail:明细组装时新增 stock_id: detailBase.system_product_id ?? null(商品/库存ID,语义与 system_product_id 一致,缺失时为 null),system_product_id 保留向后兼容", + "app/service/systems/storage/receiving.js deleteDetail:删除后剩余明细 formattedDetails 每项同步新增 stock_id = detailData.system_product_id ?? null,与 getReceivingDetail 明细项字段保持一致", + "methods/system.json 收货单模块(module=storage_receiving):getReceivingDetail 响应新增 receiving.details.*.stock_id(number|null,语义与 system_product_id 一致,取 system_product_id、缺失为 null,system_product_id 保留向后兼容);deleteDetail 响应 data.details 描述补充 stock_id 说明;deleteDetail 按更新脚本规范补齐 response 各字段 required、errors 的 description 归一化为 message(语义不变);版本 0.3.66 -> 0.3.67(docMeta.version),updatedAt 保持 2026-09-01", + "AI_METHOD_ROUTING.md / AI_TOOLBOX.md 本次未同步:两者仅登记服务方法名清单,不含 getReceivingDetail/deleteDetail 的字段级描述,无需改动", + "本次仅文档同步(业务代码由 wms-dev-agent 完成),未修改 app/ 下任何代码,未执行数据库/Redis 操作,未运行测试" + ], + "module": "storage.receiving" + }, + { + "version": "2026.09.01-wms-storage-intercept-locked-quantity", + "date": "2026-09-01", + "type": "changed", + "summary": "wms_storage 库存表新增「拦截锁定数量」字段 intercept_locked_quantity(INTEGER(12) NOT NULL DEFAULT 0,comment 拦截锁定数量),用于拦截场景数量锁定、与 locked_quantity 区分;纯数据模型变更:无接口入参/错误码/鉴权变化,现有写入点由模型默认值 0 兜底;明细模式接口响应因模型整行序列化隐含新增该字段(当前恒为 0,暂无业务读写)。", + "methods": [ + "storage.inventory.listByStockId" + ], + "notes": [ + "database/migrations/20260901000000-add-intercept-locked-quantity-to-wms-storage.js:describeTable 幂等检测,缺省时 ALTER TABLE wms_storage ADD COLUMN intercept_locked_quantity INT(12) NOT NULL DEFAULT 0 COMMENT '拦截锁定数量';down 删除该字段", + "app/model/storage.js:在 locked_quantity 之后新增 intercept_locked_quantity 字段定义(INTEGER(12)/allowNull=false/defaultValue=0/comment 拦截锁定数量);现有写入点(quickPutaway/directPutaway/commit 等)不显式传该字段,依赖模型默认值 0 兜底", + "methods/system.json storage.inventory.listByStockId:data.list 明细行字段清单补充 intercept_locked_quantity(拦截锁定数量,默认 0);group_by_space=true 汇总行与 params/errors/isNeedAuth/isNeedLogin 均不变;版本 0.3.65 -> 0.3.66(docMeta.version),updatedAt 更新为 2026-09-01", + "storage.inventory.list(group_by_batch=true 明细模式)响应同样隐含新增该字段,但其 response 文档为对象结构(脚本校验要求数组格式),本次未改写;其 list_detail 示例本非全量字段清单(未列 is_enabled/delete_at/supplier_id 等),不构成文档缺口", + "storage.inventory.export(明细/汇总导出)、stock.warehouse.getStockDetail、库存报表 stockFlow 等查询均使用显式 attributes 白名单,不受该字段影响,文档无需同步", + "本次仅文档同步,未修改 app/ 与 database/ 下任何代码,未执行数据库/Redis 操作,未运行测试" + ], + "module": "storage" + }, { "version": "2026.08.31-report-stockflow-export-columns-restructure", "date": "2026-08-31", diff --git a/methods/system.json b/methods/system.json index 42ffecf..dfc5676 100644 --- a/methods/system.json +++ b/methods/system.json @@ -1,8 +1,8 @@ { "module": "system", "description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内", - "version": "0.3.65", - "updatedAt": "2026-08-31", + "version": "0.3.74", + "updatedAt": "2026-09-03", "headers": [ { "name": "platform", @@ -1808,6 +1808,130 @@ "message": "未找到该运单号对应的订单" } ] + }, + { + "method": "index.getWorkbenchBindCode", + "description": "获取工作台绑定码(免登录、免鉴权,参考 user.getLoginWechatCode):返回 client_code 并在缓存生成绑定码;不传 client_code 时分配新客户端编码并立即返回绑定码;传入 client_code 时进入长轮询等待 workbench.bind 完成,绑定成功后返回 token,等待超时/缓存失效时重新生成绑定码后才返回数据", + "isNeedAuth": false, + "isNeedLogin": false, + "headers": [], + "params": [ + { + "name": "clientCode", + "type": "string", + "required": false, + "source": "body", + "description": "客户端编码(6 位大写字母+数字);首次可不传,后续轮询建议透传已有值" + } + ], + "response": [ + { + "name": "client_code", + "type": "string", + "required": true, + "description": "客户端编码(6 位大写字母+数字)" + }, + { + "name": "code", + "type": "string", + "required": true, + "description": "缓存生成的绑定码(6 位大写字母+数字,供 workbench.bind 使用)" + }, + { + "name": "status", + "type": "string", + "required": true, + "description": "会话状态:pending 等待绑定 / bound 已绑定" + }, + { + "name": "workbench_id", + "type": "number", + "required": false, + "description": "已绑定的工作台ID(仅 bound 状态返回)" + }, + { + "name": "token", + "type": "string", + "required": false, + "description": "绑定成功后返回的工作台 token(64 位,仅 bound 状态返回)" + }, + { + "name": "updated_at", + "type": "string", + "required": true, + "description": "状态更新时间" + }, + { + "name": "expires_at", + "type": "string", + "required": false, + "description": "会话过期时间(ISO 字符串,可能为 null)" + }, + { + "name": "expire_after_ms", + "type": "number", + "required": true, + "description": "距离过期的剩余毫秒数" + } + ], + "errors": [ + { + "code": "400", + "message": "无效的客户端编码格式" + } + ] + }, + { + "method": "index.LoginWorkbenchByCode", + "description": "通过工作台登录码登录获取 token(免登录、免鉴权):以 wms_workbench.login_code 为入参查询工作台,命中则返回其 token(工作台尚无 token 时自动生成并持久化,等价补绑定),并将 token 信息写入 workbench:token:{token} 缓存;无匹配工作台返回失败(flag=failure、code=403)", + "isNeedAuth": false, + "isNeedLogin": false, + "headers": [], + "params": [ + { + "name": "loginCode", + "type": "string", + "required": true, + "source": "body", + "description": "工作台登录码(前缀 wblc + 随机段共 64 位,兼容 login_code 驼峰/下划线两种入参名)" + } + ], + "response": [ + { + "name": "id", + "type": "number", + "required": true, + "description": "工作台ID" + }, + { + "name": "workbench_id", + "type": "number", + "required": true, + "description": "工作台ID(同 id)" + }, + { + "name": "name", + "type": "string", + "required": true, + "description": "工作台名称" + }, + { + "name": "token", + "type": "string", + "required": true, + "description": "工作台 token(64 位)" + } + ], + "errors": [ + { + "code": "400", + "message": "login_code 不能为空" + }, + { + "code": "403", + "message": "工作台不存在或登录码无效(返回 flag=failure、code=403)" + } + ] } ] }, @@ -3068,7 +3192,7 @@ }, { "method": "order.pendingOrder.detail", - "description": "查询单个订单详情,返回订单头、商品明细和运单信息", + "description": "查询单个订单详情,返回订单头、商品明细和运单信息;忽略传入的表位参数,固定先查配送表(dispatch),查不到再兜底查询待处理表(current)", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -3092,24 +3216,19 @@ "type": "string", "required": false, "source": "body", - "description": "可选,指定订单表类型,支持 current/history/dispatch/outsourced/order/revieworder/pendingorder 等" + "description": "已忽略:本接口固定先查配送表(dispatch),查不到再兜底待处理表(current),传入该参数不生效" } ], "response": [ - { - "name": "order", - "type": "object", - "description": "订单头对象(raw 行数据)" - }, { "name": "detail", "type": "object", - "description": "等同于 order" + "description": "订单头对象(raw 行数据,来自配送表或兜底的待处理表)" }, { "name": "orderItems / items", "type": "array", - "description": "商品明细数组" + "description": "商品明细数组(以库存标准格式为主,附 plan_qty / order_line_no / stock_id / order_item_id / order_id 及拣货库位 picking_locations)" }, { "name": "expresses", @@ -3117,9 +3236,9 @@ "description": "运单信息数组" }, { - "name": "waybill_codes", + "name": "storage_items", "type": "array", - "description": "去重后的运单号字符串数组" + "description": "按库位平铺的储位分配明细(附商品编码、名称、规格、单位等库存信息)" } ], "errors": [ @@ -5250,7 +5369,7 @@ }, { "method": "order.pendingOrder.batchUnintercept", - "description": "批量提交解除拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'none' 并写入操作日志(ORDER_INTERCEPT_CANCEL)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。", + "description": "批量提交解除拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'none' 并写入操作日志(ORDER_INTERCEPT_CANCEL)。不操作库存拦截锁定数量字段。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -6120,7 +6239,7 @@ }, { "method": "order.recheckOrder.confirmIntercept", - "description": "确认拦截:通过订单 ID 列表批量匹配订单,将拦截状态更新为 intercepted_at_warehouse(仓库已拦截,step=4、outbound_status=fin),同步标记运单退回与拦截(is_back='Y', is_intercept='Y'),并释放储位分配(cancelAllocateStorage)与订单锁(lock_status=none)。仅拦截当前指定订单,不波及波次内其他订单。前置条件:订单必须处于拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容),未发起拦截(none/空)的订单直接静默跳过不参与处理,已确认拦截(intercepted_at_warehouse)及其它非可确认状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/cancelled/failed/exception)一律跳过并记录失败原因;更新 SQL 的 where 同时限定拦截状态白名单,防止并发修改导致误更新。支持部分失败:未找到的订单与处理失败的订单记录在 failed 列表并返回失败原因,其余订单继续处理。全部订单处理完后按成功订单 ID 汇总批量创建售后工单 + 通知快递群。每个订单操作成功后写入操作日志(ORDER_INTERCEPT_CONFIRM)。运单标记、储位释放、锁释放、工单创建、日志写入失败均不影响主流程。", + "description": "确认拦截:通过订单 ID 列表批量匹配订单,将拦截状态更新为 intercepted_at_warehouse(仓库已拦截,step=4、outbound_status=fin),同步标记运单退回与拦截(is_back='Y', is_intercept='Y'),并释放储位分配(cancelAllocateStorage 拦截模式 interceptMode=true:库存不归还可用,移入拦截锁定字段 intercept_locked_quantity)与订单锁(lock_status=none)。仅拦截当前指定订单,不波及波次内其他订单。前置条件:订单必须处于拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容),未发起拦截(none/空)的订单直接静默跳过不参与处理,已确认拦截(intercepted_at_warehouse)及其它非可确认状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/cancelled/failed/exception)一律跳过并记录失败原因;更新 SQL 的 where 同时限定拦截状态白名单,防止并发修改导致误更新。支持部分失败:未找到的订单与处理失败的订单记录在 failed 列表并返回失败原因,其余订单继续处理。全部订单处理完后按成功订单 ID 汇总批量创建售后工单 + 通知快递群。每个订单操作成功后写入操作日志(ORDER_INTERCEPT_CONFIRM)。运单标记、储位释放、锁释放、工单创建、日志写入失败均不影响主流程。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -6215,7 +6334,7 @@ }, { "method": "order.recheckOrder.interceptScan", - "description": "拦截扫描:通过运单号查找运单记录。非拦截订单会被拒绝并提示「非拦截订单」:运单记录不存在,或运单 is_intercept≠'Y' 且关联订单 intercept_status 不在 requested/intercepting。校验通过后标记退回与拦截(is_back='Y', is_intercept='Y'),处理关联的未完结售后工单(写入「库内拦截成功」步骤并置为 completed)。若运单关联到订单,则将订单拦截状态更新为 intercepted_at_warehouse(step=4、outbound_status=fin)并释放储位分配与订单锁(仅订单级状态更新,不标记订单下其他面单)。工单处理失败不阻断主流程。", + "description": "拦截扫描:通过运单号查找运单记录。非拦截订单会被拒绝并提示「非拦截订单」:运单记录不存在,或运单 is_intercept≠'Y' 且关联订单 intercept_status 不在 requested/intercepting。校验通过后标记退回与拦截(is_back='Y', is_intercept='Y'),处理关联的未完结售后工单(写入「库内拦截成功」步骤并置为 completed)。若运单关联到订单,则将订单拦截状态更新为 intercepted_at_warehouse(step=4、outbound_status=fin)并释放储位分配(拦截模式:库存不归还可用,移入拦截锁定字段 intercept_locked_quantity)与订单锁(仅订单级状态更新,不标记订单下其他面单)。工单处理失败不阻断主流程。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -7005,6 +7124,174 @@ ], "errors": [] }, + { + "method": "order.packing.export", + "description": "提交打包任务导出任务(异步)。入参 where/sort 语义与 order.packing.list 一致;warehouse_id 由服务端从 ctx.user.store_id 注入,禁止前端传入。提交后立即返回 task_id,后台异步生成单 Sheet Excel(Sheet1「打包任务列表」)并上传,导出进度/下载请通过 order.packing.exportTaskProgress 查询。数据来源 wms_pack_task 主表 + wms_pack_task_video 视频副表 + wms_workbench 工作台 + wms_order_express 运单表;Excel 列含任务ID/订单ID/波次号/运单号/关联运单号/打包模式/任务状态/打包数量/商品总数量/商品种类数/工作台/作业人员/开始打包时间/结束打包时间/创建时间/视频状态/录像可用/备注;全量分页拉取,无行数上限。任务缓存 Redis TTL 30 分钟;状态口径 submitted → running → 数据拉取(10~30) → 关联拉取(30~55) → Excel(55~90) → 上传(92) → success(100),失败 failed + error。免权限免日志免鉴权口径与 order.export 一致。", + "isNeedAuth": false, + "isNeedLogin": true, + "headers": [], + "params": [ + { + "name": "where", + "type": "object", + "required": false, + "source": "body", + "description": "查询条件,语义与 order.packing.list 的 where 一致(支持 {operator,value,type} 标准结构或直接值;字段含 status/pack_mode/waybill_code/wave_no/order_id/workbench_id/quickWhere/has_video/video_enable/start_time/end_time/create_time 等);禁止传入 warehouse_id/warehouseId(服务端注入)" + }, + { + "name": "sort", + "type": "object", + "required": false, + "source": "body", + "description": "排序参数,语义与 order.packing.list 的 sort 一致:sortField 白名单 id/order_id/warehouse_id/workbench_id/wave_id/pack_quantity/pack_mode/status/start_time/end_time/create_time/update_time,sortOrder asc/desc,默认 create_time desc" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成,格式 packing_export_{warehouseId}_{timestamp}_{random})" + }, + { + "name": "status", + "type": "string", + "required": true, + "description": "任务状态,枚举:submitted/running/success/failed/not_found(提交成功时为 submitted)" + }, + { + "name": "progress", + "type": "number", + "required": true, + "description": "当前进度百分比(0-100),提交时返回 0" + }, + { + "name": "current_count", + "type": "number", + "required": true, + "description": "当前已处理记录数(打包任务条数)" + }, + { + "name": "total_count", + "type": "number", + "required": true, + "description": "总记录数(若有)" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "任务提示信息" + }, + { + "name": "result", + "type": "object", + "required": true, + "description": "任务执行结果(提交时为 null;后台完成后为上传信息对象,含 filename/url/fileKey/cdnUrl/cosUrl/current_count/total_count/sheet_count)" + }, + { + "name": "error", + "type": "string", + "required": true, + "description": "失败时的错误信息(可选,非失败时为空字符串)" + }, + { + "name": "update_time", + "type": "number", + "required": true, + "description": "任务更新时间(Unix 毫秒时间戳)" + } + ], + "errors": [ + { + "code": "400", + "message": "参数格式不正确或 where 条件非法" + }, + { + "code": "500", + "message": "导出任务提交失败" + } + ] + }, + { + "method": "order.packing.exportTaskProgress", + "description": "按 task_id 查询打包任务导出任务进度,返回 task_id、status、progress、current_count、total_count、message、result、error、download_url、update_time;上传完成后 download_url 返回下载链接(从 result.url/cdnUrl/cosUrl/fileKey 兜底取);任务缓存 Redis TTL 30 分钟,task_id 缺失或缓存未命中时 status=not_found(正常响应,非报错)。状态口径 submitted → running → 数据拉取(10~30) → 关联拉取(30~55) → Excel(55~90) → 上传(92) → success(100),失败 failed + error。免权限免日志口径与 order.exportTaskProgress 一致。", + "isNeedAuth": false, + "isNeedLogin": true, + "headers": [], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "source": "body|query", + "description": "任务 ID,兼容 task_id(下划线)与 taskId(驼峰)两种写法" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(task_id 缺失时为回显的空字符串,status=not_found)" + }, + { + "name": "status", + "type": "string", + "required": true, + "description": "任务状态:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": true, + "description": "进度百分比(0-100)" + }, + { + "name": "current_count", + "type": "number", + "required": true, + "description": "当前已处理记录数(打包任务条数)" + }, + { + "name": "total_count", + "type": "number", + "required": true, + "description": "总记录数" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "任务提示信息" + }, + { + "name": "result", + "type": "object", + "required": true, + "description": "任务执行结果对象(完成后含 filename/url/fileKey/cdnUrl/cosUrl 等;未完成或 not_found 时为 null)" + }, + { + "name": "error", + "type": "string", + "required": true, + "description": "失败时的错误信息(可选,非失败时为空字符串)" + }, + { + "name": "download_url", + "type": "string", + "required": true, + "description": "任务完成后下载链接(从 result.url/cdnUrl/cosUrl/fileKey 兜底取);未完成或不存在时为空字符串" + }, + { + "name": "update_time", + "type": "number", + "required": true, + "description": "最近一次状态更新时间(Unix 毫秒时间戳)" + } + ], + "errors": [] + }, { "method": "order.packing.get", "description": "打包任务详情查询。按 id + warehouse_id 查询单条打包任务记录,含工作台、视频和运单关联信息。", @@ -14012,6 +14299,24 @@ "type": "number", "required": false, "description": "默认库位(库位ID,未配置时为 null)" + }, + { + "name": "subject_config.cutoff_order_enabled", + "type": "number", + "required": false, + "description": "启用截单(flag:0=关闭,1=开启;默认 1)。启用后订单创建时间早于开始自动分配时间或超过截单时间(开始时间晚于截单时间时截单时间视为次日),不再自动分配快递和储位、不再自动加团" + }, + { + "name": "subject_config.allocate_start_time", + "type": "string", + "required": false, + "description": "开始自动分配时间,格式 HH:mm,默认 08:00,范围 00:00-23:59;作为自动分配初始时间,当前时间早于该时间与超过截单时间行为一致(不自动分配快递和储位、不自动加团)" + }, + { + "name": "subject_config.cutoff_order_time", + "type": "string", + "required": false, + "description": "截单时间,格式 HH:mm,默认 18:00,范围 00:00-23:59;作为最后允许自动分配的时间,开始时间晚于截单时间时截单时间视为次日(跨天窗口)" } ], "errors": [ @@ -14290,6 +14595,27 @@ "required": false, "source": "body.subject_config", "description": "默认库位(库位ID,须属于当前仓库且未删除、已启用,否则报 400;传 null 清空)" + }, + { + "name": "subject_config.cutoff_order_enabled", + "type": "number", + "required": false, + "source": "body.subject_config", + "description": "启用截单(flag:0=关闭,1=开启;默认 1)。启用后订单创建时间早于开始自动分配时间或超过截单时间(开始时间晚于截单时间时截单时间视为次日),不再自动分配快递和储位、不再自动加团" + }, + { + "name": "subject_config.allocate_start_time", + "type": "string", + "required": false, + "source": "body.subject_config", + "description": "开始自动分配时间,格式 HH:mm,默认 08:00,范围 00:00-23:59;作为自动分配初始时间,当前时间早于该时间与超过截单时间行为一致(不自动分配快递和储位、不自动加团)。与截单时间相同(自动分配窗口为空)时报 400" + }, + { + "name": "subject_config.cutoff_order_time", + "type": "string", + "required": false, + "source": "body.subject_config", + "description": "截单时间,格式 HH:mm,默认 18:00,范围 00:00-23:59;作为最后允许自动分配的时间,开始时间晚于截单时间时截单时间视为次日(跨天窗口)" } ], "response": [ @@ -17236,17 +17562,20 @@ { "name": "stockItem", "type": "object", - "description": "商品概要,包含 id、item_code、item_name、sku_property、stock_unit、quantity、locked_quantity 等" + "description": "商品概要,包含 id、item_code、item_name、sku_property、stock_unit、quantity、locked_quantity 等", + "required": true }, { "name": "storageList", "type": "array", - "description": "库存明细数组;group_by_batch=true 返回 wms_storage 明细(含 batch_no、production_date、expiry_date、inbound_time、inbound_order_no、supplier_batch_no 等),group_by_batch=false 时按库位合并,批次相关字段为 null" + "description": "库存明细数组;group_by_batch=true 返回 wms_storage 明细(含 batch_no、production_date、expiry_date、inbound_time、inbound_order_no、supplier_batch_no 等),group_by_batch=false 时按库位合并(批次相关字段为 null),合并明细含 intercept_locked_quantity(拦截锁定数量,默认 0),available_quantity 统一口径 = quantity - locked_quantity - intercept_locked_quantity", + "required": true }, { "name": "pagination", "type": "object", - "description": "分页信息,包含 page、pageSize、total" + "description": "分页信息,包含 page、pageSize、total", + "required": true } ], "errors": [] @@ -18159,10 +18488,16 @@ "description": "该库位总锁定数量", "required": false }, + { + "name": "intercept_locked_quantity", + "type": "number", + "description": "该库位拦截锁定数量(拦截确认时不归还可用、移入该字段)", + "required": false + }, { "name": "available_quantity", "type": "number", - "description": "可用数量(quantity - locked_quantity)", + "description": "可用数量(quantity - locked_quantity - intercept_locked_quantity)", "required": false }, { @@ -18218,6 +18553,12 @@ "description": "锁定数量", "required": false }, + { + "name": "intercept_locked_quantity", + "type": "number", + "description": "拦截锁定数量(默认 0)", + "required": false + }, { "name": "available_quantity", "type": "number", @@ -18596,6 +18937,12 @@ "required": false, "description": "商品库存ID数组,为空或未传表示不筛选" }, + { + "name": "keyword", + "type": "string", + "required": false, + "description": "快捷搜索关键字,支持按商品编码(item_code)、商品名称(item_name)、货物编码(goods_code)、条码(barcode)、SKU ID 模糊匹配。以当前登录货主 store_id 为主维度解析为 stock_id 列表后以 IN 条件合并查询。与 stock_ids 互斥(keyword 优先)" + }, { "name": "transaction_type", "type": "string", @@ -20486,7 +20833,7 @@ "list": [ { "method": "storage.receiving.getReceivingList", - "description": "查询收货单列表,支持分页和多条件筛选。支持 filterDepleted 参数过滤掉无可再用量的收货单(所有明细已被其他入库单 committed 绑定占满)。支持 entry_order_id 参数按入库单商品交集过滤。支持 stock_query_where 参数按商品条码/编码/ID 过滤。", + "description": "查询收货单列表,支持分页和多条件筛选。支持 filterDepleted 参数过滤掉无可再用量的收货单(所有明细已被其他入库单 committed 绑定占满)。支持 entry_order_id 参数按入库单商品交集过滤。支持 stock_query_where 参数按商品条码/编码/ID 过滤。列表每项包含 store_name(货主名称,实时解析:合约表 wms_store_warehouse.store_remask 优先、无合约或备注为空时回退 wms_store.company_name 公司全称,均无时保留主表快照,可能为空字符串)。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -20671,12 +21018,24 @@ "required": true, "description": "收货单详情(含 details、images、pagination)" }, + { + "name": "receiving.store_name", + "type": "string", + "required": false, + "description": "货主名称(string,可空)。优先取合约表 wms_store_warehouse.store_remask(货主备注名称,按 store_id + warehouse_id 维度),无合约或备注为空时回退 wms_store.company_name(公司全称),均无时保留主表快照(可能为空字符串)。" + }, { "name": "receiving.details", "type": "array", "required": false, "description": "收货单明细列表,单条记录包含明细字段(见下文)" }, + { + "name": "receiving.details.*.stock_id", + "type": "number", + "required": false, + "description": "商品/库存ID(number|null),语义与 system_product_id 一致,取值为 system_product_id,缺失时为 null;system_product_id 保留,向后兼容。" + }, { "name": "receiving.details.*.space_id", "type": "string", @@ -21581,41 +21940,46 @@ { "name": "code", "type": "number", + "required": true, "description": "业务状态码,200 表示成功,400/404/500 表示失败" }, { "name": "message", "type": "string", + "required": true, "description": "简短的错误或成功信息" }, { "name": "data", "type": "object", + "required": true, "description": "成功时返回的结果对象" }, { "name": "data.details", "type": "array", - "description": "删除后收货单剩余的明细数组。每项字段与 storage.receiving.getReceivingDetail 返回的明细项一致;product_snapshot 为解析后的对象或 null" + "required": true, + "description": "删除后收货单剩余的明细数组。每项字段与 storage.receiving.getReceivingDetail 返回的明细项一致(含新增的 stock_id,语义同 getReceivingDetail,number|null);product_snapshot 为解析后的对象或 null" }, { "name": "data.selectId", "type": "number|null", + "required": true, "description": "删除后建议前端选中的明细 ID;无剩余明细时为 null" } ], "errors": [ { "code": "404", - "description": "明细不存在(或非创建者/仓库无权访问)" + "message": "明细不存在(或非创建者/仓库无权访问)" }, { "code": "400", - "description": "收货单已完成或已取消,禁止删除明细;或该明细已入库或已被占用,删除失败" + "message": "收货单已完成或已取消,禁止删除明细;或该明细已入库或已被占用,删除失败" }, { "code": "500", - "description": "服务器内部错误或删除异常(含数据库写入/事务异常)" + "message": "服务器内部错误或删除异常(含数据库写入/事务异常)" } ] }, @@ -24793,7 +25157,7 @@ "name": "data.list", "type": "array", "required": true, - "description": "库存数组(quantity > 1,按 id 倒序)。group_by_space=false 时为明细行,每项字段:id、warehouse_id、store_id、space_id、stock_id、batch_no、inventory_type、quantity、locked_quantity、available_quantity、production_date、expiry_date、inbound_time、inbound_order_no、receiving_id、entry_order_id、supplier_id、supplier_batch_no、is_enabled、created_at、updated_at、delete_at;stock 对象(id/item_code/item_name/sku_property/stock_unit/is_shelf_life_mgmt/remaining_threshold_days/is_batch_mgmt_enabled/store_name/barcodes/images);space 对象(id/space_code/custom_name);顶层 store_name(货主名称);is_shelf_life_warning_triggered(效期预警是否触发);expiry_remaining_days/inventory_warning_level/inventory_warning_color/inventory_warning_range/inventory_warning_tip_text(库存预警字段,无预警时为 null)。group_by_space=true 时为按库位汇总行,每项字段:warehouse_id、store_id、space_id、stock_id、quantity/locked_quantity/available_quantity(汇总值)、batch_count(批次数)、first_inbound_time(最早入库时间)、last_inbound_time(最晚入库时间)、stock 对象、space 对象、顶层 store_name;不含批次与效期/预警字段" + "description": "库存数组(quantity > 1,按 id 倒序)。group_by_space=false 时为明细行,每项字段:id、warehouse_id、store_id、space_id、stock_id、batch_no、inventory_type、quantity、locked_quantity、intercept_locked_quantity(拦截锁定数量,默认 0)、available_quantity、production_date、expiry_date、inbound_time、inbound_order_no、receiving_id、entry_order_id、supplier_id、supplier_batch_no、is_enabled、created_at、updated_at、delete_at;stock 对象(id/item_code/item_name/sku_property/stock_unit/is_shelf_life_mgmt/remaining_threshold_days/is_batch_mgmt_enabled/store_name/barcodes/images);space 对象(id/space_code/custom_name);顶层 store_name(货主名称);is_shelf_life_warning_triggered(效期预警是否触发);expiry_remaining_days/inventory_warning_level/inventory_warning_color/inventory_warning_range/inventory_warning_tip_text(库存预警字段,无预警时为 null)。group_by_space=true 时为按库位汇总行,每项字段:warehouse_id、store_id、space_id、stock_id、quantity/locked_quantity/available_quantity(汇总值)、batch_count(批次数)、first_inbound_time(最早入库时间)、last_inbound_time(最晚入库时间)、stock 对象、space 对象、顶层 store_name;不含批次与效期/预警字段" } ], "errors": [ @@ -26692,7 +27056,7 @@ }, { "method": "storeWarehouse.store.getPolicyConfigFields", - "description": "获取签约策略可配置字段元信息列表", + "description": "获取签约策略可配置字段元信息列表(含自动分配时间窗口字段)", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -26704,7 +27068,32 @@ } ], "params": [], - "response": [], + "response": [ + { + "name": "data", + "type": "array", + "required": true, + "description": "字段元信息数组,每项含 key/name/type/default/required/description/min/max/maxLength/options 等" + }, + { + "name": "data[].cutoff_order_enabled", + "type": "object", + "required": false, + "description": "启用截单字段元信息:key=cutoff_order_enabled,type=flag,default=1;启用后订单创建时间早于开始自动分配时间或超过截单时间(开始时间晚于截单时间时截单时间视为次日),不再自动分配快递和储位、不再自动加团" + }, + { + "name": "data[].allocate_start_time", + "type": "object", + "required": false, + "description": "开始自动分配时间字段元信息:key=allocate_start_time,type=string,default=08:00,min=00:00,max=23:59,maxLength=5;早于该时间的订单与超过截单时间行为一致,不自动分配快递和储位、不自动加团;开始时间晚于截单时间时截单时间视为次日(跨天窗口)" + }, + { + "name": "data[].cutoff_order_time", + "type": "object", + "required": false, + "description": "截单时间字段元信息:key=cutoff_order_time,type=string,default=18:00,min=00:00(下限已从 12:00 放开,支持凌晨截单/跨天窗口),max=23:59,maxLength=5" + } + ], "errors": [] }, { @@ -26733,7 +27122,7 @@ "type": "object", "required": true, "source": "body", - "description": "策略配置对象;支持 receive_mode、auto_allocate_bin、auto_allocate_express(是否自动分配快递)、auto_allocate_storage(是否自动分配储位)、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)、enable_external_express_code(是否启用外部快递编码,flag:0=关闭,1=开启;默认 0)" + "description": "策略配置对象;支持 receive_mode、auto_allocate_bin、auto_allocate_express(是否自动分配快递)、auto_allocate_storage(是否自动分配储位)、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)、enable_external_express_code(是否启用外部快递编码,flag:0=关闭,1=开启;默认 0)、cutoff_order_enabled(启用截单,flag:0=关闭,1=开启;默认 1)、cutoff_order_time(截单时间,HH:mm,默认 18:00,范围 00:00-23:59)、allocate_start_time(开始自动分配时间,HH:mm,默认 08:00,范围 00:00-23:59;开始时间晚于截单时间时截单时间视为次日)" }, { "name": "policy_config.enable_external_express_code", @@ -26741,6 +27130,27 @@ "required": false, "source": "body.policy_config", "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + }, + { + "name": "policy_config.cutoff_order_enabled", + "type": "number", + "required": false, + "source": "body.policy_config", + "description": "启用截单(flag:0=关闭,1=开启;默认 1)。启用后订单创建时间早于开始自动分配时间或超过截单时间(开始时间晚于截单时间时截单时间视为次日),不再自动分配快递和储位、不再自动加团" + }, + { + "name": "policy_config.cutoff_order_time", + "type": "string", + "required": false, + "source": "body.policy_config", + "description": "截单时间,格式 HH:mm,默认 18:00,范围 00:00-23:59;作为最后允许自动分配的时间,开始时间晚于截单时间时截单时间视为次日(跨天窗口)" + }, + { + "name": "policy_config.allocate_start_time", + "type": "string", + "required": false, + "source": "body.policy_config", + "description": "开始自动分配时间,格式 HH:mm,默认 08:00,范围 00:00-23:59;作为自动分配初始时间,当前时间早于该时间与超过截单时间行为一致(不自动分配快递和储位、不自动加团)。与截单时间相同(自动分配窗口为空)时报 400" } ], "response": [ @@ -26761,9 +27171,20 @@ "type": "number", "required": true, "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + }, + { + "name": "data.policy_config.allocate_start_time", + "type": "string", + "required": true, + "description": "保存后并补齐默认值的开始自动分配时间(HH:mm,默认 08:00)" } ], - "errors": [] + "errors": [ + { + "code": "400", + "message": "参数不合法:policy_config.allocate_start_time 与 policy_config.cutoff_order_time 相同(自动分配窗口为空)时拒绝保存;时间字段格式必须为 HH:mm" + } + ] }, { "method": "storeWarehouse.store.listApiConfig", @@ -31324,7 +31745,7 @@ "list": [ { "method": "workbench.list", - "description": "查询工作台列表(仓库隔离,支持分页与关键词筛选)", + "description": "查询工作台列表(仓库隔离,支持分页与关键词筛选;列表项返回 login_code,不返回 token)", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -31388,6 +31809,11 @@ "type": "string", "description": "备注" }, + { + "name": "login_code", + "type": "string", + "description": "工作台登录码(前缀 wblc + 随机段共 64 位,创建时自动生成)" + }, { "name": "created_at", "type": "string", @@ -31410,7 +31836,7 @@ "errors": [ { "code": "400", - "description": "参数格式错误或缺少仓库上下文" + "message": "参数格式错误或缺少仓库上下文" } ] }, @@ -31457,7 +31883,7 @@ }, { "method": "workbench.create", - "description": "新增工作台(仓库隔离,条码仓库内唯一)", + "description": "新增工作台(仓库隔离,条码仓库内唯一);创建时自动生成 login_code(前缀 wblc + 随机段共 64 位,全局唯一),不接受外部传入 login_code", "isNeedAuth": true, "isNeedLogin": true, "headers": [ @@ -31503,23 +31929,23 @@ "name": "data", "type": "object", "required": true, - "description": "新建的工作台对象" + "description": "新建的工作台对象(含自动生成的 login_code)" } ], "errors": [ { "code": "400", - "description": "工作台名称不能为空" + "message": "工作台名称不能为空" }, { "code": "400", - "description": "条码已存在(仓库内唯一约束)" + "message": "条码已存在(仓库内唯一约束)" } ] }, { "method": "workbench.update", - "description": "更新工作台信息(仓库隔离)", + "description": "更新工作台信息(仓库隔离);login_code / token 不允许编辑,传入 login_code 不予受理", "isNeedAuth": true, "isNeedLogin": true, "headers": [ @@ -31578,11 +32004,11 @@ "errors": [ { "code": "400", - "description": "工作台ID不能为空" + "message": "工作台ID不能为空" }, { "code": "404", - "description": "工作台不存在或无权操作" + "message": "工作台不存在或无权操作" } ] }, @@ -31943,6 +32369,209 @@ "message": "工作台不存在或无权操作" } ] + }, + { + "method": "workbench.bind", + "description": "工作台绑定(需登录、需权限):入参缓存生成的绑定码 code 与工作台ID id,校验绑定码有效且工作台归属当前仓库后完成关联绑定;成功后在工作台写入随机生成的 64 位 token(若工作台已有 token,删除旧 workbench:token:{旧token} 缓存并写入新 token 缓存),同时更新绑定会话状态为已绑定,供 index.getWorkbenchBindCode 长轮询返回 token", + "isNeedAuth": true, + "isNeedLogin": true, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "code", + "type": "string", + "required": true, + "source": "body", + "description": "缓存生成的绑定码(6 位大写字母+数字)" + }, + { + "name": "id", + "type": "number", + "required": true, + "source": "body", + "description": "要绑定的工作台ID" + } + ], + "response": [ + { + "name": "id", + "type": "number", + "required": true, + "description": "工作台ID" + }, + { + "name": "workbench_id", + "type": "number", + "required": true, + "description": "工作台ID(同 id)" + }, + { + "name": "token", + "type": "string", + "required": true, + "description": "随机生成的工作台 token(64 位)" + } + ], + "errors": [ + { + "code": "400", + "message": "绑定码格式无效" + }, + { + "code": "400", + "message": "工作台ID不能为空或无效" + }, + { + "code": "400", + "message": "绑定码不存在或已过期" + }, + { + "code": "404", + "message": "工作台不存在或无权操作" + } + ] + }, + { + "method": "workbench.getWorkbenchInfo", + "description": "使用 token 获取工作台信息(免登录、免鉴权):先查缓存 workbench:token:{token},未命中则按 token 查库并回填缓存后返回工作台信息(不含 token/login_code);token 不存在或无对应工作台返回失败(flag=failure、code=403)", + "isNeedAuth": false, + "isNeedLogin": false, + "headers": [], + "params": [ + { + "name": "token", + "type": "string", + "required": true, + "source": "body", + "description": "工作台 token(64 位)" + } + ], + "response": [ + { + "name": "id", + "type": "number", + "required": true, + "description": "工作台ID" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "仓库ID" + }, + { + "name": "name", + "type": "string", + "required": true, + "description": "工作台名称" + }, + { + "name": "barcode", + "type": "string", + "required": false, + "description": "工作台条码" + }, + { + "name": "status", + "type": "number", + "required": true, + "description": "状态:0-禁用 1-启用" + }, + { + "name": "type", + "type": "string", + "required": true, + "description": "工作台类型:personal-个人工作台 group-团体工作台" + }, + { + "name": "remark", + "type": "string", + "required": false, + "description": "备注" + }, + { + "name": "device_ids", + "type": "array", + "required": false, + "description": "设备ID列表" + }, + { + "name": "created_at", + "type": "string", + "required": true, + "description": "创建时间" + }, + { + "name": "updated_at", + "type": "string", + "required": true, + "description": "更新时间" + } + ], + "errors": [ + { + "code": "400", + "message": "token 不能为空" + }, + { + "code": "403", + "message": "工作台不存在或 token 无效(返回 flag=failure、code=403)" + } + ] + }, + { + "method": "workbench.resetLoginCode", + "description": "重置工作台登录码(需登录、需权限):随机生成新的 login_code(前缀 wblc + 随机段共 64 位)并写入数据库,旧 login_code 随即失效(token 不变)", + "isNeedAuth": true, + "isNeedLogin": true, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "id", + "type": "number", + "required": true, + "source": "body", + "description": "工作台ID(必填)" + } + ], + "response": [ + { + "name": "id", + "type": "number", + "required": true, + "description": "工作台ID" + }, + { + "name": "login_code", + "type": "string", + "required": true, + "description": "重置后的登录码(前缀 wblc + 随机段共 64 位)" + } + ], + "errors": [ + { + "code": "400", + "message": "工作台ID不能为空或无效" + }, + { + "code": "404", + "message": "工作台不存在或无权操作" + } + ] } ] }, @@ -37280,7 +37909,7 @@ "list": [ { "method": "returnReceived.create", - "description": "退回包裹扫码登记。30日内同仓库同单号只写一次(以第一次为准);反查 wms_order_express 判定是否原单退回,命中则回填 order_express_id/order_id/store_id 并同步标记 is_back='Y'。仓库隔离:warehouse_id 由服务端注入 ctx.user.store_id,禁止前端传入。", + "description": "退回包裹扫码登记。30日内同仓库同单号只写一次(以第一次为准);反查 wms_order_express 判定是否原单退回,命中则回填 order_express_id/order_id/store_id 并同步标记 is_back='Y',同步处理关联拦截工单、更新订单拦截状态(不释放拦截锁定库存,拦截锁回落由后续入库处理链路接管)。仓库隔离:warehouse_id 由服务端注入 ctx.user.store_id,禁止前端传入。", "isNeedAuth": true, "isNeedLogin": true, "headers": [], @@ -37533,6 +38162,195 @@ "message": "登记记录不存在" } ] + }, + { + "method": "returnReceived.export", + "description": "提交退回收到登记列表导出任务(异步)。入参 where/sort 语义与 returnReceived.list 一致;warehouse_id 由服务端从 ctx.user.store_id 注入,禁止前端传入。提交后立即返回 task_id,后台异步生成单 Sheet Excel(Sheet「退回收到登记列表」)并上传,导出进度/下载请通过 returnReceived.exportTaskProgress 查询。数据来源 wms_return_received 登记表;Excel 列:运单号/扫描日期/扫描人员/是否原单退回/订单ID/货主备注/备注/登记时间/更新时间。全量分页拉取(500/页,无行数上限);任务缓存 Redis TTL 30 分钟;状态口径 submitted → running(5) → 数据拉取(10~55,未命中数据时直接 85) → Excel 生成(60) → success(100),失败 failed + error。权限口径:默认走 API 权限校验(需 wms_permission 存在 returnReceived.export 类型为 api 的记录),需登录。", + "isNeedAuth": true, + "isNeedLogin": true, + "headers": [], + "params": [ + { + "name": "where", + "type": "object", + "required": false, + "source": "body", + "description": "查询条件,语义与 returnReceived.list 的 where 一致(支持 {operator,value} 标准结构或直接值;字段含 waybill_code 模糊、scan_date 范围、scanner_id/store_id/order_express_id/order_id/scanner_name 等值、is_original_return 是否原单退回);禁止传入 warehouse_id/warehouseId(服务端注入)" + }, + { + "name": "sort", + "type": "object", + "required": false, + "source": "body", + "description": "排序参数,语义与 returnReceived.list 的 sort 一致:sortField 白名单 id/scan_date/created_at/updated_at/waybill_code,sortOrder asc/desc,默认 created_at desc" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成,格式 return_received_export_{warehouseId}_{timestamp}_{random})" + }, + { + "name": "status", + "type": "string", + "required": true, + "description": "任务状态,枚举:submitted/running/success/failed/not_found(提交成功时为 submitted)" + }, + { + "name": "progress", + "type": "number", + "required": true, + "description": "当前进度百分比(0-100),提交时返回 0" + }, + { + "name": "current_count", + "type": "number", + "required": true, + "description": "当前已处理记录数(登记记录条数)" + }, + { + "name": "total_count", + "type": "number", + "required": true, + "description": "总记录数(若有)" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "任务提示信息" + }, + { + "name": "result", + "type": "object", + "required": true, + "description": "任务执行结果(提交时为 null;后台完成后为上传信息对象,含 filename/url/fileKey/cdnUrl/cosUrl/current_count/total_count)" + }, + { + "name": "error", + "type": "string", + "required": true, + "description": "失败时的错误信息(非失败时为空字符串)" + }, + { + "name": "update_time", + "type": "number", + "required": true, + "description": "任务更新时间(Unix 毫秒时间戳)" + } + ], + "errors": [ + { + "code": "400", + "message": "参数格式不正确、where 条件非法或缺少仓库上下文" + }, + { + "code": "401", + "message": "未提供有效的认证令牌" + }, + { + "code": "403", + "message": "无权访问该接口" + }, + { + "code": "500", + "message": "导出任务提交失败" + } + ] + }, + { + "method": "returnReceived.exportTaskProgress", + "description": "按 task_id 查询退回收到导出任务进度,返回 task_id、status、progress、current_count、total_count、message、result、error、download_url、update_time;上传完成后 download_url 返回下载链接(从 result.url/cdnUrl/cosUrl/fileKey 兜底取);任务缓存 Redis TTL 30 分钟,task_id 缺失或缓存未命中时 status=not_found(正常响应,非报错)。状态口径 submitted → running(5) → 数据拉取(10~55) → Excel 生成(60) → success(100),失败 failed + error。权限口径与 returnReceived.export 一致(默认走 API 权限校验,需 wms_permission 存在 returnReceived.exportTaskProgress 类型为 api 的记录),需登录。", + "isNeedAuth": true, + "isNeedLogin": true, + "headers": [], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "source": "body|query", + "description": "任务 ID,兼容 task_id(下划线)与 taskId(驼峰)两种写法" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(task_id 缺失时为回显的空字符串,status=not_found)" + }, + { + "name": "status", + "type": "string", + "required": true, + "description": "任务状态:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": true, + "description": "进度百分比(0-100)" + }, + { + "name": "current_count", + "type": "number", + "required": true, + "description": "当前已处理记录数(登记记录条数)" + }, + { + "name": "total_count", + "type": "number", + "required": true, + "description": "总记录数" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "任务提示信息" + }, + { + "name": "result", + "type": "object", + "required": true, + "description": "任务执行结果对象(完成后含 filename/url/fileKey/cdnUrl/cosUrl 等;未完成或 not_found 时为 null)" + }, + { + "name": "error", + "type": "string", + "required": true, + "description": "失败时的错误信息(非失败时为空字符串)" + }, + { + "name": "download_url", + "type": "string", + "required": true, + "description": "任务完成后下载链接(从 result.url/cdnUrl/cosUrl/fileKey 兜底取);未完成或不存在时为空字符串" + }, + { + "name": "update_time", + "type": "number", + "required": true, + "description": "最近一次状态更新时间(Unix 毫秒时间戳)" + } + ], + "errors": [ + { + "code": "401", + "message": "未提供有效的认证令牌" + }, + { + "code": "403", + "message": "无权访问该接口" + }, + { + "code": "500", + "message": "查询失败或内部错误" + } + ] } ] }, @@ -39243,7 +40061,7 @@ }, { "method": "report.deliveryPlan.save", - "description": "新增/更新货主报表投递计划(货主 store_id + 报表定义ID report_id 唯一,存在则更新):先校验报表定义存在且启用(wms_report_definition.is_enabled=1),schedule_times 自动去重并按升序排序,channel 仅支持 inbox(默认 inbox,wecom/link 已弃用,非法渠道报错;历史 wecom/link 计划在投递时按 inbox 兜底执行),late_grace_minutes 夹取到 0-1440。可选计划名称 name(仅展示字段,不参与幂等/关联逻辑;未传不覆盖,null/空串/全空白清空,非空 trim 后 ≤100 字符,超长报错)。inbox 推送失败自动经 inbox.message.retry 立即重推一次,重推仍失败进入 failed 退避重试(MAX_RETRY=3,退避 retry_count × 60s)。可选文本通知配置:notify_template(≤500,标签白名单 {time}/{url}/{report_name}/{biz_date},未知标签报错)、notify_group_ids(wms_inbox_group.id,正整数去重 ≤20,保存时校验存在性且排除软删)、notify_member_ids(外部 IM 用户 ID,非空字符串去重 ≤100);三者仅在入参存在时生效(未传保持原值,不传行为与旧版一致)。需授权接口(管理类操作,systemInit 未声明免权限,仅通配符角色或已授权角色可用)。", + "description": "新增/更新货主报表投递计划(货主 store_id + 报表定义ID report_id 唯一,存在则更新):先校验报表定义存在且启用(wms_report_definition.is_enabled=1),schedule_times 自动去重并按升序排序,channel 仅支持 inbox(默认 inbox,wecom/link 已弃用,非法渠道报错;历史 wecom/link 计划在投递时按 inbox 兜底执行),late_grace_minutes 夹取到 0-1440。可选计划名称 name(仅展示字段,不参与幂等/关联逻辑;未传不覆盖,null/空串/全空白清空,非空 trim 后 ≤100 字符,超长报错)。inbox 推送失败自动经 inbox.message.retry 立即重推一次,重推仍失败进入 failed 退避重试(MAX_RETRY=3,退避 retry_count × 60s)。可选文本通知配置:notify_template(≤500,标签白名单 {time}/{url}/{report_name}/{biz_date},未知标签报错)、notify_group_ids(wms_inbox_group.id,正整数去重 ≤20,保存时校验存在性且排除软删)、notify_member_ids(外部 IM 用户 ID,非空字符串去重 ≤100);三者仅在入参存在时生效(未传保持原值,不传行为与旧版一致)。群路由口径(2026-09-01 修复,G1 缺陷):报表文件消息仅投递到计划配置的 notify_group_ids(投递与文本通知共用 resolveNotifyGroups 解析,过滤 is_blocked=1、软删、仓库维度不一致的群);配置了通知群但全部不可达(不存在/已删除/被屏蔽/仓库不一致)时投递抛错进入 failed 退避重试(MAX_RETRY=3,退避 retry_count × 60s),不再回退到未配置群;未配置通知群的历史计划保持旧行为,回退投递到货主默认站内信群(group_type=store,按 id ASC 取最早一条)。需授权接口(管理类操作,systemInit 未声明免权限,仅通配符角色或已授权角色可用)。", "isNeedAuth": true, "isNeedLogin": true, "headers": [ @@ -39329,7 +40147,7 @@ "type": "array", "required": false, "source": "body", - "description": "通知群ID数组(可选,wms_inbox_group.id;正整数自动去重并升序,最多 20 个;保存时校验存在性,软删已删除的群报错并列出缺失 ID,被屏蔽的群仍可选中;支持 JSON 字符串数组;空数组视为不选择群)" + "description": "通知群ID数组(可选,wms_inbox_group.id;正整数自动去重并升序,最多 20 个;保存时校验存在性,软删已删除的群报错并列出缺失 ID,被屏蔽的群仍可选中;支持 JSON 字符串数组;空数组视为不选择群)。该群同时作为报表文件消息的投递目标:配置后文件消息仅逐群投递到这些配置群;未配置(空数组/原值为空)的历史计划投递时回退到货主默认站内信群" }, { "name": "notify_member_ids", @@ -39404,7 +40222,7 @@ "name": "notify_group_ids", "type": "array|null", "required": true, - "description": "通知群ID数组(内部 wms_inbox_group.id,去重升序;未选择时 null)" + "description": "通知群ID数组(内部 wms_inbox_group.id,去重升序;未选择时 null);同时为报表文件消息投递目标群(配置后文件消息仅投递这些群,未配置时回退货主默认站内信群)" }, { "name": "notify_member_ids", @@ -39506,7 +40324,7 @@ }, { "method": "report.deliveryPlan.list", - "description": "分页查询货主报表投递计划列表(管理侧):where 支持 store_id/report_id/enabled;pagination 默认 page=1、pageSize=20(上限 200);sort 白名单 id/created_at/updated_at/store_id/report_definition_id,默认 id DESC,非法字段回退默认排序。响应每条计划带 name(计划名称,缺省空串)、report_definition_id(报表定义ID)与文本通知配置字段 notify_template/notify_group_ids/notify_member_ids。需授权接口。", + "description": "分页查询货主报表投递计划列表(管理侧):where 支持 store_id/report_id/enabled;pagination 默认 page=1、pageSize=20(上限 200);sort 白名单 id/created_at/updated_at/store_id/report_definition_id,默认 id DESC,非法字段回退默认排序。响应每条计划带 name(计划名称,缺省空串)、report_definition_id(报表定义ID)与文本通知配置字段 notify_template/notify_group_ids/notify_member_ids;notify_group_ids 同时为报表文件消息的投递目标群(配置后文件消息仅投递这些群,未配置时回退货主默认站内信群)。需授权接口。", "isNeedAuth": true, "isNeedLogin": true, "headers": [ @@ -39632,7 +40450,7 @@ "name": "notify_group_ids", "type": "array|null", "required": true, - "description": "通知群ID数组(内部 wms_inbox_group.id,去重升序;未选择时 null)" + "description": "通知群ID数组(内部 wms_inbox_group.id,去重升序;未选择时 null);同时为报表文件消息投递目标群(配置后文件消息仅投递这些群,未配置时回退货主默认站内信群)" }, { "name": "notify_member_ids", @@ -40419,7 +41237,7 @@ }, { "method": "report.deliveryPlan.copy", - "description": "快速复制货主报表投递计划到其他货主(批量复制):传入源计划ID id 与目标货主ID数组 store_ids(元素自动去重,支持 JSON 字符串数组)。源计划必须存在(软删排除);与源计划货主相同的目标计入 skipped(原因:与源计划货主相同);目标货主须在 wms_store 存在且状态有效(status 为 1 或 2(正常/审核中)均有效,其余状态或已软删自动排除),否则计入 skipped(原因:货主不存在或状态异常);目标货主已存在同 report_definition_id 计划(软删排除)时跳过不覆盖不报错(原因:已存在同报表定义计划)。新建计划 notify_group_ids/notify_member_ids 置空(通知配置不复制),enabled 原样复制(保持复制语义),其余字段 report_definition_id/schedule_times/channel/late_grace_minutes/name/remark/notify_template 原样复制;批量创建使用事务包裹,并发撞 uk_store_report_definition 唯一索引时单条降级 skipped、不中断其余创建。统一 success 包装,data={created:[{id,store_id}],skipped:[{store_id,reason}]}。需授权接口(管理类操作,systemInit 未声明免权限,仅通配符角色或已授权角色可用)。", + "description": "快速复制货主报表投递计划到其他货主(批量复制):传入源计划ID id 与目标货主ID数组 store_ids(元素自动去重,支持 JSON 字符串数组)。源计划必须存在(软删排除);与源计划货主相同的目标计入 skipped(原因:与源计划货主相同);目标货主须在 wms_store 存在且状态有效(status 为 1 或 2(正常/审核中)均有效,其余状态或已软删自动排除),否则计入 skipped(原因:货主不存在或状态异常);目标货主已存在同 report_definition_id 计划(软删排除)时跳过不覆盖不报错(原因:已存在同报表定义计划)。新建计划 notify_group_ids/notify_member_ids 置空(通知配置不复制;新计划未配置通知群,投递时回退到目标货主默认站内信群),enabled 原样复制(保持复制语义),其余字段 report_definition_id/schedule_times/channel/late_grace_minutes/name/remark/notify_template 原样复制;批量创建使用事务包裹,并发撞 uk_store_report_definition 唯一索引时单条降级 skipped、不中断其余创建。统一 success 包装,data={created:[{id,store_id}],skipped:[{store_id,reason}]}。需授权接口(管理类操作,systemInit 未声明免权限,仅通配符角色或已授权角色可用)。", "isNeedAuth": true, "isNeedLogin": true, "headers": [