Deliveries

Overview

Deliveries track the physical shipment of goods from an Order. Each delivery contains delivery products that reference order line items, allowing partial deliveries and tracking of fulfillment status.

Model: VentureDrake\LaravelCrm\Models\Delivery Table: {prefix}deliveries (default: crm_deliveries)

Attributes

Attribute	Type	Description
`external_id`	`string`	UUID used in URLs (auto-generated)
`delivery_id`	`string`	Delivery identifier
`reference`	`string`	External reference
`description`	`text`	Description
`delivery_expected`	`date`	Expected delivery date
`delivered_on`	`date`	Actual delivery date
`order_id`	`integer`	Source order
`user_owner_id`	`integer`	Owner user
`user_assigned_id`	`integer`	Assigned user

Relationships

Method	Type	Related Model	Description
`order()`	`belongsTo`	`Order`	Source order
`deliveryProducts()`	`hasMany`	`DeliveryProduct`	Line items
`addresses()`	`morphMany`	`Address`	Shipping addresses
`ownerUser()`	`belongsTo`	`User`	Owner
`assignedToUser()`	`belongsTo`	`User`	Assigned user

Helper Methods

getShippingAddress()

Returns the shipping address (address type 6).

$address = $delivery->getShippingAddress();

Computed Attributes

title

Returns the order total and client/organisation name.

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

Line Items

Model: VentureDrake\LaravelCrm\Models\DeliveryProduct Table: {prefix}delivery_products (default: crm_delivery_products)

Reached from the delivery via deliveryProducts().

Attribute	Type	Description
`external_id`	`string`	UUID
`order_product_id`	`integer`	The order line this delivery draws down
`quantity`	`decimal(15,3)`	Quantity delivered, to at most 3 decimal places
`order`	`integer`	Position of the line on the document

A delivery line references an order line rather than a product directly, which is what makes partial deliveries possible.

Note: quantity is decimal(15,3), so a delivery can record 3.5 Kg or 0.25 L. The HasDecimalQuantity trait casts it, which means $line->quantity reads back as a PHP float.

The quantity control on the Order → Delivery form is a bounded number input, and the cap is enforced server-side: on submit the remainder is recomputed from the order line and the deliveries already raised against it. The delivery form previously ran no quantity validation at all.

PDF Generation

Deliveries are exported as PDF documents through barryvdh/laravel-dompdf, rendered with one of the five shipped PDF Templates.

The template is resolved per record: the delivery's own pdf_template column when set, otherwise the default chosen for delivery under Settings → Templates, otherwise a PDF view the host has published and customised, otherwise modern. A PDF template select on the delivery create and edit form pins a template to the record; leaving it blank follows the Settings default.

Creating a Delivery

use VentureDrake\LaravelCrm\Models\Delivery;

$delivery = Delivery::create([
    'order_id' => $order->id,
    'delivery_expected' => '2026-02-01',
    'user_owner_id' => auth()->id(),
]);

Searching & Filtering

Searchable by reference, delivery_id, and associated person/organisation names.

Traits

Trait	Description
`SoftDeletes`	Soft delete support
`BelongsToTeams`	Multi-tenant team scoping
`SearchFilters`	Search and filter capabilities
`HasCrmActivities`	Activity timeline tracking
`HasGlobalSettings`	Global settings access

Reference

#Deliveries

#Overview

#Attributes

#Relationships

#Helper Methods

#getShippingAddress()

#Computed Attributes

#title

#Line Items

#PDF Generation

#Creating a Delivery

#Searching & Filtering

#Traits