探马OpenAPI

批量创建/更新订单

POST

/external/order/batchImport

信息

订单不存在则新增，存在则更新。
更新时只支持更新订单状态（状态不能回退，比如不能从已支付改为待支付）、订单金额、订单自定义字段。

注意

接口限制频率：200次/分钟

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

batchId

string

订单批次id

必需

唯一

orderList

array [object {2}]

订单列表

必需

最大100笔

order

object

订单详情

必需

goods

array [object {4}]

商品列表

必需

示例

{
    "batchId": "7f45bbd6-a535-4b06-b7e4-4d1ff7fefdae",
    "orderList": [
        {
            "order": {
                "channelId": "123456",
                "channelName": "测试商城",
                "shopId": "2123456",
                "shopName": "卖的好",
                "unionId": "ob3TSvigVFYihdr_KjBT-YsRrtI0",
                "mobile": "15212312312",
                "orderId": "Esfa78416978",
                "orderPrice": 60,
                "orderStatus": 2,
                "orderTime": "2021-04-09 15:35:36"
            },
            "goods": [
                {
                    "goodName": "粘锅",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 30,
                    "num": 1
                },
                {
                    "goodName": "铲子",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 15,
                    "num": 2
                }
            ]
        },
        {
            "order": {
                "channelId": "123456",
                "channelName": "测试商城",
                "shopId": "2123456",
                "shopName": "卖的好",
                "unionId": "ob3TSvigVFYihdr_KjBT-YsRrtI0",
                "mobile": "15212312312",
                "orderId": "Esfa78416978",
                "orderPrice": 60,
                "orderStatus": 2,
                "orderTime": "2021-04-09 15:35:36"
            },
            "goods": [
                {
                    "goodName": "粘锅",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 30,
                    "num": 1
                },
                {
                    "goodName": "铲子",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 15,
                    "num": 2
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/external/order/batchImport' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batchId": "7f45bbd6-a535-4b06-b7e4-4d1ff7fefdae",
    "orderList": [
        {
            "order": {
                "channelId": "123456",
                "channelName": "测试商城",
                "shopId": "2123456",
                "shopName": "卖的好",
                "unionId": "ob3TSvigVFYihdr_KjBT-YsRrtI0",
                "mobile": "15212312312",
                "orderId": "Esfa78416978",
                "orderPrice": 60,
                "orderStatus": 2,
                "orderTime": "2021-04-09 15:35:36"
            },
            "goods": [
                {
                    "goodName": "粘锅",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 30,
                    "num": 1
                },
                {
                    "goodName": "铲子",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 15,
                    "num": 2
                }
            ]
        },
        {
            "order": {
                "channelId": "123456",
                "channelName": "测试商城",
                "shopId": "2123456",
                "shopName": "卖的好",
                "unionId": "ob3TSvigVFYihdr_KjBT-YsRrtI0",
                "mobile": "15212312312",
                "orderId": "Esfa78416978",
                "orderPrice": 60,
                "orderStatus": 2,
                "orderTime": "2021-04-09 15:35:36"
            },
            "goods": [
                {
                    "goodName": "粘锅",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 30,
                    "num": 1
                },
                {
                    "goodName": "铲子",
                    "imageUrl": "https://mmbiz.qpic.cn/mmbiz_png/40tIia9XPiaCtD1ZoSIK0kZVf8BWCgKiaWMhhlxJlYL03fgL2ZWMUPvnLLsVAz8SKdyFUu2egTGE8m0badnVaVF6A/640?wx_fmt=png",
                    "goodPrice": 15,
                    "num": 2
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

示例：0

必需

message

string

必需

示例：success

示例

成功示例异常示例

{
    "code": 0,
    "message": "success"
}

修改于 2023-06-09 03:39:47

创建/更新订单

批量创建/更新订单结果查询接口