电子发票
接入文档
接入文档 /基础数据/企业抬头查询

企业抬头查询

按企业名称关键字联想企业开票信息（名称、税号、地址电话、开户行账号），用于在开票页面自动补全购买方抬头，减少税号填错导致的开票失败。

GET/company/codes
查询额度

该服务按次计费。请在控制台「发票配置 - 企业抬头查询」中开启服务并购买查询额度，每次调用扣减一次额度。

请求参数

参数 类型 必填 说明
appKey string 条件必填 服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret string 条件必填 服务密钥 Secret
accessToken string 条件必填 访问令牌，通过 获取访问令牌 接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber string 必填 企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
name string 必填 企业名称关键字，至少 4 个字
bash
curl "https://fapiao-api.easyapi.com/company/codes?appKey=你的appKey&appSecret=你的appSecret&taxNumber=91320211MA1WML8X6T&name=无锡帮趣网络"

响应示例

json
{
  "code": 1,
  "message": "获取成功",
  "content": [
    {
      "name": "无锡帮趣数据服务有限公司",
      "taxNumber": "91320211MA1WML8X6T",
      "address": "无锡市滨湖区蠡太路118号天圣达科创中心A栋502室",
      "phone": "0510-85180020",
      "bank": "建设银行无锡滨湖支行",
      "bankAccount": "32050161483600001096"
    }
  ]
}
字段 类型 说明
name string 企业名称
taxNumber string 纳税人识别号（统一社会信用代码）
address string 注册地址
phone string 电话
bank string 开户银行
bankAccount string 银行账号

没有匹配企业时返回 {"code":0,"message":"暂无数据"}。地址、电话、开户行等信息来源于公开登记数据，可能为空，开票前建议由用户确认。

频率限制

同一企业、同一关键字 1 秒内重复请求返回 接口请求频繁。建议前端在用户停止输入后再发起查询。

错误信息

message 说明
不能少于4个字 name 少于 4 个字
接口请求频繁 触发频率限制
上一篇 获取访问令牌下一篇 税收分类编码