OpenAPI

报关单 (查询接口)

查询报关单平台内部编号（通过客户单号或者报关单号）

请求

  • 接口路径：v1/dec?refNo={refNo}
  • 请求方法：GET
  • 成功返回状态码200
  • 只需传入客户单号或者报关单号其中一个
属性 类型 说明
refNo String 工作单号/客户单号
entryId String 报关单号

响应

响应正文：

[
	{
    		“id”:”123”,
    		“cusCiqNo”:“E20190000347566211”,
    		“entryId”:“534520201450120479”,
    		“refNo”:“1234”,
    		“createdAt”:1621835502000
    	},
    	{
    		“id”:”234”,
    		“cusCiqNo”:“E20190000357310805”,
    		“entryId”:“534520201450120479”,
            “refNo”:“1000”,
    		“createdAt”:2221835502000
    	}

]
属性 类型 说明
id String 平台内部单号
cusCiqNo String 平台统一编号
entryId String 平台报关单号
refNo String 平台工作单号
createAt long 单证在平台的创建时间（Epoch微秒）

查询报关单内容

请求

  • 接口路径：v1/dec/{id}/form
  • 请求方法：GET
  • 成功返回状态码200
属性 类型 说明
id String 平台内部单号

响应

响应正文：报关单数据结构

{
    "ieType": "EXPORT",
    "head": {},
    "freeTxt": {},
    "items": [],
    "containers": [],
    "docs": [],
    "licenses": []        
    // 详细字段请参考：报关单数据模型
}

参考：报关单数据模型

查询报关单回执

请求

  • 接口路径：v1/dec/{id}/tracking
  • 请求方法：GET
  • 成功返回状态码200
属性 类型 说明
id String 平台内部单号

响应

响应正文：

[
	{
        "code":"update",
        "note":null,
        "name":"单证数据修改",
        "remark":null,
        "props":null,
        "happendedAt":1609227101503,
        "operator":"SYSTEM",
        "channel":"INNER",
        "source":....
    },
    {
        "code":"7",
        "note":"申报成功",
        "name":"海关回执",
        "remark":"I20200000533779150,I20200000533779150直接申报成功",
        "props":[
            {
                "label":"海关编号",
                "key":"entryId",
                "value":""
            },
            {
                "label":"回执号",
                "key":"receiptNo",
                "value":null
            }
        ],
        "happendedAt":1608965363000,
        "operator":"SYSTEM",
        "channel":"singleWindow",
        "source":....
    }
]
属性 类型 说明
code String 进程编码
note String 申报审核备注
name String 进程名称
remark String 备注
props List 属性值
happendAt long 回执状态时间
operator String 操作人
channel String 来源（海关或SaaS系统操作）注：singleWindow为来源自海关，INNER为SaaS系统操作
source String base64 文件内容: 海关回执的原文

海关报文格式定义可参考单一窗口官方文件：进出口货物报关单报文格式V4.7.doc (DecImportResponse 和 DEC_RESULT部分)

查询报关单PDF打印件

请求

  • 接口路径：v1/dec/{id}/print-item/{code}
  • 请求方法：GET
  • 成功返回状态码200
属性 类型 说明
id String 平台内部单号
code String 可选择的打印项目，见下：可选打印项目

query参数

属性 类型 说明
printSource String 来源 LOCAL(默认) -> 系统生成的 SW -> 单一下载的

响应

响应正文：PDF内容(byte[])，格式为application/pdf 当printSource=SW时 返回Zip(application/zip)

可选打印项目

  • dec_main: 正本报关单
  • dec_release_pass: 放行通知书
  • export_inspection: 出口查验通知书
  • conclude_inspection：审结通知书
  • iq_ecert：检验检疫证 (只有printSource为SW时才有)

查询取样送检数据（通过报关单号）

请求

  • 接口路径：v1/dec/inspection-sampling?busiNo={busiNo}
  • 请求方法：GET
  • 成功返回状态码200

query参数

属性 类型 说明
busiNo String 报关单号

响应

响应正文：

[
    {
        "sampingNo": "xxx",
        "busiNo": "53xxx0001",
        "busiType": "进口",
        "msgType": "2",
        "msgTypeName": "取样送检进度通知",
        "gName": "样品名称",
        "rspInfo": "已完成检测",
        "deliveryTime": "2026-06-20 10:00:00",
        "recvTime": "2026-06-20 14:00:00",
        "completionTime": "2026-06-22 09:30:00",
        "indbTime": "2026-06-22 10:00:00",
        "updateTime": "2026-06-22 10:05:00"
    }
]
属性 类型 说明
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）