接入文档 /交付与通知/短信 / 邮件交付

短信 / 邮件交付

开票时传入 mobile / email，开票成功后 EasyAPI 会自动向购买方发送发票。以下接口用于补发或向新的手机号、邮箱发送已开具的发票。发票的交付页地址（downloadUrl）与 PDF 地址（electronicInvoiceUrl）也可以由业务系统自行发送给购买方。

发送短信

GET/send/mobile

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
outOrderNo	string	必填	外部订单号
mobile	string	必填	接收手机号，多个用英文逗号分隔
color	string	选填	`blue`（默认）/ `red`

bash

curl "https://fapiao-api.easyapi.com/send/mobile?appKey=你的appKey&appSecret=你的appSecret&taxNumber=91320211MA1WML8X6T&outOrderNo=ORDER20260101001&mobile=13800000000"

json

{
  "code": 1,
  "message": "发送成功"
}

发票原先没有填写手机号时，本次手机号会保存到发票记录中。

发送邮件

GET/send/email

需要先在控制台「发票配置 - 开票配置 - 邮件配置」中开启邮件发送功能。

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
outOrderNo	string	必填	外部订单号
email	string	必填	接收邮箱，多个用英文逗号分隔
color	string	选填	`blue`（默认）/ `red`

json

{
  "code": 1,
  "message": "发送成功"
}

message	说明
未开启邮件发送功能，请点击左侧菜单发票配置-开票配置-邮件配置设置	控制台未开启邮件发送
xxx邮箱格式不正确 / 邮箱不能为空	邮箱格式错误

查询邮件发送记录

GET/send/email/query

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

json

{
  "code": 1,
  "message": "查询成功",
  "content": {
    "email": "",
    "time": ""
  }
}

说明

该接口当前返回的 email、time 为占位字段；使用自定义邮件服务器发送的企业会返回 自定义邮件暂不支持查询。发票对象中的 sendSuccessCount 可用于判断是否已成功交付。

通用错误

message	说明
商户订单号不能为空	`outOrderNo` 为空
商户订单号蓝票不存在 / 商户订单号红票不存在	对应颜色的发票不存在
手机号码不能为空 / xxx手机号码格式不正确	手机号格式错误