服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【品控质检服务】导航


获取订购关系新增质检报告
更新质检报告删除质检报告
根据给定条件查询质检报告列表根据质检报告编号获得质检报告

获取订购关系

接口名称：

jingdong.market.service.qt.subscribe.get

 

功能描述：

获取订购关系

 

API用户授权类型：

需要

 

系统级别输入参数：

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数：

名称

类型

是否必须

示例值

描述

service_item_code 

String 

是

FW_GOODS-149205-1 

服务收费项目code,支持最大长度50 

pin 

String 

是

i_pin 

用户京东pin，支持最大长度50 

返回结果

名称

类型

示例值

描述

qtArticleResult 

QtArticleResult

 


QtArticleResult

名称

类型

是否必须

示例值

描述

success 

Boolean

否

true 

标记操作是否成功。true：成功，fale：失败 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

qtArticle 

QTArticle

否

 

满足条件的订购关系 

QTArticle 

名称

类型

是否必须

示例值

描述

service_item_code 

String 

否

FW_GOODS-149205-1 

服务收费项目code 

pin 

String 

否

i_pin 

用户京东pin 

all_num 

Number 

否

3 

用户订购的所有数量 

used_num 

Number 

否

2 

用户已使用的数量 

expire_time 

Date 

否

2012-02-23 21:02:00 

过期时间 


返回示例：

JSON数据格式


{

   "jingdong_market_service_qt_subscribe_get_response": {

       "qtArticleResult": {

           "r_msg": "",

           "qtArticle": {

               "all_num": "例：3",

                "pin": "例:i_pin",

               "service_item_code": "例：FW_GOODS-149205-1",

               "expire_time": "例：2012-02-23 21:02:00",

               "used_num": "例：2"

            },

           "r_code": "",

           "success": "例:true"

        }

    }

}


SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtSubscribeGetRequest request=new MarketServiceQtSubscribeGetRequest();
request.setServiceItemCode( "jingdong" );
request.setPin( "jingdong" );
MarketServiceQtSubscribeGetResponse response=client.execute(request);

新增质检报告

接口名称：

jingdong.market.service.qt.report.add

 

功能描述：

新增质检报告

 

API用户授权类型：

需要  

 

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

service_item_code 

String 

是

 FW_GOODS-10000-1

服务收费项目code 

qt_code 

String 

是

 1000001 

质检编号

qt_name 

String 

是

 皮鞋 

质检项名称

qt_type 

Number 

是

 0

活动类型，0、其他；1、入驻京东

qt_standard 

String 

否

 GB18401

质检标准

is_passed 

Number 

否

 0

样品是否合格，参考值：0：未通过；1：通过；留空表示成分鉴定,不做判定 ，只有status=3时赋值 

sp_name 

String 

是

服务商名称 

质检服务商名称

message 

String 

否

检测不通过,需要修改标签 

不合格原因

submit_time 

String 

是

2013-03-18 15:14:01 

提交检查时间,格式：yyyy-MM-dd HH:mm:ss 

report_time 

String 

否

2013-03-18 15:14:01 

出具报告时间，格式：yyyy-MM-dd HH:mm:ss 

expiry_time 

String 

否

2013-03-18 15:14:01 

质检有效期限，格式：yyyy-MM-dd HH:mm:ss  

item_url 

String 

否

http://www.jd.com

样品的链接

item_desc 

String 

否

 文字描述 

样品信息描述

report_url 

String 

否

http://www.test.com/xx

/xx.pdf 

质检报告地址

ext_attr 

String 

否

color:red;size:5

扩展属性通过冒号分隔属性与属性值. 分号分隔不同属性 

num_iid 

Number 

否

1234 

样本宝贝id

status 

Number 

是

0

质检报告状态 0:已提交申请 1:已收到样品 2:已出检测结果 3.已出具报告 

pin 

String 

是

test_pin

送检人京东pin 

返回结果

名称

类型

示例值

描述

publicResult 

AddResult 

 

返回结果对象 

AddResult

名称

类型

是否必须

示例值

描述

success 

Boolean 

否

 

标记操作是否成功。true：成功；false:失败； 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

 

返回示例：

JSON数据格式

{

    "jingdong_market_service_qt_report_add_response":{

       "publicResult": {

           "r_msg": "",

           "r_code": "",

           "success": ""

        }

    }

}


SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtReportAddRequest request=new MarketServiceQtReportAddRequest();
request.setServiceItemCode( "jingdong" );
request.setQtCode( "jingdong" );
request.setQtName( "jingdong" );
request.setQtType( 123 );
request.setQtStandard( "jingdong" );
request.setIsPassed( 123 );
request.setSpName( "jingdong" );
request.setMessage( "jingdong" );
request.setSubmitTime( "jingdong" );
request.setReportTime( "jingdong" );
request.setExpiryTime( "jingdong" );
request.setItemUrl( "jingdong" );
request.setItemDesc( "jingdong" );
request.setReportUrl( "jingdong" );
request.setExtAttr( "jingdong" );
request.setNumIid( 123 );
request.setStatus( 123 );
request.setPin( "jingdong" );
MarketServiceQtReportAddResponse response=client.execute(request);

更新质检报告

接口名称：

jingdong.market.service.qt.report.update

 

功能描述：

更新质检报告

 

API用户授权类型：

需要  

 

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

service_item_code 

String 

是

 FW_GOODS-10000-1

服务收费项目code 

qt_code 

String 

是

 1000001

质检编号

qt_name 

String 

是

 皮鞋 

质检项名称

qt_type 

Number 

是

 0

活动类型，0、其他；1、入驻京东

qt_standard 

String 

否

 GB18401 

质检标准

is_passed 

Number 

否

 0

样品是否合格，参考值：0：未通过；1：通过；留空表示成分鉴定,不做判定 ，只有status=3时赋值

sp_name 

String 

是

 服务商名称 

质检服务商名称

message 

String 

否

 检测不通过,需要修改标签 

不合格原因

submit_time 

String 

是

 2013-03-18 15:14:01 

提交检查时间，格式：yyyy-MM-dd HH:mm:ss 

report_time 

String 

否

 2013-03-18 15:14:01 

出具报告时间，格式：yyyy-MM-dd HH:mm:ss 

expiry_time 

String 

否

 2013-03-18 15:14:01 

质检有效期限，格式：yyyy-MM-dd HH:mm:ss 

item_url 

String 

否

 http://www.jd.com

样品的链接 

item_desc 

String 

否

 文字描述 

样品信息描述

report_url 

String 

否

http://www.test.com/xx/xx.pdf

质检报告地址，当status=3时为必填项，

例：http://www.jd.com 

ext_attr 

String 

否

color:red;size:5 

扩展属性通过冒号分隔属性与属性值. 分号分隔不同属性

num_iid 

Number 

否

 1234 

样本宝贝id，例：1234 

status 

Number 

是

 0

质检报告状态 0:已提交申请 1:已收到样品 2:已出检测结果 3.已出具报告 

pin 

String 

是

test_pin

送检人京东pin

返回结果

名称

类型

示例值

描述

publicResult 

com.jd.jos.market.ear.domain.UpdateResult 

 

返回结果对象 


返回结果对象

UpdateResult 

名称

类型

是否必须

示例值

描述

success 

Boolean 

否

 

标记操作是否成功。true：成功；false:失败； 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

返回示例：

JSON数据格式

{

   "jingdong_market_service_qt_report_update_response": {

       "publicResult": {

           "r_msg": "",

           "r_code": "",

           "success": ""

        }

    }

}


SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtReportUpdateRequest request=new MarketServiceQtReportUpdateRequest();
request.setServiceItemCode( "jingdong" );
request.setQtCode( "jingdong" );
request.setQtName( "jingdong" );
request.setQtType( 123 );
request.setQtStandard( "jingdong" );
request.setIsPassed( 123 );
request.setSpName( "jingdong" );
request.setMessage( "jingdong" );
request.setSubmitTime( "jingdong" );
request.setReportTime( "jingdong" );
request.setExpiryTime( "jingdong" );
request.setItemUrl( "jingdong" );
request.setItemDesc( "jingdong" );
request.setReportUrl( "jingdong" );
request.setExtAttr( "jingdong" );
request.setNumIid( 123 );
request.setStatus( 123 );
request.setPin( "jingdong" );
MarketServiceQtReportUpdateResponse response=client.execute(request);

删除质检报告

接口名称：

jingdong.market.service.qt.report.delete

 

功能描述：

删除质检报告

 

API用户授权类型：

需要

 

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

qtCode 

String 

是

 1000001

质检编号

返回结果

名称

类型

示例值

描述

publicResult 

ReportDeleteResult 

 

返回结果对象 

ReportDeleteResult

名称

类型

是否必须

示例值

描述

success 

Boolean 

否

 

标记操作是否成功。true：成功;false：失败 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

 

返回示例：

JSON数据格式

{

   "jingdong_market_service_qt_report_delete_response": {

       "publicResult": {

           "r_msg": "",

           "r_code": "",

           "success": ""

        }

    }

}

SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtReportDeleteRequest request=new MarketServiceQtReportDeleteRequest();
request.setQtCode( "jingdong" );
MarketServiceQtReportDeleteResponse response=client.execute(request);

根据给定条件查询质检报告列表

接口名称：

jingdong.market.service.qt.report.list.get

 

功能描述：

根据给定条件查询质检报告列表

 

API用户授权类型：

需要 

 

系统级别输入参数：

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

service_item_code 

String 

是

 FW_GOODS-10000-1 

服务收费项目code

qt_type 

Number 

否

 0

活动类型，0、其他；1、入驻京东

sp_name 

String 

是

 SGS质检服务商

质检服务商名称 

start_time 

String 

否

 2013-03-18 15:14:01 

查询时间段的开始时间，格式：yyyy-MM-dd HH:mm:ss

end_time 

String 

否

2013-03-18 15:14:01 

查询时间段的结束时间，格式：yyyy-MM-dd HH:mm:ss

pin 

String 

是

 jd_pin

送检人京东pin

返回结果对象

名称

类型

示例值

描述

publicResult 

ReportsResult 

 

返回结果对象 

ReportsResult

名称

类型

是否必须

示例值

描述

success 

Boolean 

否

 

标记操作是否成功。true：成功；false:失败； 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

qtReports 

java.util.List 

否

 

满足条件的报告列表 

QTReportVO 

名称

类型

是否必须

示例值

描述

id 

Number 

否

 

质检报告在京东的Id 

qt_code 

String 

否

 

质检编号 

qt_name 

String 

否

 

质检项名称 

qt_type 

Number 

否

 

活动类型，0、其他；1、入驻京东

qt_standard 

String 

否

 

质检标准 

is_passed 

Number 

否

 

样品是否合格，参考值：0：未通过；1：通过；留空表示成分鉴定,不做判定 ，只有status=3时赋值

sp_name 

String 

否

 

质检服务商名称 

message 

String 

否

 

不合格原因 

submit_time 

String 

否

 

提交检查时间 

report_time 

String 

否

 

出具报告时间 

expiry_time 

String 

否

 

质检有效期限 

item_url 

String 

否

 

样品的链接 

item_desc 

String 

否

 

样品信息描述 

report_url 

String 

否

 

质检报告地址 

ext_attr 

String 

否

 

扩展属性通过冒号分隔属性与属性值. 分号分隔不同属性,如：color:red;size:5 

num_iid 

Number 

否

 

样本宝贝id 

status 

Number 

否

 

质检报告状态 0:已提交申请 1:已收到样品 2:已出检测结果 3.已出具报告 

pin 

String 

否

 

送检人京东pin 


返回示例：

JSON数据格式

{

   "jingdong_market_service_qt_report_list_get_response": {

        "publicResult":{

           "r_msg": "",

           "qtReports": [

                {

                   "qtReport": {

                       "status": "",

                       "sp_name": "",

                       "qt_standard": "",

                        "qt_name": "",

                       "item_desc": "",

                       "ext_attr": "",

                       "item_url": "",

                       "qt_type": "",

                       "is_passed": "",

                       "id": "",

                        "message":"",

                       "pin": "",

                       "report_url": "",

                       "expiry_time": "",

                       "report_time": "",

                       "num_iid": "",

                        "qt_code": "",

                       "submit_time": ""

                    }

                }

            ],

           "r_code": "",

           "success": ""

        }

    }

}

SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtReportListGetRequest request=new MarketServiceQtReportListGetRequest();
request.setServiceItemCode( "jingdong" );
request.setQtType( 123 );
request.setSpName( "jingdong" );
request.setStartTime( "jingdong" );
request.setEndTime( "jingdong" );
request.setPin( "jingdong" );
MarketServiceQtReportListGetResponse response=client.execute(request);

根据质检报告编号获得质检报告

接口名称：

jingdong.market.service.qt.report.get

 

功能描述：

根据质检报告编号获得质检报告

 

API用户授权类型：

需要  

 

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

否

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

qtCode 

String 

是

 1000001 

质检报告的编号

返回结果

名称

类型

示例值

描述

publicResult 

GetResult 

 

返回结果对象 

GetResult 

名称

类型

是否必须

示例值

描述

success 

Boolean 

否

 

标记操作是否成功。true：成功；false:失败； 

r_code 

String 

否

 

错误码 

r_msg 

String 

否

 

错误信息 

model 

QTReportVO 

否

 

质检报告 

 

QTReportVO

名称

类型

是否必须

示例值

描述

id 

Number 

否

 

质检报告在京东的Id 

qt_code 

String 

否

 

质检编号 

qt_name 

String 

否

 

质检项名称 

qt_type 

Number 

否

 

活动类型，0、其他；1、入驻京东

qt_standard 

String 

否

 

质检标准 

is_passed 

Number 

否

 

样品是否合格，参考值：0：未通过；1：通过；留空表示成分鉴定,不做判定 ，只有status=3时赋值

sp_name 

String 

否

 

质检服务商名称 

message 

String 

否

 

不合格原因 

submit_time 

String 

否

 

提交检查时间 格式：yyyy-MM-dd HH:mm:ss 

report_time 

String 

否

 

出具报告时间 格式：yyyy-MM-dd HH:mm:ss 

expiry_time 

String 

否

 

质检有效期限 格式：yyyy-MM-dd HH:mm:ss

item_url 

String 

否

 

样品的链接 

item_desc 

String 

否

 

样品信息描述 

report_url 

String 

否

 

质检报告地址 

ext_attr 

String 

否

 

扩展属性通过冒号分隔属性与属性值. 分号分隔不同属性,如：color:red;size:5 

num_iid 

Number 

否

 

样本宝贝id 

status 

Number 

否

 

质检报告状态 0:已提交申请 1:已收到样品 2:已出检测结果 3.已出具报告 

pin 

String 

否

 

送检人京东pin 

 

返回示例：

JSON数据格式

 {

    "jingdong_market_service_qt_report_get_response":{

       "publicResult": {

           "model": {

               "status": "",

               "sp_name": "",

               "qt_standard": "",

               "qt_name": "",

               "item_desc": "",

               "ext_attr": "",

               "item_url": "",

               "qt_type": "",

               "is_passed": "",

               "id": "",

               "message": "",

               "pin": "",

               "report_url": "",

                "expiry_time":"",

               "report_time": "",

               "num_iid": "",

               "qt_code": "",

               "submit_time": ""

            },

           "r_msg": "",

           "r_code": "",

           "success": ""

        }

    }

}

SDK调用示例：

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
MarketServiceQtReportGetRequest request=new MarketServiceQtReportGetRequest();
request.setQtCode( "jingdong" );
MarketServiceQtReportGetResponse response=client.execute(request);