创建订单预览

接口概述

该接口用于创建订单预览。

POST /api/v3/platform/order/createPreview

请求参数

参数名 类型 必填 示例值 描述
addressParam Object 是 {“address”:”网商路699号”,”phone”: “0517-88990077”,”mobile”: “15251667788”,”fullName”: “张三”,”postCode”: “000000”,”areaText”: “滨江区”,”townText”: “”,”cityText”: “杭州市”,”provinceText”: “浙江省”} 收货地址信息
» fullName String 是 张三 收货人姓名
» mobile String 是 15251667788 手机
» phone String 是 0517-88990077 电话
» postCode String 是 000000 邮编
» provinceText String 是 浙江省 省份文本
» cityText String 是 杭州市 市文本
» areaText String 是 滨江区 区文本
» townText String 是 长河镇 镇文本
» address String 是 网南路699号 街道地址
cargoParamList Object[] 是 [{“specId”: “b266e0726506185beaf205cbae88530d”,”quantity”: 5,”offerId”: 554456348334},{“specId”: “2ba3d63866a71fbae83909d9b4814f01”,”quantity”: 6,”offerId”: 554456348334}] 商品信息
» offerId Long 是 554465348334 商品对应的offer id
» specId String 是 b266e0726506185beaf205cabe88530d 商品规格id
» quantity Double 是 5 商品数量（计算金额）
» openOfferId String 否 Wcv2w970KoL1BcJQGp3wvKvcBThOlPihUtkK3To4= 加密的offerId，当请求返回时只有openOfferId，需将openOfferId传入offerId下单
» outMemberId String 否 9898291823-23 外部用户会话ID
invoiceParam Object 否 {“invoiceType”:0,”cityText”: “杭州市”,”provinceText”: “浙江省”,”address”: “网商路699号”,”phone”: “0517-88990077”,”mobile”: “15251667788”,”fullName”: “张五”,”postCode”: “000000”,”areaText”: “滨江区”,”companyName”: “测试公司”,”taxpayerIdentifier”: “123455”} 发票信息
outOrderId String 否 988129883123 外部订单号
flow String 否 general general（创建大市场订单），fenxiao（创建分销订单）,saleproxy流程将校验分销关系,paired(火拼下单),boutiquefenxiao(精选货源分销价下单，采购量1个使用包邮)， boutiquepifa(精选货源批发价下单，采购量大于2使用).

返回参数

名称 类型 描述 示例值
code Integer 返回状态码 0
result Boolean 返回结果 true
message String 返回描述 “成功”
data Object 返回数据 -
» orderPreviewResuslt Object[] 订单预览结果 -
» » tradeModeNameList String[] 交易模式名称列表 [“assureTrade”]
» » status Boolean 状态 true
» » taoSampleSinglePromotion Boolean 单品促销 false
» » sumPayment Long 总支付金额（单位：分） 910
» » sumCarriage Long 总运费（单位：分） 280
» » sumPaymentNoCarriage Long 不含运费的总支付金额（单位：分） 630
» » flowFlag String 流程标识 “general”
» » cargoList Object[] 商品列表 -
» » » amount Float 商品数量 6.3
» » » finalUnitPrice Float 最终单价 6.3
» » » specId String 规格ID “36c500ae4dc74b41c9710bc55550dd5d”
» » » skuId Long SKU ID 5178938106235
» » » offerId Long 报价ID 701206300960
» » » openOfferId String 开放报价ID “96nwuxrJf99UQyoaRG1Utg==”
» » » cargoPromotionList Object[] 商品促销列表 []
» » shopPromotionList Object[] 店铺促销列表 []
» » tradeModelList Object[] 交易模型列表 -
» » » name String 交易模型名称 “担保交易”
» » » description String 交易模型描述 “买家下单后5天内支付全款…”
» » » tradeType String 交易类型 “assureTrade”
» » » opSupport Boolean 是否支持操作 true
» » payChannelInfos Object[] 支付渠道信息 -
» » » name String 支付渠道名称 “alipay”
» success Boolean 是否成功 true
» unsupportedCrossBorderPayOfferList Object[] 不支持的跨境支付报价列表 []

示例请求

  1. {
  2.     "addressParam": {
  3.         "fullName": "675",
  4.         "mobile": "15860606067",
  5.         "phone": "010-675675",
  6.         "postCode": "675675",
  7.         "provinceText": "福建省",
  8.         "cityText": "厦门市",
  9.         "areaText": "湖里区",
  10.         "townText": "禾山街道",
  11.         "address": "东华门街道675号"
  12.     },
  13.     "cargoParamList":[
  14.         {
  15.             "offerId" : "701206300960",
  16.             "specId" :"36c500ae4dc74b41c9710bc55550dd5d",
  17.             "quantity" : 1,
  18.             "outMemberId":"675"
  19.         }
  20.     ],
  21.     "outOrderId":"675120001"
  22. }

示例返回

  1. {
  2.     "code": 0,
  3.     "result": true,
  4.     "message": "成功",
  5.     "data": {
  6.         "orderPreviewResuslt": [
  7.             {
  8.                 "tradeModeNameList": [
  9.                     "assureTrade"
  10.                 ],
  11.                 "status": true,
  12.                 "taoSampleSinglePromotion": false,
  13.                 "sumPayment": 910,
  14.                 "sumCarriage": 280,
  15.                 "sumPaymentNoCarriage": 630,
  16.                 "flowFlag": "general",
  17.                 "cargoList": [
  18.                     {
  19.                         "amount": 6.3,
  20.                         "finalUnitPrice": 6.3,
  21.                         "specId": "36c500ae4dc74b41c9710bc55550dd5d",
  22.                         "skuId": 5178938106235,
  23.                         "offerId": 701206300960,
  24.                         "openOfferId": "96nwuxrJf99UQyoaRG1Utg==",
  25.                         "cargoPromotionList": []
  26.                     }
  27.                 ],
  28.                 "shopPromotionList": [],
  29.                 "tradeModelList": [
  30.                     {
  31.                         "name": "担保交易",
  32.                         "description": "买家下单后5天内支付全款，逾期付款，交易关闭。付款成功后卖家发货，买家在10天内确认收货。注：买家可使用1688网站提供的多种支付方式完成付款。特别提醒：如卖家已开通极速到账服务，将优先适用极速到账交易，买家支付款项将在买家下单并支付成功后或卖家发货后直接打入卖家账户。若买家在确认收货之前发起退款，杭州阿里巴巴智融数字技术有限公司提供非融资性担保服务，将保障除虚假、刷单等恶意行为之外的买家权益，在卖家没有及时向买家支付退款的情况下，代卖家向买家支付退款，并因此有权向卖家追偿所支付的退款。",
  33.                         "tradeType": "assureTrade",
  34.                         "opSupport": true
  35.                     }
  36.                 ],
  37.                 "payChannelInfos": [
  38.                     {
  39.                         "name": "alipay"
  40.                     }
  41.                 ]
  42.             }
  43.         ],
  44.         "success": true,
  45.         "unsupportedCrossBorderPayOfferList": []
  46.     }
  47. }