Lingxing
切换旧版

报关管理列表

POST/basicOpen/customs/search

分页查询报关资料,结果按创建时间倒序返回。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/customs/searchHTTPSPOST1

请求参数

offsetinteger必填
分页起始偏移量,从 0 开始。
lengthinteger必填
每页条数,默认 20,最多 200。
destinationCountryarray<any>
运抵国列表,命中任意一项。
referenceTypeinteger
关联单据类型:1 发货单;2 备货单。
productionSalesUnitarray<any>
生产销售单位 ID 列表,命中任意一项。
supervisionModestring
监管方式,精确匹配,例如 9810、9710。
orderDeclarationStatusstring
订单申报状态:PENDING 待申报;DECLARING 申报中;SUCCESS 申报成功;FAILED 申报失败。
temporaryStorageStatusstring
暂存单一状态:PENDING 待暂存;SAVING 暂存中;SUCCESS 暂存成功;FAILED 暂存失败。
createStartTimestring
创建时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
createEndTimestring
创建时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
updateStartTimestring
最近修改时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
updateEndTimestring
最近修改时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
timeTypeinteger
时间筛选类型:1 创建时间;2 最后修改时间;3 出口日期。
timeStartDatestring
按 timeType 筛选的开始日期(含),格式 yyyy-MM-dd。
timeEndDatestring
按 timeType 筛选的结束日期(含),格式 yyyy-MM-dd。
searchTypeinteger
搜索类型:1 报关资料编号;2 关联单号;3 货件号;4 合同协议号;5 内部备注。
searchValuestring
单个关键字,按 searchType 模糊匹配;searchValues 有有效值时忽略。
searchValuesarray<any>
批量精确关键字,需配合 searchType;命中任意一项;非空时忽略 searchValue。
productSearchFieldinteger
商品搜索字段:1 商品名称;2 商品编码。
productSearchValuestring
单个商品关键字,按 productSearchField 模糊匹配;productSearchValues 有有效值时忽略。
productSearchValuesarray<any>
批量精确商品关键字,需配合 productSearchField;命中任意一项;非空时忽略 productSearchValue。
moreFiltersobject
更多筛选条件。
隐藏子属性
creatorUserIdsarray<any>
创建人用户 ID 列表,命中任意一项。
modifierUserIdsarray<any>
修改人用户 ID 列表,命中任意一项。
authIdsarray<any>
报关账号 ID 列表,命中任意一项。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/customs/search?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{"offset":0,"length":20,"destinationCountry":[],"referenceType":"","productionSalesUnit":[],"searchType":1,"searchValue":"","moreFilters":{"creatorUserIds":[],"modifierUserIds":[],"authIds":[]}}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-09-28 12:00:00
dataobject必填
分页响应数据
隐藏子属性
offsetinteger必填
本次请求的起始偏移量。
示例 0
lengthinteger必填
本次请求的每页条数。
示例 20
totalinteger必填
匹配的总记录数。
pagesinteger必填
总页数。
listarray<object>必填
当前页报关资料。
隐藏子属性
declarationIdstring必填
报关资料 ID,后端序列化为字符串。
declarationNostring必填
报关资料编号。
temporaryStorageInfoobject必填
暂存单一错误信息。
orderDeclareInfoobject必填
订单申报信息或错误信息。
producerSalesUnitstring必填
生产销售单位 ID,后端序列化为字符串。
producerSalesUnitNamestring必填
生产销售单位名称。
shipperInfoobject必填
境内发货人信息。
隐藏子属性
shipperIdstring必填
境内发货人 ID,后端序列化为字符串。
shipperNamestring必填
境内发货人名称。
socialCreditCodestring必填
社会信用代码
customsCodestring必填
海关编码
shipperElectronicSealPicturestring必填
境内发货人电子签章
shipperAddressstring必填
境内发货人地址
shipperPhonestring必填
境内发货人电话
shipperFaxstring必填
境内发货人传真
consigneeInfoobject必填
境外收货人信息。
隐藏子属性
consigneeIdstring必填
境外收货人 ID,后端序列化为字符串。
consigneeNamestring必填
境外收货人名称。
receiverElectronicSealPicturestring必填
境外收货人电子签章
consigneeAddressstring必填
境外收货人地址
consigneePhonestring必填
境外收货人电话
consigneeFaxstring必填
境外收货人传真
accountNamestring必填
报关账号名称。
supervisionModestring必填
监管方式。
authIdstring必填
报关账号 ID,后端序列化为字符串。
orderDeclarationStatusstring必填
订单申报状态。
temporaryStorageStatusstring必填
暂存单一状态。
destinationCountrystring必填
运抵国。
referenceTypeinteger必填
关联单据类型:1 发货单;2 备货单。
示例 1
referenceNosarray<any>必填
关联单号列表。
shipmentNoarray<any>必填
货件单号列表。
orderNostring必填
订单/订仓单号。
platformstring必填
电商平台。
freightstring必填
运杂费。
totalPackagesinteger必填
总箱数。
totalNetWeightstring必填
总净重(kg)。
totalGrossWeightstring必填
总毛重(kg)。
declaredAmountstring必填
申报金额,最多两位小数。
currencystring必填
币种。
createdBystring必填
创建人名称。
createdTimestring必填
创建时间,格式 yyyy-MM-dd HH:mm:ss。
lastModifiedBystring必填
最近修改人名称。
lastModifiedTimestring必填
最近修改时间,格式 yyyy-MM-dd HH:mm:ss。
remarkstring必填
内部备注。
totalinteger必填
总记录数
示例 1

返回成功示例

{
    "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
}

附加说明

  • referenceType 可传 1、2,页面未筛选时实际传空字符串;下游会按原值转发。
  • 有效的 searchValues 优先于 searchValue;有效的 productSearchValues 优先于 productSearchValue。
  • 传入 timeType 时使用 timeStartDate、timeEndDate,忽略创建和修改时间范围字段。
  • declarationId、生产销售单位和收发货人 ID 均按字符串返回,金额及重量也按字符串返回。