PHP 怎么应收账款

wen PHP项目 2026-08-02 1

本文目录导读：

PHP 怎么应收账款

数据库设计（核心基础）
PHP 核心代码逻辑
涉及的核心函数与工具
进阶考虑（如果你是在做 ERP/财务系统）
如果你是问“如何用 PHP 调用外部 API 查应收账款”

在 PHP 中开发“应收账款”模块，通常不是指一个单一的函数，而是指一套完整的业务逻辑，它通常与数据库、客户管理、发票和支付记录紧密相关。

如果你是想用 PHP 实现应收账款的追踪和管理,可以按照以下层次来设计和实现：

数据库设计（核心基础）

你需要建立两张或多张数据表来存储数据。

表结构示例（MySQL）：

customers（客户表）：id, name, contact, phone...
invoices（发票/账单表）：id, invoice_no, customer_id, total_amount（总金额）, issued_at（开票日期）, due_at（到期日）, status（unpaid, partial, paid）
payments（收款记录表）：id, invoice_id, amount（收款金额）, paid_at（收款日期）, method（支付方式）

PHP 核心代码逻辑

这部分是业务逻辑的主体，重点在于如何计算未结清的余额。

场景 A：获取所有客户的应收账款余额

这是最常用的功能,用于生成财务报表。

<?php
// 假设 $pdo 是你的数据库连接实例 (PDO)
// SQL 查询：计算每个客户的未结清总额
$sql = "
    SELECT 
        c.id,
        c.name,
        COALESCE(i.total_billed, 0) AS total_billed, -- 总开票金额
        COALESCE(p.total_paid, 0) AS total_paid,    -- 总收款金额
        (COALESCE(i.total_billed, 0) - COALESCE(p.total_paid, 0)) AS balance -- 应收账款余额
    FROM customers c
    LEFT JOIN (
        SELECT customer_id, SUM(total_amount) AS total_billed
        FROM invoices
        WHERE status != 'cancelled'
        GROUP BY customer_id
    ) i ON c.id = i.customer_id
    LEFT JOIN (
        SELECT i.customer_id, SUM(p.amount) AS total_paid
        FROM payments p
        LEFT JOIN invoices i ON p.invoice_id = i.id
        GROUP BY i.customer_id
    ) p ON c.id = p.customer_id
    HAVING balance > 0 -- 只显示有欠款的客户
    ORDER BY balance DESC
";
$stmt = $pdo->query($sql);
$results = $stmt->fetchAll(PDO::FETCH_ASSOC);
// 输出示例
foreach ($results as $row) {
    echo $row['name'] . ' 欠款: ' . $row['balance'] . PHP_EOL;
}
?>

场景 B：记录一笔收款（更新应收账款）

当客户还款时，你需要更新支付记录,并可能需要更新发票状态。

<?php
// 伪代码：处理支付
function recordPayment(PDO $pdo, int $invoiceId, float $amount) {
    // 1. 开启事务，防止数据不一致
    $pdo->beginTransaction();
    try {
        // 2. 插入支付记录
        $sql = "INSERT INTO payments (invoice_id, amount, paid_at) VALUES (?, ?, NOW())";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([$invoiceId, $amount]);
        // 3. 查询该发票的已支付总额
        $sql = "SELECT COALESCE(SUM(amount), 0) AS paid FROM payments WHERE invoice_id = ?";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([$invoiceId]);
        $paid = $stmt->fetch(PDO::FETCH_ASSOC)['paid'];
        // 4. 查询发票的总金额
        $sql = "SELECT total_amount FROM invoices WHERE id = ?";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([$invoiceId]);
        $total = $stmt->fetch(PDO::FETCH_ASSOC)['total_amount'];
        // 5. 更新发票状态（未付/部分付/已付）
        if ($paid >= $total) {
            $status = 'paid';
        } elseif ($paid > 0) {
            $status = 'partial';
        } else {
            $status = 'unpaid';
        }
        $sql = "UPDATE invoices SET status = ? WHERE id = ?";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([$status, $invoiceId]);
        // 6. 提交事务
        $pdo->commit();
        return ['success' => true, 'new_status' => $status];
    } catch (Exception $e) {
        // 回滚事务
        $pdo->rollBack();
        return ['success' => false, 'error' => $e->getMessage()];
    }
}
// 使用示例
// recordPayment($pdo, 123, 500.00);
?>

涉及的核心函数与工具

在实际开发中，你通常会建立 Class（类） 来封装这些功能，AccountsReceivable 或 Invoice 类。

createInvoice($customerId, $amount, $dueDate)：生成新应收款。
applyPayment($invoiceId, $amount)：登记收款（如上面的例子）。
getOutstandingBalance($customerId)：获取单客户欠款。
getAgingReport()：生成账龄分析表（0-30天，31-60天，61天以上）。

账龄分析（Aging）的实现思路：

// 使用 SQL CASE WHEN 按时间分组
$sql = "
    SELECT 
        i.invoice_no,
        c.name,
        i.total_amount,
        DATEDIFF(NOW(), i.due_at) AS days_overdue,
        CASE 
            WHEN DATEDIFF(NOW(), i.due_at) < 0 THEN '未到期'
            WHEN DATEDIFF(NOW(), i.due_at) <= 30 THEN '0-30天'
            WHEN DATEDIFF(NOW(), i.due_at) <= 60 THEN '31-60天'
            ELSE '60天以上'
        END AS period
    FROM invoices i
    LEFT JOIN customers c ON i.customer_id = c.id
    WHERE i.status != 'paid'
    ORDER BY days_overdue DESC
";

进阶考虑（如果你是在做 ERP/财务系统）

货币与精度：使用 decimal 类型存储金额，PHP 中用 float 计算时需注意精度问题（可改用 number_format 或 bcmath 扩展）。
多币种：需要增加汇率字段。
坏账准备：如果某些账款长期无法收回，需要将其标记为 bad_debt 并从当前应收中扣除。
审批流程：也许你还需要设计“开票必须经过 X 审批”的逻辑。

如果你是问“如何用 PHP 调用外部 API 查应收账款”

如果你是想对接第三方平台（如支付宝、招银云直连，或者其他 SaaS 系统）查询账款数据,逻辑通常是：

// 以对接 REST API 为例
$token = getAccessToken(); // 获取令牌
$response = file_get_contents(
    'https://api.example.com/v1/receivables',
    false,
    stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => "Authorization: Bearer {$token}\r\n"
        ]
    ])
);
$data = json_decode($response, true);
print_r($data['balance']);

在 PHP 中处理应收账款归根结底是 在 SQL 层面对金额进行求和（SUM）和减法（差值），再通过 PHP 进行业务流程控制（如状态更新、事务处理），如果你是想实现更具体的某个功能（比如打印回单、生成 Excel 报表），可以把问题更具体地描述一下,我可以为你提供对应的代码片段。