Invoice
发票，发票api，发票sdk，电子发票/发票接口/数电发票/数电票/自动化开票/开票接口，支持java/php/go/python/nodejs/c#等
Install / Use
/learn @fapiaoapi/InvoiceREADME
发票接口文档目录
这是一个用于对接发票接口(数电发票)的SDK，支持发票开具、红冲、查询等功能。 发票 电子发票/数电发票/全电发票/数电票/开票
| 语言 | SDK | GitHub | Gitee | 其他 | |-----|-----|--------|-------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Java| central.sonatype.com | invoice-sdk-java | invoice-sdk-java | java8-java16<br/>开票demo<br/>红冲demo<br/>税额计算demo | | PHP | packagist.org| invoice-sdk-php | invoice-sdk-php | | | Python | pypi.org | invoice-sdk-python | invoice-sdk-python | | | Golang | pkg.go.dev| invoice-sdk-golang | invoice-sdk-golang | | | Nodejs| www.npmjs.com | invoice-sdk-nodejs | invoice-sdk-nodejs | | | C# | www.nuget.org | invoice-sdk-csharp | invoice-sdk-csharp | C#8-C#11<br/>开票demo<br/>红冲demo<br/>税额计算demo | | C++ | | | | apiClient.cpp | | postman| | | | 下载<br/>collection<br/>和<br/>environment<br/>后导入postman可测试 | | html | | | | 前端模拟页面 |
基础
- 获取授权
- 登录数电发票平台
- 获取人脸二维码
- 获取人脸二维码认证状态
- 获取认证状态
发票开具
- 数电蓝票开具接口
- 获取销项数电版式文件
发票红冲
- 申请红字前查蓝票信息接口
- 申请红字信息表
- 开负数发票
接入说明
- 在开放平台进行企业账号注册
- 添加企业获得AppKey和AppSecret
- 接入sdk调试
公共请求Header参数
| 名称 | 类型 | 示例值 | 必须 | 参数说明 | | ------------- | ------ | ------------------------------------------------------- | -- | ----------------------------------------- | | AppKey | String | eyJf | 是 | 访问令牌 | | TimeStamp | String | 1743861024 | 是 | 时间戳（秒）10位 | | RandomString | String | YCBtd52riWWKz5i5x6FD | 是 | 随机字符串 20位 | | Sign | String | 3E89AA3F89184CACDE46E80F013186DCa | 是 | 计算出来的签名值（具体计算方式，请到开发所需公共参数中进行查看） | | Authorization | String | eyJhbGciOiJI.eyJleHAiOjEIiwidHlwZSI6IjEifQ.p__oAUSdVd | 是 | 获取授权接口返回数据 |
数电发票开票流程
| 项目 | 说明内容 | 备注 | | ------------ | ---------------------------------------------------- | ------------------- | | 调用方式 | https | POST方式提交 | | 接口地址 | https://api.fa-piao.com/v5/enterprise/authorization | | | 字符编码 | UTF-8 | | | 接口描述 | 获取授权 | Authorization token | | Content-Type | form-data | |
| 名称 | 类型 | 必须 | 参数描述 | |----------| ------ |----|------------| | nsrsbh | String | 是 | 纳税人识别号 | | type | String | 否 | 账户类型 6基础 7标准 | | username | String | 否 | 账号 | | password | String | 否 | 密码 |
| 示例报文 | | --------------------------- | | nsrsbh : 915101820724315989 |
| 字段 | 名称 | 类型 | 说明 | | ----- | --------- | ------ | ---------------------------------------------- | | code | 接口返回code码 | int | 成功：200 code详情 | | msg | 接口返回信息 | String | 成功/失败 | | data | | | | | token | 授权token | String | 公共请求Header参数Authorization |
| 响应报文 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ``` { "code": 200, "data": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDQxMTQ4NTAsImlhdCI6MTc0NDExNDczMCwiaXNzIjoieXVlMDA1IiwibnNyc2JoIjoiOTI1MDAxMDNNQUQ3RjhIMTdEIiwidHlwZSI6IjEifQ.p__oAUSdVdA9inkuqvVYisjfxBIMzxGPkoMDuZ7hy04" }, "msg": "成功", "total": 0 }
| 项目 | 说明内容 | 备注 |
| ------------ | ------------------------------------------------ | -------- |
| 调用方式 | https | POST方式提交 |
| 接口地址 | https://api.fa-piao.com/v5/enterprise/loginDppt | |
| 字符编码 | UTF-8 | |
| 接口描述 | 登录数电发票平台 | 登录电票平台 |
| Content-Type | form-data | |
| 名称 | 类型 | 必须 | 参数描述 |
| -------- | ------ | -- | ------------------------------------------------------------------------------ |
| nsrsbh | String | 是 | 纳税人识别号 |
| username | String | 是 | 用户电票平台账号 |
| password | String | 是 | 用户电票平台密码 |
| sms | String | 否 | 验证码（第一次调用不传验证码，会发送验证码，第二次调用传验证码登录，会返回uuid） |
| sf | String | 否 | 电子税务局身份01:法定代表人，02:财务负责人，03:办税员，05:管理员,08:社保经办人，09:开票员，10:销售人员 |
| ewmlx | String | 否 | 1 税务人脸二维码登录，10 税务 app 扫码登录2 个税人脸二维码登录，3 个税 app 扫码确认登录 |
| ewmid | String | 否 | 第一次调用只传二维码类型(ewmlx)，会返回 ewmid 和二维码的 base64，第二次调用二维码类型跟第一次调用值必须一样，ewmid 使用第一次返回 |
| 示例报文 |
| --------------------------------------------------------------------------------- |
| nsrsbh : 915101820724315989username : 123213123password : 1231241241412421124sms: |
| 响应报文
