...
四.
...
报关行与信号旗对接 (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 | 身份标记 | | orderOutNo | String | 业务编号 | Y | 订单的身份 | | msg | String | | | | 字段 | 类型 | 描述 | 必填 | |
|---|
shipName | String | 船名 | N | | voyage | String | 航次 | N | | billNo | String | 提单号 | N | | packNo | String | 件数 | N | | grossWet | String | 毛重 | N | | | decContainersJsonArray | JsonArray | 集装箱 | N | | 字段 | 类型 | 描述 | 必填 | 备注 |
|---|
| String | containerId | 集装箱号 | Y | | | String | containerMd | 箱规格 | Y | 必须为以下值：20GP，40GP ，40HQ，45GP，45HQ | | String | containerWt | 箱自重 | N | | String | containerMdCode
| 箱规格代码 | N | | | String | containerSid | 箱封号 | N | | | int | lclFlag | 拼箱标识 | Y | 0:非拼箱； 1:拼箱 | | String | goodsNo | 商品项号关系 | N | 格式：1,2,3 |
|
|
|
| 出参 | 字段 | 类型 | 描述 | 备注 |
|---|
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 |
| 请求方式 | post |
| 入参（DataForm） | 字段 | 类型 | 描述 | 必填 | 备注 |
|---|
appId | String | 权限令牌 | Y | 身份标记 | msg | String | 消息内容 | Y | 《消息体》 | | sessionType | String | 会话类型 | Y | 默认是：20 | messageType | String | 消息类型 | Y | 《消息类型》 | | orderOutNo | String | 业务编号 | 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.同步单证状态
| 接口地址 | 在信号旗中配置回调接口，接口地址回调方提供。 |
| 请求方式 | post |
| 入参（json） | 字段 | 类型 | 必填 | 描述 |
|---|
action | String | Y | syn_status (同步状态) | orderOutNo | String | Y | 业务流水号 | code | int | Y | 参见《附件4：信号旗订单状态》 | msg | String | Y | |
|
| 出参 | 字段 | 类型 | 必填 | 描述 |
|---|
state | boolean | Y | 成功：true 失败：false | msg | String | 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 | single_receipt(海关回执) | orderOutNo | String | N | 业务流水号 | billNo | String | N | 提运单号 | paramJson | json | Y | 回执json 字段 | 类型 | 必填 | 描述 |
|---|
channel | String | | 参见《附件3：海关状态》 | note | String | | 海关描述 | noticeDate | String | | 海关时间 | customMaster | String | | 主管海关 | entryId | String | | 海关编码 | cusCiqNo | String | | 统一编号 | releaseNotice | String | N | 放行通知书文件地址 | customsDeclaration | String | N | 报关单文件地址 | examinePdf | String | N | 查验通知书(口岸查验通知、报关单查验通知......) |
|
|
| 出参 | 字段 | 类型 | 必填 | 描述 |
|---|
state | boolean | Y | 成功：true 失败：false | msg | String | N | |
|
| 描述 | |
4.电子底账日期推送
| 接口地址 | 在信号旗中配置回调接口，接口地址回调方提供。 |
| 请求方式 | post |
| 入参（json） | 字段 | 类型 | 必填 | 描述 |
|---|
action | String | Y | electronic_ledger | orderNo | String | Y | 信号旗流水号 | orderOutNo | String | Y | 业务流水号 | billNo | String | N | 提运单号 | hdCoId | String | N | | dataJson | json | Y | 回执json 字段 | 类型 | 必填 | 描述 |
|---|
qcPassId | String | Y | 电子底账编号 | validDate | String | Y | 电子底账有效结束时间 | signDate | String | Y | 电子底账有效开始时间 | declareNo | String | Y | 报关ID |
|
|
| 出参 | 字段 | 类型 | 必填 | 描述 |
|---|
state | boolean | Y | 成功：true 失败：false | msg | String | N | |
|
| 描述 | |
附件
附件1：导入单一标准数据格式
文件
http://single-xml.oss-cn-shanghai.aliyuncs.com/doc/doc/datajson.json
...
