Receipts

​

Overview

• Auto-generated for POS sales and completed orders
• Include order details, line items, taxes, and payment info
• Support custom branding and shop information
• Can be emailed to customers
• Stored as PDFs for archival
• Unique receipt numbers for tracking

​

Receipt Types

​

Receipt Model

// Receipt.php:13
protected $fillable = [
    'tenant_id',
    'shop_id',
    'order_id',
    'order_payment_id',
    'customer_id',
    'receipt_number',
    'type',
    'amount',
    'pdf_path',
    'generated_at',
    'emailed_at',
    'emailed_to',
    'generated_by',
];

• Tracking which receipts were emailed and when
• Associating receipts with orders and payments
• Regenerating receipts if needed
• Audit trail of who generated receipts

​

Automatic Receipt Generation

// POSController.php:129
$order = $this->posService->createQuickSale(...);
$this->receiptService->generateOrderReceipt($order);
$receiptUrl = route('receipts.orders.view', $order);

• Printing
• Emailing
• Viewing on screen
• Downloading as PDF

​

Receipt Numbers

// Receipt.php:65
public static function generateReceiptNumber(): string
{
    $prefix = 'REC';
    $date = now()->format('Ymd');
    $lastReceipt = self::where('receipt_number', 'like', "{$prefix}-{$date}-%")
        ->orderBy('id', 'desc')
        ->first();

    $sequence = $lastReceipt
        ? ((int) substr($lastReceipt->receipt_number, -4)) + 1
        : 1;

    return sprintf('%s-%s-%04d', $prefix, $date, $sequence);
}

• Ensures uniqueness
• Makes receipts easy to find by date
• Supports sequential tracking per day
• Prevents collisions during concurrent sales

​

Receipt Contents

​

Header Information

• Shop name and logo
• Shop address and contact info
• Receipt number and date
• Order number
• Cashier/staff name

​

Line Items

// Example receipt line item
$lineItem = [
    'product_name' => $item->productVariant->product->name,
    'variant_name' => $item->productVariant->name,
    'sku' => $item->productVariant->sku,
    'quantity' => $item->quantity,
    'unit_price' => $item->unit_price,
    'discount' => $item->discount_amount,
    'tax' => $item->tax_amount,
    'total' => $item->total_amount,
];

​

Totals Section

• Subtotal
• Discounts
• Tax (itemized by rate if applicable)
• Shipping (if applicable)
• Grand Total

​

Payment Information

// Example payment info
$paymentInfo = [
    'method' => $order->payment_method,
    'amount_paid' => $order->paid_amount,
    'amount_tendered' => $amountTendered, // For cash
    'change' => $change, // For cash
    'reference' => $payment->reference_number,
];

​

Footer Information

• Return policy
• Thank you message
• Shop website/social media
• VAT registration number (if applicable)

​

Viewing Receipts

​

Web View

route('receipts.orders.view', $order)

• Previewing before printing
• Showing customers on screen
• Quick reference without printing

​

PDF Download

route('receipts.orders.download', $order)

• Printer-friendly formatted
• Archived in the database
• Can be emailed as attachments

​

Print View

route('receipts.orders.print', $order)

• Optimized paper size (typically 80mm thermal)
• Minimal margins
• Black and white formatting

​

Emailing Receipts

$receiptService->emailReceipt(
    receipt: $receipt,
    email: $customer->email,
    customerName: $customer->full_name
);

• Attaches PDF receipt
• Customizable email template
• Includes order summary in email body
• Tracks email sent timestamp
• Records recipient email address

// Receipt.php after emailing
$receipt->emailed_at = now();
$receipt->emailed_to = $customer->email;
$receipt->save();

​

Custom Branding

• Logo - Upload shop logo to appear on receipts
• Colors - Customize header colors
• Contact Info - Shop address, phone, email, website
• Return Policy - Custom return policy text
• Footer Message - Custom thank you message

​

Receipt for Cash Payments

// POSService.php:178
if ($paymentMethod === 'cash' && $amountTendered > 0) {
    $change = $amountTendered - $totalAmount;
    $currencySymbol = $shop->currency_symbol ?? '$';
    $paymentNotes = "Cash tendered: {$currencySymbol}".number_format($amountTendered, 2).
                    ", Change: {$currencySymbol}".number_format($change, 2);

    $order->update([
        'internal_notes' => $paymentNotes,
    ]);
}

• Amount tendered
• Change due
• Formatted with shop’s currency symbol

​

Thermal Printer Support

​

Standard Sizes

• 80mm - Most common retail size
• 58mm - Compact mobile printers
• Custom - Configure custom paper width

​

Printer Integration

1. USB - Direct USB connection to POS terminal
2. Network - WiFi or Ethernet network printers
3. Bluetooth - Mobile POS with Bluetooth printers
4. Cloud Print - Cloud-connected printers

​

Print Formatting

• Monospace fonts for alignment
• ASCII art for logos (optional)
• Barcode printing for order numbers
• ESC/POS commands for printer control

​

Receipt Reprinting

​

Receipt Audit Trail

// Track receipt generation
$receipt = Receipt::create([
    'order_id' => $order->id,
    'receipt_number' => Receipt::generateReceiptNumber(),
    'generated_at' => now(),
    'generated_by' => auth()->id(),
]);

// Track email sending
$receipt->update([
    'emailed_at' => now(),
    'emailed_to' => $email,
]);

• When receipt was generated
• Who generated it
• If/when it was emailed
• Who it was emailed to

​

Receipt Storage

$pdfPath = "receipts/{$shop->id}/{$receipt->receipt_number}.pdf";
$receipt->pdf_path = $pdfPath;

• Organized by shop ID
• Named by receipt number
• Stored in secure storage (not publicly accessible)
• Can be served via authenticated routes

​

Digital Receipts

1. Email Only - Send receipt via email, no print
2. SMS - Send receipt link via SMS
3. QR Code - Customer scans QR code to view receipt
4. Customer Portal - Customer accesses receipts in their account

​

VAT/Tax Receipts

• VAT registration number
• Tax breakdown by rate
• Taxable vs non-taxable items
• Tax point (date of supply)

VAT Summary:
VAT @ 15%:     $15.00
VAT @ 0%:      $0.00
Total VAT:     $15.00

VAT Reg: 1234567890

​

Best Practices

​

Troubleshooting

​

Receipt Not Printing

1. Check printer power and paper
2. Verify printer connection (USB/network)
3. Test print from system settings
4. Check print queue for stuck jobs
5. Restart printer and try again

​

Email Not Sending

1. Verify customer email address is correct
2. Check email configuration in settings
3. Look for email in spam/junk folder
4. Check email service logs
5. Verify SMTP credentials

​

Receipt PDF Not Generating

1. Check PDF generation service is running
2. Verify storage permissions
3. Check available disk space
4. Review error logs for PDF library errors

​

Related Resources

• Point of Sale - Receipts are auto-generated for POS sales
• Orders - View receipts for completed orders
• Configuration - Configure receipt branding and layout