Versions Compared

Old Version 133

changes.mady.by.user 熊兴

Saved on

compared with

New Version 134

changes.mady.by.user 熊兴

Saved on

Key

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

...

接口地址

测试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

jsonJSON

其他参数

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

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

json

返回数据：

orderOutNo（外部流水号）

信号旗内部流水号


描述

上传成功以后，返回orderOutNo

...

接口地址

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

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

请求方式post
入参（JSON）


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

字段

类型

描述

必填

备注

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” 表示重传，其他暂无意义

hdUserName

String

货代联系人

N

页面显示

hdRemarkString货代备注N
hdEmailString货代邮箱N如果存在，则显示，不存在，则通过手机查询平台结果

hdqq

String货代QQN如果存在，则显示，不存在，则通过手机查询平台结果

declareTime

String

要求报关日期

Y

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

trafModeName

String

运输方式

N

declareTime

String

要求报关日期

Y

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

trafModeName

String

运输方式

N

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

parameter

JSON

其他参数

N


字段

类型

描述

必填

备注

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

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":""}

}]

Image Added



出参（Object）


字段

类型

描述

备注

code

int

200=成功


msg

String

接口返回信息


data

json

返回数据

信号旗内部流水号


...

接口地址

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

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

请求方式post
入参（JSON）


字段

类型

描述

必填

备注

bghId

String

报关行id

Y

身份标记

type

String

类型（报关行：“BGH”）

Y


cutoffTime
String截止时间（例："2022-06-07 16:33:28"）

N



出参


字段

类型

必填

描述

code

int

Y

200=成功

msg

String

Y

接口返回信息

data

List

Y


字段类型必填描述
orderNoStringY系统流水号
orderOutNoStringY业务编号

见下面示例


描述

示例：

入参出参

{
    "type":"BGH",
    "bghId":"D6A8E64D399546CD9B60E1982B61A699",
    "cutoffTime":"2022-06-07 16:33:28"
}

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "orderNo": "A22060714485160455",
            "orderOutNo": "2022060702"
        },
        {
            "orderNo": "A22060714485586949",
            "orderOutNo": "2022060706"
        }
    ],
    "foot": {
        "operationTime": "2022-06-07 19:39:08"
    }
}



2. 系统流水号查询失败记录

接口地址

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

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

请求方式post
入参（JSON）


字段

类型

描述

必填

备注

bghId

String

报关行id

Y

身份标记

type

String

类型（报关行：“BGH”）

Y


orderNo

String系统流水号

Y


cutoffTime
String截止时间（例："2022-06-07 16:33:28"）

N

带上截止时间可以确保查询和确认清理的数据一致


出参


字段

类型

必填

描述

code

int

Y

200=成功

msg

String

Y

接口返回信息

data

List

Y


字段类型必填描述
orderNoStringY系统流水号
actionStringY推送类型
orderOutNoStringY业务编号
paramJsonStringY推送内容
requestBodyStringY客户返回消息
createTimeStringY推送时间

见下面示例


描述

示例：

入参出参

{
    "type":"BGH",
    "bghId":"D6A8E64D399546CD9B60E1982B61A699",
    "orderNo":"A22060714485160455",
    "cutoffTime":"2022-06-07 22:18:28"
}

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "orderNo": "A22060714485160455",
            "action": "sendMakeInvo_data",
            "orderOutNo": "2022060702",
            "paramJson": "{\"containerNo\":\"\",\"orderNo\":\"A22060714485160455\",\"orderOutNo\":\"2022060702\",\"action\":\"sendMakeInvo_data\",\"hdCoId\":\"153\",\"billNo\":\"SHISI\"}",
            "requestBody": "",
            "createTime": "2022-06-07 17:17:29"
        },
        {
            "orderNo": "A22060714485160455",
            "action": "sendMakeInvo_data",
            "orderOutNo": "2022060702",
            "paramJson": "{\"containerNo\":\"\",\"orderNo\":\"A22060714485160455\",\"orderOutNo\":\"2022060702\",\"action\":\"sendMakeInvo_data\",\"hdCoId\":\"153\",\"billNo\":\"\"}",
            "requestBody": "",
            "createTime": "2022-06-07 17:20:55"
        }
    ],
    "page": null,
    "foot": {
        "operationTime": "2022-06-08 09:56:16"
    }
}



3. 批量系统流水号查询失败记录

接口地址

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

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

请求方式post
入参（JSON）


字段

类型

描述

必填

备注

bghId

String

报关行id

Y

身份标记

type

String

类型（报关行：“BGH”）

Y


orderNos

List<String>系统流水号

Y

如果数量太多，请多次查询，每次最好不超过100个
cutoffTime
String截止时间（例："2022-06-07 16:33:28"）

N

带上截止时间可以确保查询和确认清理的数据一致


出参


字段

类型

必填

描述

code

int

Y

200=成功

msg

String

Y

接口返回信息

data

List

Y


字段类型必填描述
orderNoStringY系统流水号
actionStringY推送类型
orderOutNoStringY业务编号
paramJsonStringY推送内容
requestBodyStringY客户返回消息
createTimeStringY推送时间

见下面示例


描述

示例：

入参出参

{
    "type":"BGH",
    "bghId":"D6A8E64D399546CD9B60E1982B61A699",
    "orderNos":["A22060714485160455","A22060714485586949"],
    "cutoffTime":"2022-06-07 22:18:28"
}

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "orderNo": "A22060714485160455",
            "action": "sendMakeInvo_data",
            "orderOutNo": "2022060702",
            "paramJson": "{\"containerNo\":\"\",\"orderNo\":\"A22060714485160455\",\"orderOutNo\":\"2022060702\",\"action\":\"sendMakeInvo_data\",\"hdCoId\":\"153\",\"billNo\":\"SHISI\"}",
            "requestBody": "",
            "createTime": "2022-06-07 17:17:29"
        },
        {
            "orderNo": "A22060714485160455",
            "action": "sendMakeInvo_data",
            "orderOutNo": "2022060702",
            "paramJson": "{\"containerNo\":\"\",\"orderNo\":\"A22060714485160455\",\"orderOutNo\":\"2022060702\",\"action\":\"sendMakeInvo_data\",\"hdCoId\":\"153\",\"billNo\":\"\"}",
            "requestBody": "",
            "createTime": "2022-06-07 17:20:55"
        }
    ],
    "page": null,
    "foot": {
        "operationTime": "2022-06-08 09:56:16"
    }
}



4. 推送失败清单确认（清理）

接口地址

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

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

请求方式post
入参（JSON）


字段

类型

描述

必填

备注

bghId

String

报关行id

Y

身份标记

type

String

类型（报关行：“BGH”）

Y


orderNosList<String>系统流水号

Y


cutoffTime
String截止时间（例："2022-06-07 16:33:28"）

N

带上截止时间可以确保查询和确认清理的数据一致


出参


字段

类型

描述

备注

code

int

200=成功


msg

String

接口返回信息


data

int

更新数量



描述

示例：

入参出参

{
    "type":"BGH",
    "bghId":"D6A8E64D399546CD9B60E1982B61A699",
    "orderNos":["A22060714485586949","A22051713521716668"],
    "cutoffTime":"2022-06-07 14:49:50"
}

{
    "code": 200,
    "msg": "成功",
    "data": 1,
    "foot": {
        "operationTime": "2022-06-07 19:33:28"
    }
}




附件

附件1：导入单一标准数据格式declareDate

...