报关单 (回调接口)
有关回调接口的基本要求和封装格式，请看基本要求文档。
DEC_DATA
场景：当平台报关单往单一窗口暂存时推送
可配置项：无
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| refNo | String | 工作单号/客户单号 |
| docId | String | 平台内部编号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| source | String base64 | 发送到单一窗口的报关单内容，格式为海关报关单报文格式 |
海关报文格式定义可参考单一窗口官方文件：进出口货物报关单报文格式V4.7.doc (DecMessage部分)
DEC_SOURCE
场景：平台报关单状态改变时推送
可配置项：无
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| refNo | String | 工作单号/客户单号 |
| docId | String | 平台内部编号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| source | String base64 | 报关单数据JSON格式（以 base64 编码），发送到单一窗口的报关单内容，格式为海关报关单报文格式 |
海关报文格式定义可参考单一窗口官方文件：进出口货物报关单报文格式V4.7.doc (DecMessage部分)
DEC_STATE
场景：平台报关单状态改变时推送
可配置项：需要回调的状态范围
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| refNo | String | 工作单号/客户单号 |
| docId | String | 平台内部编号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| state | String | 平台报关单状态 |
目前支持的状态:
INVALIDATED: 已作废DELETED: 已删除CREATED: 已创建
DEC_SUB_DATA
场景：当平台接收到单一窗口的订阅回执后，创建的报关单内容。若订阅的回执不涉及新创建报关单，则不会作此回调。
可配置项：
- 报关单报文过滤器 (对报关单报文进行预处理: 具体接收的值请联系客户经理)
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| refNo | String | 工作单号/客户单号 |
| docId | String | 平台内部编号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| source | String base64 | 报关单数据JSON格式（以 base64 编码），参考报关单数据模型 |
DEC_RECEIPT
场景：当单一窗口返回回执时推送
可配置项：要发送的单证状态
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| timestamp | long | 回执状态时间 epoch毫秒单位 |
| status | String | 回执状态编码 |
| refNo | String | 工作单号/客户单号 |
| docId | String | 平台内部单号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| source | String base64 | 回执内容，格式为海关标准回执XML格式 |
| mock | boolean | 是否为SaaS系统模拟回执XML |
海关报文格式定义可参考单一窗口官方文件：进出口货物报关单报文格式V4.7.doc (DecImportResponse 和 DEC_RESULT部分)
状态对应的编码:
| 编码 | 状态 |
|---|---|
| 0 | 暂存成功 |
| 1 | 暂存失败 |
| 2 | 取样送检进度通知 |
| 3 | 拟证出证 |
| 7 | 申报成功 |
| Y | 申报失败 |
| L | 海关已接收 |
| E | 海关退单 |
| J | 通关无纸化审结 |
| W | 海关无纸验放通知（审结） |
| G | 报关单已审结 |
| C | 报关单查验 |
| I | 海关无纸放行通知（放行） |
| P | 已放行 |
| B | 担保放行 |
| K | 同意担保放行 |
| D | 海关退单或删单 |
| A | 删单 |
| S | 施检 |
| H | 海关挂起，需手工申报 |
| d | 检务受理 |
| b | 已发检验检疫审核 |
| a | 检务收单 |
| c | 检验检疫撤单 |
| M | 报关单重审 |
| N | 重传文件 |
| T | 需交税费 |
| X | 海关准予进港回执（上海洋山保税港区专用） |
| Z | 退回修改 |
| R | 已结关 |
| F | 提交失败 |
DEC_PDF
场景：报关单相关PDF的推送
可配置项：
- 需要返回的打印件
- dec_main: 正本报关单
- dec_audit: 报关单复核单
- dec_audit_c: 报关单复核单C版
- dec_release_pass: 放行通知书
- export_inspection: 查验通知书
- conclude_inspection: 审结通知书
- dec-loading-list: 装船单
- dec_entrust: 委托协议
- packing-list: 装箱单
- invoice: 发票
- contract: 合同
- iq_ecert: 检验检疫证
- 要发送的单证状态
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| refNo | String | 工作单号/客户单号 |
| docId | String | SaaS系统内部编号 |
| entryId | String | 正式报关单号（若有） |
| cusCiqNo | String | 统一编号（若有） |
| printCode | String | 打印件标识（dec_main/dec_release_pass/export_inspection/conclude_inspection） |
| source | String base64 | PDF内容 |
DEC_TAXATION
场景：平台完成报关单税费数据抓取后，按税种维度推送。每个税种（进口关税、进口增值税及其它税种）各推送一条，互相独立。
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| docId | String | 平台内部编号（报关单ID） |
| entryId | String | 正式报关单号 |
| billNo | String | 提运单号 |
| contrNo | String | 合同号 |
| customMaster | String | 申报关区 |
| declDt | Date | 申报日期 |
| taxType | String | 税种编码，详见下方税种编码表 |
| taxName | String | 税种名称 |
| taxNo | String | 税费单号 |
| genDate | Date | 税单生成时间 |
| limitDate | Date | 缴款期限 |
| seqNo | String | 税费ID |
| transStatus | String | 支付状态 |
| payType | String | 支付方式 |
| payPlat | String | 支付平台，SW00000 表示单一窗口，空表示其他平台 |
| paybkCode | String | 支付银行code |
| paybkName | String | 支付银行 |
| createUser | String | 支付操作员帐号 |
| taxDate | Date | 银行扣款时间 |
| extendField1 | String | 汇总征税标志：COLLPAY 表示汇总纳税，SELFDECLARE 表示上海自贸区自主报税，否则为空 |
| amt | BigDecimal | 税费金额 |
| items | Array | 当前税种对应的税费表体数据 |
| file | String base64 | 核对单PDF |
| layoutFile | String base64 | 缴款书版式PDF |
税种编码
| 编码 | 税种 |
|---|---|
| A | 进口关税 |
| B | 112项关税 |
| C | 出口关税 |
| D | 进口农产税 |
| E | 特定关税 |
| F | 112对台税 |
| G | 直接对台 |
| H | 特定增值税 |
| I | 反倾销税 |
| J | 反补贴税 |
| K | 船舶吨税 |
| L | 进口增值税 |
| M | 海关罚没收入 / 海关缉私罚没收入 / 缉毒罚没收入 / 走私罚没收入 / 其它罚没收入 |
| N | 关税缓息 |
| O | 进口废弃电器电子产品处理基金 |
| P | 消费税缓息 |
| Q | 增值税缓息 |
| R | 全额退关税 |
| S | 监管手续费 |
| U | 滞报金 |
| V | 滞纳金 |
| W | 行李物品 |
| X | 邮递物品 |
| Y | 进口消费税 |
| Z | 关务费 |
items 表体格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| goodsNo | Integer | 报关单序号 |
| codeTs | String | 商品编码 |
| goodsName | String | 商品名称 |
| goodsQty | BigDecimal | 成交数量 |
| goodsUnitName | String | 成交单位 |
| dutyModeName | String | 征免规定 |
| tradeCurr | String | 成交币制 |
| dutyValue | BigDecimal | 完税价格 |
| exchangeRate | BigDecimal | 外汇折算率 |
| rate | BigDecimal | 从价税率 |
| qtyRate | BigDecimal | 从量税率 |
| rateType | String | 税率计征标准 |
| amt | BigDecimal | 税费金额 |
| issueDate | Date | 填发日期 |
说明：PDF字段在未抓取到对应文件时不返回。
DEC_INSPECTION_SAMPLING
场景：平台完成取样送检数据抓取并保存后推送。一次抓取所涉及的整批取样送检数据合并为一次回调发送。
可配置项：无
Payload格式：
| 属性 | 类型 | 说明 |
|---|---|---|
| items | Array | 本批次取样送检明细列表，元素格式见下方取样送检明细 |
取样送检明细
| 属性 | 类型 | 说明 |
|---|---|---|
| sampingNo | String | 报检单号 |
| busiNo | String | 报关单号 |
| busiType | String | 业务类型 |
| msgType | String | 消息类型代码 |
| msgTypeName | String | 消息类型名称（当前状态） |
| gName | String | 商品名称（首项样品） |
| rspInfo | String | 回执信息 |
| deliveryTime | String | 现场送检时间（格式 yyyy-MM-dd HH:mm:ss） |
| recvTime | String | 实验室收样时间（格式 yyyy-MM-dd HH:mm:ss） |
| completionTime | String | 实验室完成检测时间（格式 yyyy-MM-dd HH:mm:ss） |
| indbTime | String | 入库时间（格式 yyyy-MM-dd HH:mm:ss） |
| updateTime | String | 数据源更新时间（格式 yyyy-MM-dd HH:mm:ss） |