yeeraf/laravel-document-numberer

A Laravel package for create document running number

Maintainers

Details

github.com/yeeraf/laravel-document-numberer

Source

Issues

Installs: 38

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 0

Open Issues: 0

v1.3.0 2022-06-07 14:00 UTC

Requires

  • php: ^7.4|^8.0

Requires (Dev)

MIT db91d4c91e8c0988fa0212585fc92d18b821de8b

  • Suphasit <suphasit.s.woop@yeeraf.co.th>

This package is auto-updated.

Last update: 2024-10-07 19:12:08 UTC

README

example workflow

Laravel Document Running Number Generator

แพคเกจ laravel สำหรับการสร้าง เลขที่เอกสาร โดยสร้างสามารถระบุ ตัวอักษร นำหน้า, ต่อท้าย, จำนวนหลักตัวเลข ได้เอง เหมาระกับการใช้กับพวกเอกสารใบแจ้งหนี้ ใบเสร็จรับเงิน หรือเอกสารต่างๆได้ ตัวอย่างเลขที่เอกสาร

  • INV-000001
  • INV2101-0001
  • REC-0000001
  • QT #####1

การติดตั้ง

composer require yeeraf/laravel-document-numberer

หลังจากติดตั้งแล้วจะต้องทำการ run คำสั่ง migration สำหรับสร้าง table document_numbers เพื่อเก็บข้อมูลการสร้างเลขที่เอกสาร

php artisan migrate

ตัวอย่างการใข้งาน

$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->generate();

โดยค่าเริ่มต้น เลขที่เอกสารจะเป็น

นำหน้าด้วย ปีปัจจุบัน 2 digit และ เดือนปัจจุบัน 2 digit เข่น ถ้าวันนี้วันที่ 20/07/2021 เลขนำหน้าเอกสารจะเป็น 2107000001

ความยาวของ running number จะเป็น 6 หลัก เริ่มต้องด้วย 1 เช่น 2107000001

กรณีต้องการให้เลขที่เอกสาร 2 ประเภทมี format เดียวกัน แต่ต้องการให้ running แยกกัน เข่น

เลขใบแจ้งหนี้ เริ่มที่ 2107000001, 2107000002, 2107000003, ...

เลขใบเสร็จรับเงิน เริ่มที่ 2107000001, 2107000002, 2107000003, ...

ระบบสามารถแยกประเภทได้ดังนี้

// ใบแจ้งหนี้
$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->name("invoice")->generate();
// ใบเสร็จรับเงิน
$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->name("receipt")->generate();

กรณีต้องการเปลี่ยน การสร้างเลขที่เอกสาร เช่น ต้องการ

  • นำหน้าด้วย INV-
  • มี running number 3 หลัก
  • เปลี่ยน padding string จาก 0 -> #
  • ท้ายด้วย -X

ตัวอย่าง INV-##1-X

$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer
                ->prefix("INV-")
                ->padLength(3)
                ->padString("#")
                ->suffix("-X")
                ->generate();

License

The MIT License (MIT)