海运订阅之单号上传(多票)
URL参数名称 | URL参数描述 |
---|---|
companyid | 企业编码(![]() |
formdata参数 | formdata参数描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | 订阅对象数组json | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
返回值参数 | 返回值参数释义 | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
result | 具体单号订阅结果集(数组格式) | ||||||||||||||||||||||||||||||||||||||
success | 是否成功订阅。true=订阅成功,false=订阅失败 | ||||||||||||||||||||||||||||||||||||||
message | 失败原因 | ||||||||||||||||||||||||||||||||||||||
|
API地址: http://apis.yundangnet.com/api/v1/bookingsv2?companyid=0
data=[
{
"success":true,
"result":[{
"localkeyid":"123",
"referenceno":"6135761320",
"success":true,
"message":null
}]
}
]
第一次订阅的返回数据:
{
"success":true,
"result":[{
"localkeyid":"123",
"referenceno":"6135761320",
"success":true,
"message":null
}]
}
已订阅的返回数据:
{
"success":true,
"result":[{"localkeyid":"123",
"referenceno":"6135761320",
"success":true,
"message":"该提单号+船公司+起运港的记录已存在"
}]}
参数说明: success:true=订阅API成功执行;result:具体单号订阅结果集
海运订阅之数据下载(多票)
URL参数名称 | URL参数描述 |
---|---|
companyid | 企业编码(![]() |
formdata参数 | formdata参数描述 | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | 下载对象数组json | ||||||||||||||||||||||||||||||||||||||||||||||
|
API地址: http://apis.yundangnet.com/api/v1/bookingv2-liner?companyid=0
data=[
{
"carriercd":"COSCO",
"referenceno":"6135761320",
"ctnrno":"",
"pol":"CNNGB"
}
]
参数说明:
"objlinertracking":{
"keyid":"d93983f9-b4b2-42bd-a9d1-e79f26eca9a1",...,
"objbillinfo:{"keyid":"ac385ec",...,
"lstcarriages":[{...},{...}],
"lstctnrinfos":[{...,"lstctnrstatus":[{...},{...}]}]}
"lstctnrbaseinfos":[{"keyid":"85ec",...,
"lstctnrdynamics":[{...},{...}]
"lstctnrcchistoricallink":[{...},{...}]}]
"lstlinertrackingstatus":[{...},{...}]
"objterminalop":{"keyid":"bc682et",...}
}
海运订阅之数据上传下载(单票)
URL参数名称 | URL参数描述 |
---|---|
companyid | 企业编码(![]() |
formdata参数 | formdata参数描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | 订阅对象数组json | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
API地址: http://apis.yundangnet.com/api/v1/seabooking-download?companyid=0
data=[
{
"carriercd":"COSCO",
"referenceno":"6135761320",
"ctnrno":"",
"pol":"CNNGB"
}
]
第一次订阅的返回数据:
{
"success":true,
"Success":true,
"status":1006,
"Status":1006,
"objlinertracking":null,
"message":null
"Message":null
"exceptioncode":null
}
已订阅的返回数据:
参数说明:
status:0=成功,1=失败,1005=未订阅,1000=线上还未获取到具体数据,1006=首次订阅成功;message:错误信息;exceptioncode:错误代码;
获取的json数据为嵌套结构,objlinertracking为linertracking表数据,是整理的线性订阅数据,是主表。其中objbillinfo为其从表billinfo船东提单信息表数据,lstcarriages、lstctnrinfos是billinfo的从表carriage航次表和ctnrinfo箱信息表的数据,lstctnrstatus是ctnrinfo的从表ctnrstatus箱动态表的数据。
lstctnrbaseinfos是linertracking的从表ctnrbaseinfo码头箱信息表数据,lstctnrdynamics、lstctnrcchistoricallink是ctnrbaseinfo的从表ctnrdynamics箱动态表和ctnrcchistoricallink海关报关状态表数据。
lstlinertrackingstatus是linertracking的从表linertrackingstatus线性状态表数据。
结构如下所示:
"objlinertracking":{
"keyid":"d93983f9-b4b2-42bd-a9d1-e79f26eca9a1",...,
"objbillinfo:{"keyid":"ac385ec",...,
"lstcarriages":[{...},{...}],
"lstctnrinfos":[{...,"lstctnrstatus":[{...},{...}]}]}
"lstctnrbaseinfos":[{"keyid":"85ec",...,
"lstctnrdynamics":[{...},{...}]
"lstctnrcchistoricallink":[{...},{...}]}]
"lstlinertrackingstatus":[{...},{...}]
}
空运订阅之单号上传(多票)
URL参数名称 | URL参数描述 |
---|---|
companyid | 云当企业编码(![]() |
formdata参数 | formdata参数描述 | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | 订阅对象数组json | ||||||||||||||||||||||||||||||||||||||||
|
API地址: http://apis.yundangnet.com/api/v1/airbookings?companyid=0
data=[
{
"keyid":"123",
"carriercd":"MU",
"awbno":"11240644273",
"carriercd2":"",
"awbno2":"",
"carriercd3":"",
"awbno3":"",
"type":"1"
}
]
第一次订阅的返回数据:
{
"success":true,
"result":[{
"localkeyid":"123",
"carriercd":"MU",
"awbno":"11240644273",
"carriercd2":"",
"awbno2":"",
"carriercd3":"",
"awbno3":"",
"success":true,
"message":null
}]
}
已订阅的返回数据::
{
"success":true,
"result":[{"localkeyid":"123",
"carriercd":"MU",
"awbno":"11240644273",
"carriercd2":"",
"awbno2":"",
"carriercd3":"",
"awbno3":"",
"success":true,
"message":"该运单号+航空公司的记录已经存在"
}]
}
参数说明: success:true=订阅API成功执行;result:具体单号订阅结果集
空运订阅之数据下载(多票)
URL参数名称 | URL参数描述 |
---|---|
companyid | 云当企业编码(![]() |
formdata参数 | formdata参数描述 | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | 下载对象数组json | ||||||||||||||||||||||||||||||||||||
|
data=[
{
"carriercd":"MU",
"awbno":"11240644273",
"carriercd2":"",
"awbno2":"",
"carriercd3":"",
"awbno3":""
}
]
参数说明:
0=成功,1=失败,1005=未订阅;message:错误信息;exceptioncode:错误代码;
获取的json数据为嵌套结构,objairlinertracking为airlinertracking表数据,是整理的线性订阅数据,是主表。其中lstBookingInfo为其从表bookinginfo船东提单信息表数据,lstflightinfo、lstcargostatus是bookinginfo的从表flightinfo航次表和cargostatus动态表的数据
lstairlinertrackingstatus是airlinertracking的从表airlinertrackingstatus线性状态表数据。
结构如下所示:
"objairlinertracking":{
"keyid":"d93983f9-b4b2-42bd-a9d1-e79f26eca9a1",...,
"lstBookingInfo:{"keyid":"ac385ec",...,
"lstflightinfo":[{...},{...}],
"lstcargostatus":[{...},{...}]}
"lstairlinertrackingstatus":[{...},{...}]
}
C# SDK文档
海运货物跟踪订阅:
空运货物跟踪订阅:
1.海运订阅之单号上传(多票):
//新建批量上传订阅对象数组
var shippingFilterList = new List<YDN.Tracking.Shipping.Filter>();
//增加上传对象
shippingFilterList.Add(new YDN.Tracking.Shipping.Filter
{
//订阅号(提单号或订舱号都可)
ReferenceNo = "WMHB004074",
//箱号(使用箱号订阅时必填,否则可不填)
CtnrNo = "",
//船东代码(必填,详见云当船东代码)
CarrierCd = "CMA"
});
shippingFilterList.Add(new YDN.Tracking.Shipping.Filter
{
//订阅号(提单号或订舱号都可)
ReferenceNo = "OOLU2619597710",
//箱号(使用箱号订阅时必填,否则可不填)
CtnrNo = "",
//船东代码(必填,详见云当船东代码)
CarrierCd = "OOCL"
});
//调用订阅方法,上传订阅对象
var result2 = EnterpriseService.GetInstance("云当企业代码", "云当秘钥").Shipping().Subscribe(shippingFilterList);
返回结果result2的具体结构见 YDN.Tracking.Shipping.BookingResult
2.海运订阅之数据下载(多票):
//新建多票数据下载对象数组
var shippingFilterList = new List<YDN.Tracking.Shipping.Filter>();
//增加下载对象
shippingFilterList.Add(new YDN.Tracking.Shipping.Filter
{
//订阅号(提单号或订舱号都可)
ReferenceNo = "WMHB004074",
//箱号(使用箱号订阅时必填,否则可不填)
CtnrNo = "",
//船东代码(必填,详见云当船东代码)
CarrierCd = "CMA"
});
shippingFilterList.Add(new YDN.Tracking.Shipping.Filter
{
//订阅号(提单号或订舱号都可)
ReferenceNo = "OOLU2619597710",
//箱号(使用箱号订阅时必填,否则可不填)
CtnrNo = "",
//船东代码(必填,详见云当船东代码)
CarrierCd = "OOCL"
});
//调用下载方法,下载对应单号数据
var resultList3 = EnterpriseService.GetInstance("云当企业代码", "云当秘钥").Shipping().GetData(shippingFilterList);
返回结果resultList3的具体结构见 YDN.Tracking.Shipping.BookingResults
API测试工具