中文版
产品文档1688 APITaobao / Tmall API增值API
产品文档1688 APITaobao / Tmall API增值API
English
  1. 1688 订单管理
  • 1688 开发人员参考
  • 1688 商品搜索
    • 上传图片获取imageId
      POST
    • 图片搜索
      GET
    • 关键词搜索
      GET
    • 商品详情搜索
      GET
    • 店铺搜索
      GET
    • 商品运费查询
      POST
  • 1688 订单管理
    • 预览订单
      POST
    • 创建订单
      POST
    • 取消订单
      POST
    • 查询订单
      POST
    • 确认收货
      POST
  • 1688 订单支付
    • 批量获取订单的支付链接
      GET
    • 发起免密支付
      POST
  • 1688 其他接口
    • 类目查询
      GET
    • 多语言搜索导航
      GET
  • 1688 消息说明
    • 1688 交易消息
    • 1688消息-签名验证
  1. 1688 订单管理

预览订单

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

请求参数

Body 参数application/json
appKey
string 
必需
大吉平台appKey
appSecret
string 
可选
大吉平台appSecret
flow
string 
必需
general(创建大市场订单)
addressParam
object 
收货地址信息
必需
fullName
string 
收货人姓名
必需
mobile
string 
手机
必需
phone
string 
电话
必需
postCode
string 
邮编
必需
cityText
string 
必需
市文本,比如:杭州市
provinceText
string 
必需
省份文本,比如:浙江省
areaText
string 
必需
区文本,比如:滨江区
townText
string 
必需
镇文本,比如:长河镇
address
string 
必需
街道地址,比如:网商路699号
districtCode
string 
必需
地址编码,比如:310107
cargoParamList
array [object {3}] 
商品信息
必需
specId
string 
商品规格ID
可选
quantity
integer 
可选
商品数量(计算金额用)
offerId
integer 
可选
商品对应的offer id
示例
{
  "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
integer 
返回码
必需
message
string 
消息
必需
data
object 
业务数据
必需
orderPreviewResuslt
array [object {16}] 
必需
订单预览结果,自动拆单会返回多个记录
success
boolean 
是否成功
必需
errorCode
null 
错误码
必需
errorMsg
null 
错误信息
必需
postFeeByDescOfferList
null 
运费说明的商品列表
必需
consignOfferList
null 
代销商品列表
必需
unsupportedCrossBorderPayOfferList
array[string]
必需
不支持跨境宝支付的商品列表
timestamp
integer 
时间戳
必需
traceId
string 
traceId
必需
示例
{
  "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"
}
上一页
商品运费查询
下一页
创建订单
Built with