Create Platform Delivery

• 创建平台送仓单

Request

• Path: oms/wms/platform-delivery/create
• Method: POST
• Header:
  • Authorization: Basic c2FiZXI6c2FiZXJfc2VjcmV0
  • Blade-Auth: access_token
• Full Url: http://api.q9610.com/oms/wms/platform-delivery/create
• Request body example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

{
    "inboundPlanId": "PLN2024010001",
    "relatedDocNo": "PO2024010001",
    "subOrderNo": "SUB001",
    "shipDate": "2024-01-20",
    "platformLogisticCenter": "CGN1",
    "platformLogisticType": "milkrun_pallet",
    "platformAddress": "경기도 이천시 마장면 덕평대로 560",
    "caseNumbers": 5,
    "tenantId": "000001",
    "remark": "备注信息",
    "shippingPlaceInfo": "发货地信息",
    "boxes": [
        {
            "reservation_code": "RC20240120001",
            "boxNo": "BOX-001",
            "shipNo": "SHIP20240120001",
            "mark": "MARK001",
            "details": [
                {
                    "detailId": 12425,
                    "boxId": 18008,
                    "headerId": 16241,
                    "goodsId": 31270,
                    "amount": 100,
                    "platformGoodsId": "PLAT-GOODS-001",
                    "sku": "SKU-001",
                    "boxNumber": "BOX-001",
                    "invoiceNumber": "INV20240120001",
                    "skuName": "商品名称",
                    "vendorItemId": "VENDOR-ITEM-001",
                    "vendorInventoryId": "VENDOR-INV-001",
                    "skuBarcode": "BARCODE-001",
                    "shippingQty": 100,
                    "receivedQty": 0,
                    "rejectedQty": 0,
                    "imgUrl": "https://example.com/image.jpg",
                    "coupangImgUrl": "https://coupang.com/image.jpg"
                }
            ]
        }
    ],
    "attachments": [
        {
            "name": "附件1.pdf",
            "url": "https://example.com/attachment1.pdf"
        }
    ]
}

Request Params Detail

主体参数

• inboundPlanId

  • 描述：送仓计划编号
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• relatedDocNo

  • 描述：关联单据号（备货申请单编号或授权码）
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• subOrderNo

  • 描述：分单号
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• shipDate

  • 描述：送仓日期
  • 类型：日期（格式：YYYY-MM-DD）
  • 必填：是

• platformLogisticCenter

  • 描述：物流中心编码
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• platformLogisticType

  • 描述：送仓方式
  • 类型：字符
  • 长度：255 字符
  • 必填：是
  • 可选值：
    • milkrun_pallet Milkrun托盘
    • milkrun_parcel Milkrun快递
    • milkrun_truck Milkrun卡车
    • truck 卡车配送
    • parcel 快递配送

• platformAddress

  • 描述：送仓地址
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• caseNumbers

  • 描述：件数/托盘数
  • 类型：整数
  • 必填：否

• tenantId

  • 描述：租户ID
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• remark

  • 描述：备注
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• shippingPlaceInfo

  • 描述：发货地信息
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• boxes

  • 描述：箱子列表
  • 类型：数组
  • 必填：是
  • 详见：箱子信息 (BoxInfo)

• attachments

  • 描述：附件列表
  • 类型：数组
  • 必填：否
  • 详见：附件信息 (AttachmentInfo)

箱子信息 (BoxInfo)

• reservation_code

  • 描述：预约码/物流粘贴文件箱号
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• boxNo

  • 描述：出口箱唛
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• shipNo

  • 描述：快递单号
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• mark

  • 描述：唛头
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• details

  • 描述：商品明细
  • 类型：数组
  • 必填：否
  • 详见：商品明细 (PlatformDeliveryDetailReqDTO)

附件信息 (AttachmentInfo)

• name

  • 描述：附件名称
  • 类型：字符
  • 长度：255 字符
  • 必填：是

• url

  • 描述：附件URL
  • 类型：字符
  • 长度：255 字符
  • 必填：是

商品明细 (PlatformDeliveryDetailReqDTO)

• detailId

  • 描述：送仓单detailId
  • 类型：长整型
  • 必填：是

• boxId

  • 描述：箱号id
  • 类型：长整型
  • 必填：否

• headerId

  • 描述：送仓单编号
  • 类型：长整型
  • 必填：否

• goodsId

  • 描述：商品编号
  • 类型：长整型
  • 必填：否

• amount

  • 描述：送仓数量
  • 类型：长整型
  • 必填：否

• platformGoodsId

  • 描述：平台商品ID
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• sku

  • 描述：SKU
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• boxNumber

  • 描述：箱号
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• invoiceNumber

  • 描述：快递单号
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• skuName

  • 描述：商品名称
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• vendorItemId

  • 描述：商品属性
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• vendorInventoryId

  • 描述：货品仓库ID
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• skuBarcode

  • 描述：贴标sku
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• shippingQty

  • 描述：入仓创建数量
  • 类型：整型
  • 必填：否

• receivedQty

  • 描述：入库数量
  • 类型：整型
  • 必填：否

• rejectedQty

  • 描述：错误数量
  • 类型：整型
  • 必填：否

• imgUrl

  • 描述：图片地址
  • 类型：字符
  • 长度：255 字符
  • 必填：否

• coupangImgUrl

  • 描述：coupang图片地址
  • 类型：字符
  • 长度：255 字符
  • 必填：否

Response

• Response body example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

{
    "code": 200,
    "success": true,
    "data": [
        {
            "headerId": 25017,
            "headerCode": "PD20240120001",
            "weight": 50.00,
            "square": 1.50,
            "tray": 2,
            "sumAmount": 500,
            "caseNumbers": 5,
            "authCode": "AUTH001",
            "reservationCode": "RC20240120001",
            "platformName": "COUPANG",
            "platformLogisticType": "milkrun_pallet",
            "platformAddressId": 9596,
            "platformAddress": "경기도 이천시 마장면 덕평대로 560",
            "shipNo": "SHIP20240120001",
            "isPallet": "1",
            "attachLabel": "1",
            "orderId": "6575",
            "orderFeeId": 17554,
            "status": "pending",
            "remark": "备注信息",
            "shipDate": "2024-01-20T10:00:00",
            "deliveryTime": "2024-01-21T14:30:00",
            "deliveryBy": "配送员",
            "receivedTime": "2024-01-22T09:00:00",
            "receivedBy": "收货员",
            "companyCode": "COMPANY001",
            "platformCenterAddress": "平台中心地址",
            "consigneePhone": "010-1234-5678",
            "outFromKrWarehouse": "1",
            "outstockHeaderId": 1542,
            "inboundPlanId": "PLN2024010001",
            "purchaseHeaderId": 19090,
            "shipmentId": "SHIP001",
            "purchaseOrderSeq": "PO-SEQ-001",
            "shippingQty": 500,
            "receivedQty": 0,
            "internalLifecycleStatus": "created",
            "containsRejection": "0",
            "internalLifecycleDate": 1705708800000,
            "rejectedQty": 0,
            "shipmentType": "parcel",
            "edd": "2024-01-25",
            "centerCode": "CGN1",
            "invoiceNumber": "INV20240120001",
            "carrierName": "CJ大韩通运",
            "shippingPlaceInfo": "发货地信息",
            "parcelBarcode": "PARCEL-BARCODE-001",
            "cancelledTime": null,
            "sourceType": 1,
            "boxSeq": 1,
            "settlementStatus": "pending",
            "bizNo": "BIZ-001",
            "hbNo": "HB-001",
            "tenantId": "000001",
            "createTime": "2024-01-20T10:00:00",
            "creator": "admin",
            "attachments": [
                {
                    "id": 2547,
                    "bizId": 9696,
                    "name": "附件1.pdf",
                    "url": "https://example.com/attachment1.pdf",
                    "bizType": "1",
                    "createTime": "2024-01-20T10:00:00"
                }
            ],
            "details": [
                {
                    "detailId": 12425,
                    "boxId": 18008,
                    "headerId": 16241,
                    "goodsId": 31270,
                    "amount": 100,
                    "platformGoodsId": "PLAT-GOODS-001",
                    "sku": "SKU-001",
                    "boxNumber": "BOX-001",
                    "invoiceNumber": "INV20240120001",
                    "skuName": "商品名称",
                    "vendorItemId": "VENDOR-ITEM-001",
                    "vendorInventoryId": "VENDOR-INV-001",
                    "skuBarcode": "BARCODE-001",
                    "shippingQty": 100,
                    "receivedQty": 0,
                    "rejectedQty": 0,
                    "imgUrl": "https://example.com/image.jpg",
                    "coupangImgUrl": "https://coupang.com/image.jpg",
                    "tenantId": "000001",
                    "createTime": "2024-01-20T10:00:00"
                }
            ]
        }
    ],
    "msg": "操作成功"
}

Response Params Detail

主体响应参数

• headerId

  • 描述：订单编号
  • 类型：长整型

• headerCode

  • 描述：订单内部编号
  • 类型：字符

• weight

  • 描述：重量
  • 类型：数值

• square

  • 描述：方数
  • 类型：数值

• tray

  • 描述：托盘数
  • 类型：长整型

• sumAmount

  • 描述：数量
  • 类型：长整型

• caseNumbers

  • 描述：总件数
  • 类型：长整型

• authCode

  • 描述：授权码
  • 类型：字符

• reservationCode

  • 描述：预约码
  • 类型：字符

• platformName

  • 描述：平台名称
  • 类型：字符

• platformLogisticType

  • 描述：平台物流中心方式
  • 类型：字符
  • 可选值：
    • milkrun_pallet Milkrun托盘
    • milkrun_parcel Milkrun快递
    • milkrun_truck Milkrun卡车
    • truck 卡车配送
    • parcel 快递配送

• platformAddressId

  • 描述：平台送仓物流地址ID
  • 类型：长整型

• platformAddress

  • 描述：平台地址
  • 类型：字符

• shipNo

  • 描述：快递送仓单号
  • 类型：字符

• isPallet

  • 描述：是否打托
  • 类型：字符
  • 可选值：
    • 0 否
    • 1 是

• attachLabel

  • 描述：是否改标
  • 类型：字符
  • 可选值：
    • 0 否
    • 1 是

• orderId

  • 描述：送仓订单号
  • 类型：字符

• orderFeeId

  • 描述：费用结算ID
  • 类型：长整型

• status

  • 描述：状态
  • 类型：字符
  • 可选值：
    • pending 待入仓
    • pending_release 待放行
    • completed 已送仓

• remark

  • 描述：备注
  • 类型：字符

• shipDate

  • 描述：送仓时间
  • 类型：日期时间

• deliveryTime

  • 描述：实际送仓时间
  • 类型：日期时间

• deliveryBy

  • 描述：送仓人
  • 类型：字符

• receivedTime

  • 描述：入仓时间
  • 类型：日期时间

• receivedBy

  • 描述：入仓人
  • 类型：字符

• companyCode

  • 描述：店铺编码
  • 类型：字符

• platformCenterAddress

  • 描述：送仓地址
  • 类型：字符

• consigneePhone

  • 描述：电话
  • 类型：字符

• outFromKrWarehouse

  • 描述：从仁川仓库出库
  • 类型：字符
  • 可选值：
    • 0 否
    • 1 是

• outstockHeaderId

  • 描述：出库单编号
  • 类型：长整型

• inboundPlanId

  • 描述：送仓计划编号
  • 类型：字符

• purchaseHeaderId

  • 描述：备货申请单编号
  • 类型：长整型

• shipmentId

  • 描述：入库ID
  • 类型：字符

• purchaseOrderSeq

  • 描述：申请ID
  • 类型：字符

• shippingQty

  • 描述：送仓数量
  • 类型：整型

• receivedQty

  • 描述：入库数量
  • 类型：整型

• internalLifecycleStatus

  • 描述：平台入库单状态
  • 类型：字符

• containsRejection

  • 描述：平台是否包含错误
  • 类型：字符
  • 可选值：
    • 0 否
    • 1 是

• internalLifecycleDate

  • 描述：平台入库单状态时间（时间戳）
  • 类型：长整型

• rejectedQty

  • 描述：拒绝入库数量
  • 类型：整型

• shipmentType

  • 描述：送仓方式
  • 类型：字符

• edd

  • 描述：预计送仓到达日期
  • 类型：字符

• centerCode

  • 描述：送仓地址编码
  • 类型：字符

• invoiceNumber

  • 描述：送仓运单号
  • 类型：字符

• carrierName

  • 描述：送仓的快递公司
  • 类型：字符

• shippingPlaceInfo

  • 描述：发货地址
  • 类型：字符

• parcelBarcode

  • 描述：Coupang 发货代码
  • 类型：字符

• cancelledTime

  • 描述：送仓取消时间
  • 类型：日期

• sourceType

  • 描述：数据来源
  • 类型：整型
  • 可选值：
    • 1 系统创建

• boxSeq

  • 描述：箱号
  • 类型：整型

• settlementStatus

  • 描述：结算状态
  • 类型：字符

• bizNo

  • 描述：关联单据号
  • 类型：字符

• hbNo

  • 描述：分单号
  • 类型：字符

• tenantId

  • 描述：租户编号
  • 类型：字符

• createTime

  • 描述：创建时间
  • 类型：日期时间

• creator

  • 描述：创建人
  • 类型：字符

• attachments

  • 描述：附件列表
  • 类型：数组
  • 详见：附件响应信息 (CommonAttachmentRespVO)

• details

  • 描述：商品明细
  • 类型：数组
  • 详见：商品明细响应信息 (PlatformDeliveryDetailRespVO)

附件响应信息 (CommonAttachmentRespVO)

• id

  • 描述：编码
  • 类型：长整型

• bizId

  • 描述：关联单据ID
  • 类型：长整型

• name

  • 描述：附件名称
  • 类型：字符

• url

  • 描述：下载地址
  • 类型：字符

• bizType

  • 描述：业务类型
  • 类型：字符
  • 可选值：
    • 0 采购单
    • 1 送仓单
    • 2 退仓单

• createTime

  • 描述：创建时间
  • 类型：日期时间

商品明细响应信息 (PlatformDeliveryDetailRespVO)

• detailId

  • 描述：送仓单detailId
  • 类型：长整型

• boxId

  • 描述：箱号id
  • 类型：长整型

• headerId

  • 描述：送仓单编号
  • 类型：长整型

• goodsId

  • 描述：商品编号
  • 类型：长整型

• amount

  • 描述：送仓数量
  • 类型：长整型

• platformGoodsId

  • 描述：平台商品ID
  • 类型：字符

• sku

  • 描述：SKU
  • 类型：字符

• boxNumber

  • 描述：箱号
  • 类型：字符

• invoiceNumber

  • 描述：快递单号
  • 类型：字符

• skuName

  • 描述：商品名称
  • 类型：字符

• vendorItemId

  • 描述：商品属性
  • 类型：字符

• vendorInventoryId

  • 描述：货品仓库ID
  • 类型：字符

• skuBarcode

  • 描述：贴标sku
  • 类型：字符

• shippingQty

  • 描述：入仓创建数量
  • 类型：整型

• receivedQty

  • 描述：入库数量
  • 类型：整型

• rejectedQty

  • 描述：错误数量
  • 类型：整型

• imgUrl

  • 描述：图片地址
  • 类型：字符

• coupangImgUrl

  • 描述：coupang图片地址
  • 类型：字符

• tenantId

  • 描述：租户编号
  • 类型：字符

• createTime

  • 描述：创建时间
  • 类型：日期时间

Error Response

• 失败响应示例:

1
2
3
4
5
6

{
    "code": 500,
    "success": false,
    "data": null,
    "msg": "送仓计划编号不能为空"
}

• 可能的错误信息：
  • 送仓计划编号不能为空 - inboundPlanId 为空
  • 送仓日期不能为空 - shipDate 为空
  • 物流中心不能为空 - platformLogisticCenter 为空
  • 送仓方式不能为空 - platformLogisticType 为空
  • 送仓地址不能为空 - platformAddress 为空
  • 预约码不能为空 - boxes.reservation_code 为空
  • 附件名称不能为空 - attachments.name 为空
  • 附件URL不能为空 - attachments.url 为空