中文版
产品文档1688 APITaobao / Tmall APIPoizon API
产品文档1688 APITaobao / Tmall APIPoizon API
English
  1. 1688 订单管理
  • 1688 开发人员参考
  • 1688 商品搜索
    • 上传图片获取imageId
      POST
    • 图片搜索
      GET
    • 关键词搜索
      GET
    • 商品详情搜索
      GET
    • 店铺搜索
      GET
    • 商品运费查询
      POST
    • 类目查询
      GET
    • 商品详情搜索-支持短链
      GET
  • 1688 订单管理
    • 预览订单
      POST
    • 创建订单
      POST
    • 取消订单
      POST
    • 确认收货
      POST
    • 查询订单详情
      POST
    • 查询列表订单
      POST
  • 1688 订单支付
    • 批量获取订单的支付链接
      GET
    • 发起免密支付
      POST
  • 1688 其他接口
    • 多语言搜索导航
      GET
  • 1688 消息说明
    • 1688 交易消息
    • 1688消息-签名验证
  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 --request POST 'https://openapi.dajisaas.com/alibaba/createOrder/preview' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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
Body

示例
{
    "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"
}
修改于 2025-05-29 04:20:58
上一页
商品详情搜索-支持短链
下一页
创建订单
Built with