3506 lines
96 KiB
YAML
3506 lines
96 KiB
YAML
openapi: 3.0.3
|
||
info:
|
||
title: 采购样品履约节点 API
|
||
version: 1.0.0
|
||
description: 客户范围、节点资格、版本与幂等由服务端校验；购买事实与资金结果分开保存。
|
||
security:
|
||
- bearerAuth: []
|
||
paths:
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fulfillment:
|
||
get:
|
||
summary: 读取采购履约与货款结果
|
||
description: 权限 platform:overseas-business:purchase:list；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/purchase:
|
||
post:
|
||
summary: 登记真实购买并核定样品货款
|
||
description: 权限 platform:overseas-business:purchase:buy；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Purchase'
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/purchase/confirm:
|
||
post:
|
||
summary: 补齐授权或汇率后核定原购买
|
||
description: 权限 platform:overseas-business:purchase:buy；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/budget-authorizations:
|
||
post:
|
||
summary: 核验客户预算上限授权
|
||
description: 权限 platform:overseas-business:purchase:review；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Budget'
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/planned-warehouse:
|
||
post:
|
||
summary: 首次实收前选择计划采购仓
|
||
description: 权限 platform:overseas-business:purchase:review；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Warehouse'
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/cancel:
|
||
post:
|
||
summary: 购买前取消采购订单
|
||
description: 权限 platform:overseas-business:purchase:cancel；平台主体。真实已发生的购买超预算或缺汇率时保留事实并返回 purchase.issue，不伪造扣款成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查 code；成功不等于资金已扣款
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Response'
|
||
'401':
|
||
description: 未认证
|
||
'403':
|
||
description: 主体或动作权限不允许
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/physical:
|
||
get:
|
||
summary: 查询采购实收与当前装箱版本
|
||
description: 权限 platform:overseas-business:purchase:list；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/overseas-receipts:
|
||
post:
|
||
summary: 登记海外分次实收
|
||
description: 权限 platform:overseas-business:purchase:receive-overseas；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Receipt'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/domestic-receipts:
|
||
post:
|
||
summary: 按原交寄箱登记国内实收
|
||
description: 权限 platform:overseas-business:purchase:receive-domestic；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Receipt'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/overseas-receipts/complete:
|
||
post:
|
||
summary: 确认海外收货完成
|
||
description: 权限 platform:overseas-business:purchase:receive-overseas；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FinishReceipt'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/domestic-receipts/complete:
|
||
post:
|
||
summary: 确认国内收货完成
|
||
description: 权限 platform:overseas-business:purchase:receive-domestic；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FinishReceipt'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/dispositions:
|
||
post:
|
||
summary: 确认单内差异处置
|
||
description: 权限 platform:overseas-business:purchase:manage；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Disposition'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/packing:
|
||
post:
|
||
summary: 保存新的装箱清单版本
|
||
description: 权限 platform:overseas-business:purchase:pack；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Packing'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/packing/confirm:
|
||
post:
|
||
summary: 确认整批装箱
|
||
description: 权限 platform:overseas-business:purchase:pack；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ConfirmPacking'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/packing/withdraw:
|
||
post:
|
||
summary: 撤回尚未交寄的确认清单
|
||
description: 权限 platform:overseas-business:purchase:manage；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/receipts/{receiptId}/correct:
|
||
post:
|
||
summary: 保留原记录并受控更正实收
|
||
description: 权限 platform:overseas-business:purchase:manage；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: receiptId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Correction'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/dispositions/{dispositionId}/revoke:
|
||
post:
|
||
summary: 凭证支持的差异处置更正
|
||
description: 权限 platform:overseas-business:purchase:manage；平台身份、订单范围、版本、幂等及节点准入均由服务端复验。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: dispositionId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 检查业务code；返回最新采购实收及装箱快照
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/PhysicalResponse'
|
||
'403':
|
||
description: 无动作权限
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/RevokeDisposition'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/transport:
|
||
get:
|
||
summary: 读取两段面单及实际交寄事实
|
||
description: 权限 platform:overseas-business:purchase:list。平台内部资料，不直接对客输出。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/labels:
|
||
post:
|
||
summary: 保存本段全批面单新版本
|
||
description: 权限 platform:overseas-business:purchase:label。清单、文件、页码与全部可寄原箱关联；国际寄件取实际仓主档。国内改最终收件信息须有本单EXCEPTION客户确认凭证。新版本不沿用旧贴单。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Labels'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/international-estimate:
|
||
post:
|
||
summary: 核对国际预估并申请冻结或释放
|
||
description: 权限 platform:overseas-business:purchase:estimate。仅CNY。同金额可显式沿用原FROZEN/ZERO；变价先申请释放，等待成功后以新请求确认新金额，未决不得交寄。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Estimate'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/labels/apply:
|
||
post:
|
||
summary: 逐箱登记真实贴单
|
||
description: 权限 platform:overseas-business:purchase:apply-label。仅海外段；可以分次贴单，不能重复记录相同版本相同箱。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ApplyLabels'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/domestic-repack:
|
||
post:
|
||
summary: 国内原箱一对一换包装
|
||
description: 权限 platform:overseas-business:purchase:receive-domestic。不改变来源及件数，不拆箱合箱；使旧国内面单失效，并要求重新核对国内费用。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Repack'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/overseas-shipment:
|
||
post:
|
||
summary: 确认整批海外实际交寄
|
||
description: 权限 platform:overseas-business:purchase:ship-overseas。leg固定OVERSEAS；全部箱、当前面单、逐箱贴单、样品实扣关联、唯一有效预估均须通过。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Ship'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/customer-shipment:
|
||
post:
|
||
summary: 确认整批国内寄客户
|
||
description: 权限 platform:overseas-business:purchase:ship-customer。leg固定DOMESTIC；核费及全部资金完成才可交寄。每单每段最多一次，重复不同请求不能再发货。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code；资金处理中不代表已完成
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/TransportResponse'
|
||
'400':
|
||
description: 字段、来源或数量不合法
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、重复发运或节点尚未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Ship'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/files/{category}:
|
||
post:
|
||
summary: 上传采购内部附件
|
||
description: 按类别独立授权：PURCHASE=buy；BUDGET=review；LABEL=label；EXCEPTION=manage；RECEIPT=receive-overseas或receive-domestic；VOUCHER=charge或finance-adjust。新增四类只允许PDF/JPG/PNG，最大10MiB。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: category
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
enum:
|
||
- RECEIPT
|
||
- VOUCHER
|
||
- LABEL
|
||
- PURCHASE
|
||
- BUDGET
|
||
- EXCEPTION
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
multipart/form-data:
|
||
schema:
|
||
type: object
|
||
required:
|
||
- file
|
||
properties:
|
||
file:
|
||
type: string
|
||
format: binary
|
||
responses:
|
||
'200':
|
||
description: 本单附件元数据业务响应
|
||
'403':
|
||
description: 主体或类别权限不足
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/files/{fileId}/content:
|
||
get:
|
||
summary: 读取本采购单内部文件
|
||
description: 权限 platform:overseas-business:purchase:list；校验客户、订单、分类与文件归属。附件下载，Cache-Control no-store。客户入口不开放这些内部文件。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: fileId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 文件内容
|
||
content:
|
||
application/octet-stream:
|
||
schema:
|
||
type: string
|
||
format: binary
|
||
'400':
|
||
description: 文件不属于本单
|
||
'403':
|
||
description: 无平台采购只读权限
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/charges:
|
||
get:
|
||
summary: 读取核费与资金处理结果
|
||
description: 权限 platform:overseas-business:purchase:list。仅平台使用，内部费用及诊断字段不得直接透传客户。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ChargesResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fee-corrections:
|
||
get:
|
||
summary: 读取费用链更正历史
|
||
description: 权限 platform:overseas-business:purchase:list。不可变目标、原汇率、确认时净额及产生的逐笔差额或退款业务号。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FeeCorrectionsResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/charges/confirm:
|
||
post:
|
||
summary: 确认国内整单费用
|
||
description: 权限 platform:overseas-business:purchase:charge。须国内实收完成。三项固定费用明确核定，其他不适用不产生虚构收费行；重核引用原feeId不再次扣款，不可省略已有有效实际费用。确认不等于资金成功。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ChargesResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ConfirmCharges'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/retry:
|
||
post:
|
||
summary: 重试已明确失败的费用请求
|
||
description: 样品货款要求buy，预估要求estimate，实际国际运费/关税/国内运费/其他要求charge，调整/退款要求finance-adjust；未知结果拒绝新请求，已冻结仅重试结算。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ChargesResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/terminate:
|
||
post:
|
||
summary: 终止明确失败的费用版本
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。终止旧版本重试资格；有效冻结必须释放成功后才可替代，重新核对整单费用。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ChargesResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/correct-target:
|
||
post:
|
||
summary: 按正确原币总额更正费用链
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。选择原实际费用根。沿用原汇率计算正确CNY总额，以成功原扣+成功差额-成功退款求净额；正差额新扣、负差额逐笔关联退款，未决旧调整阻断。CNY差额单自身汇率为1，目标原币汇率保留在更正快照，不因分差反推原币。已寄客户不回退履约。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FeeCorrectionResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/CorrectFeeTarget'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/additional:
|
||
post:
|
||
summary: 登记独立新发生费用
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。仅已发生购买订单；按新费用真实业务日冻结汇率，以独立费用号发起扣款，核定入口为 FINANCIAL。保留原费用；普通核费首次确认后只引用已有版本。未交寄订单需重新核费，已交寄事实不回退。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FeeVersionResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/AdditionalFee'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/replace-failed:
|
||
post:
|
||
summary: 重新核定已终止且未实扣的实际费用
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。仅允许最新原实际费用已明确失败、终止重试且有效冻结已释放后替代；拒绝已实扣、未决或已有后续版本。沿用原币、业务日和汇率快照，使用新资金业务身份；货款仍核验客户预算。以更正记录关联旧版本与新实际费用，零元不发起资金请求。原购买与履约事实不回退。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FeeCorrectionResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/CorrectFeeTarget'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/refund:
|
||
post:
|
||
summary: 关联原实扣退回客户钱包
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。amount为正额CNY。仅本单已结算消费可退；整链有未完成调整/退款时不接受新请求，重放原请求仍返回原退款。累计金额由Finance原子封顶，不走外部支付。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 业务结果，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/FeeVersionResponse'
|
||
'400':
|
||
description: 参数或本单费用归属错误
|
||
'403':
|
||
description: 主体或动作权限不足
|
||
'409':
|
||
description: 版本冲突、原请求未决或节点未满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/RefundFee'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/controls:
|
||
get:
|
||
summary: 读取异常、更正与剩余货物来源
|
||
description: 权限 platform:overseas-business:purchase:list。内部记录，剩余来源用于逐项填写最终去向。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/control-notes:
|
||
post:
|
||
summary: 追加事实更正说明或阻断异常
|
||
description: 权限 platform:overseas-business:purchase:manage。校验本单事实和EXCEPTION凭证；已交寄允许追加说明，不改原货物、运单或状态。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlNote'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/control-notes/{noteId}/resolve:
|
||
post:
|
||
summary: 有凭证解除采购阻断异常
|
||
description: 权限 platform:overseas-business:purchase:manage。不覆盖原说明，记录处理人和证据；不改变资金结果。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: noteId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ResolveControl'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/actual-warehouse/correct:
|
||
post:
|
||
summary: 受控更正实际收货仓
|
||
description: 权限 platform:overseas-business:purchase:manage。未有后续箱明细时更新有效实际仓并留原快照及原实收；已有后续实物或已结束时仅追加阻断说明，不重归属货物。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/CorrectWarehouse'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/exception-close:
|
||
post:
|
||
summary: 实物资金收口后异常关闭
|
||
description: 权限 platform:overseas-business:purchase:manage。购买后逐来源核平剩余货物最终去向，并提供客户停止履约证据、财务结论及对客摘要。全部已知资金与费用来源处理结束且无阻断异常才可关闭；不退款、不生成退货或零数量发运。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ControlResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ExceptionClose'
|
||
/api/platform/v1/last-leg/overseas-procurements/{orderNo}/fees/{feeId}/release-estimate:
|
||
post:
|
||
summary: 释放不再使用的预估冻结
|
||
description: 权限 platform:overseas-business:purchase:finance-adjust。只作用于本单有效预估；未决或已实际结算不允许释放。供异常处理使用，不能将实际消费当冻结释放。
|
||
parameters:
|
||
- name: orderNo
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
- name: customerId
|
||
in: query
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- name: feeId
|
||
in: path
|
||
required: true
|
||
schema:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
responses:
|
||
'200':
|
||
description: 统一业务响应，须检查code
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/ChargesResponse'
|
||
'400':
|
||
description: 来源、证据或数量不匹配
|
||
'403':
|
||
description: 无当前操作权限
|
||
'409':
|
||
description: 版本、实物或资金前置不满足
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/json:
|
||
schema:
|
||
$ref: '#/components/schemas/Command'
|
||
components:
|
||
securitySchemes:
|
||
bearerAuth:
|
||
type: http
|
||
scheme: bearer
|
||
bearerFormat: JWT
|
||
schemas:
|
||
Command:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
Purchase:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- productName
|
||
- quantity
|
||
- amount
|
||
- currency
|
||
- purchasedAt
|
||
- estimatedArrivalAt
|
||
- voucherFileId
|
||
properties:
|
||
productName:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 255
|
||
specification:
|
||
type: string
|
||
nullable: true
|
||
maxLength: 500
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
currency:
|
||
type: string
|
||
enum:
|
||
- CNY
|
||
- USD
|
||
purchasedAt:
|
||
type: string
|
||
format: date-time
|
||
description: 真实购买时间，不得在未来
|
||
estimatedArrivalAt:
|
||
type: string
|
||
format: date-time
|
||
voucherFileId:
|
||
type: string
|
||
description: 必须属于本订单的购买或费用凭证
|
||
Budget:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- amount
|
||
- currency
|
||
- voucherFileId
|
||
properties:
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
description: 新授权货款总上限
|
||
currency:
|
||
type: string
|
||
enum:
|
||
- CNY
|
||
- USD
|
||
voucherFileId:
|
||
type: string
|
||
description: 本订单客户书面或聊天确认凭证
|
||
Warehouse:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- warehouseId
|
||
properties:
|
||
warehouseId:
|
||
type: string
|
||
description: 国内权威目录的有效公共海外收货仓引用
|
||
Response:
|
||
type: object
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
type: object
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
status:
|
||
type: string
|
||
purchase:
|
||
type: object
|
||
properties:
|
||
recorded:
|
||
type: boolean
|
||
confirmed:
|
||
type: boolean
|
||
description: 货款已核定，不代表已扣款
|
||
issue:
|
||
type: string
|
||
nullable: true
|
||
feeNo:
|
||
type: string
|
||
nullable: true
|
||
walletStatus:
|
||
type: string
|
||
nullable: true
|
||
sourceLinked:
|
||
type: boolean
|
||
description: 已实扣费用成功入池关联或明确免费
|
||
Receipt:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- leg
|
||
- receivedAt
|
||
properties:
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
warehouseId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
description: 海外段必填的实际公共收货仓，国内为空
|
||
sourceCartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
description: 国内段必填的本单原国际交寄箱，海外为空
|
||
goodQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
damagedQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
extraQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
receivedAt:
|
||
type: string
|
||
format: date-time
|
||
FinishReceipt:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- leg
|
||
properties:
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
Disposition:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- leg
|
||
- kind
|
||
- quantity
|
||
- decision
|
||
- voucherFileId
|
||
properties:
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
sourceCartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
receiptId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
kind:
|
||
type: string
|
||
enum:
|
||
- SHORTAGE
|
||
- DAMAGED
|
||
- EXTRA
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
decision:
|
||
type: string
|
||
enum:
|
||
- ACCEPT_SHORTAGE
|
||
- DISPOSE_DAMAGED
|
||
- RETURN_EXTRA
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
Source:
|
||
type: object
|
||
required:
|
||
- receiptId
|
||
- quantity
|
||
properties:
|
||
receiptId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
Carton:
|
||
type: object
|
||
required:
|
||
- cartonNo
|
||
- lengthCm
|
||
- widthCm
|
||
- heightCm
|
||
- grossWeightKg
|
||
- sources
|
||
properties:
|
||
cartonNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
lengthCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
widthCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
heightCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
grossWeightKg:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.001
|
||
sources:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
$ref: '#/components/schemas/Source'
|
||
Packing:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- cartons
|
||
properties:
|
||
cartons:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
$ref: '#/components/schemas/Carton'
|
||
ConfirmPacking:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- packingVersion
|
||
properties:
|
||
packingVersion:
|
||
type: integer
|
||
minimum: 1
|
||
Correction:
|
||
type: object
|
||
required:
|
||
- receipt
|
||
- voucherFileId
|
||
properties:
|
||
receipt:
|
||
$ref: '#/components/schemas/Receipt'
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
RevokeDisposition:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Command'
|
||
- type: object
|
||
required:
|
||
- voucherFileId
|
||
properties:
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
PhysicalResponse:
|
||
type: object
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
type: object
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
packingVersion:
|
||
type: integer
|
||
nullable: true
|
||
packingStatus:
|
||
type: string
|
||
nullable: true
|
||
enum:
|
||
- DRAFT
|
||
- CONFIRMED
|
||
- SUPERSEDED
|
||
receipts:
|
||
type: array
|
||
items:
|
||
type: object
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
receiptNo:
|
||
type: string
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
sourceCartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
goodQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
damagedQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
extraQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
receivedAt:
|
||
type: string
|
||
format: date-time
|
||
active:
|
||
type: boolean
|
||
dispositions:
|
||
type: array
|
||
description: 平台处置历史，active=0为已撤销记录；不直接对客输出内部依据
|
||
items:
|
||
type: object
|
||
cartons:
|
||
type: array
|
||
items:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Carton'
|
||
- type: object
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
PostalAddress:
|
||
type: object
|
||
required:
|
||
- name
|
||
- phone
|
||
- address
|
||
properties:
|
||
name:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
phone:
|
||
type: string
|
||
pattern: ^[+0-9 ()-]{5,64}$
|
||
address:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
Label:
|
||
type: object
|
||
required:
|
||
- cartonId
|
||
- fileId
|
||
- page
|
||
- carrier
|
||
- trackingNo
|
||
properties:
|
||
cartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
fileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
page:
|
||
type: integer
|
||
minimum: 1
|
||
carrier:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
trackingNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
Labels:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- leg
|
||
- packingVersion
|
||
- receiver
|
||
- labels
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
packingVersion:
|
||
type: integer
|
||
minimum: 1
|
||
receiver:
|
||
$ref: '#/components/schemas/PostalAddress'
|
||
addressVoucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
labels:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
$ref: '#/components/schemas/Label'
|
||
Estimate:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- labelVersion
|
||
- amount
|
||
- businessDate
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
labelVersion:
|
||
type: integer
|
||
minimum: 1
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
businessDate:
|
||
type: string
|
||
format: date
|
||
ApplyLabels:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- labelVersion
|
||
- cartonIds
|
||
- appliedAt
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
labelVersion:
|
||
type: integer
|
||
minimum: 1
|
||
cartonIds:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
uniqueItems: true
|
||
appliedAt:
|
||
type: string
|
||
format: date-time
|
||
Ship:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- leg
|
||
- labelVersion
|
||
- cartonIds
|
||
- shippedAt
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
labelVersion:
|
||
type: integer
|
||
minimum: 1
|
||
cartonIds:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
uniqueItems: true
|
||
shippedAt:
|
||
type: string
|
||
format: date-time
|
||
Repack:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- cartonId
|
||
- lengthCm
|
||
- widthCm
|
||
- heightCm
|
||
- grossWeightKg
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
cartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
lengthCm:
|
||
type: number
|
||
exclusiveMinimum: true
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
widthCm:
|
||
type: number
|
||
exclusiveMinimum: true
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
heightCm:
|
||
type: number
|
||
exclusiveMinimum: true
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
grossWeightKg:
|
||
type: number
|
||
exclusiveMinimum: true
|
||
minimum: 0
|
||
multipleOf: 0.001
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
LabelRow:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Label'
|
||
- type: object
|
||
required:
|
||
- appliedAt
|
||
properties:
|
||
appliedAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
LabelSet:
|
||
type: object
|
||
required:
|
||
- id
|
||
- version
|
||
- manifestId
|
||
- cargoHash
|
||
- sender
|
||
- receiver
|
||
- labels
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
version:
|
||
type: integer
|
||
manifestId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
cargoHash:
|
||
type: string
|
||
sender:
|
||
$ref: '#/components/schemas/PostalAddress'
|
||
receiver:
|
||
$ref: '#/components/schemas/PostalAddress'
|
||
labels:
|
||
type: array
|
||
minItems: 1
|
||
items:
|
||
$ref: '#/components/schemas/LabelRow'
|
||
TransportCargo:
|
||
type: object
|
||
required: [cartonId, cartonNo, quantity, lengthCm, widthCm, heightCm, grossWeightKg, packagingRecordId, sources]
|
||
properties:
|
||
cartonId:
|
||
type: string
|
||
pattern: '^[1-9][0-9]*$'
|
||
cartonNo:
|
||
type: string
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
lengthCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
widthCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
heightCm:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
grossWeightKg:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.001
|
||
packagingRecordId:
|
||
type: string
|
||
nullable: true
|
||
sources:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/Source'
|
||
TransportResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
type: object
|
||
required:
|
||
- orderNo
|
||
- version
|
||
- status
|
||
- overseasLabels
|
||
- domesticLabels
|
||
- overseasCargo
|
||
- domesticCargo
|
||
- shipments
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
overseasCargo:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/TransportCargo'
|
||
domesticCargo:
|
||
type: array
|
||
description: 国内有效合格实收及最新一对一换包装箱规，不包含已处置的破损或多货
|
||
items:
|
||
$ref: '#/components/schemas/TransportCargo'
|
||
overseasLabels:
|
||
allOf:
|
||
- $ref: '#/components/schemas/LabelSet'
|
||
nullable: true
|
||
domesticLabels:
|
||
allOf:
|
||
- $ref: '#/components/schemas/LabelSet'
|
||
nullable: true
|
||
shipments:
|
||
type: array
|
||
items:
|
||
type: object
|
||
required:
|
||
- id
|
||
- shipmentNo
|
||
- leg
|
||
- shippedAt
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: '^[1-9][0-9]*$'
|
||
shipmentNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
shippedAt:
|
||
type: string
|
||
format: date-time
|
||
ChargeAmount:
|
||
type: object
|
||
required:
|
||
- determination
|
||
- amount
|
||
- currency
|
||
- businessDate
|
||
- reason
|
||
properties:
|
||
determination:
|
||
type: string
|
||
enum:
|
||
- POSITIVE
|
||
- ZERO
|
||
- NOT_APPLICABLE
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
currency:
|
||
type: string
|
||
enum:
|
||
- CNY
|
||
- USD
|
||
businessDate:
|
||
type: string
|
||
format: date
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
ChargeSelection:
|
||
type: object
|
||
required: []
|
||
properties:
|
||
feeId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
value:
|
||
allOf:
|
||
- $ref: '#/components/schemas/ChargeAmount'
|
||
nullable: true
|
||
description: feeId与value恰有一个。引用本单同用途有效费用用于重新核对，不产生新扣款；新核定用value，未知不能当零元。
|
||
oneOf:
|
||
- required:
|
||
- feeId
|
||
properties:
|
||
value:
|
||
type: object
|
||
nullable: true
|
||
enum:
|
||
- null
|
||
feeId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
- required:
|
||
- value
|
||
properties:
|
||
feeId:
|
||
type: string
|
||
nullable: true
|
||
enum:
|
||
- null
|
||
value:
|
||
$ref: '#/components/schemas/ChargeAmount'
|
||
OtherCharge:
|
||
type: object
|
||
required:
|
||
- code
|
||
- name
|
||
- selection
|
||
properties:
|
||
code:
|
||
type: string
|
||
pattern: ^[A-Z][A-Z0-9_]{0,31}$
|
||
name:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
selection:
|
||
$ref: '#/components/schemas/ChargeSelection'
|
||
ConfirmCharges:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- internationalFreight
|
||
- duty
|
||
- domesticFreight
|
||
- otherDetermination
|
||
- otherFees
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
internationalFreight:
|
||
$ref: '#/components/schemas/ChargeSelection'
|
||
duty:
|
||
$ref: '#/components/schemas/ChargeSelection'
|
||
domesticFreight:
|
||
$ref: '#/components/schemas/ChargeSelection'
|
||
otherDetermination:
|
||
type: string
|
||
enum:
|
||
- NOT_APPLICABLE
|
||
- ITEMIZED
|
||
otherFees:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/OtherCharge'
|
||
AdditionalFee:
|
||
type: object
|
||
additionalProperties: false
|
||
required: [version, idempotencyKey, name, amount, currency, businessDate, voucherFileId, reason]
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
name:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
exclusiveMinimum: true
|
||
multipleOf: 0.01
|
||
description: 正额原币金额，原币及折算 CNY 均须在费用来源容量内（最多14位整数）。
|
||
currency:
|
||
type: string
|
||
enum: [CNY, USD]
|
||
businessDate:
|
||
type: string
|
||
format: date
|
||
description: 已发生费用的实际业务日期，不允许未来日期。
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
CorrectFeeTarget:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- targetOriginalAmount
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
targetOriginalAmount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
RefundFee:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- amount
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
exclusiveMinimum: true
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
ProcurementFeeVersion:
|
||
type: object
|
||
required:
|
||
- id
|
||
- feeNo
|
||
- purpose
|
||
- amount
|
||
- walletStatus
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
feeNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
purpose:
|
||
type: string
|
||
enum:
|
||
- SAMPLE_PAYMENT
|
||
- INTERNATIONAL_ESTIMATE
|
||
- INTERNATIONAL_FREIGHT
|
||
- DUTY
|
||
- DOMESTIC_FREIGHT
|
||
- OTHER
|
||
- ADJUSTMENT
|
||
- REFUND
|
||
confirmationOrigin:
|
||
type: string
|
||
enum: [BUSINESS, FINANCIAL]
|
||
description: 核定入口决定重试权限；客户响应不包含此字段。
|
||
feeVersion:
|
||
type: integer
|
||
active:
|
||
type: boolean
|
||
determination:
|
||
type: string
|
||
feeItemCode:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
feeItemName:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
amount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
currency:
|
||
type: string
|
||
enum:
|
||
- CNY
|
||
originalCurrency:
|
||
type: string
|
||
enum:
|
||
- CNY
|
||
- USD
|
||
originalAmount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
exchangeRate:
|
||
type: number
|
||
exchangeRateMonth:
|
||
type: string
|
||
businessDate:
|
||
type: string
|
||
format: date
|
||
parentFeeId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
walletStatus:
|
||
type: string
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
remark:
|
||
type: string
|
||
nullable: true
|
||
ChargesSnapshot:
|
||
type: object
|
||
required:
|
||
- orderNo
|
||
- version
|
||
- status
|
||
- confirmedAt
|
||
- fees
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
confirmedAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
fees:
|
||
type: array
|
||
items:
|
||
type: object
|
||
required:
|
||
- detail
|
||
- sourceLinked
|
||
properties:
|
||
detail:
|
||
$ref: '#/components/schemas/ProcurementFeeVersion'
|
||
sourceLinked:
|
||
type: boolean
|
||
FeeCorrectionResult:
|
||
type: object
|
||
required:
|
||
- correctionNo
|
||
- rootFeeNo
|
||
- targetOriginalAmount
|
||
- originalCurrency
|
||
- exchangeRate
|
||
- exchangeRateMonth
|
||
- targetAmount
|
||
- previousNetAmount
|
||
- differenceAmount
|
||
- feeNos
|
||
properties:
|
||
correctionNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
rootFeeNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
targetOriginalAmount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
originalCurrency:
|
||
type: string
|
||
exchangeRate:
|
||
type: number
|
||
exchangeRateMonth:
|
||
type: string
|
||
targetAmount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
previousNetAmount:
|
||
type: number
|
||
minimum: 0
|
||
multipleOf: 0.01
|
||
differenceAmount:
|
||
type: number
|
||
multipleOf: 0.01
|
||
feeNos:
|
||
type: array
|
||
items:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
ChargesResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/ChargesSnapshot'
|
||
FeeCorrectionResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/FeeCorrectionResult'
|
||
FeeCorrectionsResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/FeeCorrectionResult'
|
||
FeeVersionResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/ProcurementFeeVersion'
|
||
ControlNote:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- targetType
|
||
- blocking
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
targetType:
|
||
type: string
|
||
enum:
|
||
- PURCHASE
|
||
- WAREHOUSE
|
||
- RECEIPT
|
||
- SHIPMENT
|
||
targetId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
blocking:
|
||
type: boolean
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
clientSummary:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
nullable: true
|
||
ResolveControl:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
CorrectWarehouse:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- warehouseId
|
||
- voucherFileId
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
warehouseId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
CloseResolution:
|
||
type: object
|
||
required:
|
||
- kind
|
||
- quantity
|
||
- decision
|
||
- destination
|
||
- voucherFileId
|
||
properties:
|
||
kind:
|
||
type: string
|
||
enum:
|
||
- PURCHASE_REMAINDER
|
||
- TRANSIT_REMAINDER
|
||
- GOOD
|
||
- DAMAGED
|
||
- EXTRA
|
||
sourceId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
decision:
|
||
type: string
|
||
enum:
|
||
- SUPPLIER_RETAINED
|
||
- RETURNED_TO_SUPPLIER
|
||
- RETURNED_TO_SENDER
|
||
- LOSS_CONFIRMED
|
||
- CUSTOMER_AUTHORIZED_RETENTION
|
||
- DISPOSED
|
||
destination:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
voucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
ExceptionClose:
|
||
type: object
|
||
required:
|
||
- version
|
||
- idempotencyKey
|
||
- reason
|
||
- resolutions
|
||
- customerVoucherFileId
|
||
- financialConclusion
|
||
- clientSummary
|
||
properties:
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
idempotencyKey:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
reason:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
resolutions:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/CloseResolution'
|
||
customerVoucherFileId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
financialConclusion:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 1000
|
||
clientSummary:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 500
|
||
ControlRemaining:
|
||
type: object
|
||
required:
|
||
- kind
|
||
- sourceId
|
||
- businessNo
|
||
- quantity
|
||
properties:
|
||
kind:
|
||
type: string
|
||
enum:
|
||
- PURCHASE_REMAINDER
|
||
- TRANSIT_REMAINDER
|
||
- GOOD
|
||
- DAMAGED
|
||
- EXTRA
|
||
sourceId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
businessNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
ControlSnapshot:
|
||
type: object
|
||
required:
|
||
- orderNo
|
||
- version
|
||
- status
|
||
- notes
|
||
- remaining
|
||
- closures
|
||
- closureItems
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
notes:
|
||
type: array
|
||
items:
|
||
type: object
|
||
description: 平台内部更正事实，含原始凭证和处理说明；字段为表结构snake_case，不对客透传
|
||
remaining:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/ControlRemaining'
|
||
closures:
|
||
type: array
|
||
items:
|
||
type: object
|
||
closureItems:
|
||
type: array
|
||
items:
|
||
type: object
|
||
ControlResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/ControlSnapshot'
|
||
ProcurementHeader:
|
||
type: object
|
||
required:
|
||
- id
|
||
- orderNo
|
||
- productName
|
||
- purchaseQuantity
|
||
- status
|
||
- version
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
nullable: true
|
||
customerId:
|
||
type: string
|
||
nullable: true
|
||
customerName:
|
||
type: string
|
||
nullable: true
|
||
purchaseCategory:
|
||
type: string
|
||
nullable: true
|
||
productName:
|
||
type: string
|
||
nullable: true
|
||
productSpecification:
|
||
type: string
|
||
nullable: true
|
||
productUrl:
|
||
type: string
|
||
nullable: true
|
||
currency:
|
||
type: string
|
||
nullable: true
|
||
receivingAddress:
|
||
type: string
|
||
nullable: true
|
||
contactName:
|
||
type: string
|
||
nullable: true
|
||
contactPhone:
|
||
type: string
|
||
nullable: true
|
||
plannedWarehouseName:
|
||
type: string
|
||
nullable: true
|
||
actualWarehouseCode:
|
||
type: string
|
||
nullable: true
|
||
actualWarehouseName:
|
||
type: string
|
||
nullable: true
|
||
status:
|
||
type: string
|
||
nullable: true
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
purchaseQuantity:
|
||
type: integer
|
||
format: int64
|
||
budgetUnitPrice:
|
||
type: number
|
||
nullable: true
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
estimatedArrivalAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
createdAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
updatedAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
ProcurementBudget:
|
||
type: object
|
||
required:
|
||
- totalAmount
|
||
- currency
|
||
- authorizedAt
|
||
properties:
|
||
totalAmount:
|
||
type: number
|
||
nullable: true
|
||
currency:
|
||
type: string
|
||
authorizedAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
ProcurementProgress:
|
||
type: object
|
||
required:
|
||
- key
|
||
- title
|
||
- completedAt
|
||
properties:
|
||
key:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
title:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
completedAt:
|
||
type: string
|
||
format: date-time
|
||
nullable: true
|
||
CustomerBox:
|
||
type: object
|
||
required:
|
||
- cartonNo
|
||
- quantity
|
||
- lengthCm
|
||
- widthCm
|
||
- heightCm
|
||
- grossWeightKg
|
||
properties:
|
||
cartonNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
lengthCm:
|
||
type: number
|
||
widthCm:
|
||
type: number
|
||
heightCm:
|
||
type: number
|
||
grossWeightKg:
|
||
type: number
|
||
CustomerShipment:
|
||
type: object
|
||
required:
|
||
- shipmentNo
|
||
- leg
|
||
- shippedAt
|
||
- cartonNo
|
||
- quantity
|
||
- carrier
|
||
- trackingNo
|
||
properties:
|
||
shipmentNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
shippedAt:
|
||
type: string
|
||
format: date-time
|
||
cartonNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
carrier:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
trackingNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
CustomerFee:
|
||
type: object
|
||
required:
|
||
- feeNo
|
||
- purpose
|
||
- name
|
||
- determination
|
||
- currency
|
||
- originalCurrency
|
||
- exchangeRateMonth
|
||
- parentFeeNo
|
||
- walletStatus
|
||
- version
|
||
- active
|
||
- amount
|
||
- originalAmount
|
||
- exchangeRate
|
||
- businessDate
|
||
- sourceLinked
|
||
properties:
|
||
feeNo:
|
||
type: string
|
||
nullable: true
|
||
purpose:
|
||
type: string
|
||
nullable: true
|
||
name:
|
||
type: string
|
||
nullable: true
|
||
determination:
|
||
type: string
|
||
nullable: true
|
||
currency:
|
||
type: string
|
||
nullable: true
|
||
originalCurrency:
|
||
type: string
|
||
nullable: true
|
||
exchangeRateMonth:
|
||
type: string
|
||
nullable: true
|
||
parentFeeNo:
|
||
type: string
|
||
nullable: true
|
||
walletStatus:
|
||
type: string
|
||
nullable: true
|
||
version:
|
||
type: integer
|
||
nullable: true
|
||
active:
|
||
type: boolean
|
||
amount:
|
||
type: number
|
||
originalAmount:
|
||
type: number
|
||
nullable: true
|
||
exchangeRate:
|
||
type: number
|
||
nullable: true
|
||
businessDate:
|
||
type: string
|
||
format: date
|
||
nullable: true
|
||
sourceLinked:
|
||
type: boolean
|
||
additionalProperties: false
|
||
description: 客户费用白名单：不含凭证、备注、资金命令/冻结/流水引用和原始诊断
|
||
ProcurementCustomerView:
|
||
type: object
|
||
required:
|
||
- order
|
||
- budget
|
||
- purchased
|
||
- purchaseConfirmed
|
||
- purchaseNeedsAttention
|
||
- progress
|
||
- boxes
|
||
- shipments
|
||
- fees
|
||
- exceptionSummaries
|
||
properties:
|
||
order:
|
||
$ref: '#/components/schemas/ProcurementHeader'
|
||
budget:
|
||
$ref: '#/components/schemas/ProcurementBudget'
|
||
purchased:
|
||
type: boolean
|
||
purchaseConfirmed:
|
||
type: boolean
|
||
purchaseNeedsAttention:
|
||
type: boolean
|
||
progress:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/ProcurementProgress'
|
||
boxes:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/CustomerBox'
|
||
shipments:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/CustomerShipment'
|
||
fees:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/CustomerFee'
|
||
exceptionSummaries:
|
||
type: array
|
||
items:
|
||
type: string
|
||
additionalProperties: false
|
||
description: 客户仅获取此独立投影；boxes只包含已确认海外清单。内部采购异常只提供需要处理标记，异常摘要来自人工明确填写的对客字段。
|
||
ProcurementAction:
|
||
type: object
|
||
required:
|
||
- key
|
||
- label
|
||
- permission
|
||
- allowed
|
||
- reason
|
||
properties:
|
||
key:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
label:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
permission:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
allowed:
|
||
type: boolean
|
||
reason:
|
||
type: string
|
||
nullable: true
|
||
ProcurementPlatformView:
|
||
type: object
|
||
required:
|
||
- customerView
|
||
- purchaseFacts
|
||
- physical
|
||
- transport
|
||
- fees
|
||
- feeCorrections
|
||
- controls
|
||
- files
|
||
- reviewHistory
|
||
- operations
|
||
- actions
|
||
- internalRemark
|
||
properties:
|
||
customerView:
|
||
$ref: '#/components/schemas/ProcurementCustomerView'
|
||
purchaseFacts:
|
||
type: object
|
||
description: 平台内部履约事实，字段snake_case
|
||
physical:
|
||
type: object
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
packingVersion:
|
||
type: integer
|
||
nullable: true
|
||
packingStatus:
|
||
type: string
|
||
nullable: true
|
||
enum:
|
||
- DRAFT
|
||
- CONFIRMED
|
||
- SUPERSEDED
|
||
receipts:
|
||
type: array
|
||
items:
|
||
type: object
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
receiptNo:
|
||
type: string
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
sourceCartonId:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
nullable: true
|
||
goodQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
damagedQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
extraQuantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
receivedAt:
|
||
type: string
|
||
format: date-time
|
||
active:
|
||
type: boolean
|
||
dispositions:
|
||
type: array
|
||
description: 平台处置历史，active=0为已撤销记录；不直接对客输出内部依据
|
||
items:
|
||
type: object
|
||
cartons:
|
||
type: array
|
||
items:
|
||
allOf:
|
||
- $ref: '#/components/schemas/Carton'
|
||
- type: object
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: ^[1-9][0-9]*$
|
||
quantity:
|
||
type: integer
|
||
format: int64
|
||
minimum: 1
|
||
transport:
|
||
type: object
|
||
required:
|
||
- orderNo
|
||
- version
|
||
- status
|
||
- overseasLabels
|
||
- domesticLabels
|
||
- overseasCargo
|
||
- domesticCargo
|
||
- shipments
|
||
properties:
|
||
orderNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
version:
|
||
type: integer
|
||
format: int64
|
||
minimum: 0
|
||
status:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 128
|
||
overseasCargo:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/TransportCargo'
|
||
domesticCargo:
|
||
type: array
|
||
description: 国内有效合格实收及最新一对一换包装箱规，不包含已处置的破损或多货
|
||
items:
|
||
$ref: '#/components/schemas/TransportCargo'
|
||
overseasLabels:
|
||
allOf:
|
||
- $ref: '#/components/schemas/LabelSet'
|
||
nullable: true
|
||
domesticLabels:
|
||
allOf:
|
||
- $ref: '#/components/schemas/LabelSet'
|
||
nullable: true
|
||
shipments:
|
||
type: array
|
||
items:
|
||
type: object
|
||
required:
|
||
- id
|
||
- shipmentNo
|
||
- leg
|
||
- shippedAt
|
||
properties:
|
||
id:
|
||
type: string
|
||
pattern: '^[1-9][0-9]*$'
|
||
shipmentNo:
|
||
type: string
|
||
minLength: 1
|
||
maxLength: 64
|
||
leg:
|
||
type: string
|
||
enum:
|
||
- OVERSEAS
|
||
- DOMESTIC
|
||
shippedAt:
|
||
type: string
|
||
format: date-time
|
||
fees:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/ProcurementFeeVersion'
|
||
feeCorrections:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/FeeCorrectionResult'
|
||
controls:
|
||
$ref: '#/components/schemas/ControlSnapshot'
|
||
files:
|
||
type: array
|
||
items:
|
||
type: object
|
||
reviewHistory:
|
||
type: array
|
||
items:
|
||
type: object
|
||
operations:
|
||
type: array
|
||
items:
|
||
type: object
|
||
actions:
|
||
type: array
|
||
items:
|
||
$ref: '#/components/schemas/ProcurementAction'
|
||
internalRemark:
|
||
type: string
|
||
nullable: true
|
||
ProcurementCustomerResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/ProcurementCustomerView'
|
||
ProcurementPlatformResponse:
|
||
type: object
|
||
required:
|
||
- code
|
||
- message
|
||
- data
|
||
properties:
|
||
code:
|
||
type: string
|
||
message:
|
||
type: string
|
||
data:
|
||
$ref: '#/components/schemas/ProcurementPlatformView'
|