/basicOpen/customs/search{
"operation": {
"method": "POST",
"path": "/basicOpen/customs/search"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/customs/search?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\"offset\":0,\"length\":20,\"destinationCountry\":[],\"referenceType\":\"\",\"productionSalesUnit\":[],\"searchType\":1,\"searchValue\":\"\",\"moreFilters\":{\"creatorUserIds\":[],\"modifierUserIds\":[],\"authIds\":[]}}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-09-28 12:00:00",
"data": {
"offset": 0,
"length": 20,
"total": 1,
"pages": 1,
"list": [
{
"declarationId": "2103664996716814337",
"declarationNo": "CD20260926002",
"temporaryStorageInfo": null,
"orderDeclareInfo": null,
"producerSalesUnit": "206227556164849806",
"producerSalesUnitName": "示例公司",
"shipperInfo": {
"shipperId": "206227556164849806",
"shipperName": "示例公司",
"socialCreditCode": null,
"customsCode": null,
"shipperElectronicSealPicture": null,
"shipperAddress": null,
"shipperPhone": null,
"shipperFax": null
},
"consigneeInfo": {
"consigneeId": "206187086975594609",
"consigneeName": "示例收货人",
"receiverElectronicSealPicture": null,
"consigneeAddress": null,
"consigneePhone": null,
"consigneeFax": null
},
"accountName": "",
"supervisionMode": "9810",
"authId": null,
"orderDeclarationStatus": "PENDING",
"temporaryStorageStatus": "PENDING",
"destinationCountry": "美国",
"referenceType": 1,
"referenceNos": [
"SP260922004"
],
"shipmentNo": [
"FBA19QP58DJ7"
],
"orderNo": "FBA19QP58DJ7",
"platform": "Amazon",
"freight": "0",
"totalPackages": 2,
"totalNetWeight": "0",
"totalGrossWeight": "6",
"declaredAmount": "480",
"currency": "CNY",
"createdBy": "示例用户",
"createdTime": "2026-09-26 09:56:34",
"lastModifiedBy": "示例用户",
"lastModifiedTime": "2026-09-26 09:56:34",
"remark": ""
}
]
},
"total": 1
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 分页起始偏移量 | integer | — | Required | 分页起始偏移量,从 0 开始。 |
| 2 | length | 每页条数 | integer | — | Required | 每页条数,默认 20,最多 200。 |
| 3 | destinationCountry | 运抵国列表 | array<any> | — | Optional | 运抵国列表,命中任意一项。 |
| 4 | referenceType | 关联单据类型 | integer | — | Optional | 关联单据类型:1 发货单;2 备货单。 |
| 5 | productionSalesUnit | 生产销售单位 ID 列表 | array<any> | — | Optional | 生产销售单位 ID 列表,命中任意一项。 |
| 6 | supervisionMode | 监管方式 | string | — | Optional | 监管方式,精确匹配,例如 9810、9710。 |
| 7 | orderDeclarationStatus | 订单申报状态 | string | — | Optional | 订单申报状态:PENDING 待申报;DECLARING 申报中;SUCCESS 申报成功;FAILED 申报失败。 |
| 8 | temporaryStorageStatus | 暂存单一状态 | string | — | Optional | 暂存单一状态:PENDING 待暂存;SAVING 暂存中;SUCCESS 暂存成功;FAILED 暂存失败。 |
| 9 | createStartTime | 创建时间起点(含) | string | — | Optional | 创建时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 10 | createEndTime | 创建时间终点(含) | string | — | Optional | 创建时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 11 | updateStartTime | 最近修改时间起点(含) | string | — | Optional | 最近修改时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 12 | updateEndTime | 最近修改时间终点(含) | string | — | Optional | 最近修改时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 13 | timeType | 时间筛选类型 | integer | — | Optional | 时间筛选类型:1 创建时间;2 最后修改时间;3 出口日期。 |
| 14 | timeStartDate | 按 timeType 筛选的开始日期(含) | string | — | Optional | 按 timeType 筛选的开始日期(含),格式 yyyy-MM-dd。 |
| 15 | timeEndDate | 按 timeType 筛选的结束日期(含) | string | — | Optional | 按 timeType 筛选的结束日期(含),格式 yyyy-MM-dd。 |
| 16 | searchType | 搜索类型 | integer | — | Optional | 搜索类型:1 报关资料编号;2 关联单号;3 货件号;4 合同协议号;5 内部备注。 |
| 17 | searchValue | 单个关键字 | string | — | Optional | 单个关键字,按 searchType 模糊匹配;searchValues 有有效值时忽略。 |
| 18 | searchValues | 批量精确关键字 | array<any> | — | Optional | 批量精确关键字,需配合 searchType;命中任意一项;非空时忽略 searchValue。 |
| 19 | productSearchField | 商品搜索字段 | integer | — | Optional | 商品搜索字段:1 商品名称;2 商品编码。 |
| 20 | productSearchValue | 单个商品关键字 | string | — | Optional | 单个商品关键字,按 productSearchField 模糊匹配;productSearchValues 有有效值时忽略。 |
| 21 | productSearchValues | 批量精确商品关键字 | array<any> | — | Optional | 批量精确商品关键字,需配合 productSearchField;命中任意一项;非空时忽略 productSearchValue。 |
| 22 | moreFilters | 更多筛选条件 | object | — | Optional | 更多筛选条件。 |
| 22.1 | creatorUserIds | 创建人用户 ID 列表 | array<any> | — | Optional | 创建人用户 ID 列表,命中任意一项。 |
| 22.2 | modifierUserIds | 修改人用户 ID 列表 | array<any> | — | Optional | 修改人用户 ID 列表,命中任意一项。 |
| 22.3 | authIds | 报关账号 ID 列表 | array<any> | — | Optional | 报关账号 ID 列表,命中任意一项。 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-09-28 12:00:00 | Required | 响应时间 |
| 6 | data | 分页响应数据 | object | — | Required | 分页响应数据 |
| 6.1 | offset | 本次请求的起始偏移量 | integer | 0 | Required | 本次请求的起始偏移量。 |
| 6.2 | length | 本次请求的每页条数 | integer | 20 | Required | 本次请求的每页条数。 |
| 6.3 | total | 匹配的总记录数 | integer | — | Required | 匹配的总记录数。 |
| 6.4 | pages | 总页数 | integer | — | Required | 总页数。 |
| 6.5 | list | 当前页报关资料 | array<object> | — | Required | 当前页报关资料。 |
| 6.5.1 | declarationId | 报关资料 ID | string | — | Required | 报关资料 ID,后端序列化为字符串。 |
| 6.5.2 | declarationNo | 报关资料编号 | string | — | Required | 报关资料编号。 |
| 6.5.3 | temporaryStorageInfo | 暂存单一错误信息 | object | — | Required | 暂存单一错误信息。 |
| 6.5.4 | orderDeclareInfo | 订单申报信息或错误信息 | object | — | Required | 订单申报信息或错误信息。 |
| 6.5.5 | producerSalesUnit | 生产销售单位 ID | string | — | Required | 生产销售单位 ID,后端序列化为字符串。 |
| 6.5.6 | producerSalesUnitName | 生产销售单位名称 | string | — | Required | 生产销售单位名称。 |
| 6.5.7 | shipperInfo | 境内发货人信息 | object | — | Required | 境内发货人信息。 |
| 6.5.7.1 | shipperId | 境内发货人 ID | string | — | Required | 境内发货人 ID,后端序列化为字符串。 |
| 6.5.7.2 | shipperName | 境内发货人名称 | string | — | Required | 境内发货人名称。 |
| 6.5.7.3 | socialCreditCode | 社会信用代码 | string | — | Required | 社会信用代码 |
| 6.5.7.4 | customsCode | 海关编码 | string | — | Required | 海关编码 |
| 6.5.7.5 | shipperElectronicSealPicture | 境内发货人电子签章 | string | — | Required | 境内发货人电子签章 |
| 6.5.7.6 | shipperAddress | 境内发货人地址 | string | — | Required | 境内发货人地址 |
| 6.5.7.7 | shipperPhone | 境内发货人电话 | string | — | Required | 境内发货人电话 |
| 6.5.7.8 | shipperFax | 境内发货人传真 | string | — | Required | 境内发货人传真 |
| 6.5.8 | consigneeInfo | 境外收货人信息 | object | — | Required | 境外收货人信息。 |
| 6.5.8.1 | consigneeId | 境外收货人 ID | string | — | Required | 境外收货人 ID,后端序列化为字符串。 |
| 6.5.8.2 | consigneeName | 境外收货人名称 | string | — | Required | 境外收货人名称。 |
| 6.5.8.3 | receiverElectronicSealPicture | 境外收货人电子签章 | string | — | Required | 境外收货人电子签章 |
| 6.5.8.4 | consigneeAddress | 境外收货人地址 | string | — | Required | 境外收货人地址 |
| 6.5.8.5 | consigneePhone | 境外收货人电话 | string | — | Required | 境外收货人电话 |
| 6.5.8.6 | consigneeFax | 境外收货人传真 | string | — | Required | 境外收货人传真 |
| 6.5.9 | accountName | 报关账号名称 | string | — | Required | 报关账号名称。 |
| 6.5.10 | supervisionMode | 监管方式 | string | — | Required | 监管方式。 |
| 6.5.11 | authId | 报关账号 ID | string | — | Required | 报关账号 ID,后端序列化为字符串。 |
| 6.5.12 | orderDeclarationStatus | 订单申报状态 | string | — | Required | 订单申报状态。 |
| 6.5.13 | temporaryStorageStatus | 暂存单一状态 | string | — | Required | 暂存单一状态。 |
| 6.5.14 | destinationCountry | 运抵国 | string | — | Required | 运抵国。 |
| 6.5.15 | referenceType | 关联单据类型 | integer | 1 | Required | 关联单据类型:1 发货单;2 备货单。 |
| 6.5.16 | referenceNos | 关联单号列表 | array<any> | — | Required | 关联单号列表。 |
| 6.5.17 | shipmentNo | 货件单号列表 | array<any> | — | Required | 货件单号列表。 |
| 6.5.18 | orderNo | 订单/订仓单号 | string | — | Required | 订单/订仓单号。 |
| 6.5.19 | platform | 电商平台 | string | — | Required | 电商平台。 |
| 6.5.20 | freight | 运杂费 | string | — | Required | 运杂费。 |
| 6.5.21 | totalPackages | 总箱数 | integer | — | Required | 总箱数。 |
| 6.5.22 | totalNetWeight | 总净重(kg) | string | — | Required | 总净重(kg)。 |
| 6.5.23 | totalGrossWeight | 总毛重(kg) | string | — | Required | 总毛重(kg)。 |
| 6.5.24 | declaredAmount | 申报金额 | string | — | Required | 申报金额,最多两位小数。 |
| 6.5.25 | currency | 币种 | string | — | Required | 币种。 |
| 6.5.26 | createdBy | 创建人名称 | string | — | Required | 创建人名称。 |
| 6.5.27 | createdTime | 创建时间 | string | — | Required | 创建时间,格式 yyyy-MM-dd HH:mm:ss。 |
| 6.5.28 | lastModifiedBy | 最近修改人名称 | string | — | Required | 最近修改人名称。 |
| 6.5.29 | lastModifiedTime | 最近修改时间 | string | — | Required | 最近修改时间,格式 yyyy-MM-dd HH:mm:ss。 |
| 6.5.30 | remark | 内部备注 | string | — | Required | 内部备注。 |
| 7 | total | 总记录数 | integer | 1 | Required | 总记录数 |
The 报关管理列表 API (/basicOpen/customs/search) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.