feat(receiving): 新增批量审核、批量驳回功能及审核状态列

This commit is contained in:
liufumingren 2026-04-30 06:55:00 +08:00 committed by yin
parent 42bf6c7bfa
commit fcb1a982de
90 changed files with 2276 additions and 709 deletions

Binary file not shown.

10
package-lock.json generated
View File

@ -31,6 +31,7 @@
"vue-draggable-plus": "^0.6.1",
"vue-i18n": "^11.2.8",
"vue-router": "^5.0.3",
"vue-virtual-scroller": "^3.0.2",
"xlsx": "^0.18.5"
},
"devDependencies": {
@ -9748,6 +9749,15 @@
"typescript": ">=5.0.0"
}
},
"node_modules/vue-virtual-scroller": {
"version": "3.0.2",
"resolved": "https://registry.npmjs.org/vue-virtual-scroller/-/vue-virtual-scroller-3.0.2.tgz",
"integrity": "sha512-zneKxsBecfFBpH2NAk8zF0IWBRSYRaXnXK/dPQ/AnXE9xlbRyW6sSO9EUb5L5cSFz2Dpfb2giN30/y+/Xvu5PQ==",
"license": "MIT",
"peerDependencies": {
"vue": "^3.3.0"
}
},
"node_modules/webpack-virtual-modules": {
"version": "0.6.2",
"resolved": "https://registry.npmjs.org/webpack-virtual-modules/-/webpack-virtual-modules-0.6.2.tgz",

View File

@ -51,6 +51,7 @@
"vue-draggable-plus": "^0.6.1",
"vue-i18n": "^11.2.8",
"vue-router": "^5.0.3",
"vue-virtual-scroller": "^3.0.2",
"xlsx": "^0.18.5"
},
"devDependencies": {

View File

@ -55,6 +55,32 @@ export function batchCancelReceiving(data: any): Promise<any> {
})
}
export function reviewReceiving(data: any): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.receiving.reviewReceiving',
v,
timestamp: new Date().getTime()
},
data: data
})
}
export function rejectReceiving(data: any): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.receiving.rejectReceiving',
v,
timestamp: new Date().getTime()
},
data: data
})
}
// export function exportReceiving(data: any): Promise<any> {
// return request({
// url: '/system',
@ -247,6 +273,19 @@ export function detailChange(data: any): Promise<any> {
})
}
export function save(data: any): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.receiving.save',
v,
timestamp: new Date().getTime()
},
data
})
}
export function quickPutaway(data: {
/** 收货单ID */

View File

@ -168,11 +168,20 @@
v-for="(item, idx) in editableColumnConfigs"
:key="item.prop"
class="column-config-item"
:class="{
'is-draggable': true,
'is-drag-over': dragOverProp === item.prop
}"
draggable="true"
@dragstart="onColumnDragStart(item)"
@dragover.prevent="onColumnDragOver(item)"
@drop.prevent="onColumnDrop(item)"
@dragend="onColumnDragEnd"
>
<div class="column-config-main">
<span class="drag-handle">⋮⋮</span>
<el-checkbox
:model-value="item.visible"
:disabled="item.lockVisible"
@change="(val: any) => onToggleColumnVisible(item.prop, !!val)"
>
{{ item.label || item.prop }}
@ -181,14 +190,14 @@
<div class="column-config-actions">
<el-button
text
:disabled="idx === 0 || item.lockOrder"
:disabled="idx === 0"
@click="moveColumn(item.prop, 'up')"
>
上移
</el-button>
<el-button
text
:disabled="idx === editableColumnConfigs.length - 1 || item.lockOrder"
:disabled="idx === editableColumnConfigs.length - 1"
@click="moveColumn(item.prop, 'down')"
>
下移
@ -379,8 +388,6 @@ type ColumnItem = {
label?: string
width?: number | string
fixed?: 'left' | 'right' | boolean
lockVisible?: boolean
lockOrder?: boolean
[key: string]: any
}
@ -391,8 +398,6 @@ type ColumnConfigItem = {
order: number
width?: number | string
fixed?: 'left' | 'right' | false
lockVisible?: boolean
lockOrder?: boolean
}
type TableColumnProfile = {
@ -419,6 +424,8 @@ const checkboxUpdateKey = ref<number | null>(null)
const columnConfigDialogVisible = ref(false)
const editableColumnConfigs = ref<ColumnConfigItem[]>([])
const columnConfigMap = ref<Record<string, ColumnConfigItem>>({})
const draggingProp = ref<string>('')
const dragOverProp = ref<string>('')
const tableContainer = ref<HTMLElement | null>(null)
const bodyScrollEl = ref<HTMLElement | null>(null)
const virtualScrollTop = ref(0)
@ -473,7 +480,8 @@ const displayColumns = computed(() => {
return {
...column,
width: cfg.width ?? column.width,
fixed: cfg.fixed === false ? undefined : (cfg.fixed ?? column.fixed)
// 在字段设置模式下,以用户排序为最高优先级,避免 fixed 导致“置顶”不生效
fixed: undefined
}
})
})
@ -608,9 +616,7 @@ function getDefaultColumnConfigs() {
visible: true,
order: index,
width: column.width,
fixed: column.fixed === true ? 'left' : (column.fixed as 'left' | 'right' | undefined),
lockVisible: !!column.lockVisible,
lockOrder: !!column.lockOrder
fixed: column.fixed === true ? 'left' : (column.fixed as 'left' | 'right' | undefined)
}))
}
@ -706,7 +712,6 @@ function openColumnConfig() {
function onToggleColumnVisible(prop: string, visible: boolean) {
const next = editableColumnConfigs.value.map((item) => {
if (item.prop !== prop) return item
if (item.lockVisible) return item
return { ...item, visible }
})
editableColumnConfigs.value = next
@ -718,17 +723,58 @@ function moveColumn(prop: string, direction: 'up' | 'down') {
const index = list.findIndex((item) => item.prop === prop)
if (index === -1) return
const current = list[index]
if (current?.lockOrder) return
const targetIndex = direction === 'up' ? index - 1 : index + 1
if (targetIndex < 0 || targetIndex >= list.length) return
const target = list[targetIndex]
if (target?.lockOrder) return
list[index] = target as ColumnConfigItem
list[targetIndex] = current as ColumnConfigItem
editableColumnConfigs.value = list.map((item, idx) => ({ ...item, order: idx }))
persistEditableConfigs()
}
function onColumnDragStart(item: ColumnConfigItem) {
draggingProp.value = item.prop
}
function onColumnDragOver(item: ColumnConfigItem) {
if (!draggingProp.value) return
if (draggingProp.value === item.prop) return
dragOverProp.value = item.prop
}
function onColumnDrop(target: ColumnConfigItem) {
const sourceProp = draggingProp.value
if (!sourceProp || sourceProp === target.prop) {
onColumnDragEnd()
return
}
const list = [...editableColumnConfigs.value].sort((a, b) => a.order - b.order)
const sourceIndex = list.findIndex((item) => item.prop === sourceProp)
const targetIndex = list.findIndex((item) => item.prop === target.prop)
if (sourceIndex === -1 || targetIndex === -1) {
onColumnDragEnd()
return
}
const sourceItem = list[sourceIndex]
if (!sourceItem) {
onColumnDragEnd()
return
}
list.splice(sourceIndex, 1)
list.splice(targetIndex, 0, sourceItem)
editableColumnConfigs.value = list.map((item, idx) => ({ ...item, order: idx }))
persistEditableConfigs()
onColumnDragEnd()
}
function onColumnDragEnd() {
draggingProp.value = ''
dragOverProp.value = ''
}
function resetColumnConfig() {
const defaults = getDefaultColumnConfigs()
applyColumnConfigMap(defaults)
@ -1297,15 +1343,34 @@ watch(
border-bottom: 1px solid #f2f3f5;
}
.column-config-item.is-draggable {
cursor: move;
}
.column-config-item.is-drag-over {
background: #f0f9ff;
border-top: 1px dashed #409eff;
}
.column-config-item:last-child {
border-bottom: none;
}
.column-config-main {
display: flex;
align-items: center;
gap: 8px;
flex: 1;
min-width: 0;
}
.drag-handle {
color: #909399;
font-size: 14px;
line-height: 1;
user-select: none;
}
/* 表格尺寸样式 */
.upper-table-container.small :deep(.el-table) {
font-size: 12px;

View File

@ -225,15 +225,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})

View File

@ -7,7 +7,7 @@
<el-descriptions :column="4" border size="small">
<el-descriptions-item label="发货单号">{{ detail.delivery_order_code || '-' }}</el-descriptions-item>
<el-descriptions-item label="店铺名称">{{ detail.shop_nick || '-' }}</el-descriptions-item>
<el-descriptions-item label="来源平台">{{ detail.source_platform_name || '-' }}</el-descriptions-item>
<!-- <el-descriptions-item label="来源平台">{{ detail.source_platform_name || '-' }}</el-descriptions-item> -->
<el-descriptions-item label="买家昵称">{{ detail.buyer_nick || '-' }}</el-descriptions-item>
<el-descriptions-item label="订单状态">
<el-tag :type="getTagType('status', detail.status)" size="small">
@ -89,6 +89,7 @@ const props = defineProps<{
const loading = ref(false)
const detail = ref<Record<string, any> | null>(null)
let latestRequestId = 0
function formatTime(value: unknown) {
if (!value) return '-'
@ -112,6 +113,7 @@ async function loadDetail() {
detail.value = null
return
}
const requestId = ++latestRequestId
loading.value = true
try {
const res: any = await orderPendingOrder.detail({
@ -119,25 +121,30 @@ async function loadDetail() {
ids: [props.row.id],
tableType: 'order'
})
if (requestId !== latestRequestId) return
const ok = res && (res.code === 1 || res.code === 200)
if (!ok) {
ElMessage.error(res?.message || '获取订单明细失败')
detail.value = null
return
}
detail.value = res?.data?.detail || null
const payload = res?.data || {}
detail.value = payload.order || payload.detail || payload || null
} catch {
if (requestId !== latestRequestId) return
ElMessage.error('获取订单明细失败')
detail.value = null
} finally {
loading.value = false
if (requestId === latestRequestId) {
loading.value = false
}
}
}
watch(
() => props.row?.id,
() => [props.row?.id, props.row?.updated_at, props.row?.status],
() => {
loadDetail()
void loadDetail()
},
{ immediate: true }
)

View File

@ -355,10 +355,10 @@ export const deliveryAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'delivery_order_code', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '来源平台', value: 'source_platform_name', type: 'text' },
{ label: '来源平台', value: 'source_platform_name', type: 'select', options: [] },
{ label: '收货人', value: 'name', type: 'text' },
{ label: '手机号', value: 'mobile', type: 'text' },
{ label: '物流公司', value: 'logistics_name', type: 'text' },
{ label: '物流公司', value: 'logistics_name', type: 'select', options: [] },
{ label: '物流单号', value: 'waybill_codes', type: 'text' },
{ label: '紧急订单', value: 'is_urgency', type: 'select', options: [
{ label: '是', value: 'Y' },
@ -444,7 +444,7 @@ export const deliverybuttonList: any[] = [
export const reviewAvailableFields = [
{ label: '发货单号', value: 'delivery_order_code', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '平台编码', value: 'sys_platform_code', type: 'text' },
{ label: '平台编码', value: 'sys_platform_code', type: 'select', options: [] },
{ label: '收货人', value: 'name', type: 'text' },
{ label: '手机号', value: 'mobile', type: 'text' },
{ label: '订单状态', value: 'status', type: 'select', options: [ { label: '待审核', value: 'pedding' }, { label: '已创建', value: 'created' }, { label: '错误', value: 'error' } ] },
@ -558,12 +558,14 @@ export const pendingAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'order_code', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '来源平台', value: 'source_platform_name', type: 'text' },
{ label: '物流公司', value: 'logistics_name', type: 'text' },
{ label: '来源平台', value: 'source_platform_name', type: 'select', options: [] },
{ label: '物流公司', value: 'logistics_name', type: 'select', options: [] },
{ label: '物流单号', value: 'waybill_codes', type: 'text' },
{ label: '收货人', value: 'name', type: 'text' },
{ label: '手机号', value: 'mobile', type: 'text' },
{ label: '省/市/区', value: 'province_city_area', type: 'text' },
{ label: '省份', value: 'province', type: 'text' },
{ label: '城市', value: 'city', type: 'text' },
{ label: '区县', value: 'area', type: 'text' },
{ label: '是否紧急', value: 'is_urgency', type: 'select', options: [ { label: '是', value: 'Y' }, { label: '否', value: 'N' } ] },
{ label: '同步状态', value: 'sync_status', type: 'select', options: [ { label: '待同步', value: 'padding' }, { label: '已同步', value: 'fin' }, { label: '错误', value: 'error' } ] },
{ label: '下单时间', value: 'place_order_time', type: 'daterange' },
@ -588,7 +590,7 @@ export const pendingCloums = [
{ prop: 'create_at', label: '创建时间', width: '165', formatter: orderTimeFormatter },
{ prop: 'pay_time', label: '支付时间', width: '160', formatter: orderTimeFormatter },
{ prop: 'place_order_time', label: '时效', width: '165', formatter: orderTimeFormatter },
{ prop: 'source_platform_name', label: '来源', width: '120' },
{ prop: 'sys_platform_name', label: '来源', width: '120' },
{ prop: 'logistics_name', label: '快递', width: '120' },
{ prop: 'waybill_codes', label: '快递单号', width: '160', formatter: waybillCodesFormatter },
{ prop: 'remark', label: '留言', width: '160' },
@ -773,7 +775,7 @@ export const expectionOrderAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'order_code', type: 'input' },
{ label: '发货单号', value: 'delivery_order_code', type: 'input' },
{ label: '物流公司', value: 'logistics_name', type: 'input' },
{ label: '物流公司', value: 'logistics_name', type: 'select', options: [] },
{ label: '快递单号', value: 'express_code', type: 'input' },
{ label: '拦截状态', value: 'intercept_status', type: 'select', options: [
{ label: '无', value: 'none' },

View File

@ -225,15 +225,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})

View File

@ -157,7 +157,8 @@ import { ref, reactive, onMounted, computed } from 'vue'
import { ElMessage } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import { orderDeliveryOrder } from '@/api/order.deliveryOrder/orderdeliveryOrder'
import * as indexApi from '@/api/index/index'
import { orderDeliveryOrder } from '@/api/order.deliveryorder/orderdeliveryOrder'
import {
deliveryAvailableFields,
@ -208,8 +209,48 @@ function toggleDetailVisible() {
onMounted(() => {
loadData()
loadOrderMetaOptions()
})
function normalizeOptionValue(value: unknown) {
return String(value ?? '').trim()
}
function mapNameOptions(rawList: any[], nameKeys: string[]) {
const result: Array<{ label: string; value: string }> = []
const seen = new Set<string>()
for (const item of rawList || []) {
const name = normalizeOptionValue(nameKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
if (!name || seen.has(name)) continue
result.push({ label: name, value: name })
seen.add(name)
}
return result
}
async function loadOrderMetaOptions() {
try {
const [expressRes, platformRes] = await Promise.all([
indexApi.getExpressList({}),
indexApi.getPlatformList({})
])
const expressData: any = expressRes?.data
const platformData: any = platformRes?.data
const expressRaw = expressData?.list || expressData || []
const platformRaw = platformData?.list || platformData || []
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = mapNameOptions(expressRaw, ['name', 'logistics_name', 'express_name'])
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) platformField.options = mapNameOptions(platformRaw, ['name', 'platform_name'])
} catch {
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = []
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) platformField.options = []
}
}
async function loadData() {
if (loading.value) return
loading.value = true
@ -257,15 +298,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})

View File

@ -225,15 +225,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})

View File

@ -611,6 +611,18 @@ function mapCodeOptions(rawList: any[], codeKeys: string[], nameKeys: string[])
return result
}
function mapNameOptions(rawList: any[], nameKeys: string[]) {
const result: Array<{ label: string; value: string }> = []
const seen = new Set<string>()
for (const item of rawList || []) {
const name = normalizeCode(nameKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
if (!name || seen.has(name)) continue
result.push({ value: name, label: name })
seen.add(name)
}
return result
}
function getSelectedIds(): number[] {
const ids: number[] = []
for (const item of selectionRows.value) {
@ -943,15 +955,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})
@ -982,9 +997,15 @@ async function loadOrderMetaOptions() {
const platformRaw = platformData?.list || platformData || []
expressCodeOptions.value = mapCodeOptions(expressRaw, ['code', 'logistics_code', 'express_code'], ['name', 'logistics_name', 'express_name'])
platformCodeOptions.value = mapCodeOptions(platformRaw, ['code', 'platform_code'], ['name', 'platform_name'])
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) {
logisticsField.options = mapNameOptions(expressRaw, ['name', 'logistics_name', 'express_name'])
}
} catch {
expressCodeOptions.value = []
platformCodeOptions.value = []
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = []
}
}

View File

@ -169,6 +169,7 @@ import { computed, nextTick, onMounted, reactive, ref } from 'vue'
import { ElMessage } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import * as indexApi from '@/api/index/index'
import { orderOutboundOrder } from '@/api/order.outboundorder/orderoutboundOrder'
import {
outboundAvailableFields,
@ -246,15 +247,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})
@ -382,7 +386,47 @@ function openColumnConfigPanel() {
onMounted(() => {
loadData()
loadOrderMetaOptions()
})
function normalizeOptionValue(value: unknown) {
return String(value ?? '').trim()
}
function mapNameOptions(rawList: any[], nameKeys: string[]) {
const result: Array<{ label: string; value: string }> = []
const seen = new Set<string>()
for (const item of rawList || []) {
const name = normalizeOptionValue(nameKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
if (!name || seen.has(name)) continue
result.push({ label: name, value: name })
seen.add(name)
}
return result
}
async function loadOrderMetaOptions() {
try {
const [expressRes, platformRes] = await Promise.all([
indexApi.getExpressList({}),
indexApi.getPlatformList({})
])
const expressData: any = expressRes?.data
const platformData: any = platformRes?.data
const expressRaw = expressData?.list || expressData || []
const platformRaw = platformData?.list || platformData || []
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = mapNameOptions(expressRaw, ['name', 'logistics_name', 'express_name'])
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) platformField.options = mapNameOptions(platformRaw, ['name', 'platform_name'])
} catch {
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = []
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) platformField.options = []
}
}
</script>
<style scoped lang="scss">

View File

@ -405,15 +405,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})
@ -590,6 +593,21 @@ function mapCodeOptions(rawList: any[], codeKeys: string[], nameKeys: string[])
return result
}
function mapNameOptions(rawList: any[], nameKeys: string[]) {
const result: Array<{ label: string; value: string }> = []
const seen = new Set<string>()
for (const item of rawList || []) {
const name = normalizeCode(nameKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
if (!name || seen.has(name)) continue
result.push({
value: name,
label: name
})
seen.add(name)
}
return result
}
async function loadOrderMetaOptions() {
try {
const [expressRes, platformRes] = await Promise.all([
@ -602,9 +620,21 @@ async function loadOrderMetaOptions() {
const platformRaw = platformData?.list || platformData || []
expressCodeOptions.value = mapCodeOptions(expressRaw, ['code', 'logistics_code', 'express_code'], ['name', 'logistics_name', 'express_name'])
platformCodeOptions.value = mapCodeOptions(platformRaw, ['code', 'platform_code'], ['name', 'platform_name'])
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) {
logisticsField.options = mapNameOptions(expressRaw, ['name', 'logistics_name', 'express_name'])
}
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) {
platformField.options = mapNameOptions(platformRaw, ['name', 'platform_name'])
}
} catch {
expressCodeOptions.value = []
platformCodeOptions.value = []
const logisticsField = availableFieldsRef.find((i: any) => i.value === 'logistics_name')
if (logisticsField) logisticsField.options = []
const platformField = availableFieldsRef.find((i: any) => i.value === 'source_platform_name')
if (platformField) platformField.options = []
}
}

View File

@ -144,6 +144,7 @@ import { ref, reactive, onMounted, computed } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import * as indexApi from '@/api/index/index'
import { orderReviewOrder } from '@/api/order.revieworder/orderreviewOrder'
import {
@ -204,8 +205,44 @@ const selectedRow = computed(() => {
onMounted(() => {
loadData()
loadOrderMetaOptions()
})
function normalizeOptionValue(value: unknown) {
return String(value ?? '').trim()
}
function mapCodeOptions(rawList: any[], codeKeys: string[], nameKeys: string[]) {
const result: Array<{ label: string; value: string }> = []
const seen = new Set<string>()
for (const item of rawList || []) {
const code = normalizeOptionValue(codeKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
if (!code || seen.has(code)) continue
const name = normalizeOptionValue(nameKeys.map((k) => item?.[k]).find((v) => v !== undefined && v !== null && v !== ''))
result.push({
value: code,
label: name ? `${code} - ${name}` : code
})
seen.add(code)
}
return result
}
async function loadOrderMetaOptions() {
try {
const platformRes: any = await indexApi.getPlatformList({})
const platformData: any = platformRes?.data
const platformRaw = platformData?.list || platformData || []
const platformField = availableFieldsRef.find((i: any) => i.value === 'sys_platform_code')
if (platformField) {
platformField.options = mapCodeOptions(platformRaw, ['code', 'platform_code'], ['name', 'platform_name'])
}
} catch {
const platformField = availableFieldsRef.find((i: any) => i.value === 'sys_platform_code')
if (platformField) platformField.options = []
}
}
async function loadData() {
if (loading.value) return
loading.value = true
@ -251,15 +288,18 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
const where: Record<string, any> = {}
Object.keys(rawConditions || {}).forEach((key) => {
const condition = rawConditions[key]
const normalizedKey = key === 'order_code' ? 'delivery_order_code' : key
if (condition && typeof condition === 'object' && 'operator' in condition) {
where[key] = condition
where[normalizedKey] = Array.isArray(condition.value)
? { ...condition, value: condition.value[0] ?? '', type: 'text' }
: condition
return
}
if (condition !== undefined && condition !== null && condition !== '') {
where[key] = {
where[normalizedKey] = {
operator: 'eq',
value: condition,
type: Array.isArray(condition) ? 'array' : typeof condition
value: Array.isArray(condition) ? condition[0] ?? '' : condition,
type: 'text'
}
}
})

View File

@ -93,7 +93,7 @@
<!-- 底部操作按钮 -->
<div class="bottom">
<el-button-group class="toolbar-btn-group">
<el-button type="primary" size="small" icon="Check" disabled :loading="saveLoading">
<el-button type="primary" size="small" icon="Check" :loading="saveLoading" @click="handleSave">
保存
</el-button>
<el-button type="danger" size="small" icon="Refresh" @click="handleReset">
@ -122,32 +122,102 @@ const props = defineProps<{
}>()
const form = ref({
id: '',
receiving_number: '',
store_name: '',
store_id: '',
detail_status: '',
creator_name: '',
delivery_method: '',
license_plate: '',
tracking_number: '',
status: '',
loading_method: '',
total_items: 0,
total_quantity: 0,
total_boxes: 0,
total_pallets: 0,
remark: ''
remark: '',
video_device_id: ''
})
const saveLoading = ref(false)
const parseOptionalNumber = (value: any) => {
if (value === '' || value === null || value === undefined) return undefined
const n = Number(value)
return Number.isFinite(n) ? n : undefined
}
const normalizeOptionalString = (value: any) => {
if (value === null || value === undefined) return undefined
const text = String(value).trim()
return text || undefined
}
const handleSave = async () => {
const receivingId = Number((form.value as any).id || props.row?.id)
if (!Number.isFinite(receivingId) || receivingId <= 0) {
ElMessage.warning('缺少收货单ID,无法保存')
return
}
const payload: any = {
id: receivingId,
delivery_method: normalizeOptionalString(form.value.delivery_method),
loading_method: normalizeOptionalString(form.value.loading_method),
remark: normalizeOptionalString(form.value.remark),
total_boxes: parseOptionalNumber((form.value as any).total_boxes),
total_pallets: parseOptionalNumber((form.value as any).total_pallets),
status: normalizeOptionalString((form.value as any).status),
video_device_id: normalizeOptionalString((form.value as any).video_device_id),
}
const rawStoreId = (form.value as any).store_id
if (rawStoreId === '' || rawStoreId === null || rawStoreId === undefined) {
payload.store_id = null
} else {
const storeIdNum = Number(rawStoreId)
if (!Number.isFinite(storeIdNum)) {
ElMessage.warning('货主ID格式不正确')
return
}
payload.store_id = storeIdNum
}
const deliveryMethod = payload.delivery_method
if (deliveryMethod === 'truck') {
payload.license_plate = normalizeOptionalString(form.value.license_plate)
payload.tracking_number = ''
} else if (['express', 'air_freight', 'sea_freight'].includes(deliveryMethod)) {
payload.tracking_number = normalizeOptionalString((form.value as any).tracking_number)
payload.license_plate = ''
} else {
payload.license_plate = ''
payload.tracking_number = ''
}
try {
saveLoading.value = true
// 这里可以调用接口保存数据
ElMessage.success('保存成功')
saveLoading.value = true
const res: any = await receivingApi.save(payload)
if (res && (res.code === 200 || res.flag === 'success')) {
if (props.row) {
Object.assign(props.row, {
...props.row,
...payload,
id: receivingId,
store_id: payload.store_id ?? '',
store_name: form.value.store_name
})
}
ElMessage.success(res.message || '保存成功')
} else {
ElMessage.error((res && res.message) || '保存失败')
}
} catch (error) {
ElMessage.error('保存失败')
ElMessage.error('保存失败')
} finally {
saveLoading.value = false
saveLoading.value = false
}
}

View File

@ -19,6 +19,8 @@
完成收货
</el-button>
<el-button size="small" :disabled="!hasSelection" @click="confirmBatchCancel">批量作废</el-button>
<el-button type="warning" size="small" :disabled="!hasSelection" @click="handleRejectReceiving">批量驳回</el-button>
<el-button type="primary" size="small" :disabled="!hasSelection" :loading="reviewLoading" @click="handleReviewReceiving">批量审核</el-button>
<el-button type="success" size="small" :disabled="selectionRows.length !== 1" :loading="quickPutawayLoading" @click="handleQuickPutaway">快捷入库</el-button>
<el-button type="info" size="small" icon="el-icon-printer" @click="handleOpenPrintDialog" title="打印收货单"
:disabled="!hasSelection" class="toolbar-btn">
@ -65,6 +67,12 @@
</el-tag>
</template>
<template #column-is_review="{ row }">
<el-tag :type="row.is_review === 1 || row.is_review === true ? 'success' : 'info'" size="small">
{{ row.is_review === 1 || row.is_review === true ? '已审核' : '未审核' }}
</el-tag>
</template>
<template #column-delivery_method="{ row }">
<el-tag v-if="row.delivery_method"
:type="deliveryMethodConfig[row.delivery_method as keyof typeof deliveryMethodConfig]?.tagType || 'info'"
@ -256,6 +264,24 @@
<el-button size="small" type="primary" :loading="createLoading" @click="submitCreateReceiving">确定</el-button>
</template>
</el-dialog>
<!-- 驳回收货单对话框 -->
<el-dialog v-model="rejectDialogVisible" title="批量驳回收货单" width="480px" align-center>
<el-form label-width="80px" size="small">
<el-form-item label="驳回理由">
<el-input
v-model="rejectRemark"
type="textarea"
:rows="3"
placeholder="请输入驳回理由(选填,将覆盖原备注)"
/>
</el-form-item>
</el-form>
<template #footer>
<el-button size="small" @click="rejectDialogVisible = false">取消</el-button>
<el-button size="small" type="warning" :loading="rejectLoading" @click="submitRejectReceiving">确认驳回</el-button>
</template>
</el-dialog>
</div>
</template>
@ -1113,6 +1139,82 @@ async function confirmBatchCancel() {
}
}
// 审核收货单相关
const reviewLoading = ref(false)
async function handleReviewReceiving() {
if (!selectionRows.value.length) {
ElMessage.warning('请先选择要审核的收货单')
return
}
try {
await ElMessageBox.confirm(
`确定要批量审核 ${selectionRows.value.length} 个收货单吗?\n审核后将会直接通知货主且不可撤销。`,
'确认审核',
{ type: 'warning' }
)
} catch {
return
}
reviewLoading.value = true
try {
const ids = selectionRows.value.map(row => row.id)
const res: any = await receivingApi.reviewReceiving({ ids })
if (res && res.code === 200) {
ElMessage.success(`已成功审核 ${res.data?.count ?? ids.length} 个收货单`)
selectionRows.value = []
loadData()
} else {
ElMessage.error(res?.message || '批量审核失败')
}
} catch (e) {
console.error('批量审核出错:', e)
ElMessage.error('审核操作执行失败')
} finally {
reviewLoading.value = false
}
}
// 驳回收货单相关
const rejectDialogVisible = ref(false)
const rejectLoading = ref(false)
const rejectRemark = ref('')
function handleRejectReceiving() {
if (!selectionRows.value.length) {
ElMessage.warning('请先选择要驳回的收货单')
return
}
rejectRemark.value = ''
rejectDialogVisible.value = true
}
async function submitRejectReceiving() {
rejectLoading.value = true
try {
const ids = selectionRows.value.map(row => row.id)
const payload: any = { ids }
if (rejectRemark.value) payload.remark = rejectRemark.value
const res: any = await receivingApi.rejectReceiving(payload)
if (res && res.code === 200) {
ElMessage.success(`已成功驳回 ${res.data?.count ?? ids.length} 个收货单`)
rejectDialogVisible.value = false
selectionRows.value = []
loadData()
} else {
ElMessage.error(res?.message || '驳回失败')
}
} catch (e) {
console.error('驳回收货单出错:', e)
ElMessage.error('驳回操作执行失败')
} finally {
rejectLoading.value = false
}
}
function printReceiving() {
if (!selectionRows.value.length) {
ElMessage.warning('请选择要打印的收货单')

View File

@ -102,6 +102,7 @@ export const receivingColumns = [
{ prop: 'status', label: '收货状态', width: '90', align: 'center' },
{ prop: 'detail_status', label: '匹配状态', width: '90', align: 'center' },
{ prop: 'storage_status', label: '入库状态', width: '90', align: 'center' },
{ prop: 'is_review', label: '审核状态', width: '90', align: 'center' },
{ prop: 'store_name', label: '货主', width: '100' },
{ prop: 'total_items', label: '商品种类', width: '90', align: 'right', sortable: true },
{ prop: 'total_quantity', label: '总数量', width: '90', align: 'right', sortable: true },
@ -263,15 +264,16 @@ export const detailpanel = [
{ prop: 'receiving_number', label: '收货单号', type: 'input', disabled: true },
{ prop: 'store_name', label: '货主', type: 'input', disabled: true },
{ prop: 'creator_name', label: '创建人', type: 'input', disabled: true },
{ prop: 'status', label: '收货状态', type: 'select', disabled: true},
{ prop: 'detail_status', label: '匹配状态', type: 'select' },
{ prop: 'storage_status', label: '入库状态', type: 'select' },
// { prop: 'status', label: '收货状态', type: 'select', disabled: true},
// { prop: 'detail_status', label: '匹配状态', type: 'select' },
// { prop: 'storage_status', label: '入库状态', type: 'select' },
{ prop: 'delivery_method', label: '来货方式', type: 'select' },
{ prop: 'license_plate', label: '车牌号', type: 'input' },
{ prop: 'loading_method', label: '装卸方式', type: 'select' },
{ prop: 'total_items', label: '商品种类', type: 'number' },
{ prop: 'total_quantity', label: '总数量', type: 'number' },
{ prop: 'total_boxes', label: '总箱数', type: 'number' },
{ prop: 'total_pallets', label: '总托盘数', type: 'number' },
// { prop: 'total_items', label: '商品种类', type: 'number' },
// { prop: 'total_quantity', label: '总数量', type: 'number' },
// { prop: 'total_boxes', label: '总箱数', type: 'number' },
// { prop: 'total_pallets', label: '总托盘数', type: 'number' },
{ prop: 'remark', label: '备注', type: 'textarea' },
]

View File

@ -56,23 +56,28 @@ function handleNodeClick(data: any) {
<style scoped>
.warehouse-tree-card {
height: 220px;
height: 200px;
display:flex;
flex-direction: column;
.el-card__header {
padding: 0;
height:40px;
line-height: 40px;
padding-left: 20px;
height:30px;
line-height: 30px;
padding-left: 10px;
.clearfix{
display:flex;
flex-direction: row;
justify-content: space-between;
align-items: center;
height: 30px;
font-size: 16px;
padding-right: 6px;
}
}
.el-card__body{
flex:1;
height: 10px;
padding: 6px 8px;
}
.tree-container {
height: 100%;
@ -81,10 +86,10 @@ function handleNodeClick(data: any) {
.tree-node {
display: flex;
align-items: center;
font-size: 14px;
font-size: 12px;
i {
margin-right: 6px;
margin-right: 4px;
color: #409EFF;
}
@ -94,4 +99,12 @@ function handleNodeClick(data: any) {
}
}
}
:deep(.el-card__header .el-button) {
font-size: 11px;
padding: 0 4px;
min-height: 22px;
}
:deep(.el-tree-node__content) {
height: 26px;
}
</style>

View File

@ -84,18 +84,22 @@ function getZoneTypeText(type: string) { return zoneTypeMap[type]?.text || type
<style scoped>
.zone-management-card {
flex: 1;
min-height: 0;
display: flex;
flex-direction: column;
.el-card__header {
padding:0;
height:40px;
line-height:40px;
padding-left: 20px;
height:34px;
line-height:34px;
padding-left: 12px;
font-size: 13px;
}
.el-card__body{
height: 100px;
height: 0;
flex:1;
min-height: 0;
padding: 8px 10px;
}
.zone-tree-container {
height: 100%;
@ -106,12 +110,12 @@ function getZoneTypeText(type: string) { return zoneTypeMap[type]?.text || type
align-items: center;
justify-content: space-between;
width: 100%;
font-size: 14px;
font-size: 12px;
.node-content {
display: flex;
align-items: center;
gap: 8px;
gap: 6px;
.node-label {
max-width: 150px;
@ -133,7 +137,7 @@ function getZoneTypeText(type: string) { return zoneTypeMap[type]?.text || type
}
.el-icon {
font-size: 16px;
font-size: 14px;
}
}
@ -143,4 +147,7 @@ function getZoneTypeText(type: string) { return zoneTypeMap[type]?.text || type
}
}
}
:deep(.zone-tree-container .el-tree-node__content) {
height: 28px;
}
</style>

View File

@ -4,6 +4,7 @@
title="导入批量修改"
width="1000px"
top="calc(50% - 250px)"
align-center
:close-on-click-modal="false"
destroy-on-close
append-to-body
@ -27,62 +28,70 @@
<el-tag type="danger" v-if="errorCount>0">错误: {{ errorCount }}</el-tag>
</div>
<div style="flex:1;overflow:auto;padding:8px;">
<el-table :data="items" stripe size="small" border style="width:100%" :row-class-name="rowClassName">
<el-table-column prop="space_code" label="仓位编码" width="160">
<template #default="{ row }">
<div>{{ getRowValue(row, 'space_code') }}</div>
</template>
</el-table-column>
<div class="virtual-table-wrap">
<div class="virtual-table">
<div class="virtual-table-header virtual-table-row">
<div class="cell cell-space-code">仓位编码</div>
<div class="cell cell-custom-name">自定义名称</div>
<div class="cell cell-custom-barcode">自定义条码</div>
<div class="cell cell-pick-sequence">拣货顺序</div>
<div class="cell cell-location-type">库位类型</div>
<div class="cell cell-error">错误</div>
<div class="cell cell-action">操作</div>
</div>
<el-table-column prop="custom_name" label="自定义名称" width="160">
<template #default="{ row, $index }">
<el-input :model-value="getRowValue(row, 'custom_name')" clearable @update:modelValue="(val: any) => (setRowValue(row, 'custom_name', val), onRowChange($index))"></el-input>
</template>
</el-table-column>
<RecycleScroller
class="virtual-table-body"
:items="items"
:item-size="56"
key-field="__virtualKey"
:buffer="300"
>
<template #default="{ item, index }">
<div class="virtual-table-row" :class="{ 'row-error': !!errors[index] }">
<div class="cell cell-space-code">
{{ getRowValue(item, 'space_code') }}
</div>
<el-table-column prop="custom_barcode" label="自定义条码" width="120">
<template #default="{ row, $index }">
<el-input :model-value="getRowValue(row, 'custom_barcode')" clearable @update:modelValue="(val: any) => (setRowValue(row, 'custom_barcode', val), onRowChange($index))"></el-input>
</template>
</el-table-column>
<div class="cell cell-custom-name">
<el-input :model-value="getRowValue(item, 'custom_name')" clearable @update:modelValue="(val: any) => (setRowValue(item, 'custom_name', val), onRowChange(index))"></el-input>
</div>
<el-table-column prop="pick_sequence" label="拣货顺序" width="120">
<template #default="{ row, $index }">
<el-input-number :model-value="getRowValue(row, 'pick_sequence')" :min="0" :controls="false" @change="(val: any) => (setRowValue(row, 'pick_sequence', val), onRowChange($index))"></el-input-number>
</template>
</el-table-column>
<div class="cell cell-custom-barcode">
<el-input :model-value="getRowValue(item, 'custom_barcode')" clearable @update:modelValue="(val: any) => (setRowValue(item, 'custom_barcode', val), onRowChange(index))"></el-input>
</div>
<el-table-column prop="location_type_name" label="库位类型" width="120">
<template #default="{ row, $index }">
<el-select :model-value="getRowValue(row, 'location_type_name')" placeholder="请选择" filterable clearable @change="(val: any) => (setRowValue(row, 'location_type_name', val), onRowChange($index))">
<el-option
v-for="(lt, idx) in locationTypes"
:key="lt.id ?? idx"
:label="lt.label"
:value="lt.value"
/>
</el-select>
</template>
</el-table-column>
<div class="cell cell-pick-sequence">
<el-input-number :model-value="getRowValue(item, 'pick_sequence')" :min="0" :controls="false" @change="(val: any) => (setRowValue(item, 'pick_sequence', val), onRowChange(index))"></el-input-number>
</div>
<el-table-column label="错误" width="160">
<template #default="{ row, $index }">
<div v-if="errors[$index]">
<el-tooltip :content="errors[$index]" placement="top">
<el-tag type="danger">{{ errors[$index] }}</el-tag>
</el-tooltip>
<div class="cell cell-location-type">
<el-select :model-value="getRowValue(item, 'location_type_name')" placeholder="请选择" filterable clearable @change="(val: any) => (setRowValue(item, 'location_type_name', val), onRowChange(index))">
<el-option
v-for="(lt, idx) in locationTypes"
:key="lt.id ?? idx"
:label="lt.label"
:value="lt.value"
/>
</el-select>
</div>
<div class="cell cell-error">
<div v-if="errors[index]">
<el-tooltip :content="errors[index]" placement="top">
<el-tag type="danger">{{ errors[index] }}</el-tag>
</el-tooltip>
</div>
</div>
<div class="cell cell-action">
<el-button link type="primary" size="small" @click="removeRow(index)">移除</el-button>
<el-button link type="primary" size="small" @click="validateRow(index)">校验</el-button>
</div>
</div>
</template>
</el-table-column>
<el-table-column label="操作" width="120">
<template #default="{ row, $index }">
<el-button link type="primary" size="small" @click="removeRow($index)">移除</el-button>
<el-button link type="primary" size="small" @click="validateRow($index)">校验</el-button>
</template>
</el-table-column>
</el-table>
</RecycleScroller>
</div>
</div>
</div>
</div>
@ -97,9 +106,11 @@
<script setup lang="ts">
import { ref, reactive, computed, nextTick } from 'vue'
import * as XLSX from 'xlsx'
import { RecycleScroller } from 'vue-virtual-scroller'
import * as warehouseApi from '@/api/warehouse/warehouse'
import * as indexApi from '@/api/index/index'
import { ElMessage } from 'element-plus'
import 'vue-virtual-scroller/dist/vue-virtual-scroller.css'
const visible = ref(false)
const loaded = ref(false)
@ -293,6 +304,7 @@ function parseRowsToItems(rows: any[], headerOrder?: string[]) {
parsedHeaderKeys.value = headerKeys
items.value = rows
refreshVirtualKeys()
loaded.value = true
// 如果已有库位类型,把名称转换为 id 再校验;否则直接校验
if (locationTypes.value && locationTypes.value.length) {
@ -326,6 +338,7 @@ function remapItemsLocationTypes() {
function removeRow(index: number) {
items.value.splice(index, 1)
refreshVirtualKeys()
nextTick(() => validateAll())
}
@ -339,8 +352,10 @@ function onRowChange(index: number) {
validateRow(index)
}
function rowClassName({ row, rowIndex }: any) {
return errors[rowIndex] ? 'row-error' : ''
function refreshVirtualKeys() {
items.value.forEach((row: any, index: number) => {
row.__virtualKey = `row-${index}`
})
}
const errorCount = computed(() => Object.keys(errors).length)
@ -524,7 +539,86 @@ async function submit() {
align-items: center;
justify-content: center;
}
.row-error td {
.virtual-table-wrap {
flex: 1;
overflow: auto;
padding: 8px;
}
.virtual-table {
min-width: 960px;
border: 1px solid var(--el-border-color-lighter);
border-radius: 4px;
overflow: hidden;
}
.virtual-table-header {
background: var(--el-fill-color-light);
font-weight: 500;
border-bottom: 1px solid var(--el-border-color-lighter);
}
.virtual-table-body {
height: 420px;
}
.virtual-table-row {
display: flex;
align-items: center;
min-height: 56px;
border-bottom: 1px solid var(--el-border-color-lighter);
}
.virtual-table-row:last-child {
border-bottom: none;
}
.cell {
box-sizing: border-box;
padding: 8px;
border-right: 1px solid var(--el-border-color-lighter);
}
.cell:last-child {
border-right: none;
}
.cell-space-code {
width: 160px;
}
.cell-custom-name {
width: 160px;
}
.cell-custom-barcode {
width: 120px;
}
.cell-pick-sequence {
width: 120px;
}
.cell-location-type {
width: 120px;
}
.cell-error {
width: 160px;
}
.cell-action {
width: 120px;
}
.cell-pick-sequence :deep(.el-input-number),
.cell-location-type :deep(.el-select),
.cell-custom-name :deep(.el-input),
.cell-custom-barcode :deep(.el-input) {
width: 100%;
}
.row-error {
background: #fff6f6 !important;
}
</style>

View File

@ -31,17 +31,22 @@
<el-tabs v-model="activeRightTab" class="right-tabs">
<!-- 空间管理 -->
<el-tab-pane label="空间管理" name="spaces">
<rack-space-management
:rack="selectedRack"
ref="rackSpaceManagement"
@refresh="refreshRackSpaces"
@space-click="spaceClick"
/>
<space-card
v-if="selectedRack"
:spaceId="currentSpaceId"
@spaceSave="handleSpaceSave"
/>
<div class="spaces-pane">
<div class="spaces-pane__list">
<rack-space-management
:rack="selectedRack"
ref="rackSpaceManagement"
@refresh="refreshRackSpaces"
@space-click="spaceClick"
/>
</div>
<div v-if="selectedRack" class="spaces-pane__detail">
<space-card
:spaceId="currentSpaceId"
@spaceSave="handleSpaceSave"
/>
</div>
</div>
</el-tab-pane>
<!-- 路径管理 -->
@ -294,7 +299,7 @@ const refreshCurrentWarehouse = async () => {
// 刷新货架格子数据
const refreshRackSpaces = async () => {
if (selectedRack.value && rackSpaceManagement.value) {
await rackSpaceManagement.value.loadSpaces()
await rackSpaceManagement.value.loadRackSpaces()
}
}
@ -426,7 +431,7 @@ onMounted(() => {
.main-layout {
display: flex;
height: 100%;
padding: 16px;
padding: 8px 16px;
gap: 16px;
.sidebar {
@ -442,26 +447,54 @@ onMounted(() => {
&.right-sidebar {
flex-shrink: 0;
width: 600px;
overflow: hidden;
min-height: 0;
.right-tabs {
height: 100%;
display: flex;
flex-direction: column;
min-height: 0;
:deep(.el-tabs__header) {
flex-shrink: 0;
}
:deep(.el-tabs__content) {
flex: 1;
overflow-y: auto;
overflow: hidden;
min-height: 0;
.el-tab-pane {
display: flex;
flex-direction: column;
gap: 12px;
gap: 0;
height: 100%;
min-height: 0;
}
}
}
}
}
.spaces-pane {
display: flex;
flex-direction: column;
height: 100%;
min-height: 0;
// gap: 0px;
.spaces-pane__list {
// flex: 0 0 64%;
min-height: 0;
}
.spaces-pane__detail {
flex: 0 0 calc(36% - 10px);
min-height: 0;
}
}
.main-content {
flex: 1;
min-width: 0;

View File

@ -253,24 +253,28 @@ function refresh() {
.rack-space-management {
display: flex;
flex-direction: column;
gap: 16px;
gap: 10px;
overflow-y: auto;
flex: 0 0 auto;
max-height: 240px;
.el-card__header {
padding: 0;
height: 40px;
line-height: 40px;
padding-left: 20px;
height: 34px;
line-height: 34px;
padding-left: 12px;
font-weight: 400;
font-size: 13px;
}
.el-card__body{
font-size: 14px;
font-size: 12px;
padding: 10px 12px;
}
.rack-management,
.info-display {
flex: 1;
display: flex;
flex-direction: column;
gap: 16px;
gap: 10px;
}
.card-header {
display: flex;
@ -278,6 +282,28 @@ function refresh() {
align-items: center;
font-weight: 600;
color: #303133;
font-size: 13px;
}
.info-item {
margin-bottom: 4px;
line-height: 1.4;
}
.statistics-section {
margin-top: 8px;
}
:deep(.statistics-section h4) {
margin: 0 0 8px;
font-size: 12px;
}
:deep(.stat-item) {
padding: 6px 8px;
}
:deep(.stat-label) {
font-size: 11px;
}
:deep(.stat-value) {
font-size: 14px;
line-height: 1.2;
}
.zone-image-placeholder {

View File

@ -0,0 +1,167 @@
# stock.stockWarehouse 前端查询规则
## 目的
本文档约束 `stock.stockWarehouse` 的 `where` 构造格式,便于前端统一构建查询条件,并与后端解析器保持一致。
## 接口入口
- 路由:`POST /system`
- method:`stock.stockWarehouse`
## 请求体结构
```json
{
"pagination": {
"page": 1,
"pageSize": 20
},
"where": {
"item_code": {
"operator": "like",
"value": "SKU",
"type": "text"
}
}
}
```
## where 字段规则
`where` 必须是对象,且每个字段值也必须是对象。
正确示例:
```json
{
"where": {
"item_name": {
"operator": "like",
"value": "鞋",
"type": "text"
}
}
}
```
错误示例(会返回解析失败原因):
```json
{
"where": {
"item_name": "鞋"
}
}
```
## 条件对象结构
每个 `where.<field>` 支持:
- `operator`:操作符,默认 `eq`
- `value`:查询值
- `type`:值类型(可选)
- `field`:映射到真实字段(一般不需要前端传)
### 支持操作符
- `eq`
- `ne`
- `like` / `contains`
- `startswith`
- `endswith`
- `gt`
- `lt`
- `ge`
- `le`
- `in`
- `notin`
- `between`
- `notbetween`
- `isnull`
- `isnotnull`
- `regexp`
- `notregexp`
### 支持 type
- `boolean`:转换为 `Y/N`
- `number`:转换为数字
- `date`:日期字符串归一化
- `daterange`:日期数组归一化
- `text`:逗号分隔字符串拆分数组
## 特殊字段说明
### barcode
- 在条码表中先匹配,再回灌 `stock_id` 过滤主表。
- 推荐:`operator=eq|like`。
### prohibited_type
- 传入的是违禁品类型 `id`。
- 后端会映射到关联模型进行过滤。
## 空值处理
以下值会被视为“空条件”并跳过:
- `null`
- `undefined`
- `""`
- `[]`
## 排序规则
后端只接受以下排序字段:
- `id`
- `item_code`
- `item_name`
- `quantity`
- `locked_quantity`
- `tag_price`
- `retail_price`
- `create_at`
- `update_at`
当传入非法排序字段时,会回退为:
- `sortField=create_at`
- `sortOrder=DESC`
## 失败返回(解构失败)
当 `where` 结构不合法时,返回示例:
```json
{
"code": 400,
"message": "筛选条件解析失败: 字段 item_code 条件必须是对象",
"data": {
"list": [],
"pagination": {
"page": 1,
"pageSize": 20,
"total": 0,
"totalPages": 0,
"hasPrevious": false,
"hasNext": false
},
"summary": {
"total_quantity": 0,
"total_locked": 0,
"total_available": 0,
"total_items": 0
}
}
}
```
## 前端建议
- 对 `in/notin/between/notbetween` 先做数组校验,再发请求。
- 对 `where` 做 schema 校验,避免后端 400。
- 对空输入不构造条件,减少无效查询。

View File

@ -3,20 +3,392 @@
{
"接口": "user.login",
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3NzczNjg3MTgsImV4cCI6MTc3NzM4MzExOH0.fGpEVBs6wjnNl3bUu-W9GRvENk4HPqmtU7ALMtdffvY"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc1NDIyOTAsImV4cCI6MTc3NzU1NjY5MH0.WDBNzCpCdi3m7yH0W_yAJM3wAv2RMC2ykppCNKZtu7w"
}
},
{
"接口": "index.getLocationTypeList",
"data": null
"接口": "index.getPlatformList",
"data": [
{
"code": "1688",
"name": "阿里巴巴",
"default_express_interface": "cainiao",
"value": "1688",
"label": "阿里巴巴",
"platform_code": "1688",
"platform_name": "阿里巴巴",
"is_system_setting": false
},
{
"code": "DW",
"name": "得物",
"default_express_interface": "polyapi",
"value": "DW",
"label": "得物",
"platform_code": "DW",
"platform_name": "得物",
"is_system_setting": false
},
{
"code": "DYCS",
"name": "抖音超市",
"default_express_interface": "polyapi",
"value": "DYCS",
"label": "抖音超市",
"platform_code": "DYCS",
"platform_name": "抖音超市",
"is_system_setting": false
},
{
"code": "DYGX",
"name": "抖音供销",
"default_express_interface": "polyapi",
"value": "DYGX",
"label": "抖音供销",
"platform_code": "DYGX",
"platform_name": "抖音供销",
"is_system_setting": false
},
{
"code": "DYXD",
"name": "抖音小店",
"default_express_interface": "polyapi",
"value": "DYXD",
"label": "抖音小店",
"platform_code": "DYXD",
"platform_name": "抖音小店",
"is_system_setting": false
},
{
"code": "JD",
"name": "京东",
"default_express_interface": "polyapi",
"value": "JD",
"label": "京东",
"platform_code": "JD",
"platform_name": "京东",
"is_system_setting": false
},
{
"code": "KS",
"name": "快手",
"default_express_interface": "polyapi",
"value": "KS",
"label": "快手",
"platform_code": "KS",
"platform_name": "快手",
"is_system_setting": false
},
{
"code": "MAOCHAO",
"name": "天猫超市",
"default_express_interface": "cainiao",
"value": "MAOCHAO",
"label": "天猫超市",
"platform_code": "MAOCHAO",
"platform_name": "天猫超市",
"is_system_setting": false
},
{
"code": "OFFLINE",
"name": "线下",
"default_express_interface": "cainiao",
"value": "OFFLINE",
"label": "线下",
"platform_code": "OFFLINE",
"platform_name": "线下",
"is_system_setting": false
},
{
"code": "OTHER",
"name": "其他",
"default_express_interface": "cainiao",
"value": "OTHER",
"label": "其他",
"platform_code": "OTHER",
"platform_name": "其他",
"is_system_setting": false
},
{
"code": "PDD",
"name": "拼多多",
"default_express_interface": "pdd",
"value": "PDD",
"label": "拼多多",
"platform_code": "PDD",
"platform_name": "拼多多",
"is_system_setting": false
},
{
"code": "SPH",
"name": "视频号",
"default_express_interface": "polyapi",
"value": "SPH",
"label": "视频号",
"platform_code": "SPH",
"platform_name": "视频号",
"is_system_setting": false
},
{
"code": "TB",
"name": "淘宝",
"default_express_interface": "cainiao",
"value": "TB",
"label": "淘宝",
"platform_code": "TB",
"platform_name": "淘宝",
"is_system_setting": false
},
{
"code": "TGC",
"name": "淘工厂",
"default_express_interface": "cainiao",
"value": "TGC",
"label": "淘工厂",
"platform_code": "TGC",
"platform_name": "淘工厂",
"is_system_setting": false
},
{
"code": "TM",
"name": "天猫",
"default_express_interface": "cainiao",
"value": "TM",
"label": "天猫",
"platform_code": "TM",
"platform_name": "天猫",
"is_system_setting": false
},
{
"code": "XHS",
"name": "小红书",
"default_express_interface": "polyapi",
"value": "XHS",
"label": "小红书",
"platform_code": "XHS",
"platform_name": "小红书",
"is_system_setting": false
},
{
"code": "CC1",
"name": "CC1 (天猫超市)",
"value": "CC1",
"label": "CC1 (天猫超市)",
"is_system_setting": true,
"id": 4,
"alias": "",
"platform_code": "MAOCHAO",
"platform_name": "天猫超市",
"default_express_interface": "cainiao"
},
{
"code": "DY",
"name": "DY (抖音小店)",
"value": "DY",
"label": "DY (抖音小店)",
"is_system_setting": true,
"id": 2,
"alias": "",
"platform_code": "DYXD",
"platform_name": "抖音小店",
"default_express_interface": "polyapi"
}
]
},
{
"接口": "warehouse.batchUpdateSpaceInfo",
"data": null
},
{
"接口": "warehouse.exportRackSpaces",
"data": null
"接口": "index.getExpressList",
"data": [
{
"code": "ANKY",
"name": "安能",
"KS": "ANE",
"polyapi_extra_info": null,
"PDD": "ANKY",
"DYXD": null
},
{
"code": "DBWL",
"name": "德邦物流",
"KS": "debangwuliu",
"polyapi_extra_info": null,
"PDD": "DB",
"DYXD": "debangkuaiyun"
},
{
"code": "EMS",
"name": "EMS",
"KS": "EMS",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "EMS",
"DYXD": "ems"
},
{
"code": "FENGWANG",
"name": "丰网速运",
"KS": "FENGWANG",
"polyapi_extra_info": null,
"PDD": "FENGWANG",
"DYXD": "fengwang"
},
{
"code": "HTKD",
"name": "百世极兔",
"KS": "huitongkuaidi",
"polyapi_extra_info": null,
"PDD": "HT",
"DYXD": "huitongkuaidi"
},
{
"code": "HTKY",
"name": "极兔速度",
"KS": "JT",
"polyapi_extra_info": null,
"PDD": "JTSD",
"DYXD": "jtexpress"
},
{
"code": "JD",
"name": "京东配送",
"KS": "JD",
"polyapi_extra_info": {
"temperatureRange": "2"
},
"PDD": "JD",
"DYXD": "jd"
},
{
"code": "KYE",
"name": "跨越物流",
"KS": "KYE",
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "OTHER",
"name": "其他",
"KS": null,
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "POSTB",
"name": "邮政小包",
"KS": "POSTB",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "YZXB",
"DYXD": "youzhengguonei"
},
{
"code": "POST_DSBK",
"name": "邮政电商标快",
"KS": "POST_DSBK",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "YZDSBK",
"DYXD": "yzdsbk"
},
{
"code": "SF",
"name": "顺丰快递",
"KS": "SF",
"polyapi_extra_info": {
"isvClientCode": "WYSJF_WDGJ"
},
"PDD": "SF",
"DYXD": "shunfeng"
},
{
"code": "SFKY",
"name": "顺丰快运",
"KS": "SFKY",
"polyapi_extra_info": null,
"PDD": "SFKY",
"DYXD": null
},
{
"code": "STO",
"name": "申通快递",
"KS": "STO",
"polyapi_extra_info": null,
"PDD": "STO",
"DYXD": "shentong"
},
{
"code": "SZKKE",
"name": "京广快运",
"KS": "SZKKE",
"polyapi_extra_info": null,
"PDD": "SZKKE",
"DYXD": null
},
{
"code": "TTKDEX",
"name": "天天快递",
"KS": "TTKDEX",
"polyapi_extra_info": null,
"PDD": "TTKDEX",
"DYXD": "TTKDEX"
},
{
"code": "YTO",
"name": "圆通快递",
"KS": "YTO",
"polyapi_extra_info": null,
"PDD": "YTO",
"DYXD": "yuantong"
},
{
"code": "YUNDA",
"name": "韵达快递",
"KS": "YUNDA",
"polyapi_extra_info": null,
"PDD": "YUNDA",
"DYXD": "yunda"
},
{
"code": "ZTKY",
"name": "中通快运",
"KS": "ZTKY",
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "ZTO",
"name": "中通快递",
"KS": "ZTO",
"polyapi_extra_info": null,
"PDD": "ZTO",
"DYXD": "zhongtong"
},
{
"code": "EMS.TEST",
"name": "EMS.TEST (EMS)",
"value": "EMS.TEST",
"label": "EMS.TEST (EMS)",
"is_system_setting": true,
"id": 3,
"alias": "EMS测试业务1",
"express_code": "EMS"
},
{
"code": "SF.KY",
"name": "SF.KY (顺丰快递)",
"value": "SF.KY",
"label": "SF.KY (顺丰快递)",
"is_system_setting": true,
"id": 2,
"alias": "顺丰空运产品",
"express_code": "SF"
}
]
}
]
```

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-04-28 17:51:49
- 更新时间: 2026-04-30 16:21:16
- 扫描目录: `src\api`
- 模块数: 30
- API 文件数: 30
- 接口数: 239
- 已启用: 211
- 接口数: 242
- 已启用: 213
- 占位接口: 2
## 模块统计
@ -34,14 +34,14 @@
| setting.printtemplate | 1 | 13 | 13 | 0 |
| setting.role | 1 | 5 | 5 | 0 |
| stock | 1 | 26 | 25 | 0 |
| storage_receiving | 1 | 18 | 8 | 0 |
| storage_receiving | 1 | 21 | 11 | 0 |
| storage.entry | 1 | 4 | 4 | 0 |
| storage.inventory | 1 | 8 | 7 | 0 |
| storage.stockout | 1 | 3 | 3 | 0 |
| store | 1 | 6 | 6 | 0 |
| storewarehouse.store | 1 | 11 | 11 | 0 |
| user | 1 | 9 | 9 | 0 |
| warehouse | 1 | 23 | 22 | 0 |
| warehouse | 1 | 23 | 21 | 0 |
## 接口明细
@ -220,7 +220,10 @@
| storage_receiving | getReceivingDetail | storage.receiving.getReceivingDetail | POST | 是 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | getReceivingList | storage.receiving.getReceivingList | POST | 是 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | getReceivingProduct | storage.receiving.getReceivingProduct | POST | 否 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | rejectReceiving | storage.receiving.rejectReceiving | POST | 是 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | removeItem | storage.receiving.removeItem | POST | 否 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | reviewReceiving | storage.receiving.reviewReceiving | POST | 是 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | save | storage.receiving.save | POST | 是 | 否 | storage_receiving/receiving.ts | |
| storage_receiving | saveReceiving | storage.receiving.saveReceiving | POST | 否 | 否 | storage_receiving/receiving.ts | |
| storage.entry | cancelEntry | storage.entry.cancel | POST | 是 | 否 | storage.entry/entry.ts | |
| storage.entry | completeEntry | storage.entry.completeEntry | POST | 是 | 否 | storage.entry/entry.ts | |
@ -267,7 +270,7 @@
| warehouse | checkBarcodeUnique | warehouse.checkBarcodeUnique | POST | 是 | 否 | warehouse/warehouse.ts | |
| warehouse | checkConnectivity | warehouse.checkConnectivity | POST | 否 | 否 | warehouse/warehouse.ts | |
| warehouse | create | warehouse.create | POST | 是 | 否 | warehouse/warehouse.ts | |
| warehouse | createRack | warehouse.createRack | POST | 是 | 否 | warehouse/warehouse.ts | |
| warehouse | createRack | warehouse.createRack | POST | 否 | 否 | warehouse/warehouse.ts | |
| warehouse | createRackWithSpaces | warehouse.createRackWithSpaces | POST | 是 | 否 | warehouse/warehouse.ts | |
| warehouse | deleteZone | warehouse.delete | POST | 是 | 否 | warehouse/warehouse.ts | |
| warehouse | detail | warehouse.detail | POST | 是 | 否 | warehouse/warehouse.ts | |

View File

@ -8,72 +8,21 @@
}
},
{
"method": "index.getLocationTypeList",
"body": {
}
},
{
"method": "warehouse.batchUpdateSpaceInfo",
"body": {
}
},
{
"method": "warehouse.exportRackSpaces",
"method": "index.getPlatformList",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"body": {}
},
{
"method": "",
"method": "index.getExpressList",
"body": {}
}
],
"successMessages": [
"ok",
"成功",
"登录成功",
"success"
"success",
"查询成功",
"获取成功"
]
}

View File

@ -1,43 +1,18 @@
{
"数据一览": {
"当前请求数": 4,
"成功数": 2,
"全部请求数": 4,
"成功数与全部请求数": "2/4",
"当前请求数": 3,
"成功数": 3,
"全部请求数": 3,
"成功数与全部请求数": "3/3",
"成功判定名单": [
"ok",
"成功",
"登录成功",
"success"
],
"失败接口": [
{
"接口": "warehouse.batchUpdateSpaceInfo",
"message": "批量数据不能为空",
"code": 0,
"模块目录": "warehouse",
"api封装": [
{
"文件": "src/api/warehouse/warehouse.ts",
"方法名": "batchUpdateSpaceInfo"
}
],
"引用页面": []
},
{
"接口": "warehouse.exportRackSpaces",
"message": "导出成功",
"code": 200,
"模块目录": "warehouse",
"api封装": [
{
"文件": "src/api/warehouse/warehouse.ts",
"方法名": "exportRackSpaces"
}
],
"引用页面": []
}
"success",
"查询成功",
"获取成功"
],
"失败接口": [],
"空数据接口": []
},
"详情": [
@ -46,26 +21,396 @@
"message": "登录成功",
"code": 200,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3NzczNjg3MTgsImV4cCI6MTc3NzM4MzExOH0.fGpEVBs6wjnNl3bUu-W9GRvENk4HPqmtU7ALMtdffvY"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc1NDIyOTAsImV4cCI6MTc3NzU1NjY5MH0.WDBNzCpCdi3m7yH0W_yAJM3wAv2RMC2ykppCNKZtu7w"
}
},
{
"接口": "index.getLocationTypeList",
"接口": "index.getPlatformList",
"message": "ok",
"code": 200,
"data": null
"data": [
{
"code": "1688",
"name": "阿里巴巴",
"default_express_interface": "cainiao",
"value": "1688",
"label": "阿里巴巴",
"platform_code": "1688",
"platform_name": "阿里巴巴",
"is_system_setting": false
},
{
"code": "DW",
"name": "得物",
"default_express_interface": "polyapi",
"value": "DW",
"label": "得物",
"platform_code": "DW",
"platform_name": "得物",
"is_system_setting": false
},
{
"code": "DYCS",
"name": "抖音超市",
"default_express_interface": "polyapi",
"value": "DYCS",
"label": "抖音超市",
"platform_code": "DYCS",
"platform_name": "抖音超市",
"is_system_setting": false
},
{
"code": "DYGX",
"name": "抖音供销",
"default_express_interface": "polyapi",
"value": "DYGX",
"label": "抖音供销",
"platform_code": "DYGX",
"platform_name": "抖音供销",
"is_system_setting": false
},
{
"code": "DYXD",
"name": "抖音小店",
"default_express_interface": "polyapi",
"value": "DYXD",
"label": "抖音小店",
"platform_code": "DYXD",
"platform_name": "抖音小店",
"is_system_setting": false
},
{
"code": "JD",
"name": "京东",
"default_express_interface": "polyapi",
"value": "JD",
"label": "京东",
"platform_code": "JD",
"platform_name": "京东",
"is_system_setting": false
},
{
"code": "KS",
"name": "快手",
"default_express_interface": "polyapi",
"value": "KS",
"label": "快手",
"platform_code": "KS",
"platform_name": "快手",
"is_system_setting": false
},
{
"code": "MAOCHAO",
"name": "天猫超市",
"default_express_interface": "cainiao",
"value": "MAOCHAO",
"label": "天猫超市",
"platform_code": "MAOCHAO",
"platform_name": "天猫超市",
"is_system_setting": false
},
{
"code": "OFFLINE",
"name": "线下",
"default_express_interface": "cainiao",
"value": "OFFLINE",
"label": "线下",
"platform_code": "OFFLINE",
"platform_name": "线下",
"is_system_setting": false
},
{
"code": "OTHER",
"name": "其他",
"default_express_interface": "cainiao",
"value": "OTHER",
"label": "其他",
"platform_code": "OTHER",
"platform_name": "其他",
"is_system_setting": false
},
{
"code": "PDD",
"name": "拼多多",
"default_express_interface": "pdd",
"value": "PDD",
"label": "拼多多",
"platform_code": "PDD",
"platform_name": "拼多多",
"is_system_setting": false
},
{
"code": "SPH",
"name": "视频号",
"default_express_interface": "polyapi",
"value": "SPH",
"label": "视频号",
"platform_code": "SPH",
"platform_name": "视频号",
"is_system_setting": false
},
{
"code": "TB",
"name": "淘宝",
"default_express_interface": "cainiao",
"value": "TB",
"label": "淘宝",
"platform_code": "TB",
"platform_name": "淘宝",
"is_system_setting": false
},
{
"code": "TGC",
"name": "淘工厂",
"default_express_interface": "cainiao",
"value": "TGC",
"label": "淘工厂",
"platform_code": "TGC",
"platform_name": "淘工厂",
"is_system_setting": false
},
{
"code": "TM",
"name": "天猫",
"default_express_interface": "cainiao",
"value": "TM",
"label": "天猫",
"platform_code": "TM",
"platform_name": "天猫",
"is_system_setting": false
},
{
"code": "XHS",
"name": "小红书",
"default_express_interface": "polyapi",
"value": "XHS",
"label": "小红书",
"platform_code": "XHS",
"platform_name": "小红书",
"is_system_setting": false
},
{
"code": "CC1",
"name": "CC1 (天猫超市)",
"value": "CC1",
"label": "CC1 (天猫超市)",
"is_system_setting": true,
"id": 4,
"alias": "",
"platform_code": "MAOCHAO",
"platform_name": "天猫超市",
"default_express_interface": "cainiao"
},
{
"code": "DY",
"name": "DY (抖音小店)",
"value": "DY",
"label": "DY (抖音小店)",
"is_system_setting": true,
"id": 2,
"alias": "",
"platform_code": "DYXD",
"platform_name": "抖音小店",
"default_express_interface": "polyapi"
}
]
},
{
"接口": "warehouse.batchUpdateSpaceInfo",
"message": "批量数据不能为空",
"code": 0,
"data": null
},
{
"接口": "warehouse.exportRackSpaces",
"message": "导出成功",
"接口": "index.getExpressList",
"message": "ok",
"code": 200,
"data": null
"data": [
{
"code": "ANKY",
"name": "安能",
"KS": "ANE",
"polyapi_extra_info": null,
"PDD": "ANKY",
"DYXD": null
},
{
"code": "DBWL",
"name": "德邦物流",
"KS": "debangwuliu",
"polyapi_extra_info": null,
"PDD": "DB",
"DYXD": "debangkuaiyun"
},
{
"code": "EMS",
"name": "EMS",
"KS": "EMS",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "EMS",
"DYXD": "ems"
},
{
"code": "FENGWANG",
"name": "丰网速运",
"KS": "FENGWANG",
"polyapi_extra_info": null,
"PDD": "FENGWANG",
"DYXD": "fengwang"
},
{
"code": "HTKD",
"name": "百世极兔",
"KS": "huitongkuaidi",
"polyapi_extra_info": null,
"PDD": "HT",
"DYXD": "huitongkuaidi"
},
{
"code": "HTKY",
"name": "极兔速度",
"KS": "JT",
"polyapi_extra_info": null,
"PDD": "JTSD",
"DYXD": "jtexpress"
},
{
"code": "JD",
"name": "京东配送",
"KS": "JD",
"polyapi_extra_info": {
"temperatureRange": "2"
},
"PDD": "JD",
"DYXD": "jd"
},
{
"code": "KYE",
"name": "跨越物流",
"KS": "KYE",
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "OTHER",
"name": "其他",
"KS": null,
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "POSTB",
"name": "邮政小包",
"KS": "POSTB",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "YZXB",
"DYXD": "youzhengguonei"
},
{
"code": "POST_DSBK",
"name": "邮政电商标快",
"KS": "POST_DSBK",
"polyapi_extra_info": {
"oneBillFeeType": "1"
},
"PDD": "YZDSBK",
"DYXD": "yzdsbk"
},
{
"code": "SF",
"name": "顺丰快递",
"KS": "SF",
"polyapi_extra_info": {
"isvClientCode": "WYSJF_WDGJ"
},
"PDD": "SF",
"DYXD": "shunfeng"
},
{
"code": "SFKY",
"name": "顺丰快运",
"KS": "SFKY",
"polyapi_extra_info": null,
"PDD": "SFKY",
"DYXD": null
},
{
"code": "STO",
"name": "申通快递",
"KS": "STO",
"polyapi_extra_info": null,
"PDD": "STO",
"DYXD": "shentong"
},
{
"code": "SZKKE",
"name": "京广快运",
"KS": "SZKKE",
"polyapi_extra_info": null,
"PDD": "SZKKE",
"DYXD": null
},
{
"code": "TTKDEX",
"name": "天天快递",
"KS": "TTKDEX",
"polyapi_extra_info": null,
"PDD": "TTKDEX",
"DYXD": "TTKDEX"
},
{
"code": "YTO",
"name": "圆通快递",
"KS": "YTO",
"polyapi_extra_info": null,
"PDD": "YTO",
"DYXD": "yuantong"
},
{
"code": "YUNDA",
"name": "韵达快递",
"KS": "YUNDA",
"polyapi_extra_info": null,
"PDD": "YUNDA",
"DYXD": "yunda"
},
{
"code": "ZTKY",
"name": "中通快运",
"KS": "ZTKY",
"polyapi_extra_info": null,
"PDD": null,
"DYXD": null
},
{
"code": "ZTO",
"name": "中通快递",
"KS": "ZTO",
"polyapi_extra_info": null,
"PDD": "ZTO",
"DYXD": "zhongtong"
},
{
"code": "EMS.TEST",
"name": "EMS.TEST (EMS)",
"value": "EMS.TEST",
"label": "EMS.TEST (EMS)",
"is_system_setting": true,
"id": 3,
"alias": "EMS测试业务1",
"express_code": "EMS"
},
{
"code": "SF.KY",
"name": "SF.KY (顺丰快递)",
"value": "SF.KY",
"label": "SF.KY (顺丰快递)",
"is_system_setting": true,
"id": 2,
"alias": "顺丰空运产品",
"express_code": "SF"
}
]
}
]
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {
@ -12,49 +12,26 @@
"label": "全部"
}
},
"totalInterfaceCount": 208,
"totalInterfaceCount": 209,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleDeleted": 0,
"moduleUpdated": 1,
"moduleUpdated": 0,
"interfaceAdded": 0,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 1,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": [
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"folder": "warehouse",
"previousModuleName": "仓库模块",
"previousModuleKey": "warehouse",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"warehouse.exportRackSpaces"
],
"responseUpdatedMethods": []
}
}
]
"updated": []
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"folder": "warehouse",
"method": "warehouse.exportRackSpaces"
}
],
"paramsUpdated": [],
"responseUpdated": []
}
},
@ -6478,8 +6455,8 @@
"moduleKey": "storage.inventory",
"moduleFolder": "storage.inventory",
"method": "storage.inventory.matchPutaway",
"title": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,完成后根据入库单来源(QM/API)自动触发回传",
"description": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,完成后根据入库单来源(QM/API)自动触发回传",
"title": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,要求收货单已完成且已审核,完成后根据入库单来源(QM/API)自动触发回传",
"description": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,要求收货单已完成且已审核,完成后根据入库单来源(QM/API)自动触发回传",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -6509,8 +6486,8 @@
"moduleKey": "storage.inventory",
"moduleFolder": "storage.inventory",
"method": "storage.inventory.quickPutaway",
"title": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成且所有明细已匹配系统商品",
"description": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成且所有明细已匹配系统商品",
"title": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成、已审核且所有明细已匹配系统商品",
"description": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成、已审核且所有明细已匹配系统商品",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -7303,6 +7280,51 @@
}
]
},
{
"moduleName": "收货单模块",
"moduleKey": "storage_receiving",
"moduleFolder": "storage_receiving",
"method": "storage.receiving.rejectReceiving",
"title": "驳回收货单:将已完成(completed)的收货单批量恢复为收货中(receiving),记录驳回人信息和驳回理由。若任意一张收货单状态非 completed,则整批拒绝操作。驳回人信息(reviewer_name、reviewer_employee_id)自动取当前登录用户上下文,无需传入.",
"description": "驳回收货单:将已完成(completed)的收货单批量恢复为收货中(receiving),记录驳回人信息和驳回理由。若任意一张收货单状态非 completed,则整批拒绝操作。驳回人信息(reviewer_name、reviewer_employee_id)自动取当前登录用户上下文,无需传入.",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "收货单ID数组,所有收货单必须属于当前仓库且状态为 completed,否则整批拒绝"
},
{
"name": "remark",
"type": "string",
"required": false,
"description": "驳回理由,覆盖收货单原备注字段;不传则保留原备注"
}
],
"response": [
{
"name": "count",
"type": "number",
"required": false,
"description": "成功驳回的收货单数量"
}
]
},
{
"moduleName": "收货单模块",
"moduleKey": "storage_receiving",
@ -7345,9 +7367,9 @@
"moduleName": "收货单模块",
"moduleKey": "storage_receiving",
"moduleFolder": "storage_receiving",
"method": "storage.receiving.saveReceiving",
"title": "storage.receiving.saveReceiving 接口",
"description": "storage.receiving.saveReceiving 接口",
"method": "storage.receiving.reviewReceiving",
"title": "批量审核收货单:校验所有单据满足条件(收货完成、全部匹配、未入库、已绑定货主、未审核)后统一审核,任意一张不符合则整批失败回滚。审核人信息自动取当前登录用户上下文,无需传入.",
"description": "批量审核收货单:校验所有单据满足条件(收货完成、全部匹配、未入库、已绑定货主、未审核)后统一审核,任意一张不符合则整批失败回滚。审核人信息自动取当前登录用户上下文,无需传入.",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -7363,8 +7385,139 @@
"description": "Bearer token"
}
],
"params": [],
"response": []
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "收货单ID数组,所有单据必须满足:status=completed、detail_status=all_matched、storage_status=none、store_id 已绑定、is_review=0,否则整批拒绝"
}
],
"response": [
{
"name": "count",
"type": "number",
"required": false,
"description": "成功审核的收货单数量"
}
]
},
{
"moduleName": "收货单模块",
"moduleKey": "storage_receiving",
"moduleFolder": "storage_receiving",
"method": "storage.receiving.save",
"title": "修改收货单基础信息。按收货单ID更新当前仓库下收货单的基础字段。",
"description": "修改收货单基础信息。按收货单ID更新当前仓库下收货单的基础字段。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "id",
"type": "number",
"required": true,
"description": "收货单ID,按该ID修改当前仓库下的收货单"
},
{
"name": "delivery_method",
"type": "string",
"required": false,
"description": "到货方式:truck/express/air_freight/sea_freight/other;不传则保持原值"
},
{
"name": "loading_method",
"type": "string",
"required": false,
"description": "装卸方式:with_pallet/without_pallet;不传则保持原值"
},
{
"name": "license_plate",
"type": "string",
"required": false,
"description": "车牌号;当 delivery_method=truck 时可更新,其他到货方式会被清空或忽略"
},
{
"name": "tracking_number",
"type": "string",
"required": false,
"description": "物流单号;当 delivery_method 为 express/air_freight/sea_freight 时可更新,truck/other 场景会被清空或忽略"
},
{
"name": "store_id",
"type": "number",
"required": false,
"description": "货主ID;若传入,会校验当前仓库下签约关系并同步更新货主名称;传 0/null 可清空货主"
},
{
"name": "total_boxes",
"type": "number",
"required": false,
"description": "总箱数,默认 0"
},
{
"name": "total_pallets",
"type": "number",
"required": false,
"description": "总托盘数,默认 0"
},
{
"name": "remark",
"type": "string",
"required": false,
"description": "备注信息"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "收货单状态;不传则保持原值"
},
{
"name": "video_device_id",
"type": "string",
"required": false,
"description": "录像设备ID"
}
],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码;200 表示修改成功"
},
{
"name": "id",
"type": "number",
"required": true,
"description": "修改的收货单ID"
},
{
"name": "receiving_number",
"type": "string",
"required": true,
"description": "收货单号"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "结果描述;成功时通常为收货单修改成功"
}
]
},
{
"moduleName": "出库单模块",
@ -8749,8 +8902,8 @@
"moduleKey": "warehouse",
"moduleFolder": "warehouse",
"method": "warehouse.batchUpdateSpaceInfo",
"title": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ items: [ { warehouse_code: 'WH001', space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_name: '标准库位' } ] }。其中 space_code 为必填定位键,warehouse_code 建议原样回传用于边界校验。",
"description": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ items: [ { warehouse_code: 'WH001', space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_name: '标准库位' } ] }。其中 space_code 为必填定位键,warehouse_code 建议原样回传用于边界校验。",
"title": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ id: 36, items: [ { space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_id: 3 } ] }。其中 id 为货架ID(可选,传入时只允许操作该货架下的仓位),space_code 为必填定位键,location_type_id 为仓位类型主键(可通过 index.getLocationTypeList 获取)。",
"description": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ id: 36, items: [ { space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_id: 3 } ] }。其中 id 为货架ID(可选,传入时只允许操作该货架下的仓位),space_code 为必填定位键,location_type_id 为仓位类型主键(可通过 index.getLocationTypeList 获取)。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -8767,17 +8920,17 @@
}
],
"params": [
{
"name": "id",
"type": "number",
"required": false,
"description": "货架ID,传入时校验所有 space_code 必须属于该货架,不传则只校验属于任意货架类型库位"
},
{
"name": "items",
"type": "array",
"required": true,
"description": "批量修改数据数组;每项支持字段:warehouse_code、space_code、custom_name、custom_barcode、pick_sequence、location_type_name"
},
{
"name": "items[].warehouse_code",
"type": "string",
"required": false,
"description": "仓库编码,若传入则必须与当前登录仓库一致,否则整批失败"
"description": "批量修改数据数组;每项支持字段:space_code、custom_name、custom_barcode、pick_sequence、location_type_name"
},
{
"name": "items[].space_code",
@ -8804,10 +8957,10 @@
"description": "拣货顺序,必须为非负整数,超出边界则整批失败"
},
{
"name": "items[].location_type_name",
"type": "string",
"name": "items[].location_type_id",
"type": "number",
"required": false,
"description": "仓位类型名称,必须能在 index.getLocationTypeList 返回结果中命中,否则整批失败"
"description": "仓位类型ID,必须为正整数且在当前仓库或全局类型中存在(is_active=true),否则整批失败;传 null 或不传则不修改仓位类型"
}
],
"response": [
@ -8882,122 +9035,6 @@
"params": [],
"response": []
},
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"moduleFolder": "warehouse",
"method": "warehouse.createRack",
"title": "warehouse.createRack 接口",
"description": "warehouse.createRack 接口",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "height",
"type": "number",
"required": true,
"description": "height 参数"
},
{
"name": "length",
"type": "number",
"required": true,
"description": "length 参数"
},
{
"name": "rack_columns",
"type": "number",
"required": true,
"description": "rack_columns 参数"
},
{
"name": "rack_levels",
"type": "number",
"required": true,
"description": "rack_levels 参数"
},
{
"name": "rack_rows",
"type": "number",
"required": true,
"description": "rack_rows 参数"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "warehouse_id 参数"
},
{
"name": "width",
"type": "number",
"required": true,
"description": "width 参数"
},
{
"name": "x",
"type": "number",
"required": true,
"description": "x 参数"
},
{
"name": "y",
"type": "number",
"required": true,
"description": "y 参数"
},
{
"name": "zone_code",
"type": "string",
"required": true,
"description": "zone_code 参数"
},
{
"name": "zone_name",
"type": "string",
"required": true,
"description": "zone_name 参数"
},
{
"name": "color",
"type": "string",
"required": false,
"description": "color 参数"
},
{
"name": "direction",
"type": "string",
"required": false,
"description": "direction 参数"
},
{
"name": "parent_id",
"type": "number",
"required": false,
"description": "parent_id 参数"
},
{
"name": "z",
"type": "number",
"required": false,
"description": "z 参数"
}
],
"response": []
},
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {
@ -13,49 +13,26 @@
}
},
"moduleCount": 30,
"totalInterfaceCount": 208,
"totalInterfaceCount": 209,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleDeleted": 0,
"moduleUpdated": 1,
"moduleUpdated": 0,
"interfaceAdded": 0,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 1,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": [
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"folder": "warehouse",
"previousModuleName": "仓库模块",
"previousModuleKey": "warehouse",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"warehouse.exportRackSpaces"
],
"responseUpdatedMethods": []
}
}
]
"updated": []
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [
{
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"folder": "warehouse",
"method": "warehouse.exportRackSpaces"
}
],
"paramsUpdated": [],
"responseUpdated": []
}
},
@ -64,7 +41,7 @@
"moduleName": "仓库模块",
"moduleKey": "warehouse",
"folder": "warehouse",
"interfaceCount": 22,
"interfaceCount": 21,
"interfaces": [
{
"method": "warehouse.getWarehouseZones"
@ -96,9 +73,6 @@
{
"method": "warehouse.getPath"
},
{
"method": "warehouse.createRack"
},
{
"method": "warehouse.getPickPath"
},
@ -788,7 +762,7 @@
"moduleName": "收货单模块",
"moduleKey": "storage_receiving",
"folder": "storage_receiving",
"interfaceCount": 15,
"interfaceCount": 17,
"interfaces": [
{
"method": "storage.receiving.getReceivingList"
@ -799,6 +773,12 @@
{
"method": "storage.receiving.batchCancelReceiving"
},
{
"method": "storage.receiving.rejectReceiving"
},
{
"method": "storage.receiving.reviewReceiving"
},
{
"method": "storage.receiving.create"
},
@ -815,7 +795,7 @@
"method": "storage.receiving.removeItem"
},
{
"method": "storage.receiving.saveReceiving"
"method": "storage.receiving.save"
},
{
"method": "storage.receiving.get"

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {
@ -33,8 +33,8 @@
"interfaces": [
{
"method": "storage.inventory.quickPutaway",
"title": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成且所有明细已匹配系统商品",
"description": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成且所有明细已匹配系统商品",
"title": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成、已审核且所有明细已匹配系统商品",
"description": "收货单快捷入库上架。从收货单直接生成入库单并写入库存表,要求收货单已完成、已审核且所有明细已匹配系统商品",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -55,8 +55,8 @@
},
{
"method": "storage.inventory.matchPutaway",
"title": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,完成后根据入库单来源(QM/API)自动触发回传",
"description": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,完成后根据入库单来源(QM/API)自动触发回传",
"title": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,要求收货单已完成且已审核,完成后根据入库单来源(QM/API)自动触发回传",
"description": "收货单与入库单匹配入库。接收多个收货单和入库单,按商品(stock_warehouse_id)进行数量匹配入库,要求收货单已完成且已审核,完成后根据入库单来源(QM/API)自动触发回传",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "收货单模块",
"key": "storage_receiving",
"folder": "storage_receiving",
"interfaceCount": 15
"interfaceCount": 17
},
"changes": {
"fromPreviousSnapshot": {
@ -163,6 +163,84 @@
}
]
},
{
"method": "storage.receiving.rejectReceiving",
"title": "驳回收货单:将已完成(completed)的收货单批量恢复为收货中(receiving),记录驳回人信息和驳回理由。若任意一张收货单状态非 completed,则整批拒绝操作。驳回人信息(reviewer_name、reviewer_employee_id)自动取当前登录用户上下文,无需传入.",
"description": "驳回收货单:将已完成(completed)的收货单批量恢复为收货中(receiving),记录驳回人信息和驳回理由。若任意一张收货单状态非 completed,则整批拒绝操作。驳回人信息(reviewer_name、reviewer_employee_id)自动取当前登录用户上下文,无需传入.",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "收货单ID数组,所有收货单必须属于当前仓库且状态为 completed,否则整批拒绝"
},
{
"name": "remark",
"type": "string",
"required": false,
"description": "驳回理由,覆盖收货单原备注字段;不传则保留原备注"
}
],
"response": [
{
"name": "count",
"type": "number",
"required": false,
"description": "成功驳回的收货单数量"
}
]
},
{
"method": "storage.receiving.reviewReceiving",
"title": "批量审核收货单:校验所有单据满足条件(收货完成、全部匹配、未入库、已绑定货主、未审核)后统一审核,任意一张不符合则整批失败回滚。审核人信息自动取当前登录用户上下文,无需传入.",
"description": "批量审核收货单:校验所有单据满足条件(收货完成、全部匹配、未入库、已绑定货主、未审核)后统一审核,任意一张不符合则整批失败回滚。审核人信息自动取当前登录用户上下文,无需传入.",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "收货单ID数组,所有单据必须满足:status=completed、detail_status=all_matched、storage_status=none、store_id 已绑定、is_review=0,否则整批拒绝"
}
],
"response": [
{
"name": "count",
"type": "number",
"required": false,
"description": "成功审核的收货单数量"
}
]
},
{
"method": "storage.receiving.create",
"title": "storage.receiving.create 接口",
@ -438,9 +516,9 @@
"response": []
},
{
"method": "storage.receiving.saveReceiving",
"title": "storage.receiving.saveReceiving 接口",
"description": "storage.receiving.saveReceiving 接口",
"method": "storage.receiving.save",
"title": "修改收货单基础信息。按收货单ID更新当前仓库下收货单的基础字段。",
"description": "修改收货单基础信息。按收货单ID更新当前仓库下收货单的基础字段。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -456,8 +534,100 @@
"description": "Bearer token"
}
],
"params": [],
"response": []
"params": [
{
"name": "id",
"type": "number",
"required": true,
"description": "收货单ID,按该ID修改当前仓库下的收货单"
},
{
"name": "delivery_method",
"type": "string",
"required": false,
"description": "到货方式:truck/express/air_freight/sea_freight/other;不传则保持原值"
},
{
"name": "loading_method",
"type": "string",
"required": false,
"description": "装卸方式:with_pallet/without_pallet;不传则保持原值"
},
{
"name": "license_plate",
"type": "string",
"required": false,
"description": "车牌号;当 delivery_method=truck 时可更新,其他到货方式会被清空或忽略"
},
{
"name": "tracking_number",
"type": "string",
"required": false,
"description": "物流单号;当 delivery_method 为 express/air_freight/sea_freight 时可更新,truck/other 场景会被清空或忽略"
},
{
"name": "store_id",
"type": "number",
"required": false,
"description": "货主ID;若传入,会校验当前仓库下签约关系并同步更新货主名称;传 0/null 可清空货主"
},
{
"name": "total_boxes",
"type": "number",
"required": false,
"description": "总箱数,默认 0"
},
{
"name": "total_pallets",
"type": "number",
"required": false,
"description": "总托盘数,默认 0"
},
{
"name": "remark",
"type": "string",
"required": false,
"description": "备注信息"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "收货单状态;不传则保持原值"
},
{
"name": "video_device_id",
"type": "string",
"required": false,
"description": "录像设备ID"
}
],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码;200 表示修改成功"
},
{
"name": "id",
"type": "number",
"required": true,
"description": "修改的收货单ID"
},
{
"name": "receiving_number",
"type": "string",
"required": true,
"description": "收货单号"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "结果描述;成功时通常为收货单修改成功"
}
]
},
{
"method": "storage.receiving.get",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-04-28 17:50:49",
"updatedAt": "2026-04-30 17:11:56",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-04-28 17:50:49",
"generatedAtLocal": "2026-04-28 17:50:49",
"generatedAt": "2026-04-30 17:11:56",
"generatedAtLocal": "2026-04-30 17:11:56",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "仓库模块",
"key": "warehouse",
"folder": "warehouse",
"interfaceCount": 22
"interfaceCount": 21
},
"changes": {
"fromPreviousSnapshot": {
@ -25,9 +25,7 @@
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"warehouse.exportRackSpaces"
],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
@ -423,119 +421,6 @@
],
"response": []
},
{
"method": "warehouse.createRack",
"title": "warehouse.createRack 接口",
"description": "warehouse.createRack 接口",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "height",
"type": "number",
"required": true,
"description": "height 参数"
},
{
"name": "length",
"type": "number",
"required": true,
"description": "length 参数"
},
{
"name": "rack_columns",
"type": "number",
"required": true,
"description": "rack_columns 参数"
},
{
"name": "rack_levels",
"type": "number",
"required": true,
"description": "rack_levels 参数"
},
{
"name": "rack_rows",
"type": "number",
"required": true,
"description": "rack_rows 参数"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "warehouse_id 参数"
},
{
"name": "width",
"type": "number",
"required": true,
"description": "width 参数"
},
{
"name": "x",
"type": "number",
"required": true,
"description": "x 参数"
},
{
"name": "y",
"type": "number",
"required": true,
"description": "y 参数"
},
{
"name": "zone_code",
"type": "string",
"required": true,
"description": "zone_code 参数"
},
{
"name": "zone_name",
"type": "string",
"required": true,
"description": "zone_name 参数"
},
{
"name": "color",
"type": "string",
"required": false,
"description": "color 参数"
},
{
"name": "direction",
"type": "string",
"required": false,
"description": "direction 参数"
},
{
"name": "parent_id",
"type": "number",
"required": false,
"description": "parent_id 参数"
},
{
"name": "z",
"type": "number",
"required": false,
"description": "z 参数"
}
],
"response": []
},
{
"method": "warehouse.getPickPath",
"title": "warehouse.getPickPath 接口",
@ -825,8 +710,8 @@
},
{
"method": "warehouse.batchUpdateSpaceInfo",
"title": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ items: [ { warehouse_code: 'WH001', space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_name: '标准库位' } ] }。其中 space_code 为必填定位键,warehouse_code 建议原样回传用于边界校验。",
"description": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ items: [ { warehouse_code: 'WH001', space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_name: '标准库位' } ] }。其中 space_code 为必填定位键,warehouse_code 建议原样回传用于边界校验。",
"title": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ id: 36, items: [ { space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_id: 3 } ] }。其中 id 为货架ID(可选,传入时只允许操作该货架下的仓位),space_code 为必填定位键,location_type_id 为仓位类型主键(可通过 index.getLocationTypeList 获取)。",
"description": "按导出模板批量修改货架仓位信息,任一行越界或冲突则整批失败。前端提交示例:{ id: 36, items: [ { space_code: 'A01-01-01', custom_name: '拣货位1', custom_barcode: 'PICK-001', pick_sequence: 10, location_type_id: 3 } ] }。其中 id 为货架ID(可选,传入时只允许操作该货架下的仓位),space_code 为必填定位键,location_type_id 为仓位类型主键(可通过 index.getLocationTypeList 获取)。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
@ -843,17 +728,17 @@
}
],
"params": [
{
"name": "id",
"type": "number",
"required": false,
"description": "货架ID,传入时校验所有 space_code 必须属于该货架,不传则只校验属于任意货架类型库位"
},
{
"name": "items",
"type": "array",
"required": true,
"description": "批量修改数据数组;每项支持字段:warehouse_code、space_code、custom_name、custom_barcode、pick_sequence、location_type_name"
},
{
"name": "items[].warehouse_code",
"type": "string",
"required": false,
"description": "仓库编码,若传入则必须与当前登录仓库一致,否则整批失败"
"description": "批量修改数据数组;每项支持字段:space_code、custom_name、custom_barcode、pick_sequence、location_type_name"
},
{
"name": "items[].space_code",
@ -880,10 +765,10 @@
"description": "拣货顺序,必须为非负整数,超出边界则整批失败"
},
{
"name": "items[].location_type_name",
"type": "string",
"name": "items[].location_type_id",
"type": "number",
"required": false,
"description": "仓位类型名称,必须能在 index.getLocationTypeList 返回结果中命中,否则整批失败"
"description": "仓位类型ID,必须为正整数且在当前仓库或全局类型中存在(is_active=true),否则整批失败;传 null 或不传则不修改仓位类型"
}
],
"response": [