API支持的买家用户地区:韩国、台湾
可以分钟为单位查询24小时内的订单列表。
注意:CGF 订单不会通过 Open API 返回给您。 请通过 Wing 查看。
例) (2022-08-10T00:00~2022-08-10T23:59)
搜索超过 24 小时时出现错误。
除部分Path Parameter外,整体配置与订单列表查询(以天为单位)相同。
订单列表中无法查看已完成退货的订单,请通过“退货/取消申请列表查询”API查看。
顾客可在付款完成后修改收货地址,
因此将商品状态处理为“商品准备中”后,请务必通过单件订单查询更新配送地信息("receiver")。
- 发货前,请一定要确认"sellerProductName + sellerProductItemName"和"vendorItemName"上的信息是否一致。
- 构成、数量、容量等有不同时,请先暂停发货,通过在线咨询申请的话我们会尽快给予帮助的。(商品信息显示错误。> 请选择“是”来申请。)
- 若确认为错误显示,扣除的卖家分数就会恢复。
路径
GET
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
示例
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/ordersheets?createdAtFrom=2025-07-10T00:00%2B09:00&createdAtTo=2025-07-10T23:59%2B09:00&searchType=timeFrame&status=DEPARTURE
请求参数
| Name | Required | Type | Description | |
| vendorId | O | String |
vendor ID 酷澎提供给卖家的固有代码 ex) A00012345 |
链接查询参数
| Name | Required | Type | Description | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| createdAtFrom | O | 字符串 |
查询起始时间请按照此格式填写 "yyyy-mm-ddT01:00%2B09:00"
ex) 2025-07-01T01:00%2B09:00 (请求台湾店铺时,时区为08:00) |
|||||||||||||||||
| createdAtTo | O | 字符串 |
查询结束时间
查询结束时间请按照此格式填写 "yyyy-mm-ddT02:00%2B09:00"
ex) 2025-07-01T02:00%2B09:00 (请求台湾店铺时,时区为08:00) 最多可以查询24小时(日期可以不是同一天)
|
|||||||||||||||||
| status | O | 字符串 |
订单状态
|
|||||||||||||||||
| nextToken | 字符串 |
请求下一页内容时所需的 Token 值
查询第一页内容时无需填写此字段值.
每页最多返回50个订单. 请使用 [nextToken] 来查询之后的页面
|
||||||||||||||||||
| searchType | 字符串 |
订单列表查询类型
当 "searchType=timeFrame" 时,使用的是按分钟查询订单列表功能。除此之外,使用的是按天查询订单列表功能。
|
||||||||||||||||||
请求体
无
返回消息
| 名称 | 数据类型 | 描述 | ||||||||||||||||||
| code | Number | 服务器返回码 | ||||||||||||||||||
| message | String | 服务器返回信息 | ||||||||||||||||||
| data | Number | 订单列表 如果没有订单,则返回空列表 |
||||||||||||||||||
| shipmentBoxId | Number | 合并配送号码 | ||||||||||||||||||
| orderId | Number | 订单号 | ||||||||||||||||||
| orderedAt | String |
订单日期/时间 (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| orderer | Object | 订购人信息 | ||||||||||||||||||
| name | String | 订购人名字 | ||||||||||||||||||
| String |
订购人电子邮箱 未使用/則会显示空值(“”) |
|||||||||||||||||||
| safeNumber | String | 收货人电话号码(隐私号码) (格式需符合E.164標準) | ||||||||||||||||||
| ordererNumber | String | 收货人电话号码 (真实电话号码) (格式需符合E.164標準) | ||||||||||||||||||
| paidAt | String |
付款完成时的日期/时间 (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| status | String |
订单状态码
|
||||||||||||||||||
| shippingPrice | Object | 配送费 | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| remotePrice | Object | 偏远地区运送费 | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| remoteArea | Boolean | 收货地址是否为偏远地区 | ||||||||||||||||||
| parcelPrintMessage | String | 买家备注 | ||||||||||||||||||
| splitShipping | Boolean | 是否为分开配送 | ||||||||||||||||||
| ableSplitShipping | Boolean | 是否可以分开配送 | ||||||||||||||||||
| receiver | Object |
收货人信息 订单在付款完成状态下,买家可以更改。请在确认订单更改为“产品准备中”状态时,检查收货地址是否有改变。 |
||||||||||||||||||
| name | String | 收货人姓名 | ||||||||||||||||||
| safeNumber | String | 收货人联系方式 (隐私号码) (格式需符合E.164標準) | ||||||||||||||||||
| receiverNumber | String | 收货人电话号码 (真实号码) (格式需符合E.164標準) | ||||||||||||||||||
| addr1 | String | 收货人地址1 | ||||||||||||||||||
| addr2 | String | 收货人地址2 | ||||||||||||||||||
| postCode | String | 收货人邮编 | ||||||||||||||||||
| orderItems | Array | 订单物品信息 | ||||||||||||||||||
| vendorItemPackageId | Number |
vendorItemPackageId 未使用/不存在则返回0 |
||||||||||||||||||
| vendorItemPackageName | String | vendorItemPackageName | ||||||||||||||||||
| productId | Number |
产品ID 未使用/不存在则返回0 |
||||||||||||||||||
| vendorItemId | Number | 产品单项ID/OptionID | ||||||||||||||||||
| vendorItemName | String | 产品单项名称 | ||||||||||||||||||
| shippingCount | Number |
shippingCount = 订购时的产品数量 holdCountForCancel = 被取消待退款的产品数量 |
||||||||||||||||||
| salesPrice | Object | 产品单项单价 | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| orderPrice | Object | 付款金额: salesPrice*shippingCount | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| discountPrice | Object | 打折金额总和, discountPrice(打折金额总和) = instantCouponDiscount(立減优惠券) + downloadableCoupon(下载优惠券) + coupangDiscount(Coupang 专享优惠) |
||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| instantCouponDiscount | Object | 立減优惠券 | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| downloadableCouponDiscount | Object | 下载优惠券 | ||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| coupangDiscount | Object |
Coupang 专享优惠 酷澎专享购物車/品类折扣等金额 |
||||||||||||||||||
| currencyCode | String | 货币码(符合ISO-4217標準),3位大写字母 | ||||||||||||||||||
| units | Number | 货币整数部分,64-bit | ||||||||||||||||||
| nanos | Number | 货币小数部分,32-bit,取值范围 [-999999999, 999999999] | ||||||||||||||||||
| externalVendorSkuCode | String | 卖家产品 SKU | ||||||||||||||||||
| etcInfoHeader | String |
各产品单项输入项 可选输入 |
||||||||||||||||||
| etcInfoValue | String |
各产品单项输入项的使用者输入值 可选输入 此栏位存在,但是沒有任何值. 如果需要,请使用以下 etcInfoValues. |
||||||||||||||||||
| etcInfoValues | Number |
使用者商品单项各属性入值 可先输入 |
||||||||||||||||||
| sellerProductId | Number | 卖家产品ID | ||||||||||||||||||
| sellerProductName | String | 注册产品名称 | ||||||||||||||||||
| sellerProductItemName | String | 产品单项名称 | ||||||||||||||||||
| firstSellerProductItemName | String | 原始产品单项注册名称 | ||||||||||||||||||
| cancelCount | Number | 已取消产品数量 | ||||||||||||||||||
| holdCountForCancel | Number | 被取消待退款的产品数量 | ||||||||||||||||||
| estimatedShippingDate | String |
收到订单后预计发货日期 (符合ISO-8601標準) 格式:YYYY-MM-DD |
||||||||||||||||||
| plannedShippingDate | String |
计划发货日期(拆分发货订单) (符合ISO-8601標準) 格式:YYYY-MM-dd |
||||||||||||||||||
| invoiceNumberUploadDate | String |
运单号上传日期 (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| extraProperties | String |
卖家商品属性的其它信息 key:value 类型 |
||||||||||||||||||
| pricingBadge | Boolean |
是否为最低价 true/false |
||||||||||||||||||
| usedProduct | Boolean |
是否为二手货 true/false |
||||||||||||||||||
| confirmDate | String |
确认收货日期时间 (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| deliveryChargeTypeName | String |
配送收费型別 not-free, free |
||||||||||||||||||
| canceled | Boolean |
订单是否被取消 true/false |
||||||||||||||||||
| overseaShippingInfoDto | Object | 海外配送信息 | ||||||||||||||||||
| personalCustomsClearanceCode | String | 个人海关通关码 | ||||||||||||||||||
| orderersSsn | String | 未使用 | ||||||||||||||||||
| ordererPhoneNumber | String | 收货人电话号码(格式需符合E.164標準) | ||||||||||||||||||
| deliveryCompanyName | String |
物流配送公司名称 CJ Logistics, Hanjin Express, etc. |
||||||||||||||||||
| invoiceNumber | String | 运单号 | ||||||||||||||||||
| inTrasitDateTime | String |
配送日期时间 (开始运送时间) (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| deliveredDate | String |
结算完成日期时间 (符合ISO-8601標準) 格式:YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||||||||||
| refer | String |
付款设备信息: iPhone, Android APP 或者 PC/Mobile 网页。 |
||||||||||||||||||
| shipmentType | String |
运送类别 THIRD_PARTY, CGF, CGF LITE |
||||||||||||||||||
| isCod | Boolean |
订单是否为货到付款配送 true / false
|
||||||||||||||||||
| extraProperties | Object |
订单属性的其他信息 key:value 类型 有发票的市场会看到以下信息: receiptOption:
appliedType:发票类型,取值:
appliedValue:发票统编信息,取值:
SameDayShipping:是否当日出货(可选值):
cutOffTimeHour:晚于此时间当日出货不适用(可选值)
|
||||||||||||||||||
| nextToken | String | 请求下一页內容时所需的 Token 值。若无下一頁,刚为 “”。 | ||||||||||||||||||
返回訊息例子
{
"code": 200,
"message": "OK",
"data": [
{
"shipmentBoxId": 64253897***6401429,
"orderId": 22000009546234,
"orderedAt": "2025-01-15T14:17:13.973885-08:00",
"orderer": {
"name": "신*희",
"email": "",
"safeNumber": "+1(555)444-1234",
"ordererNumber": null
},
"paidAt": "2025-01-15T14:17:13.973885-08:00",
"status": "FINAL_DELIVERY",
"shippingPrice": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"remotePrice": null,
"remoteArea": false,
"parcelPrintMessage": "문 앞",
"splitShipping": false,
"ableSplitShipping": false,
"receiver": {
"name": "신*희",
"safeNumber": "+1(555)444-1234",
"receiverNumber": null,
"addr1": "경기 광명시 하안1동 두산트레지움아파트",
"addr2": "107동701호",
"postCode": "423-747"
},
"orderItems": [
{
"vendorItemPackageId": 0,
"vendorItemPackageName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1",
"productId": 31846051,
"vendorItemId": 3242596358,
"vendorItemName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1, 07 DARK GREY, 160호",
"shippingCount": 1,
"salesPrice": {
"currencyCode": "KRW",
"units": 19900,
"nanos": 0
},
"orderPrice": {
"currencyCode": "KRW",
"units": 19900,
"nanos": 0
},
"discountPrice": null,
"externalVendorSkuCode": "170816368810",
"etcInfoHeader": null,
"etcInfoValue": null,
"etcInfoValues": [
"추가메시지1",
"추가메시지2"
],
"sellerProductId": 80240831,
"sellerProductName": "인디고뱅크키즈 A5 기모 배색츄키니 IKTM17WG1",
"sellerProductItemName": "07 DARK GREY 160호",
"firstSellerProductItemName": "07 DARK GREY/160호",
"cancelCount": 0,
"holdCountForCancel": 0,
"estimatedShippingDate": "2017-10-16",
"plannedShippingDate": "",
"invoiceNumberUploadDate": "",
"extraProperties": {},
"pricingBadge": false,
"usedProduct": false,
"confirmDate": "2025-01-15T14:17:13.973885-08:00",
"deliveryChargeTypeName": "유료",
"canceled": false
}
],
"overseaShippingInfoDto": {
"personalCustomsClearanceCode": "",
"ordererSsn": "",
"ordererPhoneNumber": ""
},
"deliveryCompanyName": "CJ 대한통운",
"invoiceNumber": "340010913442",
"inTrasitDateTime": "2025-01-15T14:17:13.973885-08:00",
"deliveredDate": "2025-01-15T14:17:13.973885-08:00",
"refer": "안드로이드앱"
"shipmentType": "THIRD_PARTY",
"isCod": false,
"extraProperties":{
"sameDayShipping": "false",
"cutOffTimeHour": "0"}
},
{
"shipmentBoxId": 6425389776401428,
"orderId": 22000009546630,
"orderedAt": "2025-01-15T14:17:13.973885-08:00",
"orderer": {
"name": "김*숙",
"email": "hs*****@na",
"safeNumber": "+1(555)444-1234",
"ordererNumber": null
},
"paidAt": "2025-01-15T14:17:13.973885-08:00",
"status": "FINAL_DELIVERY",
"shippingPrice": {
"currencyCode": "KRW",
"units": 0,
"nanos": 0
},
"remotePrice": null,
"remoteArea": false,
"parcelPrintMessage": "직접 받고 부재 시 문 앞",
"splitShipping": false,
"ableSplitShipping": false,
"receiver": {
"name": "김*숙",
"safeNumber": "+1(555)444-1234",
"receiverNumber": null,
"addr1": "경기도 고양시 일산동구 백석동 **아파트",
"addr2": "303-*",
"postCode": "104-48"
},
"orderItems": [
{
"vendorItemPackageId": 0,
"vendorItemPackageName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5",
"productId": 34047877,
"vendorItemId": 3261300431,
"vendorItemName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5, 04 MIDDLE MELANGE GR, 170호",
"shippingCount": 1,
"salesPrice": {
"currencyCode": "KRW",
"units": 49900,
"nanos": 0
},
"orderPrice": {
"currencyCode": "KRW",
"units": 49900,
"nanos": 0
},
"discountPrice": {
"currencyCode": "KRW",
"units": 500,
"nanos": 0
},
"instantCouponDiscount": {
"currencyCode": "KRW",
"units": 0,
"nanos": 0
},
"downloadableCouponDiscount": {
"currencyCode": "KRW",
"units": 500,
"nanos": 0
},
"coupangDiscount": {
"currencyCode": "KRW",
"units": 0,
"nanos": 0
},
"externalVendorSkuCode": "170824416510",
"etcInfoHeader": null,
"etcInfoValue": null,
"etcInfoValues": [
"추가메시지1",
"추가메시지2"
],
"sellerProductId": 87037167,
"sellerProductName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5",
"sellerProductItemName": "04 MIDDLE MELANGE GR 170호",
"firstSellerProductItemName": "04 MIDDLE MELANGE GR/170호",
"cancelCount": 0,
"holdCountForCancel": 0,
"estimatedShippingDate": "2017-10-16",
"plannedShippingDate": "",
"invoiceNumberUploadDate": "",
"extraProperties": {},
"pricingBadge": false,
"usedProduct": false,
"confirmDate": "2025-01-15T14:17:13.973885-08:00",
"deliveryChargeTypeName": "무료",
"canceled": false
}
],
"overseaShippingInfoDto": {
"personalCustomsClearanceCode": "",
"ordererSsn": "",
"ordererPhoneNumber": ""
},
"deliveryCompanyName": "CJ 대한통운",
"invoiceNumber": "340010912565",
"inTrasitDateTime": "2025-01-15T14:17:13.973885-08:00",
"deliveredDate": "2025-01-15T14:17:13.973885-08:00",
"refer": "안드로이드앱",
"shipmentType": "CGF LITE",
"isCod": false,
"extraProperties": {
"taxReceiptInfo": {
"appliedValue": null,
"receiptOption": "PAPER",
"appliedType": "PERSONAL_COUPANG_MEMBER_CARRIER"
},
"sameDayShipping": "true",
"cutOffTimeHour": "18"
}
}
],
"nextToken": "448537989"
}错误代码
| HTTP状态代码(错误类型) | 错误信息 | 解决方案 |
| 400 (确认请求参数) | Invalid vendor ID |
请确认您输入的卖家ID(vendorId) 是否正确。 例) A00012345 |
| 400 (确认请求参数) | endTime-startTime range should less than 0 day | 请确认查询时间段是否小于24小时。 |
接口名称
GET_ORDERSHEET