概述
更新通知:
2017.7.14更新接口文档v2版本,发布全新捷网直发接口,包括 预录单下单、获取单号、取消预录单、获取面单、获取快递渠道、获取海外仓快递渠道、查询订单状态、查询预录单、查询已处理订单以及获取物流跟踪信息。
测试账号: jiewang 密码:158159 (客户ID和秘钥请登录捷网官网查看)

预录单写入
功能
预录单写入
HTTP请求方式
POST
请求URL
http://api2.j-net.cn/order
请求参数
参数名称 类型 是否必须 描述
clientId Integer 客户Id:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
body String
[{
    "waybillNum": "",
    "clientId": 1234,
    "type": 1,
    "language":0,
    "model": "J-NET俄快通",
    "from": "CN",
    "des": "俄罗斯",
    "weight": 1.001,
    "length": 11,
    "width": 22,
    "height": 33,
    "pieces": 1,
    "receiverName": "name",
    "receiverUnit": "unitname",
    "receiverAddr": "Michurina 19   Smela",
    "receiverCity": "Smela",
    "receiverPostcode": "20701",
    "receiverProvince": "Cherkasy",
    "receiverCountry": "RU",
    "receiverPhone": "400-800-4002",
    "receiverEMail": "j-net@sina.com",
    "receiverSms": "13000000004",
    "receiverIDCard": "4244547678568",
    "receiverTaxNumber":"61424334743476",
    "senderName": "jiewang",
    "senderUnit": "jw",
    "senderAddr": " 上海捷网 虹井路",
    "senderCity": "shanghai",
    "senderPostcode": "430406",
    "senderProvince": "shanghai",
    "senderCountry": "cn",
    "senderPhone": "384858",
    "senderEMail": "123@1234.com",
    "senderSms": "131010101",
    "refNo": "12213121",
    "customsNo": "1213",
    "mark": "mark",
    "memo": "备注",
    "insured": 314,
    "source": "ERP",
    "currency": "USD",
    "goodsList": [
        {
            "cnName": "物品中文名称1",
            "enName": "English Name1",
            "quantity": 1,
            "unit": "Lot",
            "declaredValue": 11.00,
            "origin": "cn",
            "hsCode": "18096",
            "sku": "sku1",
            "url": "http://image.com",
            "attribute":"颜色:红色;尺寸:32;货架:A3112-4"
        },
        {
             "cnName": "物品中文名称2",
            "enName": "English Name2",
            "quantity": 3,
            "unit": "Lot",
            "declaredValue": 0.123,
            "origin": "CN",
            "hsCode": "1313",
            "sku": "sku2",
            "url": "http://image.cn",
            "attribute":"颜色:黄色;尺寸:28;货架:B2557-8"
        }
    ]
}]
body参数说明 List集合
参数名称 类型 是否必须 描述
waybillNum String 运单号
clientId Integer 捷网注册用户客户ID;唯一身份识别字段
type Integer 快件类型,默认为1;0(文件),1(包裹),2(防水袋)
language Integer 地域语言,默认为0;0(中国大陆),1(华语),2(其它地域)
model String 快递渠道
from String 出发地,可空
des String 快递渠道所到达的国家,填写国家二字码;0-63字符
weight BigDecimal 重量,kg
length Integer 长,厘米,可空
width Integer 宽,厘米,可空
height Integer 高,厘米,可空
pieces Integer 包裹数量
receiverName String 收件人姓名,0-63字符
receiverUnit String 收件人单位,若无,可以填收件人姓名;0-254字符
receiverAddr String 收件人地址,0-254字符
receiverCity String 收件人城市,0-126字符
receiverPostcode String 收件人邮编,0-15字符
receiverProvince String 收件人省州,0-63字符
receiverCountry String 收件人国家,0-126字符
receiverPhone String 收件电话,0-63字符;若无可以和收件电邮相同
receiverSms String 收件电邮,0-63字符;若无可以和收件电话相同
receiverEMail String 收件人email
receiverIDCard String 收件人证照号,0-30字符
receiverTaxNumber String 收件人纳税号,0-30字符
senderName String 发件人,0-30字符;俄陆运必填
senderUnit String 发件人单位,0-127字符
senderAddr String 发件人地址,0-127字符
senderCity String 发件城市,0-63字符
senderPostcode String 发件邮编,0-15字符
senderProvince String 发件省州,0-30字符
senderCountry String 发件国家,0-63字符
senderPhone String 发件电话,0-63字符
senderEMail String 发件电邮,0-63字符
senderSms String 发件手机,0-22字符
senderIDCard String 发件证照号,0-30字符;俄陆运必填
refNo String 平台订单号,0-30字符
customsNo String 报关号,0-30字符
mark String 标签,0-15字符
memo String 备注,0-254字符;没有可填写快递渠道
insured Integer 保额 元;捷网保险费用=保额*2%;最多1000人民币,只能是正整数
source String 订单来源,0-63字符,可标记不同的ERP等
currency String 货币代码,针对物品列表中的单价,0-3字符;例:USD/CNY
goodsList参数说明
参数名称 类型 是否必须 描述
cnName String 物品名称、报关中文名,中文,0-63字符
enName String 物品名称、报关英文名,英文,0-63字符
quantity Integer 物品数量
unit String 物品单位,0-15字符
declaredValue BigDecimal 物品单价,2位小数。单位为currency字段
origin String 原产地国家代码,0-3字符,如CN
hsCode String 海关编码,0-63字符
sku String sku编码,0-63字符
url String 物品连接,0-2048字符;俄全通普货和带电必须填写物品链接
attribute String 物品属性,0-2048字符
请求示例
POST http://api2.j-net.cn/order
HttpPost post = new HttpPost(url);
post.addHeader("clientId",clientId);
post.addHeader("md5",md5);
post.setEntity(body);
返回结果
请求成功:
{ "ReturnValue": 1, "RecList": [ { "index": 0, "success": true, "message": "JNTCU0100222115YQ" } ], "cMess": "总共1条,成功1条" }
请求失败:
{ "ReturnValue": -1, "cMess": "授权失败" }
返回说明
ReturnValue:大于零:下单成功;-1:授权失败,-2:参数有误,-9:系统异常或其他错误
RecList: 下单返回消息集合;请求失败:无
index:循环订单的索引;请求失败:无
message:运单号;请求失败:无
cMess:成功时返回成功处理了几条数据,不成功时返回失败的原因

预录单数据删除
功能
预录单数据删除
HTTP请求方式
DELETE
请求URL
http://api2.j-net.cn/order/{num}
请求参数
参数名称 类型 是否必须 描述
clientId Integer 客户Id:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
num String 运单号
请求示例
DELETE http://api2.j-net.cn/order/JNTCU0100221889YQ
HttpDelete delete = new HttpDelete(url);
delete.addHeader("clientId",clientId);
delete.addHeader("md5",md5);
返回结果
{"ReturnValue":1,"cMess":"取消成功"}
返回说明
ReturnValue:1,取消成功;-1,授权失败; -2,参数有误; -9,系统异常或其他错误; -12,订单不允许修改;-14,订单取消失败; -15,订单不存在;
cMess:成功提示或者失败原因

获取运单号
功能
获取运单号
HTTP请求方式
GET
请求URL
http://api2.j-net.cn/order/num
请求参数
参数名称 类型 是否必须 描述
clientId Integer 客户Id:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
model String 快递渠道
请求示例
GET http://api2.j-net.cn/order/num?model=快递渠道
HttpGet httpGet = new HttpGet(url);
httpGet.addHeader("clientId",clientId);
httpGet.addHeader("md5",md5);
返回结果
{"ReturnValue":1,"cMess":"JNTCU0100222247YQ"}
返回说明
ReturnValue: 1:成功;-1:授权失败;-2:参数有误;-9:系统异常或其他错误;-11:快递类别不支持
cMess:如果成功返回运单号,如果不成功返回失败原因

获取快递渠道
功能
获取快递渠道(包括直发和海外仓)
HTTP请求方式
GET
请求URL
http://api2.j-net.cn/model
请求参数
参数名称 类型 是否必须 描述
clientId Integer 客户Id:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
请求示例
GET http://api2.j-net.cn/model
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
请求成功:
{ "ReturnValue": 3, "RecList": [ { "model": "J-NET俄全通", "type": 3, "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian Federation" }, { "areaCn": "白俄罗斯", "areaEn": "Belarus" } ] }, { "model": "J-NET俄全通特快", "type": 3, "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian" } ] }, { "model": "MOSEXP", "type": 2, "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian" } ] } ], "cMess": "" 请求失败:
{ "ReturnValue": -1, "cMess": "授权失败" } }
返回说明
ReturnValue:如果获取成功:快递类别条数;如果获取失败: -1 授权失败 -9 系统错误或其他错误
cMess:失败原因
RecList: 快递渠道集合,可能为空;请求失败:无
areaCn:该快递渠道到达国家中文名称;请求失败:无
areaEn:该快递渠道到达国家英文名称;请求失败:无
model:快递渠道名称;请求失败:无
type: 快递渠道类型:3-物流直发渠道;2-海外仓出库渠道

获取捷网海外仓快递渠道列表
功能
获取捷网海外仓快递渠道列表
HTTP请求方式
GET
请求URL
http://api2.j-net.cn/model/depot
请求参数
参数名称 类型 是否必须 描述
clientId Integer 客户Id:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
depot String 仓库代号;如果填写,根据仓库代号查找
请求示例
GET http://api2.j-net.cn/model/depot?depot=仓库代号
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
请求成功:
{ { "ReturnValue": 3, "RecList": [ { "model": "俄快递", "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian" }, { "areaCn": "哈萨克斯坦", "areaEn": "Kazakhstan" } ], "depot": "C05" }, { "model": "俄快递2", "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian" } ], "depot": "C05" }, { "model": "俄快递3", "areas": [ { "areaCn": "俄罗斯", "areaEn": "Russian" } ], "depot": "C05" } ], "cMess": "" } } 请求失败:
{ "ReturnValue": -1, "cMess": "授权失败" }
返回说明
ReturnValue:如果获取成功:快递类别条数;如果获取失败:-1 授权失败 -5 海外仓仓库代号有误 -9 系统错误或其他错误
cMess:失败原因
RecList:快递渠道信息集合;请求失败:无
areaCn:该渠道到达国家中文名称;请求失败:无
areaEn:该渠道到达国家英文名称;请求失败:无
depot: 该快递渠道所属仓库代号;请求失败:无

打印面单
功能
获取面单接口
请求URL
GET http://api2.j-net.cn/label
请求参数
参数名称 类型 是否必须 描述
clientId Integer 用户ID:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
type String 面单类型 1、RM(热敏100*100打印);2、A4 A4纸打印;默认RM
encryptype String 加密类型 1、file 返回pdf文件;2、base64 返回base64加密字符串;默认file
nums String 运单号字符串,每个运单号用英文逗号分隔
请求示例
http://api2.j-net.cn/label?type=RM&encryptype=file&nums=运单号
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
 {
    "ReturnValue": 68382,
    "cMess": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9MZW5ndGggNjcvRmlsdGVyL0ZsYXRlRGVjb2RlPj5z\r\ndHJlYW0KeJwr5HIK4TI2U7AwMFMISeFyDeEK5CpUMFQwAEIQaWpqoWdqopCcq6AfkWao4JKvgCpv\r\nZG6qZ2ABlTeCyAMA5vkRzwplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwvUGFyZW50IDQgMCBS\r\nL0NvbnRlbnRzIDMgMCBSL1R5cGUvUGFnZS9SZXNvdXJjZXM8PC9YT2JqZWN0PDwvWGYyIDIgMCBS\r\nL1hmMSAxIDAgUj4+Pj4vTWVkaWFCb3hbMCAwIDU5NSA4NDJdPj4KZW5kb2JqCjEgMCBvYmoKPDwv\r\nVHlwZS9YT2JqZWN0L1Jlc291cmNlczw8L0V4dEdTdGF0ZTw8L0dTMCA2IDAgUj4+L1Byb2NTZXRb\r\nL1BERi9UZXh0XS9YT2JqZWN0PDwvWGk4IDcgMCBSL1hpOSA4IDAgUi9YaTExIDkgMCBSL1hpNCAx\r\nMCAwIFIvWGk1IDExIDAgUi9YaTYgMTIgMCBSL1hpMTAgMTMgMCBSL1hpNyAxNCAwIFIvWGkwIDE1\r\nIDAgUi9YaTEgMTYgMCBSL1hpMiAxNyAwIFIvWGkzIDE4IDAgUj4+L0ZvbnQ8PC9DMF8wIDE5IDAg\r\nUi9UVDAgMjAgMCBSPj4vUHJvcGVydGllczw8L01DMCAyMSAwIFI+Pj4+L1N1YnR5cGUvRm9ybS9C\r\nQm94WzAgMCAyODMuNDYgMjgzLjQ2XS9NYXRyaXhbMSAwIDAgMSAwIDBdL0Zvcm1UeXBlIDEvTGVu\r\nZ3RoIDgxNzIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJztXV2PLcdVfZ9fcR54AKRzXN8f\r..................."
}
                    
返回说明
ReturnValue:如果获取成功:字节数组长度;如果失败:-1,授权失败; -2,参数有误;-3,运单号错误或不存在
cMess:如果成功:返回base64加密文件字符串;如果失败: -2,参数有误;-3,运单号错误或不存在等原因
encryptype=file时,返回pdf文件

查询订单状态
功能
查询订单状态
请求URL
GET http://api2.j-net.cn/order/status
请求参数
参数名称 类型 是否必须 描述
clientId Integer 用户ID:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
nums String 运单号字符串,每个运单号用英文“,”分隔
请求示例
http://api2.j-net.cn/order/status?nums=运单号
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
{
    "ReturnValue": 1,
    "RecList": [{
        "num": "JNTCU06000463YQ",
        "status": 12
    }],
    "cMess": "传入1个单号,总共查询到1个订单,其中0个预报"
}
                    
返回说明
ReturnValue:大于或等于0表示通过单号能查询到的记录数;如果失败:-1,授权失败; -9,表示系统异常或其他错误
num: 查询运单号
status: 订单状态; 00-预报 11-转运中 12-送达 13-异常 14-退件
cMess: 返回消息说明

查询预录单
功能
查询预录单
请求URL
GET http://api2.j-net.cn/order/pre
请求参数
参数名称 类型 是否必须 描述
clientId Integer 用户ID:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
model String 快递渠道;默认为空字符串
keyword String 运单号/转单号/平台订单号;支持模糊查询,默认为空字符串
des String 目的地;默认为空字符串
begin Date 订单查询开始时间,格式为“yyyy-MM-dd”;默认为空
end Date 订单查询结束时间,格式为“yyyy-MM-dd”;默认为空
pageNo Integer 当前页;默认为1
pagePer Integer 每页显示订单数量;默认为50;最多只能每页显示200条记录
请求示例
http://api2.j-net.cn/order/pre?model=&keyword=&des=&begin=&end=&pageNo=&pagePer=
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
查询成功返回消息:
{
    "ReturnValue": 50,
    "PageNo": 1,
    "PagePer": 50,
    "TotalRec": 1637,
    "RecList": [
        {
            "id": 646731,
            "payWay": 0,
            "amount": 0,
            "waybillNum": "JNTCU3000031128YQ",
            "transportNo": "JNTCU3000031128YQ",
            "clientId": 2158,
            "type": 1,
            "language": 0,
            "model": "J-NET俄快通",
            "distribution": null,
            "from": "ruidu  shanghai",
            "des": "俄罗斯",
            "weight": 1,
            "length": 20,
            "width": 12,
            "height": 15,
            "pieces": 1,
            "sysDate": "2017-07-22 13:52:28",
            "receiverName": "Khyzhniak",
            "receiverUnit": "Khyzhniak",
            "receiverAddr": "Michurina 11  Cherkasy, Ukraine",
            "receiverCity": "Smela",
            "receiverPostcode": "20701",
            "receiverProvince": "Cherkasy",
            "receiverCountry": "Ukraine",
            "receiverPhone": "3806723877",
            "receiverEMail": "",
            "receiverSms": "3806732877",
            "receiverIDCard": "",
            "senderName": "jiewang",
            "senderUnit": "jw",
            "senderAddr": "ruidu  shanghai",
            "senderCity": "shanghai",
            "senderPostcode": "384858",
            "senderProvince": "shanghai",
            "senderCountry": "shanghai",
            "senderPhone": "384858",
            "senderEMail": "123423@qq.com",
            "senderSms": "12345678902",
            "senderIDCard": "",
            "refNo": "",
            "customsNo": "",
            "mark": "",
            "memo": "12321",
            "reserveString": "",
            "reserveInt": 0,
            "insured": 0,
            "feeInsurance": 0,
            "currency": null,
            "source": "捷网单票下单",
            "printCount": 1,
            "transNote": null,
            "orderPreGoodsList": [{
                "orderPreId": 646731,
                "cnName": "鞋子",
                "enName": "English Name",
                "quantity": 1,
                "unit": "",
                "declaredValue": 11,
                "origin": null,
                "hsCode": "",
                "sku": "",
                "duty": null,
                "tariffRate": null,
                "netWeight": null,
                "wpos": null,
                "url": null
            }]
        },
        {
               "id": 646656,
            "payWay": 0,
            "amount": 0,
            "waybillNum": "JNTCU3300003069YQ",
            "transportNo": "RO556163811CN",
            "clientId": 2158,
            "type": 1,
            "language": 0,
            "model": "哈萨克斯坦专线",
            "distribution": null,
            "from": "ruidu  shanghai",
            "des": "哈萨克斯坦",
            "weight": 1,
            "length": 0,
            "width": 0,
            "height": 0,
            "pieces": 1,
            "sysDate": "2017-07-22 13:18:17",
            "receiverName": "Khyzhniak",
            "receiverUnit": "Khyzhniak",
            "receiverAddr": "Michurina 19   Smela, Cherkasy, Ukraine",
            "receiverCity": "Smela",
            "receiverPostcode": "20701",
            "receiverProvince": "Cherkasy",
            "receiverCountry": "Ukraine",
            "receiverPhone": "38067321877",
            "receiverEMail": "",
            "receiverSms": "3806732877",
            "receiverIDCard": "",
            "senderName": "jiewang",
            "senderUnit": "jw",
            "senderAddr": "ruidu  shanghai",
            "senderCity": "shanghai",
            "senderPostcode": "384858",
            "senderProvince": "shanghai",
            "senderCountry": "shanghai",
            "senderPhone": "384858",
            "senderEMail": "123423@qq.com",
            "senderSms": "12345678902",
            "senderIDCard": "",
            "refNo": "",
            "customsNo": "",
            "mark": "",
            "memo": "122121",
            "reserveString": "",
            "reserveInt": 0,
            "insured": 0,
            "feeInsurance": 0,
            "currency": null,
            "source": "捷网单票下单",
            "printCount": 1,
            "transNote": null,
            "orderPreGoodsList": [{
                "orderPreId": 646656,
                "cnName": "物品中文名",
                "enName": "English Name",
                "quantity": 1,
                "unit": "",
                "declaredValue": 11,
                "origin": null,
                "hsCode": "",
                "sku": "",
                "duty": null,
                "tariffRate": null,
                "netWeight": null,
                "wpos": null,
                "url": null
            }]
        },
                        。
                        。
                        。
                        。
 }
                        
查询失败返回消息: { "ReturnValue": -1, "cMess": "授权失败" }
返回说明
ReturnValue:大于或等于0表示查询到的记录数;如果失败:-1,授权失败;-2,查询订单每页订单数量不能超过200条 -9,表示系统异常或其他错误
PageNo: 当前页;查询失败: 无
PagePer: 每页显示订单数量;查询失败:无
TotalRec: 查询到的订单总数量;查询失败:无
RecList: 查询到的订单集合,具体参数见下方RecList参数说明;可能为空;查询失败:无
cMess: 消息说明;查询成功:null;查询失败:失败消息说明
RecList参数说明
参数名称 类型 描述
id Integer 预录单id
payWay Integer 付款方式,0(月结),1(现付),2(到付)
amount BigDecimal 快递费,元,2位小数。
waybillNum String 运单号
transportNo String 转单号
clientId Integer 捷网注册用户客户ID;唯一身份识别字段
type Integer 快件类型,默认为1;0(文件),1(包裹),2(防水袋)
language Integer 地域语言,默认为0;0(中国大陆),1(华语),2(其它地域)
model String 快递渠道
distribution String 分拨,运输方式(快递类别)
from String 出发地,可空
des String 快递渠道所到达的国家;0-63字符
weight BigDecimal 重量,kg
length Integer 长,厘米,可空
width Integer 宽,厘米,可空
height Integer 高,厘米,可空
pieces Integer 包裹数量
sysDate Date 预录单下单时间
receiverName String 收件人姓名
receiverUnit String 收件人单位
receiverAddr String 收件人地址
receiverCity String 收件人城市
receiverPostcode String 收件人邮编
receiverProvince String 收件人省州
receiverCountry String 收件人国家
receiverPhone String 收件人电话
receiverSms String 收件人电邮
receiverEMail String 收件人email
receiverIDCard String 收件人证照号
senderName String 发件人
senderUnit String 发件人单位
senderAddr String 发件人地址
senderCity String 发件人城市
senderPostcode String 发件人邮编
senderProvince String 发件人省州
senderCountry String 发件人国家
senderPhone String 发件人电话
senderEMail String 发件人电邮
senderSms String 发件人手机
senderIDCard String 发件人证照号
refNo String 平台订单号
customsNo String 报关号
mark String 标签
memo String 备注
reserveString String 留用串
reserveInt String 留用数
insured Integer 保额 元;捷网保险费用=保额*2%
feeInsurance BigDecimal 保险费 元,捷网保险费用=保额*2%
currency String 货币代码,针对物品列表中的单价
source String 订单来源
printCount Integer 面单打印次数
transNote String 转运备注
orderPreGoodsList List 物品信息集合;参数说明见下方
orderPreGoodsList参数说明
参数名称 类型 描述
orderPreId Integer 预录单id
cnName String 物品名称、报关中文名
enName String 物品名称、报关英文名
quantity Integer 物品数量
unit String 物品单位
declaredValue BigDecimal 物品单价,2位小数。单位为currency字段
origin String 原产地国家代码
hsCode String 海关编码
sku String sku编码
duty BigDecimal 关税额
tariffRate BigDecimal 税率
netWeight BigDecimal 物品净重
wpos Integer 序号
url String 物品连接

查询已处理订单
功能
查询已处理订单
请求URL
GET http://api2.j-net.cn/order/rec
请求参数
参数名称 类型 是否必须 描述
clientId Integer 用户ID:http请求头部信息
md5 String md5 加密后的客户Id和密钥,比如:MD5.encrypt(客户Id + 密钥):http请求头部信息
model String 快递渠道;默认为空字符串
keyword String 运单号/转单号/平台订单号;支持模糊查询,默认为空字符串
des String 目的地;默认为空字符串
begin Date 订单查询开始时间,格式为“yyyy-MM-dd”;默认为空
end Date 订单查询结束时间,格式为“yyyy-MM-dd”;默认为空
pageNo Integer 当前页;默认为1
pagePer Integer 每页显示订单数量;默认为50;最多只能每页显示200条记录
ver Integer 是否核销; 0-否 1-是;默认为查询所有
status String 订单状态;11-转运中 12-送达 13-异常 14-退件 多个状态用英文逗号分隔;默认为所有状态
请求示例
http://api2.j-net.cn/order/rec?model=&keyword=&des=&begin=&end=&pageNo=&pagePer=&ver=&status=
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);
返回结果
查询成功返回消息:
{
    "ReturnValue": 100,
    "PageNo": 1,
    "PagePer": 100,
    "TotalRec": 470,
    "RecList": [
        {
            "id": 615082,
            "payWay": 0,
            "amount": 0,
            "auditId": 0,
            "waybillNum": "JNTLYD02000519",
            "transportNo": "JNTLYD02000519",
            "clientId": 2158,
            "type": 0,
            "model": "J-NET俄快通",
            "des": "俄罗斯",
            "weight": 1,
            "length": null,
            "width": null,
            "height": null,
            "cubic": 0,
            "pieces": 1,
            "receiverName": "Тахтахаев Евгений",
            "receiverUnit": "J-NET",
            "receiverAddr": "Чита, дом 43, пом. 1.",
            "receiverCity": "Чита",
            "receiverPostcode": "672000",
            "receiverProvince": "",
            "receiverCountry": "Russian Federation",
            "receiverPhone": "891513186",
            "receiverEMail": "",
            "receiverSms": "89151521486",
            "receiverIDCard": "",
            "senderName": "捷网测试",
            "senderUnit": "",
            "senderAddr": "",
            "senderCity": "",
            "senderPostcode": "158121231",
            "senderProvince": "",
            "senderCountry": "",
            "senderPhone": "1581212231",
            "senderEMail": "",
            "senderSms": "1581521231",
            "senderIDCard": "",
            "refNo": "",
            "customsNo": "",
            "mark": "",
            "memo": "捷网测试",
            "reserveString": "",
            "reserveInt": "0",
            "insured": 0,
            "days": 0,
            "state": 11,
            "sendDate": "1900-01-01 00:00:00",
            "sysDate": "2017-07-22 21:07:12",
            "currency": null,
            "source": "erp",
            "paid": false,
            "depotOutId": null,
            "orderRecGoodsList": [
                {
                    "orderRecId": 615082,
                    "cnName": "笔记本电脑",
                    "enName": "notebook computer",
                    "quantity": 10,
                    "unit": "",
                    "declaredValue": 0,
                    "origin": null,
                    "hsCode": "",
                    "sku": "notebook2017",
                    "duty": 0,
                    "tariffRate": 0,
                    "netWeight": 0,
                    "wpos": null,
                    "url": "https://detail.1688.com/offer/1225071975.html?spm=0.0.0.0.yTapIf"
                }
            ]
        },
        {
            "id": 608953,
            "payWay": 0,
            "amount": 0,
            "auditId": 40601,
            "waybillNum": "JNTLYD02000483",
            "transportNo": "JNTLYD02000483",
            "clientId": 2158,
            "type": 0,
            "model": "J-NET俄快通",
            "des": "俄罗斯",
            "weight": 1,
            "length": null,
            "width": null,
            "height": null,
            "cubic": 0,
            "pieces": 1,
            "receiverName": "Тахтахаев Евгений",
            "receiverUnit": "J-NET",
            "receiverAddr": "Чита, дом 43, пом. 1.",
            "receiverCity": "Чита",
            "receiverPostcode": "672000",
            "receiverProvince": "",
            "receiverCountry": "Russian Federation",
            "receiverPhone": "8915112486",
            "receiverEMail": "",
            "receiverSms": "8915151486",
            "receiverIDCard": "",
            "senderName": "test",
            "senderUnit": "",
            "senderAddr": "",
            "senderCity": "",
            "senderPostcode": "1212121212",
            "senderProvince": "",
            "senderCountry": "",
            "senderPhone": "1212121212",
            "senderEMail": "",
            "senderSms": "1212121212",
            "senderIDCard": "",
            "refNo": "",
            "customsNo": "",
            "mark": "",
            "memo": "test",
            "reserveString": "",
            "reserveInt": "0",
            "insured": 0,
            "days": 0,
            "state": 11,
            "sendDate": "1900-01-01 00:00:00",
            "sysDate": "2017-07-19 16:20:53",
            "currency": null,
            "source": "",
            "paid": false,
            "depotOutId": null,
            "orderRecGoodsList": [
                {
                    "orderRecId": 608953,
                    "cnName": "蒜",
                    "enName": "Garlic",
                    "quantity": 100,
                    "unit": "",
                    "declaredValue": 0,
                    "origin": null,
                    "hsCode": "",
                    "sku": "Garlic123",
                    "duty": 0,
                    "tariffRate": 0,
                    "netWeight": 0,
                    "wpos": null,
                    "url": null
                }
            ]
        },
                        。
                        。
                        。
                        。
 }
                        
查询失败返回消息: { "ReturnValue": -1, "cMess": "授权失败" }
返回说明
ReturnValue: 大于或等于0表示查询到的记录数; 小于0 获取失败: -1,授权失败 -2 每页显示订单数量不能超过200条 -4 快递类别不支持 -9 系统错误或其他错误 -11 快递类别不支持
PageNo: 当前页;查询失败: 无
PagePer: 每页显示订单数量;查询失败:无
TotalRec: 查询到的订单总数量;查询失败:无
RecList: 查询到的订单集合,具体参数见下方RecList参数说明;可能为空;查询失败:无
cMess: 消息说明;查询成功:null;查询失败:失败消息说明
RecList参数说明
参数名称 类型 描述
id Integer 订单id
payWay Integer 付款方式,0(月结),1(现付),2(到付)
amount BigDecimal 快递费,元,2位小数。
auditId Integer 收款核销记录ID,0表示未收款核销
waybillNum String 运单号
transportNo String 转单号
clientId Integer 捷网注册用户客户ID;唯一身份识别字段
type Integer 快件类型,默认为1;0(文件),1(包裹),2(防水袋)
language Integer 地域语言,默认为0;0(中国大陆),1(华语),2(其它地域)
model String 快递渠道
des String 快递渠道所到达的国家;0-63字符
weight BigDecimal 重量,kg
length Integer 长,厘米,可空
width Integer 宽,厘米,可空
height Integer 高,厘米,可空
cubic Integer 体积,立方厘米
pieces Integer 包裹数量
receiverName String 收件人姓名
receiverUnit String 收件人单位
receiverAddr String 收件人地址
receiverCity String 收件人城市
receiverPostcode String 收件人邮编
receiverProvince String 收件人省州
receiverCountry String 收件人国家
receiverPhone String 收件人电话
receiverSms String 收件人电邮
receiverEMail String 收件人email
receiverIDCard String 收件人证照号
senderName String 发件人
senderUnit String 发件人单位
senderAddr String 发件人地址
senderCity String 发件人城市
senderPostcode String 发件人邮编
senderProvince String 发件人省州
senderCountry String 发件人国家
senderPhone String 发件人电话
senderEMail String 发件人电邮
senderSms String 发件人手机
senderIDCard String 发件人证照号
refNo String 平台订单号
customsNo String 报关号
mark String 标签
memo String 备注
reserveString String 留用串
reserveInt String 留用数
insured Integer 保额 元;捷网保险费用=保额*2%
days Integer 预计送达天数
state Integer 状态
sendDate Date 发送日期
sysDate Date 业务记录系统时间
currency String 货币代码,针对物列表中的单价
source String 订单来源
paid Boolean 是否已付款 0、否,1、是
orderRecGoodsList List 物品信息集合;参数说明见下方
orderRecGoodsList参数说明
参数名称 类型 描述
orderRecId Integer 订单id
cnName String 物品名称、报关中文名
enName String 物品名称、报关英文名
quantity Integer 物品数量
unit String 物品单位
declaredValue BigDecimal 物品单价,2位小数。单位为currency字段
origin String 原产地国家代码
hsCode String 海关编码
sku String sku编码
duty BigDecimal 关税额
tariffRate BigDecimal 税率
netWeight BigDecimal 物品净重
wpos Integer 序号
url String 物品连接

获取物流跟踪信息
功能
获取物流跟踪信息
请求URL
GET http://api2.j-net.cn/track/{num}
请求参数
参数名称 类型 是否必须 描述
num String 捷网运单号,每次只能获取一个订单物流信息
请求示例
http://api2.j-net.cn/track/JNTCU0100221889YQ
返回结果
{
    "ReturnValue": 1,
    "RecList": [
        {
            "error": null,
            "num": "JNTCU0600046683YQ",
            "transNum": "MSK0000027695",
            "model": "MOSEXP",
            "destinationCountry": "Russian",
            "lastStatus": "GTMS_SIGNED",
            "lastTrackElement": {
                "type": "DC",
                "time": "2017-07-13 11:54:00",
                "country": "Russian",
                "city": null,
                "facilityName": "Армавир",
                "timeZone": "+3",
                "desc": "Товар был успешно доставлен получателю. Спасибо что воспользовались нашими услугами",
                "actionCode": "GTMS_SIGNED"
            },
            "trackElementList": [
                {
                    "type": "DC",
                    "time": "2017-07-07 17:39:09",
                    "country": "Russian",
                    "city": null,
                    "facilityName": "Sorting center of J-NET",
                    "timeZone": "+3",
                    "desc": "Order received successfully",
                    "actionCode": "GWMS_ACCEPT"
                },
                {
                    "type": "DC",
                    "time": "2017-07-07 17:39:00",
                    "country": "Russian",
                    "city": null,
                    "facilityName": "Sorting center of J-NET",
                    "timeZone": "+3",
                    "desc": "The parcel is ready to transfer to the courier",
                    "actionCode": "VISIBLE_UNKOWN"
                },
                        。
                        。
                        。
             ]
        }
    ],
    "cMess": ""
}
请求失败返回消息:
{
    "ReturnValue": -2,
    "cMess": "参数有误"
}
                    
返回说明
ReturnValue:1,获取成功;如果失败:-1,授权失败; -6,运单号错误或者不是已处理订单;-9,系统异常或其他错误
cMess:如果成功:为空字符串;失败: 失败原因
RecList参数说明
参数名称 类型 描述
error String 物流查询错误消息;可能为null
num String 运单号
transNum String 转单号
model String 快递渠道
destinationCountry String 目的地国家
lastStatus String 最后物流状态码
lastTrackElement Map 最后物流动态,具体参数说明见trackElement
trackElementList List 物流动态集合;具体参数说明见trackElement
trackElement参数说明
参数名称 类型 描述
type String 物流状态发生地是否在国内(中国);OC:在国内;DC:在国外
time Date 物流状态发生时间,北京时间
country String 物流状态发生地点所在国家
city String 物流状态发生所在城市,一般为null
facilityName String 物流状态发生地点名称
timeZone String 物流状态发生地点所在国家时区
desc String 物流状态描述
actionCode String 物流状态码