Qeasy Cloud
Get Started

领星ERP 报关管理列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
物流 · POST · 请求参数 25 个(必填 2) · 响应参数 56 个 · 限流令牌桶容量 1
Updated At
2026-11-21

报关管理列表

POST/basicOpen/customs/search
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset分页起始偏移量integer—Required分页起始偏移量,从 0 开始。
2length每页条数integer—Required每页条数,默认 20,最多 200。
3destinationCountry运抵国列表array<any>—Optional运抵国列表,命中任意一项。
4referenceType关联单据类型integer—Optional关联单据类型:1 发货单;2 备货单。
5productionSalesUnit生产销售单位 ID 列表array<any>—Optional生产销售单位 ID 列表,命中任意一项。
6supervisionMode监管方式string—Optional监管方式,精确匹配,例如 9810、9710。
7orderDeclarationStatus订单申报状态string—Optional订单申报状态:PENDING 待申报;DECLARING 申报中;SUCCESS 申报成功;FAILED 申报失败。
8temporaryStorageStatus暂存单一状态string—Optional暂存单一状态:PENDING 待暂存;SAVING 暂存中;SUCCESS 暂存成功;FAILED 暂存失败。
9createStartTime创建时间起点(含)string—Optional创建时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
10createEndTime创建时间终点(含)string—Optional创建时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
11updateStartTime最近修改时间起点(含)string—Optional最近修改时间起点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
12updateEndTime最近修改时间终点(含)string—Optional最近修改时间终点(含),格式 yyyy-MM-dd HH:mm:ss;仅 timeType 未传时生效。
13timeType时间筛选类型integer—Optional时间筛选类型:1 创建时间;2 最后修改时间;3 出口日期。
14timeStartDate按 timeType 筛选的开始日期(含)string—Optional按 timeType 筛选的开始日期(含),格式 yyyy-MM-dd。
15timeEndDate按 timeType 筛选的结束日期(含)string—Optional按 timeType 筛选的结束日期(含),格式 yyyy-MM-dd。
16searchType搜索类型integer—Optional搜索类型:1 报关资料编号;2 关联单号;3 货件号;4 合同协议号;5 内部备注。
17searchValue单个关键字string—Optional单个关键字,按 searchType 模糊匹配;searchValues 有有效值时忽略。
18searchValues批量精确关键字array<any>—Optional批量精确关键字,需配合 searchType;命中任意一项;非空时忽略 searchValue。
19productSearchField商品搜索字段integer—Optional商品搜索字段:1 商品名称;2 商品编码。
20productSearchValue单个商品关键字string—Optional单个商品关键字,按 productSearchField 模糊匹配;productSearchValues 有有效值时忽略。
21productSearchValues批量精确商品关键字array<any>—Optional批量精确商品关键字,需配合 productSearchField;命中任意一项;非空时忽略 productSearchValue。
22moreFilters更多筛选条件object—Optional更多筛选条件。
22.1creatorUserIds创建人用户 ID 列表array<any>—Optional创建人用户 ID 列表,命中任意一项。
22.2modifierUserIds修改人用户 ID 列表array<any>—Optional修改人用户 ID 列表,命中任意一项。
22.3authIds报关账号 ID 列表array<any>—Optional报关账号 ID 列表,命中任意一项。

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-09-28 12:00:00Required响应时间
6data分页响应数据object—Required分页响应数据
6.1offset本次请求的起始偏移量integer0Required本次请求的起始偏移量。
6.2length本次请求的每页条数integer20Required本次请求的每页条数。
6.3total匹配的总记录数integer—Required匹配的总记录数。
6.4pages总页数integer—Required总页数。
6.5list当前页报关资料array<object>—Required当前页报关资料。
6.5.1declarationId报关资料 IDstring—Required报关资料 ID,后端序列化为字符串。
6.5.2declarationNo报关资料编号string—Required报关资料编号。
6.5.3temporaryStorageInfo暂存单一错误信息object—Required暂存单一错误信息。
6.5.4orderDeclareInfo订单申报信息或错误信息object—Required订单申报信息或错误信息。
6.5.5producerSalesUnit生产销售单位 IDstring—Required生产销售单位 ID,后端序列化为字符串。
6.5.6producerSalesUnitName生产销售单位名称string—Required生产销售单位名称。
6.5.7shipperInfo境内发货人信息object—Required境内发货人信息。
6.5.7.1shipperId境内发货人 IDstring—Required境内发货人 ID,后端序列化为字符串。
6.5.7.2shipperName境内发货人名称string—Required境内发货人名称。
6.5.7.3socialCreditCode社会信用代码string—Required社会信用代码
6.5.7.4customsCode海关编码string—Required海关编码
6.5.7.5shipperElectronicSealPicture境内发货人电子签章string—Required境内发货人电子签章
6.5.7.6shipperAddress境内发货人地址string—Required境内发货人地址
6.5.7.7shipperPhone境内发货人电话string—Required境内发货人电话
6.5.7.8shipperFax境内发货人传真string—Required境内发货人传真
6.5.8consigneeInfo境外收货人信息object—Required境外收货人信息。
6.5.8.1consigneeId境外收货人 IDstring—Required境外收货人 ID,后端序列化为字符串。
6.5.8.2consigneeName境外收货人名称string—Required境外收货人名称。
6.5.8.3receiverElectronicSealPicture境外收货人电子签章string—Required境外收货人电子签章
6.5.8.4consigneeAddress境外收货人地址string—Required境外收货人地址
6.5.8.5consigneePhone境外收货人电话string—Required境外收货人电话
6.5.8.6consigneeFax境外收货人传真string—Required境外收货人传真
6.5.9accountName报关账号名称string—Required报关账号名称。
6.5.10supervisionMode监管方式string—Required监管方式。
6.5.11authId报关账号 IDstring—Required报关账号 ID,后端序列化为字符串。
6.5.12orderDeclarationStatus订单申报状态string—Required订单申报状态。
6.5.13temporaryStorageStatus暂存单一状态string—Required暂存单一状态。
6.5.14destinationCountry运抵国string—Required运抵国。
6.5.15referenceType关联单据类型integer1Required关联单据类型:1 发货单;2 备货单。
6.5.16referenceNos关联单号列表array<any>—Required关联单号列表。
6.5.17shipmentNo货件单号列表array<any>—Required货件单号列表。
6.5.18orderNo订单/订仓单号string—Required订单/订仓单号。
6.5.19platform电商平台string—Required电商平台。
6.5.20freight运杂费string—Required运杂费。
6.5.21totalPackages总箱数integer—Required总箱数。
6.5.22totalNetWeight总净重(kg)string—Required总净重(kg)。
6.5.23totalGrossWeight总毛重(kg)string—Required总毛重(kg)。
6.5.24declaredAmount申报金额string—Required申报金额,最多两位小数。
6.5.25currency币种string—Required币种。
6.5.26createdBy创建人名称string—Required创建人名称。
6.5.27createdTime创建时间string—Required创建时间,格式 yyyy-MM-dd HH:mm:ss。
6.5.28lastModifiedBy最近修改人名称string—Required最近修改人名称。
6.5.29lastModifiedTime最近修改时间string—Required最近修改时间,格式 yyyy-MM-dd HH:mm:ss。
6.5.30remark内部备注string—Required内部备注。
7total总记录数integer1Required总记录数

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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.