Versions Compared

Old Version 156

changes.mady.by.user 熊兴

Saved on

compared with

New Version Current

changes.mady.by.user 张能

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

版本

变更内容

备注

操作人

变更时间

V3.2

新增数据获取


sw

20200515

V3.3

船名，航次，提单号改为非必填字段


Stella

20200608

V3.4

货代上传人、货代邮件，货代QQ


sw

20200805

V3.5新增获取客户校验稿
sw20200824
V3.6新增文件流上传接口
sw20210118
V3.7新增Base64文件上传接口
sw20210119
V3.7.1新增查验返回JSON
sw20210223
V3.7.2

整箱做箱任务/docking/package

更新说明sw20210226
V3.1011.1

新增费用接口


Gavin20231201



推送AI数据接口

...

接口地址

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

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

请求方式post
入参（JSON）


字段

类型

描述

必填

备注

appId

String

权限令牌

Y

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

bghId

String

报关行ID

Y

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

fileUrl

String

网络下载地址

Y

http://allseeing-rar.oss-cn-shanghai.aliyuncs.com/A1908010846

5575164/1564620414.zip

海运报关业务支持：zip，rar格式；

orderOutNo

String

外部订单号

Y

业务编号

isReload

String

重传标记

Y

“2” 表示重传，其他暂无意义（暂不支持重传）

parameter

JSON

其他参数

Y


字段

类型

描述

必填

备注

sourceAppIdString来源appIdN第三方
phoneString手机号N信号旗货代平台如果存在该手机号，为默认为上传人
customerNameString客户上传人N默认为空，标记第三方上传人
hdEmailString货代邮箱N如果存在，则显示，不存在，则通过手机查询平台结果（20200805新增）

hdqq

String货代QQN如果存在，则显示，不存在，则通过手机查询平台结果（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

业务编号预留字段

customerNo

String

客户自编号

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

mergeType


String


拼箱标识


N

1=出口拼箱

2=出口整箱

3=进口拼箱

4=进口整箱

5=进口分拨

6=出口自拼箱

7=进口报关

8=出口报关

superviseMode

String

监管仓上传方式

N

JGC/9710/9810/HNCZC


Bool

是否退税

N



String

客户报关类型

N



String

入库单号

N



String

进仓单号

N




进仓件数

N


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

json

返回数据：

orderOutNo（外部流水号）

信号旗内部流水号


描述

上传成功以后，返回orderOutNo

...

接口地址

测试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
Stringbase64文件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


字段

类型

描述

必填

备注

sourceAppIdString来源appIdN第三方
phoneString手机号N信号旗货代平台如果存在该手机号，为默认为上传人
customerNameString客户上传人N默认为空，标记第三方上传人
hdEmailString货代邮箱N如果存在，则显示，不存在，则通过手机查询平台结果（20200805新增）

hdqq

String货代QQN如果存在，则显示，不存在，则通过手机查询平台结果（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=出口报关

superviseMode

String

监管仓上传方式

N

JGC/9710/9810/HNCZC

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：测试URL：http://api.t.baoguan001.com/api/docking/receiptseauploadImport

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

请求方式post
入参（json）入参（JSON）


字段

类型

描述

必填

备注

orderOutNo

appId

String

业务流水号

...

customMaster

...

String

...

申报地海关

...

entryId

...

String

...

报关单编号

...

dDate

...

申报日期

...

yyyy-MM-dd

...

cusCiqNo

...

关检关联号

...

ieDate

...

进出口日期

...

yyyy-MM-dd

...

cusRetSeqNo

...

包装种类

Image Removed

描述：红框部分为回执号

...

字段

...

类型

...

描述

...

备注

...

code

...

int

...

200=成功

...

msg

...

String

...

接口返回信息

...

data

...

json

...

返回数据

...

4.上传拼箱关系接口 (已废弃)

提运单号
接口地址

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

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

请求方式post
入参（json）

字段

类型

描述

必填

备注

outNo

String

拼箱号

Y

唯一标记

billNo

String

主提单号

N

shipName

String

船名

Y

voyage

String

航次

Y

iEPort

String

出境关别

Y

洋山：“2248”

外港：“2225”

distinatePort

String

指运港

N

containerId

String

集装箱号

Y

containerMd

String

集装箱规格

Y

packNo

String

件数

Y

grossWet

String

毛重

Y

clcList

json

拼箱订单列表

Y

clcList.orderOutNo

String

业务订单号

clcList.billNo

String

权限令牌

Y

唯一标记

dataJson

json

申报后json

详见附件1：《单一标准数据》

出参

字段

类型

描述

备注

code

int

200=成功

msg

String

接口返回信息

data

json

返回数据

描述

3.海关回执接口

...

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

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

...

字段

...

类型

...

描述

...

必填

...

备注

...

orderOutNo

...

String

...

业务流水号

...

Y

...

唯一标记

...

paramJson

...

json

...

回执json

...

Y

...

字段

...

类型

...

描述

...

必填

...

备注

...

channel

...

String

...

回执代码

...

参见《附件3：海关状态》

...

note

...

String

...

回执说明

...

noticeDate

...

String

...

通知时间

...

yyyy-MM-dd HH:mm:ss

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

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

业务编号

settlementNo

String

结算编号

N

结算编号

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

海运  / 空运  /  公路 / 铁路

receiptUserName

String

客户名称

Y

客户名称

receivingRemark

String

接单备注

N

接单备注

packNo

String

件数

N

件数

grossWet

String

毛重

N

毛重

tradeName

String

境内收发货人

N

境内收发货人

tradeNameCode

String

境内10位编码

N

境内10位编码

tradeNameDutyNo

String

境内18位编码

N

境内18位编码

expectedOrderExchangeTime

String

预计换单时间

N

预计换单时间

practicalOrderExchangeTime

String

实际换单时间

N

实际换单时间

parameter

JSON

其他参数

N


字段

类型

描述

必填

备注


















出参（Object）


字段

类型

描述

备注

code

int

200=成功


msg

String

接口返回信息


data

String

返回数据：

信号旗内部流水号


描述




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

返回数据



描述

...


3.

...

海关回执接口

入参：

必填：业务编号、船名、航次、出境关别、提单号、件数、毛重(kg)、

选填：指运港、集装箱号、集装箱规格、随附文档

接口：

bghId
接口地址调试url：http://接口地址

调试url：http://api.t.baoguan001.com/api/docking/lcl_task正式url：httpreceiptsingle

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

请求方式post
入参（DataForm）入参（json）


字段

类型

描述

必填

备注

appId

orderOutNo

String

权限令牌

业务流水号

Y

身份标记

唯一标记

fileUrl

paramJson

String

json

随附文档

回执json

N图片地址 (图片地址和订单列表必填一个，不能两者都为空)
taskId
String拼箱任务IDN新增成功后返回的ID，修改时必填

Y


字段

类型

描述

必填

备注

channel

String