# 7 纠纷接口

# 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 用于日志查询错误

# 5 纠纷列表(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 用于日志查询错误

# 6 获取纠纷详情(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 用于日志查询错误