This commit is contained in:
yin 2026-06-15 18:13:39 +08:00
parent a680b9e9b2
commit dddb132893
106 changed files with 1977 additions and 329 deletions

Binary file not shown.

View File

@ -162,6 +162,21 @@ export type DeliveryOrderDetailItem = {
images?: string[]
}
/** order.deliveryOrder.detail 运单信息项 */
export type DeliveryOrderDetailExpressItem = {
waybill_code?: string
weighing_weight?: number | null
sys_logistics_code?: string
sys_logistics_name?: string
logistics_code?: string
logistics_name?: string
logistics_interface_id?: number | null
business_key?: string
created_at?: number | null
package_material_id?: number | null
package_material_name_snapshot?: string | null
}
/** order.deliveryOrder.detail 日志项 */
export type DeliveryOrderDetailLogItem = {
id: number
@ -182,7 +197,7 @@ export type DeliveryOrderDetailPayload = {
order?: DeliveryOrderDetailHeader
items?: DeliveryOrderDetailItem[]
orderItems?: DeliveryOrderDetailItem[]
expresses?: Record<string, unknown>[]
expresses?: DeliveryOrderDetailExpressItem[]
logs?: DeliveryOrderDetailLogItem[]
waybill_codes?: string[]
}

View File

@ -123,6 +123,8 @@ export type OrderDetailExpressItem = {
logistics_interface_id?: number | null
business_key?: string
created_at?: number | null
package_material_id?: number | null
package_material_name_snapshot?: string | null
}
/** order.detail 响应 data */
@ -141,6 +143,21 @@ export type BindExpressPackageMaterialParams = {
package_material_code: string
}
/** order.bindExpressPackageMaterialByWaybill 请求参数 */
export type BindExpressPackageMaterialByWaybillParams = {
waybill_code: string
package_material_code: string
}
/** order.bindExpressPackageMaterialByWaybill 响应 data */
export type BindExpressPackageMaterialByWaybillResponse = {
order_id: number
waybill_code: string
package_material_id: number
package_material_name_snapshot: string
package_material_code: string
}
export type OrderExportParams = {
table_type?: string
tableType?: string
@ -268,6 +285,23 @@ export function orderBindExpressPackageMaterial(data: BindExpressPackageMaterial
} as any)
}
/** order.bindExpressPackageMaterialByWaybill:按运单号绑定包材,无需传入订单 ID */
export function orderBindExpressPackageMaterialByWaybill(
data: BindExpressPackageMaterialByWaybillParams
): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.bindExpressPackageMaterialByWaybill',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderExport(data: OrderExportParams = {}): Promise<any> {
return request({
url: '/system',
@ -319,6 +353,7 @@ export const order = {
queryOrderLogList: orderQueryOrderLogList,
updateExpressWeighingWeight: orderUpdateExpressWeighingWeight,
bindExpressPackageMaterial: orderBindExpressPackageMaterial,
bindExpressPackageMaterialByWaybill: orderBindExpressPackageMaterialByWaybill,
export: orderExport,
exportTaskProgress: orderExportTaskProgress,
detail: orderDetail

View File

@ -8,13 +8,15 @@ import {
const v = '1.0'
/** 扫描关键词;支持 keyword、value、运单号与车号别名(见 order.recheckorder module.json) */
/** 扫描关键词;支持 keyword、value、运单号、波次号与车号别名(见 order.recheckorder module.json) */
export type RecheckScanOrderParams = {
keyword?: string
value?: string
waybill_no?: string
waybillCode?: string
waybill_code?: string
wave_no?: string
waveNo?: string
cart_code?: string
cartCode?: string
}
@ -25,6 +27,8 @@ const SCAN_ORDER_FIELD_KEYS: (keyof RecheckScanOrderParams)[] = [
'waybill_no',
'waybillCode',
'waybill_code',
'wave_no',
'waveNo',
'cart_code',
'cartCode'
]
@ -37,16 +41,30 @@ function pickScanOrderBody(data: RecheckScanOrderParams): Record<string, string>
}
}
throw new Error(
'扫描关键词不能为空(keyword / value / waybill_no / waybillCode / waybill_code / cart_code / cartCode)'
'扫描关键词不能为空(keyword / value / waybill_no / waybillCode / waybill_code / wave_no / waveNo / cart_code / cartCode)'
)
}
/** scanOrder 成功时服务端常用字段 */
/** scanOrder 成功时服务端常用字段(与 order.recheckOrder.scanOrder 响应对齐) */
export type ScanOrderResultShape = {
match_type?: 'waybill' | 'cart' | string
match_type?: 'waybill' | 'wave' | 'cart' | string
list_type?: 'single' | 'group' | string
waybill_no?: string
task_id?: number | null
picker_id?: number | null
picker_name?: string
wave_id?: number
wave_no?: string
wave_type?: number
pick_mode?: number
strategy_id?: number | null
strategy_name?: string
total_orders?: number
reviewed_count?: number
unreviewed_count?: number
list?: unknown[]
cart_match_view?: Record<string, unknown> | null
order_id?: number | string
waybill_no?: string
order?: Record<string, unknown>
items?: unknown[]
expresses?: unknown[]
@ -152,6 +170,34 @@ export function confirmRecheck(data: ConfirmRecheckParams): Promise<any> {
} as any)
}
/** order.recheckOrder.batchQuickRecheck 请求参数 */
export type BatchQuickRecheckParams = {
ids: number[] | string
}
/** order.recheckOrder.batchQuickRecheck 响应 data */
export type BatchQuickRecheckResponse = {
success: unknown[]
failed: unknown[]
success_count: number
failed_count: number
}
/** order.recheckOrder.batchQuickRecheck:批量快捷复核 */
export function batchQuickRecheck(data: BatchQuickRecheckParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.batchQuickRecheck',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** order.recheckOrder.confirmIntercept:确认拦截,入参 order_id,匹配单个订单并标记拦截 */
export function confirmIntercept(data: ConfirmRecheckParams): Promise<any> {
return request({
@ -169,6 +215,7 @@ export function confirmIntercept(data: ConfirmRecheckParams): Promise<any> {
export const orderRecheckOrder = {
scanOrder,
batchQuickRecheck,
confirmRecheck,
confirmIntercept
}

View File

@ -2,9 +2,21 @@ import request from '@/utils/request'
const v = '1.0'
/** 自动出库规则配置(subject_config.auto_outbound_rules) */
export type SettingWarehouseAutoOutboundRules = {
enabled?: boolean
require_recheck?: boolean
require_pack?: boolean
require_weigh?: boolean
require_sync?: boolean
require_print?: boolean
require_pick?: boolean
}
/** 与 module setting.warehouse 文档 subject_config 对齐 */
export type SettingWarehouseSubjectConfig = {
enable_external_express_code?: boolean
auto_outbound_rules?: SettingWarehouseAutoOutboundRules
max_wave_quantity?: number
min_group_order_fetch_quantity?: number
max_notice_webhook_count?: number

View File

@ -196,6 +196,7 @@ const printerLoading = ref(false)
const businessTypeOptions = [
{ label: '收货单 (RECEIPT)', value: 'RECEIPT' },
{ label: '库存单 (STOCK)', value: 'STOCK' },
{ label: '出库单 (STOCKOUT)', value: 'STOCKOUT' },
{ label: '拣货单 (PICKING)', value: 'PICKING' }
]
@ -460,7 +461,7 @@ function resolveBusinessType() {
}
function isSupportedBusinessType(value: string) {
return ['STOCK', 'RECEIPT', 'PICKING'].includes(value)
return ['STOCK', 'STOCKOUT', 'RECEIPT', 'PICKING'].includes(value)
}
async function handleBusinessTypeChange() {

View File

@ -1,6 +1,6 @@
<template>
<create-pending-order-dialog
v-if="sessionActive && dialogVisible"
v-if="sessionActive"
v-model="dialogVisible"
/>
<create-order-float-widget />

View File

@ -0,0 +1,207 @@
<template>
<el-dialog
:model-value="modelValue"
title="按运单号绑定包材"
width="520px"
align-center
destroy-on-close
@close="handleClose"
@closed="resetForm"
>
<el-alert
type="info"
:closable="false"
show-icon
style="margin-bottom: 12px"
title="仅需运单号与包材编码,系统自动反查订单运单记录并绑定包材,无需订单 ID。"
/>
<el-form ref="formRef" :model="form" :rules="rules" label-width="96px" @submit.prevent>
<el-form-item label="运单号" prop="waybill_code">
<el-input
v-model.trim="form.waybill_code"
placeholder="请输入运单号"
clearable
@keyup.enter="focusMaterialSelect"
/>
</el-form-item>
<el-form-item label="包材编码" prop="package_material_code">
<el-select
ref="materialSelectRef"
v-model="form.package_material_code"
filterable
remote
clearable
reserve-keyword
placeholder="输入编码/名称搜索"
:remote-method="searchPackageMaterials"
:loading="materialLoading"
style="width: 100%"
@keyup.enter="handleSubmit"
>
<el-option
v-for="item in materialOptions"
:key="item.material_code"
:label="`${item.material_code} / ${item.material_name}`"
:value="item.material_code"
/>
</el-select>
</el-form-item>
</el-form>
<div v-if="lastResult" class="bind-result">
<el-divider content-position="left">绑定结果</el-divider>
<el-descriptions :column="1" size="small" border>
<el-descriptions-item label="订单 ID">{{ lastResult.order_id }}</el-descriptions-item>
<el-descriptions-item label="运单号">{{ lastResult.waybill_code }}</el-descriptions-item>
<el-descriptions-item label="包材 ID">{{ lastResult.package_material_id }}</el-descriptions-item>
<el-descriptions-item label="包材编码">{{ lastResult.package_material_code }}</el-descriptions-item>
<el-descriptions-item label="包材名称">{{ lastResult.package_material_name_snapshot }}</el-descriptions-item>
</el-descriptions>
</div>
<template #footer>
<el-button @click="handleClose">取消</el-button>
<el-button type="primary" :loading="submitting" @click="handleSubmit">绑定</el-button>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { nextTick, reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'
import {
orderBindExpressPackageMaterialByWaybill,
type BindExpressPackageMaterialByWaybillResponse
} from '@/api/order.index/orderindex'
import { packageMaterialGet } from '@/api/setting.packagematerial/packagematerial'
import { parsePackageMaterialListResponse } from '@/views/material/packageMaterial/package-material-config'
import { isOrderIndexApiSuccess } from '../utils/order-index-helpers'
const props = defineProps<{
modelValue: boolean
/** 打开时预填运单号(如从运单列表带入) */
initialWaybillCode?: string
}>()
const emit = defineEmits<{
(e: 'update:modelValue', value: boolean): void
(e: 'success', payload: BindExpressPackageMaterialByWaybillResponse): void
}>()
const formRef = ref<FormInstance>()
const materialSelectRef = ref<{ focus?: () => void } | null>(null)
const submitting = ref(false)
const materialLoading = ref(false)
const materialOptions = ref<Array<{ material_code: string; material_name: string }>>([])
const lastResult = ref<BindExpressPackageMaterialByWaybillResponse | null>(null)
const form = reactive({
waybill_code: '',
package_material_code: ''
})
const rules: FormRules = {
waybill_code: [{ required: true, message: '请输入运单号', trigger: 'blur' }],
package_material_code: [{ required: true, message: '请选择包材编码', trigger: 'change' }]
}
watch(
() => props.modelValue,
(visible) => {
if (!visible) return
lastResult.value = null
form.waybill_code = String(props.initialWaybillCode || '').trim()
form.package_material_code = ''
materialOptions.value = []
}
)
function handleClose() {
emit('update:modelValue', false)
}
function resetForm() {
form.waybill_code = ''
form.package_material_code = ''
materialOptions.value = []
lastResult.value = null
formRef.value?.clearValidate()
}
function focusMaterialSelect() {
nextTick(() => materialSelectRef.value?.focus?.())
}
async function searchPackageMaterials(query: string) {
const keyword = String(query || '').trim()
if (!keyword) {
materialOptions.value = []
return
}
materialLoading.value = true
try {
const res: any = await packageMaterialGet({
pagination: { page: 1, pageSize: 50 },
where: { quickWhere: keyword }
})
const data = parsePackageMaterialListResponse(res)
materialOptions.value = (data.list || [])
.map((item: any) => ({
material_code: String(item.material_code || '').trim(),
material_name: String(item.material_name || '').trim()
}))
.filter((item) => item.material_code)
} catch {
materialOptions.value = []
} finally {
materialLoading.value = false
}
}
function unwrapBindPayload(res: any): BindExpressPackageMaterialByWaybillResponse | null {
const raw = res?.data
if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
return raw as BindExpressPackageMaterialByWaybillResponse
}
return null
}
async function handleSubmit() {
if (!formRef.value || submitting.value) return
const valid = await formRef.value.validate().catch(() => false)
if (!valid) return
const waybill_code = form.waybill_code.trim()
const package_material_code = String(form.package_material_code || '').trim().toUpperCase()
if (!waybill_code || !package_material_code) return
submitting.value = true
try {
const res: any = await orderBindExpressPackageMaterialByWaybill({
waybill_code,
package_material_code
})
if (!isOrderIndexApiSuccess(res)) {
throw new Error(res?.message || '绑定包材失败')
}
const payload = unwrapBindPayload(res)
if (payload) {
lastResult.value = payload
emit('success', payload)
}
ElMessage.success('包材绑定成功')
} catch (error: any) {
ElMessage.error(error?.message || '绑定包材失败')
} finally {
submitting.value = false
}
}
</script>
<style scoped lang="scss">
.bind-result {
margin-top: 4px;
}
</style>

View File

@ -20,6 +20,8 @@
<div class="create-order-float__body">
<p v-if="floatSummary.loading" class="create-order-float__status">正在创建订单…</p>
<p v-else-if="floatSummary.parsing" class="create-order-float__status">正在解析 Excel…</p>
<p v-else-if="floatSummary.reRecognizing" class="create-order-float__status">正在地址重识…</p>
<p v-else-if="floatSummary.checkingDeliveryCode" class="create-order-float__status">正在发货单号查重…</p>
<p v-else-if="floatSummary.rowCount > 0" class="create-order-float__status">
{{ floatSummary.rowCount }} 行明细 · {{ floatSummary.orderCount }} 个订单
</p>
@ -45,7 +47,12 @@ const {
} = useCreateOrderSession()
async function handleClose() {
const hasData = floatSummary.value.rowCount > 0 || floatSummary.value.loading || floatSummary.value.parsing
const hasData =
floatSummary.value.rowCount > 0
|| floatSummary.value.loading
|| floatSummary.value.parsing
|| floatSummary.value.reRecognizing
|| floatSummary.value.checkingDeliveryCode
if (hasData) {
try {
await ElMessageBox.confirm('关闭后将清空当前建单数据,是否继续?', '关闭建单', {

View File

@ -4,7 +4,6 @@
width="92%"
align-center
append-to-body
destroy-on-close
:close-on-click-modal="false"
:before-close="handleBeforeClose"
>
@ -55,7 +54,7 @@
<el-button
type="primary"
:loading="importOrderLoading"
:disabled="parseImportFileLoading || reRecognizeAddressLoading"
:disabled="parseImportFileLoading || reRecognizeAddressLoading || checkDeliveryCodeLoading"
@click="submitImportOrders"
>
确认创建
@ -460,6 +459,7 @@ const emit = defineEmits<{
const {
resetToken,
sessionActive,
minimizeCreateOrderDialog,
closeCreateOrderSession,
updateFloatSummary,
@ -601,13 +601,22 @@ watch(visible, (opened) => {
}, { immediate: true })
watch(
[() => importPreviewRows.value.length, importPreviewOrderCount, importOrderLoading, parseImportFileLoading],
[
() => importPreviewRows.value.length,
importPreviewOrderCount,
importOrderLoading,
parseImportFileLoading,
reRecognizeAddressLoading,
checkDeliveryCodeLoading
],
() => {
updateFloatSummary({
rowCount: importPreviewRows.value.length,
orderCount: importPreviewOrderCount.value,
loading: importOrderLoading.value,
parsing: parseImportFileLoading.value
parsing: parseImportFileLoading.value,
reRecognizing: reRecognizeAddressLoading.value,
checkingDeliveryCode: checkDeliveryCodeLoading.value
})
},
{ immediate: true }
@ -657,7 +666,13 @@ function handleMinimize() {
}
function persistCreateOrderDraft() {
if (!importPreviewRows.value.length && !importOrderLoading.value && !parseImportFileLoading.value) {
if (
!importPreviewRows.value.length
&& !importOrderLoading.value
&& !parseImportFileLoading.value
&& !reRecognizeAddressLoading.value
&& !checkDeliveryCodeLoading.value
) {
return
}
const snapshot: CreateOrderDraftSnapshot = {
@ -699,12 +714,18 @@ onBeforeUnmount(() => {
storeOptions.value = []
importExpressOptions.value = []
importPlatformOptions.value = []
resetImportOrderDialog()
if (!sessionActive.value) {
resetImportOrderDialog()
}
})
async function confirmDiscardSession() {
const hasData =
importPreviewRows.value.length > 0 || importOrderLoading.value || parseImportFileLoading.value
importPreviewRows.value.length > 0
|| importOrderLoading.value
|| parseImportFileLoading.value
|| reRecognizeAddressLoading.value
|| checkDeliveryCodeLoading.value
if (!hasData) return true
try {
await ElMessageBox.confirm('关闭后将清空当前建单数据,是否继续?', '关闭建单', {
@ -1311,6 +1332,7 @@ async function handleReRecognizeAddresses() {
applyParsedAddressToRow(row, data)
successCount += 1
persistCreateOrderDraft()
} catch {
failCount += 1
}
@ -1331,10 +1353,15 @@ async function handleReRecognizeAddresses() {
} finally {
reRecognizeAddressLoading.value = false
syncAllPreviewRowIssues()
persistCreateOrderDraft()
}
}
async function handleCheckDeliveryOrderCodes() {
if (checkDeliveryCodeLoading.value || parseImportFileLoading.value || importOrderLoading.value || reRecognizeAddressLoading.value) {
return
}
const rowsWithCode = importPreviewRows.value.filter((row) => getPreviewRowDeliveryOrderCode(row))
if (!rowsWithCode.length) {
ElMessage.warning('请先填写发货单号')
@ -1359,20 +1386,21 @@ async function handleCheckDeliveryOrderCodes() {
duplicateRowCount += 1
}
}
syncAllPreviewRowIssues()
persistCreateOrderDraft()
if (!duplicateRowCount) {
ElMessage.success('未发现重复发货单号')
syncAllPreviewRowIssues()
return
}
ElMessage.warning(`发现 ${existingCodeSet.size} 个重复发货单号,共 ${duplicateRowCount} 行`)
syncAllPreviewRowIssues()
} catch (error) {
console.error('check delivery order code failed:', error)
ElMessage.error('发货单号查重失败')
} finally {
checkDeliveryCodeLoading.value = false
persistCreateOrderDraft()
}
}

View File

@ -3,6 +3,7 @@
<template v-if="orderId">
<div class="toolbar">
<el-button size="small" :loading="loading" @click="loadDetail">刷新运单</el-button>
<el-button size="small" type="primary" plain @click="openQuickBindDialog">按运单绑定包材</el-button>
<el-tag v-if="waybillCodesText" size="small" type="info">运单汇总:{{ waybillCodesText }}</el-tag>
</div>
@ -62,51 +63,20 @@
</template>
</el-dialog>
<el-dialog v-model="bindDialogVisible" title="绑定运单包材" width="480px" align-center @closed="resetBindForm">
<el-form label-width="96px">
<el-form-item label="运单号">
<el-input :model-value="bindForm.waybill_code" disabled />
</el-form-item>
<el-form-item label="包材编码">
<el-select
v-model="bindForm.package_material_code"
filterable
remote
clearable
reserve-keyword
placeholder="输入编码/名称搜索"
:remote-method="searchPackageMaterials"
:loading="materialLoading"
style="width: 100%"
>
<el-option
v-for="item in materialOptions"
:key="item.material_code"
:label="`${item.material_code} / ${item.material_name}`"
:value="item.material_code"
/>
</el-select>
</el-form-item>
</el-form>
<template #footer>
<el-button @click="bindDialogVisible = false">取消</el-button>
<el-button type="primary" :loading="bindSaving" @click="submitBind">绑定</el-button>
</template>
</el-dialog>
<BindPackageMaterialByWaybillDialog
v-model="quickBindDialogVisible"
:initial-waybill-code="quickBindWaybillCode"
@success="handleBindSuccess"
/>
</div>
</template>
<script setup lang="ts">
import { computed, reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import {
orderBindExpressPackageMaterial,
orderDetail,
orderUpdateExpressWeighingWeight
} from '@/api/order.index/orderindex'
import { packageMaterialGet } from '@/api/setting.packagematerial/packagematerial'
import { orderDetail, orderUpdateExpressWeighingWeight } from '@/api/order.index/orderindex'
import { isOrderIndexApiSuccess, parseOrderDetailPayload, normalizeOrderExpressList } from '../utils/order-index-helpers'
import { parsePackageMaterialListResponse } from '@/views/material/packageMaterial/package-material-config'
import BindPackageMaterialByWaybillDialog from './BindPackageMaterialByWaybillDialog.vue'
const props = defineProps<{
row: Record<string, any> | null
@ -115,24 +85,17 @@ const props = defineProps<{
const loading = ref(false)
const weighingSaving = ref(false)
const bindSaving = ref(false)
const materialLoading = ref(false)
const weighingDialogVisible = ref(false)
const bindDialogVisible = ref(false)
const quickBindDialogVisible = ref(false)
const quickBindWaybillCode = ref('')
const expressRows = ref<any[]>([])
const waybillCodesText = ref('')
const materialOptions = ref<Array<{ material_code: string; material_name: string }>>([])
const weighingForm = reactive({
waybill_code: '',
weighing_weight: undefined as number | undefined
})
const bindForm = reactive({
waybill_code: '',
package_material_code: ''
})
const orderId = computed(() => props.row?.id)
function formatWeight(value: unknown) {
@ -185,13 +148,17 @@ function openWeighingDialog(row: any) {
}
function openBindDialog(row: any) {
bindForm.waybill_code = row.waybill_code
bindForm.package_material_code = row.package_material_code || ''
materialOptions.value = []
bindDialogVisible.value = true
if (bindForm.package_material_code) {
searchPackageMaterials(bindForm.package_material_code)
}
quickBindWaybillCode.value = row.waybill_code || ''
quickBindDialogVisible.value = true
}
function openQuickBindDialog() {
quickBindWaybillCode.value = ''
quickBindDialogVisible.value = true
}
async function handleBindSuccess() {
await loadDetail()
}
function resetWeighingForm() {
@ -199,38 +166,6 @@ function resetWeighingForm() {
weighingForm.weighing_weight = undefined
}
function resetBindForm() {
bindForm.waybill_code = ''
bindForm.package_material_code = ''
materialOptions.value = []
}
async function searchPackageMaterials(query: string) {
const keyword = String(query || '').trim()
if (!keyword) {
materialOptions.value = []
return
}
materialLoading.value = true
try {
const res: any = await packageMaterialGet({
pagination: { page: 1, pageSize: 50 },
where: { quickWhere: keyword }
})
const data = parsePackageMaterialListResponse(res)
materialOptions.value = (data.list || [])
.map((item: any) => ({
material_code: String(item.material_code || '').trim(),
material_name: String(item.material_name || '').trim()
}))
.filter((item) => item.material_code)
} catch {
materialOptions.value = []
} finally {
materialLoading.value = false
}
}
async function submitWeighing() {
if (!orderId.value || weighingSaving.value) return
if (!weighingForm.weighing_weight || weighingForm.weighing_weight <= 0) {
@ -260,33 +195,6 @@ async function submitWeighing() {
}
}
async function submitBind() {
if (!orderId.value || bindSaving.value) return
const code = String(bindForm.package_material_code || '').trim().toUpperCase()
if (!code) {
ElMessage.warning('请选择包材编码')
return
}
bindSaving.value = true
try {
const res: any = await orderBindExpressPackageMaterial({
order_id: orderId.value,
waybill_code: bindForm.waybill_code,
package_material_code: code
})
if (!isOrderIndexApiSuccess(res)) {
throw new Error(res?.message || '绑定包材失败')
}
ElMessage.success('包材绑定成功')
bindDialogVisible.value = false
await loadDetail()
} catch (error: any) {
ElMessage.error(error?.message || '绑定包材失败')
} finally {
bindSaving.value = false
}
}
watch(
() => orderId.value,
() => {

View File

@ -5,6 +5,8 @@ export type CreateOrderFloatSummary = {
orderCount: number
loading: boolean
parsing: boolean
reRecognizing: boolean
checkingDeliveryCode: boolean
}
/** 建单草稿:收起后台时暂存,关闭会话或还原后释放 DOM */
@ -27,7 +29,9 @@ const floatSummary = ref<CreateOrderFloatSummary>({
rowCount: 0,
orderCount: 0,
loading: false,
parsing: false
parsing: false,
reRecognizing: false,
checkingDeliveryCode: false
})
const createOrderDraft = shallowRef<CreateOrderDraftSnapshot | null>(null)
@ -83,7 +87,9 @@ export function useCreateOrderSession() {
rowCount: 0,
orderCount: 0,
loading: false,
parsing: false
parsing: false,
reRecognizing: false,
checkingDeliveryCode: false
}
}

View File

@ -2,6 +2,7 @@
<div class="order-management-wrapper" :style="{ height: containerHeight }">
<div class="tabs-header-action">
<el-button size="small" @click="workbenchDialogVisible = true">统一查询</el-button>
<el-button size="small" @click="bindByWaybillDialogVisible = true">按运单绑定包材</el-button>
<el-button size="small" :loading="badgeLoading" @click="refreshBadgeCounts">刷新角标</el-button>
</div>
<el-tabs
@ -35,6 +36,7 @@
</el-tabs>
<order-workbench-list-dialog v-model="workbenchDialogVisible" />
<BindPackageMaterialByWaybillDialog v-model="bindByWaybillDialogVisible" />
</div>
</template>
@ -52,6 +54,7 @@ import EntrustWarehouse from './entrustWarehouse.vue'
import DeliveryException from './deliveryException.vue'
import ArchiveOrder from './archiveOrder.vue'
import OrderWorkbenchListDialog from './component/OrderWorkbenchListDialog.vue'
import BindPackageMaterialByWaybillDialog from './component/BindPackageMaterialByWaybillDialog.vue'
import { safeInvoke } from '@/utils/safe-invoke'
const route = useRoute()
@ -59,6 +62,7 @@ const router = useRouter()
const settingsStore = useSettingsStore()
const badgeLoading = ref(false)
const workbenchDialogVisible = ref(false)
const bindByWaybillDialogVisible = ref(false)
const shortcutExpanded = computed(() => settingsStore.shortcutExpanded)
const containerHeight = computed(() => shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)')

View File

@ -0,0 +1,256 @@
<template>
<el-dialog
:model-value="modelValue"
title="批量快捷复核"
width="640px"
align-center
destroy-on-close
@close="handleClose"
@closed="resetForm"
>
<el-alert
type="info"
:closable="false"
show-icon
style="margin-bottom: 12px"
title="对每个订单执行前置检查并自动完成拣货(如需)后标记复核;各订单独立事务,支持部分失败。"
/>
<el-form ref="formRef" :model="form" :rules="rules" label-width="96px" @submit.prevent>
<el-form-item label="订单 ID" prop="idsText">
<el-input
v-model="form.idsText"
type="textarea"
:rows="4"
placeholder="支持多个订单 ID,逗号、空格或换行分隔;也可直接粘贴 ID 列表"
/>
<div class="form-hint">
已解析 <strong>{{ parsedIds.length }}</strong> 个有效 ID
<el-button
v-if="suggestedIds.length"
link
type="primary"
size="small"
style="margin-left: 8px"
@click="fillSuggestedIds"
>
填入当前未复核订单({{ suggestedIds.length }})
</el-button>
</div>
</el-form-item>
</el-form>
<div v-if="result" class="recheck-result">
<el-divider content-position="left">执行结果</el-divider>
<div class="result-summary">
<el-tag type="success" size="small">成功 {{ result.success_count }}</el-tag>
<el-tag type="danger" size="small">失败 {{ result.failed_count }}</el-tag>
</div>
<el-tabs v-model="resultTab" class="result-tabs">
<el-tab-pane :label="`成功 (${result.success.length})`" name="success">
<el-table :data="normalizeResultRows(result.success)" border size="small" max-height="220" empty-text="无">
<el-table-column prop="order_id" label="订单 ID" width="100" />
<el-table-column prop="waybill_no" label="运单号" min-width="140" show-overflow-tooltip />
<el-table-column prop="message" label="说明" min-width="160" show-overflow-tooltip />
</el-table>
</el-tab-pane>
<el-tab-pane :label="`失败 (${result.failed.length})`" name="failed">
<el-table :data="normalizeResultRows(result.failed)" border size="small" max-height="220" empty-text="无">
<el-table-column prop="order_id" label="订单 ID" width="100" />
<el-table-column prop="waybill_no" label="运单号" min-width="140" show-overflow-tooltip />
<el-table-column prop="reason" label="原因" min-width="180" show-overflow-tooltip />
<el-table-column prop="message" label="说明" min-width="160" show-overflow-tooltip />
</el-table>
</el-tab-pane>
</el-tabs>
</div>
<template #footer>
<el-button @click="handleClose">关闭</el-button>
<el-button type="primary" :loading="submitting" @click="handleSubmit">执行复核</el-button>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { computed, reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'
import {
batchQuickRecheck,
type BatchQuickRecheckResponse
} from '@/api/order.recheckorder/recheckOrder'
const props = defineProps<{
modelValue: boolean
/** 建议填入的未复核订单 ID */
suggestedIds?: number[]
}>()
const emit = defineEmits<{
(e: 'update:modelValue', value: boolean): void
(e: 'success', payload: BatchQuickRecheckResponse): void
}>()
const formRef = ref<FormInstance>()
const submitting = ref(false)
const result = ref<BatchQuickRecheckResponse | null>(null)
const resultTab = ref<'success' | 'failed'>('success')
const form = reactive({
idsText: ''
})
const suggestedIds = computed(() =>
(props.suggestedIds || []).filter((id) => Number.isFinite(id) && id > 0)
)
const parsedIds = computed(() => parseOrderIdsInput(form.idsText))
const rules: FormRules = {
idsText: [
{
validator: (_rule, _value, callback) => {
if (parsedIds.value.length === 0) {
callback(new Error('请至少输入一个有效订单 ID'))
} else {
callback()
}
},
trigger: 'blur'
}
]
}
watch(
() => props.modelValue,
(visible) => {
if (!visible) return
result.value = null
resultTab.value = 'success'
form.idsText = ''
}
)
function handleClose() {
emit('update:modelValue', false)
}
function resetForm() {
form.idsText = ''
result.value = null
resultTab.value = 'success'
formRef.value?.clearValidate()
}
function parseOrderIdsInput(raw: string): number[] {
const parts = String(raw || '')
.split(/[,,\s\n\r]+/)
.map((s) => s.trim())
.filter(Boolean)
const ids: number[] = []
const seen = new Set<number>()
for (const part of parts) {
const n = Number(part)
if (Number.isFinite(n) && n > 0 && !seen.has(n)) {
seen.add(n)
ids.push(n)
}
}
return ids
}
function fillSuggestedIds() {
if (!suggestedIds.value.length) return
form.idsText = suggestedIds.value.join(', ')
formRef.value?.clearValidate(['idsText'])
}
function normalizeResultRows(rows: unknown[]): Array<Record<string, unknown>> {
return rows.map((row) => {
if (row && typeof row === 'object' && !Array.isArray(row)) {
return row as Record<string, unknown>
}
return { message: String(row) }
})
}
function unwrapBatchResult(res: any): BatchQuickRecheckResponse | null {
const raw = res?.data
if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
return raw as BatchQuickRecheckResponse
}
return null
}
function isRecheckApiSuccess(res: any) {
return res && (res.code === 1 || res.code === 200 || res.flag === 'success')
}
async function handleSubmit() {
if (!formRef.value || submitting.value) return
const valid = await formRef.value.validate().catch(() => false)
if (!valid) return
const ids = parsedIds.value
if (!ids.length) {
ElMessage.warning('请至少输入一个有效订单 ID')
return
}
submitting.value = true
try {
const res: any = await batchQuickRecheck({ ids })
if (!isRecheckApiSuccess(res)) {
throw new Error(res?.message || '批量快捷复核失败')
}
const payload = unwrapBatchResult(res)
if (!payload) {
throw new Error('未获取到复核结果')
}
result.value = {
success: Array.isArray(payload.success) ? payload.success : [],
failed: Array.isArray(payload.failed) ? payload.failed : [],
success_count: Number(payload.success_count) || 0,
failed_count: Number(payload.failed_count) || 0
}
resultTab.value = result.value.failed_count > 0 ? 'failed' : 'success'
emit('success', result.value)
if (result.value.failed_count === 0) {
ElMessage.success(`批量复核完成,成功 ${result.value.success_count} 单`)
} else {
ElMessage.warning(
`复核完成:成功 ${result.value.success_count} 单,失败 ${result.value.failed_count} 单`
)
}
} catch (error: any) {
ElMessage.error(error?.message || '批量快捷复核失败')
} finally {
submitting.value = false
}
}
</script>
<style scoped lang="scss">
.form-hint {
margin-top: 6px;
font-size: 12px;
color: #909399;
line-height: 1.5;
}
.recheck-result {
margin-top: 4px;
}
.result-summary {
display: flex;
gap: 8px;
margin-bottom: 8px;
}
.result-tabs :deep(.el-tabs__header) {
margin-bottom: 8px;
}
</style>

View File

@ -44,6 +44,9 @@
确认拦截
</el-button>
<el-button size="small" @click="resetAll">清空</el-button>
<el-button size="small" type="primary" plain @click="batchRecheckDialogVisible = true">
批量快捷复核
</el-button>
<el-button
v-if="!hasSelectedIntercept"
size="small"
@ -191,6 +194,12 @@
<el-button type="primary" :loading="weighingSubmitting" @click="submitWeighing">保存</el-button>
</template>
</el-dialog>
<BatchQuickRecheckDialog
v-model="batchRecheckDialogVisible"
:suggested-ids="batchRecheckSuggestedIds"
@success="handleBatchQuickRecheckSuccess"
/>
</div>
</template>
@ -200,6 +209,7 @@ import { ElMessage, ElMessageBox } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import RecheckOrderPanel from './component/RecheckOrderPanel.vue'
import BatchQuickRecheckDialog from './component/BatchQuickRecheckDialog.vue'
import * as stationApi from '@/api/print/print'
import { getOrderPrintData } from '@/api/order.print/orderprint'
import type { WavePlatformPrintDataPayload } from '@/api/order.print/orderprint'
@ -428,6 +438,8 @@ const panelActiveWaybill = ref('')
const panelScanMode = ref<'search' | 'recheck'>('search')
const panelTaskId = ref<number | string | undefined>(undefined)
const refreshTaskLoading = ref(false)
const batchRecheckDialogVisible = ref(false)
const lastScanParams = ref<RecheckScanOrderParams | null>(null)
function handlePanelSearch(keyword: string) {
void executeScan({ keyword })
@ -662,6 +674,29 @@ const selectedOrderRow = ref<Record<string, unknown> | null>(null)
const showDetailPane = computed(() => scanPayload.value != null && activeOrderId.value != null)
function resolvePanelOrderId(order: any): number | null {
if (order?._is_wave) return null
const raw = order?.order_id ?? order?.id
const n = Number(raw)
return Number.isFinite(n) && n > 0 ? n : null
}
const batchRecheckSuggestedIds = computed(() => {
const ids: number[] = []
const seen = new Set<number>()
for (const o of panelOrders.value) {
const id = resolvePanelOrderId(o)
if (id == null) continue
const status = String(o.recheck_status ?? o.is_reviewed ?? '').trim()
if (status === 'fin' || status === 'true') continue
if (!seen.has(id)) {
seen.add(id)
ids.push(id)
}
}
return ids
})
const waybillSummaryRows = computed(() => (scanPayload.value ? [{}] : []))
function clearScanResult() {
@ -1446,7 +1481,19 @@ watch(cartSelectableOrders, (list) => {
}
})
async function handleBatchQuickRecheckSuccess() {
const taskId = Number(panelTaskId.value)
if (Number.isFinite(taskId) && taskId > 0) {
await handleRefreshTask(taskId)
return
}
if (lastScanParams.value) {
await executeScan(lastScanParams.value)
}
}
async function executeScan(params: RecheckScanOrderParams) {
lastScanParams.value = { ...params }
scanHint.value = ''
scanHintType.value = 'info'
selectedOrderId.value = null

View File

@ -835,6 +835,17 @@
:fetch-print-data="loadWavePrintFormData"
/>
<batch-receiving-print-dialog
v-model="outboundPrintDialogVisible"
:selection-rows="outboundPrintRows"
business-type="STOCKOUT"
dialog-title="批量打印出库单"
queue-no-field="delivery_order_code"
document-label="出库单"
hide-business-type-select
:fetch-print-data="loadOutboundPrintFormData"
/>
<wave-platform-print-preview-dialog
v-model="platformPrintDialogVisible"
:error-message="platformPrintErrorMessage"
@ -871,7 +882,10 @@ import {
formatWaveExpressAssignmentStatusLabel,
formatWavePrintAssignmentStatusLabel,
formatWaveReviewAssignmentStatusLabel,
getWaveAssignmentAggregateTagType
getWaveAssignmentAggregateTagType,
buildOutboundPrintQueue,
unwrapWavePrintPayload as unwrapWavePrintPayloadFromConfig,
resolveOutboundPrintRowKey
} from './config/wave-config'
import { safeInvoke } from '@/utils/safe-invoke'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'
@ -973,6 +987,7 @@ const batchAutoGroupingLoading = ref(false)
const batchFinishAutoGroupingLoading = ref(false)
const batchCancelLoading = ref(false)
const batchPrintLoading = ref(false)
const batchOutboundPrintLoading = ref(false)
const batchPlatformPrintLoading = ref(false)
const platformPrintDialogVisible = ref(false)
const platformPrintPayload = ref<WavePlatformPrintDataPayload | null>(null)
@ -985,6 +1000,9 @@ const userStore = useUserStore()
const wavePrintDialogVisible = ref(false)
const wavePrintRows = ref<any[]>([])
const wavePrintDataMap = ref<Record<string, any>>({})
const outboundPrintDialogVisible = ref(false)
const outboundPrintRows = ref<any[]>([])
const outboundPrintDataMap = ref<Record<string, any>>({})
const queryTime = ref(0)
const tableSize = ref('small')
const activeTab = ref('detail')
@ -1198,6 +1216,7 @@ const buttonLoadingMap = computed(() => ({
batchFinishAutoGroupingLoading: batchFinishAutoGroupingLoading.value,
batchCancelLoading: batchCancelLoading.value,
batchPrintLoading: batchPrintLoading.value,
batchOutboundPrintLoading: batchOutboundPrintLoading.value,
batchPlatformPrintLoading: batchPlatformPrintLoading.value,
batchAllocateExpressLoading: batchAllocateExpressLoading.value,
batchAllocateStorageLoading: batchAllocateStorageLoading.value,
@ -1209,12 +1228,14 @@ const batchPlatformPrintDisabled = computed(() => !printableSelectionRows.value.
const buttonDisabledMap = computed(() => ({
batchPickingPrintDisabled: batchPrintDisabled.value,
batchPrintDisabled: batchPrintDisabled.value,
batchOutboundPrintDisabled: batchPrintDisabled.value,
batchPlatformPrintDisabled: batchPlatformPrintDisabled.value,
noSelection: !hasSelection.value
}))
const buttonLabelMap = computed(() => ({
batchPrintTotal: `批量打印(${selectedWaveOrderTotal.value})`,
batchOutboundPrintTotal: `批量打印出库单(${selectedWaveOrderTotal.value})`,
batchPlatformPrintTotal: `批量打印(平台)(${selectedWaveOrderTotal.value})`,
batchPickingPrintTotal: `批量打印拣货单(${selectionRows.value.length})`,
detailToggleLabel: detailVisible.value ? '隐藏详情' : '显示详情'
@ -1242,6 +1263,9 @@ const toolbarActionMap: Record<string, () => void> = {
openColumnConfigPanel: () => openColumnConfigPanel(),
toggleDetailVisible: () => toggleDetailVisible(),
handleBatchPrint: () => handleBatchPrint(),
handleBatchOutboundPrint: () => {
void handleBatchOutboundPrint()
},
handleBatchPlatformPrint: () => {
void handleBatchPlatformPrint()
},
@ -1865,6 +1889,87 @@ async function handleBatchPrint() {
await openBatchPrintDialog(rows)
}
async function loadOutboundPrintFormData(row: any) {
const key = String(row?.id ?? resolveOutboundPrintRowKey(row || {}, String(row?.wave_id ?? ''), 0))
return outboundPrintDataMap.value[key] || row || {}
}
async function openBatchOutboundPrintDialog(rows: any[]) {
const first = rows[0] as Record<string, unknown>
const warehouseId = Number(first?.warehouse_id ?? userStore.user?.warehouse_id ?? userStore.user?.store_id)
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
ElMessage.error('无法确定仓库 ID,请确认列表中的仓库字段或当前登录仓库上下文')
return
}
const wave_ids = rows
.map((row: any) => row?.id ?? row?.wave_id ?? row?.batch_id)
.filter((id: unknown) => id !== undefined && id !== null && id !== '')
if (!wave_ids.length) {
ElMessage.warning('当前勾选记录缺少可用的波次 ID')
return
}
batchOutboundPrintLoading.value = true
try {
const res: any = await getWavePrintData({ warehouse_id: warehouseId, wave_ids })
const payload = unwrapWavePrintPayloadFromConfig(res)
const waveList = Array.isArray(payload.wave_list) ? payload.wave_list : []
const { printRows, dataMap } = buildOutboundPrintQueue(waveList, rows)
if (!printRows.length) {
ElMessage.warning('未获取到可打印的出库单明细,请确认波次下存在订单且快递已完全分配')
return
}
outboundPrintRows.value = printRows
outboundPrintDataMap.value = dataMap
outboundPrintDialogVisible.value = true
ElMessage.success(res?.message || `已获取出库单打印数据,共 ${printRows.length} 单`)
} catch (error: any) {
outboundPrintRows.value = []
outboundPrintDataMap.value = {}
ElMessage.error(error?.message || '获取出库单打印数据失败')
} finally {
batchOutboundPrintLoading.value = false
}
}
async function handleBatchOutboundPrint() {
if (!selectionRows.value.length) {
ElMessage.warning('请先勾选要打印的波次')
return
}
const autoGroupingRows = [...autoGroupingSelectionRows.value]
const removedCount = autoGroupingRows.length
if (removedCount) {
autoGroupingRows.forEach((row: any) => {
upperTable.value?.toggleRowSelection?.(row, false)
})
}
if (!printableSelectionRows.value.length) {
ElMessage.warning('自动加团中的波次不参与批量打印,已从当前勾选中移除')
return
}
if (waveMaxOrderLimit.value !== null && selectedWaveOrderTotal.value > waveMaxOrderLimit.value) {
ElMessage.warning(`选中波次总订单数为 ${selectedWaveOrderTotal.value},超过仓库配置上限 ${waveMaxOrderLimit.value} 单,暂不允许批量打印`)
return
}
if (waveMaxOrderLimit.value === null) {
ElMessage.warning('未获取到仓库波次最大订单数量配置,暂无法执行批量打印')
return
}
if (removedCount) {
ElMessage.warning(`已自动移除 ${removedCount} 个“自动加团中”波次,不计入批量打印`)
}
await openBatchOutboundPrintDialog(printableSelectionRows.value)
}
async function handleBatchPrintPickingList() {
if (!selectionRows.value.length) {
ElMessage.warning('请先勾选要打印拣货单的波次')

View File

@ -421,6 +421,17 @@
:fetch-print-data="loadWavePrintFormData"
/>
<batch-receiving-print-dialog
v-model="outboundPrintDialogVisible"
:selection-rows="outboundPrintRows"
business-type="STOCKOUT"
dialog-title="批量打印出库单"
queue-no-field="delivery_order_code"
document-label="出库单"
hide-business-type-select
:fetch-print-data="loadOutboundPrintFormData"
/>
<wave-platform-print-preview-dialog
v-model="platformPrintDialogVisible"
:error-message="platformPrintErrorMessage"
@ -464,7 +475,10 @@ import {
formatWaveExpressAssignmentStatusLabel,
formatWavePrintAssignmentStatusLabel,
formatWaveReviewAssignmentStatusLabel,
getWaveAssignmentAggregateTagType
getWaveAssignmentAggregateTagType,
buildOutboundPrintQueue,
unwrapWavePrintPayload as unwrapWavePrintPayloadFromConfig,
resolveOutboundPrintRowKey
} from './config/wave-config'
import { safeInvoke } from '@/utils/safe-invoke'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'
@ -541,6 +555,7 @@ const batchAutoGroupingLoading = ref(false)
const batchFinishAutoGroupingLoading = ref(false)
const batchCancelLoading = ref(false)
const batchPrintLoading = ref(false)
const batchOutboundPrintLoading = ref(false)
const batchPlatformPrintLoading = ref(false)
const platformPrintDialogVisible = ref(false)
const platformPrintPayload = ref<WavePlatformPrintDataPayload | null>(null)
@ -554,6 +569,9 @@ const userStore = useUserStore()
const wavePrintDialogVisible = ref(false)
const wavePrintRows = ref<any[]>([])
const wavePrintDataMap = ref<Record<string, any>>({})
const outboundPrintDialogVisible = ref(false)
const outboundPrintRows = ref<any[]>([])
const outboundPrintDataMap = ref<Record<string, any>>({})
const queryTime = ref(0)
const tableSize = ref('small')
const activeTab = ref('detail')
@ -699,6 +717,7 @@ const buttonLoadingMap = computed(() => ({
batchFinishAutoGroupingLoading: batchFinishAutoGroupingLoading.value,
batchCancelLoading: batchCancelLoading.value,
batchPrintLoading: batchPrintLoading.value,
batchOutboundPrintLoading: batchOutboundPrintLoading.value,
batchPlatformPrintLoading: batchPlatformPrintLoading.value,
batchAllocateExpressLoading: batchAllocateExpressLoading.value,
batchAllocateStorageLoading: batchAllocateStorageLoading.value,
@ -709,12 +728,14 @@ const batchPlatformPrintDisabled = computed(() => !printableSelectionRows.value.
const buttonDisabledMap = computed(() => ({
batchPrintDisabled: batchPrintDisabled.value,
batchOutboundPrintDisabled: batchPrintDisabled.value,
batchPlatformPrintDisabled: batchPlatformPrintDisabled.value,
noSelection: !hasSelection.value
}))
const buttonLabelMap = computed(() => ({
batchPrintTotal: `批量打印(${selectedWaveOrderTotal.value})`,
batchOutboundPrintTotal: `批量打印出库单(${selectedWaveOrderTotal.value})`,
batchPlatformPrintTotal: `批量打印(平台)(${selectedWaveOrderTotal.value})`,
detailToggleLabel: detailVisible.value ? '隐藏详情' : '显示详情'
}))
@ -741,6 +762,9 @@ const toolbarActionMap: Record<string, () => void> = {
openColumnConfigPanel: () => openColumnConfigPanel(),
toggleDetailVisible: () => toggleDetailVisible(),
handleBatchPrint: () => handleBatchPrint(),
handleBatchOutboundPrint: () => {
void handleBatchOutboundPrint()
},
handleBatchPlatformPrint: () => {
void handleBatchPlatformPrint()
},
@ -1378,6 +1402,87 @@ async function handleBatchPrint() {
}
}
async function loadOutboundPrintFormData(row: any) {
const key = String(row?.id ?? resolveOutboundPrintRowKey(row || {}, String(row?.wave_id ?? ''), 0))
return outboundPrintDataMap.value[key] || row || {}
}
async function openBatchOutboundPrintDialog(rows: any[]) {
const first = rows[0] as Record<string, unknown>
const warehouseId = Number(first?.warehouse_id ?? userStore.user?.warehouse_id ?? userStore.user?.store_id)
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
ElMessage.error('无法确定仓库 ID,请确认列表中的仓库字段或当前登录仓库上下文')
return
}
const wave_ids = rows
.map((row: any) => row?.id ?? row?.wave_id ?? row?.batch_id)
.filter((id: unknown) => id !== undefined && id !== null && id !== '')
if (!wave_ids.length) {
ElMessage.warning('当前勾选记录缺少可用的波次 ID')
return
}
batchOutboundPrintLoading.value = true
try {
const res: any = await getWavePrintData({ warehouse_id: warehouseId, wave_ids })
const payload = unwrapWavePrintPayloadFromConfig(res)
const waveList = Array.isArray(payload.wave_list) ? payload.wave_list : []
const { printRows, dataMap } = buildOutboundPrintQueue(waveList, rows)
if (!printRows.length) {
ElMessage.warning('未获取到可打印的出库单明细,请确认波次下存在订单且快递已完全分配')
return
}
outboundPrintRows.value = printRows
outboundPrintDataMap.value = dataMap
outboundPrintDialogVisible.value = true
ElMessage.success(res?.message || `已获取出库单打印数据,共 ${printRows.length} 单`)
} catch (error: any) {
outboundPrintRows.value = []
outboundPrintDataMap.value = {}
ElMessage.error(error?.message || '获取出库单打印数据失败')
} finally {
batchOutboundPrintLoading.value = false
}
}
async function handleBatchOutboundPrint() {
if (!selectionRows.value.length) {
ElMessage.warning('请先勾选要打印的波次')
return
}
const autoGroupingRows = [...autoGroupingSelectionRows.value]
const removedCount = autoGroupingRows.length
if (removedCount) {
autoGroupingRows.forEach((row: any) => {
upperTable.value?.toggleRowSelection?.(row, false)
})
}
if (!printableSelectionRows.value.length) {
ElMessage.warning('自动加团中的波次不参与批量打印,已从当前勾选中移除')
return
}
if (waveMaxOrderLimit.value !== null && selectedWaveOrderTotal.value > waveMaxOrderLimit.value) {
ElMessage.warning(`选中波次总订单数为 ${selectedWaveOrderTotal.value},超过仓库配置上限 ${waveMaxOrderLimit.value} 单,暂不允许批量打印`)
return
}
if (waveMaxOrderLimit.value === null) {
ElMessage.warning('未获取到仓库波次最大订单数量配置,暂无法执行批量打印')
return
}
if (removedCount) {
ElMessage.warning(`已自动移除 ${removedCount} 个“自动加团中”波次,不计入批量打印`)
}
await openBatchOutboundPrintDialog(printableSelectionRows.value)
}
function stopFetchTaskPolling() {
if (fetchTaskPollTimer.value) {
clearTimeout(fetchTaskPollTimer.value)

View File

@ -334,6 +334,17 @@ export const waveToolbarButtons: WaveToolbarButtonConfig[] = [
loadingKey: 'batchPlatformPrintLoading',
action: 'handleBatchPlatformPrint'
},
{
key: 'batchOutboundPrint',
label: '批量打印出库单(0)',
dynamicLabelKey: 'batchOutboundPrintTotal',
type: 'info',
plain: true,
size: 'small',
disabledKey: 'batchOutboundPrintDisabled',
loadingKey: 'batchOutboundPrintLoading',
action: 'handleBatchOutboundPrint'
},
{
key: 'printerComponentConnection',
label: '打印组件连接',
@ -845,3 +856,114 @@ export function getPickTaskSourceTagType(value: unknown): 'info' | 'success' {
if (num === 1) return 'success'
return 'info'
}
export function unwrapWavePrintPayload(res: any) {
const inner =
res?.data !== undefined && res?.data !== null && typeof res.data === 'object' && !Array.isArray(res.data)
? res.data
: res
const summaryRaw = inner?.summary
const summary =
summaryRaw !== undefined && summaryRaw !== null && typeof summaryRaw === 'object' && !Array.isArray(summaryRaw)
? (summaryRaw as Record<string, unknown>)
: {}
const waveListRaw = inner?.wave_list
const wave_list = Array.isArray(waveListRaw)
? (waveListRaw.filter((x) => x && typeof x === 'object') as Record<string, unknown>[])
: []
const extRaw = inner?.ext
const ext =
extRaw !== undefined && extRaw !== null && typeof extRaw === 'object' && !Array.isArray(extRaw)
? (extRaw as Record<string, unknown>)
: undefined
return { summary, wave_list, ext }
}
export function getWaveOrders(wave: Record<string, unknown>) {
const keys = ['orders', 'order_list', 'order_details', 'items', 'print_orders', 'order_rows', 'details']
for (const key of keys) {
const value = wave[key]
if (Array.isArray(value)) return value
}
return []
}
export function getWaveOrderLineItems(order: Record<string, unknown>) {
const keys = ['items', 'order_items', 'details', 'order_details', 'sku_list', 'goods_list', 'lines']
for (const key of keys) {
const value = order[key]
if (Array.isArray(value)) return value
}
return []
}
export function resolveWaveRowKey(row: Record<string, unknown>) {
return String(row?.id ?? row?.wave_id ?? row?.batch_id ?? row?.wave_no ?? '')
}
export function resolveOutboundQueueNo(order: Record<string, unknown>, fallback = '—') {
return String(
order.delivery_order_code
?? order.delivery_no
?? order.order_sn
?? order.order_no
?? order.order_number
?? fallback
)
}
export function resolveOutboundPrintRowKey(
order: Record<string, unknown>,
waveKey: string,
index: number
) {
const orderId = order.order_id ?? order.id ?? `${waveKey}-${index}`
return `${waveKey}::${orderId}`
}
export function toOutboundPrintForm(order: Record<string, unknown>, wave: Record<string, unknown>) {
const lineItems = getWaveOrderLineItems(order)
return {
...wave,
...order,
wave_no: String(wave.wave_no ?? wave.batch_no ?? wave.wave_code ?? wave.id ?? '—'),
delivery_order_code: resolveOutboundQueueNo(order),
details: lineItems
}
}
export function buildOutboundPrintQueue(
waveList: Record<string, unknown>[],
selectedWaveRows: any[]
) {
const waveByKey = new Map<string, Record<string, unknown>>()
waveList.forEach((wave) => {
const key = resolveWaveRowKey(wave)
if (key) waveByKey.set(key, wave)
})
const printRows: any[] = []
const dataMap: Record<string, any> = {}
selectedWaveRows.forEach((waveRow) => {
const waveKey = resolveWaveRowKey(waveRow || {})
const wave = (waveKey ? waveByKey.get(waveKey) : undefined) || (waveRow as Record<string, unknown>)
const orders = getWaveOrders(wave)
orders.forEach((order, index) => {
const orderRec = order && typeof order === 'object' ? (order as Record<string, unknown>) : {}
const rowKey = resolveOutboundPrintRowKey(orderRec, waveKey || 'wave', index)
const queueNo = resolveOutboundQueueNo(orderRec, rowKey)
const queueRow = {
...orderRec,
id: rowKey,
delivery_order_code: queueNo,
wave_no: String(wave.wave_no ?? waveRow?.wave_no ?? waveRow?.batch_no ?? waveRow?.wave_code ?? '—'),
wave_id: waveKey || waveRow?.id
}
printRows.push(queueRow)
dataMap[rowKey] = toOutboundPrintForm(orderRec, wave)
})
})
return { printRows, dataMap }
}

View File

@ -395,13 +395,6 @@ const validateItemCode = async (rule: any, value: any, callback: any) => {
return
}
const pattern = /^[A-Za-z0-9_\-\u3400-\u4DBF\u4E00-\u9FFF\uF900-\uFAFF]+$/
if (!pattern.test(value)) {
itemCodeError.value = "商品编码只能包含字母、数字、汉字、下划线和短横线"
callback(new Error(itemCodeError.value))
return
}
if (value.length > 20) {
itemCodeError.value = "条码长度不能超过20个字符"
callback(new Error(itemCodeError.value))

View File

@ -595,14 +595,6 @@ const validateItemCode = async (rule: any, value: string, callback: any) => {
return
}
// 检查格式(允许字母、数字、汉字、下划线、短横线)
const pattern = /^[A-Za-z0-9_\-\u3400-\u4DBF\u4E00-\u9FFF\uF900-\uFAFF]+$/
if (!pattern.test(value)) {
itemCodeError = "商品编码只能包含字母、数字、汉字、下划线和短横线"
callback(new Error('商品编码只能包含字母、数字、汉字、下划线和短横线'))
return
}
// 检查长度
if (value.length > 20) {
itemCodeError = "条码长度不能超过20个字符"

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-06-12 11:18:58
- 更新时间: 2026-06-15 09:45:23
- 扫描目录: `src\api`
- 模块数: 41
- API 文件数: 41
- 接口数: 354
- 已启用: 316
- 接口数: 356
- 已启用: 319
- 占位接口: 2
## 模块统计
@ -15,17 +15,17 @@
| config | 1 | 1 | 0 | 0 |
| dashboard | 1 | 6 | 6 | 0 |
| index | 1 | 25 | 22 | 1 |
| order | 1 | 3 | 2 | 0 |
| order | 1 | 3 | 3 | 0 |
| order.archiveorder | 1 | 2 | 2 | 0 |
| order.deliveryexpectionorder | 1 | 2 | 2 | 0 |
| order.deliveryorder | 1 | 2 | 2 | 0 |
| order.entrustorder | 1 | 2 | 2 | 0 |
| order.expectionorder | 1 | 3 | 3 | 0 |
| order.index | 1 | 10 | 9 | 0 |
| order.index | 1 | 11 | 10 | 0 |
| order.outboundorder | 1 | 3 | 3 | 0 |
| order.pendingorder | 1 | 27 | 25 | 0 |
| order.print | 1 | 4 | 4 | 0 |
| order.recheckorder | 1 | 6 | 4 | 0 |
| order.recheckorder | 1 | 7 | 5 | 0 |
| order.revieworder | 1 | 3 | 3 | 0 |
| order.wave | 1 | 30 | 28 | 0 |
| pick | 1 | 4 | 4 | 0 |
@ -106,6 +106,7 @@
| order.expectionorder | orderExpectionOrderResolveException | order.expectionOrder.resolveException | POST | 是 | 否 | order.expectionorder/orderexpectionorder.ts | |
| order.index | orderBadgeCount | order.badgeCount | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderBindExpressPackageMaterial | order.bindExpressPackageMaterial | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderBindExpressPackageMaterialByWaybill | order.bindExpressPackageMaterialByWaybill | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderDetail | order.detail | POST | 否 | 否 | order.index/orderindex.ts | |
| order.index | orderExport | order.export | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderExportTaskProgress | order.exportTaskProgress | POST | 是 | 否 | order.index/orderindex.ts | |
@ -148,6 +149,7 @@
| order.print | getWavePlatformPrintData | order.print.getWavePlatformPrintData | POST | 是 | 否 | order.print/orderprint.ts | |
| order.print | getWavePrintData | order.print.getWavePrintData | POST | 是 | 否 | order.print/orderprint.ts | |
| order.print | unlockWavePlatformPrintDataByGroup | order.print.unlockWavePlatformPrintDataByGroup | POST | 是 | 否 | order.print/orderprint.ts | |
| order.recheckorder | batchQuickRecheck | order.recheckOrder.batchQuickRecheck | POST | 是 | 否 | order.recheckorder/recheckOrder.ts | |
| order.recheckorder | confirmIntercept | order.recheckOrder.confirmIntercept | POST | 是 | 否 | order.recheckorder/recheckOrder.ts | |
| order.recheckorder | confirmRecheck | order.recheckOrder.confirmRecheck | POST | 是 | 否 | order.recheckorder/recheckOrder.ts | |
| order.recheckorder | scanOrder | order.recheckOrder.scanOrder | POST | 是 | 否 | order.recheckorder/recheckOrder.ts | |

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -12,27 +12,139 @@
"label": "全部"
}
},
"totalInterfaceCount": 313,
"totalInterfaceCount": 315,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleDeleted": 0,
"moduleUpdated": 0,
"interfaceAdded": 0,
"moduleUpdated": 4,
"interfaceAdded": 2,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
"interfaceParamsUpdated": 1,
"interfaceResponseUpdated": 4
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": []
"updated": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"previousModuleName": "订单工作台入口模块",
"previousModuleKey": "order.index",
"interfaceChanges": {
"addedMethods": [
"order.bindExpressPackageMaterialByWaybill"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.detail"
]
}
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"previousModuleName": "订单复核模块",
"previousModuleKey": "order.recheckOrder",
"interfaceChanges": {
"addedMethods": [
"order.recheckOrder.batchQuickRecheck"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.recheckOrder.scanOrder"
]
}
},
{
"moduleName": "订单配送模块",
"moduleKey": "order.deliveryOrder",
"folder": "order.deliveryorder",
"previousModuleName": "订单配送模块",
"previousModuleKey": "order.deliveryOrder",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.deliveryOrder.detail"
]
}
},
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"previousModuleName": "仓库设置模块",
"previousModuleKey": "setting.warehouse",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"setting.warehouse.saveSettings"
],
"responseUpdatedMethods": [
"setting.warehouse.getSettings"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"added": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"method": "order.bindExpressPackageMaterialByWaybill"
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"method": "order.recheckOrder.batchQuickRecheck"
}
],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
"paramsUpdated": [
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"method": "setting.warehouse.saveSettings"
}
],
"responseUpdated": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"method": "order.detail"
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"method": "order.recheckOrder.scanOrder"
},
{
"moduleName": "订单配送模块",
"moduleKey": "order.deliveryOrder",
"folder": "order.deliveryorder",
"method": "order.deliveryOrder.detail"
},
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"method": "setting.warehouse.getSettings"
}
]
}
},
"interfaces": [
@ -1604,6 +1716,75 @@
}
]
},
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"moduleFolder": "order.index",
"method": "order.bindExpressPackageMaterialByWaybill",
"title": "按运单号绑定包材。仅需传入运单号与包材编码,系统自动根据运单号反查对应订单运单记录并绑定包材,无需传入订单ID。",
"description": "按运单号绑定包材。仅需传入运单号与包材编码,系统自动根据运单号反查对应订单运单记录并绑定包材,无需传入订单ID。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "waybill_code",
"type": "string",
"required": true,
"description": "运单号,必填。"
},
{
"name": "package_material_code",
"type": "string",
"required": true,
"description": "包材编码,必填。"
}
],
"response": [
{
"name": "order_id",
"type": "number",
"required": true,
"description": "运单号对应的订单ID(成功时返回于 data 对象中)。"
},
{
"name": "waybill_code",
"type": "string",
"required": true,
"description": "运单号(成功时返回于 data 对象中)。"
},
{
"name": "package_material_id",
"type": "number",
"required": true,
"description": "绑定后的包材ID(成功时返回于 data 对象中)。"
},
{
"name": "package_material_name_snapshot",
"type": "string",
"required": true,
"description": "绑定时写入的包材名称快照(成功时返回于 data 对象中)。"
},
{
"name": "package_material_code",
"type": "string",
"required": true,
"description": "绑定成功的包材编码(成功时返回于 data 对象中)。"
}
]
},
{
"moduleName": "订单配送异常模块",
"moduleKey": "order.deliveryExpectionOrder",
@ -1776,31 +1957,31 @@
{
"name": "order",
"type": "object",
"required": false,
"required": true,
"description": "订单头对象(raw 行数据)"
},
{
"name": "detail",
"type": "object",
"required": false,
"required": true,
"description": "等同于 order"
},
{
"name": "orderItems / items",
"type": "array",
"required": false,
"required": true,
"description": "商品明细数组"
},
{
"name": "expresses",
"type": "array",
"required": false,
"description": "运单信息数组"
"required": true,
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)、package_material_id(包材ID,number|null)、package_material_name_snapshot(包材名称快照,string|null)"
},
{
"name": "waybill_codes",
"type": "array",
"required": false,
"required": true,
"description": "去重后的运单号字符串数组"
}
]
@ -1927,7 +2108,7 @@
"name": "expresses",
"type": "array",
"required": true,
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)"
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)、package_material_id(包材ID,number|null)、package_material_name_snapshot(包材名称快照,string|null)"
},
{
"name": "waybill_codes",
@ -5364,6 +5545,63 @@
}
]
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"moduleFolder": "order.recheckorder",
"method": "order.recheckOrder.batchQuickRecheck",
"title": "批量快捷复核:传入订单 IDs 列表,对每个有效订单执行前置检查(已分配储位、已分配快递、已同步且未被拦截),必要时自动完成拣货(含库存锁定校验与扣减、库存流水写入、拣货任务状态同步)后标记复核(含复核任务记录、任务复核状态更新、车任务解绑、操作日志)。每个订单在独立事务中执行,支持部分失败,不满足条件的订单跳过并返回原因。",
"description": "批量快捷复核:传入订单 IDs 列表,对每个有效订单执行前置检查(已分配储位、已分配快递、已同步且未被拦截),必要时自动完成拣货(含库存锁定校验与扣减、库存流水写入、拣货任务状态同步)后标记复核(含复核任务记录、任务复核状态更新、车任务解绑、操作日志)。每个订单在独立事务中执行,支持部分失败,不满足条件的订单跳过并返回原因。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array<number>|string",
"required": true,
"description": "订单 ID 列表,支持数组或以逗号分隔的字符串"
}
],
"response": [
{
"name": "success",
"type": "array",
"required": true,
"description": "复核成功的订单列表"
},
{
"name": "failed",
"type": "array",
"required": true,
"description": "复核失败的订单列表"
},
{
"name": "success_count",
"type": "number",
"required": true,
"description": "成功数量"
},
{
"name": "failed_count",
"type": "number",
"required": true,
"description": "失败数量"
}
]
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
@ -5666,7 +5904,7 @@
"name": "list",
"type": "array",
"required": true,
"description": "统一列表输出。散单模式(list_type=single)有波次信息时:扁平订单数组;无波次信息时退回单订单详情模式(每项含 detail、items、expresses、logs)。团购模式(list_type=group):波次视图数组(每项含 wave_id、wave_no、wave_type、wave_status、total_orders、processed_orders、creator、create_time、update_time、order_count、pick_mode、box_no、orders[])"
"description": "统一列表输出。散单模式(list_type=single)有波次信息时:扁平订单数组;无波次信息时退回单订单详情模式(每项含 detail、items、expresses、logs)。团购模式(list_type=group):波次视图数组(每项含 wave_id、wave_no、wave_type、wave_status、total_orders、processed_orders、creator、create_time、update_time、order_count、pick_mode、box_no、order_ids、orders_detail、stocks[])"
}
]
},
@ -12480,6 +12718,54 @@
"type": "boolean",
"required": true,
"description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)"
},
{
"name": "subject_config.auto_outbound_rules",
"type": "object",
"required": true,
"description": "自动出库规则配置。全部条件满足时自动标记待出库"
},
{
"name": "subject_config.auto_outbound_rules.enabled",
"type": "boolean",
"required": true,
"description": "是否启用自动出库,默认 false"
},
{
"name": "subject_config.auto_outbound_rules.require_recheck",
"type": "boolean",
"required": true,
"description": "是否要求已复核(recheck_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pack",
"type": "boolean",
"required": true,
"description": "是否要求已打包(pack_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_weigh",
"type": "boolean",
"required": true,
"description": "是否要求已称重(weighing_weight>0),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_sync",
"type": "boolean",
"required": true,
"description": "是否要求已同步(sync_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_print",
"type": "boolean",
"required": true,
"description": "是否要求已打印(print_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pick",
"type": "boolean",
"required": true,
"description": "是否要求已拣货(pick_status=fin),默认 true"
}
]
},
@ -12529,6 +12815,54 @@
"type": "boolean",
"required": false,
"description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)"
},
{
"name": "subject_config.auto_outbound_rules",
"type": "object",
"required": false,
"description": "自动出库规则配置。全部条件满足时自动标记待出库"
},
{
"name": "subject_config.auto_outbound_rules.enabled",
"type": "boolean",
"required": false,
"description": "是否启用自动出库,默认 false"
},
{
"name": "subject_config.auto_outbound_rules.require_recheck",
"type": "boolean",
"required": false,
"description": "是否要求已复核(recheck_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pack",
"type": "boolean",
"required": false,
"description": "是否要求已打包(pack_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_weigh",
"type": "boolean",
"required": false,
"description": "是否要求已称重(weighing_weight>0),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_sync",
"type": "boolean",
"required": false,
"description": "是否要求已同步(sync_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_print",
"type": "boolean",
"required": false,
"description": "是否要求已打印(print_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pick",
"type": "boolean",
"required": false,
"description": "是否要求已拣货(pick_status=fin),默认 true"
}
],
"response": [

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -13,27 +13,139 @@
}
},
"moduleCount": 41,
"totalInterfaceCount": 313,
"totalInterfaceCount": 315,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleDeleted": 0,
"moduleUpdated": 0,
"interfaceAdded": 0,
"moduleUpdated": 4,
"interfaceAdded": 2,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
"interfaceParamsUpdated": 1,
"interfaceResponseUpdated": 4
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": []
"updated": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"previousModuleName": "订单工作台入口模块",
"previousModuleKey": "order.index",
"interfaceChanges": {
"addedMethods": [
"order.bindExpressPackageMaterialByWaybill"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.detail"
]
}
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"previousModuleName": "订单复核模块",
"previousModuleKey": "order.recheckOrder",
"interfaceChanges": {
"addedMethods": [
"order.recheckOrder.batchQuickRecheck"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.recheckOrder.scanOrder"
]
}
},
{
"moduleName": "订单配送模块",
"moduleKey": "order.deliveryOrder",
"folder": "order.deliveryorder",
"previousModuleName": "订单配送模块",
"previousModuleKey": "order.deliveryOrder",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": [
"order.deliveryOrder.detail"
]
}
},
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"previousModuleName": "仓库设置模块",
"previousModuleKey": "setting.warehouse",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"setting.warehouse.saveSettings"
],
"responseUpdatedMethods": [
"setting.warehouse.getSettings"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"added": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"method": "order.bindExpressPackageMaterialByWaybill"
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"method": "order.recheckOrder.batchQuickRecheck"
}
],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
"paramsUpdated": [
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"method": "setting.warehouse.saveSettings"
}
],
"responseUpdated": [
{
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"method": "order.detail"
},
{
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"method": "order.recheckOrder.scanOrder"
},
{
"moduleName": "订单配送模块",
"moduleKey": "order.deliveryOrder",
"folder": "order.deliveryorder",
"method": "order.deliveryOrder.detail"
},
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"method": "setting.warehouse.getSettings"
}
]
}
},
"modules": [
@ -528,7 +640,7 @@
"moduleName": "订单复核模块",
"moduleKey": "order.recheckOrder",
"folder": "order.recheckorder",
"interfaceCount": 5,
"interfaceCount": 6,
"interfaces": [
{
"method": "order.recheckOrder.scanOrder"
@ -544,6 +656,9 @@
},
{
"method": "order.recheckOrder.scanTask"
},
{
"method": "order.recheckOrder.batchQuickRecheck"
}
]
},
@ -551,7 +666,7 @@
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"interfaceCount": 10,
"interfaceCount": 11,
"interfaces": [
{
"method": "order.list"
@ -577,6 +692,9 @@
{
"method": "order.bindExpressPackageMaterial"
},
{
"method": "order.bindExpressPackageMaterialByWaybill"
},
{
"method": "order.export"
},

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -26,7 +26,9 @@
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
"responseUpdatedMethods": [
"order.deliveryOrder.detail"
]
}
}
},
@ -128,31 +130,31 @@
{
"name": "order",
"type": "object",
"required": false,
"required": true,
"description": "订单头对象(raw 行数据)"
},
{
"name": "detail",
"type": "object",
"required": false,
"required": true,
"description": "等同于 order"
},
{
"name": "orderItems / items",
"type": "array",
"required": false,
"required": true,
"description": "商品明细数组"
},
{
"name": "expresses",
"type": "array",
"required": false,
"description": "运单信息数组"
"required": true,
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)、package_material_id(包材ID,number|null)、package_material_name_snapshot(包材名称快照,string|null)"
},
{
"name": "waybill_codes",
"type": "array",
"required": false,
"required": true,
"description": "去重后的运单号字符串数组"
}
]

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -16,17 +16,21 @@
"name": "订单工作台入口模块",
"key": "order.index",
"folder": "order.index",
"interfaceCount": 10
"interfaceCount": 11
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"addedMethods": [
"order.bindExpressPackageMaterialByWaybill"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
"responseUpdatedMethods": [
"order.detail"
]
}
}
},
@ -147,7 +151,7 @@
"name": "expresses",
"type": "array",
"required": true,
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)"
"description": "运单信息数组,每个元素包含以下字段:waybill_code(运单号,string)、weighing_weight(称重重量,number|null)、sys_logistics_code(系统物流公司编码,string)、sys_logistics_name(系统物流公司名称,string)、logistics_code(实际物流公司编码,string)、logistics_name(实际物流公司名称,string)、logistics_interface_id(物流接口ID,number|null)、business_key(业务标识,string)、created_at(创建时间戳毫秒,number|null)、package_material_id(包材ID,number|null)、package_material_name_snapshot(包材名称快照,string|null)"
},
{
"name": "waybill_codes",
@ -594,6 +598,72 @@
}
]
},
{
"method": "order.bindExpressPackageMaterialByWaybill",
"title": "按运单号绑定包材。仅需传入运单号与包材编码,系统自动根据运单号反查对应订单运单记录并绑定包材,无需传入订单ID。",
"description": "按运单号绑定包材。仅需传入运单号与包材编码,系统自动根据运单号反查对应订单运单记录并绑定包材,无需传入订单ID。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "waybill_code",
"type": "string",
"required": true,
"description": "运单号,必填。"
},
{
"name": "package_material_code",
"type": "string",
"required": true,
"description": "包材编码,必填。"
}
],
"response": [
{
"name": "order_id",
"type": "number",
"required": true,
"description": "运单号对应的订单ID(成功时返回于 data 对象中)。"
},
{
"name": "waybill_code",
"type": "string",
"required": true,
"description": "运单号(成功时返回于 data 对象中)。"
},
{
"name": "package_material_id",
"type": "number",
"required": true,
"description": "绑定后的包材ID(成功时返回于 data 对象中)。"
},
{
"name": "package_material_name_snapshot",
"type": "string",
"required": true,
"description": "绑定时写入的包材名称快照(成功时返回于 data 对象中)。"
},
{
"name": "package_material_code",
"type": "string",
"required": true,
"description": "绑定成功的包材编码(成功时返回于 data 对象中)。"
}
]
},
{
"method": "order.export",
"title": "提交订单导出任务(异步)。入参支持 table_type/tableType 与 module/module_name;where 与 sort 语义与 order.list 一致。提交后立即返回 task_id,后台异步执行,导出进度/下载请通过 order.exportTaskProgress 查询。",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-05 09:15:19",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-20 08:59:09",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -16,17 +16,21 @@
"name": "订单复核模块",
"key": "order.recheckOrder",
"folder": "order.recheckorder",
"interfaceCount": 5
"interfaceCount": 6
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"addedMethods": [
"order.recheckOrder.batchQuickRecheck"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
"responseUpdatedMethods": [
"order.recheckOrder.scanOrder"
]
}
}
},
@ -153,7 +157,7 @@
"name": "list",
"type": "array",
"required": true,
"description": "统一列表输出。散单模式(list_type=single)有波次信息时:扁平订单数组;无波次信息时退回单订单详情模式(每项含 detail、items、expresses、logs)。团购模式(list_type=group):波次视图数组(每项含 wave_id、wave_no、wave_type、wave_status、total_orders、processed_orders、creator、create_time、update_time、order_count、pick_mode、box_no、orders[])"
"description": "统一列表输出。散单模式(list_type=single)有波次信息时:扁平订单数组;无波次信息时退回单订单详情模式(每项含 detail、items、expresses、logs)。团购模式(list_type=group):波次视图数组(每项含 wave_id、wave_no、wave_type、wave_status、total_orders、processed_orders、creator、create_time、update_time、order_count、pick_mode、box_no、order_ids、orders_detail、stocks[])"
}
]
},
@ -444,6 +448,60 @@
"description": "统一列表输出。散单模式(list_type=single):扁平订单数组(每项结构与 scanOrder 散单有波次模式一致,含 order_id/delivery_order_code/waybill_no/pick_status/is_printed/is_reviewed/shop_nick/items_count/wave_index/recheck_status/order_type/status/logistics_name/store_remark/intercept_status/stock[])。团购模式(list_type=group):波次视图数组(结构与 scanOrder 团购模式一致,每项含 wave_id/wave_no/wave_type/wave_status/total_orders/processed_orders/creator/create_time/update_time/order_count/pick_mode/box_no/orders[])"
}
]
},
{
"method": "order.recheckOrder.batchQuickRecheck",
"title": "批量快捷复核:传入订单 IDs 列表,对每个有效订单执行前置检查(已分配储位、已分配快递、已同步且未被拦截),必要时自动完成拣货(含库存锁定校验与扣减、库存流水写入、拣货任务状态同步)后标记复核(含复核任务记录、任务复核状态更新、车任务解绑、操作日志)。每个订单在独立事务中执行,支持部分失败,不满足条件的订单跳过并返回原因。",
"description": "批量快捷复核:传入订单 IDs 列表,对每个有效订单执行前置检查(已分配储位、已分配快递、已同步且未被拦截),必要时自动完成拣货(含库存锁定校验与扣减、库存流水写入、拣货任务状态同步)后标记复核(含复核任务记录、任务复核状态更新、车任务解绑、操作日志)。每个订单在独立事务中执行,支持部分失败,不满足条件的订单跳过并返回原因。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array<number>|string",
"required": true,
"description": "订单 ID 列表,支持数组或以逗号分隔的字符串"
}
],
"response": [
{
"name": "success",
"type": "array",
"required": true,
"description": "复核成功的订单列表"
},
{
"name": "failed",
"type": "array",
"required": true,
"description": "复核失败的订单列表"
},
{
"name": "success_count",
"type": "number",
"required": true,
"description": "成功数量"
},
{
"name": "failed_count",
"type": "number",
"required": true,
"description": "失败数量"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-09 09:52:14",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 17:23:48",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-06-03 16:55:40",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-29 09:07:53",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-29 09:07:53",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {
@ -25,8 +25,12 @@
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
"paramsUpdatedMethods": [
"setting.warehouse.saveSettings"
],
"responseUpdatedMethods": [
"setting.warehouse.getSettings"
]
}
}
},
@ -69,6 +73,54 @@
"type": "boolean",
"required": true,
"description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)"
},
{
"name": "subject_config.auto_outbound_rules",
"type": "object",
"required": true,
"description": "自动出库规则配置。全部条件满足时自动标记待出库"
},
{
"name": "subject_config.auto_outbound_rules.enabled",
"type": "boolean",
"required": true,
"description": "是否启用自动出库,默认 false"
},
{
"name": "subject_config.auto_outbound_rules.require_recheck",
"type": "boolean",
"required": true,
"description": "是否要求已复核(recheck_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pack",
"type": "boolean",
"required": true,
"description": "是否要求已打包(pack_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_weigh",
"type": "boolean",
"required": true,
"description": "是否要求已称重(weighing_weight>0),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_sync",
"type": "boolean",
"required": true,
"description": "是否要求已同步(sync_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_print",
"type": "boolean",
"required": true,
"description": "是否要求已打印(print_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pick",
"type": "boolean",
"required": true,
"description": "是否要求已拣货(pick_status=fin),默认 true"
}
]
},
@ -144,6 +196,54 @@
"type": "boolean",
"required": false,
"description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)"
},
{
"name": "subject_config.auto_outbound_rules",
"type": "object",
"required": false,
"description": "自动出库规则配置。全部条件满足时自动标记待出库"
},
{
"name": "subject_config.auto_outbound_rules.enabled",
"type": "boolean",
"required": false,
"description": "是否启用自动出库,默认 false"
},
{
"name": "subject_config.auto_outbound_rules.require_recheck",
"type": "boolean",
"required": false,
"description": "是否要求已复核(recheck_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pack",
"type": "boolean",
"required": false,
"description": "是否要求已打包(pack_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_weigh",
"type": "boolean",
"required": false,
"description": "是否要求已称重(weighing_weight>0),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_sync",
"type": "boolean",
"required": false,
"description": "是否要求已同步(sync_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_print",
"type": "boolean",
"required": false,
"description": "是否要求已打印(print_status=fin),默认 true"
},
{
"name": "subject_config.auto_outbound_rules.require_pick",
"type": "boolean",
"required": false,
"description": "是否要求已拣货(pick_status=fin),默认 true"
}
],
"response": [

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-25 17:05:16",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-15 17:32:36",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-13 17:11:23",
"generatedAtLocal": "2026-06-13 17:11:23",
"generatedAt": "2026-06-15 09:13:10",
"generatedAtLocal": "2026-06-15 09:13:10",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-13 17:11:23",
"updatedAt": "2026-06-15 09:13:10",
"deletedAt": null,
"restoredAt": null
}

Some files were not shown because too many files have changed in this diff Show More