开放平台

请求方式

POST /open/order/create

请求业务参数

参数名	类型	是否必须	说明
thirdOrderNo	string	是	第三方订单编号
outUserId	string	是	下单用户标识
address	object	是	收件人信息
address.name	string	是	收件人
address.phone	string	是	收件人手机号
address.province	string	是	省
address.city	string	是	市
address.district	string	是	区
address.address	string	是	详细地址
address.oaid	string	否	地址解密码
skus	object[]	是	sku列表
skus.{i}.customizeNo	string	是	定制单号
skus.{i}.resellerSkuId	int	是	resellerSkuId
skus.{i}.count	int	是	下单数量
skus.{i}.customize	object	否	定制详情（单个售卖商品必传）
skus.{i}.customize.previewList	string[]	否	预览图列表
skus.{i}.customize.partList	object[]	是	定制部件列表
skus.{i}.customize.partList.{j}.partIndex	int	是	部件序号
skus.{i}.customize.partList.{j}.maskUrl	string	否	刀线图url
skus.{i}.customize.partList.{j}.holeUrl	string	否	孔位图url
skus.{i}.customize.partList.{j}.holeUrls	string	否	孔位图url列表
skus.{i}.customize.partList.{j}.printList	object[]	是	印刷区域列表
skus.{i}.customize.partList.{j}.printList{k}.frontUrl	string	是	前景层图url
skus.{i}.customize.partList.{j}.printList{k}.backUrl	string	否	后景层图url
skus.{i}.customize.partList.{j}.printList{k}.whiteInkUrl	string	否	白墨层图url
skus.{i}.customize.partList.{j}.printList{k}.glossOilList	object[]	否	光油层列表
skus.{i}.customize.partList.{j}.printList{k}.glossOilList.{z}.url	string	是	光油层图url
skus.{i}.customize.partList.{j}.printList{k}.glossOilList.{z}.type	int	是	光油层类型
skus.{i}.customizes	object[]	否	定制详情（套装售卖商品必传）
skus.{i}.customizes{j}.previewList	string[]	否	预览图列表
skus.{i}.customizes{j}.count	int	否	套装内数量
skus.{i}.customizes{j}.partList	object[]	是	定制部件列表
skus.{i}.customizes{j}.partList.{k}.partIndex	int	是	部件序号
skus.{i}.customizes{j}.partList.{k}.maskUrl	string	否	刀线图url
skus.{i}.customizes{j}.partList.{k}.holeUrl	string	否	孔位图url
skus.{i}.customizes{j}.partList.{k}.holeUrls	string	否	孔位图url列表
skus.{i}.customizes{j}.partList.{k}.printList	object[]	是	印刷区域列表
skus.{i}.customizes{j}.partList.{k}.printList{z}.frontUrl	string	是	前景层图url
skus.{i}.customizes{j}.partList.{k}.printList{z}.backUrl	string	否	后景层图url
skus.{i}.customizes{j}.partList.{k}.printList{z}.whiteInkUrl	string	否	白墨层图url
skus.{i}.customizes{j}.partList.{k}.printList{z}.glossOilList	object[]	否	光油层列表
skus.{i}.customizes{j}.partList.{k}.printList{z}.glossOilList.{x}.url	string	是	光油层图url
skus.{i}.customizes{j}.partList.{k}.printList{z}.glossOilList.{x}.type	int	是	光油层类型

请求示例

单个售卖示例

{
    "timestamp": 1710471082,
    "sign": "",
    "resellerId": 10000,
    "version": 1,
    "bizContent": {
        "thirdOrderNo": "20240328-87436723343",
        "outUserId": "outUserId",
        "address": {
            "name": "张三",
            "phone": "1*********9",
            "province": "浙江省",
            "city": "杭州市",
            "district": "西湖区",
            "address": "金*********梯"
        },
        "skus": [
            {
                "customizeNo": "customizeNo_1u346383123",
                "resellerSkuId": 7,
                "count": 1,
                "customize": {
                    "previewList": [
                        "https://img02.songzhaopian.cn/rzs/2024/03/27/rust/e1c2c5d4-3f63-44b2-97b6-cb7be7ca7d3c.png"
                    ],
                    "partList": [
                        {
                            "partIndex": 1,
                            "printList": [
                                {
                                    "printIndex": 1,
                                    "frontUrl": "https://img02.songzhaopian.cn/rzs/2024/03/27/rust/e1c2c5d4-3f63-44b2-97b6-cb7be7ca7d3c.png",
                                    "whiteInkUrl": "https://img02.songzhaopian.cn/rzs/2024/03/27/00693db4-9606-491e-b0a7-c23224123659.png"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

套装售卖示例

{
    "timestamp": 1716969171,
    "sign": "276a8aa2f78d6dd03a020aa4835f6114",
    "resellerId": 10000,
    "version": 1,
    "bizContent": {
        "thirdOrderNo": "20241014_001",
        "outUserId": "outUserId123",
        "address": {
            "name": "张三",
            "phone": "1*********9",
            "province": "浙江省",
            "city": "杭州市",
            "district": "西湖区",
            "address": "金*********梯"
        },
        "skus": [
            {
                "customizeNo": "20241014_001",
                "resellerSkuId": 3298,
                "count": 1,
                "customizes": [
                    {
                        "previewList": [
                            "https://img02.songzhaopian.cn/rzt/2024/10/14/a462e277-ba7e-4c9a-ae95-6fae01a0d1f3.jpg"
                        ],
                        "count": 6,
                        "partList": [
                            {
                                "partIndex": 1,
                                "printList": [
                                    {
                                        "frontUrl": "https://img02.songzhaopian.cn/resource/2024/10/11/a3748f82-6f79-4ee9-a3e9-0eabee13b8dc.png",
                                        "printIndex": 1
                                    }
                                ]
                            },
                            {
                                "partIndex": 2,
                                "printList": [
                                    {
                                        "frontUrl": "https://img02.songzhaopian.cn/resource/2024/10/11/a3748f82-6f79-4ee9-a3e9-0eabee13b8dc.png",
                                        "printIndex": 1
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "count": 4,
                        "partList": [
                            {
                                "partIndex": 1,
                                "printList": [
                                    {
                                        "frontUrl": "https://img02.songzhaopian.cn/resource/2024/10/11/a3748f82-6f79-4ee9-a3e9-0eabee13b8dc.png",
                                        "printIndex": 1
                                    }
                                ]
                            },
                            {
                                "partIndex": 2,
                                "printList": [
                                    {
                                        "frontUrl": "https://img02.songzhaopian.cn/resource/2024/10/11/a3748f82-6f79-4ee9-a3e9-0eabee13b8dc.png",
                                        "printIndex": 1
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

响应示例

{
    "code": 0,
    "data": {
        "outUserId": "outUserId",
        "unionOrderNo": "1711594562688294261637727",
        "thirdOrderNo": "20240328-87436723343",
        "address": {
            "name": "张三",
            "phone": "1*********9",
            "province": "浙江省",
            "city": "杭州市",
            "district": "西湖区",
            "address": "金*********梯"
        },
        "subOrderList": [
            {
                "orderNo": "1711594562691364814519646",
                "orderStatus": 6,
                "skus": [
                    {
                        "customizeNo": "customizeNo_1u346383123",
                        "resellerSkuId": 7,
                        "count": 1
                    }
                ]
            }
        ]
    },
    "message": "成功"
}

光油层类型

状态值	说明
7	烫金
8	烫银
9	镭射银
10	镭射金
11	烫红
12	烫蓝

错误码

值	说明
5000000	参数校验错误
5000001	系统繁忙
5000002	配置异常
6000000	地址解密失败
6000003	手机号格式不正确
6000004	sku未上线
6000005	sku不存在
6000006	定制参数不允许为空
6000007	套装定制参数不允许为空
6000008	套装数量不正确
6000014	部件不完整
6000015	部件打印区域不完整
6000016	前景层url必传
6000017	孔位图url和孔位图列表不能同时传
6000018	不需要刀线图
6000019	不需要孔位图
6000020	不需要白墨图
6000021	光油层不能为空
6000022	未支持的光油层
6000023	不需要该光油层
6000024	结算异常
6000025	没有可生成的订单
6000026	三方单号不允许重复
6000027	定制单号不允许重复
6000028	定制类型异常

请求方式 ​

请求业务参数 ​

请求示例 ​

单个售卖示例 ​

套装售卖示例 ​

响应示例 ​

光油层类型 ​

错误码 ​

请求方式

请求业务参数

请求示例

单个售卖示例

套装售卖示例

响应示例

光油层类型

错误码