Laravel收到账单PDF后,先确认提取字段,再写入业务表

Laravel账单字段确认:先确认,再入库

账单PDF识别出金额后,不应立即写入正式业务表。先把候选字段和原文件放在一起确认,能避免将缺失日期、零折扣或错误金额静默带入系统。

本例用教学账单BILL-271,金额135.60元、折扣0.00、到期日未填写。

解析结果与候选字段分开

先用ComPDF全文解析接口取得实际输出。本次JSON包含正文和表格;应用再针对这个教学模板提取金额与折扣。不要把应用的正则映射说成接口已经直接返回了账单业务对象。

本次实际解析结果的相关部分如下,只省略了坐标和其他内容,没有把字段改成自定义业务对象。可先保存为invoice.json,复现候选映射与确认测试:

{
  "result": {
    "pages": [
      {
        "page_id": 1,
        "structured": [
          {
            "type": "paragraph_title",
            "text": "## 教学账单 BILL-271"
          },
          {
            "type": "text",
            "text": "供应商:教学服务方。账单号:BILL-271。实付金额:135.60。币种:CNY。折扣金额:0.00。到期日未填写。"
          }
        ]
      }
    ]
  }
}

在本地运行完整确认示例

准备PHP 8.4.1以上及Laravel正常扩展,尤其是mbstring与PDO SQLite。新建空目录,保存以下composer.json:

{"require":{"php":"^8.4.1","laravel/framework":"12.69.3"}}
composer install
mkdir -p bootstrap/cache storage/framework/views storage/logs

把下面完整程序保存为review-check.php。第二个参数是原文件,只用于生成本地去重测试的文件哈希;复现应用测试时可以用自己的小型PDF作为输入,但不能据此声称其内容已经被解析。

<?php
use Illuminate\Foundation\Application;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\ValidationException;
require __DIR__.'/vendor/autoload.php';
try {
$app=Application::configure(basePath: __DIR__)->create();$app->make(Kernel::class)->bootstrap();
$app['config']->set('database.default','sqlite');
$app['config']->set('database.connections.sqlite',['driver'=>'sqlite','database'=>':memory:','prefix'=>'']);
DB::statement('CREATE TABLE reviewed (id INTEGER PRIMARY KEY, source_hash TEXT UNIQUE NOT NULL, amount TEXT NOT NULL, discount TEXT NOT NULL, due_date TEXT NULL)');
// These candidates are mapped by the application from this teaching sample's parsed text.
$parsed=json_decode(file_get_contents($argv[1]),true,512,JSON_THROW_ON_ERROR);
$text=implode("\n",array_column($parsed['result']['pages'][0]['structured'],'text'));
if(!preg_match('/实付金额:([0-9.]+)/u',$text,$a)||!preg_match('/折扣金额:([0-9.]+)/u',$text,$b))throw new RuntimeException('Missing expected fields');
$candidate=['amount'=>$a[1],'discount'=>$b[1],'due_date'=>null];
$hash=hash_file('sha256',$argv[2]);
function confirm(array $input,string $hash):int {
 $v=Validator::make($input,['amount'=>['required','regex:/^\d+\.\d{2}$/'],'discount'=>['required','regex:/^\d+\.\d{2}$/'],'due_date'=>['nullable','date_format:Y-m-d']])->validate();
 return DB::transaction(function()use($hash,$v){
  $old=DB::table('reviewed')->where('source_hash',$hash)->first();
  if($old)return (int)$old->id;
  return DB::table('reviewed')->insertGetId(['source_hash'=>$hash,'amount'=>$v['amount'],'discount'=>$v['discount'],'due_date'=>$v['due_date']??null]);
 });
}
$before=DB::table('reviewed')->count();$first=confirm($candidate,$hash);$again=confirm($candidate,$hash);
$checks=['nothing_saved_before_confirmation'=>$before===0,'duplicate_confirmation_same_record'=>$first===$again&&DB::table('reviewed')->count()===1,'zero_discount_preserved'=>DB::table('reviewed')->first()->discount==='0.00','missing_date_stays_null'=>DB::table('reviewed')->first()->due_date===null];
try{confirm(['amount'=>'not-a-number','discount'=>'0.00'],'other');$checks['invalid_amount_rejected']=false;}catch(ValidationException $e){$checks['invalid_amount_rejected']=true;}
if(in_array(false,$checks,true))throw new RuntimeException('Review test failed');
echo json_encode(['php'=>PHP_VERSION,'laravel'=>$app->version(),'candidate'=>$candidate,'checks'=>$checks],JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE).PHP_EOL;

} catch (Throwable $e) { fwrite(STDERR, get_class($e).': '.$e->getMessage().PHP_EOL); exit(1); }
php review-check.php invoice.json input.pdf

这一步使用正文中的实际解析片段,不重新调用ComPDF API。先观察候选为135.60、0.00、null,再看五项检查是否全部为true。它验证的是应用确认层,不代表你新放入的PDF已得到同样的识别结果。

接入自己的账单时,应先调用全文解析接口,取回并解压真正的结果,再以该PDF及其结果成对运行。这个模板使用中文标签匹配金额,换模板后必须调整映射与缺项处理;匹配不到就停止,不能用默认零值补齐。

确认后才进入事务

金额用带两位小数的字符串校验,本例存储也用字符串;生产表可以选择适当的定点类型。不要先转成浮点数再计算。

$validated = Validator::make($input, [
    'amount' => ['required', 'regex:/^\d+\.\d{2}$/'],
    'discount' => ['required', 'regex:/^\d+\.\d{2}$/'],
    'due_date' => ['nullable', 'date_format:Y-m-d'],
])->validate();

0.00是明确的零值,未填写的到期日保持null。确认接口还应使用应用既有的登录、权限和CSRF保护;教学CLI没有替代这些入口控制。

原文值、候选字段与确认要求逐项对应;依据实际解析及Laravel测试整理,非产品界面

图:原文值、候选字段与确认要求逐项对应;依据实际解析及Laravel测试整理,非产品界面

确认界面应让人核对什么

只显示两个输入框,确认人员仍不知道它们从哪里来。界面至少把原页、原文标签、币种、候选值和修改后值放在一起;缺失日期显示“原件未提供”,不要预填今天。存储时保留原解析片段与确认记录,人工补充的日期标记为人工输入。

例如折扣0.00是明确数字,不能用PHP的empty()把它和空字符串、null混为一谈。金额校验通过只说明格式正确,仍需核对该字段是否对应实付金额,以及币种、业务期间和单据编号。

重复确认不要重复建记录

教学表对源文件哈希设置唯一约束,同一文件再次确认返回已有记录。正式应用还应加上租户范围和业务版本规则;文件内容相同并不总表示业务操作相同。

确认写入放在事务内,并记录原始解析结果与人工修改,不覆盖原件。示例只覆盖顺序重复确认,不用它证明并发请求已经处理完善。

验收读回的数据

本次PHP 8.4.27、Laravel 12.69.3检查通过:确认前没有记录、重复确认只有一条、折扣仍是0.00、日期仍为空、非法金额被拒绝。框架检查与ComPDF解析结果要分别保存,便于定位问题。

后续需要多模板、分类或更完整处理流程时,可评估DocSlight。本例没有测试DocSlight企业功能,也没有作财务合规或全自动入账承诺。

本作品采用《CC 协议》,转载必须注明作者和本文链接
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!
未填写
文章
42
粉丝
2
喜欢
7
收藏
9
排名:1377
访问:2875
私信
所有博文
社区赞助商