/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 分页起始偏移量 | integer | — | 必填 | 分页起始偏移量,从 0 开始。 |
| 2 | length | 每页条数 | integer | — | 必填 | 每页条数,默认 20,最多 200。 |
| 3 | destinationCountry | 运抵国列表 | array<any> | — | 可选 | 运抵国列表,命中任意一项。 |
| 4 | referenceType | 关联单据类型 | integer | — | 可选 | 关联单据类型:1 发货单;2 备货单。 |
| 5 | productionSalesUnit | 生产销售单位 ID 列表 | array<any> | — | 可选 | 生产销售单位 ID 列表,命中任意一项。 |
| 6 | supervisionMode | 监管方式 | string | — | 可选 | 监管方式,精确匹配,例如 9810、9710。 |
| 7 | orderDeclarationStatus | 订单申报状态 | string | — | 可选 | 订单申报状态:PENDING 待申报;DECLARING 申报中;SUCCESS 申报成功;FAILED 申报失败。 |
| 8 | temporaryStorageStatus | 暂存单一状态 | string | — | 可选 | 暂存单一状态:PENDING 待暂存;SAVING 暂存中;SUCCESS 暂存成功;FAILED 暂存失败。 |
| 9 | createStartTime | 创建时间起点(含) | string | — | 可选 | 创建时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 10 | createEndTime | 创建时间终点(含) | string | — | 可选 | 创建时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 11 | updateStartTime | 最近修改时间起点(含) | string | — | 可选 | 最近修改时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 12 | updateEndTime | 最近修改时间终点(含) | string | — | 可选 | 最近修改时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。 |
| 13 | timeType | 时间筛选类型 | integer | — | 可选 | 时间筛选类型:1 创建时间;2 最后修改时间;3 出口日期。 |
| 14 | timeStartDate | 按 timeType 筛选的开始日期(含) | string | — | 可选 | 按 timeType 筛选的开始日期(含),格式 yyyy-MM-dd。 |
| 15 | timeEndDate | 按 timeType 筛选的结束日期(含) | string | — | 可选 | 按 timeType 筛选的结束日期(含),格式 yyyy-MM-dd。 |
| 16 | searchType | 搜索类型 | integer | — | 可选 | 搜索类型:1 报关资料编号;2 关联单号;3 货件号;4 合同协议号;5 内部备注。 |
| 17 | searchValue | 单个关键字 | string | — | 可选 | 单个关键字,按 searchType 模糊匹配;searchValues 有有效值时忽略。 |
| 18 | searchValues | 批量精确关键字 | array<any> | — | 可选 | 批量精确关键字,需配合 searchType;命中任意一项;非空时忽略 searchValue。 |
| 19 | productSearchField | 商品搜索字段 | integer | — | 可选 | 商品搜索字段:1 商品名称;2 商品编码。 |
| 20 | productSearchValue | 单个商品关键字 | string | — | 可选 | 单个商品关键字,按 productSearchField 模糊匹配;productSearchValues 有有效值时忽略。 |
| 21 | productSearchValues | 批量精确商品关键字 | array<any> | — | 可选 | 批量精确商品关键字,需配合 productSearchField;命中任意一项;非空时忽略 productSearchValue。 |
| 22 | moreFilters | 更多筛选条件 | object | — | 可选 | 更多筛选条件。 |
| 22.1 | creatorUserIds | 创建人用户 ID 列表 | array<any> | — | 可选 | 创建人用户 ID 列表,命中任意一项。 |
| 22.2 | modifierUserIds | 修改人用户 ID 列表 | array<any> | — | 可选 | 修改人用户 ID 列表,命中任意一项。 |
| 22.3 | authIds | 报关账号 ID 列表 | array<any> | — | 可选 | 报关账号 ID 列表,命中任意一项。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-09-28 12:00:00 | 必填 | 响应时间 |
| 6 | data | 分页响应数据 | object | — | 必填 | 分页响应数据 |
| 6.1 | offset | 本次请求的起始偏移量 | integer | 0 | 必填 | 本次请求的起始偏移量。 |
| 6.2 | length | 本次请求的每页条数 | integer | 20 | 必填 | 本次请求的每页条数。 |
| 6.3 | total | 匹配的总记录数 | integer | — | 必填 | 匹配的总记录数。 |
| 6.4 | pages | 总页数 | integer | — | 必填 | 总页数。 |
| 6.5 | list | 当前页报关资料 | array<object> | — | 必填 | 当前页报关资料。 |
| 6.5.1 | declarationId | 报关资料 ID | string | — | 必填 | 报关资料 ID,后端序列化为字符串。 |
| 6.5.2 | declarationNo | 报关资料编号 | string | — | 必填 | 报关资料编号。 |
| 6.5.3 | temporaryStorageInfo | 暂存单一错误信息 | object | — | 必填 | 暂存单一错误信息。 |
| 6.5.4 | orderDeclareInfo | 订单申报信息或错误信息 | object | — | 必填 | 订单申报信息或错误信息。 |
| 6.5.5 | producerSalesUnit | 生产销售单位 ID | string | — | 必填 | 生产销售单位 ID,后端序列化为字符串。 |
| 6.5.6 | producerSalesUnitName | 生产销售单位名称 | string | — | 必填 | 生产销售单位名称。 |
| 6.5.7 | shipperInfo | 境内发货人信息 | object | — | 必填 | 境内发货人信息。 |
| 6.5.7.1 | shipperId | 境内发货人 ID | string | — | 必填 | 境内发货人 ID,后端序列化为字符串。 |
| 6.5.7.2 | shipperName | 境内发货人名称 | string | — | 必填 | 境内发货人名称。 |
| 6.5.7.3 | socialCreditCode | 社会信用代码 | string | — | 必填 | 社会信用代码 |
| 6.5.7.4 | customsCode | 海关编码 | string | — | 必填 | 海关编码 |
| 6.5.7.5 | shipperElectronicSealPicture | 境内发货人电子签章 | string | — | 必填 | 境内发货人电子签章 |
| 6.5.7.6 | shipperAddress | 境内发货人地址 | string | — | 必填 | 境内发货人地址 |
| 6.5.7.7 | shipperPhone | 境内发货人电话 | string | — | 必填 | 境内发货人电话 |
| 6.5.7.8 | shipperFax | 境内发货人传真 | string | — | 必填 | 境内发货人传真 |
| 6.5.8 | consigneeInfo | 境外收货人信息 | object | — | 必填 | 境外收货人信息。 |
| 6.5.8.1 | consigneeId | 境外收货人 ID | string | — | 必填 | 境外收货人 ID,后端序列化为字符串。 |
| 6.5.8.2 | consigneeName | 境外收货人名称 | string | — | 必填 | 境外收货人名称。 |
| 6.5.8.3 | receiverElectronicSealPicture | 境外收货人电子签章 | string | — | 必填 | 境外收货人电子签章 |
| 6.5.8.4 | consigneeAddress | 境外收货人地址 | string | — | 必填 | 境外收货人地址 |
| 6.5.8.5 | consigneePhone | 境外收货人电话 | string | — | 必填 | 境外收货人电话 |
| 6.5.8.6 | consigneeFax | 境外收货人传真 | string | — | 必填 | 境外收货人传真 |
| 6.5.9 | accountName | 报关账号名称 | string | — | 必填 | 报关账号名称。 |
| 6.5.10 | supervisionMode | 监管方式 | string | — | 必填 | 监管方式。 |
| 6.5.11 | authId | 报关账号 ID | string | — | 必填 | 报关账号 ID,后端序列化为字符串。 |
| 6.5.12 | orderDeclarationStatus | 订单申报状态 | string | — | 必填 | 订单申报状态。 |
| 6.5.13 | temporaryStorageStatus | 暂存单一状态 | string | — | 必填 | 暂存单一状态。 |
| 6.5.14 | destinationCountry | 运抵国 | string | — | 必填 | 运抵国。 |
| 6.5.15 | referenceType | 关联单据类型 | integer | 1 | 必填 | 关联单据类型:1 发货单;2 备货单。 |
| 6.5.16 | referenceNos | 关联单号列表 | array<any> | — | 必填 | 关联单号列表。 |
| 6.5.17 | shipmentNo | 货件单号列表 | array<any> | — | 必填 | 货件单号列表。 |
| 6.5.18 | orderNo | 订单/订仓单号 | string | — | 必填 | 订单/订仓单号。 |
| 6.5.19 | platform | 电商平台 | string | — | 必填 | 电商平台。 |
| 6.5.20 | freight | 运杂费 | string | — | 必填 | 运杂费。 |
| 6.5.21 | totalPackages | 总箱数 | integer | — | 必填 | 总箱数。 |
| 6.5.22 | totalNetWeight | 总净重(kg) | string | — | 必填 | 总净重(kg)。 |
| 6.5.23 | totalGrossWeight | 总毛重(kg) | string | — | 必填 | 总毛重(kg)。 |
| 6.5.24 | declaredAmount | 申报金额 | string | — | 必填 | 申报金额,最多两位小数。 |
| 6.5.25 | currency | 币种 | string | — | 必填 | 币种。 |
| 6.5.26 | createdBy | 创建人名称 | string | — | 必填 | 创建人名称。 |
| 6.5.27 | createdTime | 创建时间 | string | — | 必填 | 创建时间,格式 yyyy-MM-dd HH:mm:ss。 |
| 6.5.28 | lastModifiedBy | 最近修改人名称 | string | — | 必填 | 最近修改人名称。 |
| 6.5.29 | lastModifiedTime | 最近修改时间 | string | — | 必填 | 最近修改时间,格式 yyyy-MM-dd HH:mm:ss。 |
| 6.5.30 | remark | 内部备注 | string | — | 必填 | 内部备注。 |
| 7 | total | 总记录数 | integer | 1 | 必填 | 总记录数 |
领星ERP的接口:报关管理列表(/basicOpen/customs/search),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。