乐企开票 · 开通接口

支付宝系

本组接口为企业一站式完成税局乐企联用资质申请与开票配置: 生成开通授权链接发给企业,企业用企业支付宝登录确认后, 平台自动完成资质申请、审核跟踪与授权令牌托管。开通完成后,即可调用同体系的正向开票、反向开票接口。资金与开票全程走支付宝官方通道直连税务系统。

调用地址

接口	方法	地址	计费
生成开通授权链接	POST	`https://openapi.kailingteck.com/api/v1/alipay/onboard/invite`	免费
查询开通结果	POST	`https://openapi.kailingteck.com/api/v1/alipay/onboard/status`	免费
查询可开通发票产品	POST	`https://openapi.kailingteck.com/api/v1/alipay/onboard/products`	免费
发票产品开通申请(企业自主)	POST	`https://openapi.kailingteck.com/api/v1/alipay/onboard/apply`	免费

请求体为 JSON,Content-Type: application/json;鉴权与本平台其他接口同一套(X-App-Key / X-Timestamp / X-Sign,见签名说明)。

开通流程(四步)

调用 onboard/invite 生成开通授权链接,发给企业经办人(反向开票只有 PC 网页链接,正向开票另附小程序链接);
企业在电脑上用企业支付宝登录开通页,核对税号信息、确认授权、提交开通(同步完成乐企联用资质申请);
平台侧完成审核跟踪与授权令牌自动托管——贵方无需处理任何支付宝证书/令牌细节;
调用 onboard/status 轮询开通结果,flow_status = ACTIVATION_SUCCESS 即开通完成,可开始开票。

注意:反向开票的开通授权只能在电脑上走网页确认,支付宝不支持小程序扫码授权,别把二维码发给企业; 反向开票仅支持企业支付宝;正反向都要用时务必以企业支付宝开通;单税号仅支持一个支付宝账户开通。

产品码速查

场景	体系分类	product_code
报废产品收购	反向开票	`SCRAP_MATERIAL`
农产品收购	反向开票	`AGRICULTURAL_PRODUCT_PURCHASE`
灵活用工(通用反向)	反向开票	`REVERSE_INVOICE_NORMAL`
基础版开票	正向开票	`NORMAL_INVOICE`
成品油发票	正向开票	`REFINED_OIL_INVOICE`
不动产租赁发票	正向开票	`REAL_PROPERTY_BUSINESS_INVOICE`
旅客运输发票	正向开票	`PASSENGER_TRANSPORT_INVOICE`

接口一:生成开通授权链接

请求参数

参数名称	类型	必填	长度	描述
product_code	string	是	64	开票产品码,见下方「产品码速查」
out_apply_id	string	是	64	外部申请ID,贵方自行生成、全局唯一,后续开通结果按此关联
company_name	string	否	128	企业名称(可选,商户在开通页可自行填写/修改)
company_tax_no	string	否	20	企业税号(可选,传入后开通页预填)

响应参数

参数名称	类型	必返	描述
pc_url	string	是	PC 端开通授权链接,商户在电脑上用企业支付宝登录网页、核对信息后确认授权
auth_mode	string	是	授权方式:PC_WEB_ONLY 仅网页确认(反向开票三个产品码);PC_WEB_OR_MINI 网页或小程序均可(正向开票)
mini_scheme_url	string	否	支付宝小程序开通链接(alipays:// scheme)。仅正向开票产品返回;反向开票不支持扫码授权,不返回此字段
out_apply_id	string	是	原样返回外部申请ID

请求示例

{
  "product_code": "SCRAP_MATERIAL",
  "out_apply_id": "KL_20260718_0001",
  "company_name": "某某再生资源有限公司",
  "company_tax_no": "913301067046373123"
}

响应示例

{
  "code": "10000",
  "msg": "Success",
  "out_apply_id": "KL_20260718_0001",
  "pc_url": "https://piao.alipay.com/isv/auth-invitation?productCode=SCRAP_MATERIAL&isvAppId=…&outApplyId=KL_20260718_0001",
  "auth_mode": "PC_WEB_ONLY"
}

接口二:查询开通结果

请求参数

参数名称	类型	必填	长度	描述
tax_no	string	是	20	企业(商户)税号
apply_id	string	条件	28	产品开通流水ID(与 out_apply_id 二选一)
out_apply_id	string	条件	64	外部产品开通申请ID(与 apply_id 二选一)

响应参数

参数名称	类型	必返	描述
apply_id	string	是	产品开通流水ID
out_apply_id	string	是	外部申请ID
flow_status	string	是	开通状态:WAIT_AUDIT 待审核;AUTH_PENDING 授权中;AUTH_SUCCESS 授权成功;AUTH_FAIL 授权失败;ACTIVATION_SUCCESS 开通成功;AUDIT_FAIL 审核未通过;ACTIVATION_FAIL 开通失败
open_page_url	string	是	开通流程页链接(需商户登录),流程卡住时可发给商户继续办理

响应示例

{
  "code": "10000",
  "msg": "Success",
  "apply_id": "2024121700152002340000001000",
  "out_apply_id": "KL_20260718_0001",
  "flow_status": "ACTIVATION_SUCCESS",
  "open_page_url": "https://piao.alipay.com/open/xxxxx"
}

接口三:查询可开通发票产品

请求参数

参数名称	类型	必填	长度	描述
product_type	string	是	16	发票产品类型:BASIC 基础能力;INVOICE 正向开票;RECYCLING 反向开票

响应参数

参数名称	类型	必返	描述
invoice_product_list	array	否	平台已发布发票产品列表
invoice_product_list.product_id	string	是	发票产品编号
invoice_product_list.product_name	string	是	发票产品名称,如「报废产品收购」
invoice_product_list.product_type	string	是	BASIC / INVOICE / RECYCLING
invoice_product_list.product_desc	string	是	发票产品描述

接口四:发票产品开通申请(企业自主开通)

适用于企业不经邀请链接、直接按税号+产品编号发起开通的场景。

请求参数

参数名称	类型	必填	长度	描述
tax_no	string	是	20	企业(商户)税号
product_id	string	是	16	发票产品编号(可先调「产品查询」获取)
out_apply_id	string	是	64	外部申请ID,唯一

响应参数

参数名称	类型	必返	描述
apply_id	string	是	产品开通流水ID
out_apply_id	string	是	外部申请ID
flow_status	string	是	开通状态:WAIT_AUDIT 待审核;AUTH_PENDING 授权中;AUTH_SUCCESS 授权成功;AUTH_FAIL 授权失败;ACTIVATION_SUCCESS 开通成功;AUDIT_FAIL 审核未通过;ACTIVATION_FAIL 开通失败
open_page_url	string	是	开通流程页链接(需商户登录),流程卡住时可发给商户继续办理

常见业务错误码

错误码(sub_code)	含义与处理
COMPANY_TAX_NO_UNANIMOUS	企业税号与支付宝认证税号不一致,请核对税号
MERCHANT_NOT_CERTIFIED	账户非企业账号或未完成实名认证,完成认证后重试
COMPANY_PRODUCT_EXIST	该产品在当前企业下已申请存在,无需重复开通
NOT_PRODUCT_MULTI_INSTANCE	暂不支持同一企业开通多个反向产品
OUT_FLOW_ID_APPLY_EXIST	外部申请ID已存在,更换 out_apply_id 后重试
PRODUCT_NOT_EXIST / PRODUCT_ILLEGAL_STATUS	发票产品不存在/已停用,先调产品查询确认

响应 code = 10000 为成功;业务失败时 code=40004,按 sub_code / sub_msg 提示处理。