Page History

...

版本	变更内容	备注	操作人	变更时间
V3.2	新增数据获取		sw	20200515
V3.3	船名，航次，提单号改为非必填字段		Stella	20200608
V3.4	货代上传人、货代邮件，货代QQ		sw	20200805
V3.5	新增获取客户校验稿		sw	20200824
V3.6	新增文件流上传接口		sw	20210118
V3.7	新增Base64文件上传接口		sw	20210119
V3.7.1	新增查验返回JSON		sw	20210223
V3.7.2	整箱做箱任务/docking/package	更新说明	sw	20210226
V3.11.1	新增费用接口		Gavin	20231201

进口文件上传接口

推送AI数据接口

appId 获取方式：开放平台对接参数（appId、回调地址、相关推送）

...

接口地址

测试URL：http://api.t.baoguan001.com/api/docking/fileBase64Upload

正式URL：http://api.platform.codeflagai.com/api/docking/fileBase64Upload

请求方式

post

入参（JSON）

字段

类型

描述

必填

备注

appId

String

权限令牌

Y

身份标记(分为测试环境与线上环境)

bghId

String

报关行ID

Y

通过接口获取（6 通过货代appId获取报关行列表）

fileName

String

文件名称

Y

海运报关业务支持：zip，rar，pdf等

base64File

String

base64文件

Y

Base64.getEncoder().encodeToString(Paths.get(filePath))

orderOutNo

String

外部订单号

Y

业务编号

isReload

String

重传标记

Y

“2” 表示重传，其他暂无意义

~~declareTime~~

~~String~~

~~要求报关日期~~

Y

~~yyyy-MM-dd HH：mm：ss (大于当前时间1小时)~~ 已更新至parameter参数中

~~trafModeName~~

~~String~~

~~运输方式~~

N

~~2：水路运输；3：铁路运输；4：公路运输；5：航空运输；默认为2~~ 已更新至parameter参数中

parameter

JSON

其他参数

Y

字段

类型

描述

必填

备注

sourceAppId

String

来源appId

N

第三方

phone

String

手机号

N

信号旗货代平台如果存在该手机号，为默认为上传人

customerName

String

客户上传人

N

默认为空，标记第三方上传人

hdEmail

String

货代邮箱

N

如果存在，则显示，不存在，则通过手机查询平台结果（20200805新增）

hdqq

String

货代QQ

N

如果存在，则显示，不存在，则通过手机查询平台结果（20200805新增）

declarationPort

String

申报口岸

N

海关编码

IEPort

String

出境关别

N

洋山：“2248”

外港：“2225”

entyPort

String

离境口岸

N

海关编码

trafName

String

船名

N

voyageNo

String

航次

N

billNo

String

提运单号

N

packNo

String

件数

N

grossWet

String

毛重

N

tradeArea

String

贸易国

N

海关编码

originalCountry

String

运抵国

N

海关编码

distinatePort

String

指运港

N

海关编码

trafModeName

String

运输方式

N

2：水路运输；3：铁路运输；4：公路运输；5：航空运输；默认为2

declareNo

String

报关ID

N

业务编号预留字段

volume

String

体积

N

receiptUserName

String

客户名称

N

页面显示

noticeBgh

boolean

等通知报关

N

true=是（等通知报关） false=否（直接可报关）接口上传默认false

paperType

boolean

有纸报关/通关无纸化

N

true=是 false=否接口上传默认false

linkage

String

多式联运

N

twoPortLinkage=两港联动

dushanPort=独山港

Other=其他内支河

hdUserName

String

货代联系人

N

页面显示

containerNo

String

集箱号

N

hdRemark

String

货代备注

N

source

String

来源

N

用于页面显示

manuscriptCheck

boolean

校验单标识

N

true=是 false=否是否需要进行预录单校验

needSecondCheck

boolean

二审标识

N

true=是 false=否接口上传默认false

priorityGrade

boolean

优先审核标识

N

true=是 false=否接口上传默认false

importantCheck

boolean

重点审核标识

N

true=是 false=否接口上传默认false

orderCommissionCheck

boolean

电子委托标记

N

true=是 false=否报关委托书为电子委托或非电子委托

declareTime

String

要求报关日期

Y

yyyy-MM-dd HH:mm:ss (大于当前时间1小时)

mergeType

String

拼箱标识

N

1=出口拼箱

2=出口整箱

3=进口拼箱

4=进口整箱

5=进口分拨

6=出口自拼箱

7=进口报关

8=出口报关

decContainersJsonArray

List

集装箱箱号

N

格式：

字段名称	类型	描述	格式	说明
containerMd	json	规格	code，value	value必须为以下值：20GP，40GP ，40HQ，45GP，45HQ； code对应value：20GP为21，40GP为11，40HQ为11，45GP为11，45HQ为11； code 21 对应 value 20GP 11对应40GP 11对应40HQ 11对应45GP 11对应45HQ
goodsNo	json	商品项号关系	code，value	value必须为“1,2,3”格式，数字对应报关单商品项号，用英文逗号隔开； code传空字符串
containerId	json	集装箱号	code，value	value为集装箱号； code传空字符串
lclFlag	json	拼箱标志	code，value	value必须为以下值：是，否；（是表示拼箱，否表示整箱） code对应value：是为1，否为0；
containerWt	json	自重	code，value	value为集装箱自重； code传空字符串

示例：

[{

"containerMd":{"code":"","value":""},

"goodsNo":{"code":"","value":""},

"containerId":{"code":"","value":""},

"lclFlag":{"code":"","value":""},

"containerWt":{"code":"","value":""}

}]

出参（Object）

字段	类型	描述	备注
code	int	200=成功
msg	String	接口返回信息
data	String	返回数据	信号旗内部流水号

1.3进口文件上传接口

接口地址

测试URL：http://api.t.baoguan001.com/api/docking/uploadImport

正式URL：http://api.platform.codeflagai.com/api/docking/uploadImport

请求方式

post

入参（JSON）

字段	类型	描述	必填	备注
appId	String	权限令牌	Y	身份标记(分为测试环境与线上环境)
bghId	String	报关行ID	Y	报关行ID
fileUrl	String	网络下载地址	Y	http://allseeing-rar.oss-cn-shanghai.aliyuncs.com/A1908010846 5575164/1564620414.zip 海运报关业务支持：zip，rar格式；
orderOutNo	String	外部订单号	Y	业务编号
isReload	String	重传标记	Y	“2” 表示重传，其他暂无意义（暂不支持重传）
customerNo	String	客户自编号	N	客户自编号
receivingRemark	String	接单备注	N	接单备注
isNotice	Bool	是否等通知报关	N	是否等通知报关
trafName	String	船名	N	船名
voyageNo	String	航次	N	航次
billNo	String	提运单号	N	提运单号
trafModeName	String	运输方式	N	2：水路运输；3：铁路运输；4：公路运输；5：航空运输；默认为2
expectedOrderExchangeTime	String	预计换单时间	N	预计换单时间
practicalOrderExchangeTime	String	实际换单时间	N	实际换单时间
parameter	JSON	其他参数

Y

N

字段	类型	描述	必填	备注

出参（Object）

字段	类型	描述	备注
code	int	200=成功
msg	String	接口返回信息
data	json	返回数据：	信号旗内部流水号

描述

2.单一放行数据接口

接口地址

调试url：http://api.t.baoguan001.com/api/docking/receiptsea

正式url：http://api.platform.codeflagai.com/api/docking/receiptsea

请求方式

post

入参（json）

字段	类型	描述	必填	备注
orderOutNo	String	业务流水号	Y	唯一标记
dataJson	json	申报后json		详见附件1：《单一标准数据》

出参

字段	类型	描述	备注
code	int	200=成功
msg	String	接口返回信息
data	json	返回数据

描述

...

接口地址

在后台配置外部地址url，接口地址外部提供。

请求方式

Post

参数（json）

action	String	Y	node_data_I(进口流程节点)
orderOutNo	String	N	业务流水号
orderNo	String	Y	系统流水号
StatusCode	String	Y	操作code; 30=进口接单，31=进口锁单，32=进口发单
StatusName	String	Y	操作名
StatusDate	String	Y	操作日志
StatusBy	String	Y	操作人
CustomerName	String	Y	客户名称

出参

字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N

描述

9.进口合作方数据对接推送数据接口

接口地址

在后台配置外部地址url，接口地址外部提供。

请求方式

Post

参数（json）

action	String	Y	send_data_I (报关行发送数据) single_data_I (海关放行数据)
orderOutNo	String	N	业务流水号
orderNo	String	Y	系统流水号
billNo	String	Y	提运单号
dataJson	JSON	Y	报关单数据参考下面文档

出参

字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N

描述

View file

name	合作方详细数据推送数据说明240422.docx
height	250

...

Page tree

Versions Compared

Old Version 169

New Version 170

Key

进口文件上传接口

1.3进口文件上传接口

2.单一放行数据接口

9.进口合作方数据对接推送数据接口