核注清单 (查询接口)
查询核注清单平台内部编号(通过客户单号)
请求
- 接口路径:v1/voucher?refNo={refNo}
- 请求方法:GET
- 成功返回状态码200
| 属性 | 类型 | 说明 |
| refNo | String | 工作单号/客户单号 |
响应
响应正文:
[
{
"id": "123",
"seqNo": "202300000085475001",
"bondInvtNo": "QD535222I000874001",
"refNo": "1234",
"createdAt": 1621835502000
},
{
"id": "234",
"seqNo": "202300000085475002",
"bondInvtNo": "QD535222I000874002",
"refNo": "1000",
"createdAt": 2221835502000
}
]
| 属性 | 类型 | 说明 |
| id | String | 平台内部单号 |
| seqNo | String | 统一编号 |
| bondInvtNo | String | 清单编号 |
| refNo | String | 平台工作单号 |
| createAt | long | 单证在平台的创建时间(Epoch微秒) |
查询核注清单内容
请求
- 接口路径:v1/voucher/{id}/form
- 请求方法:GET
- 成功返回状态码200
| 属性 | 类型 | 说明 |
| id | String | 平台内部单号 |
响应
响应正文:核注清单数据结构
{
"head": {},
"goodsList": []
// 详细字段请参考:核注清单数据模型
}
参考:核注清单数据模型
查询核注清单回执
请求
- 接口路径:v1/voucher/{id}/tracking
- 请求方法:GET
- 成功返回状态码200
| 属性 | 类型 | 说明 |
| id | String | 平台内部单号 |
响应
响应正文:
[
{
"code": "ZH",
"name": "海关回执",
"remark": "终审已核扣",
"props": null,
"happendedAt": 1675323364000,
"operator": "SYSTEM",
"channel": "simulate",
"source": ....
},
{
"code": "Y",
"name": "海关回执",
"remark": "海关预审通过",
"props": [
{
"label": "预录入编号",
"key": "seqNo",
"value": "202300000085475001"
},
{
"label": "清单编号",
"key": "bondInvtNo",
"value": "QD535222I000874001"
}
],
"happendedAt": 1608965363000,
"operator": "SYSTEM",
"channel": "singleWindow",
"source": ....
}
]
| 属性 | 类型 | 说明 |
| code | String | 进程编码 |
| name | String | 进程名称 |
| remark | String | 备注 |
| props | List | 属性值 |
| happendAt | long | 回执状态时间 |
| operator | String | 操作人 |
| channel | String | 来源(海关或SaaS系统操作)注:singleWindow为来源自海关,simulate为SaaS系统操作 |
| source | String base64 | 文件内容: 海关回执的原文 |
查询报关单PDF打印件
请求
- 接口路径:v1/voucher/{id}/print-item/{code}
- 请求方法:GET
- 成功返回状态码200
| 属性 | 类型 | 说明 |
| id | String | 平台内部单号 |
| code | String | 可选择的打印项目,见下:可选打印项目 |
响应
响应正文:PDF内容(byte[]),格式为application/pdf
可选打印项目
- voucher_production: 核注清单
- voucher_production_audit: 核注清单核对单
附:数据模型
核注清单数据模型
{
"head": { // 单证表头
"listStat": "", // 清单状态 (系统自动反填。已申报、退单、改单、删单、审核通过)
"etpsInnerInvtNo": "", //企业内部编号
"dclTypecd": "", //申报类型编号 1-备案申请 2-变更申请 3-删除申请
"seqNo": "", //清单预录入统一编号
"bondInvtNo": "", //保税清单编号
"putrecNo": "", //手(账)册编号
"chgTmsCnt": "", // 修改变更次数
"bizopEtpsSccd": "", //经营企业社会信用代码
"bizopEtpsno": "", //经营企业编号
"bizopEtpsNm": "", //经营企业名称
"rvsngdEtpsSccd": "", //加工单位 收发货企业社会信用代码
"rcvgdEtpsno": "", //加工单位编码 收货企业编号
"rcvgdEtpsNm": "", // 收货企业名称
"dclEtpsSccd": "", // 申报企业社会信用代码
"dclEtpsno": "", //申报企业编号
"dclEtpsNm": "", //申报企业名称
"inputCode": "", //录入企业编号
"inputCreditCode": "", //录入企业社会信用代码
"inputName": "", //录入单位名称
"inputTime": 1675390631000, //录入日期
"invtDclTime": 1675390631000, //清单申报时间
"entryDclTime": 1675390631000, //报关单申报日期
"entryNo": "", //对应报关单编号
"corrEntryDclEtpsSccd": "", //对应报关单申报单位社会统一信用代码
"corrEntryDclEtpsNo": "", //对应报关单申报单位编码
"corrEntryDclEtpsNm": "", // 对应报关单申报单位名称
"rltInvtNo": "", //关联清单编号
"rltPutrecNo": "", // 关联备案编号(关联手(账)册备案号)
"rltEntryNo": "", //关联报关单编号
"rltEntryBizopEtpssccd": "", //关联报关单境内收发货人社会信用代码
"rltEntryBizopEtpsno": "", //关联报关单境内收发货人编码
"rltEntryBizopEtpsNm": "", //关联报关单境内收发货人名称
"rltEntryRvsngdEtpsSccd": "", //关联报关单生产销售(消费使用)社会信用代码
"rltEntryRcvgdEtpsno": "", //关联报关单生产销售(消费使用)单位编码
"rltEntryRcvgdEtpsNm": "", //关联报关单生产销售(消费使用)单位名称
"rltEntryDclEtpsSccd": "", //关联报关单申报单位社会统一信用代码
"rltEntryDclEtpsNm": "", //关联报关单申报单位名称
"rltEntryDclEtpsno": "", //关联报关单海关申报单位编码
"applyNo": "", //申报表编号
"impexpPortcd": "", //进出境关别
"dclPlcCuscd": "", //申报地关区代码
"impexpMarkcd": "", //进出口标记代码(I:进口,E:出口)
"mtpckEndprdMarkcd": "", //料件成品标记代码(I:料件,E:成品)
"dclcusFlag": "", //是否报关标志(1.报关2.非报关)
"genDecFlag": "", //是否系统生成报关单 (1-生成, 2-不生成)
"dclcusTypecd": "", //报关类型代码(1.关联报关2.对应报关)
"decType": "", //报关单类型
"entryStucd": "", //报关状态(0:未放行,1:已放行)
"supvModecd": "", //监管方式代码
"trspModecd": "", //运输方式代码
"listType": "", //流转类型
"vrfdedMarkcd": "", //核扣标记代码(系统自动反填。0-未核扣 1-预核扣 2-已核扣 3-已核销)
"stshipTrsarvNatcd": "", //启运/运抵国(地区)
"invtType": "", //清单类型
"prevdTime": 1675390631000, //预核扣时间
"formalVrfdedTime": 1675390631000, //正式核扣时间
"invtIochkptStucd": "", //清单进出卡口状态代码
"icCardNo": "", //申报人IC卡号
"passportUsedTypecd": "", //核放单生成标志代码
"rmk": "", //备注
"decRmk": "", //报关单草稿
"sysId": "", //95---加工贸易账册系统 B1---加工贸易手册系统 Z7---海关特殊监管区域管理系统 Z8---保税物流管理系统
"ediSendTime": 1675390631000, //发送单一窗口时间
"ediSendStatus": true, //发单一窗口状态
"holdFlag": true, //发送暂存状态
"delcareFlag": true, //发送申报状态
"swResponseInfo": "", //单一窗口回执信息
"noticeDate": 1675390631000, //回执通知时间
"inputTimeString": "",
"invtDclTimeString": "",
"entryDclTimeString": ""
},
"goodsList": [ // 表体
{
"seqNo": null, //中心统一编号
"gdsSeqno": 1, // 商品序号
"impGdsSeqno": null, //入区商品序号
"impBondInvtNo": null, //入区清单编号
"putrecSeqno": "23020201", // 备案序号-工厂 关备案序号-仓库
"gdsMtno": "ZL0202001", //商品料号
"gdecd": "9503006000", // 商品编码
"gdsNm": "益智玩具", // 商品名称
"gdsSpcfModelDesc": "3|1|玩耍|塑胶玩偶类", // 商品规格型号
"dclUnitcd": "007", // 申报计量单位
"lawfUnitcd": "006", // 法定计量单位
"secdLawfUnitcd": "035", // 法定第二计量单位
"natcd": "142", // 原产国(地区)
"dclUprcAmt": 1, // 企业申报单价
"dclTotalAmt": 100, // 企业申报总价
"usdStatTotalAmt": null, // 美元统计总金额
"dclCurrcd": "142", // 币制
"lawfQty": null, // 法定数量
"secdLawfQty": null, // 第二法定数量
"wtSfVal": null, // 重量比例因子
"fstSfVal": null, // 第一比例因子
"secdSfVal": null, // 第二比例因子
"dclQty": 100, // 申报数量
"grossWt": null, // 毛重
"netWt": null, // 净重
"useCd": null, // 用途代码
"lvyrlfModecd": "3", // 征免方式
"ucnsVerno": null, // 单耗版本号
"entryGdsSeqno": null, // 报关单商品序号
"applyTbSeqno": null, // 流转申报表序号
"clyMarkcd": null, // 归类标志 危化品标志
"destinationNatcd": "142", // 最终目的国
"modfMarkcd": null, // 修改标志
"rmk": null, // 备注
"props": null // 拓展字段
}
]
}