428 lines
15 KiB
YAML
428 lines
15 KiB
YAML
openapi: 3.0.3
|
|
info:
|
|
title: 排车装车资料（Admin/PDA共用）
|
|
version: 1.0.0
|
|
description: 理货审核通过时，将本趟已核验驾驶证和车辆照片复制到空的司机驾驶证、车牌照片类别（每类最多5份），来源未变的已有照片保持不变；保存车辆、司机或证照来源变更时，对应类别旧资料与资源保存同事务失效并保留历史；换车另失效装车完成及封车照片，换司机另失效BOL签字，重审通过后只带入驾驶证与车牌资料；PDF驾驶证保留原件并计为一份。GET只读，不对存量记录补写。LOADING阶段即可同步上传并保存五个整车照片框；照片齐全不会提前发车。装车确认时资料已齐则直接进入DELIVERING，否则进入AFTER_LOADING，最后一次绑定自动生成派送并进入DELIVERING。触发推进的装车确认或照片绑定与派送同事务，失败保留先前已保存资料。复用车队照片记录，技术槽位沿用原文件归属，按顺序对应司机驾驶证、车牌照片、装车完成、封车照片、BOL司机签字；每类1至5张，允许追加或指定replaceFileId精确替换，不代表驾驶证审核或真实签收。PDA每次核验Token冻结仓，平台list只读、edit写；原键仅原操作者恢复。上传须携当前reviewRound并将轮次写入上传账本；绑定须携uploadKey核对原上传文件、分类、操作者及当前审核轮次，不允许用最新资料版本重绑旧轮次上传。
|
|
security:
|
|
- bearerAuth: []
|
|
paths:
|
|
/api/platform/v1/last-leg/dispatches/{dispatchNo}/loading-documents:
|
|
get:
|
|
operationId: getDispatchLoadingDocuments
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: platform:overseas-warehouse:dispatch:list
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Documents'
|
|
/api/pda/v1/last-leg/dispatches/{dispatchNo}/loading-documents:
|
|
get:
|
|
operationId: getDispatchLoadingDocumentsPda
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: lastleg:pda:operate
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Documents'
|
|
x-required-role: OVERSEAS_WAREHOUSE_PDA_OPERATOR
|
|
/api/platform/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}/uploads:
|
|
post:
|
|
operationId: uploadDispatchLoadingPhoto
|
|
summary: 上传整车装车照片，尚未绑定
|
|
x-permission-code: platform:overseas-warehouse:dispatch:edit
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Photo'
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
multipart/form-data:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- file
|
|
- idempotencyKey
|
|
- reviewRound
|
|
properties:
|
|
file:
|
|
type: string
|
|
format: binary
|
|
description: 非空JPG/PNG，司机驾驶证（LOADING_SCENE）也支持PDF，最大10MiB
|
|
reviewRound:
|
|
type: string
|
|
pattern: "^[1-9][0-9]*$"
|
|
description: 选择照片时看到的审核轮次；不得在上传后改用新轮次。
|
|
idempotencyKey:
|
|
type: string
|
|
minLength: 8
|
|
maxLength: 128
|
|
/api/pda/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}/uploads:
|
|
post:
|
|
operationId: uploadDispatchLoadingPhotoPda
|
|
summary: 上传整车装车照片，尚未绑定
|
|
x-permission-code: lastleg:pda:operate
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Photo'
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
multipart/form-data:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- file
|
|
- idempotencyKey
|
|
- reviewRound
|
|
properties:
|
|
file:
|
|
type: string
|
|
format: binary
|
|
description: 非空JPG/PNG，司机驾驶证（LOADING_SCENE）也支持PDF，最大10MiB
|
|
reviewRound:
|
|
type: string
|
|
pattern: "^[1-9][0-9]*$"
|
|
description: 选择照片时看到的审核轮次；不得在上传后改用新轮次。
|
|
idempotencyKey:
|
|
type: string
|
|
minLength: 8
|
|
maxLength: 128
|
|
x-required-role: OVERSEAS_WAREHOUSE_PDA_OPERATOR
|
|
/api/platform/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}:
|
|
put:
|
|
operationId: bindDispatchLoadingPhoto
|
|
summary: 保存装车照片；五框齐全时自动进入派送中
|
|
x-permission-code: platform:overseas-warehouse:dispatch:edit
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Documents'
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/BindPhoto'
|
|
/api/pda/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}:
|
|
put:
|
|
operationId: bindDispatchLoadingPhotoPda
|
|
summary: 保存装车照片；五框齐全时自动进入派送中
|
|
x-permission-code: lastleg:pda:operate
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Documents'
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/BindPhoto'
|
|
x-required-role: OVERSEAS_WAREHOUSE_PDA_OPERATOR
|
|
/api/platform/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}/files/{fileId}/content:
|
|
get:
|
|
operationId: readDispatchLoadingPhoto
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: platform:overseas-warehouse:dispatch:list
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
- $ref: '#/components/parameters/fileId'
|
|
responses:
|
|
'200':
|
|
description: no-store图片内容
|
|
content:
|
|
image/jpeg:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
application/pdf:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
image/png:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
/api/pda/v1/last-leg/dispatches/{dispatchNo}/loading-documents/{slot}/files/{fileId}/content:
|
|
get:
|
|
operationId: readDispatchLoadingPhotoPda
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: lastleg:pda:operate
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/slot'
|
|
- $ref: '#/components/parameters/fileId'
|
|
responses:
|
|
'200':
|
|
description: no-store图片内容
|
|
content:
|
|
image/jpeg:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
application/pdf:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
image/png:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
x-required-role: OVERSEAS_WAREHOUSE_PDA_OPERATOR
|
|
/api/platform/v1/last-leg/dispatches/{dispatchNo}/loading-documents/uploads/{idempotencyKey}:
|
|
get:
|
|
operationId: recoverDispatchLoadingPhoto
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: platform:overseas-warehouse:dispatch:edit
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/idempotencyKey'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Photo'
|
|
/api/pda/v1/last-leg/dispatches/{dispatchNo}/loading-documents/uploads/{idempotencyKey}:
|
|
get:
|
|
operationId: recoverDispatchLoadingPhotoPda
|
|
summary: 读取本车装车资料或原上传结果
|
|
x-permission-code: lastleg:pda:operate
|
|
parameters:
|
|
- $ref: '#/components/parameters/dispatchNo'
|
|
- $ref: '#/components/parameters/idempotencyKey'
|
|
responses:
|
|
'200':
|
|
description: 成功；业务错误沿ApiResponse返回A0400/A0403/A0404/A0409及诊断编号
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
message:
|
|
type: string
|
|
data:
|
|
$ref: '#/components/schemas/Photo'
|
|
x-required-role: OVERSEAS_WAREHOUSE_PDA_OPERATOR
|
|
components:
|
|
securitySchemes:
|
|
bearerAuth:
|
|
type: http
|
|
scheme: bearer
|
|
bearerFormat: JWT
|
|
parameters:
|
|
dispatchNo:
|
|
name: dispatchNo
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
slot:
|
|
name: slot
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
enum: &id001
|
|
- LOADING_SCENE
|
|
- LOADING_LIST
|
|
- PRE_DEPARTURE_CHECK
|
|
- DRIVER_LICENSE
|
|
- RECEIPT
|
|
fileId:
|
|
name: fileId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
idempotencyKey:
|
|
name: idempotencyKey
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
schemas:
|
|
Photo:
|
|
type: object
|
|
required:
|
|
- slot
|
|
- fileId
|
|
- fileName
|
|
- contentType
|
|
- sizeBytes
|
|
- uploadedAt
|
|
properties:
|
|
slot:
|
|
type: string
|
|
enum: *id001
|
|
category:
|
|
type: string
|
|
enum:
|
|
- LOADING
|
|
fileId:
|
|
type: string
|
|
fileName:
|
|
type: string
|
|
contentType:
|
|
type: string
|
|
sizeBytes:
|
|
type: string
|
|
uploadedAt:
|
|
type: string
|
|
savedAt:
|
|
type: string
|
|
nullable: true
|
|
Documents:
|
|
type: object
|
|
required:
|
|
- dispatchNo
|
|
- recordVersion
|
|
- editable
|
|
- photos
|
|
- dispatchRecordVersion
|
|
- reviewRound
|
|
- stage
|
|
- complete
|
|
properties:
|
|
dispatchNo:
|
|
type: string
|
|
recordVersion:
|
|
type: string
|
|
editable:
|
|
type: boolean
|
|
photos:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/Photo'
|
|
dispatchRecordVersion:
|
|
type: string
|
|
reviewRound:
|
|
type: string
|
|
pattern: "^[1-9][0-9]*$"
|
|
stage:
|
|
type: string
|
|
enum:
|
|
- LOADING
|
|
- AFTER_LOADING
|
|
- DELIVERING
|
|
- DELIVERED
|
|
complete:
|
|
type: boolean
|
|
description: 五类各至少一张已保存照片，不能用总张数代替类别齐全
|
|
BindPhoto:
|
|
type: object
|
|
required:
|
|
- recordVersion
|
|
- idempotencyKey
|
|
- uploadKey
|
|
- fileId
|
|
properties:
|
|
recordVersion:
|
|
type: string
|
|
pattern: ^(0|[1-9][0-9]*)$
|
|
uploadKey:
|
|
type: string
|
|
minLength: 8
|
|
maxLength: 128
|
|
description: 本文件原上传请求的幂等键；与当前审核轮次及操作者一致。
|
|
idempotencyKey:
|
|
type: string
|
|
minLength: 8
|
|
maxLength: 128
|
|
fileId:
|
|
type: string
|
|
replaceFileId:
|
|
type: string
|
|
nullable: true
|
|
pattern: "^[1-9][0-9]*$"
|
|
description: 待替换的当前同类文件ID；省略时装车照片追加，每类最多5张，油耗沿单张替换。
|