轻易云
注册体验

领星ERP报关管理列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
物流 · POST · 请求参数 25 个(必填 2) · 响应参数 56 个 · 限流令牌桶容量 1
更新日期
2026-11-21

报关管理列表

POST/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&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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:报关管理列表(/basicOpen/customs/search),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。