主要供应商与客户

ProcurementAndSales

付费 · PlusJSON支持在线试运行

此接口需要付费授权或有效测试权限。可先查看字段和示例；在线支付尚未开放。

数据说明

主要供应商与客户接口用于获取沪深北上市公司前五大客户销售情况和前五大供应商采购情况；该接口包含日期、证券名称、前五大客户销售明细（客户名称、销售金额、销售额占总额比例）、前五大客户销售合计、前五大供应商采购明细（供应商名称、采购金额、采购额占总额比例）以及前五大供应商采购合计等关键指标使用场景： -支持用户获取公司前五大客户及对应销售情况信息； -支持用户获取公司前五大供应商及对应采购情况信息

POST /v1/data/operations/ProcurementAndSales · JSON

输入参数

字段	类型	约束	说明与示例
`stockObject` 股票代码	文本列表 `string_array`	必填按字典选择: `STOCK_A_COMPANY`	股票代码是指沪深北上市公司通用的股票代码，支持一次获取多个品种数据示例: `["1679"]`
`relationType` 关系类型	文本列表 `string_array`	可选按字典选择: `RELATIONTYPE`	关系类型是指公司在采购交易时，对手方的的关系类型，包括客户、供应商示例: `[…]`
`beginDate` 起始日期	日期（年-月-日） `date`	可选	起始日期是查询会计报告期区间的开始日期，输入格式“YYYY-MM-DD” 示例: `2026-09-30`
`endDate` 截止日期	日期（年-月-日） `date`	可选	截止日期是查询会计报告期区间的结束日期，输入格式“YYYY-MM-DD” 示例: `2026-09-30`
`pageNo` 页面编号	数字 `number`	可选	定位分页查询的目标页码，默认不限示例: `1`
`pageSize` 页内记录数	数字 `number`	可选	单页返回的最大记录条数，默认不限示例: `5`

返回字段

字段	类型	约束	说明与示例
`stockobject` 股票内码	文本 `string`	—	沪深北上市股票的内部编码示例: `示例文本`
`stockname` 股票名称	文本 `string`	—	沪深北上市公司的股票简称示例: `示例文本`
`stockcode` 股票代码	文本 `string`	—	沪深北上市公司的通用股票代码示例: `示例文本`
`reportdate` 报告期	文本 `string`	—	主要供应商/客户数据的报告期示例: `示例文本`
`relationtype` 关系类型	文本 `string`	—	主要供应商/客户的关系类型：客户\供应商示例: `示例文本`
`serialnumber` 关系排名	文本 `string`	—	主要供应商/客户的关系排名示例: `示例文本`
`relatedpartyname` 供应商/客户名称	文本 `string`	—	主要供应商/客户的名称示例: `示例文本`
`tradingvalue` 交易金额（万元）	文本 `string`	—	主要供应商/客户的交易金额示例: `示例文本`
`ratiointotal` 占总额比例（%）	文本 `string`	—	主要供应商/客户的交易金额占总交易额之比示例: `示例文本`
`remark` 备注说明	文本 `string`	—	主要供应商/客户信息的备注说明示例: `示例文本`

调用示例

已填入示例标的、必填参数与适用的分页限制。点击试运行，在右侧抽屉查看字段说明并获取真实返回。

{
  "parameters": {
    "stockObject": [
      "1679"
    ],
    "pageNo": 1,
    "pageSize": 5
  }
}

stockObject: 贵州茅台 · 600519.SH
样例使用已核验的标的和字典值；返回记录取决于查询范围、数据更新及当前 Key 权限。
默认请求 5 条；部分业务聚合可能返回更多记录，以实际响应为准。

覆盖与使用边界

请先运行示例，确认所需证券、日期范围和字段是否可用。可用历史范围与内容使用许可因接口而异；查询使用账户和所选 API Key 的权限与额度。

分钟周期、复权方式和时间单位请按上方参数说明填写。接口没有返回的数据不代表数值为零。