English
Product Documentation1688 APITaobao/Tmall API
Product Documentation1688 APITaobao/Tmall API
中文
  1. 1688 Order Manage
  • 1688 Solution Introduction
  • 1688 Product Search
    • Image upload By Get
      GET
    • Image upload By Post
      POST
    • Image search
      GET
    • keyword search
      GET
    • Product details search
      GET
  • 1688 Order Manage
    • Preview order
      POST
    • Create order
      POST
    • Cancel order
      POST
    • View order details
      POST
    • Buyer confirms receipt
      POST
  • 1688 Oder Pay
    • Get payment links for orders in batches
      GET
    • Initiate password-free payment
      POST
  • 1688 Message Service
    • 1688 Message Service
  1. 1688 Order Manage

Preview order

POST
/alibaba/createOrder/preview
Preview orders only allow purchases from the same supplier. This interface returns discounts and other information related to creating an order.
1.
Verify whether the product data allows ordering. 2. Verify the consignment relationship 3. Verify inventory, minimum batch size, and whether mixed batch conditions are met

Request

Body Params application/json
appKey
string 
required
大吉平台appKey
appSecret
string 
optional
大吉平台appSecret
addressParam
object 
required
收货地址信息
fullName
string 
required
收货人姓名
mobile
string 
required
手机
phone
string 
required
电话
postCode
string 
required
邮编
cityText
string 
required
市文本,比如:杭州市
provinceText
string 
required
省份文本,比如:浙江省
areaText
string 
required
区文本,比如:滨江区
townText
string 
required
镇文本,比如:长河镇
address
string 
required
街道地址,比如:网商路699号
districtCode
string 
required
地址编码,比如:310107
cargoParamList
array [object {3}] 
required
商品信息
specId
string 
optional
商品规格ID
quantity
integer 
optional
商品数量(计算金额用)
offerId
integer 
optional
商品对应的offer id
Example
{
  "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
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
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
        }
    ]
}'

Responses

🟢200成功
application/json
Body
code
integer 
required
返回码
message
string 
required
消息
data
object 
required
业务数据
orderPreviewResuslt
array [object {16}] 
required
订单预览结果,自动拆单会返回多个记录
success
boolean 
required
是否成功
errorCode
null 
required
错误码
errorMsg
null 
required
错误信息
postFeeByDescOfferList
null 
required
运费说明的商品列表
consignOfferList
null 
required
代销商品列表
unsupportedCrossBorderPayOfferList
array[string]
required
不支持跨境宝支付的商品列表
timestamp
integer 
required
时间戳
traceId
string 
required
traceId
Example
{
  "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"
}
Previous
Product details search
Next
Create order
Built with