天津港电子商务网向用户提供数据交互服务,数据接口标准如下:
一、获取认证token
概述:“获取认证token服务”,平台提供的接口服务都需要进行认证,获取有效的token值,调用接口时使用获取到的token值传入相应接口,才能调用相应的接口服务
调用接口前需要进行服务认证,需要平台提供有效的用户名、密码,密钥以及请求服务名称,以此来调用获取权限的认证服务;认证返回的token有一定时效,过期后需要重新获取token.
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
username //用户名, password //密码 |
{ "success" //成功标志 "msg" //token } |
二、海关集装箱预配舱单
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, billno //提单号 |
{ "TRANSPORT_ID //船舶IMO号 "VESSEL_NAME_EN" //英文船名 "VESSEL_VOYAGE" //航次 "BILL_NO" //提单号 "CNTR_NO" //集装箱号 "GROSS_WEIGHT" //集装箱重量 "PACKAGE_NO" //件数 "I_E_FLAG" //进出口 "SEAL" //铅封号 "DTINSERTTIME" //时间 } |
三、海关集装箱申报信息
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, billno //提单号 |
{ "VESSEL_NAME_EN" //英文船名 "VESSEL_VOYAGE" //航次 "BILL_NO" //提单号 "CNTR_NO" //集装箱号 "DOC_NO" //报关单号 "DTINSERTTIME" //时间 } |
四、海关集装箱运抵信息
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, cntrno //集装箱号 |
{ " TRANSPORT_ID " //船舶IMO号 "VESSEL_NAME_EN" //英文船名 "VESSEL_VOYAGE" //航次 "CNTR_NO" //集装箱号 "I_E_FLAG" //进出口 "UNLOAD_CODE " //运抵 "UNLOAD_DATE " //时间 "ISO" //箱型 "SEAL" //铅封号 "BILL_NO" //提单号 "CUSTOM_CODE" //关区号 "DTINSERTTIME" //时间 } |
五、海关集装箱放行信息
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, cntrno //集装箱号 billno //提单号 |
{ "TRANSPORT_ID " //船舶IMO号 "VESSEL_NAME_EN" //英文船名 "VESSEL_VOYAGE" //航次 "BILL_NO" //提单号 "CNTR_NO" //集装箱号 "PACKAGE_NO" //件数 "GROSS_WEIGHT" //箱重 "VALID_FLAG" //有效标志 "CUSTOMS_CODE" //关区号 } |
六、码头进出门信息
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, cntrno //集装箱号 billno //提单号 |
{ "VESSEL_NAME_EN" //英文船名 "VESSEL_NAME_CN" //中文船名 "VESSEL_VOYAGE" //航次 "MOVE_KIND" //装卸动作 "BILL_NO" //提单号 "CNTR_NO" //集装箱号 "ISO" //箱型 "EF_CODE" //空重标志 "BUSINESS_TYPE" //业务类型 "GATE_OPERATE" //闸口操作 "GATE_OPERATE_TIME" //闸口操作时间 "TERMINAL_CODE" //码头 "GATE_NO" //闸口通道号 "TRUCK_NO" //拖车号 "CNTR_OPERATOR" //营运人 "CNTR_GROSS_WEIGHT" // 箱毛重 } |
七、码头装卸船信息
请求方式 | 传入参数: | 返回结果: |
---|---|---|
POST |
token, cntrno //集装箱号 billno //提单号 |
{ "VESSEL_NAME_EN" //英文船名 "VESSEL_NAME_CN" //中文船名 "VESSEL_VOYAGE" //航次 "MOVE_KIND" //航次 "BILL_NO" //提单号 "CNTR_NO" //集装箱号 "ISO": //箱型 "EF_CODE" //空重标志 "I_E_ID" //进出口 "CNTR_OPERATOR" //持箱人 "BAY" //贝位 "CNTR_GROSS_WEIGHT" // 箱重 "WORK_TIME" //作业时间 "ACTUAL_ARRIVAL_DATE" //靠港时间 "ACTUAL_DEPARTURE_DATE" //离港时间 "FACILITY_ID" //码头 } |