轻易云
注册体验

领星ERP查询供应商列表接口

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

查询供应商列表

POST/erp/sc/data/local_inventory/supplier
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/data/local_inventory/supplier"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "offset": 0,
    "length": 1000
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "929A1D7D-D656-0EA0-C78A-A686790C7090",
    "response_time": "2022-05-20 16:57:03",
    "data": [
      {
        "customer_supplier_id": null,
        "supplier_id": 500,
        "supplier_name": "供应商5870",
        "supplier_code": "34-AK.pei",
        "employees": 1,
        "url": "012010",
        "contact_person": "012010",
        "contact_number": "012010",
        "qq": "012010",
        "email": "012010",
        "fax": "012010",
        "account_name": "012010",
        "open_bank": "012010",
        "bank_card_number": "012010",
        "remark": "0接口新增供应商5870",
        "purchaser": "1",
        "is_delete": 0,
        "status": 1,
        "status_text": "启用",
        "address_full": "",
        "payment_method_text": "网银转账",
        "pc_name": "",
        "settlement_method_text": "款到发货",
        "settlement_description": "结算描述1",
        "employees_text": "少于50人",
        "level_text": "★",
        "credit_code": "",
        "prepay_percent": "",
        "payment_account_group": [
          {
            "name": "默认收款账户",
            "account_name": "张三",
            "bank_name": "中国工商银行",
            "account_id": "6222021000000000000",
            "remark": "主要收款账户",
            "is_default": 1,
            "is_open": 1,
            "key": "default_payment_account",
            "version": "1.0.0"
          }
        ],
        "period_config_key": "MONTHLY_SETTLEMENT",
        "period_config_text": "月结",
        "wid": 101,
        "w_name": "主仓库",
        "template_id": "template_abc_123",
        "template_name": "通用采购合同模板",
        "purchaser_id": 200,
        "purchaser_id_text": "采购部门A",
        "receipt_wid": 102,
        "receipt_wid_text": "采购收货仓库B"
      },
      {
        "customer_supplier_id": null,
        "supplier_id": 501,
        "supplier_name": "供应商6000",
        "supplier_code": "SUP-001.XYZ",
        "employees": 5,
        "url": "www.supplier6000.com",
        "contact_person": "李四",
        "contact_number": "13800138000",
        "qq": "123456789",
        "email": "lisi@supplier6000.com",
        "fax": "021-88889999",
        "account_name": "李四公司",
        "open_bank": "中国建设银行",
        "bank_card_number": "6227000000000000000",
        "remark": "新注册供应商",
        "purchaser": "2",
        "is_delete": 0,
        "status": 1,
        "status_text": "启用",
        "address_full": "上海市浦东新区张江高科",
        "payment_method_text": "银行转账",
        "pc_name": "电子元件采购合同",
        "settlement_method_text": "货到付款",
        "settlement_description": "货品验收合格后3个工作日内付款",
        "employees_text": "50-100人",
        "level_text": "★★",
        "credit_code": "913100001234567890",
        "prepay_percent": "20%",
        "payment_account_group": [
          {
            "name": "主要收款账户",
            "account_name": "李四公司",
            "bank_name": "中国建设银行",
            "account_id": "6227000000000000000",
            "remark": "默认收款账户",
            "is_default": 1,
            "is_open": 1,
            "key": "main_payment_account",
            "version": "1.0.0"
          }
        ],
        "period_config_key": "WEEKLY_SETTLEMENT",
        "period_config_text": "周结",
        "wid": 103,
        "w_name": "辅料仓库",
        "template_id": "template_def_456",
        "template_name": "辅料采购合同模板",
        "purchaser_id": 201,
        "purchaser_id_text": "采购部门B",
        "receipt_wid": 104,
        "receipt_wid_text": "辅料收货仓库C"
      }
    ],
    "total": 2
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1offset分页偏移量integer—可选分页偏移量,默认0
2length分页长度integer—可选分页长度,默认1000

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring929A1D7D-D656-0EA0-C78A-A686790C7090必填请求链路id
5response_time响应时间string2022-05-20 16:57:03必填响应时间
6data响应数据array<object>—必填响应数据
6.1customer_supplier_id客户供应商id【已停用】string—必填客户供应商id【已停用】
6.2supplier_id系统供应商idinteger500必填系统供应商id
6.3supplier_name供应商名称string供应商5870必填供应商名称
6.4supplier_codesupplier_codestring34-AK.pei必填供应商编码【供应商代码只支持数字、英文字母、英文句号、-】
6.5employees规模integer1必填规模:员工数
6.6url供应商网址string012010必填供应商网址
6.7contact_person联系人string012010必填联系人
6.8contact_number联系电话string012010必填联系电话
6.9qqqqstring012010必填qq
6.10email邮箱string012010必填邮箱
6.11fax传真string012010必填传真
6.12account_name户名string012010必填户名
6.13open_bank开户行string012010必填开户行
6.14bank_card_number银行卡号string012010必填银行卡号
6.15remark备注string0接口新增供应商5870必填备注
6.16purchaser跟进人string1必填跟进人
6.17is_delete是否已删除integer0必填是否已删除:0 否,1 是
6.18status状态integer1必填状态
6.19status_text状态文本string启用必填状态文本
6.20address_full详细地址string—必填详细地址
6.21payment_method_text支付方式string网银转账必填支付方式
6.22pc_name采购合同名称string—必填采购合同名称
6.23settlement_method_text结算方式string款到发货必填结算方式
6.24settlement_description结算描述string结算描述1必填结算描述
6.25employees_text规模大小string少于50人必填规模大小
6.26level_text级别string★必填级别
6.27credit_code统一社会信用代码string—必填统一社会信用代码
6.28prepay_percent预付比例string—必填预付比例
6.29payment_account_group收款账户array<object>—必填收款账户
6.29.1name账户名称string—必填账户名称
6.29.2account_name户名string—必填户名
6.29.3bank_name开户行string—必填开户行
6.29.4account_id账号string—必填账号
6.29.5remark备注string—必填备注
6.29.6is_default是否默认账户integer—必填是否默认账户
6.29.7is_open是否启用账户integer—必填是否启用账户
6.29.8key功能string—必填功能
6.29.9version功能版本string—必填功能版本
6.30period_config_key结算账期string—必填结算账期
6.31period_config_text结算账期文本string—必填结算账期文本
6.32wid仓库idinteger—必填仓库id
6.33w_name仓库名称string—必填仓库名称
6.34template_id新采购合同模板idstring—必填新采购合同模板id
6.35template_name新采购合同模板名称string—必填新采购合同模板名称
6.36purchaser_id采购方idinteger—必填采购方id
6.37purchaser_id_text采购方string—必填采购方
6.38receipt_wid采购收货仓库idinteger—必填采购收货仓库id
6.39receipt_wid_text采购收货仓库string—必填采购收货仓库
7total总数integer1必填总数

领星ERP的接口:查询供应商列表(/erp/sc/data/local_inventory/supplier),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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