# 纠纷接口

# 1 选择纠纷商品列表（GET）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/disputeProducts

# CURL

curl --location --request GET 'https://developers.cjdropshipping.com/api2.0/v1/disputes/disputeProducts' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度	备注
orderId	cj订单号	string	是	100

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型	长度	备注
orderId	cj订单ID	string	200
orderNumber	客户订单编号	string	200
productInfoList	商品信息列表	Object[]		选择纠纷商品供应商列表
lineItemId	lineItem id	string	100
cjProductId	cj商品id	string	100
cjVariantId	cj变体id	string	100
canChoose	是否可勾选开纠纷	boolean		true:可以开纠纷, false：不可开纠纷,可能原因:存在未完成纠纷单
price	商品价格	BigDecimal	(18,2)	单位：$（美元）
quantity	可开纠纷数量	integer	20
cjProductName	cj商品名称	string	200
cjImage	商品图片	string	100
sku	sku	string	100
supplierName	供应商name	string	200

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

# 2 纠纷确认（POST）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/disputeConfirmInfo

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/disputes/disputeConfirmInfo' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度
orderId	cj订单号	string	是	100
productInfoList	纠纷商品信息	object[]	是
lineItemId	lineItem id	string	100
quantity	纠纷数量	integer	是
price	纠纷商品价格	BigDecimal	是	(18,2)

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型	长度	备注
orderId	cj订单ID	string	200
orderNumber	客户订单编号	string	200
expectResultOptionList	期望类型选项列表	string[]		1 退款 2补发
productInfoList	商品信息列表	Object[]		选择纠纷商品供应商列表
maxProductPrice	商品总价	BigDecimal	(18,2)	单位：$（美元）
maxPostage	运费	BigDecimal	(18,2)	单位：$（美元）
maxIossTaxAmount	ioss税费金额	BigDecimal	(18,2)	单位：$（美元）
maxIossHandTaxAmount	ioss税费手续费金额	BigDecimal	(18,2)	单位：$（美元）
maxAmount	申请退款金额	BigDecimal	(18,2)	单位：$（美元）
productInfoList	商品信息列表	Object[]		选择纠纷商品供应商列表
canChoose	是否可勾选开纠纷	boolean	2	false：存在未完成纠纷单,不可开纠纷 ture:可以开
price	商品价格	BigDecimal	(18,2)	单位：$（美元）
quantity	可开纠纷数量	integer	20
lineItemId	lineItem id	string	100
cjProductId	cj商品id	string	100
cjVariantId	cj变体id	string	100
cjProductName	cj商品名称	string	200
cjImage	商品图片	string	100
sku	sku	string	100
supplierName	供应商name	string	200
disputeReasonList	纠纷原因列表	object []
disputeReasonId	纠纷原因id	integer	20
reasonName	纠纷原因-英文	string	200

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

# 3 发起纠纷（POST）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/create

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/disputes/create' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度	备注
businessDisputeId	客户业务id	string	是	100	合作方的纠纷Id
orderId	cj订单号	string	是	100
disputeReasonId	纠纷原因id	integer	是	10
expectType	期望类型	integer	是	20	1-纠纷退款，2-纠纷补发
refundType	退款类型	integer	是	20	1:余额 2：平台
messageText	文本信息	string	是	500
imageUrl	图片地址	string []	否	200
videoUrl	视频地址	string []	否	200
productInfoList	纠纷商品信息	object[]
price	商品价格	BigDecimal	是	(18,2)	单位：$（美元）
lineItemId	lineItem id	string	100
quantity	纠纷数量	integer	是	10

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data
requestId	请求Id	string	48	用于日志查询错误

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

# 4 取消纠纷（post）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/cancel

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/disputes/cancel' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度	备注
orderId	CJ订单号	string	是	100
disputeId	CJ纠纷号	string	是	100

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data		boolean
requestId	请求Id	string	48	用于日志查询错误

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

# 4 纠纷列表（GET）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/getDisputeList

# CURL

curl --location --request GET 'https://developers.cjdropshipping.com/api2.0/v1/disputes/getDisputeList' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度	备注
orderId	cj订单号	string	否	100
disputeId	纠纷id	integer	否	10
orderNumber	店铺单号	string	否	100	1-纠纷退款，2-纠纷补发
pageNumber	页码	integer	否	10	默认1
pageSize	每页数量	integer	否	10

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型	长度	备注
pageNum	当前页数	int	20
pageSize	每页返回多少条	int	20
total	总条数	int	20
list		List
status	纠纷状态	string	否	20
id	纠纷号	string
disputeReason	纠纷原因	string
replacementAmount	纠纷补发金额
resendOrderCode	补发单号
money	最终退款金额
finallyDeal	最终协商处理结果：1退款 2补发 3拒绝	integer
createDate	创建时间
productList	商品信息	Object[]
image	商品图片	string
price	商品价格
lineItemId	lineItem id	string	100
cjProductId	商品id	string
cjVariantId	cj变体id	string	100
productName	商品名称	string
supplierName	供应商名称	string

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

# 5 获取纠纷详情（GET）

# URL

https://developers.cjdropshipping.com/api2.0/v1/disputes/getDisputeDetail

# CURL

curl --location --request GET 'https://developers.cjdropshipping.com/api2.0/v1/disputes/getDisputeDetail' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

参数名称	参数意义	参数类型	是否必传	长度	备注
disputeId	纠纷id	integer	否	10

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": "",
    "redirectUri": "0242ad78-eea2-481d-876a-7cf64398f07f"
}

返回字段	字段意思	字段类型
id	纠纷号	string
status	纠纷状态	string
disputeReason	纠纷原因	string
replacementAmount	纠纷补发金额
resendOrderCode	补发单号
money	最终退款金额
finallyDeal	最终协商处理结果：1退款 2补发 3拒绝	integer
createDate	创建时间
productList	商品信息	Object[]
image	商品图片	string
price	商品价格
productCode	商品code	string
productId	商品id	string
productName	商品名称	string
standId	商品变体id	string
supplierName	供应商名称	string

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}

返回字段	字段意思	字段类型	长度	备注
code	错误码	int	20	返回错误码标准表
result	是否正常返回	boolean	1
message	返回信息	string	200
data				接口数据返回
requestId	请求Id	string	48	用于日志查询错误

← 05-物流 07-消息 →