1. 1688 订单管理
大吉开放平台 API
  • 大吉开放平台API
    • 产品文档
      • 平台概述
      • 成为开发者
      • Access Key和Access 密钥
      • 接口签名规则(sign)
      • 1688 API 说明
      • Taobao API 说明
      • 常见问题
    • 1688-API
      • 1688 商机
        • 查询榜单列表
        • 查询商品每日销售趋势
      • 1688 订单管理
        • 预览订单
          POST
        • 创建订单
          POST
        • 取消订单
          POST
        • 确认收货
          POST
        • 查询订单详情
          POST
        • 查询订单列表
          POST
      • 1688 其他接口
        • 多语言搜索导航
      • 1688 订单支付
        • 批量获取订单的支付链接
        • 发起免密支付
      • 1688 商品搜索
        • 上传图片获取imageId
        • 图片搜索
        • 关键词搜索
        • 商品详情搜索
        • 店铺搜索
        • 商品运费查询
        • 类目查询
        • 商品详情搜索-支持短链
      • 1688-API调试
        • 1688 签名&枚举
        • 上传图片获取imageId
        • 图片搜索
        • 关键词搜索
        • 商品详情搜索
        • 店铺搜索
        • 商品运费查询
        • 类目查询
        • 商品详情搜索-支持短链
        • 查询榜单列表
        • 查询商品每日销售趋势
        • 预览订单
        • 创建订单
        • 取消订单
        • 确认收货
        • 查询订单详情
        • 查询订单列表
        • 批量获取订单的支付链接
        • 发起免密支付
        • 多语言搜索导航
        • 1688 交易消息
        • 1688消息-签名验证
        • 1688 API
    • Taobao-API
      • Taobao-Tmall-API
        • Taobao/Tmall 签名&枚举
        • 上传图片
        • 图片搜索V1.0
        • 图片搜索V2.0
        • 关键词搜索
        • 店铺搜索
        • 商品详情搜索
        • 榜单类型搜索
        • 榜单商品搜索
        • 商品运费查询
        • 商品详情搜索-支持短链
        • 批量商品运费查询
        • 商品详情搜索V2
        • 商品运费查询 V2
        • 批量商品运费查询 V2
        • 撞库接口
        • 预览商品
        • 创建订单
        • 取消订单
        • 查询订单
        • 支付订单
        • 订单消息
        • 订单消息-签名验证
        • Taobao / Tmall API
      • Taobao API调试
        • Tmall 订单管理
          • 撞库接口
          • 预览商品
          • 创建订单
          • 取消订单
          • 查询订单
        • Tmall 订单支付
          • 支付订单
        • Tmall 商品搜索
          • 上传图片
          • 图片搜索V1.0
          • 图片搜索V2.0
          • 关键词搜索
          • 店铺搜索
          • 商品详情搜索V2
          • 榜单类型搜索
          • 榜单商品搜索
          • 商品运费查询 V2
          • 商品详情搜索-支持短链
          • 批量商品运费查询 V2
    • Poizon-API
      • Poizon 关键词搜索
      • Poizon 商品详情
      • Poizon API调试
        • 得物商品搜索
          • Poizon 关键词搜索
          • Poizon 商品详情
  1. 1688 订单管理

预览订单

POST
/alibaba/createOrder/preview
预览订单,只允许提交同一个卖家的商品,本接口返回创建订单相关的运费与折扣等信息(1、校验商品数据是否允许订购,2、校验库存、起批量、是否满足混批条件,3、中国段运费与折扣信息)

请求参数

Body 参数application/json

示例
{
    "appKey": "",
    "appSecret": "",
    "flow": "general",
    "addressParam": {
        "fullName": "张三",
        "mobile": "18888888888",
        "phone": "18888888888",
        "postCode": "000000",
        "cityText": "杭州市",
        "provinceText": "浙江省",
        "areaText": "滨江区",
        "townText": "镇文本",
        "address": "网商路699号",
        "districtCode": "310107"
    },
    "cargoParamList": [
        {
            "specId": "594b40c111b019af610a0078e4316373",
            "quantity": 1,
            "offerId": 670291644950
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/alibaba/createOrder/preview' \
--header 'Content-Type: application/json' \
--data '{
    "appKey": "",
    "appSecret": "",
    "flow": "general",
    "addressParam": {
        "fullName": "张三",
        "mobile": "18888888888",
        "phone": "18888888888",
        "postCode": "000000",
        "cityText": "杭州市",
        "provinceText": "浙江省",
        "areaText": "滨江区",
        "townText": "镇文本",
        "address": "网商路699号",
        "districtCode": "310107"
    },
    "cargoParamList": [
        {
            "specId": "594b40c111b019af610a0078e4316373",
            "quantity": 1,
            "offerId": 670291644950
        }
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 200,
    "message": "操作成功",
    "data": {
        "orderPreviewResuslt": [
            {
                "discountFee": null,
                "tradeModeNameList": [
                    "assureTrade"
                ],
                "status": true,
                "taoSampleSinglePromotion": false,
                "sumPayment": 1671,
                "message": null,
                "sumCarriage": 350,
                "resultCode": null,
                "sumPaymentNoCarriage": 1321,
                "additionalFee": null,
                "flowFlag": "general",
                "cargoList": [
                    {
                        "amount": 13.21,
                        "message": null,
                        "finalUnitPrice": 13.9,
                        "specId": "594b40c111b019af610a0078e4316373",
                        "skuId": 4829152353068,
                        "resultCode": null,
                        "offerId": 670291644950,
                        "cargoPromotionList": [
                            {
                                "promotionId": "plus-1081365079-901378548216|AliB2Bdszk-64971405656_901378548216",
                                "selected": false,
                                "text": "省0.69:PLUS会员价",
                                "desc": "<ul><li>PLUS会员价:省0.69元</li></ul>",
                                "freePostage": false,
                                "discountFee": 69
                            }
                        ],
                        "openOfferId": "/nlXn4qH5YNFo9hwZ8PEsA=="
                    }
                ],
                "shopPromotionList": [],
                "tradeModelList": [
                    {
                        "tradeWay": null,
                        "name": "担保交易",
                        "tradeType": "assureTrade",
                        "description": "买家下单后5天内支付全款,逾期付款,交易关闭。付款成功后卖家发货,买家在10天内确认收货。注:买家可使用1688网站提供的多种支付方式完成付款。特别提醒:如卖家已开通极速到账服务,将优先适用极速到账交易,买家支付款项将在买家下单并支付成功后或卖家发货后直接打入卖家账户。若买家在确认收货之前发起退款,杭州阿里巴巴智融数字技术有限公司提供非融资性担保服务,将保障除虚假、刷单等恶意行为之外的买家权益,在卖家没有及时向买家支付退款的情况下,代卖家向买家支付退款,并因此有权向卖家追偿所支付的退款。",
                        "opSupport": true
                    }
                ],
                "payChannelList": null,
                "payChannelInfos": [
                    {
                        "name": "alipay",
                        "amountLimit": null
                    },
                    {
                        "name": "shegou",
                        "amountLimit": 30000
                    }
                ]
            }
        ],
        "success": true,
        "errorCode": null,
        "errorMsg": null,
        "postFeeByDescOfferList": null,
        "consignOfferList": null,
        "unsupportedCrossBorderPayOfferList": []
    },
    "timestamp": 1723613421492,
    "traceId": "3f8ececcae29"
}
修改于 2026-07-31 07:36:47
上一页
查询商品每日销售趋势
下一页
创建订单
Built with