接入文档 /基础数据/企业（商户）信息

企业（商户）信息

查询密钥对应企业的开票配置，或由平台型客户为下游企业注册、更新开票服务。

查询企业信息

GET/shop/query

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
taxNumber	string	必填	要查询的企业税号

bash

curl "https://fapiao-api.easyapi.com/shop/query?appKey=你的appKey&appSecret=你的appSecret&taxNumber=91320211MA1WML8X6T"

响应示例

json

{
  "code": 1,
  "message": "提交成功",
  "content": {
    "shopId": 1001,
    "addTime": "2024-01-01 10:00:00",
    "updateTime": "2026-01-01 10:00:00",
    "endTime": "2027-01-01 00:00:00",
    "renewPrice": 1200,
    "ifDefault": true,
    "identifyNumber": "91320211MA1WML8X6T",
    "name": "无锡帮趣数据服务有限公司",
    "address": "无锡市滨湖区蠡太路118号天圣达科创中心A栋502室",
    "phone": "0510-85180020",
    "bank": "建设银行无锡滨湖支行",
    "bankAccount": "32050161483600001096",
    "receiverName": "",
    "checkerName": "",
    "drawerName": "张三",
    "legalPerson": "",
    "province": "上海",
    "certificate": "",
    "invoiceCategories": [
      { "category": "全电电子普通发票", "minPrice": 0.01, "maxPrice": 100000 },
      { "category": "全电电子专用发票", "minPrice": 0.01, "maxPrice": 100000 }
    ],
    "ifAuditElectronic": false,
    "provider": "数电发票",
    "apiState": 1
  }
}

字段	类型	说明
shopId	int	企业 ID
endTime	string	服务到期时间
renewPrice	decimal	续费价格（元 / 年）
ifDefault	boolean	是否密钥的默认企业
identifyNumber / name	string	税号 / 企业名称
address / phone / bank / bankAccount	string	销售方地址、电话、开户行、账号
receiverName / checkerName / drawerName	string	默认收款人 / 复核人 / 开票人
legalPerson	string	法人
province	string	电子税务局省份
certificate	string	营业执照图片地址
invoiceCategories	array	支持的发票类型及开票金额区间
ifAuditElectronic	boolean	开电子发票是否需要控制台审核
provider	string	开票通道
apiState	int	API 状态：`1` 正常、`0` 过期、`-1` 未开通

注册或更新企业

POST/shop/register

平台型客户（SaaS、代理商）用自己的密钥为下游企业开通开票服务。税号不存在时创建企业并自动关联调用方密钥；税号已存在且属于调用方（或与调用方共用同一组密钥）时更新企业信息。创建后仍需在控制台完成开票员配置与电子税务局登录&认证。

参数	类型	必填	说明
appKey	string	必填	服务密钥 Key
appSecret	string	必填	服务密钥 Secret
name	string	必填	企业名称
taxNumber	string	必填	纳税人识别号，15 / 17 / 18 / 19 / 20 位
province	string	必填	电子税务局省份，如 `上海`、`浙江`
address	string	选填	地址
phone	string	选填	电话
bank	string	选填	开户行
bankAccount	string	选填	银行账号
receiverName	string	选填	收款人，20 字以内
checkerName	string	选填	复核人，20 字以内
drawerName	string	选填	开票人，20 字以内
legalPerson	string	选填	法人，100 字以内
certificate	string	选填	营业执照图片地址
invoiceCategories	array	选填	支持的发票类型与金额区间，元素格式 `{"category":"全电电子普通发票","minPrice":0.01,"maxPrice":100000}`
ifAudit	boolean	选填	开票是否需要审核，默认 `false`
managerMobile	string	选填	企业管理员手机号（控制台登录账号）
managerPassword	string	选填	管理员控制台密码

json

{
  "appKey": "你的appKey",
  "appSecret": "你的appSecret",
  "name": "杭州某某科技有限公司",
  "taxNumber": "91330100MA2XXXXXXX",
  "province": "浙江",
  "address": "杭州市西湖区某某路1号",
  "phone": "0571-00000000",
  "bank": "中国银行杭州分行",
  "bankAccount": "123456789012",
  "invoiceCategories": [
    { "category": "全电电子普通发票", "minPrice": 0.01, "maxPrice": 100000 }
  ],
  "managerMobile": "13900000000"
}

响应示例

json

{
  "code": 1,
  "message": "注册成功",
  "content": {
    "shopId": 1002,
    "addTime": "2026-01-01 10:00:00",
    "updateTime": "2026-01-01 10:00:00",
    "endTime": null,
    "identifyNumber": "91330100MA2XXXXXXX",
    "name": "杭州某某科技有限公司",
    "address": "杭州市西湖区某某路1号",
    "phone": "0571-00000000",
    "bank": "中国银行杭州分行",
    "bankAccount": "123456789012",
    "receiverName": "",
    "checkerName": "",
    "drawerName": "",
    "legalPerson": null,
    "certificate": null,
    "state": 0
  }
}

字段	类型	说明
state	int	`1` 服务中、`0` 未开通、`-1` 已过期

更新已有企业时 message 为 更新成功。

错误信息

message	说明
企业名称不能为空 / 纳税人识别号不能为空 / 电子税务局省份不能为空	必填项缺失
纳税人识别号长度不正确	税号格式错误
纳税人识别号xxx已被其他人添加，如需更改，请联系EasyAPI管理员	该企业已被其他客户注册

上一篇税收分类编码下一篇登录&认证卡片集成