创建一件代发出库(支持批量)

POST

/openapi/order/create

「发送方式」「配送日期」「配送时间段」的参数规则：

参数	示例	说明
指定发送方式	`AUTO` / `yamato_takkyubin`	`AUTO`：系统自动选择；`yamato_takkyubin`：ヤマト運輸・宅配便
指定配送日期	`2026-08-12`	格式：`yyyy-MM-dd`；`null`：不设置
指定配送时间段	`812`	`812`：08:00-12:00；`1416`：14:00-16:00；`1618`：16:00-18:00；`1820`：18:00-20:00；`1921`：19:00-21:00；`null`：不设置

指定配送时间段

支持以下编码：

812   = 08:00-12:00
1416  = 14:00-16:00
1618  = 16:00-18:00
1820  = 18:00-20:00
1921  = 19:00-21:00
null  = 不设置

参数说明：

指定发送方式编码：AUTO 表示系统自动选择；yamato_takkyubin 表示ヤマト運輸・宅配便。
指定配送日期：格式为 yyyy-MM-dd，例如 2026-08-12；传入 null 表示不设置。
指定配送时间段：传入对应时间段编码；传入 null 表示不设置。

请求参数

Header 参数

Body 参数application/json

示例

{
    "warehouseCode": "TYO-WH01",
    "planName": "",
    "remark": "plan test",
    "orderList": [
        {
            "sourceOrderNo": "TEST-20260630174503120",
            "receiverName": "TEST USER 1",
            "receiverPhone": "09012345678",
            "receiverPostcode": "1000001",
            "receiverPrefecture": "東京都",
            "receiverCity": "千代田区",
            "recipientAddress1": "丸の内1-1-1",
            "recipientAddress2": "TEST BUILDING 101",
            "specifiedCarrier": "AUTO",
            "deliveryDate": null,
            "deliveryTimeSlot": null,
            "remark": "first test order",
            "items": [
                {
                    "sku": "TEST-SKU-01",
                    "quantity": 2
                },
                {
                    "sku": "TEST-SKU-02",
                    "quantity": 1
                }
            ]
        },
        {
            "sourceOrderNo": "TEST-20260630174504131",
            "platformType": "OPENAPI",
            "receiverName": "TEST USER 2",
            "receiverPhone": "08098765432",
            "receiverPostcode": "1500001",
            "receiverPrefecture": "東京都",
            "receiverCity": "渋谷区",
            "recipientAddress1": "神宮前1-2-3",
            "recipientAddress2": "ROOM 202",
            "specifiedCarrier": "yamato_takkyubin",
            "deliveryDate": "2026-09-30",
            "deliveryTimeSlot": "812",
            "remark": "second test order",
            "items": [
                {
                    "sku": "TEST-SKU-03",
                    "quantity": 1
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://oms.osl.sohomall.jp/api/openapi/order/create' \
--header 'App-Key;' \
--header 'Nonce;' \
--header 'Sign;' \
--header 'Timestamp;' \
--header 'Content-Type: application/json' \
--data '{
    "warehouseCode": "TYO-WH01",
    "planName": "",
    "remark": "plan test",
    "orderList": [
        {
            "sourceOrderNo": "TEST-20260630174503120",
            "receiverName": "TEST USER 1",
            "receiverPhone": "09012345678",
            "receiverPostcode": "1000001",
            "receiverPrefecture": "東京都",
            "receiverCity": "千代田区",
            "recipientAddress1": "丸の内1-1-1",
            "recipientAddress2": "TEST BUILDING 101",
            "specifiedCarrier": "AUTO",
            "deliveryDate": null,
            "deliveryTimeSlot": null,
            "remark": "first test order",
            "items": [
                {
                    "sku": "TEST-SKU-01",
                    "quantity": 2
                },
                {
                    "sku": "TEST-SKU-02",
                    "quantity": 1
                }
            ]
        },
        {
            "sourceOrderNo": "TEST-20260630174504131",
            "platformType": "OPENAPI",
            "receiverName": "TEST USER 2",
            "receiverPhone": "08098765432",
            "receiverPostcode": "1500001",
            "receiverPrefecture": "東京都",
            "receiverCity": "渋谷区",
            "recipientAddress1": "神宮前1-2-3",
            "recipientAddress2": "ROOM 202",
            "specifiedCarrier": "yamato_takkyubin",
            "deliveryDate": "2026-09-30",
            "deliveryTimeSlot": "812",
            "remark": "second test order",
            "items": [
                {
                    "sku": "TEST-SKU-03",
                    "quantity": 1
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "planId": "2100826619461980160",
        "planNo": "CKC035026091802570001",
        "totalQuantity": 1,
        "successQuantity": 1,
        "failQuantity": 0,
        "failList": []
    }
}

修改于 2026-09-23 08:06:30

查询运输公司列表

查询订单状态

创建一件代发出库(支持批量)

指定配送时间段#

请求参数

请求示例代码

返回响应

指定配送时间段