Versions Compared

Old Version 171

changes.mady.by.user 张能

Saved on

compared with

New Version 172

changes.mady.by.user Stella

Saved on

Key

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

...

接口地址

在信号旗中配置回调接口，接口地址回调方提供。

请求方式post
入参（json）


字段

类型

必填

描述

action

String

Y

msg_notice(订单消息通知)

orderOutNo

String

Y

业务流水号

code

int

N

消息状态码

msg

String

Y

 通知消息


出参


字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N



描述

待确认###

5.

...

推送进口保税数据接口核注清单

接口地址
在信号旗中配置回调接口，接口地址回调方提供。

在货代配置回调接口，接口地址回调方提供。

请求方式post
入参（json）


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








BussinessData
StringusedStringextraTypeStringwarningIndexStringtopInteger当前字段位置：纵向坐标顶部距离bottomInteger当前字段位置：纵向坐标底部距离leftInteger当前字段位置：横向坐标左侧距离rightInteger当前字段位置：横向坐标右侧距离heightInteger当前文件高度（px）widthInteger当前文件:宽度 (px)conceptIdIntegerdutyNoStringimgSrcString图片或文件地址sourceFlagStringconceptStrString

TableList 对象

出参
JsonY
T/F（T：成功，F：失败）messageStringY返回信息data字段类型必填描叙

declarationPort

Attribute

申报地海关

IEPort

Attribute

出境关别

manualNo

Attribute

备案号

contrNo

Attribute

合同协议号

IEDate

Attribute

出口日期

declareDate

Attribute

申报日期

tradeName

Attribute

境内收发货人

overseasConsignor

Attribute

境外收发货人

ownerName

Attribute

生产销售单位

agentName

Attribute

申报单位

billNo

Attribute

提运单号

trafName

Attribute

运输工具名称

voyageNo

Attribute

航次号

trafModeName

Attribute

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

supervisor

Attribute

监管方式

cutMode

Attribute

征免性质

licenseNo

Attribute

许可证号

originalCountry

Attribute

运抵国地

distinatePort

Attribute

指运港

transMode

Attribute

成交方式

feeMark

Attribute

运费/率  描述

feeCurr

Attribute

运费/率 价格

feeRate

Attribute

运费/率 币值单位

insurMark

Attribute

保费/率 描述

insurCurr

Attribute

保费/率 价格

insurRate

Attribute

保费/率 币值单位

otherMark

Attribute

杂费/率

packNo

Attribute

件数

wrapType

Attribute

包装种类

grossWet

Attribute

毛重(Kg)

netWt

Attribute

净重(Kg)

tradeArea

Attribute

贸易国别

goodsPlace

Attribute

货物存放地

entyPort

Attribute

离境口岸

entryType

Attribute

报关单类型: 有纸报关,无纸带清单报关,有纸带清单报关,通关无纸化,无纸报关

noteS

Attribute

备注

markNo

Attribute

标记唛码

firstConfirm

Attribute

特殊关系确认

secondConfirm

Attribute

价格影响确认

thirdConfirm

Attribute

使用费支付确认

domesticConsigneeEname

Attribute

境内发货人英文

otherRate

Attribute

杂费金额

otherCurr

Attribute

杂费币制

invoiceAmount

Attribute

发票总价

packingNetWeightAmount

Attribute

装箱单总净重

overseasConsignee

Attribute

海外收货人

districtName

Attribute

境内货源地

docImageSrc

Array

解析图片集合

PRE_DECLARATION：预录单

INVOICE：发票

PACKING_LIST：装箱单

CONTRACT：销售合同

DECLARATION_ELEMENTS：产品说明&申报要素

ENTRUST_LETTER_OF_INSPECTION：报关委托书

CUSTOMS_POWER_OF_ATTORNEY：代理报关委托书

OTHER：其他

docPdfSrc

Array

解析pdf集合（分类同上）

picArgsList

Array

tableList

Array

商品数组

字段类型必填描叙

contrlItem

Attribute

备案序号

codeTS

Attribute

商品编号

gName

Attribute

商品名称

gModel

Attribute

规格型号

gQty

Attribute

成交数量

gUnit

Attribute

成交单位

declPrice

Attribute

单价

declTotal

Attribute

总价

tradeCurr

Attribute

币制

firstQty

Attribute

法定数量

firstUnit

Attribute

法定单位

versionNo

Attribute

版本号

productNo

Attribute

货号

destinationCountry

Attribute

最终目的国

secondQty

Attribute

第二数量

secondUnit

Attribute

第二单位

originCountry

Attribute

原产国

districtName

Attribute

境内货源地

destName

Attribute

产地

dutyMode

Attribute

征免方式

gNoAttribute

项号

unCode
Attribute
UN编号
dangPackType
Attribute
包装类别
dangName
Attribute
危险类别
dangPackSpec
Attribute
包装UN标记
noDangFlag
Attribute
非危险货物
goodsAttrName
Attribute
货物属性

Attribute 对象：

字段类型必填描叙codeString当前字段值[code](*位数)编码valueString当前字段值内容totalInteger当前字段总数flagString比对标记（0：提取来源为预录单，发票，箱单上，三者数据比对一致；1：比对不一致；2：仅从预录单提取到，并未从其他分类单据中提取到，那么视作单一来源）currencyStringdocTypeStringdutyNoString当前字段值社会信用代码rowsList

当前字段的坐标

字段类型必填描叙codeStringvalueStringcolorFlagStringflagStringcellNameStringdocTypeString值：INVOICE ｜  PRE_DECLARATION ｜ CONTRACT ｜PACKING_LIST ｜DECLARATION_ELEMENTS

https://single-xml-dev.oss-cn-shanghai.aliyuncs.com/doc/doc/%E6%8E%A8%E9%80%81%E8%BF%9B%E5%8F%A3%E4%BF%9D%E7%A8%8E%E6%A0%B8%E6%B3%A8%E6%B8%85%E5%8D%95%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3.pdf



https://single-xml-dev.oss-cn-shanghai.aliyuncs.com/doc/doc/%E6%A0%B8%E6%B3%A8%E6%B8%85%E5%8D%95%E6%95%B0%E6%8D%AE.json


出参



描述

待确认###

6.推送订单费用接口

接口地址

信号旗中配置回调接口地址，接口地址回调方提供（注意：该地址只能提供一个，具体业务根据action字段区分）。

请求方式post
入参（json）


字段

类型

必填

描述

action

String

Y

order_fee(订单费用)

orderOutNo

String

Y

业务流水号

billNo

String

N

提运单号

feeId

int

Y

费⽤id，标识唯⼀费⽤

feeOpt

String

Y

操作：1--新增；2--修改；3--删除

feeName

String

Y

费⽤名称；

feeType

int

Y

收付：1--应收；2--应付

feeAcctType

int

Y

费⽤类型：1--普通费⽤；2--代收代付

feeAmount

decimal

Y

费用金额

feeCurrency

String

Y

币制

goodsNumber

Integer

N

商品项数

orderOperator

String

Y

货代联系人（订单操作人）

feeRemark

String

N

备注


出参


字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N



描述


7.进口流程节点推送数据接口

接口地址

在后台配置外部地址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



描述


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

接口地址

在后台配置外部地址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
height250


三、数据获取（XHQ << ERP）

1.获取海关回执数据（所有的历史状态记录）

       描述：如果对方服务在重启或者长时间未获取到，可以通过该接口来查询数据；数据有效期90天；

接口地址

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

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

请求方式post
入参（json）


字段

类型

必填

描述

action

String

Y

single_receipt(海关回执)

appId

String

Y


orderOutNo

String

Y

业务流水号


出参


字段

类型

必填

描述

code

int

200=成功


orderOutNo

String

Y

外部流水号

msg

String

N


data




data.rows

String

根据action查询返回相应的数据集合

返回字符串，如果是明文，字符串里面是一个集合；


描述


2.获取检验稿

       描述：通过外部流水号+appId，获取校验稿url

接口地址

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

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

请求方式post
入参（json）


字段

类型

必填

描述

appId

String

Y（二选一）

货代appId

tokenString报关行token

orderOutNo

String

Y（二选一）

业务流水号

billNo

customerNo

String

String

 提运单号

客户自编号


出参


字段

类型

必填

描述

code

int

200=成功


msg

String

Y

说明

data





示例

Image Added

3. 获取报关单

接口地址

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

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

请求方式post
入参（json）


字段

类型

必填

描述

appId

String

Y


orderOutNo

String

Y

业务流水号


出参


字段

类型

必填

描述

code

int

200=成功


msg

String

Y

说明

data





描述

Image Added



4. 获取放行通知书

接口地址

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

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

请求方式post
入参（json）


字段

类型

必填

描述

state

appId

boolean

String

Y

成功：true


orderOutNo

失败：false

String

msg

Y

String

业务流水号

N


出参
描述


字段

...

类型

接口地址

必填

在货代配置回调接口，接口地址回调方提供。

描述

请求方式

code

post

int

入参（json）字段类型必填描叙orderNo

200=成功


msg

String

Y

系统流水号

说明

orderOutNo

data

String





描述
Y

Image Added

业务编号

5. 获取查验通知书

BussinessDataJsonYhttps
接口地址

调试url：http://

single-xml-dev.oss-cn-shanghai.aliyuncs

api.t.baoguan001.com/

doc

api/

doc

docking/

%E6%8E%A8%E9%80%81%E8%BF%9B%E5%8F%A3%E4%BF%9D%E7%A8%8E%E6%A0%B8%E6%B3%A8%E6%B8%85%E5%8D%95%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3.pdfhttps

getCheckRows

正式url：http://

single-xml-dev.oss-cn-shanghai.aliyuncs

api.platform.codeflagai.com/

doc

api/

doc

docking/

%E6%A0%B8%E6%B3%A8%E6%B8%85%E5%8D%95%E6%95%B0%E6%8D%AE.json

getCheckRows

出参
请求方式
描述
post
待确认###
入参（json）

7.推送订单费用接口

billNoStringN提运单号feeIdfeeOpt备注
接口地址

信号旗中配置回调接口地址，接口地址回调方提供（注意：该地址只能提供一个，具体业务根据action字段区分）。

请求方式post
入参（json）


字段

字段

类型

必填

描述

actionappId

String

Yorder_fee(订单费用)


typeStringNcheck ：标识区分查验描述

orderOutNo

String

Y

业务流水号


出参


字段

类型

必填

描述

code

int

Y

费⽤id，标识唯⼀费⽤

200=成功


msg

String

Y

操作：1--新增；2--修改；3--删除

feeName

String

Y

费⽤名称；

feeType

int

Y

收付：1--应收；2--应付

feeAcctType

int

Y

费⽤类型：1--普通费⽤；2--代收代付

feeAmount

decimal

Y

费用金额

feeCurrency

String

Y

币制

goodsNumber

Integer

N

商品项数

orderOperator

String

Y

货代联系人（订单操作人）

feeRemark

String

N

说明

data

List

多个下载地址

根据type 类型返回，不传type 返回值结构版本1，check返回值结构版本2


描述
版本1
Image Added
版本2
Image Added


6. 获取报关委托书

接口地址

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

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

请求方式post
入参（json）


字段

类型

必填

描述

appId

String

Y


orderOutNo

String

Y

业务流水号


出参


字段

类型

必填

描述

statecode

boolean

Y

成功：true

失败：falseint

200=成功


msg

String

NY

描述

8.进口流程节点推送数据接口

...

接口地址

...

在后台配置外部地址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
height250

...

1.获取海关回执数据（所有的历史状态记录）

       描述：如果对方服务在重启或者长时间未获取到，可以通过该接口来查询数据；数据有效期90天；

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

说明

data

String




描述

Image Added



四. 客户系统与信号旗对接 (ERP->报关行)

1. 整箱做箱任务

接口地址

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

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

请求方式post
入参（DataForm）


字段

类型

描述

必填

备注

appId

String

权限令牌

Y

身份标记

orderOutNoString业务编号Y订单的身份
msgString


字段类型描述必填
shipName
String船名N
voyage
String航次N
billNo
String提单号N
packNo
String
件数N
grossWet
String
毛重N
decContainersJsonArrayJsonArray集装箱N


字段类型描述必填备注
String
containerId
集装箱号Y
String
containerMd
箱规格Y必须为以下值：20GP，40GP ，40HQ，45GP，45HQ
String
containerWt
箱自重N
String
containerMdCode
箱规格代码N
String
containerSid
箱封号N
intlclFlag拼箱标识Y0:非拼箱； 1:拼箱
StringgoodsNo商品项号关系N格式：1,2,3




出参


字段

类型

描述

备注

code

int

200=成功


msg

String

接口返回信息


data

Object




描述

做箱任务由货代端ERP发起，通过信号旗IM，传递给报关行；

报关行客户，确定做箱数据后，回填到系统中（这时数据才真正的生效）


2.获取推送消息

接口地址

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

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

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


Y

字段

类型

描述

必填

描述

action

String

Y

single_receipt(海关回执)

appId

String

备注

appId

String

权限令牌

Y

身份标记

msg

String

消息内容

Y

《消息体》

sessionTypeString会话类型Y

默认是：20

messageType
String
消息类型Y《消息类型》
orderOutNoString业务编号Y业务流水号订单的身份


出参


字段

类型

必填描述描述

备注

code

int

200=成功

orderOutNo

String

Y

外部流水号


msg

String

N接口返回信息


datadata.rows

ObjectString




描述根据action查询返回相应的数据集合

示例：

返回字符串，如果是明文，字符串里面是一个集合；
入参
描述
出参

2.获取检验稿

       描述：通过外部流水号+appId，获取校验稿url

...

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

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

...

字段

类型

必填

描述

appId

String

Y（二选一）

货代appId

tokenString报关行token

orderOutNo

String

Y（二选一）

业务流水号

billNo

customerNo

String

String

 提运单号

客户自编号

...

字段

...

类型

...

必填

...

描述

...

code

...

int

...

200=成功

...

msg

...

String

...

Y

...

说明

...

data

...

Image Removed

3. 获取报关单

...

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

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

...

字段

...

类型

...

必填

...

描述

...

appId

...

String

...

Y

...

orderOutNo

...

String

...

Y

...

业务流水号

...

字段

...

类型

...

必填

...

描述

...

code

...

int

...

200=成功

...

msg

...

String

...

Y

...

说明

...

data

...

Image Removed

...

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

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

...

字段

...

类型

...

必填

...

描述

...

appId

...

String

...

Y

...

orderOutNo

...

String

...

Y

...

业务流水号

...

字段

...

类型

...

必填

...

描述

...

code

...

int

...

200=成功

...

msg

...

String

...

Y

...

说明

...

data

...

Image Removed

5. 获取查验通知书

...

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

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

...

字段

...

类型

...

必填

...

描述

...

appId

...

String

...

Y

...

orderOutNo

...

String

...

Y

...

业务流水号

...

字段

...

类型

...

必填

...

描述

...

code

...

int

...

200=成功

...

msg

...

String

...

Y

...

说明

...

data

...

List

...

多个下载地址

...

根据type 类型返回，不传type 返回值结构版本1，check返回值结构版本2

...

版本1
Image Removed
版本2
Image Removed

6. 获取报关委托书

...

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

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

...

字段

...

类型

...

必填

...

描述

...

appId

...

String

...

Y

...

orderOutNo

...

String

...

Y

...

业务流水号

...

字段

...

类型

...

必填

...

描述

...

code

...

int

...

200=成功

...

msg

...

String

...

Y

...

说明

...

data

...

String

...

Image Removed

四. 客户系统与信号旗对接 (ERP->报关行)

1. 整箱做箱任务

...

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

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

...

字段

...

类型

...

描述

...

必填

...

备注

...

appId

...

String

...

权限令牌

...

Y

...

身份标记

...

shipName

...

voyage

...

billNo

...

packNo

...

String

...

grossWet

...

String

...

containerId

...

containerMd

...

containerWt

...

containerMdCode

...

containerSid

...

字段

...

类型

...

描述

...

备注

...

code

...

int

...

200=成功

...

msg

...

String

...

接口返回信息

...

data

...

Object

...

做箱任务由货代端ERP发起，通过信号旗IM，传递给报关行；

报关行客户，确定做箱数据后，回填到系统中（这时数据才真正的生效）

2.获取推送消息

...

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

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

...

字段

类型

描述

必填

备注

appId

String

权限令牌

Y

身份标记

msg

String

消息内容

Y

《消息体》

sessionTypeString会话类型Y

默认是：20

messageType
String
消息类型Y《消息类型》
orderOutNoString业务编号Y订单的身份

...

字段

...

类型

...

描述

...

备注

...

code

...

int

...

200=成功

...

msg

...

String

...

接口返回信息

...

data

...

Object

...

示例：

入参出参
{
    "appId":"<身份标记>",
    "msg":"[{"containerId":"<集装箱号>","containerMd":"<箱规格>","containerWt":"<箱自重>","containerMdCode":"<箱规格代码>","containerSid":"<箱封号>","lclFlag":<拼箱标识>,"goodsNo":"<商品项号关系>"}]",
    "sessionType":"20",
    "messageType":"1706",
    "orderOutNo":"<订单的身份>"
}		{
    "code":200,
    "msg":null,
    "data":true
}

ERP发送消息给报关行。直接发送到报关的想要的聊天记录中，并提供消息即使提醒

五. 信号旗推送消息给对接方 (信号旗->对接方)

在后台配置回调接口地址,需求对方提供;

1.同步单证状态

...

在信号旗中配置回调接口，接口地址回调方提供。

...

字段

...

类型

...

必填

...

描述

...

action

...

String

...

Y

...

syn_status (同步状态)

...

orderOutNo

...

String

...

Y

...

业务流水号

...

code

...

int

...

Y

...

参见《附件4：信号旗订单状态》

...

msg

...

String

...

Y

...

字段

...

类型

...

必填

...

描述

...

state

...

boolean

...

Y

...

成功：true

失败：false

...

msg

...

String

...

N

...

2.推送数据接口

...

在信号旗中配置回调接口，接口地址回调方提供。

...

字段

类型

必填

描述

action

String

Y

send_data (制单完成数据)

sendBgh_data (报关行发送数据)

single_data (单一放行数据)

orderOutNo

String

Y

业务流水号

dataJson

json

N

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

...

字段

...

类型

...

必填

...

描述

...

state

...

boolean

...

Y

...

成功：true

失败：false

...

msg

...

String

...

N

...

{
    "appId":"<身份标记>",
    "msg":"[{"containerId":"<集装箱号>","containerMd":"<箱规格>","containerWt":"<箱自重>","containerMdCode":"<箱规格代码>","containerSid":"<箱封号>","lclFlag":<拼箱标识>,"goodsNo":"<商品项号关系>"}]",
    "sessionType":"20",
    "messageType":"1706",
    "orderOutNo":"<订单的身份>"
}		{
    "code":200,
    "msg":null,
    "data":true
}


ERP发送消息给报关行。直接发送到报关的想要的聊天记录中，并提供消息即使提醒


五. 信号旗推送消息给对接方 (信号旗->对接方)

在后台配置回调接口地址,需求对方提供;

1.同步单证状态

channelString参见《附件3：海关状态》note查验通知书(口岸查验通知、报关单查验通知......)
接口地址

在信号旗中配置回调接口，接口地址回调方提供。

请求方式post
入参（json）


字段

类型

必填

描述

action

String

Y

singlesyn_receiptstatus (海关回执同步状态)

orderOutNo

String

NY

业务流水号

billNocode

Stringint

NY提运单号

参见《附件4：信号旗订单状态》

paramJsonmsg

jsonString

Y回执json



出参


字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

海关描述

noticeDate

String

海关时间

customMaster

String

主管海关

entryId

String

海关编码

cusCiqNo
String统一编号

releaseNotice

String

N

放行通知书文件地址

customsDeclaration

String

N

报关单文件地址

examinePdf
StringN

N



描述


2.推送数据接口

接口地址

在信号旗中配置回调接口，接口地址回调方提供。

请求方式post
入参（json）


字段

类型

必填

描述

action

String

Y

send_data (制单完成数据)

sendBgh_data (报关行发送数据)

single_data (单一放行数据)

orderOutNo

String

Y

业务流水号

dataJson

json

N

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


出参


字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N



描述

...


3.

...

海关回执接口

接口地址

在信号旗中配置回调接口，接口地址回调方提供。

请求方式post
入参（json）


信号旗流水号

字段

类型

必填

描述

action

String

Y

electronic_ledger

orderNo
StringY

single_receipt(海关回执)

orderOutNo

String

YN

业务流水号

billNo

String

N

提运单号

hdCoId
StringN
dataJson

paramJson

json

Y

回执json

报关ID

字段

类型

必填

描述

qcPassId
StringY电子底账编号
validDate
StringY电子底账有效结束时间
signDate
StringY电子底账有效开始时间
declareNo
StringY

channel

String


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

note

String


海关描述

noticeDate

String


海关时间

customMaster

String


主管海关

entryId

String


海关编码

cusCiqNo
String
统一编号

releaseNotice

String

N

放行通知书文件地址

customsDeclaration

String

N

报关单文件地址

examinePdf
StringN查验通知书(口岸查验通知、报关单查验通知......)



出参


字段

类型

必填

描述

state

boolean

Y

成功：true

失败：false

msg

String

N



描述


...

接口地址

调试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"
    }
}




七. 合作方最终数据回推信号旗


接口地址

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

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


附件

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

...