tax/invoice

发票SDK php 数电发票/电子发票/数电票/全电发票/开票

1.0.10 2025-05-08 15:21 UTC

Requires

• php: >=7.0
• ext-json: *
• guzzlehttp/guzzle: ^7.0

MIT

• YueJiangHe

README

发票 php SDK 专为电子发票、数电发票（全电发票）场景设计，支持开票、红冲、版式文件下载等核心功能，快速对接税务平台API。

关键词: 电子发票SDK,数电票php,开票接口,发票api,发票开具,发票红冲,全电发票集成

📖 核心功能

基础认证

• ✅ 获取授权 - 快速接入税务平台身份认证
• ✅ 人脸二维码登录 - 支持数电发票平台扫码登录
• ✅ 认证状态查询 - 实时获取纳税人身份状态

发票开具

• 🟦 数电蓝票开具 - 支持增值税普通/专用电子发票
• 📄 版式文件下载 - 自动获取销项发票PDF/OFD/XML文件

发票红冲

• 🔍 红冲前蓝票查询 - 精确检索待红冲的电子发票
• 🛑 红字信息表申请 - 生成红冲凭证
• 🔄 负数发票开具 - 自动化红冲流程

🚀 快速安装

通过Composer安装:

composer require tax/invoice

📦 查看Packagist最新版本

📚 查看完整中文文档 | 💡 更多示例代码

🔍 为什么选择此SDK？

• 精准覆盖中国数电发票标准 - 严格遵循国家最新接口规范
• 开箱即用 - 无需处理XML/签名等底层细节，专注业务逻辑
• 企业级验证 - 已在生产环境处理超100万张电子发票

📊 支持的开票类型

发票类型	状态
数电发票（普通发票）	✅ 支持
数电发票（增值税专用发票）	✅ 支持
数电发票（铁路电子客票）	✅ 支持
数电发票（航空运输电子客票行程单）	✅ 支持
数电票（二手车销售统一发票）	✅ 支持
数电纸质发票（增值税专用发票）	✅ 支持
数电纸质发票（普通发票）	✅ 支持
数电纸质发票（机动车发票）	✅ 支持
数电纸质发票（二手车发票）	✅ 支持

🤝 贡献与支持

• 提交Issue: 问题反馈
• 商务合作: [e-mail]

use Tax\Invoice\Client;
use Tax\Invoice\InvoiceFactory;
use Tax\Invoice\Constants;
use Tax\Invoice\Utils;

// 配置信息
$appKey = 'YOUR_APP_KEY';
$appSecret = 'YOUR_APP_SECRET';

$nsrsbh = '91500112MADFAQ9xxx'; // 统一社会信用代码
$title = "重庆悦江河科技有限公司";//名称（营业执照）
$username = "1912284xxxx";//手机号码（电子税务局）
$password = "";//个人用户密码（电子税务局）
$sf = "01";//身份（电子税务局）
$fphm = "24502000000045823936";
$kprq = "";
$token = "";


try {
    // 创建客户端
    $client = new Client($appKey, $appSecret);
    
    // 获取授权
    if ($token) {
        $client->setToken($token);
    }else{
        $authResult = $client->getAuthorization($nsrsbh);
        if ($authResult['code'] == 200) {
            $token = $authResult['data']['token'];
            $client->setToken($token);
            echo "授权成功，Token: " . $token . PHP_EOL;
        } else {
            echo "授权失败: " . $authResult['msg'] . PHP_EOL;
            exit;
        }
    }
  


    $loginResult = $client->queryFaceAuthState($nsrsbh, $username);
    switch ($loginResult['code']) {
        case 200:
            echo "可以开发票了\n";
             // 税额计算
             $amount = 200;
             $taxRate = 0.01;
             $isIncludeTax = false; // 是否含税
             $se = Utils::calculateTax($amount, $taxRate, $isIncludeTax);
             
             echo "价税合计：" . $amount . "\n";
             echo "税率：" . $taxRate . "\n";
             echo "合计金额：" . ($amount - floatval($se)) . "\n";
             echo ($isIncludeTax ? "含税" : "不含税") . " 合计税额：" . $se . "\n";
            
            // 授信额度查询
            $creditLimitResponse = $client->queryCredit($nsrsbh,$username);
            if ($creditLimitResponse['code'] == 200) {
                print_r($creditLimitResponse['data']);
            }

            // 开具蓝票
            $invoiceParams = [
                'fpqqlsh' => $appKey . time(),
                'fplxdm' => '82',
                'kplx' => '0',
                'xhdwsbh' => $nsrsbh,
                'xhdwmc' => '重庆悦江河科技有限公司',
                'xhdwdzdh' => '重庆市渝北区仙桃街道汇业街1号17-2 19122840xxxx',
                'xhdwyhzh' => '中国工商银行 310008670920023xxxx',
                'ghdwmc' => '个人',
                'zsfs' => '0',
                'fyxm' => [
                    [
                        'fphxz' => '0',
                        'spmc' => '*信息技术服务*软件开发服务',
                        'je' => '10',
                        'sl' => '0.01',
                        'se' => '0.1',
                        'hsbz' => '1',
                        'spbm' => '3040201010000000000'
                    ]
                ],
                'hjje' => '9.9',
                'hjse' => '0.1',
                'jshj' => '10'
            ];

            $invoiceResponse = $client->blueTicket($invoiceParams);
            echo $invoiceResponse['code'] . " 开票结果: " . $invoiceResponse['msg'] . "\n";

            if ($invoiceResponse['code'] == 200) {
                $fphm = $invoiceResponse['data']['Fphm'];
                $kprq = $invoiceResponse['data']['Kprq'];
                echo "发票号码: " . $fphm . "\n";
                echo "开票日期: " . $invoiceResponse['data']['Kprq'] . "\n";
            }

            // 下载发票
                $pdfResponse = $client->getPdfOfdXml($nsrsbh,$fphm,'4',$kprq,$username);
                if ($pdfResponse['code'] == 200) {
                    print_r($pdfResponse['data']);
                }
            break;
        case 420:
            echo "登录(短信认证)\n";
            
            // // 1. 发短信验证码
            // $loginResponse = $client->loginDppt($nsrsbh, $username, $password, "");
            // if ($loginResponse['code'] == 200) {
            //     echo $loginResponse['msg'] . "\n";
            //     echo "请" . $username . "接收验证码\n";
            //     sleep(60); // 等待60秒
            // }

            // // 2. 输入验证码
            // echo "请输入验证码\n";
            // $smsCode = ""; // 这里应该获取用户输入的验证码
            // $loginResponse2 = $client->loginDppt($nsrsbh, $username, $password, $smsCode);
            // if ($loginResponse2['code'] == 200) {
            //     echo $loginResponse2['data'] . "\n";
            //     echo "验证成功\n";
            // }
            break;
        case 430:
            echo "人脸认证\n";
            // 1. 获取人脸二维码
            $qrCodeResponse = $client->getFaceImg($nsrsbh, $username, "1");
            echo "二维码: " . print_r($qrCodeResponse['data'], true) . "\n";
            
            switch ($qrCodeResponse['data']['ewmlyx']) {
                case 'swj':
                    echo "请使用税务局app扫码\n";
                    break;
                case 'grsds':
                    echo "个人所得税app扫码\n";
                    break;
            }

            // 2. 认证完成后获取人脸二维码认证状态
            $rzid = $qrCodeResponse['data']['rzid'];
            $faceStatusResponse = $client->getFaceState($nsrsbh, $rzid, $username, "1");
            echo "code: " . $faceStatusResponse['code'] . "\n";
            echo "data: " . print_r($faceStatusResponse['data'], true) . "\n";
            
            if ($faceStatusResponse['data'] != null) {
                switch ($faceStatusResponse['data']['slzt']) {
                    case '1':
                        echo "未认证\n";
                        break;
                    case '2':
                        echo "成功\n";
                        break;
                    case '3':
                        echo "二维码过期-->重新获取人脸二维码\n";
                        break;
                }
            }
            break;
        case 401:
            echo $statusResponse['code'] . "授权失败:" . $statusResponse['msg'] . "\n";
            break;
        default:
            echo $statusResponse['code'] . " " . $statusResponse['msg'] . "\n";
            break;
    }
} catch (InvoiceException $e) {
    echo "错误: [" . $e->getErrorCode() . "] " . $e->getMessage() . "\n";
} catch (\Exception $e) {
    echo "系统错误: " . $e->getMessage() . "\n";
}

发票红冲demo