#Invoices

#Overview

Invoices represent billing documents generated from Orders. An invoice contains line items and tracks payment status including amount due, amount paid, and full payment date. Invoices support integration with external accounting systems like Xero.

Model: VentureDrake\LaravelCrm\Models\Invoice Table: {prefix}invoices (default: crm_invoices)

#Attributes

Note: All money fields are stored in cents. The amount_due accessor returns total if no explicit value is set.

#Computed Attributes

#title

Returns a formatted title with the monetary total and organisation/person name.

$invoice->title; // "$1,500.00 - Acme Corp"

#Relationships

#Public Portal

Invoices have a public-facing portal page accessible at /p/invoices/{external_id}. This allows recipients to view invoices without needing a CRM login.

#PDF Generation

Invoices can be exported as PDF documents using barryvdh/laravel-dompdf.

#Creating an Invoice

use VentureDrake\LaravelCrm\Models\Invoice;

$invoice = Invoice::create([
    'currency' => 'USD',
    'subtotal' => 10000,
    'tax' => 1000,
    'total' => 11000,
    'issue_date' => '2026-01-15',
    'due_date' => '2026-02-15',
    'order_id' => $order->id,
    'person_id' => $person->id,
    'organisation_id' => $organisation->id,
    'user_owner_id' => auth()->id(),
]);

#Searching & Filtering

Searchable by reference, invoice_id, and associated person/organisation names. Filterable by user_owner_id and labels.id.

#Traits