945 lines
27 KiB
YAML
945 lines
27 KiB
YAML
openapi: "3.0.3"
|
||
info:
|
||
title: "原排车未拼车业务运营视图"
|
||
version: "1.0.0"
|
||
description: "未实际接入拼车货物的装车后排车；按需求池已实收绑定及本车真实货物组成判定。车辆OWNED/DISPATCHED只表示装车时归属，不决定业务分类；所有主单事实来自原dispatch。新增数据仅附加运营记录、命令、历史及归属证据。油耗L/100km手工登记，金额CNY/USD不默认、不换汇；零与未登记不同。响应遵循NON_NULL：可空属性可省略，省略与null均表示空值，0仍是明确登记值；请求必填项仍以required及DTO校验为准。"
|
||
security:
|
||
-
|
||
bearerAuth: []
|
||
paths:
|
||
"/api/platform/v1/last-leg/fleet/owned-business":
|
||
get:
|
||
operationId: "listOwnedBusiness"
|
||
summary: "未接入拼车货物的装车后视图及同筛选四项统计"
|
||
description: "权限：platform:fleet:owned-business:list。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:list"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/ListResult"
|
||
nullable: true
|
||
parameters:
|
||
-
|
||
name: "page"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "integer"
|
||
minimum: 1
|
||
default: 1
|
||
-
|
||
name: "size"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "integer"
|
||
minimum: 1
|
||
maximum: 200
|
||
default: 20
|
||
-
|
||
name: "plannedDepartureFrom"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "string"
|
||
format: "date-time"
|
||
-
|
||
name: "plannedDepartureTo"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "string"
|
||
format: "date-time"
|
||
-
|
||
name: "keyword"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
-
|
||
name: "stage"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
"$ref": "#/components/schemas/Stage"
|
||
-
|
||
name: "warehouseId"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "string"
|
||
maxLength: 64
|
||
x-filter-contract: "plannedDepartureAt [from,to)，统计同全部过滤、不带分页；无归属快照不降级按当前主档推断。"
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
get:
|
||
operationId: "getOwnedBusiness"
|
||
summary: "组合原排车详情及附加运营信息"
|
||
description: "权限：platform:fleet:owned-business:list。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:list"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Detail"
|
||
nullable: true
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/history":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
get:
|
||
operationId: "historyOwnedBusiness"
|
||
summary: "原排车及附加真实流水聚合分页"
|
||
description: "权限：platform:fleet:owned-business:list。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:list"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/HistoryPage"
|
||
nullable: true
|
||
parameters:
|
||
-
|
||
name: "page"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "integer"
|
||
minimum: 1
|
||
default: 1
|
||
-
|
||
name: "size"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "integer"
|
||
minimum: 1
|
||
maximum: 200
|
||
default: 20
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/operations":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
put:
|
||
operationId: "saveOwnedBusinessOperations"
|
||
summary: "按附加版本登记、更正或清空运营信息"
|
||
description: "权限：platform:fleet:owned-business:edit。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:edit"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Detail"
|
||
nullable: true
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
"$ref": "#/components/schemas/SaveOperations"
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/photos/{slot}/uploads":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
-
|
||
name: "slot"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
"$ref": "#/components/schemas/PhotoSlot"
|
||
post:
|
||
operationId: "uploadOwnedBusinessPhoto"
|
||
summary: "逐框准备照片，尚未保存绑定"
|
||
description: "权限：platform:fleet:owned-business:upload。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:upload"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Photo"
|
||
nullable: true
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
"multipart/form-data":
|
||
schema:
|
||
type: "object"
|
||
required:
|
||
- "file"
|
||
- "idempotencyKey"
|
||
properties:
|
||
idempotencyKey:
|
||
type: "string"
|
||
minLength: 8
|
||
maxLength: 128
|
||
description: "原上传请求键，以multipart表单字段提交，绑定使用独立请求键。"
|
||
file:
|
||
type: "string"
|
||
format: "binary"
|
||
description: "真实JPG/PNG，非空，最大10MiB；与独立绑定命令使用不同请求键。"
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/photos/{slot}":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
-
|
||
name: "slot"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
"$ref": "#/components/schemas/PhotoSlot"
|
||
put:
|
||
operationId: "bindOwnedBusinessPhoto"
|
||
summary: "保存原上传fileId；失败保留原键恢复，不重新上传"
|
||
description: "权限：platform:fleet:owned-business:upload。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:upload"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Detail"
|
||
nullable: true
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
"$ref": "#/components/schemas/BindPhoto"
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/photos/{slot}/files/{fileId}/content":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
-
|
||
name: "slot"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
"$ref": "#/components/schemas/PhotoSlot"
|
||
-
|
||
name: "fileId"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
pattern: "^[1-9][0-9]*$"
|
||
get:
|
||
operationId: "readOwnedBusinessPhoto"
|
||
summary: "授权读取当前或原历史绑定图片"
|
||
description: "权限：platform:fleet:owned-business:list。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:list"
|
||
responses:
|
||
200:
|
||
description: "仅当前或指定历史引用的图片字节，Cache-Control:no-store，X-Content-Type-Options:nosniff"
|
||
content:
|
||
"image/jpeg":
|
||
schema:
|
||
type: "string"
|
||
format: "binary"
|
||
"image/png":
|
||
schema:
|
||
type: "string"
|
||
format: "binary"
|
||
parameters:
|
||
-
|
||
name: "revisionVersion"
|
||
in: "query"
|
||
required: false
|
||
schema:
|
||
type: "integer"
|
||
format: "int64"
|
||
minimum: 1
|
||
"/api/platform/v1/last-leg/fleet/owned-business/{dispatchNo}/commands/{idempotencyKey}":
|
||
parameters:
|
||
-
|
||
name: "dispatchNo"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
maxLength: 128
|
||
-
|
||
name: "idempotencyKey"
|
||
in: "path"
|
||
required: true
|
||
schema:
|
||
type: "string"
|
||
minLength: 8
|
||
maxLength: 128
|
||
get:
|
||
operationId: "recoverOwnedBusinessCommand"
|
||
summary: "恢复本操作者原命令，未知结果不得换键重发"
|
||
description: "权限：platform:fleet:owned-business:list。仅可信平台主体；只读原排车事实，不改变其状态/版本，不发布费用。"
|
||
x-permission-code: "platform:fleet:owned-business:list"
|
||
responses:
|
||
200:
|
||
description: "统一ApiResponse：成功code=200；业务错误保留A0400/A0403/A0404/A0409及诊断requestId/traceId。"
|
||
content:
|
||
"application/json":
|
||
schema:
|
||
type: "object"
|
||
properties:
|
||
code:
|
||
type: "string"
|
||
message:
|
||
type: "string"
|
||
data:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Command"
|
||
nullable: true
|
||
components:
|
||
securitySchemes:
|
||
bearerAuth:
|
||
type: "http"
|
||
scheme: "bearer"
|
||
bearerFormat: "JWT"
|
||
schemas:
|
||
Stage:
|
||
type: "string"
|
||
enum:
|
||
- "AFTER_LOADING"
|
||
- "DELIVERING"
|
||
- "DELIVERED"
|
||
PhotoSlot:
|
||
type: "string"
|
||
enum:
|
||
- "LOADING_SCENE"
|
||
- "LOADING_LIST"
|
||
- "PRE_DEPARTURE_CHECK"
|
||
- "DRIVER_LICENSE"
|
||
- "RECEIPT"
|
||
- "FUEL_START"
|
||
- "FUEL_END"
|
||
Money:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Money"
|
||
required:
|
||
- "currency"
|
||
- "amount"
|
||
properties:
|
||
currency:
|
||
type: "string"
|
||
enum:
|
||
- "CNY"
|
||
- "USD"
|
||
amount:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]{0,15})(\\.[0-9]{1,2})?$"
|
||
Arrival:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Arrival"
|
||
required:
|
||
- "destinationKey"
|
||
properties:
|
||
destinationKey:
|
||
type: "string"
|
||
minLength: 1
|
||
maxLength: 256
|
||
actualArrivedAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
Operations:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Operations"
|
||
required:
|
||
- "arrivals"
|
||
properties:
|
||
money:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Money"
|
||
nullable: true
|
||
actualDistanceMiles:
|
||
type: "string"
|
||
nullable: true
|
||
pattern: "^(0|[1-9][0-9]{0,8})(\\.[0-9]{1,3})?$"
|
||
fuelConsumptionLitresPer100Km:
|
||
type: "string"
|
||
nullable: true
|
||
pattern: "^(0|[1-9][0-9]{0,8})(\\.[0-9]{1,3})?$"
|
||
arrivals:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Arrival"
|
||
SaveOperations:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.SaveOperations"
|
||
required:
|
||
- "recordVersion"
|
||
- "idempotencyKey"
|
||
- "operations"
|
||
properties:
|
||
recordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
idempotencyKey:
|
||
type: "string"
|
||
minLength: 8
|
||
maxLength: 128
|
||
operations:
|
||
"$ref": "#/components/schemas/Operations"
|
||
reason:
|
||
type: "string"
|
||
nullable: true
|
||
maxLength: 1000
|
||
BindPhoto:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.BindPhoto"
|
||
required:
|
||
- "recordVersion"
|
||
- "idempotencyKey"
|
||
- "fileId"
|
||
properties:
|
||
recordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
idempotencyKey:
|
||
type: "string"
|
||
minLength: 8
|
||
maxLength: 128
|
||
fileId:
|
||
type: "string"
|
||
pattern: "^[1-9][0-9]*$"
|
||
Gate:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Gate"
|
||
required:
|
||
- "allowed"
|
||
properties:
|
||
allowed:
|
||
type: "boolean"
|
||
blockReason:
|
||
type: "string"
|
||
nullable: true
|
||
Actions:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Actions"
|
||
required:
|
||
- "edit"
|
||
- "upload"
|
||
properties:
|
||
edit:
|
||
"$ref": "#/components/schemas/Gate"
|
||
upload:
|
||
"$ref": "#/components/schemas/Gate"
|
||
Origin:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Origin"
|
||
required:
|
||
- "warehouseId"
|
||
- "warehouseCode"
|
||
- "warehouseName"
|
||
properties:
|
||
warehouseId:
|
||
type: "string"
|
||
warehouseCode:
|
||
type: "string"
|
||
warehouseName:
|
||
type: "string"
|
||
Vehicle:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Vehicle"
|
||
required:
|
||
- "ownership"
|
||
properties:
|
||
vehicleId:
|
||
type: "string"
|
||
nullable: true
|
||
plate:
|
||
type: "string"
|
||
nullable: true
|
||
ownership:
|
||
type: "string"
|
||
enum:
|
||
- "OWNED"
|
||
- "DISPATCHED"
|
||
Driver:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Driver"
|
||
properties:
|
||
name:
|
||
type: "string"
|
||
nullable: true
|
||
phone:
|
||
type: "string"
|
||
nullable: true
|
||
Appointment:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Appointment"
|
||
required:
|
||
- "appointmentNo"
|
||
- "allocatedPackages"
|
||
properties:
|
||
appointmentNo:
|
||
type: "string"
|
||
confirmationNo:
|
||
type: "string"
|
||
nullable: true
|
||
scheduledAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
allocatedPackages:
|
||
type: "string"
|
||
pattern: "^[1-9][0-9]*$"
|
||
Destination:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Destination"
|
||
required:
|
||
- "destinationKey"
|
||
- "appointments"
|
||
properties:
|
||
destinationKey:
|
||
type: "string"
|
||
warehouseCode:
|
||
type: "string"
|
||
nullable: true
|
||
warehouseName:
|
||
type: "string"
|
||
nullable: true
|
||
address:
|
||
type: "string"
|
||
nullable: true
|
||
appointments:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Appointment"
|
||
actualArrivedAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
Photo:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Photo"
|
||
required:
|
||
- "slot"
|
||
- "category"
|
||
- "fileId"
|
||
- "fileName"
|
||
- "contentType"
|
||
- "sizeBytes"
|
||
- "uploadedAt"
|
||
properties:
|
||
slot:
|
||
"$ref": "#/components/schemas/PhotoSlot"
|
||
category:
|
||
type: "string"
|
||
enum:
|
||
- "LOADING"
|
||
- "FUEL"
|
||
fileId:
|
||
type: "string"
|
||
fileName:
|
||
type: "string"
|
||
contentType:
|
||
type: "string"
|
||
enum:
|
||
- "image/jpeg"
|
||
- "image/png"
|
||
sizeBytes:
|
||
type: "string"
|
||
pattern: "^[1-9][0-9]*$"
|
||
uploadedAt:
|
||
type: "string"
|
||
savedAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
description: "上传回执savedAt为空；绑定成功才填写savedAt。File类型分别为OVERSEAS_DISPATCH_LOADING_PHOTO和OVERSEAS_DISPATCH_FUEL_PHOTO，平台0、原dispatch内部ID，最多10MiB。"
|
||
PhotoSummary:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.PhotoSummary"
|
||
required:
|
||
- "loadingCount"
|
||
- "fuelCount"
|
||
properties:
|
||
loadingCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
fuelCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
Row:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Row"
|
||
required:
|
||
- "dispatchNo"
|
||
- "stage"
|
||
- "plannedDepartureAt"
|
||
- "loadingCompletedAt"
|
||
- "origin"
|
||
- "vehicle"
|
||
- "driver"
|
||
- "destinations"
|
||
- "operations"
|
||
- "recordVersion"
|
||
- "dispatchRecordVersion"
|
||
- "photoSummary"
|
||
- "actions"
|
||
- "sourceIssues"
|
||
properties:
|
||
dispatchNo:
|
||
type: "string"
|
||
stage:
|
||
"$ref": "#/components/schemas/Stage"
|
||
plannedDepartureAt:
|
||
type: "string"
|
||
format: "date-time"
|
||
loadingCompletedAt:
|
||
type: "string"
|
||
format: "date-time"
|
||
departedAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
deliveryCompletedAt:
|
||
type: "string"
|
||
nullable: true
|
||
format: "date-time"
|
||
origin:
|
||
"$ref": "#/components/schemas/Origin"
|
||
vehicle:
|
||
"$ref": "#/components/schemas/Vehicle"
|
||
driver:
|
||
"$ref": "#/components/schemas/Driver"
|
||
destinations:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Destination"
|
||
actualPalletCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
nullable: true
|
||
operations:
|
||
"$ref": "#/components/schemas/Operations"
|
||
unitPrice:
|
||
type: "string"
|
||
nullable: true
|
||
pattern: "^(0|[1-9][0-9]{0,15})(\\.[0-9]{1,2})?$"
|
||
recordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
dispatchRecordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
photoSummary:
|
||
"$ref": "#/components/schemas/PhotoSummary"
|
||
actions:
|
||
"$ref": "#/components/schemas/Actions"
|
||
sourceIssues:
|
||
type: "array"
|
||
items:
|
||
type: "string"
|
||
Summary:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Summary"
|
||
required:
|
||
- "dispatchCount"
|
||
- "afterLoadingCount"
|
||
- "deliveringCount"
|
||
- "deliveredCount"
|
||
properties:
|
||
dispatchCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
afterLoadingCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
deliveringCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
deliveredCount:
|
||
type: "integer"
|
||
minimum: 0
|
||
ListResult:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.ListResult"
|
||
required:
|
||
- "records"
|
||
- "page"
|
||
- "size"
|
||
- "total"
|
||
- "summary"
|
||
properties:
|
||
records:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Row"
|
||
page:
|
||
type: "integer"
|
||
minimum: 1
|
||
size:
|
||
type: "integer"
|
||
minimum: 1
|
||
maximum: 200
|
||
total:
|
||
type: "integer"
|
||
minimum: 0
|
||
summary:
|
||
"$ref": "#/components/schemas/Summary"
|
||
Cargo:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Cargo"
|
||
required:
|
||
- "sourceKey"
|
||
- "customerId"
|
||
- "palletNo"
|
||
- "destinationKey"
|
||
- "packages"
|
||
properties:
|
||
sourceKey:
|
||
type: "string"
|
||
customerId:
|
||
type: "string"
|
||
customerName:
|
||
type: "string"
|
||
nullable: true
|
||
orderNo:
|
||
type: "string"
|
||
nullable: true
|
||
inboundCode:
|
||
type: "string"
|
||
nullable: true
|
||
palletNo:
|
||
type: "string"
|
||
destinationKey:
|
||
type: "string"
|
||
packages:
|
||
type: "string"
|
||
Detail:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Detail"
|
||
required:
|
||
- "row"
|
||
- "dispatch"
|
||
- "cargo"
|
||
- "photos"
|
||
properties:
|
||
row:
|
||
"$ref": "#/components/schemas/Row"
|
||
dispatch:
|
||
"$ref": "./overseas-business-v1.yaml#/components/schemas/DispatchDetail"
|
||
cargo:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Cargo"
|
||
photos:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Photo"
|
||
History:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.History"
|
||
required:
|
||
- "eventSource"
|
||
- "action"
|
||
- "occurredAt"
|
||
- "photos"
|
||
properties:
|
||
eventSource:
|
||
type: "string"
|
||
enum:
|
||
- "DISPATCH"
|
||
- "OPERATIONS"
|
||
recordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
nullable: true
|
||
dispatchRecordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
nullable: true
|
||
action:
|
||
type: "string"
|
||
operatorName:
|
||
type: "string"
|
||
nullable: true
|
||
occurredAt:
|
||
type: "string"
|
||
format: "date-time"
|
||
reason:
|
||
type: "string"
|
||
nullable: true
|
||
operations:
|
||
allOf:
|
||
-
|
||
"$ref": "#/components/schemas/Operations"
|
||
nullable: true
|
||
photos:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/Photo"
|
||
description: "UNION ALL读取原排车真实流水与附加流水，一次排序分页；DISPATCH事件recordVersion=null、operations=null、photos=[]；OPERATIONS事件dispatchRecordVersion=null。"
|
||
HistoryPage:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.HistoryPage"
|
||
required:
|
||
- "records"
|
||
- "page"
|
||
- "size"
|
||
- "total"
|
||
properties:
|
||
records:
|
||
type: "array"
|
||
items:
|
||
"$ref": "#/components/schemas/History"
|
||
page:
|
||
type: "integer"
|
||
minimum: 1
|
||
size:
|
||
type: "integer"
|
||
minimum: 1
|
||
maximum: 200
|
||
total:
|
||
type: "integer"
|
||
minimum: 0
|
||
Command:
|
||
type: "object"
|
||
x-java-record: "OwnedBusinessModels.Command"
|
||
description: "SAVE_OPERATIONS/BIND_PHOTO成功时recordVersion和result必须有值；UPLOAD_PHOTO成功时result必须含fileId，recordVersion可空。仅可空的未确定或拒绝结果字段允许省略，不放宽成功回执的关联要求。"
|
||
required:
|
||
- "dispatchNo"
|
||
- "action"
|
||
- "idempotencyKey"
|
||
- "state"
|
||
- "replayed"
|
||
- "retryAllowed"
|
||
properties:
|
||
dispatchNo:
|
||
type: "string"
|
||
action:
|
||
type: "string"
|
||
enum:
|
||
- "SAVE_OPERATIONS"
|
||
- "UPLOAD_PHOTO"
|
||
- "BIND_PHOTO"
|
||
idempotencyKey:
|
||
type: "string"
|
||
state:
|
||
type: "string"
|
||
enum:
|
||
- "SUCCEEDED"
|
||
- "PENDING"
|
||
- "UNKNOWN_RESULT"
|
||
- "REJECTED"
|
||
recordVersion:
|
||
type: "string"
|
||
pattern: "^(0|[1-9][0-9]*)$"
|
||
nullable: true
|
||
replayed:
|
||
type: "boolean"
|
||
result:
|
||
nullable: true
|
||
oneOf:
|
||
-
|
||
"$ref": "#/components/schemas/Detail"
|
||
-
|
||
"$ref": "#/components/schemas/Photo"
|
||
errorCode:
|
||
type: "string"
|
||
nullable: true
|
||
retryAllowed:
|
||
type: "boolean"
|
||
enum:
|
||
- false
|