Struct Shipment 

pub struct Shipment {

    pub id: ShipmentId,
    pub shipment_number: String,
    pub order_id: OrderId,
    pub status: ShipmentStatus,
    pub carrier: ShippingCarrier,
    pub shipping_method: ShippingMethod,
    pub tracking_number: Option<String>,
    pub tracking_url: Option<String>,
    pub recipient_name: String,
    pub recipient_email: Option<String>,
    pub recipient_phone: Option<String>,
    pub shipping_address: String,
    pub weight_kg: Option<Decimal>,
    pub dimensions: Option<String>,
    pub shipping_cost: Option<Decimal>,
    pub insurance_amount: Option<Decimal>,
    pub signature_required: bool,
    pub shipped_at: Option<DateTime<Utc>>,
    pub estimated_delivery: Option<DateTime<Utc>>,
    pub delivered_at: Option<DateTime<Utc>>,
    pub notes: Option<String>,
    pub items: Vec<ShipmentItem>,
    pub events: Vec<ShipmentEvent>,
    pub version: i32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

A shipment tracks the physical delivery of items from an order

Fields

id: ShipmentId

Unique identifier

shipment_number: String

Human-readable shipment number (e.g., “SHP-ABC123”)

order_id: OrderId

Order this shipment belongs to

status: ShipmentStatus

Current status

carrier: ShippingCarrier

Shipping carrier

shipping_method: ShippingMethod

Shipping method/speed

tracking_number: Option<String>

Carrier tracking number

tracking_url: Option<String>

Auto-generated tracking URL

recipient_name: String

Recipient name

recipient_email: Option<String>

Recipient email for notifications

recipient_phone: Option<String>

Recipient phone

shipping_address: String

Full shipping address

weight_kg: Option<Decimal>

Package weight in kg

dimensions: Option<String>

Package dimensions (e.g., “10x8x6 cm”)

shipping_cost: Option<Decimal>

Shipping cost

insurance_amount: Option<Decimal>

Insurance amount

signature_required: bool

Whether signature is required on delivery

shipped_at: Option<DateTime<Utc>>

When the shipment was handed to carrier

estimated_delivery: Option<DateTime<Utc>>

Expected delivery date

delivered_at: Option<DateTime<Utc>>

Actual delivery timestamp

notes: Option<String>

Notes about the shipment

items: Vec<ShipmentItem>

Items in this shipment

events: Vec<ShipmentEvent>

Tracking events/history

version: i32

Version for optimistic locking

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Shipment

pub fn generate_shipment_number() -> String

Generate a unique shipment number based on timestamp

pub fn transit_days(&self) -> Option<f64>

Calculate transit time in days (if delivered)

pub fn is_late(&self) -> bool

Check if delivery is late

Trait Implementations

impl Clone for Shipment

fn clone(&self) -> Shipment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Shipment

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Shipment

fn deserialize<__D>( __deserializer: __D, ) -> Result<Shipment, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Shipment

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.