捷网仓储API

概述

更新通知：

2017.07.23更新海外仓接口文档v2.0版本，接口全面升级，字段明确，包含从物品添加到客户订单，全部过程可与erp同步。其中包括：物品管理、库存管理、入库管理、出库管理、费用管理、消息管理、打印管理七大模块：
    物品管理：查看物品、添加物品、修改物品、修改物品图片、删除物品
    库存管理：查看库存、物品归库、修改库存预警
    入库管理：查看入库记录、申请入库、删除入库申请
    出库管理：查看出库记录、申请出库、删除出库申请
    打印管理：入库面单打印、sku条码打印
其基本对接流程如下：
    添加物品->物品归库->申请入库->等待我方工作人员确认入库->客户下单申请出库->等待我方工作人员出库操作->对接完成
假如erp不支持全面对接，还可以直接对接出库申请，其操作流程：
    1、客户在我方erp和对接方erp上各添加同样的物品信息（ps:sku必须一样，物品信息最好保持一致，否则会出现出入库物品信息不一致）
    2、客户在我方erp和对接方erp都同时进行入库
    3、等待我方工作人员进行入库确认
    4、客户可以在对接方erp上进行下单与我们的出库申请进行同步
    5、我方工作人员进行出库确认
如果有不明事项，或者接口有什么不完善的地方等事项，还望和对接技术人员进行商议！

物品管理 --查看物品

功能

查看物品

HTTP请求方式

GET

请求URL

http://api.j-net.cn/goods?sku={sku}&cnName={物品中文名称}&enName={物品英文名称}&state=0&mark={物品标签}&pageNo={页码}&pagePer={页大小}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
sku	String	否	物品sku
cnName	String	否	物品中文名称
enName	String	否	物品英文名称
state	Integer	否	物品状态 0、运营 1、停售
mark	String	否	物品标签
pageNo	Integer	否	页码：默认为1
pagePer	Integer	否	页大小：默认为50，页大小不能超过2000

请求示例

GET http://api.j-net.cn/goods?sku=JQM011A
HttpGet httpGet = new HttpGet(url);
httpGet.addHeader("clientId",clientId);
httpGet.addHeader("md5",md5);

返回结果

{
  "ReturnValue": 1,
  "PageNo": 1,
  "PagePer": 50,
  "TotalRec": 1,
  "RecList": [
    {
      "id": 3997,
      "clientId": 2158,
      "enName": "jiqimao-head",
      "cnName": "机器猫的头",
      "sku": "JQM011A",
      "hsCode": "",
      "producer": "",
      "color": "蓝",
      "size": "中号",
      "brand": "",
      "model": "",
      "origin": "",
      "unit": "",
      "mark": "blue-head",
      "memo": "",
      "length": 0,
      "width": 0,
      "height": 0,
      "weight": 0.000,
      "weightDiff": 0,
      "ex1": "",
      "img": null               //物品图片单独查询，见查看物品图片
    }
  ],
  "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	如果成功：返回物品的个数以及信息如果不成功：0为获取失败，-9为系统异常,-2为页大小不能超过2000
cMess	String	如果成功：返回成功说明，如果失败：返回失败说明，对应ReturnValue
id	Integer	物品Id
clientId	Integer	用户id
enName	String	物品英文名称
cnName	String	物品中文名称
sku	String	物品统一编码sku，1-63字节
hsCode	String	海关编码
producer	String	生产商
color	String	颜色
size	String	尺码
brand	String	商标
model	String	型号
origin	String	原产地国家代码
unit	String	计量单位
mark	String	标签
memo	String	备注
length	Integer	长
width	Integer	宽
height	Integer	高
weight	Float	重量（公斤）
weightDiff	Float	重量偏差(克)
ex1	String	数据来源
img	byte[]	物品图片单独查询：见查看物品图片

物品管理 --查看物品图片

功能

查看物品图片

HTTP请求方式

GET

请求URL

http://api.j-net.cn//goods/img/{goodsId}

请求参数

参数名称	类型	是否必须	描述
goodsId	Integer	是	物品Id

请求示例

GET http://api.j-net.cn/goods/img/4720

返回结果

图片文件

物品管理 --添加物品

功能

添加物品

HTTP请求方式

POST Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/goods

请求参数

参数名称

类型

是否必须

描述

clientId

Integer

是

客户Id：http请求头部信息

md5

String

是

md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

body(request body)

String

是

[
    {
        "clientId": 2158,
        "enName": "notebook computer",
        "cnName": "笔记本电脑",
        "sku": "notebook2017",
        "hsCode": "notebook2017",
        "producer": "生产商",
        "color": "蓝",
        "size": "尺寸",
        "brand": "商标",
        "model": "型号",
        "origin": "CN",
        "unit": "件",
        "mark": "标签",
        "memo": "备注",
        "length": 0,
        "width": 0,
        "height": 0,
        "weight": 0,
        "weightDiff": 0,
        "declaredValue": 111,
        "img":base64加密图片,
        "ex1": "测试erp"
    }
]

请求示例

POST http://api.j-net.cn/goods
HttpPost post = new HttpPost(url);
post.addHeader("clientId",clientId);
post.addHeader("md5",md5);
post.setEntity(body);

返回结果

{
    "ReturnValue": 1,
    "RecList": [
        {
            "target": {
                "id": 4324,
                "clientId": 2158,
                "enName": "notebook computer",
                "cnName": "笔记本电脑",
                "sku": "notebook2017",
                "hsCode": "notebook2017",
                "producer": "生产商",
                "color": "蓝",
                "size": "尺寸",
                "brand": "商标",
                "model": "型号",
                "origin": "CN",
                "unit": "件",
                "mark": "标签",
                "memo": "备注",
                "length": 0,
                "width": 0,
                "height": 0,
                "weight": 0,
                "weightDiff": 0,
                "declaredValue": 111,
                "img":base64加密图片,
                "ex1": "测试erp"
            },
            "message": 4324,
            "success": true
        }
    ],
    "cMess": "总共1条，成功1条"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	ReturnValue:大于0，为添加成功；0为添加失败；-9为系统异常
cMess	String	成功或者失败说明，失败说明：授权失败参数有误：body和捷网字段不一致而导致的错误
target	json	返回的物品信息：见body说明
cMess	boolean	是否添加成功：成功返回true，失败返回false
message	T	添加成功则返回添加物品的id值，失败则返回失败原因：统一编码sku重复商品名称重复客户Id不能为空物品sku不能为空物品sku长度不能超过63个字符，一个中文占用两个字符物品中文名称不能为空物品中文名称长度不能超过63个字符，一个中文占用两个字符物品英文名称不能为空物品英文名称长度不能超过254个字符，一个中文占用两个字符其他系统异常

新增物品body参数说明

参数名称	类型	是否必须	描述
id	Integer	是	物品Id ps:如果是修改则这个字段必须填写；如果是添加，这个字段不用填写
clientId	Integer	是	客户Id
enName	String	是	物品英文名称,0-254个字节
cnName	String	是	物品中文名称,0-63个字节
sku	String	是	物品统一编码SKU，0-63字节
hsCode	String	否	HS编码,0-15字节
producer	String	否	生产商，0-63字节。
color	String	否	物品颜色,0-15字节
size	String	否	物品尺码，0-15字节
brand	String	否	商标，0-15字节。
model	String	否	型号，0-63字节。
origin	String	否	原产地国家代码，0-3字节。
unit	String	否	计量单位，0-15字节。
mark	String	否	标签，0-15字节。
memo	String	否	备注，0-254字节。
length	Integer	否	长(cm)
width	Integer	否	宽(cm)
height	Integer	否	高(cm)
weight	Float	否	重量，公斤
declaredValue	Integer	是	单个sku货值
img	byte[]	否	base64加密图片
ex1	String	是	数据来源

物品管理 --修改物品

功能

修改物品

HTTP请求方式

PATCH Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/goods

请求参数

参数名称

类型

是否必须

描述

clientId

Integer

是

客户Id：http请求头部信息

md5

String

是

md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

body(request body)

String

是

[
    {
        "id":4324,
        "enName": "notebook computer",
        "cnName": "笔记本电脑",
        "hsCode": "notebook2017",
        "producer": "生产商",
        "color": "蓝",
        "size": "尺寸",
        "brand": "商标",
        "model": "型号",
        "origin": "CN",
        "unit": "件",
        "mark": "标签",
        "memo": "备注",
        "length": 0,
        "width": 0,
        "height": 0,
        "weight": 0,
        "weightDiff": 0,
        "declaredValue": 111,
        "img":base64加密图片,
        "ex1": "测试erp"
    }
]

请求示例

PATCH http://api.j-net.cn/goods

返回结果

{
    "ReturnValue": 1,
    "RecList": [
        {
            "target": {
                "id": 4324,
                "clientId": 2158,
                "enName": "notebook computer",
                "cnName": "笔记本电脑",
                "sku": "notebook2017",
                "hsCode": "notebook2017",
                "producer": "生产商",
                "color": "蓝",
                "size": "尺寸",
                "brand": "商标",
                "model": "型号",
                "origin": "CN",
                "unit": "件",
                "mark": "标签",
                "memo": "备注",
                "length": 0,
                "width": 0,
                "height": 0,
                "weight": 0,
                "weightDiff": 0,
                "declaredValue": 111,
                "img":base64加密图片,
                "ex1": "测试erp"
            },
            "message": 1,
            "success": true
        }
    ],
    "cMess": "总共1条，成功1条"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	ReturnValue:大于0，为修改成功；0为修改失败；-9为系统异常
cMess	String	成功或者失败说明，失败说明：授权失败参数有误：body和捷网字段不一致而导致的错误
target	json	返回修改的物品信息：见 body说明
message	Object	成功返回1，失败返回失败原因：添加成功则返回添加物品的id值，失败则返回失败原因：物品不存在中文名称重复客户编码重复物品Id不能为空物品中文名称长度不能超过63个字符，一个中文占用两个字符物品英文名称不能为空物品英文名称长度不能超过254个字符，一个中文占用两个字符其他系统异常
success	boolean	成功：true,失败：false

修改物品body参数说明

参数名称	类型	是否必须	描述
id	Integer	是	物品Id
enName	String	否	物品英文名称,0-254个字节
cnName	String	否	物品中文名称,0-63个字节
hsCode	String	否	HS编码,0-15字节
producer	String	否	生产商，0-63字节。
color	String	否	物品颜色,0-15字节
size	String	否	物品尺码，0-15字节
brand	String	否	商标，0-15字节。
model	String	否	型号，0-63字节。
origin	String	否	原产地国家代码，0-3字节。
unit	String	否	计量单位，0-15字节。
mark	String	否	标签，0-15字节。
memo	String	否	备注，0-254字节。
length	Integer	否	长(cm)
width	Integer	否	宽(cm)
height	Integer	否	高(cm)
weight	Float	否	重量，公斤
declaredValue	Integer	是	单个sku货值
img	byte[]	否	base64加密图片

物品管理 --删除物品

功能

删除物品：ps：物品归库之前可以删除，但是物品归库之后不能删除

HTTP请求方式

DELETE

请求URL

http://api.j-net.cn/goods/{goodsId}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
goodsId	String	是	物品id

请求示例

DELETE http://api.j-net.cn/goods/4324
HttpDelete delete = new HttpDelete(url);
delete.addHeader("clientId",clientId);
delete.addHeader("md5",md5);

返回结果

{"ReturnValue":4324,"cMess":"删除成功"}

返回结果

参数名称	类型	描述
ReturnValue	Integer	大于0：删除成功，返回删除的物品Id；等于0：删除失败；-2：不存在的sku；-3：已有库存；-4：已有出售的商品；-9：系统异常
cMess	String	成功或者失败说明：删除成功该物品不存在已有库存已有出售的商品

库存管理 --查看库存

功能

查看库存

HTTP请求方式

GET

请求URL

http://api.j-net.cn/depot/{depot}?sku={sku}&mark={标签}&state={库存状态}&pageNo={页码}&pagePer={页大小}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	是	仓库编码
sku	String	否	物品统一编码SKU,如果是多个用英文逗号分隔
mark	String	否	标签
state	Integer	否	库存状态：0、库存正常；1、库存不足；2、库存过剩
pageNo	Integer	否	页码：默认为1
pagePer	Integer	否	页大小：默认为50，最大不能超过2000

请求示例

GET http://api.j-net.cn/depot/C05?sku=JSQM0011A

返回结果

{
    "ReturnValue": 1,
    "PageNo": 1,
    "PagePer": 50,
    "TotalRec": 1,
    "RecList": [
        {
            "id": 4520,
            "clientId": 2158,
            "goodsId": 4324,
            "depot": "C05",
            "min": 0,
            "max": 0,
            "in": 20,
            "out": 2,
            "inventory": 20,
            "mark": "标签",
            "memo": "备注",
            "source": "",
            "goods": {
                "id": 4324,
                "clientId": 2158,
                "enName": "notebook computer",
                "cnName": "笔记本电脑",
                "sku": "notebook2017",
                "hsCode": "notebook2017",
                "producer": "生产商",
                "color": "蓝",
                "size": "尺寸",
                "brand": "商标",
                "model": "型号",
                "origin": "CN",
                "unit": "",
                "mark": "标签",
                "memo": "备注",
                "length": 0,
                "width": 0,
                "height": 0,
                "weight": 1.6,
                "weightDiff": 0,
                "ex1": "测试erp"
            }
        }
    ],
    "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功；0：获取失败，没有归库记录；-9：系统异常；-2：页大小不能超过2000。
PageNo	Integer	页码
PagePer	Integer	页大小
TotalRec	Integer	所有物品总数
id	Integer	库存物品id
clientId	Integer	客户Id
goodsId	Integer	物品Id
depot	String	仓库代码
min	Integer	最小库存量
max	Integer	最大库存量
in	Integer	入库总量
out	Integer	出库总量
inventory	Integer	库存量
mark	String	标签
memo	String	备注
goods		见goods字段说明
cMess	String	成功或失败说明，对应ReturnValue

库存管理 --查看出入库历史记录

功能

查看出入库历史记录

HTTP请求方式

GET

请求URL

http://api.j-net.cn/depot/{仓库代码}/history?sku={sku}&pageNo={页码}&pagePer={页码大小}&begin={开始时间}&end={结束时间}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	是	仓库编码
sku	String	否	物品统一编码SKU,如果是多个用英文逗号分隔
pageNo	Integer	否	页码：默认为1
pagePer	Integer	否	页码大小：每页有多少数据默认为200 最大不能超过2000

请求示例

GET http://api.j-net.cn/depot/C05/history?sku=notebook2017

返回结果

{
  "ReturnValue": 3,
  "PageNo": 1,
  "PagePer": 200,
  "TotalRec": 3,
  "RecList": [
    {
      "id": 17046,
      "sysDate": "2017-07-26 17:37:33",
      "waybillNum": "JNTCU0400016705YQ",
      "in": null,
      "out": 2,
      "inventory": 18,
      "inOrderId": null,
      "outOrderId": 623547,
      "sku": "notebook2017",
      "depot": "C05",
      "clientId": 2158,
      "model": "俄快递",
      "status": 4,
      "oldInventory": 20
    },
    {
      "id": 17043,
      "sysDate": "2017-07-26 17:32:46",
      "waybillNum": "JNTLYD02000561",
      "in": 10,
      "out": null,
      "inventory": 20,
      "inOrderId": 623522,
      "outOrderId": null,
      "sku": "notebook2017",
      "depot": "C05",
      "clientId": 2158,
      "model": "中俄东线陆运",
      "status": 3,
      "oldInventory": 10
    },
    {
      "id": 13580,
      "sysDate": "2017-07-22 21:07:49",
      "waybillNum": "JNTLYD02000519",
      "in": 10,
      "out": null,
      "inventory": 10,
      "inOrderId": 615092,
      "outOrderId": null,
      "sku": "notebook2017",
      "depot": "C05",
      "clientId": 2158,
      "model": "中俄东线陆运",
      "status": 3,
      "oldInventory": 0
    }
  ],
  "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功；返回查询的个数；小于0：获取失败，-1、授权失败，-2、页大小不能超过2000，-3、sku不能为空，-9、系统异常并返回异常信息
PageNo	Integer	页码
PagePer	Integer	每页多少数据
TotalRec	Integer	数据总数
RecList	List	查询出来的出入库历史记录
cMess	String	获取成功或失败原因说明，对应ReturnValue

出入库记录RecList说明

参数名称	类型	描述
id	Integer	出入库历史记录id
sysDate	Date	订单日期
waybillNum	String	运单号
in	Integer	入库数量
out	Integer	出库数量
inventory	Integer	库存数量
inOrderId	Integer	入库订单id
outOrderId	Integer	出库订单id
sku	String	物品sku
depot	String	仓库代码
clientId	Integer	客户Id
model	String	快递渠道
status	Integer	订单状态，1-库存报损；2-转运中；3-送达；4-退件入库和退件；5-其它异常
oldInventory	Integer	出入库之前的库存数量

库存管理 --物品归库

功能

物品归库

HTTP请求方式

POST Content-Type:"application/json; charset=UTF-8"

新增请求URL

http://api.j-net.cn/depot

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http头部信息
md5	Integer	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
body(request body)	String	是	[ { "goodsId":4324, "clientId":2158, "depot":"C01", "mark":"标签", "memo":"备注", "source":"测试erp" } ]

请求示例

POST：http://api.j-net.cn/depot
HttpPost post = new HttpPost(url);
post.addHeader("clientId",clientId);
post.addHeader("md5",md5);
post.setEntity(body);

返回结果

{
  "ReturnValue": 1,
  "RecList": [
    {
      "target": {
        "id": 5257,
        "goodsId": 4324,
        "clientId": 2158,
        "depot": "C01",
        "mark": "标签",
        "memo": "备注",
        "source": "测试erp"
      },
      "message": 5257,
      "success": true
    }
  ],
  "cMess": "总共1条，成功1条"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：归库成功，小于0：归库失败 -1、授权失败；-2、参数有误，一般是字段和捷网字段不一致；-9、其他系统异常
cMess	String	总共处理几条数据，成功处理了几条数据说明，系统异常说明
message	Object	如果成功返回id值，如果失败返回失败原因：重复归库该物品[goodsId]不存在其他系统异常说明
success	boolean	如果成功返回true，如果失败返回false
id	Integer	归库Id
clientId	Integer	客户Id
goodsId	Integer	物品Id
depot	String	仓库代码
mark	String	标签
memo	String	备注
source	String	数据来源，一般为erp简称

入库管理 --申请/修改入库

功能

申请/修改入库：如果此运单号存在则为修改，如果此运单号不存在则为添加入库。

HTTP请求方式

POST Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/depot/in

请求参数

参数名称

类型

是否必须

描述

clientId

Integer

是

客户Id：http头部信息

md5

String

是

md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

body(request body)

String

是

{
        "waybillNum": "JNTLYD02000648",
        "depot": "C05",
        "leaveTime":"2017-07-21 21:23:22",
        "transWay": "中俄东线陆运",
        "clientId": 2158,
        "contactPerson": "捷网测试",
        "contactTel": "15815922231",
        "memo": "捷网测试",
        "cartonQty": 1,
        "depotInGoods": [
            {
                "sku": "notebook2017",
                "quantity": 10,
                "cartonNo":1,
                "insured":true
            }
        ]
    }

请求示例

POST http://api.j-net.cn/depot/in

返回结果

{"ReturnValue":5020,"入库成功"}

返回说明

参数名称	类型	描述
ReturnValue	Integer	ReturnValue: 大于0：添加成功，返回申请入库数据Id; 0：添加失败，返回失败原因 -9：系统异常，返回异常原因 -1：授权失败
Rec	json	见查看入库记录返回说明
cMess	String	如果失败返回失败原因：请先获取头程单号单号不合规,请重新获取运单号该订单已收到，无法修改客户Id不能为空头程单号不能为空联系人不能为空联系人电话不能为空入库物品不能为空物品运单号不能为空物品Id不能为空物品数量不能为空物品sku不能为空该订单存在未归库物品，请更改后再提交授权失败参数错误：一般为字段名和捷网的不一致系统异常并返回异常信息

入库body说明

参数名称	类型	是否必须	描述
waybillNum	String	是	头程单号：ps：如果是添加，先获取单号赋值给它，如果是修改，直接赋值要修改入库的头程单号
depot	String	是	仓库代码
transWay	String	是	头程运输方式（快递类别）
clientId	Integer	是	客户Id
contactPerson	String	是	联系人姓名
contactTel	String	是	联系人电话
cartonQty	Integer	是	箱子数量
memo	String	否	备注

入库物品信息说明

参数名称	类型	是否必须	描述
sku	String	是	入库物品sku
quantity	Integer	是	入库物品数量
cartonNo	Integer	是	箱子编号
insured	Boolean	是	是否投保

库存管理 --修改库存预警

功能

修改库存预警

HTTP请求方式

PATCH Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/depot

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户id：http头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
body(request body)	String	是	{"id":4420,"min":0,"max":10}

修改库存预警body说明

参数名称	类型	是否必须	描述
id	Integer	是	归库Id
min	Integer	是	最小库存量
max	Integer	是	最大库存量

请求示例

PATCH http://api.j-net.cn/depot

返回结果

{ReturnValue:1,cMess:"成功"}

返回说明

参数名称	类型	描述
ReturnValue	Integer	ReturnValue: 大于0：获取成功，返回查询归库物品的个数和信息 0：获取失败，返回失败原因 -9：系统异常，返回异常信息 -1：授权失败 -2：参数有误
cMess	String	成功或失败说明：修改成功该物品不存在物品归库id不能为空其他系统异常信息

入库管理 --查看入库记录

功能

查看入库记录

HTTP请求方式

GET

请求URL

http://api.j-net.cn/depot/in/{depot}?num={头程单号}&sku={sku}&state={状态值}&beginDate={开始时间}&endDate={结束时间}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	用户ID：http头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	是	仓库编码
num	String	否	头程单号，例：JNTLYX03002004或多个单号以逗号分隔JNTLYX03002004,JNTLYD02001433
sku	String	否	物品统一编码sku
state	Integer	否	入库状态
beginDate	Date	否	开始时间格式("YYYY-MM-DD"),年-月-日
endDate	Date	否	结束时间格式("YYYY-MM-DD"),年-月-日
pageNo	Integer	否	页码：默认为1
pagePer	Integer	否	页大小：默认为50，最大不能超过2000

请求示例

GET http://api.j-net.cn/depot/in/C05?num=JNTLYD02000648

返回结果

{
  "ReturnValue": 1,
  "PageNo": 1,
  "PagePer": 50,
  "TotalRec": 1,
  "RecList": [
    {
      "id": 2933,
      "waybillNum": "JNTLYD02000648",
      "depot": "C05",
      "transWay": "中俄东线陆运",
      "leaveTime": null,
      "aboutArrivalTime": null,
      "clientId": 2158,
      "contactPerson": "捷网测试",
      "contactTel": "15815922231",
      "memo": "捷网测试",
      "status": 11,
      "createTime": "2017-08-11 17:28:43",
      "cartonQty": 1,
      "source": null,
      "depotInGoods": [
        {
          "id": 76,
          "goodsId": 4324,
          "sku": "notebook2017",
          "waybillNum": "JNTLYD02000648",
          "cartonNo": 1,
          "quantity": 10,
          "insured": false
        }
      ]
    }
  ],
  "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
id	Integer	入库Id
waybillNum	String	头程单号
depot	String	仓库编码
transWay	String	头程运输方式
aboutArrivalTime	String	预计到达时间
clientId	Integer	客户Id
contactPerson	String	联系人姓名
contactTel	String	联系人电话
memo	String	备注
status	Integer	入库状态：11、预录；12、已收到；13、转运中；14、上架；15、异常；16、未确认
createTime	String	业务发生时间
depotInGoods	List	入库物品信息: 见入库物品信息说明
cMess	String	成功与失败说明

入库物品信息说明

参数名称	类型	描述
id	Integer	入库物品Id
waybillNum	String	头程单号
goodsId	Integer	物品Id
quantity	Integer	入库物品数量
sku	String	入库物品sku
insured	boolean	是否保价：false，否；true，是。对应depotInGoods里面的 insured
cartonNo	Integer	箱号

入库管理 --删除入库申请

功能

删除入库申请

HTTP请求方式

DELETE

请求URL

http://api.j-net.cn/depot/in/{num}

请求参数

参数名称	类型	是否必须	描述
num	String	是	头程单号
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

请求示例

DELETE http://api.j-net.cn/depot/in/JNTLYD0200051

返回结果

{"ReturnValue":78416,"cMess":"取消成功"}

返回说明

returnValue:
大于0：删除成功，返回删除的入库数据id；
0：没有删除成功：订单正在处理，不能取消或者订单不存在；
-1:授权失败
-2：客户不存在
-4：订单不存在
-6：订单已拣货，不能删除
-9：系统异常返回异常信息
cMess：成功或失败说明，对应returnValue

出库管理 --查看申请出库

功能

查看申请出库

HTTP请求方式

GET

请求URL

http://api.j-net.cn/depot/out?depot={仓库代码}&num={运单号}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	是	仓库编码
num	String	否	运单号，例：JNTCU0600129644YQ或多个单号以逗号分隔JNTCU0600129644YQ,JNTCU0600131978YQ
transportNo	String	否	转单号
refNo	String	否	订单号
state	Integer	否	出库状态：11、未审核；12、已审核；13、捡货完成；14、出库确认
beginDate	Date	否	开始时间格式为（"YYYY-MM-DD"）年-月-日
endDate	Date	否	结束时间格式为（"YYYY-MM-DD"）年-月-日
pageNo	Integer	否	页码：默认为1
pagePer	Integer	否	页大小：默认为50，页大小不能超过2000

请求示例

GET http://api.j-net.cn/depot/out?depot=C05&num=JNTCU0400016029YQ

返回结果

{
    "ReturnValue": 1,
    "PageNo": 1,
    "PagePer": 50,
    "TotalRec": 1,
    "RecList": [
        {
            "id": 64701,
            "amount": 0,
            "waybillNum": "JNTCU0400016029YQ",
            "clientId": 2158,
            "type": 1,
            "language": 0,
            "model": "俄快递",
            "des": "RU",
            "weight": 0,
            "pieces": 1,
            "batch": null,
            "purpose": null,
            "receiverName": "Alevtina Shmanatova",
            "receiverUnit": "p. Oktiabr'skii, Sportivnaia, d.1",
            "receiverAddr": "p. Oktiabr'skii, Sportivnaia, d.1",
            "receiverCity": "Lyuberetskiy rayon",
            "receiverPostcode": "140060",
            "receiverProvince": "Moskovskaya oblast",
            "receiverCountry": "RU",
            "receiverPhone": "",
            "receiverEMail": "",
            "receiverSms": "+7--9265507363",
            "receiverIDCard": null,
            "refNo": "503124764724767",
            "customsNo": null,
            "mark": "",
            "memo": "14141241",
            "reserveString": null,
            "reserveInt": null,
            "insured": 13200,
            "quantity": 1,
            "source": "捷网速卖通ERP",
            "goodsList": [
                {
                    "id": 3185,
                    "sku": "panwu123",
                    "cnName": "panwu123",
                    "enName": "shengqing",
                    "quantity": 1
                }
            ],
            "depot": "C05",
            "status": 12,
            "sysDate": "2017-06-28 11:28:44"
        }
    ],
    "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功，返回查询归库物品的个数，0：获取失败，没有归库记录，-9：系统异常，返回异常信息，-1：授权失败
PageNo	Integer	页码
pagePer	Integer	页大小
id	Integer	出库数据Id
amount	Float	快递费用
waybillNum	String	运单号
clientId	String	客户Id
type	Integer	快件类型，0(文件),1(包裹),2(防水袋)
language	String	地域语言，默认为0。取值为：0(中国大陆),1(华语),2(其它地域)
model	String	运输方式(快递类别)
des	String	目的地
weight	Float	重量，公斤
pieces	Integer	件数
batch	String	订单批次
purpose	Integer	订单类别，枚举，默认0。(0:快递;1:提货;2:次品;3:平仓)
receiverName	String	收件人姓名
receiverUnit	String	收件人单位
receiverAddr	String	收件地址
receiverCity	String	收件城市
receiverPostcode	String	收件邮编
receiverProvince	String	收件省州
receiverCountry	String	收件国家
receiverPhone	String	收件电话
receiverEMail	String	收件电邮
receiverSms	String	收件短信
receiverIDCard	String	收件证照号
refNo	String	订单号
customsNo	String	报关号
mark	String	标签
memo	String	备注
insured	Integer	保价,元,捷网保费=保价*2%
quantity	Integer	物品总数
source	String	订单来源：erp简称或者erp公司简称
depot	String	仓库代码
status	Integer	出库状态（11、未审核；12、已审核；13、捡货完成；14、出库确认）
sysDate	Date	业务发生时间
goodsList	List	出库的物品信息：见goods字段说明
cMess	String	成功或失败说明：对应ReturnValue

goodlist说明

参数名称	类型	描述
iquantity	Integer	物品数量
cccode	String	物品编码
cex1	String	备注目前用做转单号存储转下家CDEK和PONY
ntype	Byte	包裹类别类型
giid	String	物品id
cunit	String	计量单位
cgcode	String	统一编码.SKU
icid	String	用户Id
irealout	Integer	实出数量
cname	String	物品名称
fprice	Float	单价，2位小数。

申请出库 --添加出库申请

功能

添加出库申请

HTTP请求方式

POST Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/depot/out

请求参数

参数名称

类型

是否必须

描述

clientId

Integer

是

客户Id：http请求头部信息

md5

String

是

md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

body(request body)

String

是

[
    {
    "waybillNum": "JNTCU0400016588YQ",
    "clientId":2158,
    "type": 1,
    "language": 0,
    "depot": "C05",
    "model": "俄快递",
    "des": "俄罗斯",
    "receiverName": "Serger Kozlov",
    "receiverUnit": "收件人单位",
    "receiverAddr": "收件人地址",
    "receiverCity": "收件人城市",
    "receiverPostcode": "212121",
    "receiverProvince": "收件人省份",
    "receiverCountry": "收件人国家",
    "receiverPhone": "7-4945-5454598",
    "receiverEMail": "20202020@163.com",
    "receiverSms": "13021212121",
    "refNo": "订单号",
    "memo": "备注",
    "quantity":1,
    "distributeProvider": "WB_FBS",          
    "distributeNumber": "*CgjZezt3",
    "distributeLabel": "http://121.4.82.42:9000/erpfile/4017893780_0.png1562514467559464715.pdf",
    "GoodsList": [
        {
            "sku": "notebook2017",
            "cnName": "笔记本电脑",
            "quantity": 1,
            "enName":"notebook computer",
            "unit":"物品单位",
            "declaredValue":1,
            "hsCode":"2017080122",
            "netWeight":0.003
        }
        ]
    }
]

请求示例

POST http://api.j-net.cn/depot/out

返回结果

{"ReturnValue":1,"RecList":[{"target":"JNTCU0400016586YQ","message":78416,"success":true}],"cMess":"总共1条，成功1条"}

返回结果说明

ReturnValue：大于0：添加成功，返回成功的个数；小于等于0：添加失败
target：如果成功，返回成功的运单号，如果失败返回null
message：如果成功返回出库订单的id，如果失败返回失败原因
         该仓库不存在该渠道
         运单号不能为空
         该快递渠道名称填写错误
         该SKU = sku 不存在或当前渠道对应仓库未添加此SKU物品
         运单号重复
         转单号重复
         系统错误
cMess：如果成功能返回总共几条，成功几条
       如果失败：授权失败
       参数有误：一般是body与捷网字段不一致
success：true:添加成功，false：添加失败

出库body参数说明

参数名称	类型	是否必须	描述
waybillNum	String	是	运单号：ps：获取运单号赋值给它
clientId	Integer	是	客户Id
type	Integer	否	快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋)
language	Integer	否	地域语言，默认为0。取值为：0(中国大陆),1(华语),2(其它地域)
model	String	是	快递渠道 0-15个字符
depot	String	是	仓库代号 0-15个字符
des	String	是	到达国家 0-63个字符
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-22字符
receiverEMail	String	否	收件人邮件 0-63字符
receiverIDCard	String	否	收件证照号,0-30字符：俄陆通必须字段
refNo	String	否	订单号,0-30字符
customsNo	String	否	报关号,0-30字符
mark	String	否	标签,0-15字符。
memo	String	否	备注,0-254字符。
insured	Integer	否	保价,元,捷网保费=保价*2%
source	String	是	订单来源，0-63字符，可标记不同的ERP等
currency	String	否	货币代码,针对物列表中的单价,0-3字符
url	String	否	链接
distributeProvider	String	否	派送商
distributeNumber	String	否	派送单号
distributeLabel	String	否	派送面单
GoodsList	List	是	[ { "sku": "notebook2017", "cnName": "笔记本电脑", "quantity": 1, "enName":"notebook computer", "unit":"物品单位", "declaredValue":1, "hsCode":"2017080122", } ]

GoodsList字段说明

参数名称	类型	是否必须	描述
sku	String	是	物品统一编码sku，1-63字节
cnName	String	是	物品中文名称，1-63字节
quantity	Integer	是	物品数量
enName	String	是	物品英文名称，1-254字节
unit	String	否	物品单位
declaredValue	Float	否	物品单价,元,2位小数,此价影响关税
hsCode	String	否	海关编码,0-63字符

申请出库 --删除出库申请

功能

删除出库申请

HTTP请求方式

DELETE

请求URL

http://api.j-net.cn/depot/out/{num}

请求参数

参数名称	类型	是否必须	描述
num	String	是	运单号
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5加密过的客户id和密钥：http请求头部信息

请求示例

DELETE http://api.j-net.cn/depot/out/JNTCU0400016586YQ

返回结果

{"ReturnValue":78416,"cMess":"取消成功"}

返回说明

ReturnValue:
大于0：删除成功；
0：没有删除成功：订单正在处理，不能取消或者订单不存在；
-1:授权失败
-2：客户不存在
-4：订单不存在
-6：订单已拣货，不能删除
-9：系统异常返回异常信息
cMess：成功或失败说明，对应ReturnValue

费用管理 --订单费用查询

功能

查看申请出库

HTTP请求方式

GET

请求URL

http://api.j-net.cn//fee/orders?begin={开始时间}&end={结束时间}&payStatus={付款状态}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
begin	Date	是	开始时间：业务发生时间格式为："yyyy-MM-dd"
end	Date	是	结束时间：业务发生时间格式为："yyyy-MM-dd"
model	String	否	快递渠道
payStatus	Integer	否	是否已付款：0-全部 11-未付款 12-已付款默认为11

请求示例

GET http://api.j-net.cn/orders?begin=2017-02-02&end=2017-07-30&payStatus=11

返回结果

{
    "ReturnValue": 9,
     "RecList": [
        {
            "id": 624772,
            "payWay": 11,
            "payStatus": 11,
            "amount": 0,
            "auditId": 0,
            "waybillNum": "JNTLYD02000562",
            "transportNo": "JNTLYD02000562",
            "clientId": 2158,
            "type": 0,
            "model": "中俄东线陆运",
            "des": "俄罗斯",
            "weight": 22,
            "length": null,
            "width": null,
            "height": null,
            "cubic": 0,
            "pieces": 1,
            "insured": 0,
            "sysDate": "2017-07-27 11:17:31",
            "feeBase": null,
            "feeAddon": null,
            "feeCustom": null,
            "feePickup": 0,
            "feeCarry": null,
            "feeInsurance": 0,
            "feePack": 0,
            "feeSundry": 0,
            "feeCheck": 0,
            "feeRemote": 0,
            "feeExtra": 0
        },
        {
            "id": 623547,
            "payWay": 11,
            "payStatus": 11,
            "amount": 385,
            "auditId": 0,
            "waybillNum": "JNTCU0400016705YQ",
            "transportNo": "JNTCU0400016705YQ",
            "clientId": 2158,
            "type": 1,
            "model": "俄快递",
            "des": "俄罗斯",
            "weight": 18,
            "length": null,
            "width": null,
            "height": null,
            "cubic": 2,
            "pieces": 1,
            "insured": 0,
            "sysDate": "2017-07-26 17:37:30",
            "feeBase": null,
            "feeAddon": null,
            "feeCustom": null,
            "feePickup": 0,
            "feeCarry": null,
            "feeInsurance": 0,
            "feePack": 0,
            "feeSundry": 0,
            "feeCheck": 0,
            "feeRemote": 0,
            "feeExtra": 0
        }
    ],
    "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功，返回数据数量；小于0：获取失败，-1、授权失败，-2、单号不能为空，-9、系统异常并返回异常原因，11、订单不存在或费用尚未生成
RecList	List	查询出来的订单费用信息：字段说明见：订单费用字段说明

订单费用
字段说明

参数名称	类型	描述
id	Integer	出入库订单Id
payWay	Integer	付款方式:11(月结),12(现付),13(到付)
payStatus	Integer	是否已经付款 11 否，12是
amount	Float	快递费，元，2位小数
auditId	Integer	核销ID，0表示未核销
waybillNum	String	运单号
transportNo	String	转单号
clientId	Integer	客户Id
type	Integer	快件类型，0(文件),1(包裹),2(防水袋)
model	String	运输方式(快递类别)
des	String	目的地
weight	Float	重量，公斤
length	Integer	长，厘米
width	Integer	宽，厘米
height	Integer	高，厘米
cubic	Integer	体积，立方厘米
pieces	Integer	件数
insured	Integer	保价,元
sysDate	Date	业务记录系统时间
feeBase	Float	基础运费,元,2位小数
feeAddon	Float	燃油附加费,元,2位小数
feeCustom	Float	报关费,元,2位小数
feePickup	Float	提货费,元,2位小数
feeCarry	Float	送货费,元,2位小数
feeInsurance	Float	保险费,元,2位小数
feePack	Float	包装费,元,2位小数
feeSundry	Float	杂费,元,2位小数
feeCheck	Float	验货费,元,2位小数
feeRemote	Float	偏远费,元,2位小数
feeExtra	Float	其它费,元,2位小数

费用管理 --按运单号查订单费用

功能

按运单号查订单费用

HTTP请求方式

GET

请求URL

http://api.j-net.cn/fee/order/{waybillNum}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	是	仓库编码
waybillNum	String	是	运单号

请求示例

GET http://api.j-net.cn/fee/order/CU220042586TR

返回结果

{
    "ReturnValue": 163329,
    "Rec": {
        "id": 163329,
        "payWay": 11,
        "payStatus": 12,
        "amount": 0,
        "auditId": 17850,
        "waybillNum": "CU220042586TR",
        "transportNo": "CU220042586TR",
        "clientId": 2158,
        "type": 1,
        "model": "J-NET专线",
        "des": "123",
        "weight": 123,
        "length": 0,
        "width": 23,
        "height": 0,
        "cubic": 0,
        "pieces": 123,
        "insured": 0,
        "sysDate": "2016-07-15 14:18:24",
        "feeBase": null,
        "feeAddon": null,
        "feeCustom": null,
        "feePickup": 0,
        "feeCarry": null,
        "feeInsurance": 0,
        "feePack": 0,
        "feeSundry": 0,
        "feeCheck": 0,
        "feeRemote": 0,
        "feeExtra": 0
    },
    "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功，返回数据Id；小于0：获取失败，-1、授权失败，-2、单号不能为空，-9、系统异常并返回异常原因，11、订单不存在或费用尚未生成
Rec		订单费用信息：见订单费用字段说明
cMess	String	成功或者失败说明，对应ReturnValue

费用管理 --查询财务账单

功能

查询财务账单

HTTP请求方式

GET

请求URL

http://api.j-net.cn/fee?type={结算状态}&begin={开始时间}&end={结束时间}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
begin	Date	是	业务记录开始时间：格式为："yyyy-MM-dd"
end	Date	是	业务记录结束时间：格式为："yyyy-MM-dd"
type	Integer	否	记录类别：11-核收(核收之后关联的订单变为已收款状态),12-清缴(增加结算余额，一般客户充值之后会发生此状态)

请求示例

GET http://api.j-net.cn/fee?type=11&begin=2017-07-01&end=2017-07-30

返回结果

{
    "ReturnValue": 5,
    "RecList": [
        {
            "clientId": 2158,
            "payDate": "2017-07-25 13:41:42",
            "type": 0,
            "payAmount": 63,
            "refAmount": 63,
            "currency": "CNY",
            "primaryAmount": 63,
            "payWay": 0,
            "invoiceNum": "",
            "refNo": "",
            "mark": "",
            "memo": "",
            "sysDate": "2017-07-25 13:42:10",
            "orders": [
                {
                    "id": 617982,
                    "payWay": 11,
                    "payStatus": 12,
                    "amount": 63,
                    "auditId": 41327,
                    "waybillNum": "JNTCU0100229916YQ",
                    "transportNo": "JNTCU0100229916YQ",
                    "clientId": 2158,
                    "type": 1,
                    "model": "俄快通",
                    "des": "俄罗斯",
                    "weight": 1,
                    "length": null,
                    "width": null,
                    "height": null,
                    "cubic": 0,
                    "pieces": 1,
                    "insured": 0,
                    "sysDate": "2017-07-24 15:06:42",
                    "feeBase": null,
                    "feeAddon": null,
                    "feeCustom": null,
                    "feePickup": 0,
                    "feeCarry": null,
                    "feeInsurance": 0,
                    "feePack": 0,
                    "feeSundry": 0,
                    "feeCheck": 0,
                    "feeRemote": 0,
                    "feeExtra": 0
                },
                {
                    "id": 616455,
                    "payWay": 11,
                    "payStatus": 12,
                    "amount": 0,
                    "auditId": 41327,
                    "waybillNum": "JNTCU0100188822YQ",
                    "transportNo": "JNTCU0100188822YQ",
                    "clientId": 2158,
                    "type": 1,
                    "model": "俄快递",
                    "des": "俄罗斯",
                    "weight": 1,
                    "length": null,
                    "width": null,
                    "height": null,
                    "cubic": 15000000,
                    "pieces": 1,
                    "insured": 44,
                    "sysDate": "2017-07-24 14:14:05",
                    "feeBase": null,
                    "feeAddon": null,
                    "feeCustom": null,
                    "feePickup": 0,
                    "feeCarry": null,
                    "feeInsurance": 0,
                    "feePack": 0,
                    "feeSundry": 0,
                    "feeCheck": 0,
                    "feeRemote": 0,
                    "feeExtra": 0
                },
                {
                    "id": 615092,
                    "payWay": 11,
                    "payStatus": 12,
                    "amount": 0,
                    "auditId": 41327,
                    "waybillNum": "JNTLYD02000519",
                    "transportNo": "JNTLYD02000519",
                    "clientId": 2158,
                    "type": 0,
                    "model": "中俄东线陆运",
                    "des": "俄罗斯",
                    "weight": 1,
                    "length": null,
                    "width": null,
                    "height": null,
                    "cubic": 0,
                    "pieces": 1,
                    "insured": 0,
                    "sysDate": "2017-07-22 21:07:12",
                    "feeBase": null,
                    "feeAddon": null,
                    "feeCustom": null,
                    "feePickup": 0,
                    "feeCarry": null,
                    "feeInsurance": 0,
                    "feePack": 0,
                    "feeSundry": 0,
                    "feeCheck": 0,
                    "feeRemote": 0,
                    "feeExtra": 0
                }
            ]
        }
    ],
    "cMess": "获取成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0：获取成功，返回数据Id；小于0：获取失败，-1、授权失败，-2、单号不能为空，-9、系统异常并返回异常原因，11、订单不存在或费用尚未生成
RecList		充值或者消费记录信息：见财务账单字段说明
cMess	String	成功或失败说明，对应ReturnValue

财务账单
字段说明

参数名称	类型	描述
clientId	Integer	客户Id
payDate	Date	付款时间
type	Integer	记录类别：11核收(核收之后关联的订单变为已收款状态),12-清缴(增加结算余额，一般表示客户充值)
payAmount	Float	付款金额（元）
refAmount	Float	票单金额（元）
currency	String	原始币种，国际三字代码
primaryAmount	Float	原始货币金额，2位小数，当用非本币付款时记录此项
payWay	Integer	付款方式，枚举值：0：现金；1：转帐；2：网络；3：冲销；4：其它
invoiceNum	String	发票号
refNo	String	票证号/交易号
mark	String	标签
memo	String	备注
sysDate	Date	业务记录系统时间
orders	List	核收关联的订单信息：见：订单费用字段说明

消息管理 --消息订阅

功能

消息订阅：如果推送信息失败，系统总共会推送3次，5分钟后推送第2次，再过10分钟后推送第3次

HTTP请求方式

POST Content-Type:"application/json; charset=UTF-8"

请求URL

http://api.j-net.cn/subscribe

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
body(request body)	String	是	{"type":1,"url":"http://www.j-net.cn"}

body说明

参数名称	类型	是否必须	描述
type	Integer	是	1.通知 2.新问题件 4.问题件反馈组合的话直接把逻辑相加，比如3(1+2)表示通知+新问题件
url	String	是	用来接收消息的url地址，http://***；如果接收成功之后要求对方erp返回字符串"true"

请求示例

GET http://api.j-net.cn/subscribe

返回结果

{
  "ReturnValue": 0,
  "cMess": "订阅成功"
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	0：订阅成功 -1：授权失败 -2：参数错误 -9：系统异常
cMess	String	成功或失败说明：对应ReturnValue

消息管理 --消息推送

功能

消息推送：如果推送信息失败，系统总共会推送3次，5分钟后推送第2次，再过10分钟后推送第3次

HTTP响应

POST

返回结果

{
    "id": 1,
    "clientId": 2158,
    "sms": "13123232312",
    "email": "30302323@qq.com",
    "fromName": "测试name",
    "messageTitle": "测试title",
    "messageType": 1,
    "messageContent": "测试正文",
    "messageFormat": "text",
    "messageRefid": 518378,
    "messageTime": "2017-08-06 08:21:23",
    "reply": 0,
    "status": 0
}

返回说明

参数名称	类型	描述
id	Integer	主键id
clientId	Integer	客户id
sms	String	手机短信
email	String	邮箱
fromName	String	消息来源，操作人
messageTitle	String	消息标题
messageType	Integer	消息类型：1.通知 2.新问题件 4.问题件反馈
messageContent	String	消息正文
messageFormat	String	消息正文格式（html,text）
messageRefid	Integer	消息关联的内容id(如：问题件id)
messageTime	Date	消息时间
reply	Integer	0-不需要回复 1-需要回复 2-已回复
status	Integer	0-未读 1-已读 9-删除

消息管理 --更新消息状态

功能

更新消息状态：标记为是否已读或者是否已回复。如果为问题件消息，请和物流商协商后再确认是否已回复

HTTP请求方式

POST

请求URL

http://api.j-net.cn/subscribe/update

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
ids	Integer[]	是	消息Id
read	Boolean	否	是否已读
reply	Boolean	否	是否已回复

请求示例

POST http://api.j-net.cn/subscribe/update

返回结果

{
  "ReturnValue": 2,
  "cMess": ""
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0表示更新成功，小于0表示更新失败
cMess	String	成功或失败说明：对应ReturnValue

打印管理 --入库面单打印

功能

面单打印

HTTP请求方式

GET

请求URL

http://api.j-net.cn/label/depot?type=RM&encryptype=file&num=JNTLYD02000648&depot=C05&model=中俄东线陆运&cartonQty=10

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	用户ID：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
num	String	是	头程单号
depot	String	是	仓库代号
model	String	是	头程渠道
cartonQty	Integer	是	箱子数量
type	String	否	面单类型 1、RM(热敏100*100)2、A4 是A4；默认RM
encryptype	String	否	加密类型 1、file 返回pdf文件；2、base64 返回base64加密字符串;默认file

请求示例

http://api.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":"JVBERi0xLjQKJeLjz9MKMy..."}

返回说明

ReturnValue：如果获取成功：字节数组长度；如果失败：-1，授权失败； -2，参数有误；-3，运单号错误或不存在， -9 系统异常或其他错误，-11运单号为空， -13 面单类型错误，只能是RM或者A4
cMess：
如果成功：encryptype=base64时，cMess 返回 base64加密文件，否则cMess 返回pdf文件；
如果失败： -2，参数有误；-3，运单号错误或不存在等失败原因， -9 系统异常或其他错误，-11运单号为空， -13 面单类型错误，只能是RM或者A4

打印管理 --SKU条码打印

功能

SKU条码打印

HTTP请求方式

GET

请求URL

http://api.j-net.cn/label/sku?codes=JSQM0011A&encryptype={加密文件}&remark={备注信息}

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
encryptype	String	否	加密类型 1、file 返回pdf文件；2、base64 返回base64加密字符串;默认file
remark	String	否	备注信息

请求示例

http://api.j-net.cn/label/sku?codes=JSQM0011A
HttpGet get = new HttpGet(url);
get.addHeader("clientId",icid);
get.addHeader("md5",md5);

返回结果

{"ReturnValue":68382,"cMess":"JVBERi0xLjQKJeLjz9MKMy..."}

返回说明

ReturnValue：如果获取成功：字节数组长度；如果失败：-1，授权失败； -2，参数有误；-3，运单号错误或不存在
cMess：
如果成功：encryptype=base64时，cMess 返回 base64加密文件，否则cMess 返回pdf文件；
如果失败： -2、参数有误；-3、运单号错误或不存在等失败原因；-9、系统异常信息

获取运单号 --获取运单号

功能

获取运单号/头程单号

HTTP请求方式

GET

请求URL

http://api.j-net.cn/order/num

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
model	String	是	快递渠道

请求示例

GET http://api.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:如果成功返回运单号，如果不成功返回失败原因：
对应ReturnValue

获取渠道 --获取出库渠道

功能

获取渠道

HTTP请求方式

GET

请求URL

http://api.j-net.cn/model/depot

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息
depot	String	否	仓库代码

请求示例

GET http://api.j-net.cn/model/depot

返回结果

{
  "ReturnValue": 6,
  "RecList": [
    {
      "model": "俄快递",
      "areas": [
        {
          "areaCn": "俄罗斯",
          "areaEn": "Russian"
        },
        {
          "areaCn": "哈萨克斯坦",
          "areaEn": "Kazakhstan"
        },
        {
          "areaCn": "白俄罗斯",
          "areaEn": "Belarus"
        }
      ],
      "depot": "C05"
    },
    {
      "model": "俄PONY",
      "areas": [
        {
          "areaCn": "俄罗斯",
          "areaEn": "Russian Federation, The"
        }
      ],
      "depot": "C05"
    },
    {
      "model": "俄陆运",
      "areas": [
        {
          "areaCn": "俄罗斯",
          "areaEn": "Russian"
        }
      ],
      "depot": "C05"
    },
    {
      "model": "MOSEXP",
      "areas": [
        {
          "areaCn": "俄罗斯",
          "areaEn": "Russia"
        },
        {
          "areaCn": "哈萨克斯坦",
          "areaEn": "Kazakhstan"
        },
        {
          "areaCn": "白俄罗斯",
          "areaEn": "The Republic of Belarus"
        },
        {
          "areaCn": "摩尔多瓦",
          "areaEn": "Republic of Moldova"
        },
        {
          "areaCn": "乌克兰",
          "areaEn": "Ukraine"
        }
      ],
      "depot": "R01"
    },
    {
      "model": "MOSPOST",
      "areas": null,
      "depot": "R01"
    },
    {
      "model": "MOSPONY",
      "areas": [
        {
          "areaCn": "俄罗斯",
          "areaEn": "Russian Federation, The"
        }
      ],
      "depot": "R01"
    }
  ],
  "cMess": ""
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0表示成功返回查出的个数，-1 授权失败 -5 海外仓仓库代号有误 -9 系统错误或其他错误
cMess	String	失败说明对应ReturnValue
model	String	快递渠道
areaCn	String	快递渠道到达的国家中文名称
areaEn	String	快递渠道到达的国家英文名称
depot	String	仓库代码

获取渠道 --获取入库头程

功能

获取入库头程

HTTP请求方式

GET

请求URL

http://api.j-net.cn/model/depot/in

请求参数

参数名称	类型	是否必须	描述
clientId	Integer	是	客户Id：http请求头部信息
md5	String	是	md5 加密后的客户Id和密钥，比如：MD5.encrypt(客户Id + 密钥)：http请求头部信息

请求示例

GET http://api.j-net.cn/model/depot/in

返回结果

{
  "ReturnValue": 4,
  "RecList": [
    {
      "model": "中俄东线陆运"
    },
    {
      "model": "中俄西线陆运"
    },
    {
      "model": "中俄空运"
    },
    {
      "model": "中俄快路"
    }
  ],
  "cMess": ""
}

返回说明

参数名称	类型	描述
ReturnValue	Integer	大于0表示成功返回查出的个数，-1 授权失败 -5 海外仓仓库代号有误 -9 系统错误或其他错误
cMess	String	失败说明对应ReturnValue
model	String	头程渠道