怎样在PHP项目中实现电子发票？

wen java案例 2026-07-21 160

PHP项目集成电子发票功能的实战指南

📖 目录导读

电子发票核心概念与行业标准
PHP项目接入电子发票的三种主流方案
使用第三方API接口（推荐）
本地生成合规PDF发票
对接税务平台直连
代码实战：完整发票生成与存储流程
安全与合规性关键点
常见问题与问答（FAQ）
总结与延伸阅读

电子发票核心概念与行业标准

电子发票并非简单的PDF文件,它必须符合国家税务部门的技术规范，电子发票需要包含：

怎样在PHP项目中实现电子发票？

发票代码、发票号码
开票日期、校验码
购买方/销售方税号、名称
商品明细（含税收分类编码）
价税合计金额
税务数字签名（通过税控设备或第三方平台生成）

技术标准：目前主流遵循《电子发票技术规范》（GB/T 24589）以及各省税务局接口规范，PHP开发者需重点理解JSON/XML数据格式与签名算法。

PHP项目接入电子发票的三种主流方案

方案类型	适用场景	开发成本	合规性
第三方API	中小企业、SaaS平台	低	高（平台托管）
本地生成	高定制化需求	高	需对接税控设备
直连税务	大型企业、自建系统	极高	完全自主

核心结论：90%的PHP项目推荐使用第三方API方案，原因在于税控设备管理、税务签名算法复杂度高，自研成本远超想象。

方案一：使用第三方API接口（推荐）

1 主流服务商选择

微信支付/支付宝发票助手：适合电商场景，费率低
百望云、票通、发票通：专业税务服务商，接口标准
用友、金蝶：ERP集成场景

2 PHP集成步骤（以百望云为例）

// 1. 安装HTTP客户端（Guzzle）
composer require guzzlehttp/guzzle
// 2. 发票开具请求
function createInvoice($orderData) {
    $client = new \GuzzleHttp\Client();
    $response = $client->post('https://sandbox.bwcloud.cn/v2/invoice', [
        'headers' => [
            'Authorization' => 'Bearer YOUR_ACCESS_TOKEN',
            'Content-Type' => 'application/json'
        ],
        'json' => [
            'sellerTaxNo' => '91110108MA018...',
            'buyerTaxNo' => $orderData['buyer_tax_no'],
            'items' => $orderData['items'],
            'totalAmount' => $orderData['total']
        ]
    ]);
    return json_decode($response->getBody(), true);
}

3 关键注意事项

测试环境：务必使用沙箱环境调试，避免误开发票
异步回调：发票生成通常需1-3秒，建议使用Webhook接收结果
失败重试：网络波动导致失败，需设计重试机制（指数退避）

方案二：本地生成合规PDF发票

1 必要组件

TCPDF/FPDF：PHP生成PDF库
税务签名库：需购买税控设备（如UKey）或获取数字证书
二维码生成：添加发票查验二维码

2 生成流程

// 伪代码示例：生成PDF发票
$pdf = new TCPDF();
$pdf->AddPage();
$pdf->SetFont('cid0cs', '', 12);
// 填充发票表格
$pdf->writeHTML($htmlContent);
// 添加税务数字签名（需调用税控接口）
$signature = taxSign($invoiceData);
$pdf->addSignature($signature);
// 添加查验二维码
$qrCode = generateQRCode($invoiceNumber);
$pdf->Image($qrCode, 180, 260, 20, 20);
$pdf->Output('invoice_'.$invoiceNumber.'.pdf', 'I');

3 风险提示

签名合规风险：税务签名算法不断更新，需持续维护
性能瓶颈：PDF生成+签名+二维码生成，单张耗时约0.5s
硬件依赖：税控UKey需物理连接服务器，不适合云部署

方案三：对接税务平台直连

1 前置条件

申请电子发票服务平台（如国家税务总局的电子发票系统）
获取税控设备加密卡/USBKey
部署税务安全中间件（通常为Java/C#组件，PHP需通过Socket/HTTP调用）

2 PHP调用示例（通过Socket连接税控中间件）

$socket = fsockopen("127.0.0.1", 8090, $errno, $errstr, 30);
$command = json_encode([
    'type' => 'invoice_send',
    'data' => [...]
]);
fwrite($socket, $command);
$response = fread($socket, 4096);
fclose($socket);

3 适用企业

年开票量 > 10万张
有专职税务IT团队
需要完全自主控制数据安全

代码实战：完整发票生成与存储流程

1 数据库设计

CREATE TABLE `invoices` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `order_id` varchar(64) NOT NULL,
  `invoice_code` varchar(20) DEFAULT NULL,
  `invoice_number` varchar(20) DEFAULT NULL,
  `pdf_url` varchar(255) DEFAULT NULL,
  `status` tinyint(4) DEFAULT '0' COMMENT '0待开票 1开票中 2完成 3失败',
  `error_msg` text,
  `created_at` datetime DEFAULT NULL,
  `updated_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_order` (`order_id`)
);

2 业务代码

class InvoiceService {
    public function issueInvoice($orderId) {
        // 1. 状态检查
        $existing = Invoice::where('order_id', $orderId)->first();
        if ($existing && $existing->status === 2) {
            throw new \Exception('该订单已开票');
        }
        // 2. 创建发票记录
        $invoice = Invoice::create([
            'order_id' => $orderId,
            'status' => 1 // 开票中
        ]);
        // 3. 调用第三方API（异步）
        Queue::push(new IssueInvoiceJob($invoice->id));
        return $invoice;
    }
    // 回调处理（Webhook）
    public function handleWebhook($data) {
        $invoice = Invoice::where('invoice_number', $data['invoice_no'])->first();
        if ($data['status'] === 'success') {
            $invoice->update([
                'status' => 2,
                'invoice_code' => $data['code'],
                'pdf_url' => $data['pdf_url']
            ]);
        } else {
            $invoice->update([
                'status' => 3,
                'error_msg' => $data['message']
            ]);
        }
    }
}

安全与合规性关键点

1 数据安全红线

税号保护：企业税号等同身份证号，需加密存储（AES-256）
签名隔离：税务数字证书文件不得随代码仓库传输
日志审计：所有开票、作废操作需记录IP、时间、操作人

2 合规检查清单

[ ] 发票内容必须包含税收分类编码（通过API校验）
[ ] 金额精度保留两位小数（四舍五入）
[ ] 购买方税号校验（统一社会信用代码规则）
[ ] 开票红冲（负数发票）需保留原发票关联

常见问题与问答（FAQ）

❓ Q1：PHP能否直接生成税务要求的二维码？

答：可以生成，但二维码内容必须包含特定格式（如发票代码+号码+校验码+金额+开票日期），且需通过国税总局查验接口验证，建议直接使用第三方API提供的二维码数据。

❓ Q2：开票频率过高是否有限制？

答：第三方平台通常有限流（如100次/秒），对于高并发场景建议：

使用消息队列（RabbitMQ/Redis）缓冲
增加API key（多key轮询）
提前预审发票数据,减少无效请求

❓ Q3：电子发票如何作废？

答：电子发票不支持物理作废，只能开具红字发票（负数发票），代码实现：

function voidInvoice($originalInvoiceNo) {
    // 调用API，传入原发票号码
    $client->post('/v2/invoice/void', [
        'original_no' => $originalInvoiceNo
    ]);
}