Shipment Transportation Integration

Overview

Attribute	Value
Context	Shipment Transportation
Pattern	Customer-Supplier
Direction	Outbound (Process Path → Transportation)
Protocol	Apache Kafka
Topics	`pack-ship.slam.`, `transportation.shipments.`

Integration Summary

Process Path is the supplier that completes SLAM operations, and Shipment Transportation is the customer that takes over for carrier handoff. The handoff occurs after SLAM completion when the package is labeled and manifested.

┌─────────────────────────┐         ┌─────────────────────────┐
│      PROCESS PATH       │         │   SHIPMENT TRANSPORT    │
│                         │         │                         │
│  • SLAM completion      │  ─────► │  • Carrier sorting      │
│  • Label generation     │  Event  │  • Truck loading        │
│  • Weight verification  │         │  • Dispatch management  │
│  • Manifest recording   │         │  • Tracking activation  │
└─────────────────────────┘         └─────────────────────────┘

Events Published

SLAMCompletedEvent

Purpose: Trigger carrier sorting and shipping handoff

Topic: pack-ship.slam.completed

Transportation Action: Route to carrier sort lane

{
  "specversion": "1.0",
  "type": "com.paklog.packship.slam.completed.v1",
  "source": "/pack-ship-service",
  "id": "evt-slam-123456",
  "time": "2025-01-20T10:18:00.000Z",
  "subject": "SHP-123456",
  "data": {
    "shipmentId": "SHP-123456",
    "orderId": "ORD-789012",
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "UPS",
    "serviceLevel": "GROUND",
    "destinationZip": "98101",
    "labelApplied": true,
    "manifestRecorded": true,
    "packageDetails": {
      "weight": 1.52,
      "dimensions": {
        "length": 12,
        "width": 8,
        "height": 6
      },
      "boxType": "A1"
    },
    "carrierCutoff": "2025-01-20T16:00:00Z",
    "slamStationId": "SLAM-01",
    "slammedAt": "2025-01-20T10:18:00Z"
  }
}

ShipmentReadyForSortEvent

Purpose: Direct carrier sort operations

Topic: process-path.outbound.ready

{
  "type": "com.paklog.processpath.outbound.ready.v1",
  "data": {
    "shipmentId": "SHP-123456",
    "carrier": "UPS",
    "serviceLevel": "GROUND",
    "sortCode": "SEA-01",
    "dockDoor": "DOOR-15",
    "trailerId": "TRAILER-UPS-001",
    "carrierPickupTime": "2025-01-20T16:00:00Z",
    "priority": "NORMAL"
  }
}

Events Consumed

ShipmentPickedUpEvent

Purpose: Confirm carrier handoff, close shipment tracking

Topic: transportation.shipments.picked-up

{
  "type": "com.paklog.transportation.pickup.completed.v1",
  "data": {
    "shipmentId": "SHP-123456",
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "UPS",
    "trailerId": "TRAILER-UPS-001",
    "sealNumber": "SEAL-789456",
    "pickedUpAt": "2025-01-20T16:05:00Z",
    "manifestConfirmed": true
  }
}

CarrierCutoffWarningEvent

Purpose: Expedite shipments at risk

Topic: transportation.carrier.cutoff-warning

{
  "type": "com.paklog.transportation.cutoff.warning.v1",
  "data": {
    "carrier": "UPS",
    "serviceLevel": "GROUND",
    "cutoffTime": "2025-01-20T16:00:00Z",
    "timeRemaining": "PT30M",
    "shipmentsAtRisk": 15,
    "affectedShipmentIds": ["SHP-123456", "SHP-123457"]
  }
}

SLAM to Sort Flow

Flow Diagram

SLAM Completion
    │
    ├── Label Applied
    ├── Manifest Recorded
    ├── Tracking Activated
    │
    ▼
Carrier Sort
    │
    ├── Scan Tracking Barcode
    ├── Route to Carrier Lane
    ├── Route to Destination Sort
    │
    ▼
Truck Loading
    │
    ├── Scan into Trailer
    ├── Load Optimization
    │
    ▼
Dispatch
    │
    ├── Seal Trailer
    ├── Driver Handoff
    └── Manifest Transmission

Carrier Sorting Rules

Process Path provides sort codes based on carrier and destination:

Carrier	Service Level	Sort Lane	Dock Door Range
UPS	GROUND	UPS-GND	DOOR-10 to DOOR-15
UPS	2DAY	UPS-AIR	DOOR-16 to DOOR-18
FEDEX	GROUND	FDX-GND	DOOR-20 to DOOR-25
FEDEX	EXPRESS	FDX-EXP	DOOR-26 to DOOR-28
USPS	ALL	USPS	DOOR-30 to DOOR-32
AMZL	ALL	AMZL	DOOR-40 to DOOR-50

Manifest Integration

Manifest Data Provided

{
  "manifestId": "MAN-2025-01-20-UPS-001",
  "carrier": "UPS",
  "serviceLevel": "GROUND",
  "shipments": [
    {
      "shipmentId": "SHP-123456",
      "trackingNumber": "1Z999AA10123456784",
      "weight": 1.52,
      "destination": {
        "zip": "98101",
        "state": "WA",
        "country": "US"
      }
    }
  ],
  "totalShipments": 150,
  "totalWeight": 450.5,
  "trailerId": "TRAILER-UPS-001",
  "scheduledPickup": "2025-01-20T16:00:00Z"
}

SLA Handoff Tracking

Process Path tracks SLA compliance through shipping:

Shipment Timeline:
├── Order Released: 09:55:00
├── Path Assigned: 09:56:00 (SINGLES)
├── Picked: 10:05:00
├── Packed: 10:12:00
├── SLAM Complete: 10:18:00
├── Sorted: 10:22:00
├── Loaded: 14:30:00
├── Picked Up: 16:05:00 ✓
│
└── Total Fulfillment Time: 6h 10m
    SLA Compliance: ✓ (before 16:00 cutoff)

Cutoff Management

Near-Cutoff Expediting

When CarrierCutoffWarningEvent received:

1. Identify affected shipments in process
2. If shipment in pack/SLAM:
   - Escalate to RED priority
   - Fast-lane through SLAM
3. If shipment in sort:
   - Priority lane to dock door
4. If shipment in loading:
   - Ensure on current trailer
5. Report at-risk shipments to Operations

Error Handling

Error	Process Path Action	Transportation Action
Label scan failure	Report exception	Manual sort
Wrong trailer	Alert, rescan	Redirect package
Missed cutoff	Report SLA breach	Next available pickup
Manifest mismatch	Reconcile, report	Hold for verification

Performance Metrics

Metric	Target	Description
SLAM to sort time	< 5 min	Time from SLAM to sort scan
Sort accuracy	> 99.9%	Correct carrier/lane routing
Cutoff compliance	> 99.5%	Shipments meeting cutoff
Manifest accuracy	> 99.99%	Shipments matching manifest