- Taobao
- goods
- order form
- shopping cart
- After sales
- Message callback
- 1688
- Goods
- 1688 commodity details inquiry
- 1688 Product keyword query
- 1688 Product image search
- 1688 multilingual store search
- Query multilingual categories according to category ID
- Product recommendation
- Related product recommendation
- Global strictly selected keyword query
- 1688 Strictly select keyword query
- Hot list query
- shopping cart
- order form
- Developers submit 1688 orders for payment in batchPOST
- Preview data interface before order creation (different merchants)POST
- Create order interface in batch (different merchants)POST
- Obtain logistics tracking informationGET
- Order ListPOST
- Preview data interface before creating an orderPOST
- Create Order InterfacePOST
- Cancel order interface before paymentPOST
- Order paymentGET
- Buyer confirms receiptPOST
- 1688 conversion and decryption to Wangwang nickname interfacePOST
- After sales
- Message callback
- basis
- Warehouse logistics
Create order interface in batch (different merchants)
POST
/v2/alibaba/order/batch/create
/v2/alibaba/order/batch/create
请求参数
Header 参数
access-key
string
必需
默认值:
58c0201dfdf148eca63cbf6bb5e7cf03
nonce-str
string
可选
默认值:
nonce-str
timestamp
string
必需
默认值:
1715669977082
user-id
string
必需
默认值:
2100007341207
signature
string
必需
默认值:
B7F83FE2ADC8D8F044F2E01F0FFE8C80
Body 参数application/json
flow
string
必需
message
string
订单备注
shopPromotionId
string
可选
tradeType
string
可选
addressParam
object (FastAdress)
收货地址信息
fullName
string | null
可选
mobile
string | null
可选
phone
string | null
可选
postCode
string | null
可选
cityText
string | null
可选
provinceText
string | null
可选
areaText
string | null
可选
townText
string | null
可选
address
string | null
可选
districtCode
string | null
可选
cargoParamList
array[object (FastCargo) {3}]
商品信息不能为空
offerId
integer | null
可选
specId
string | null
可选
quantity
number | null
可选
userId
string
可选
staffName
string
雇员名称
platformOrder
integer
下单途径
transferAccountImgs
string
可选
转账凭证
transferAccountRemark
string
可选
银行转账备注
示例
{
"flow": "general",
"addressParam": {
"fullName": "zhang",
"mobile": "18600888861",
"phone": "18600888861",
"postCode": "100000",
"cityText": "杭州市",
"provinceText": "浙江省",
"areaText": "西湖区",
"townText": "转塘",
"address": "xxxxxxx"
},
"cargoParamList": [
{
"offerMapId": "L0PTnwSnx_dWNZWCtgK7Gg",
"specId": "e61a85a671bb3d0301d0412b51641c6b",
"quantity": 1,
"sellerOpenId": "BBBgGWh2O6JFI6v1aQuZVgRIA"
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/alibaba/order/batch/create' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
"flow":"general",
"addressParam": {
"fullName": "zhang",
"mobile": "18600888861",
"phone": "18600888861",
"postCode": "100000",
"cityText": "杭州市",
"provinceText": "浙江省",
"areaText": "西湖区",
"townText": "转塘",
"address": "xxxxxxx"
},
"cargoParamList": [
{
"offerMapId": "L0PTnwSnx_dWNZWCtgK7Gg",
"specId": "e61a85a671bb3d0301d0412b51641c6b",
"quantity": 1,
"sellerOpenId": "BBBgGWh2O6JFI6v1aQuZVgRIA"
}
]
}'
返回响应
🟢200成功
application/json
Body
requestId
string
请求ID
code
integer
返回码
developId
integer
开发者ID
msg
string
返回码对应信息
data
array[object (TradeModelTradeInfoV2VO) {22}]
返回内容
guaranteesTerms
object (AlibabaOpenplatformTradeModelGuaranteeTermsInfo)
可选
internationalLogistics
object (AlibabaOpenplatformTradeModelInternationalLogisticsInfo)
可选
nativeLogistics
object (AlibabaOpenplatformTradeModelNativeLogisticsInfo)
可选
productItems
array[object (ProductItem) {46}]
可选
tradeTerms
array[object (AlibabaOpenplatformTradeModelTradeTermsInfo[]) {10}]
可选
extAttributes
array[object (AlibabaOpenplatformTradeKeyValuePair[]) {3}]
可选
orderRateInfo
object (AlibabaTradeOrderRateInfo)
可选
orderInvoiceInfo
object (AlibabaInvoiceOrderInvoiceModel)
可选
customs
object (AlibabaTradeCustoms)
可选
overseasExtraAddress
object (AlibabaTradeOverseasExtraAddress)
可选
baseInfo
object (AlibabaOpenplatformTradeModelOrderBaseInfo)
可选
orderBizInfo
object (AlibabaOrderBizInfo)
可选
quoteList
array[object (AlibabaOrderDetailCaigouQuoteInfo[]) {3}]
可选
fromEncryptOrder
boolean
可选
encryptOutOrderInfo
object (AlibabaTradeGetSellerViewTradeinfoEncryptOutOrderInfo)
可选
outChannel
string
可选
sendGoodsOverdueRisk
string
可选
officialLogisticOrder
boolean
可选
sellerOpenId
string
可选
success
boolean
可选
errorCode
string
可选
errorMsg
string
可选
示例
{
"requestId": "1a4cc8ca912144eb92e77ccfcf74fbe8",
"code": 200,
"developId": "1110890638347337996",
"msg": "成功",
"data": [
{
"guaranteesTerms": null,
"internationalLogistics": null,
"nativeLogistics": {
"address": "转塘 xxxxxxx",
"area": "西湖区",
"areaCode": "330106",
"city": "杭州市",
"contactPerson": "zhang",
"fax": null,
"mobile": "18600888861",
"province": "浙江省",
"telephone": "18600888861",
"zip": "100000",
"logisticsItems": null,
"townCode": null,
"town": null,
"caid": null,
"realLogisticsCompanyNo": null
},
"productItems": [
{
"cargoNumber": null,
"description": null,
"itemAmount": 19,
"name": "2024春季新款女包斜跨大容量包包女时尚手提托特包尼龙布单肩包潮",
"price": 19,
"productID": 743470146022,
"productImgUrl": [
"http://cbu01.alicdn.com/img/ibank/O1CN01XM0H0F1Bs32yWFMfl_!!0-0-cib.80x80.jpg",
"http://cbu01.alicdn.com/img/ibank/O1CN01XM0H0F1Bs32yWFMfl_!!0-0-cib.jpg"
],
"productSnapshotUrl": "https://trade.1688.com/order/offer_snapshot.htm?order_entry_id=2540608320348880794",
"quantity": 1,
"refund": 0,
"skuID": 5129230517256,
"sort": null,
"status": "waitbuyerpay",
"subItemID": 2540608320348881000,
"type": "common",
"unit": "件",
"weight": null,
"weightUnit": null,
"guaranteesTerms": [
{
"assuranceInfo": "卖家承诺买家签收货物后7天内,在“商品完好”的情形下,向买家提供退货服务。",
"assuranceType": "qtwlybt",
"qualityAssuranceType": "7天无理由退货"
},
{
"assuranceInfo": "“满足相应条件时,用户在退货寄出后,享受极速退款到账。",
"assuranceType": "lsjst_s",
"qualityAssuranceType": "极速退款"
},
{
"assuranceInfo": "卖家在承诺买家保障服务的基础上,向买家提供“48小时发货延必赔”的服务。在买家通过支付宝担保交易完成付款或通过货到付款下单成功后,卖家承诺在买家支付成功起48小时内发货。如卖家未履行前述承诺,买家可在指定期限内发起维权,并申请赔付。",
"assuranceType": "ssbxsfh",
"qualityAssuranceType": "48小时发货"
}
],
"productCargoNumber": "8089",
"skuInfos": [
{
"name": "颜色",
"value": "奶油紫"
}
],
"entryDiscount": 0,
"specId": "e61a85a671bb3d0301d0412b51641c6b",
"quantityFactor": 1,
"statusStr": "等待买家付款",
"refundStatus": null,
"closeReason": null,
"logisticsStatus": 1,
"gmtCreate": "2025-04-23T14:13:44.000+08:00",
"gmtModified": "2025-04-23T14:13:45.000+08:00",
"gmtCompleted": null,
"gmtPayExpireTime": null,
"refundId": null,
"subItemIDString": "2540608320348880794",
"refundIdForAs": null,
"erpMaterialCode": null,
"itemDiscountFee": null,
"cantSendReason": null,
"canSendGoods": null,
"barCode": null,
"permitLogisticsCpCode": null,
"deliverGoodsOverdueRisk": null,
"relatedCode": null,
"freeEntryServiceInfo": null,
"payEntryServiceInfo": null,
"extAttributes": null
}
],
"tradeTerms": [],
"extAttributes": [
{
"key": "preSelectPayChannel",
"value": "alipay",
"description": null
}
],
"orderRateInfo": {
"buyerRateStatus": 5,
"sellerRateStatus": 5,
"buyerRateList": null,
"sellerRateList": null
},
"orderInvoiceInfo": null,
"customs": null,
"overseasExtraAddress": null,
"baseInfo": {
"allDeliveredTime": null,
"businessType": "cb",
"buyerID": "b2b-2217011889407ed2e0",
"buyerMemo": null,
"completeTime": null,
"createTime": "2025-04-23T14:13:44.000+08:00",
"currency": null,
"id": 2540608320348881000,
"modifyTime": "2025-04-23T14:13:45.000+08:00",
"payTime": null,
"receivingTime": null,
"refund": 0,
"remark": null,
"sellerID": "b2b-2207770725121452b2",
"sellerMemo": null,
"shippingFee": 4,
"status": "waitbuyerpay",
"totalAmount": 23,
"buyerRemarkIcon": null,
"sellerRemarkIcon": null,
"discount": 0,
"buyerContact": {
"phone": "86-0571-17799847985",
"fax": null,
"email": "wanqing@pandapon.com",
"imInPlatform": "pandaponpp2023",
"name": "陈翠珍",
"mobile": "17799847985",
"companyName": "杭州花熊科技有限公司"
},
"tradeType": "50060",
"refundStatus": null,
"refundStatusForAs": null,
"refundPayment": 0,
"idOfStr": "2540608320348880794",
"alipayTradeId": "UNCREATED",
"receiverInfo": {
"toFullName": "zhang",
"toDivisionCode": "330106",
"toMobile": "18600888861",
"toPhone": "18600888861",
"toPost": "100000",
"toTownCode": null,
"toArea": "浙江省 杭州市 西湖区 转塘 xxxxxxx"
},
"buyerLoginId": "pandaponpp2023",
"sellerLoginId": "广州市大榕树皮具",
"buyerUserId": null,
"sellerUserId": null,
"buyerAlipayId": null,
"sellerAlipayId": null,
"confirmedTime": null,
"closeReason": null,
"sumProductPayment": 19,
"stepOrderList": null,
"stepAgreementPath": null,
"stepPayAll": false,
"buyerFeedback": null,
"overSeaOrder": false,
"subBuyerLoginId": "pandaponpp2023:uwebuy",
"sellerOrder": false,
"preOrderId": null,
"refundId": null,
"flowTemplateCode": "assureTrade",
"buyerLevel": null,
"sellerCreditLevel": null,
"sellerContact": {
"phone": "86-",
"fax": null,
"email": null,
"imInPlatform": "广州市大榕树皮具",
"name": "廖腾飞",
"mobile": "13632968337",
"companyName": "广州市大榕树皮具有限公司",
"wgSenderName": null,
"wgSenderPhone": null
},
"newStepOrderList": [
{
"gmtStart": "2025-04-23T14:13:45.000+08:00",
"gmtPay": null,
"gmtEnd": null,
"stepNo": 1,
"lastStep": true,
"stepName": "全款交易",
"activeStatus": 1,
"payStatus": 1,
"logisticsStatus": 1,
"payFee": 23,
"paidFee": 0,
"goodsFee": null,
"adjustFee": 0,
"discountFee": 0,
"postFee": 4,
"paidPostFee": 0
}
],
"closeRemark": null,
"closeOperateType": "",
"couponFee": 0,
"tradeTypeDesc": "担保交易",
"payChannelList": [],
"tradeTypeCode": "assureTrade",
"payTimeout": 432000,
"payTimeoutType": 0,
"payChannelCodeList": [],
"ccid": null,
"relatedCode": null,
"buyerOpenUid": null,
"buyerSubOpenUid": null,
"inventoryMode": null,
"outOrderId": null
},
"orderBizInfo": {
"odsCyd": false,
"accountPeriodTime": null,
"creditOrder": false,
"creditOrderDetail": null,
"preOrderInfo": null,
"lstOrderInfo": null,
"erpBuyerUserId": null,
"erpOrderId": null,
"erpBuyerOrgId": null,
"isCz": null,
"isDz": null,
"dz": null,
"dropshipping": false,
"shippingInsurance": "givenByAnXinGou",
"hyperLinkCangFaOrder": null,
"hyperLinkOrder": null,
"hyperLinkSecondStepOrder": null,
"hyperLinkShipType": null,
"lightningWarehouse": null
},
"quoteList": null,
"fromEncryptOrder": false,
"encryptOutOrderInfo": null,
"outChannel": null,
"sendGoodsOverdueRisk": null,
"officialLogisticOrder": null,
"sellerOpenId": "BBBgGWh2O6JFI6v1aQuZVgRIA",
"success": true,
"errorCode": null,
"errorMsg": null
}
]
}
修改于 2025-04-25 06:10:18