This commit is contained in:
yin 2026-05-25 18:14:47 +08:00
parent 5547fc74b1
commit 33756ce1fd
105 changed files with 3227 additions and 4434 deletions

View File

@ -138,7 +138,12 @@ export function putI18nCollect(data:any){
} as any)
}
export function getExpressList(data?: Record<string, unknown>) {
export type GetExpressListParams = {
systemOnly?: boolean | number | string
express_code?: string
}
export function getExpressList(data?: GetExpressListParams) {
return request({
url: '/system',
method: 'post',
@ -180,20 +185,6 @@ export function getPlatformList(data?: Record<string, unknown>) {
} as any)
}
export function getPrintPlatformList(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getPrintPlatformList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function getPrintPlatformTemplateList(data?: { platform_code?: string; express_code: string }) {
return request({
url: '/system',
@ -208,6 +199,36 @@ export function getPrintPlatformTemplateList(data?: { platform_code?: string; ex
} as any)
}
/** 公共无参查询淘宝菜鸟标准模板列表 */
export function getCainiaoStfTemplates(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getCainiaoStfTemplates',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 生成菠萝派授权链接(无请求参数) */
export function polyapiAuthorizeUrl(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.polyapiAuthorizeUrl',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 获取平台授权链接(当前仅支持 PDD) */
export function getPlatformOauthLink(data?: {
code?: string

View File

@ -70,7 +70,6 @@ export type PendingOrderCreateOrderItem = {
export type PendingOrderCreateOrderParams = {
store_id: number;
shop_name?: string;
name: string;
mobile?: string;
tel?: string;

View File

@ -2,8 +2,13 @@ import request from '@/utils/request'
const v = '1.0'
/** 文档列在快递模块下的 index.getExpressList 封装(与 index 模块同源) */
export function expressIndexGetExpressList(data?: Record<string, unknown>) {
export type ExpressIndexGetExpressListParams = {
systemOnly?: boolean | number | string
express_code?: string
}
/** 文档列在快递模块下的 index.getExpressList 封装 */
export function expressIndexGetExpressList(data?: ExpressIndexGetExpressListParams) {
return request({
url: '/system',
method: 'post',

View File

@ -110,3 +110,17 @@ export function expressInterfaceDelete(data: { id: number }) {
data
})
}
/** 获取打印平台全量列表(文档归属 setting.expressinterface) */
export function getPrintPlatformList(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getPrintPlatformList',
v,
timestamp: new Date().getTime()
},
data: data ?? {}
})
}

88
src/api/shops/shops.ts Normal file
View File

@ -0,0 +1,88 @@
import request from '@/utils/request'
const v = '1.0'
/** 分页查询店铺 */
export function shopsList(data?: {
page?: number
pageSize?: number
where?: Record<string, unknown>
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'shops.list',
v,
timestamp: new Date().getTime()
},
data: data || {}
})
}
/** 新增店铺 */
export function shopsAdd(data: {
platform_code: string
custom_name: string
shop_name?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'shops.add',
v,
timestamp: new Date().getTime()
},
data
})
}
/** 软删除店铺 */
export function shopsDel(data: { id: number }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'shops.del',
v,
timestamp: new Date().getTime()
},
data
})
}
/** 编辑店铺 */
export function shopsEdit(data: {
id: number
platform_code?: string
custom_name?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'shops.edit',
v,
timestamp: new Date().getTime()
},
data
})
}
/** 按店铺所属平台生成授权会话 */
export function shopGetAuthorizeSessionKey(data: {
id: number
callbackurl: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'shop.GetAuthorizeSessionKey',
v,
timestamp: new Date().getTime()
},
data
})
}

View File

@ -60,6 +60,7 @@ export default {
'Validity period':'Validity period',
// 'StoreIndex':'Store',
'expressinterface':'Express Interface',
'shops':'Shops',
},
"login": {
"title": "Login",

View File

@ -61,6 +61,7 @@ export default {
'Validity period':'效期预警',
// 'StoreIndex':'货主',
'expressinterface':'快递接口',
'shops':'店铺管理',
},
"login": {
"title": "登录",

View File

@ -38,4 +38,5 @@ export const componentMap: Record<string, any> = {
'storage/validityperiod':() =>import('@/views/storage/validityperiod/index.vue'),
'system/setting/expressinterface/index':() => import('@/views/system/setting/expressinterface/index.vue'),
'system/setting/encoding/index':() => import('@/views/system/setting/encoding/index.vue'),
'system/setting/shops/index':() => import('@/views/system/setting/shops/index.vue'),
};

View File

@ -89,10 +89,10 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" :detail-request="orderArchiveOrder.detail" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchArchiveOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
<order-items-detail-panel :row="selectedRow" :detail-request="fetchArchiveOrderDetail" />
</div>
<div v-else-if="activeTab === 'fulfillment'" class="detail-page">
<p>履约历程加载中...</p>
@ -172,6 +172,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.archiveOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeArchiveListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.archiveOrder.detail:归档页使用 history 模型 */
function fetchArchiveOrderDetail(data: Record<string, any>) {
return orderArchiveOrder.detail({
...data,
tableType: 'history'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
@ -205,7 +221,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
try {
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -213,6 +229,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeArchiveListWhere(where)
const params = {
pagination: {
page: pagination.currentPage,
@ -228,7 +245,7 @@ async function loadData() {
if (res && (res.code === 200 || res.code === 1)) {
const responseData = res.data || {}
list.value = responseData.list || []
pagination.total = responseData.pagination?.total || responseData.total || (responseData.list ? responseData.list.length : 0)
pagination.total = responseData.pagination?.total ?? 0
} else {
list.value = []
pagination.total = 0

View File

@ -25,6 +25,14 @@ const props = defineProps<{
const loading = ref(false)
const archiveList = ref<any[]>([])
/** order.archiveOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeArchiveListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
watch(
() => [props.orderId, props.deliveryOrderCode],
() => {
@ -61,7 +69,7 @@ async function loadArchiveOrders() {
page: 1,
pageSize: 20
},
where
where: sanitizeArchiveListWhere(where)
})
if (res && (res.code === 1 || res.code === 200)) {

View File

@ -27,11 +27,12 @@
</el-select>
</el-form-item>
</el-col>
<el-col :span="12">
<!-- 店铺名称:order.pendingOrder.createOrder 文档未定义 shop_name,暂不提交 -->
<!-- <el-col :span="12">
<el-form-item label="店铺名称">
<el-input v-model.trim="createOrderForm.shop_name" placeholder="请输入店铺名称" maxlength="80" />
</el-form-item>
</el-col>
</el-col> -->
<el-col :span="12">
<el-form-item label="收件人" prop="name">
<el-input v-model.trim="createOrderForm.name" maxlength="60" placeholder="请输入收件人姓名" />
@ -400,7 +401,6 @@ const createOrderItemsPagination = reactive({
const createOrderForm = reactive({
store_id: undefined as number | undefined,
shop_name: '',
name: '',
mobile: '',
tel: '',
@ -656,7 +656,6 @@ function handleCreateOrderItemsPageSizeChange(size: number) {
function resetCreateOrderDialog() {
createOrderFormRef.value?.clearValidate?.()
createOrderForm.store_id = undefined
createOrderForm.shop_name = ''
createOrderForm.name = ''
createOrderForm.mobile = ''
createOrderForm.tel = ''
@ -1009,7 +1008,6 @@ async function submitCreateOrder() {
const payload = {
store_id: Number(createOrderForm.store_id),
shop_name: String(createOrderForm.shop_name || '').trim() || undefined,
name: String(createOrderForm.name || '').trim(),
mobile: String(createOrderForm.mobile || '').trim() || undefined,
tel: String(createOrderForm.tel || '').trim() || undefined,
@ -1029,7 +1027,7 @@ async function submitCreateOrder() {
order_type: String(createOrderForm.order_type || '').trim() || undefined,
is_urgency: createOrderForm.is_urgency || undefined,
invoice_flag: createOrderForm.invoice_flag || undefined
} satisfies PendingOrderCreateOrderParams & { shop_name?: string }
} satisfies PendingOrderCreateOrderParams
createOrderLoading.value = true
try {

View File

@ -24,6 +24,7 @@ import { orderPendingOrder } from '@/api/order.pendingorder/orderpendingOrder'
const props = defineProps<{
row: Record<string, any> | null
detailRequest?: (data: Record<string, any>) => Promise<any>
}>()
const loading = ref(false)
@ -35,6 +36,30 @@ function formatAmount(value: unknown) {
return Number.isFinite(n) ? n.toFixed(2) : String(value)
}
/** order.pendingOrder.detail 响应:商品明细为 orderItems / items */
function normalizeItems(data: Record<string, any>) {
if (Array.isArray(data.orderItems)) return data.orderItems
if (Array.isArray(data.items)) return data.items
const order = data.order || data.detail
if (order && typeof order === 'object') {
if (Array.isArray(order.orderItems)) return order.orderItems
if (Array.isArray(order.items)) return order.items
}
const rawItems = data.order?.items || data.detail?.items
if (Array.isArray(rawItems)) return rawItems
if (typeof rawItems === 'string') {
try {
const parsed = JSON.parse(rawItems)
return Array.isArray(parsed) ? parsed : []
} catch {
return []
}
}
return []
}
async function loadItems() {
if (!props.row?.id) {
items.value = []
@ -42,7 +67,8 @@ async function loadItems() {
}
loading.value = true
try {
const res: any = await orderPendingOrder.detail({
const requestFn = props.detailRequest || orderPendingOrder.detail
const res: any = await requestFn({
id: props.row.id,
ids: [props.row.id],
tableType: 'order'
@ -53,7 +79,7 @@ async function loadItems() {
items.value = []
return
}
items.value = Array.isArray(res?.data?.items) ? res.data.items : []
items.value = normalizeItems(res?.data || {})
} catch {
ElMessage.error('获取商品明细失败')
items.value = []

View File

@ -89,10 +89,10 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" :detail-request="orderDeliveryOrder.detail" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchDeliveryExpectionOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
<order-items-detail-panel :row="selectedRow" :detail-request="fetchDeliveryExpectionOrderDetail" />
</div>
<div v-else-if="activeTab === 'fulfillment'" class="detail-page">
<p>履约历程加载中...</p>
@ -121,7 +121,6 @@ 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 { orderDeliveryOrder } from '@/api/order.deliveryorder/orderdeliveryOrder'
import { orderDeliveryExpectionOrder } from '@/api/order.deliveryexpectionorder/orderdeliveryexpectionorder'
import {
@ -173,6 +172,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.deliveryExpectionOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeDeliveryExpectionListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.deliveryExpectionOrder.detail:配送异常 dispatch 模型 */
function fetchDeliveryExpectionOrderDetail(data: Record<string, any>) {
return orderDeliveryExpectionOrder.detail({
...data,
tableType: 'dispatch'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
@ -206,7 +221,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
try {
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -214,6 +229,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeDeliveryExpectionListWhere(where)
const params = {
pagination: {
page: pagination.currentPage,

View File

@ -140,10 +140,10 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" :detail-request="orderDeliveryOrder.detail" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchDeliveryOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
<order-items-detail-panel :row="selectedRow" :detail-request="fetchDeliveryOrderDetail" />
</div>
<div v-else class="detail-page order-log-wrapper">
<log :data="selectedRow" />
@ -229,6 +229,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.deliveryOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeDeliveryListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.deliveryOrder.detail:配送 dispatch 模型 */
function fetchDeliveryOrderDetail(data: Record<string, any>) {
return orderDeliveryOrder.detail({
...data,
tableType: 'dispatch'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
@ -297,7 +313,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
try {
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -305,6 +321,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeDeliveryListWhere(where)
const params = {
pagination: {
page: pagination.currentPage,

View File

@ -89,10 +89,10 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" :detail-request="orderEntrustOrder.detail" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchEntrustOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
<order-items-detail-panel :row="selectedRow" :detail-request="fetchEntrustOrderDetail" />
</div>
<div v-else-if="activeTab === 'fulfillment'" class="detail-page">
<p>履约历程加载中...</p>
@ -172,6 +172,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.entrustOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeEntrustListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.entrustOrder.detail:委托外仓 outsourced 模型 */
function fetchEntrustOrderDetail(data: Record<string, any>) {
return orderEntrustOrder.detail({
...data,
tableType: 'outsourced'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
@ -205,7 +221,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
try {
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -213,6 +229,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeEntrustListWhere(where)
const params = {
pagination: {
page: pagination.currentPage,

View File

@ -230,7 +230,7 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchExpectionOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
@ -467,6 +467,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.expectionOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeExpectionListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.expectionOrder.detail:异常页订单明细 */
function fetchExpectionOrderDetail(data: Record<string, any>) {
return orderExpectionOrder.detail({
...data,
tableType: 'order'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
@ -585,7 +601,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
try {
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -593,6 +609,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeExpectionListWhere(where)
const params = {
pagination: {
page: pagination.currentPage,

View File

@ -132,7 +132,7 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchOutboundOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
@ -224,6 +224,14 @@ const selectedRow = computed(() => {
return list.value.find((item: any) => item.id === selectedOrderId.value) || null
})
/** order.outboundOrder.detail:待出库页订单明细 */
function fetchOutboundOrderDetail(data: Record<string, any>) {
return orderOutboundOrder.detail({
...data,
tableType: 'order'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})

View File

@ -106,7 +106,7 @@
<div class="detail-container">
<KeepAlive>
<div v-if="activeTab === 'detail'" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :row="selectedRow" />
<pending-order-detail-panel :row="selectedRow" :detail-request="fetchReviewOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" class="detail-page order-detail-wrapper">
<order-items-detail-panel :row="selectedRow" />
@ -213,6 +213,22 @@ const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.reviewOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeReviewListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.reviewOrder.detail:待审核页订单明细 */
function fetchReviewOrderDetail(data: Record<string, any>) {
return orderReviewOrder.detail({
...data,
tableType: 'revieworder'
})
}
onMounted(() => {
loadData()
loadOrderMetaOptions()
@ -268,7 +284,7 @@ async function loadData() {
loading.value = true
const start = Date.now()
const where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
let where = buildWhereConditions(scanBox.value?.getConditions?.() || {})
if (quickSearch.value) {
where.delivery_order_code = {
operator: 'like',
@ -276,6 +292,7 @@ async function loadData() {
type: 'text'
}
}
where = sanitizeReviewListWhere(where)
const queryParams = {
pagination: {

View File

@ -906,7 +906,7 @@ import { storeWarehouseList, storeWarehouseSign, storeWarehouseUnbind,
storeWarehouseRename, storeWarehouseGetPolicyConfig, storeWarehouseGetPolicyConfigFields,
storeWarehouseSavePolicyConfig, saveApiConfig, storeWarehouseDeleteQimenConfig,
storeWarehouseAdjustPrintQuantity, storeWarehouseQueryPrintQuantityLogs, listApiConfig
} from '@/api/storeWarehouse.store/storeWarehouse'
} from '@/api/storewarehouse.store/storeWarehouse'
import { listInterfaceTypes, getExpressList, getPlatformList, getQimenAppList } from '@/api/index/index'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'

View File

@ -479,20 +479,20 @@ import type { FormInstance, FormRules } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import {
getExpressList,
getPrintPlatformList,
getPrintPlatformTemplateList,
getPlatformOauthLink,
getShopList,
getShopExpressList
} from '@/api/index/index'
import { expressIndexGetExpressList as getExpressList } from '@/api/setting.express/express'
import {
expressInterfaceCreate,
expressInterfaceDelete,
expressInterfaceList,
expressInterfaceListByWarehousePlatformCode,
expressInterfaceUpdate
} from '@/api/setting.expressInterface/expressInterface'
expressInterfaceUpdate,
getPrintPlatformList
} from '@/api/setting.expressinterface/expressInterface'
import { useUserStore } from '@/stores/modules/user'
import { useSettingsStore } from '@/stores/modules/settings'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'

View File

@ -0,0 +1,468 @@
<template>
<div class="shops-container encoding-sub-container">
<div class="main-content">
<div class="toolbar">
<div class="toolbar-left">
<el-form :inline="true" :model="listQuery" class="filter-form">
<el-form-item label="平台">
<el-select
v-model="listQuery.platform_code"
placeholder="全部平台"
clearable
filterable
style="width: 160px"
@change="handleFilter"
>
<el-option
v-for="item in platformOptions"
:key="item.code"
:label="item.label || item.name"
:value="item.code"
/>
</el-select>
</el-form-item>
<el-form-item label="状态">
<el-select
v-model="listQuery.status"
placeholder="全部"
clearable
style="width: 120px"
@change="handleFilter"
>
<el-option label="正常" value="ACTIVE" />
<el-option label="停用" value="INACTIVE" />
</el-select>
</el-form-item>
<el-form-item label="关键词">
<el-input
v-model="listQuery.keyword"
placeholder="自定义名称/店铺名称"
clearable
style="width: 200px"
@keyup.enter="handleFilter"
/>
</el-form-item>
<el-form-item>
<el-button type="primary" :loading="loading" @click="handleFilter">搜索</el-button>
<el-button :loading="loading" @click="loadList">刷新</el-button>
<el-button type="success" @click="openCreate">新增店铺</el-button>
</el-form-item>
</el-form>
</div>
</div>
<div class="upper-wrapper">
<upper-table
ref="upperTable"
title="店铺列表"
table-id="setting-shops"
:data="tableData"
:columns="columns"
:table-size="tableSize"
:pagination="pagination"
:show-index="true"
:show-selection="false"
:loading="loading"
:query-time="queryTime"
@page-change="handlePageChange"
@page-size-change="handlePageSizeChange"
@refresh="loadList"
>
<template #column-status="{ row }">
<el-tag :type="formatShopStatus(row.status).type" size="small">
{{ formatShopStatus(row.status).text }}
</el-tag>
</template>
<template #column-actions="{ row }">
<el-button link type="primary" @click="openEdit(row)">编辑</el-button>
<el-button link type="success" @click="openAuthorize(row)">授权</el-button>
<el-button link type="danger" @click="handleDelete(row)">删除</el-button>
</template>
<template #empty>
<div class="empty-tip">暂无店铺数据</div>
</template>
</upper-table>
</div>
</div>
<el-dialog
v-model="dialogVisible"
:title="dialogMode === 'create' ? '新增店铺' : '编辑店铺'"
width="560px"
align-center
@close="resetForm"
>
<el-form ref="formRef" :model="formData" :rules="rules" label-width="110px">
<el-form-item label="平台" prop="platform_code">
<el-select
v-model="formData.platform_code"
placeholder="请选择平台"
filterable
style="width: 100%"
>
<el-option
v-for="item in platformOptions"
:key="item.code"
:label="item.label || item.name"
:value="item.code"
/>
</el-select>
</el-form-item>
<el-form-item label="自定义名称" prop="custom_name">
<el-input v-model="formData.custom_name" placeholder="最大 100 字符" maxlength="100" show-word-limit />
</el-form-item>
<el-form-item v-if="dialogMode === 'create'" label="店铺名称">
<el-input
v-model="formData.shop_name"
placeholder="可选,不填则使用自定义名称"
maxlength="100"
show-word-limit
/>
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">取消</el-button>
<el-button type="primary" :loading="saving" @click="submitForm">保存</el-button>
</template>
</el-dialog>
<el-dialog
v-model="authDialogVisible"
title="店铺授权"
width="560px"
align-center
@close="resetAuthForm"
>
<el-form ref="authFormRef" :model="authForm" :rules="authRules" label-width="110px">
<el-form-item label="店铺">
<el-input :model-value="authForm.shopLabel" disabled />
</el-form-item>
<el-form-item label="回调地址" prop="callbackurl">
<el-input
v-model="authForm.callbackurl"
placeholder="请输入授权完成后的回调 URL"
clearable
/>
</el-form-item>
</el-form>
<template #footer>
<el-button @click="authDialogVisible = false">取消</el-button>
<el-button type="primary" :loading="authSubmitting" @click="submitAuthorize">确认授权</el-button>
</template>
</el-dialog>
</div>
</template>
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'
import UpperTable from '@/components/UpperTable/index.vue'
import { getPrintPlatformList } from '@/api/setting.expressinterface/expressInterface'
import {
shopGetAuthorizeSessionKey,
shopsAdd,
shopsDel,
shopsEdit,
shopsList
} from '@/api/shops/shops'
import {
buildShopListPayload,
formatShopStatus,
shopColumns,
type ShopRecord
} from './shops-config'
type PlatformOption = {
code: string
name: string
label?: string
}
const columns = shopColumns
const loading = ref(false)
const saving = ref(false)
const authDialogVisible = ref(false)
const authSubmitting = ref(false)
const authFormRef = ref<FormInstance>()
const tableData = ref<ShopRecord[]>([])
const platformOptions = ref<PlatformOption[]>([])
const queryTime = ref(0)
const tableSize = ref('small')
const pagination = reactive({ currentPage: 1, pageSize: 20, total: 0 })
const listQuery = reactive({
platform_code: '',
status: '',
keyword: ''
})
const dialogVisible = ref(false)
const dialogMode = ref<'create' | 'edit'>('create')
const formRef = ref<FormInstance>()
const formData = reactive({
id: undefined as number | undefined,
platform_code: '',
custom_name: '',
shop_name: ''
})
const rules: FormRules = {
platform_code: [{ required: true, message: '请选择平台', trigger: 'change' }],
custom_name: [
{ required: true, message: '请输入自定义名称', trigger: 'blur' },
{ max: 100, message: '最多 100 个字符', trigger: 'blur' }
]
}
const authForm = reactive({
shopId: undefined as number | undefined,
shopLabel: '',
callbackurl: ''
})
const authRules: FormRules = {
callbackurl: [{ required: true, message: '请输入回调地址', trigger: 'blur' }]
}
const isSuccess = (res: any) => res && [0, 1, 200].includes(res.code)
async function loadList() {
loading.value = true
const start = Date.now()
try {
const res: any = await shopsList(
buildShopListPayload({
page: pagination.currentPage,
pageSize: pagination.pageSize,
platformCode: listQuery.platform_code,
keyword: listQuery.keyword,
status: listQuery.status
})
)
if (!isSuccess(res)) {
ElMessage.error(res?.message || '获取店铺列表失败')
tableData.value = []
pagination.total = 0
return
}
const data = res?.data || {}
tableData.value = data.list || []
pagination.total = Number(data.pagination?.total ?? data.total ?? 0)
} catch {
tableData.value = []
pagination.total = 0
ElMessage.error('获取店铺列表失败')
} finally {
queryTime.value = Date.now() - start
loading.value = false
}
}
async function loadPlatformOptions() {
try {
const res: any = await getPrintPlatformList({})
if (!isSuccess(res)) {
platformOptions.value = []
return
}
platformOptions.value = (res?.data || []).map((item: any) => ({
code: item.platform_code || item.code,
name: item.platform_name || item.name,
label: item.label || item.platform_name || item.name
}))
} catch {
platformOptions.value = []
}
}
function handlePageChange(page: number) {
pagination.currentPage = page
loadList()
}
function handlePageSizeChange(size: number) {
pagination.pageSize = size
pagination.currentPage = 1
loadList()
}
function handleFilter() {
pagination.currentPage = 1
loadList()
}
function resetForm() {
formData.id = undefined
formData.platform_code = ''
formData.custom_name = ''
formData.shop_name = ''
formRef.value?.clearValidate()
}
function openCreate() {
dialogMode.value = 'create'
dialogVisible.value = true
resetForm()
}
function openEdit(row: ShopRecord) {
if (!row.id) return
dialogMode.value = 'edit'
dialogVisible.value = true
formData.id = row.id
formData.platform_code = row.platform_code || ''
formData.custom_name = row.custom_name || ''
formData.shop_name = ''
formRef.value?.clearValidate()
}
async function submitForm() {
if (!formRef.value || saving.value) return
const valid = await formRef.value.validate().catch(() => false)
if (!valid) return
saving.value = true
try {
if (dialogMode.value === 'create') {
const payload: {
platform_code: string
custom_name: string
shop_name?: string
} = {
platform_code: formData.platform_code,
custom_name: formData.custom_name.trim()
}
const shopName = formData.shop_name.trim()
if (shopName) payload.shop_name = shopName
const res: any = await shopsAdd(payload)
if (!isSuccess(res)) {
ElMessage.error(res?.message || '新增失败')
return
}
ElMessage.success('新增成功')
} else {
if (!formData.id) return
const platformCode = formData.platform_code.trim()
const customName = formData.custom_name.trim()
if (!platformCode && !customName) {
ElMessage.warning('请至少修改平台或自定义名称')
return
}
const payload: {
id: number
platform_code?: string
custom_name?: string
} = { id: formData.id }
if (platformCode) payload.platform_code = platformCode
if (customName) payload.custom_name = customName
const res: any = await shopsEdit(payload)
if (!isSuccess(res)) {
ElMessage.error(res?.message || '更新失败')
return
}
ElMessage.success('更新成功')
}
dialogVisible.value = false
loadList()
} catch {
ElMessage.error('保存失败')
} finally {
saving.value = false
}
}
function handleDelete(row: ShopRecord) {
if (!row.id) return
const name = row.custom_name || row.shop_name || String(row.id)
ElMessageBox.confirm(`确认删除店铺「${name}」吗?`, '提示', { type: 'warning' })
.then(async () => {
const res: any = await shopsDel({ id: row.id as number })
if (!isSuccess(res)) {
ElMessage.error(res?.message || '删除失败')
return
}
ElMessage.success('删除成功')
if (tableData.value.length === 1 && pagination.currentPage > 1) {
pagination.currentPage -= 1
}
loadList()
})
.catch(() => undefined)
}
function resetAuthForm() {
authForm.shopId = undefined
authForm.shopLabel = ''
authForm.callbackurl = ''
authFormRef.value?.clearValidate()
}
function openAuthorize(row: ShopRecord) {
if (!row.id) return
authForm.shopId = row.id
authForm.shopLabel = row.custom_name || row.shop_name || String(row.id)
authForm.callbackurl = ''
authDialogVisible.value = true
authFormRef.value?.clearValidate()
}
async function submitAuthorize() {
if (!authFormRef.value || authSubmitting.value || !authForm.shopId) return
const valid = await authFormRef.value.validate().catch(() => false)
if (!valid) return
const callbackurl = authForm.callbackurl.trim()
if (!callbackurl) {
ElMessage.warning('请输入回调地址')
return
}
authSubmitting.value = true
try {
const res: any = await shopGetAuthorizeSessionKey({
id: authForm.shopId,
callbackurl
})
if (!isSuccess(res)) {
ElMessage.error(res?.message || '获取授权链接失败')
return
}
const oauthUrl = String(res?.data?.authorize_url || '').trim()
if (!oauthUrl) {
ElMessage.error('未获取到有效的授权链接')
return
}
authDialogVisible.value = false
const win = window.open(oauthUrl, '_blank')
if (!win) {
window.location.href = oauthUrl
}
} catch {
ElMessage.error('获取授权链接失败')
} finally {
authSubmitting.value = false
}
}
onMounted(async () => {
await loadPlatformOptions()
await loadList()
})
</script>
<style lang="scss" scoped>
@use '../encoding/styles/encoding-sub.scss';
.filter-form {
:deep(.el-form-item) {
margin-bottom: 0;
margin-right: 12px;
}
}
</style>

View File

@ -0,0 +1,66 @@
export type ShopRecord = {
id?: number
platform_code?: string
platform_name?: string
custom_name?: string
shop_name?: string
status?: string | number
}
export const shopColumns = [
{ prop: 'id', label: 'ID', width: '80', sortable: true },
{ prop: 'platform_code', label: '平台编码', minWidth: '120', showOverflowTooltip: true },
{ prop: 'platform_name', label: '平台名称', minWidth: '140', showOverflowTooltip: true },
{ prop: 'custom_name', label: '自定义名称', minWidth: '160', showOverflowTooltip: true },
{ prop: 'shop_name', label: '店铺名称', minWidth: '160', showOverflowTooltip: true },
{ prop: 'status', label: '状态', width: '100', align: 'center' },
{ prop: 'actions', label: '操作', width: '220', align: 'center', fixed: 'right' }
]
export function formatShopStatus(status: string | number | undefined) {
const raw = String(status ?? '').trim().toUpperCase()
if (!raw) return { text: '--', type: 'info' as const }
if (['1', 'ACTIVE', 'ENABLED', 'ENABLE'].includes(raw)) {
return { text: '正常', type: 'success' as const }
}
if (['0', 'INACTIVE', 'DISABLED', 'DISABLE'].includes(raw)) {
return { text: '停用', type: 'danger' as const }
}
return { text: String(status), type: 'info' as const }
}
export function buildShopListPayload(options: {
page: number
pageSize: number
platformCode?: string
keyword?: string
status?: string
}) {
const where: Record<string, unknown> = {}
const platformCode = String(options.platformCode || '').trim()
const keyword = String(options.keyword || '').trim()
const status = String(options.status || '').trim()
if (platformCode) {
where.platform_code = platformCode
}
if (status) {
where.status = status
}
if (keyword) {
where.quickWhere = keyword
}
const payload: Record<string, unknown> = {
page: options.page,
pageSize: options.pageSize,
pagination: {
page: options.page,
pageSize: options.pageSize
}
}
if (Object.keys(where).length) {
payload.where = where
}
return payload
}

File diff suppressed because it is too large Load Diff

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-05-21 13:09:42
- 更新时间: 2026-05-25 17:22:24
- 扫描目录: `src\api`
- 模块数: 37
- API 文件数: 37
- 接口数: 295
- 已启用: 263
- 模块数: 38
- API 文件数: 38
- 接口数: 308
- 已启用: 276
- 占位接口: 2
## 模块统计
@ -14,7 +14,7 @@
| --- | ---: | ---: | ---: | ---: |
| config | 1 | 1 | 0 | 0 |
| dashboard | 1 | 6 | 6 | 0 |
| index | 1 | 18 | 15 | 1 |
| index | 1 | 25 | 22 | 1 |
| order | 1 | 1 | 1 | 0 |
| order.archiveorder | 1 | 2 | 2 | 0 |
| order.deliveryexpectionorder | 1 | 2 | 2 | 0 |
@ -33,12 +33,13 @@
| printer.station | 1 | 11 | 1 | 0 |
| setting.account | 1 | 7 | 7 | 0 |
| setting.express | 1 | 7 | 7 | 0 |
| setting.expressinterface | 1 | 5 | 5 | 0 |
| setting.expressinterface | 1 | 6 | 6 | 0 |
| setting.permission | 1 | 4 | 4 | 0 |
| setting.platform | 1 | 5 | 5 | 0 |
| setting.printtemplate | 1 | 13 | 13 | 0 |
| setting.role | 1 | 5 | 5 | 0 |
| setting.warehouse | 1 | 3 | 3 | 0 |
| shops | 1 | 5 | 5 | 0 |
| stock | 1 | 29 | 28 | 0 |
| storage_receiving | 1 | 22 | 12 | 0 |
| storage.entry | 1 | 4 | 4 | 0 |
@ -62,6 +63,7 @@
| dashboard | getStoreStats | dashboard.storeStats | POST | 是 | 否 | dashboard/dashboard.ts | |
| dashboard | getWarehouseStats | dashboard.warehouseStats | POST | 是 | 否 | dashboard/dashboard.ts | |
| index | fastWhereTree | index.fastWhereTree | POST | 否 | 是 | index/index.ts | |
| index | getCainiaoStfTemplates | index.getCainiaoStfTemplates | POST | 是 | 否 | index/index.ts | |
| index | getCOSUploadConfig | index.getCOSUploadConfig | POST | 是 | 否 | index/index.ts | |
| index | getExpressList | index.getExpressList | POST | 是 | 否 | index/index.ts | |
| index | getExpressProductTypeList | index.getExpressProductTypeList | POST | 是 | 否 | index/index.ts | |
@ -70,9 +72,15 @@
| index | getLocationTypeList | index.getLocationTypeList | POST | 是 | 否 | index/index.ts | |
| index | getMessageDetail | index.getMessageDetail | POST | 是 | 否 | index/index.ts | |
| index | getPlatformList | index.getPlatformList | POST | 是 | 否 | index/index.ts | 平台编码表单用 |
| index | getPlatformOauthLink | index.getPlatformOauthLink | POST | 是 | 否 | index/index.ts | |
| index | getPrintPlatformTemplateList | index.getPrintPlatformTemplateList | POST | 是 | 否 | index/index.ts | |
| index | getQimenAppList | index.getQimenAppList | POST | 是 | 否 | index/index.ts | |
| index | getShopExpressList | index.getShopExpressList | POST | 是 | 否 | index/index.ts | |
| index | getShopList | index.getShopList | POST | 是 | 否 | index/index.ts | |
| index | listInterfaceTypes | index.listInterfaceTypes | POST | 是 | 否 | index/index.ts | |
| index | loadStores | index.loadStores | POST | 是 | 否 | index/index.ts | |
| index | loginToIm | index.loginToIm | POST | 否 | 否 | index/index.ts | |
| index | polyapiAuthorizeUrl | index.polyapiAuthorizeUrl | POST | 是 | 否 | index/index.ts | |
| index | putI18nCollect | index.putI18nCollect | POST | 是 | 否 | index/index.ts | |
| index | recognizeLicensePlate | index.recognizeLicensePlate | POST | 否 | 否 | index/index.ts | |
| index | ReferenceFile | index.ReferenceFile | POST | 是 | 否 | index/index.ts | |
@ -195,6 +203,7 @@
| setting.express | expressList | setting.express.list | POST | 是 | 否 | setting.express/express.ts | |
| setting.express | expressListBase | setting.express.listBase | POST | 是 | 否 | setting.express/express.ts | |
| setting.express | expressUpdate | setting.express.update | POST | 是 | 否 | setting.express/express.ts | |
| setting.expressinterface | getPrintPlatformList | index.getPrintPlatformList | POST | 是 | 否 | setting.expressinterface/expressInterface.ts | |
| setting.expressinterface | expressInterfaceCreate | setting.expressInterface.create | POST | 是 | 否 | setting.expressinterface/expressInterface.ts | |
| setting.expressinterface | expressInterfaceDelete | setting.expressInterface.delete | POST | 是 | 否 | setting.expressinterface/expressInterface.ts | |
| setting.expressinterface | expressInterfaceList | setting.expressInterface.list | POST | 是 | 否 | setting.expressinterface/expressInterface.ts | |
@ -230,6 +239,11 @@
| setting.warehouse | settingWarehouseGetFieldMeta | setting.warehouse.getFieldMeta | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| setting.warehouse | settingWarehouseGetSettings | setting.warehouse.getSettings | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| setting.warehouse | settingWarehouseSaveSettings | setting.warehouse.saveSettings | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| shops | shopGetAuthorizeSessionKey | shop.GetAuthorizeSessionKey | POST | 是 | 否 | shops/shops.ts | |
| shops | shopsAdd | shops.add | POST | 是 | 否 | shops/shops.ts | |
| shops | shopsDel | shops.del | POST | 是 | 否 | shops/shops.ts | |
| shops | shopsEdit | shops.edit | POST | 是 | 否 | shops/shops.ts | |
| shops | shopsList | shops.list | POST | 是 | 否 | shops/shops.ts | |
| stock | stockStockWarehouse | stock.stockWarehouse | POST | 是 | 否 | stock/stock.ts | |
| stock | backData | stock.warehouse.backData | POST | 是 | 否 | stock/stock.ts | |
| stock | bindItem | stock.warehouse.bindItem | POST | 是 | 否 | stock/stock.ts | |
@ -311,7 +325,7 @@
| storewarehouse.store | storeWarehouseGetPolicyConfigFields | storeWarehouse.store.getPolicyConfigFields | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | storeWarehouseList | storeWarehouse.store.list | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | listApiConfig | storeWarehouse.store.listApiConfig | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | queryPrintQuantityLogs | storeWarehouse.store.queryPrintQuantityLogs | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | storeWarehouseQueryPrintQuantityLogs | storeWarehouse.store.queryPrintQuantityLogs | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | storeWarehouseRename | storeWarehouse.store.rename | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | saveApiConfig | storeWarehouse.store.saveApiConfig | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |
| storewarehouse.store | storeWarehouseSavePolicyConfig | storeWarehouse.store.savePolicyConfig | POST | 是 | 否 | storewarehouse.store/storeWarehouse.ts | |

View File

@ -8,18 +8,28 @@
}
},
{
"method": "storage.stockout.list",
"method": "setting.expressInterface.list",
"body": {}
},
{
"method": "storage.stockout.toOrder",
"method": "setting.expressInterface.listByWarehousePlatformCode",
"body": {}
},
{
"method": "storage.stockout.listItems",
"body": {
"id": 6487
}
"method": "setting.expressInterface.create",
"body": {}
},
{
"method": "setting.expressInterface.update",
"body": {}
},
{
"method": "setting.expressInterface.delete",
"body": {}
},
{
"method": "index.getPrintPlatformList",
"body": {}
}
],
"successMessages": [

File diff suppressed because it is too large Load Diff

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
@ -12,109 +12,72 @@
"label": "全部"
}
},
"totalInterfaceCount": 261,
"totalInterfaceCount": 270,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleAdded": 1,
"moduleDeleted": 0,
"moduleUpdated": 2,
"interfaceAdded": 0,
"moduleUpdated": 0,
"interfaceAdded": 5,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 4,
"interfaceResponseUpdated": 3
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": [
"added": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"previousModuleName": "基础模块",
"previousModuleKey": "index",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"index.getShopList"
],
"responseUpdatedMethods": [
"index.getShopList"
]
}
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"previousModuleName": "快递接口管理模块",
"previousModuleKey": "setting.expressInterface",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"setting.expressInterface.create",
"setting.expressInterface.list",
"setting.expressInterface.update"
],
"responseUpdatedMethods": [
"setting.expressInterface.list",
"setting.expressInterface.update"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"method": "index.getShopList"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.create"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.list"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.update"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"methods": [
"shop.GetAuthorizeSessionKey",
"shops.add",
"shops.del",
"shops.edit",
"shops.list"
],
"interfaceCount": 5
}
],
"responseUpdated": [
"deleted": [],
"updated": []
},
"interfaceUpdates": {
"added": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"method": "index.getShopList"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shop.GetAuthorizeSessionKey"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.list"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.add"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.update"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.del"
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.edit"
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.list"
}
]
],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
}
},
"interfaces": [
@ -369,6 +332,49 @@
],
"response": []
},
{
"moduleName": "基础模块",
"moduleKey": "index",
"moduleFolder": "index",
"method": "index.getCainiaoStfTemplates",
"title": "公共无参查询淘宝菜鸟标准模板列表;服务端调用淘宝开放平台 cainiao.cloudprint.stdtemplates.get,请求地址为 https://eco.taobao.com/router/rest,使用 TOP 公共签名参数。不需要用户授权,不下发 session,不依赖登录态、当前仓库或店铺授权。成功返回 data.platform_code='TB' 与标准模板数组,模板项统一字段为 template_id/template_name/template_url/cp_code/wp_code。",
"description": "公共无参查询淘宝菜鸟标准模板列表;服务端调用淘宝开放平台 cainiao.cloudprint.stdtemplates.get,请求地址为 https://eco.taobao.com/router/rest,使用 TOP 公共签名参数。不需要用户授权,不下发 session,不依赖登录态、当前仓库或店铺授权。成功返回 data.platform_code='TB' 与标准模板数组,模板项统一字段为 template_id/template_name/template_url/cp_code/wp_code。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "业务提示信息,成功时返回 ok。"
},
{
"name": "data.platform_code",
"type": "string",
"required": true,
"description": "平台编码,固定返回 TB。"
},
{
"name": "data.list",
"type": "array",
"required": true,
"description": "菜鸟标准模板列表;来源于 cainiao_cloudprint_stdtemplates_get_response.result.datas[*].standard_templates[*] 的宽松兼容解析结果,按统一字段 template_id/template_name/template_url/cp_code/wp_code 返回。"
}
]
},
{
"moduleName": "基础模块",
"moduleKey": "index",
@ -406,8 +412,8 @@
"moduleKey": "setting.express",
"moduleFolder": "setting.express",
"method": "index.getExpressList",
"title": "合并后的快递列表",
"description": "合并后的快递列表",
"title": "获取快递列表。默认返回系统基础快递与当前登录仓库自定义快递编码的合并结果:系统快递在前,仓库自定义编码在后,同一 `code` 仅保留首条(系统同码优先保留系统记录)。当 `systemOnly` 为真值(支持 `true`、`1`、`'1'`、`'true'`)时,仅返回系统基础快递列表。仅接受 `express_code` 入参,服务端会先 trim 再转为大写:`systemOnly=true` 时按系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义编码映射记录中的系统快递编码字段 `express_code` 过滤,仅返回当前登录仓库下匹配该系统快递编码的自定义编码列表,不再回传系统基础项。仓库范围来自当前登录用户 `ctx.user.store_id`;未识别到仓库时,自定义编码列表为空。接口优先读取缓存,未命中时回源 `wms_express` 与 `wms_express_setting`。",
"description": "获取快递列表。默认返回系统基础快递与当前登录仓库自定义快递编码的合并结果:系统快递在前,仓库自定义编码在后,同一 `code` 仅保留首条(系统同码优先保留系统记录)。当 `systemOnly` 为真值(支持 `true`、`1`、`'1'`、`'true'`)时,仅返回系统基础快递列表。仅接受 `express_code` 入参,服务端会先 trim 再转为大写:`systemOnly=true` 时按系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义编码映射记录中的系统快递编码字段 `express_code` 过滤,仅返回当前登录仓库下匹配该系统快递编码的自定义编码列表,不再回传系统基础项。仓库范围来自当前登录用户 `ctx.user.store_id`;未识别到仓库时,自定义编码列表为空。接口优先读取缓存,未命中时回源 `wms_express` 与 `wms_express_setting`。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -416,8 +422,46 @@
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": []
"params": [
{
"name": "systemOnly",
"type": "boolean|number|string",
"required": false,
"description": "是否仅返回系统基础快递列表;仅 `true`、`1`、`'1'`、`'true'` 会被识别为 true,其余值按 false 处理"
},
{
"name": "express_code",
"type": "string",
"required": false,
"description": "系统快递编码;服务端会去首尾空格并转为大写。`systemOnly=true` 时按该系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义映射记录中的系统快递编码字段 `express_code` 过滤当前仓库的自定义编码列表,而不是按自定义 `code` 过滤"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功时为 `success`"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回消息,成功时通常为 `ok`"
},
{
"name": "data",
"type": "array",
"required": true,
"description": "快递列表数组。默认模式下先返回系统基础快递,再追加当前仓库自定义编码;当传入 `express_code` 且 `systemOnly=false` 时,仅返回当前仓库下系统快递编码等于该 `express_code` 的自定义映射记录,不返回系统基础项。每项字段如下:"
}
]
},
{
"moduleName": "基础模块",
@ -613,6 +657,105 @@
}
]
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"moduleFolder": "setting.expressinterface",
"method": "index.getPrintPlatformList",
"title": "获取打印平台全量列表。供前端新增、修改快递接口时下拉选择使用;仅返回未删除且状态为 `ACTIVE` 的打印平台,不分页,按 `platform_name` 升序、`id` 升序返回。接口不校验额外鉴权或权限点,但需要登录态。",
"description": "获取打印平台全量列表。供前端新增、修改快递接口时下拉选择使用;仅返回未删除且状态为 `ACTIVE` 的打印平台,不分页,按 `platform_name` 升序、`id` 升序返回。接口不校验额外鉴权或权限点,但需要登录态。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功时为 `success`"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回消息,成功时通常为 `ok`"
},
{
"name": "data",
"type": "array",
"required": true,
"description": "打印平台列表数组,不分页,仅包含未删除且状态为 `ACTIVE` 的平台;按 `platform_name` 升序、`id` 升序返回。每项字段如下:"
}
]
},
{
"moduleName": "基础模块",
"moduleKey": "index",
"moduleFolder": "index",
"method": "index.getPrintPlatformTemplateList",
"title": "按打印平台与快递编码查询模板列表。express_code 为必填;接口会先按 platform_code(默认 CAINIAO)定位 wms_express 对应打印平台字段,再以 express_code 过滤可用模板后返回。",
"description": "按打印平台与快递编码查询模板列表。express_code 为必填;接口会先按 platform_code(默认 CAINIAO)定位 wms_express 对应打印平台字段,再以 express_code 过滤可用模板后返回。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [
{
"name": "platform_code",
"type": "string",
"required": false,
"description": "打印平台编码(如 CAINIAO);不传默认 CAINIAO,服务端会转为大写。"
},
{
"name": "express_code",
"type": "string",
"required": true,
"description": "快递编码(必填);服务端会转为大写,并用于按 wms_express 中对应打印平台字段筛选模板。"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局结果标识;成功为 success,失败为 failure。"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码;成功时为 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息;成功时为 ok。"
},
{
"name": "data",
"type": "object",
"required": true,
"description": "返回数据对象。"
}
]
},
{
"moduleName": "基础模块",
"moduleKey": "index",
@ -776,6 +919,43 @@
"params": [],
"response": []
},
{
"moduleName": "基础模块",
"moduleKey": "index",
"moduleFolder": "index",
"method": "index.polyapiAuthorizeUrl",
"title": "生成菠萝派授权链接。该接口不接收请求参数,服务端会固定调用 Differ.JH.BuildeAuthorizeUrl,并以内置配置 this.app.config.poloApi.appKey / this.app.config.poloApi.secret 以及当前代码中写死的 callbackUrl=http://39.100.57.68/、state=123456、itemcode=test001 作为上游请求参数,最终将菠萝派接口原始响应包裹后返回。",
"description": "生成菠萝派授权链接。该接口不接收请求参数,服务端会固定调用 Differ.JH.BuildeAuthorizeUrl,并以内置配置 this.app.config.poloApi.appKey / this.app.config.poloApi.secret 以及当前代码中写死的 callbackUrl=http://39.100.57.68/、state=123456、itemcode=test001 作为上游请求参数,最终将菠萝派接口原始响应包裹后返回。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "业务提示信息,成功时返回 ok。"
},
{
"name": "data.respone",
"type": "object",
"required": true,
"description": "菠萝派接口 Differ.JH.BuildeAuthorizeUrl 的原始响应对象。字段名按当前实现保持为 respone。"
}
]
},
{
"moduleName": "基础模块",
"moduleKey": "index",
@ -9253,6 +9433,381 @@
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"moduleFolder": "shops",
"method": "shop.GetAuthorizeSessionKey",
"title": "按店铺所属平台生成授权会话。入参兼容 id/shop_id/shopId 与 callbackurl/callback_url,callbackurl 必填。对已实现的平台(PDD/CAINIAO)返回 session_key/authorize_url/state,其他平台返回 501 未实现。",
"description": "按店铺所属平台生成授权会话。入参兼容 id/shop_id/shopId 与 callbackurl/callback_url,callbackurl 必填。对已实现的平台(PDD/CAINIAO)返回 session_key/authorize_url/state,其他平台返回 501 未实现。",
"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,兼容 shop_id/shopId"
},
{
"name": "callbackurl",
"type": "string",
"required": true,
"description": "回调地址,兼容 callback_url"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.shop_id",
"type": "number",
"required": true,
"description": "店铺 ID"
},
{
"name": "data.platform_code",
"type": "string",
"required": true,
"description": "平台编码(大写)"
},
{
"name": "data.callbackurl",
"type": "string",
"required": true,
"description": "回调地址"
},
{
"name": "data.session_key",
"type": "string",
"required": true,
"description": "授权预占码(session)"
},
{
"name": "data.authorize_url",
"type": "string",
"required": true,
"description": "平台授权跳转地址(含 state)"
},
{
"name": "data.state",
"type": "string",
"required": true,
"description": "内部 state 值(platform + '_' + authRandomCode),用于回调解析"
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"moduleFolder": "shops",
"method": "shops.add",
"title": "新增店铺,校验 platform_code 必须匹配已配置且处于 ACTIVE 且未删除的打印平台;custom_name 必填且长度<=100;shop_name 可选,缺失时使用 custom_name。支持 snake_case 与 camelCase 入参兼容。",
"description": "新增店铺,校验 platform_code 必须匹配已配置且处于 ACTIVE 且未删除的打印平台;custom_name 必填且长度<=100;shop_name 可选,缺失时使用 custom_name。支持 snake_case 与 camelCase 入参兼容。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "platform_code",
"type": "string",
"required": true,
"description": "平台编码,兼容 platformCode,服务端会标准化为大写并验证"
},
{
"name": "custom_name",
"type": "string",
"required": true,
"description": "店铺自定义名称,最大长度 100"
},
{
"name": "shop_name",
"type": "string",
"required": false,
"description": "店铺名称,若不传则以 custom_name 作为 shop_name"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "新建店铺 ID"
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"moduleFolder": "shops",
"method": "shops.del",
"title": "软删除店铺:将 shop_name 修改为 DELETED_SHOP_<id>_<suffix> 并清空敏感字段;若存在 ExpressInterface 引用则返回 409;返回 deleted=true 与 id。",
"description": "软删除店铺:将 shop_name 修改为 DELETED_SHOP_<id>_<suffix> 并清空敏感字段;若存在 ExpressInterface 引用则返回 409;返回 deleted=true 与 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,兼容 shop_id/shopId"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.deleted",
"type": "boolean",
"required": true,
"description": "是否已删除"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "删除的店铺 ID"
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"moduleFolder": "shops",
"method": "shops.edit",
"title": "编辑店铺,仅允许修改 platform_code 或 custom_name;至少传入其中一个。platform_code 会校验平台存在且为 ACTIVE;custom_name 必填且长度<=100;服务端兼容 snake_case/camelCase。",
"description": "编辑店铺,仅允许修改 platform_code 或 custom_name;至少传入其中一个。platform_code 会校验平台存在且为 ACTIVE;custom_name 必填且长度<=100;服务端兼容 snake_case/camelCase。",
"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,兼容 shop_id/shopId"
},
{
"name": "platform_code",
"type": "string",
"required": false,
"description": "平台编码,兼容 platformCode,服务端会转为大写并校验"
},
{
"name": "custom_name",
"type": "string",
"required": false,
"description": "自定义名称,兼容 customName,若传入需非空且 <=100 字符"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.updated",
"type": "boolean",
"required": true,
"description": "是否已更新"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "被更新的店铺 ID"
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"moduleFolder": "shops",
"method": "shops.list",
"title": "分页查询店铺,支持 where 条件(支持字段:id, platform_code, custom_name, shop_name, status, quickWhere),兼容 snake_case 与 camelCase 入参;返回分页信息与标准化店铺列表。",
"description": "分页查询店铺,支持 where 条件(支持字段:id, platform_code, custom_name, shop_name, status, quickWhere),兼容 snake_case 与 camelCase 入参;返回分页信息与标准化店铺列表。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "page",
"type": "number",
"required": false,
"description": "页码,兼容 pagination.page/currentPage"
},
{
"name": "pageSize",
"type": "number",
"required": false,
"description": "每页大小,兼容 page_size/pagination.page_size,最大 200"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "查询条件,支持标准 where 结构或 quickWhere 简写,字段兼容 id/platform_code/custom_name/shop_name/status/quickWhere"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "调用结果标识,成功为 success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功为 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.list",
"type": "array",
"required": true,
"description": "店铺数组,元素结构见 children"
},
{
"name": "data.pagination",
"type": "object",
"required": true,
"description": "分页信息"
}
]
},
{
"moduleName": "商品模块",
"moduleKey": "stock",

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
@ -12,110 +12,73 @@
"label": "全部"
}
},
"moduleCount": 37,
"totalInterfaceCount": 261,
"moduleCount": 38,
"totalInterfaceCount": 270,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleAdded": 1,
"moduleDeleted": 0,
"moduleUpdated": 2,
"interfaceAdded": 0,
"moduleUpdated": 0,
"interfaceAdded": 5,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 4,
"interfaceResponseUpdated": 3
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
},
"moduleUpdates": {
"added": [],
"deleted": [],
"updated": [
"added": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"previousModuleName": "基础模块",
"previousModuleKey": "index",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"index.getShopList"
],
"responseUpdatedMethods": [
"index.getShopList"
]
}
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"previousModuleName": "快递接口管理模块",
"previousModuleKey": "setting.expressInterface",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"setting.expressInterface.create",
"setting.expressInterface.list",
"setting.expressInterface.update"
],
"responseUpdatedMethods": [
"setting.expressInterface.list",
"setting.expressInterface.update"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"method": "index.getShopList"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.create"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.list"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.update"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"methods": [
"shop.GetAuthorizeSessionKey",
"shops.add",
"shops.del",
"shops.edit",
"shops.list"
],
"interfaceCount": 5
}
],
"responseUpdated": [
"deleted": [],
"updated": []
},
"interfaceUpdates": {
"added": [
{
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"method": "index.getShopList"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shop.GetAuthorizeSessionKey"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.list"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.add"
},
{
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"method": "setting.expressInterface.update"
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.del"
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.edit"
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"method": "shops.list"
}
]
],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
}
},
"modules": [
@ -361,6 +324,29 @@
}
]
},
{
"moduleName": "店铺模块",
"moduleKey": "shops",
"folder": "shops",
"interfaceCount": 5,
"interfaces": [
{
"method": "shops.list"
},
{
"method": "shops.add"
},
{
"method": "shops.del"
},
{
"method": "shops.edit"
},
{
"method": "shop.GetAuthorizeSessionKey"
}
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
@ -665,7 +651,7 @@
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"interfaceCount": 18,
"interfaceCount": 21,
"interfaces": [
{
"method": "index.fastWhereTree"
@ -720,6 +706,15 @@
},
{
"method": "index.getShopExpressList"
},
{
"method": "index.getCainiaoStfTemplates"
},
{
"method": "index.getPrintPlatformTemplateList"
},
{
"method": "index.polyapiAuthorizeUrl"
}
]
},
@ -865,7 +860,7 @@
"moduleName": "快递接口管理模块",
"moduleKey": "setting.expressInterface",
"folder": "setting.expressinterface",
"interfaceCount": 5,
"interfaceCount": 6,
"interfaces": [
{
"method": "setting.expressInterface.list"
@ -881,6 +876,9 @@
},
{
"method": "setting.expressInterface.delete"
},
{
"method": "index.getPrintPlatformList"
}
]
},

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "基础模块",
"key": "index",
"folder": "index",
"interfaceCount": 18
"interfaceCount": 21
},
"changes": {
"fromPreviousSnapshot": {
@ -25,12 +25,8 @@
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"index.getShopList"
],
"responseUpdatedMethods": [
"index.getShopList"
]
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
@ -738,6 +734,133 @@
"description": "服务端按店铺所属平台拉取并统一收敛后的快递签约/电子面单可用列表;未接入的平台返回空数组。"
}
]
},
{
"method": "index.getCainiaoStfTemplates",
"title": "公共无参查询淘宝菜鸟标准模板列表;服务端调用淘宝开放平台 cainiao.cloudprint.stdtemplates.get,请求地址为 https://eco.taobao.com/router/rest,使用 TOP 公共签名参数。不需要用户授权,不下发 session,不依赖登录态、当前仓库或店铺授权。成功返回 data.platform_code='TB' 与标准模板数组,模板项统一字段为 template_id/template_name/template_url/cp_code/wp_code。",
"description": "公共无参查询淘宝菜鸟标准模板列表;服务端调用淘宝开放平台 cainiao.cloudprint.stdtemplates.get,请求地址为 https://eco.taobao.com/router/rest,使用 TOP 公共签名参数。不需要用户授权,不下发 session,不依赖登录态、当前仓库或店铺授权。成功返回 data.platform_code='TB' 与标准模板数组,模板项统一字段为 template_id/template_name/template_url/cp_code/wp_code。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "业务提示信息,成功时返回 ok。"
},
{
"name": "data.platform_code",
"type": "string",
"required": true,
"description": "平台编码,固定返回 TB。"
},
{
"name": "data.list",
"type": "array",
"required": true,
"description": "菜鸟标准模板列表;来源于 cainiao_cloudprint_stdtemplates_get_response.result.datas[*].standard_templates[*] 的宽松兼容解析结果,按统一字段 template_id/template_name/template_url/cp_code/wp_code 返回。"
}
]
},
{
"method": "index.getPrintPlatformTemplateList",
"title": "按打印平台与快递编码查询模板列表。express_code 为必填;接口会先按 platform_code(默认 CAINIAO)定位 wms_express 对应打印平台字段,再以 express_code 过滤可用模板后返回。",
"description": "按打印平台与快递编码查询模板列表。express_code 为必填;接口会先按 platform_code(默认 CAINIAO)定位 wms_express 对应打印平台字段,再以 express_code 过滤可用模板后返回。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [
{
"name": "platform_code",
"type": "string",
"required": false,
"description": "打印平台编码(如 CAINIAO);不传默认 CAINIAO,服务端会转为大写。"
},
{
"name": "express_code",
"type": "string",
"required": true,
"description": "快递编码(必填);服务端会转为大写,并用于按 wms_express 中对应打印平台字段筛选模板。"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局结果标识;成功为 success,失败为 failure。"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码;成功时为 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息;成功时为 ok。"
},
{
"name": "data",
"type": "object",
"required": true,
"description": "返回数据对象。"
}
]
},
{
"method": "index.polyapiAuthorizeUrl",
"title": "生成菠萝派授权链接。该接口不接收请求参数,服务端会固定调用 Differ.JH.BuildeAuthorizeUrl,并以内置配置 this.app.config.poloApi.appKey / this.app.config.poloApi.secret 以及当前代码中写死的 callbackUrl=http://39.100.57.68/、state=123456、itemcode=test001 作为上游请求参数,最终将菠萝派接口原始响应包裹后返回。",
"description": "生成菠萝派授权链接。该接口不接收请求参数,服务端会固定调用 Differ.JH.BuildeAuthorizeUrl,并以内置配置 this.app.config.poloApi.appKey / this.app.config.poloApi.secret 以及当前代码中写死的 callbackUrl=http://39.100.57.68/、state=123456、itemcode=test001 作为上游请求参数,最终将菠萝派接口原始响应包裹后返回。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": false,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200。"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "业务提示信息,成功时返回 ok。"
},
{
"name": "data.respone",
"type": "object",
"required": true,
"description": "菠萝派接口 Differ.JH.BuildeAuthorizeUrl 的原始响应对象。字段名按当前实现保持为 respone。"
}
]
}
]
}

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-20 08:59:09",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-09 09:52:14",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 17:23:48",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
@ -33,8 +33,8 @@
"interfaces": [
{
"method": "index.getExpressList",
"title": "合并后的快递列表",
"description": "合并后的快递列表",
"title": "获取快递列表。默认返回系统基础快递与当前登录仓库自定义快递编码的合并结果:系统快递在前,仓库自定义编码在后,同一 `code` 仅保留首条(系统同码优先保留系统记录)。当 `systemOnly` 为真值(支持 `true`、`1`、`'1'`、`'true'`)时,仅返回系统基础快递列表。仅接受 `express_code` 入参,服务端会先 trim 再转为大写:`systemOnly=true` 时按系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义编码映射记录中的系统快递编码字段 `express_code` 过滤,仅返回当前登录仓库下匹配该系统快递编码的自定义编码列表,不再回传系统基础项。仓库范围来自当前登录用户 `ctx.user.store_id`;未识别到仓库时,自定义编码列表为空。接口优先读取缓存,未命中时回源 `wms_express` 与 `wms_express_setting`。",
"description": "获取快递列表。默认返回系统基础快递与当前登录仓库自定义快递编码的合并结果:系统快递在前,仓库自定义编码在后,同一 `code` 仅保留首条(系统同码优先保留系统记录)。当 `systemOnly` 为真值(支持 `true`、`1`、`'1'`、`'true'`)时,仅返回系统基础快递列表。仅接受 `express_code` 入参,服务端会先 trim 再转为大写:`systemOnly=true` 时按系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义编码映射记录中的系统快递编码字段 `express_code` 过滤,仅返回当前登录仓库下匹配该系统快递编码的自定义编码列表,不再回传系统基础项。仓库范围来自当前登录用户 `ctx.user.store_id`;未识别到仓库时,自定义编码列表为空。接口优先读取缓存,未命中时回源 `wms_express` 与 `wms_express_setting`。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -43,8 +43,46 @@
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": []
"params": [
{
"name": "systemOnly",
"type": "boolean|number|string",
"required": false,
"description": "是否仅返回系统基础快递列表;仅 `true`、`1`、`'1'`、`'true'` 会被识别为 true,其余值按 false 处理"
},
{
"name": "express_code",
"type": "string",
"required": false,
"description": "系统快递编码;服务端会去首尾空格并转为大写。`systemOnly=true` 时按该系统快递编码过滤系统基础快递列表;`systemOnly=false` 时按自定义映射记录中的系统快递编码字段 `express_code` 过滤当前仓库的自定义编码列表,而不是按自定义 `code` 过滤"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功时为 `success`"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回消息,成功时通常为 `ok`"
},
{
"name": "data",
"type": "array",
"required": true,
"description": "快递列表数组。默认模式下先返回系统基础快递,再追加当前仓库自定义编码;当传入 `express_code` 且 `systemOnly=false` 时,仅返回当前仓库下系统快递编码等于该 `express_code` 的自定义映射记录,不返回系统基础项。每项字段如下:"
}
]
},
{
"method": "setting.express.list",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "快递接口管理模块",
"key": "setting.expressInterface",
"folder": "setting.expressinterface",
"interfaceCount": 5
"interfaceCount": 6
},
"changes": {
"fromPreviousSnapshot": {
@ -25,15 +25,8 @@
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [
"setting.expressInterface.create",
"setting.expressInterface.list",
"setting.expressInterface.update"
],
"responseUpdatedMethods": [
"setting.expressInterface.list",
"setting.expressInterface.update"
]
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
@ -283,6 +276,46 @@
"description": "是否已删除,成功时为 true"
}
]
},
{
"method": "index.getPrintPlatformList",
"title": "获取打印平台全量列表。供前端新增、修改快递接口时下拉选择使用;仅返回未删除且状态为 `ACTIVE` 的打印平台,不分页,按 `platform_name` 升序、`id` 升序返回。接口不校验额外鉴权或权限点,但需要登录态。",
"description": "获取打印平台全量列表。供前端新增、修改快递接口时下拉选择使用;仅返回未删除且状态为 `ACTIVE` 的打印平台,不分页,按 `platform_name` 升序、`id` 升序返回。接口不校验额外鉴权或权限点,但需要登录态。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功时为 `success`"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功时返回 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回消息,成功时通常为 `ok`"
},
{
"name": "data",
"type": "array",
"required": true,
"description": "打印平台列表数组,不分页,仅包含未删除且状态为 `ACTIVE` 的平台;按 `platform_name` 升序、`id` 升序返回。每项字段如下:"
}
]
}
]
}

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -0,0 +1,12 @@
{
"module": {
"name": "店铺模块",
"key": "shops",
"folder": "shops"
},
"status": "active",
"createdAt": "2026-05-25 17:05:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -0,0 +1,401 @@
{
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "店铺模块",
"key": "shops",
"folder": "shops",
"interfaceCount": 5
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": true,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [
"shop.GetAuthorizeSessionKey",
"shops.add",
"shops.del",
"shops.edit",
"shops.list"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "shops.list",
"title": "分页查询店铺,支持 where 条件(支持字段:id, platform_code, custom_name, shop_name, status, quickWhere),兼容 snake_case 与 camelCase 入参;返回分页信息与标准化店铺列表。",
"description": "分页查询店铺,支持 where 条件(支持字段:id, platform_code, custom_name, shop_name, status, quickWhere),兼容 snake_case 与 camelCase 入参;返回分页信息与标准化店铺列表。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "page",
"type": "number",
"required": false,
"description": "页码,兼容 pagination.page/currentPage"
},
{
"name": "pageSize",
"type": "number",
"required": false,
"description": "每页大小,兼容 page_size/pagination.page_size,最大 200"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "查询条件,支持标准 where 结构或 quickWhere 简写,字段兼容 id/platform_code/custom_name/shop_name/status/quickWhere"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "调用结果标识,成功为 success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,成功为 200"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.list",
"type": "array",
"required": true,
"description": "店铺数组,元素结构见 children"
},
{
"name": "data.pagination",
"type": "object",
"required": true,
"description": "分页信息"
}
]
},
{
"method": "shops.add",
"title": "新增店铺,校验 platform_code 必须匹配已配置且处于 ACTIVE 且未删除的打印平台;custom_name 必填且长度<=100;shop_name 可选,缺失时使用 custom_name。支持 snake_case 与 camelCase 入参兼容。",
"description": "新增店铺,校验 platform_code 必须匹配已配置且处于 ACTIVE 且未删除的打印平台;custom_name 必填且长度<=100;shop_name 可选,缺失时使用 custom_name。支持 snake_case 与 camelCase 入参兼容。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "platform_code",
"type": "string",
"required": true,
"description": "平台编码,兼容 platformCode,服务端会标准化为大写并验证"
},
{
"name": "custom_name",
"type": "string",
"required": true,
"description": "店铺自定义名称,最大长度 100"
},
{
"name": "shop_name",
"type": "string",
"required": false,
"description": "店铺名称,若不传则以 custom_name 作为 shop_name"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "新建店铺 ID"
}
]
},
{
"method": "shops.del",
"title": "软删除店铺:将 shop_name 修改为 DELETED_SHOP_<id>_<suffix> 并清空敏感字段;若存在 ExpressInterface 引用则返回 409;返回 deleted=true 与 id。",
"description": "软删除店铺:将 shop_name 修改为 DELETED_SHOP_<id>_<suffix> 并清空敏感字段;若存在 ExpressInterface 引用则返回 409;返回 deleted=true 与 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,兼容 shop_id/shopId"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.deleted",
"type": "boolean",
"required": true,
"description": "是否已删除"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "删除的店铺 ID"
}
]
},
{
"method": "shops.edit",
"title": "编辑店铺,仅允许修改 platform_code 或 custom_name;至少传入其中一个。platform_code 会校验平台存在且为 ACTIVE;custom_name 必填且长度<=100;服务端兼容 snake_case/camelCase。",
"description": "编辑店铺,仅允许修改 platform_code 或 custom_name;至少传入其中一个。platform_code 会校验平台存在且为 ACTIVE;custom_name 必填且长度<=100;服务端兼容 snake_case/camelCase。",
"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,兼容 shop_id/shopId"
},
{
"name": "platform_code",
"type": "string",
"required": false,
"description": "平台编码,兼容 platformCode,服务端会转为大写并校验"
},
{
"name": "custom_name",
"type": "string",
"required": false,
"description": "自定义名称,兼容 customName,若传入需非空且 <=100 字符"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.updated",
"type": "boolean",
"required": true,
"description": "是否已更新"
},
{
"name": "data.id",
"type": "number",
"required": true,
"description": "被更新的店铺 ID"
}
]
},
{
"method": "shop.GetAuthorizeSessionKey",
"title": "按店铺所属平台生成授权会话。入参兼容 id/shop_id/shopId 与 callbackurl/callback_url,callbackurl 必填。对已实现的平台(PDD/CAINIAO)返回 session_key/authorize_url/state,其他平台返回 501 未实现。",
"description": "按店铺所属平台生成授权会话。入参兼容 id/shop_id/shopId 与 callbackurl/callback_url,callbackurl 必填。对已实现的平台(PDD/CAINIAO)返回 session_key/authorize_url/state,其他平台返回 501 未实现。",
"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,兼容 shop_id/shopId"
},
{
"name": "callbackurl",
"type": "string",
"required": true,
"description": "回调地址,兼容 callback_url"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "200 成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息"
},
{
"name": "data.shop_id",
"type": "number",
"required": true,
"description": "店铺 ID"
},
{
"name": "data.platform_code",
"type": "string",
"required": true,
"description": "平台编码(大写)"
},
{
"name": "data.callbackurl",
"type": "string",
"required": true,
"description": "回调地址"
},
{
"name": "data.session_key",
"type": "string",
"required": true,
"description": "授权预占码(session)"
},
{
"name": "data.authorize_url",
"type": "string",
"required": true,
"description": "平台授权跳转地址(含 state)"
},
{
"name": "data.state",
"type": "string",
"required": true,
"description": "内部 state 值(platform + '_' + authRandomCode),用于回调解析"
}
]
}
]
}

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-15 17:32:36",
"updatedAt": "2026-05-23 09:07:16",
"updatedAt": "2026-05-25 17:05:16",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

View File

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

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-23 09:07:16",
"generatedAtLocal": "2026-05-23 09:07:16",
"generatedAt": "2026-05-25 17:05:16",
"generatedAtLocal": "2026-05-25 17:05:16",
"source": "remote",
"filter": {
"platform": {

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