Coupang Developer Center

API支持的买家用户地区：韩国、台湾

可在此查询酷澎客服中心的咨询记录，并查看顾客对于某件特定商品向酷澎客服中心提出的咨询。

若属性ID和查询时间段均有数值，则可查询属性ID和查询时间段内的所有咨询记录
若只有属性ID值，则只能查询属性ID的咨询记录
若只有查询时间段的数值，则只能查询查询时间段内的咨询记录

查询时间段最长可设置为7天。

路径

GET

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/callCenterInquiries?inquiryStartAt=2018-01-07&inquiryEndAt=2018-01-08&vendorId=A00012345&partnerCounselingStatus=NO_ANSWER&pageSize=10&pageNum=1

请求参数

Name	Required	Type	Description
vendorId	O	String	卖家ID

链接请求参数

Name

Required

Type

Description

vendorId

String

卖家ID

partnerCounselingStatus

String

咨询状态

Name	Status
NONE	咨询
ANSWER	已回复
NO_ANSWER	未回复: 需要卖家回复
TRANSFER	待确认 : 酷澎已完成咨询，现已转交给卖家。需卖家确认，无需回复

inquiryStartAt

String

查询开始日期：格式: yyyy-MM-dd

如果vendorItemId为null，则须输入该参数才能查询。可查看查询开始日到和结束日期间内的所有咨询列表（inquiryEndAt-inquiryStartAt = 7d）

如果有输入的vendorItemId值，则不输入参数也可以查询

如果查询开始日和查询结束日为null，则可查询vendorItemId的所有咨询列表

如果有查询开始日和结束日的数值，则可查询该期间内的所有咨询列表

inquiryEndAt

String

查询结束日期; 格式: yyyy-MM-dd

orderId

Number

订单编号

例: 1900000*******

vendorItemId

String

属性ID

如果咨询开始日和结束日为null，则须使用该参数查询指定vendorItemId的所有咨询列表

如果有咨询开始日和查询结束日的数值，则无需输入该参数

pageNum

Number

当前页面

默认值: 1

pageSize

Number

页面大小

默认值: 10; 最大值: 30

请求体

无

返回消息

Name

Type

Description

code

Number

服务器响应码

message

String

服务器响应消息

data

Object

结果

content

Array

结果

inquiryId

Number

咨询编号

问题ID

inquiryStatus

String

咨询状态

进行中或已完成

csPartnerCounselingStatus

String

是否已回复

requestAnswer or answered

vendorItemId

Number

属性ID

itemName

String

单品名

content

String

咨询内容

问题内容

answeredAt

String

回复日期 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

replies

Array

回复列表

answerId

Number

回复ID

parentAnswerId

String

ID映射的上层关系

partnerTransferStatus

String

卖家映射状态

none（不需要）或 requestAnswer（待回复）或已回复（answered)）

partnerTransferCompleteReason

String

卖家转接完成理由

CODE	NAME
NONE	无
DISPUTE_PROCESS	依职权处理
DISPUTE_PROCESS_COMPLETE	卖家确认
CANCEL	取消转接

answerType

String

回复者类型

csAgent (客服人员) or vendor (卖家)

needAnswer

Boolean

是否需要回复

是或否

receptionistName

String

负责人姓名

receptionist

String

负责人

replyAt

String

回复日期 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

content

String

回复内容

inquiryAt

String

咨询日期 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

buyerEmail

String

未使用/则会显示空值(“”)

buyerPhone

String

顾客电话号码

orderId

Long

订单号

例: 1900000*******

orderDate

String

下单日期 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

receiptCategory

String

咨询方式

saleStartedAt

String

销售开始日期

saleEndedAt

String

销售结束日期

pagination

Object

Pagination information

currentPage

Number

当前页面

默认值: 1

totalPages

Number

总页数

totalElements

Number

总咨询数

countPerPage

Number

每页咨询数

返回消息示例

{
"code": 200,
"message": "OK",
"data": {
"content": [
{
"inquiryId": 1015668177,
"csPartnerCounselingStatus": "answered",
"inquiryStatus": "progress",
"vendorItemId": [
3285906659
],
"itemName": "스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L",
"content": "상담이력",
"answeredAt": "2025-01-15T14:17:13.973885-08:00",
"replies": [
{
"receptionistName": "AA몰",
"receptionist": "10000058",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "[판매자이관]\n◼주문번호: 100000*******\n◼아이템: 스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L\n◼고객명/연락처: <<****/01*-****-****>>\n◼문의내용: 고객 상품 반송하였다고 합니다. 반송장은 경비실에 맡겨서 모른다고 합니다.\n입고 확인후 환불 처리 부탁 드립니다.\n",
"answerId": 1027082307,
"parentAnswerId": 0,
"partnerTransferStatus": "answered",
"partnerTransferCompleteReason": "NONE",
"answerType": "csAgent",
"needAnswer": false
},
{
"receptionistName": "AA몰",
"receptionist": "elandmall",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n1/3일 입고 된것으로 확인됩니다.\r\n\r\n3영업일이 정상 검수기간으로 시일이 소요되기에 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
"answerId": 1027083739,
"parentAnswerId": 0,
"partnerTransferStatus": null,
"partnerTransferCompleteReason": "NONE",
"answerType": "vendor",
"needAnswer": false
}
],
"inquiryAt": "2025-01-15T14:17:13.973885-08:00",
"buyerEmail": "",
"buyerPhone": "+1(555)444-1234",
"orderId": 1000001*******6,
"orderDate": "2025-01-15T14:17:13.973885-08:00",
"receiptCategory": "기타문의>기타>전상담사통화요청",
"saleStartedAt": "2017-12-12",
"saleEndedAt": "2099-12-30"
},
{
"inquiryId": 1015664934,
"csPartnerCounselingStatus": "answered",
"inquiryStatus": "progress",
"vendorItemId": [
3361159025
],
"itemName": "스파오(SPAO) 몬스터주식회사 맨투맨 (디즈니)_D/GYAY SPMB74VC19, (17)Dark Gray, S",
"content": "상담이력",
"answeredAt": "2025-01-15T14:17:13.973885-08:00",
"replies": [
{
"receptionistName": "AA몰",
"receptionist": "D002236",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "[입고완료이관] \nㅁ 고객명: ******\nㅁ 주문번호:100000******\nㅁ 반송장번호: ********* CJ대한통운\nㅁ 입고일자: 12/30\n반송장조회 결과 입고완료로 확인됩니다. \n★환불승인★ 부탁드립니다. \n반품입고후 3영업일이 경과되면 환불 자동승인처리가 \n되오니, 입고 상품의 문제발생 시 쿠팡확인요청으로 \n이의제기를 등록해주셔야 합니다.",
"answerId": 1027076645,
"parentAnswerId": 0,
"partnerTransferStatus": "answered",
"partnerTransferCompleteReason": "NONE",
"answerType": "csAgent",
"needAnswer": false
},
{
"receptionistName": "AA몰",
"receptionist": "elandmall",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n담당부서측으로 내용 전달 완료 하였습니다.\r\n\r\n금일 내 확인될시 환불진행 하겠으나 , 평균 2영업일 소요되기에 익일까지 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
"answerId": 1027079048,
"parentAnswerId": 0,
"partnerTransferStatus": null,
"partnerTransferCompleteReason": "NONE",
"answerType": "vendor",
"needAnswer": false
}
],
"inquiryAt": "2025-01-15T14:17:13.973885-08:00",
"buyerEmail": "",
"buyerPhone": "+1(555)444-1234",
"orderId": 100000********0,
"orderDate": "2025-01-15T14:17:13.973885-08:00",
"receiptCategory": "취소/반품 후단관리>회수확인>고객반송확인",
"saleStartedAt": "2017-12-12",
"saleEndedAt": "2099-12-30"
}
],
"pagination": {
"currentPage": 1,
"totalPages": 7,
"totalElements": 13,
"countPerPage": 2
}
}
}

错误信息

HTTP状态代码（错误类型）	错误信息	解决方案
400 (确认请求参数)	time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd	请确认查询时间段是否小于7天。
400 (确认请求参数)	Invalid vendor ID	请确认输入的卖家ID(vendorId)是否正确。

接口名称

GET_INQUIRY_BY_QUERY

查询酷澎客服中心咨询记录

简介

详细内容

路径

示例