报关结果查询

2024-08-08 08:00

POST /v1/customs/inquiryDeclarationRequests

使用此接口查询海关申报状态。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

如果字段的数据类型为整数属性，且其值为 20，设置为 "20"。
如果字段的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

declarationRequestIds Array<String> REQUIRED

商户为识别申报请求而分配的专属 ID。支持批量查询，一次最多可支持 10 个申报请求 ID。

更多信息：

最大长度：32 字符
最多可包含元素个数：10

出参

result Result REQUIRED

请求结果，包含状态和错误代码等信息。

Show child parameters

declarationRequestsNotFound Array<String>

系统查无报关请求 ID 表。

注意：当 result.resultCode 为S且系统中找不到一个或多个报关请求 ID 时，返回此字段。

更多信息：

最大长度：32 字符
最多可包含元素个数：10

declarationRecords Array<DeclarationRecord>

海关申报记录列表。每条记录代表一次海关申报。

注意：此字段在 result.resultCode 为S时返回。

更多信息：

最多可包含元素个数：10

Show child parameters

API Explorer

示例代码沙箱运行

请求

URL

请求体

响应

Case

Success

响应体

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	接口调用成功，无需进一步操作。
ACCESS_DENIED	F	访问被拒绝。	请联系 Antom 技术支持获取详细原因。
INVALID_API	F	调用的接口无效或未激活。	请联系 Antom 技术支持解决此问题。
ARRAY_SIZE_EXCEEDED	F	一个查询请求最多支持 10 个报关请求 ID。	检查 declarationRequestID 字段中是否存在超过 10 个申报请求 ID。
CLIENT_INVALID	F	客户端 ID 无效。Antom 对客户端 ID 有限制。	检查客户端 ID 是否正确，或联系 Antom 技术支持获取详细原因。
INVALID_CONTRACT	F	合同中的参数值与当前交易不符。	检查合同中的参数值是否与当前交易匹配。如果匹配，请联系 Antom 技术支持排查问题。
INVALID_SIGNATURE	F	签名验证失败。请求签名所用的私钥与 Antom Dashboard 的公钥不匹配。	检查用于签署请求的私钥是否与 Antom Dashboard 的公钥匹配。以下签名参考信息可能有用：请求头中的签名字段如何生成签名
KEY_NOT_FOUND	F	找不到 Antom 或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在 Antom Dashboard 中上传私钥。
MEDIA_TYPE_NOT_ACCEPTABLE	F	服务器不支持客户端可接受的媒体类型。	检查媒体类型是否正确，并使用 Antom 接受的媒体类型。
MERCHANT_NOT_REGISTERED	F	商户未注册。	请使用注册接口注册商户。如果无法调用注册接口，请联系 Antom 技术支持。
METHOD_NOT_SUPPORTED	F	服务器不支持请求的 HTTP 方法。仅支持 POST 方法。	确保 HTTP 方法为`POST`。
NO_INTERFACE_DEF	F	接口未定义。	请检查链接是否正确。请参考接口文档中的端点信息。
PARAM_ILLEGAL	F	缺少必需参数，或存在非法参数。例如，非数字输入、无效日期，或参数长度和类型错误。	检查并验证当前接口所需的请求字段（包括头字段和正文字段）是否正确传递并有效。
PROCESS_FAIL	F	发生了常见的业务失败。	获取 Antom 技术支持前请勿重试。
RISK_REJECT	F	请求因风险控制被拒绝。	提示用户请求被拒绝，因为风险控制失败。
SYSTEM_ERROR	F	发生系统错误。	获取 Antom 技术支持前请勿重试。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超过限制。	再次调用接口以解决问题。如果问题仍未解决，请联系 Antom 技术支持。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	再次调用接口以解决问题。如果问题仍未解决，请联系 Antom 技术支持。

海关名称	统一海关解决方案	海关编码	Antom注册ID
海关总署	发送至ZONGSHU	ZONGSHU	31222699S7
河南保税物流中心	发送至ZHENGZHOU	ZHENGZHOU	31222699S7
宁波海关	发送至NINGBO	NINGBO	31222699S7
新郑综合保税区（机场）	先发送至HENAN，再发送至ZONGSHU	HENAN	P460400005
天津海关	发送至ZONGSHU	ZONGSHU	31222699S7
上海海关	发送至SHANGHAI_CBT	SHANGHAI_CBT	31222699S7
广州海关（机场）	发送至广州机场国检。需要企业提供备案信息。	ZONGSHU	C000010000416158
广州海关（南沙）	发送至广州南沙国检。需要企业提供备案信息。	ZONGSHU	C000010000416158
广州海关（黄埔）	发送至广州黄埔国检。需要企业提供备案信息。	ZONGSHU	C000010000416158
广州海关（沙田）	发送至广州沙田国检。需要企业提供备案信息。	ZONGSHU	C000010000416158
杭州海关	发送至ZONGSHU	ZONGSHU	ZF14021901