644 lines
19 KiB
YAML
644 lines
19 KiB
YAML
{
|
|
"openapi": "3.0.3",
|
|
"info": {
|
|
"title": "船期变化影响核对",
|
|
"version": "1.0.0"
|
|
},
|
|
"security": [
|
|
{
|
|
"bearerAuth": []
|
|
}
|
|
],
|
|
"paths": {
|
|
"/api/platform/v1/last-leg/appointment-planning/impacts": {
|
|
"get": {
|
|
"operationId": "listAppointmentImpacts",
|
|
"description": "仅平台主体，同时要求platform:appointment:list和platform:overseas-warehouse:last-mile-order:list。按现有美国活动柜次分页，impact为空表示尚未核对。GET不读取远程船期、不创建记录。",
|
|
"parameters": [
|
|
{
|
|
"name": "page",
|
|
"in": "query",
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"default": 1
|
|
}
|
|
},
|
|
{
|
|
"name": "size",
|
|
"in": "query",
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 100,
|
|
"default": 20
|
|
}
|
|
},
|
|
{
|
|
"name": "keyword",
|
|
"in": "query",
|
|
"schema": {
|
|
"type": "string",
|
|
"maxLength": 128
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "ApiResponse，业务成功code为字符串200",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/ImpactPage"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "非平台主体或缺少权限"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/platform/v1/last-leg/appointment-planning/impacts/refresh": {
|
|
"post": {
|
|
"operationId": "refreshAppointmentImpacts",
|
|
"description": "仅平台主体，同时要求platform:appointment:list和platform:overseas-warehouse:last-mile-order:list。写入另需platform:appointment:followup。显式批量核对当前页，一次Firstleg来源查询；范围不完整或来源失败保留原状态并报错。稳定柜次事项和追加观察历史，不改外部确认、订单或车次。来源时间时区未核实，不转换为UTC或推算备妥窗口。",
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"page": {
|
|
"type": "integer",
|
|
"minimum": 1
|
|
},
|
|
"size": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 100
|
|
},
|
|
"keyword": {
|
|
"type": "string",
|
|
"maxLength": 128
|
|
}
|
|
},
|
|
"required": [
|
|
"page",
|
|
"size"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "ApiResponse，业务成功code为字符串200",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/Impacts"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "非平台主体或缺少权限"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/platform/v1/last-leg/appointment-planning/impacts/{id}": {
|
|
"get": {
|
|
"operationId": "readAppointmentImpact",
|
|
"description": "仅平台主体，同时要求platform:appointment:list和platform:overseas-warehouse:last-mile-order:list。直接货物和预约按客户归属关联；运输明细另外要求platform:fleet:trip:list，无权时transport为null。sameTripBookings仅提示同车运输承诺复核，不断言直接延期。明细任一范围超过1000拒绝，不静默截断。历史服务端分页，业务确认时间保持原值。",
|
|
"parameters": [
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "内部柜次关联键，不作界面业务编号"
|
|
},
|
|
{
|
|
"name": "page",
|
|
"in": "query",
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"default": 1
|
|
}
|
|
},
|
|
{
|
|
"name": "size",
|
|
"in": "query",
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 100,
|
|
"default": 20
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "ApiResponse，业务成功code为字符串200",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/ImpactDetail"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "非平台主体或缺少权限"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/platform/v1/last-leg/appointment-planning/impacts/{id}/commands": {
|
|
"post": {
|
|
"operationId": "handleAppointmentImpact",
|
|
"description": "仅平台主体，同时要求platform:appointment:list和platform:overseas-warehouse:last-mile-order:list。写入另需platform:appointment:followup。CLAIM认领当前人；RECORD和RESOLVE必须填写实际结果。其他人已认领、事项版本或来源观察变化时拒绝；同操作者同键同体精确重放原响应。处理完成仅确认核对事项，绝不改约/撤销承运/改库存。处理后新预测变化重新打开同一事项。",
|
|
"parameters": [
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "内部柜次关联键，不作界面业务编号"
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"expectedVersion": {
|
|
"type": "integer",
|
|
"minimum": 0
|
|
},
|
|
"forecastToken": {
|
|
"type": "string"
|
|
},
|
|
"idempotencyKey": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"maxLength": 64
|
|
},
|
|
"action": {
|
|
"type": "string",
|
|
"enum": [
|
|
"CLAIM",
|
|
"RECORD",
|
|
"RESOLVE"
|
|
]
|
|
},
|
|
"result": {
|
|
"type": "string",
|
|
"nullable": true,
|
|
"maxLength": 1000
|
|
},
|
|
"nextAction": {
|
|
"type": "string",
|
|
"nullable": true,
|
|
"maxLength": 500
|
|
},
|
|
"followupDate": {
|
|
"type": "string",
|
|
"format": "date",
|
|
"nullable": true
|
|
}
|
|
},
|
|
"required": [
|
|
"expectedVersion",
|
|
"forecastToken",
|
|
"idempotencyKey",
|
|
"action"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "ApiResponse，业务成功code为字符串200",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/Impact"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "非平台主体或缺少权限"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"securitySchemes": {
|
|
"bearerAuth": {
|
|
"type": "http",
|
|
"scheme": "bearer",
|
|
"bearerFormat": "JWT"
|
|
}
|
|
},
|
|
"schemas": {
|
|
"Fact": {
|
|
"type": "object",
|
|
"properties": {
|
|
"containerBookingId": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"factId": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"providerCode": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"sourceReference": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"observedAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"estimatedAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"actualAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
}
|
|
},
|
|
"nullable": true
|
|
},
|
|
"Impact": {
|
|
"type": "object",
|
|
"properties": {
|
|
"containerBookingId": {
|
|
"type": "string"
|
|
},
|
|
"impactNo": {
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"MONITORING",
|
|
"OPEN",
|
|
"RESOLVED"
|
|
]
|
|
},
|
|
"reason": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"ownerId": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"ownerName": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"baseline": {
|
|
"$ref": "#/components/schemas/Fact"
|
|
},
|
|
"latest": {
|
|
"$ref": "#/components/schemas/Fact"
|
|
},
|
|
"forecastToken": {
|
|
"type": "string"
|
|
},
|
|
"updatedAt": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"ImpactPage": {
|
|
"type": "object",
|
|
"properties": {
|
|
"records": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"container": {
|
|
"type": "object",
|
|
"properties": {
|
|
"containerBookingId": {
|
|
"type": "string"
|
|
},
|
|
"containerNo": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"orderCount": {
|
|
"type": "integer"
|
|
},
|
|
"customerCount": {
|
|
"type": "integer"
|
|
},
|
|
"packages": {
|
|
"type": "integer",
|
|
"nullable": true
|
|
},
|
|
"unknownPackageOrders": {
|
|
"type": "integer"
|
|
},
|
|
"earliestArrivalAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"latestArrivalAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"standardNode": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"sourceVersion": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"incompleteScope": {
|
|
"type": "boolean"
|
|
},
|
|
"warehouses": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"warehouseId": {
|
|
"type": "string"
|
|
},
|
|
"warehouseName": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"orderCount": {
|
|
"type": "integer"
|
|
},
|
|
"customerCount": {
|
|
"type": "integer"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"impact": {
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/Impact"
|
|
}
|
|
],
|
|
"nullable": true
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"total": {
|
|
"type": "integer",
|
|
"format": "int64"
|
|
},
|
|
"page": {
|
|
"type": "integer"
|
|
},
|
|
"size": {
|
|
"type": "integer"
|
|
},
|
|
"pages": {
|
|
"type": "integer"
|
|
}
|
|
}
|
|
},
|
|
"Impacts": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/components/schemas/Impact"
|
|
}
|
|
},
|
|
"ImpactDetail": {
|
|
"type": "object",
|
|
"properties": {
|
|
"impact": {
|
|
"$ref": "#/components/schemas/Impact"
|
|
},
|
|
"cargo": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"customerId": {
|
|
"type": "string"
|
|
},
|
|
"orderId": {
|
|
"type": "string"
|
|
},
|
|
"inboundCode": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"customerName": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"packages": {
|
|
"type": "integer",
|
|
"nullable": true
|
|
},
|
|
"destination": {
|
|
"type": "string",
|
|
"nullable": true
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"appointments": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"appointmentNo": {
|
|
"type": "string"
|
|
},
|
|
"status": {
|
|
"type": "string"
|
|
},
|
|
"destination": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"confirmedAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"timezone": {
|
|
"type": "string",
|
|
"nullable": true
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"transport": {
|
|
"type": "object",
|
|
"properties": {
|
|
"trips": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"tripNo": {
|
|
"type": "string"
|
|
},
|
|
"status": {
|
|
"type": "string"
|
|
},
|
|
"plannedDepartureAt": {
|
|
"type": "string",
|
|
"nullable": true
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"sameTripBookings": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"tripNo": {
|
|
"type": "string"
|
|
},
|
|
"bookingNo": {
|
|
"type": "string"
|
|
},
|
|
"customerName": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"destinationLabel": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"status": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"nullable": true
|
|
},
|
|
"history": {
|
|
"type": "object",
|
|
"properties": {
|
|
"records": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"action": {
|
|
"type": "string"
|
|
},
|
|
"operatorName": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"result": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"nextAction": {
|
|
"type": "string",
|
|
"nullable": true
|
|
},
|
|
"followupDate": {
|
|
"type": "string",
|
|
"format": "date",
|
|
"nullable": true
|
|
},
|
|
"createdAt": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"total": {
|
|
"type": "integer",
|
|
"format": "int64"
|
|
},
|
|
"page": {
|
|
"type": "integer"
|
|
},
|
|
"size": {
|
|
"type": "integer"
|
|
},
|
|
"pages": {
|
|
"type": "integer"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|