此为通过订单号(orderId)查询单个订单的API。
顾客可在付款完成后修改收货地址, 因此将商品状态处理为“商品准备中”后,请务必通过单件订单查询来确认是否修改或更新了配送地信息("receiver")。
- 发货前,请一定要确认"sellerProductName + sellerProductItemName"和"vendorItemName"上的信息是否一致。
- 构成、数量、容量等有不同时,请先暂停发货,通过在线咨询申请的话我们会尽快给予帮助的。(商品信息显示错误。> 请选择“是”来申请。)
- 若确认为错误显示,扣除的卖家分数就会恢复。
路径
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/{orderId}/ordersheets
示例
请求参数
名称 |
是否必须 |
类型 |
描述 |
vendorId |
O |
|
卖家代码 酷澎提供给卖家的固有代码 可登录Wing后查看 |
orderId |
O |
|
订单号 该参数包含在以分钟和天为单位查询订单列表的订单信息中。 订单号为数值类型。 |
请求体
无
返回消息
Name | Type | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | 数值 |
服务器返回码
|
||||||||||||||||||
message | 字符串 |
服务器返回消息
|
||||||||||||||||||
data | 数组 |
结果列表
若没有结果,则返回空白列表 |
||||||||||||||||||
shipmentBoxId | 数值 |
合并配送号码
|
||||||||||||||||||
orderId | 数值 |
订单号码
|
||||||||||||||||||
orderedAt | 字符串 |
订单日期/时间
yyyy-MM-dd'T'HH:mm:ss
|
||||||||||||||||||
orderer | 对象 |
订购人信息
|
||||||||||||||||||
name | 字符串 |
订购人名称
|
||||||||||||||||||
字符串 |
订购人邮箱
未使用/则会显示空值(“”)
|
|||||||||||||||||||
safeNumber | 字符串 |
收货人电话号码(安全号码)
|
||||||||||||||||||
ordererNumber | 字符串 |
订购人联系方式 (真实电话号码)
null
|
||||||||||||||||||
paidAt | 字符串 |
付款完成时的日期/时间
yyyy-MM-dd'T'HH:mm:ss
|
||||||||||||||||||
status | 字符串 |
订单状态
|
||||||||||||||||||
shippingPrice | 数值 |
配送费
|
||||||||||||||||||
remotePrice | 数值 |
偏远地区运送费
|
||||||||||||||||||
remoteArea | 布尔 |
收货地址是否为偏远地区
|
||||||||||||||||||
parcelPrintMessage | 字符串 |
买家备注信息
|
||||||||||||||||||
splitShipping | 布尔 |
是否为分开配送
|
||||||||||||||||||
ableSplitShipping | 布尔 |
是否可以分开配送
|
||||||||||||||||||
receiver | 对象 |
收货人信息
只有订单在付款完成状态下买家可以更改。 请在确认订单更改为“产品准备中”状态时检查收货地址是否有改变。
|
||||||||||||||||||
name | 字符串 |
收货人姓名
|
||||||||||||||||||
safeNumber | 字符串 |
收货人联系方式 (安全号码)
|
||||||||||||||||||
receiverNumber | 字符串 |
收货人电话号码 (真实号码)
null
|
||||||||||||||||||
addr1 | 字符串 |
收货人地址1
|
||||||||||||||||||
addr2 | 字符串 |
收货人地址2
|
||||||||||||||||||
postCode | 字符串 |
收货人邮编
|
||||||||||||||||||
orderItems | 数组 |
订单信息
|
||||||||||||||||||
vendorItemPackageId | 数值 |
vendorItemPackageId
未使用/不存在则返回0
|
||||||||||||||||||
vendorItemPackageName | 字符串 |
vendorItemPackageName
|
||||||||||||||||||
productId | 数值 |
产品ID
未使用/不存在则返回0
|
||||||||||||||||||
vendorItemId | 数值 |
产品单项ID/OptionID
|
||||||||||||||||||
vendorItemName | 字符串 |
产品显示名称
|
||||||||||||||||||
shippingCount | 数值 |
shippingCount = 订购时的产品数量
holdCountForCancel = 被取消待退款的产品数量
cancelCount = 已经确认要被取消的产品数量 可配送产品数量 = shippingCount - (holdCountForCancel + cancelCount ) |
||||||||||||||||||
salesPrice | 数值 |
产品单项的价格
|
||||||||||||||||||
orderPrice | 数值 |
付款金额: salesPrice*shippingCount
|
||||||||||||||||||
discountPrice | 数值 |
打折金额总和,
discountPrice(打折金额总和) = instantCouponDiscount(立减优惠券) + downloadableCoupon(下载优惠券) + coupangDiscount(Coupang 专享优惠) |
||||||||||||||||||
instantCouponDiscount | 数值 |
立减优惠券数额
|
||||||||||||||||||
downloadableCouponDiscount | 数值 |
下载优惠券数额
|
||||||||||||||||||
coupangDiscount | 数值 |
Coupang 专享优惠
酷澎专享购物车/品类折扣等金额
|
||||||||||||||||||
externalVendorSkuCode | 字符串 |
卖家产品 SKU 代码
|
||||||||||||||||||
etcInfoHeader | 字符串 |
各商品单项输入项
可选输入
|
||||||||||||||||||
etcInfoValue | 字符串 |
各商品单项输入项的用户输入值
可选输入
此字段存在,但是没有任何值. 如果需要,请使用以下 etcInfoValues.
|
||||||||||||||||||
etcInfoValues | 数组 |
用户产品单项各属性输入值列表
可选输入
|
||||||||||||||||||
sellerProductId | 数值 |
卖家产品ID
|
||||||||||||||||||
sellerProductName | 字符串 |
注册产品名称
|
||||||||||||||||||
sellerProductItemName | 字符串 |
产品单项名称
|
||||||||||||||||||
firstSellerProductItemName | 字符串 |
原始注册产品单项名称
|
||||||||||||||||||
cancelCount | 数值 | 已取消产品数量 | ||||||||||||||||||
holdCountForCancel | 数值 |
被取消待退款的产品数量
|
||||||||||||||||||
estimatedShippingDate | 字符串 |
收到订单后预计发货日期
yyyy-MM-dd
|
||||||||||||||||||
plannedShippingDate | 字符串 |
计划发货日期(拆分发货订单)
yyyy-MM-dd
|
||||||||||||||||||
invoiceNumberUploadDate | 字符串 |
运单号上传日期
yyyy-MM-dd'T'HH:mm:ss
|
||||||||||||||||||
extraProperties | 对象 |
卖家商品属性的其它信息
key:value 类型
|
||||||||||||||||||
pricingBadge | 布尔 |
是否为最低价
true/false
|
||||||||||||||||||
usedProduct | 布尔 |
是否为二手货
true/false
|
||||||||||||||||||
confirmDate | 字符串 |
确认收货日期时间
yyyy-MM-dd HH:mm:ss
|
||||||||||||||||||
deliveryChargeTypeName | 字符串 |
配送收费类型
not-free, free
|
||||||||||||||||||
canceled | 布尔 |
订单是否被取消
true/false
|
||||||||||||||||||
overseaShippingInfoDto | 对象 |
海外运送信息
|
||||||||||||||||||
personalCustomsClearanceCode | 字符串 |
个人海关通关码 |
||||||||||||||||||
orderersSsn | 字符串 |
未使用 |
||||||||||||||||||
ordererPhoneNumber | 字符串 |
订购人电话号码 |
||||||||||||||||||
deliveryCompanyName | 字符串 |
物流配送公司名称
CJ Logistics, Hanjin Express, etc.
|
||||||||||||||||||
invoiceNumber | 字符串 |
运单号码
|
||||||||||||||||||
inTrasitDateTime | 字符串 |
配送日期时间 (开始运送时间)
yyyy-MM-dd HH:mm:ss
|
||||||||||||||||||
deliveredDate | 字符串 |
配送完成日期时间
yyyy-MM-dd HH:mm:ss
|
||||||||||||||||||
refer | 字符串 |
付款设备信息:
iPhone, Android APP 或者 PC/Mobile 网页。
|
||||||||||||||||||
shipmentType | 字符串 |
运送类型
THIRD_PARTY, CGF, CGF LITE
|
返回消息示例
{
"code": "200",
"message": "OK",
"data": [
{
"shipmentBoxId": 102392001,
"orderId": 500000596,
"orderedAt": "2017-10-06T22:59:37",
"orderer": {
"name": "김문근",
"email": "",
"safeNumber": "0501-111-2222",
"ordererNumber": null
},
"paidAt": "2017-10-06T22:59:37",
"status": "FINAL_DELIVERY",
"shippingPrice": 2500,
"remotePrice": 0,
"remoteArea": false,
"parcelPrintMessage": null,
"splitShipping": false,
"ableSplitShipping": false,
"receiver": {
"name": "test",
"safeNumber": "0501-111-2222",
"receiverNumber": null,
"addr1": "addr1",
"addr2": "addr2",
"postCode": "284-60"
},
"orderItems": [
{
"vendorItemPackageId": 0,
"vendorItemPackageName": "러비더비 섬유향수 보솔레이",
"productId": 2429,
"vendorItemId": 3000000177,
"vendorItemName": "러비더비 섬유향수 보솔레이, 500ml",
"shippingCount": 1,
"salesPrice": 14000,
"orderPrice": 14000,
"discountPrice": 500,
"instantCouponDiscount": 0,
"downloadableCouponDiscount": 500,
"coupangDiscount": 0,
"externalVendorSkuCode": "800022867",
"etcInfoHeader": null,
"etcInfoValue": null,
"etcInfoValues": [
"추가메시지1",
"추가메시지2"
],
"sellerProductId": 26758514,
"sellerProductName": "[러비더비] 대용량 섬유향수 보솔레이 500ml",
"sellerProductItemName": "01_보솔레이 500ml",
"firstSellerProductItemName": "01_보솔레이 500ml",
"cancelCount": 0,
"holdCountForCancel": 0,
"estimatedShippingDate": "2017-10-12",
"plannedShippingDate": "",
"invoiceNumberUploadDate": "",
"extraProperties": {},
"pricingBadge": false,
"usedProduct": false,
"confirmDate": "2017-10-18 18:10:28",
"deliveryChargeTypeName": "무료",
"canceled": false
}
],
"overseaShippingInfoDto": {
"personalCustomsClearanceCode": null,
"ordererSsn": "",
"ordererPhoneNumber": ""
},
"deliveryCompanyName": "CJ 대한통운",
"invoiceNumber": "337398446274",
"inTrasitDateTime": "2017-10-11 19:04:45",
"deliveredDate": "2017-10-13 19:34:50",
"refer": "PC웹",
"shipmentType": "CGF"
}
]
}
错误代码
HTTP状态代码(错误类型) |
错误信息 |
解决方案 |
400 (确认请求参数) |
该订单已取消或退货。 |
请通过退货/取消申请列表查询API确认订单是否已被取消或退货,并确保该订单不被重复调用。 |
400 (确认请求参数) |
订单号无效。 |
请确认您输入的订单号是否正确。 |
400 (确认请求参数) |
无法查询其他卖家的订单。 |
请确认您输入的卖家ID (vendorId)是否正确。 |
接口名称
GET_ORDERSHEET_BY_ORDERID