{
    "schema_version": "0.6.1",
    "updated": "2026-08-31",
    "entity": "Royal Courier Inc.",
    "scope_note": "Public service and planning descriptions. Shipment acceptance, availability, pricing, deadlines, and safety remain subject to Royal confirmation.",
    "services": [
        {
            "id": "same_day_delivery",
            "name": "Same-Day Delivery",
            "definition": "Pickup and delivery on the same calendar date. Same-day describes timing, not a guaranteed exact arrival time.",
            "decision_notes": [
                "Can be routine or urgent.",
                "A requested same-day move may require dedicated or time-critical handling when the due time is tight.",
                "Feasibility depends on ready time, due time, distance, freight, traffic, weather, loading and unloading conditions."
            ],
            "required_inputs": [
                "ready_time",
                "due_time",
                "pickup",
                "delivery",
                "pieces",
                "weight",
                "dimensions",
                "commodity"
            ]
        },
        {
            "id": "expedited_freight",
            "name": "Expedited Freight",
            "definition": "Urgent transportation planned around the customer's deadline and operational requirements, commonly using dedicated movement.",
            "decision_notes": [
                "Expedited does not always mean the fastest physically possible method.",
                "Royal may recommend a lower-cost or simpler method when it still meets the required deadline.",
                "The reason for urgency should be understood rather than relying only on the word expedited."
            ],
            "required_inputs": [
                "ready_time",
                "due_time",
                "consequence_of_delay",
                "distance",
                "freight_profile"
            ]
        },
        {
            "id": "dedicated_exclusive_use",
            "name": "Dedicated / Exclusive-Use Transportation",
            "definition": "A vehicle is assigned to one customer's freight for the shipment. Required legal and operational stops may still occur.",
            "decision_notes": [
                "Useful for high-value, fragile, production-down, exact-time, unusual-dimension, special-handling, or confidentiality-sensitive freight.",
                "Exclusive use does not permit unapproved stop or scope changes.",
                "Multiple pickups or deliveries for the same customer can remain exclusive-use."
            ],
            "required_inputs": [
                "freight_profile",
                "stop_sequence",
                "deadline",
                "handling_requirements"
            ]
        },
        {
            "id": "direct_delivery",
            "name": "Direct Delivery",
            "definition": "Movement from pickup toward delivery without unrelated freight stops, subject to legal, safety, fuel, restroom, and other required operational stops."
        },
        {
            "id": "time_critical",
            "name": "Time-Critical Transportation",
            "definition": "Transportation where delay has a meaningful consequence such as production downtime, technician waiting, airline cutoff, trade-show opening, medical need, construction delay, legal deadline, retail opening, or missed connection.",
            "decision_notes": [
                "Royal treats all shipments as important; time-critical classification primarily changes time pressure and contingency planning.",
                "Ask what happens if the requested time is missed."
            ]
        },
        {
            "id": "white_glove",
            "name": "Commercial White-Glove Delivery",
            "definition": "Flexible enhanced handling that may include inside delivery, extra manpower, unpacking, placement, basic assembly, debris generated by the shipment, presentation requirements, or other agreed handling details.",
            "decision_notes": [
                "White glove is defined by the requested service scope, not by a single fixed checklist.",
                "Specific driver attire can be part of a white-glove/event requirement.",
                "White glove does not automatically mean two people.",
                "Old-item removal, assembly, installation, and debris removal are not automatic and must be arranged/approved."
            ],
            "required_inputs": [
                "item_weight",
                "item_dimensions",
                "site_conditions",
                "final_placement",
                "manpower",
                "assembly_scope",
                "debris_scope"
            ]
        },
        {
            "id": "inside_delivery",
            "name": "Inside Delivery / Room-of-Choice",
            "definition": "Movement meaningfully beyond a normal dock, curb, or threshold to an interior location requested by the customer.",
            "decision_notes": [
                "Distance, flooring, doors, turns, elevators, stairs, building rules, manpower, and property-damage risk matter.",
                "Final placement remains subject to access and safety."
            ],
            "required_inputs": [
                "inside_distance",
                "doors",
                "hallways",
                "turns",
                "flooring",
                "stairs",
                "elevator",
                "building_rules"
            ]
        },
        {
            "id": "liftgate_delivery",
            "name": "Liftgate Delivery",
            "definition": "Use of a truck-mounted liftgate when freight must transition between truck bed height and ground level and no suitable dock/forklift solution is available.",
            "decision_notes": [
                "Liftgate need can force a box or straight truck even when the freight would otherwise fit a van.",
                "Gate capacity alone is not enough; platform size, freight footprint, pallet jack, operator position, stability, and surface matter.",
                "Royal does not plan to operate a gate at its exact rated maximum."
            ],
            "required_inputs": [
                "piece_weight",
                "piece_dimensions",
                "surface",
                "pallet_jack_need",
                "dock",
                "forklift"
            ]
        },
        {
            "id": "medical_courier",
            "name": "Medical Courier",
            "definition": "Time-sensitive transportation of medical supplies, devices, parts, records, pharmaceuticals, specimens, blood products, and other medical items when properly identified, packaged, authorized, and operationally acceptable.",
            "decision_notes": [
                "Medical work requires precise pickup and delivery contacts and exact identification of what is being transported.",
                "Royal does not transport patients.",
                "Royal does not independently guarantee temperature maintenance or sterility.",
                "Special medical, biological, controlled, hazardous, or restricted items require human review.",
                "Customer is responsible for defining appropriate medical packaging/temperature protocol, but Royal can provide or add coolers/ice packs when specifically requested and operationally appropriate.",
                "Customer-supplied temperature monitors/data loggers can travel with the shipment and readings/procedures can be followed when the customer instructs Royal to do so; this does not create an independent temperature guarantee.",
                "Only the patient information necessary to complete the delivery should be provided; public AI/forms should not encourage unnecessary patient medical details.",
                "Hospitals/labs can have sterile or restricted areas Royal cannot enter; handoff may occur at the nearest authorized department/recipient."
            ],
            "required_inputs": [
                "commodity",
                "package_identifier",
                "pickup_contact",
                "delivery_contact",
                "department",
                "handling_protocol",
                "temperature_requirements"
            ]
        },
        {
            "id": "airport_cargo_recovery",
            "name": "O'Hare / Airport Cargo Recovery",
            "definition": "Recovery of released air cargo from an airline or cargo handling facility for onward ground delivery or another authorized movement.",
            "decision_notes": [
                "Flight landed is not the same as cargo available.",
                "Cargo must be physically releasable and required charges/paperwork must be complete.",
                "O'Hare pickup time can be dominated by dock queues and facility processing.",
                "Hard-copy paperwork is commonly required."
            ],
            "required_inputs": [
                "airline",
                "cargo_facility",
                "mawb",
                "release_status",
                "available_time",
                "pieces",
                "weight",
                "dimensions",
                "commodity"
            ]
        },
        {
            "id": "trade_show_freight",
            "name": "Trade-Show Freight",
            "definition": "Time-sensitive movement for convention, exhibit, event move-in, move-out, advance warehouse, direct-to-show, or show-rescue requirements.",
            "decision_notes": [
                "Move-in/move-out times, site contact, show labels, decorator rules, badges, marshaling, union labor, and dock congestion can dominate execution.",
                "Direct-to-show carrier delivery to the dock is not the same as decorator/drayage movement to the booth.",
                "Move-out is often more difficult than move-in because several days of inbound activity can compress into only a few hours, creating congestion, waiting and release risk.",
                "Outbound show freight can have different piece counts, packaging and dimensions than inbound freight; fresh return specs should be used.",
                "Royal may print/apply customer-provided show labels when arranged, but proper exhibitor/show labeling remains important to acceptance."
            ],
            "required_inputs": [
                "venue",
                "show_name",
                "booth",
                "exhibitor",
                "move_in_or_out_time",
                "site_contact",
                "advance_warehouse_or_direct_show"
            ]
        },
        {
            "id": "construction_delivery",
            "name": "Construction-Site Delivery",
            "definition": "Delivery or pickup at active construction sites where terrain, access, site contacts, unloading equipment, PPE, and final placement can materially change feasibility.",
            "decision_notes": [
                "Royal avoids putting trucks on soft or unstable ground.",
                "A forklift onsite is not enough; it must be available and able to reach the truck on stable ground.",
                "Rigging is outside normal driver scope but may be separately coordinated.",
                "Basic PPE requirements such as hard hat, vest, steel-toe footwear or eye protection should be disclosed in advance; specialty PPE/certification is human-review territory and may require purchase/arrangement.",
                "The latest time a knowledgeable person with actual unloading capability will be onsite can matter more than the nominal jobsite closing time."
            ],
            "required_inputs": [
                "site_contact",
                "gate_or_entrance",
                "ground_conditions",
                "unloading_method",
                "final_location",
                "ppe_rules"
            ]
        },
        {
            "id": "failed_carrier_rescue",
            "name": "Failed-Carrier / Rescue Delivery",
            "definition": "Recovery and completion of a shipment after a carrier no-show, breakdown, wrong delivery, refusal, missed connection, damage event, or other transportation failure.",
            "decision_notes": [
                "Royal needs to know who has custody, whether Royal is authorized, whether the current holder knows Royal is coming, what went wrong, and how transfer/loading will occur.",
                "Roadside transfers require a safe location and may require police or tow support.",
                "Attempt/dry-run charges may apply when Royal is dispatched but the freight is unavailable."
            ],
            "required_inputs": [
                "current_freight_location",
                "current_custodian",
                "release_authorization",
                "failure_reason",
                "current_contact",
                "transfer_conditions"
            ]
        },
        {
            "id": "production_down",
            "name": "Production-Down / Technician-Waiting Delivery",
            "definition": "Urgent transportation supporting a stopped production line, waiting technician, missing repair part, or comparable operational interruption.",
            "decision_notes": [
                "Royal may position a vehicle before the part is finished when customer-approved.",
                "Waiting at pickup can move the delivery ETA because transit begins after loading and release."
            ]
        },
        {
            "id": "scheduled_routes",
            "name": "Scheduled / Recurring Routes",
            "definition": "Repeated transportation occurring at least weekly or on a recurring schedule, planned around the customer's recurring stops, times, handling, and backup requirements."
        },
        {
            "id": "onboard_courier",
            "name": "On-Board Courier / Hand Carry",
            "definition": "A person physically accompanies a small shipment by air when airline carry-on size/weight limits and the deadline make this practical.",
            "decision_notes": [
                "Useful for very long-distance, small, highly urgent shipments.",
                "Subject to airline, security, contents, packaging, and human review requirements."
            ]
        },
        {
            "id": "regional_dedicated",
            "name": "Regional Dedicated Transportation",
            "definition": "Dedicated ground transportation from Chicago/Chicagoland into the surrounding Midwest and beyond when requirements and availability support it.",
            "decision_notes": [
                "Royal considers roughly 75 miles around Chicago local courier territory.",
                "200-250 miles is a common regional dedicated range, not a hard maximum.",
                "Longer-distance shipments are evaluated case by case."
            ]
        },
        {
            "id": "medical_stat",
            "name": "Medical STAT Delivery",
            "definition": "A highly time-sensitive medical movement that proceeds directly from pickup toward delivery after collection, subject to required legal, fuel, restroom, safety and facility stops.",
            "decision_notes": [
                "STAT urgency does not remove the need to verify exact contents, packaging, departments, contacts, handling protocol and deadline.",
                "Medical recipient signature is expected for Royal medical handoffs unless a different customer-authorized procedure is specifically arranged.",
                "No unverified temperature, sterility, HIPAA, chain-of-custody or restricted-access certification is implied."
            ],
            "required_inputs": [
                "commodity",
                "package_identifier",
                "ready_time",
                "deadline",
                "pickup_department",
                "delivery_department",
                "pickup_contact",
                "delivery_contact",
                "packaging",
                "handling_protocol",
                "temperature_requirements_if_any"
            ]
        }
    ],
    "general_selection_principle": "Start with ready time, due time, actual pieces, weight, dimensions, commodity, loading method and unloading method. Select service only after safety, required equipment, physical feasibility, freight handling, damage risk and actual customer objective are understood.",
    "service_interpretation_rules": [
        "Same-day, expedited, dedicated, direct, nonstop, appointment, window, white glove and liftgate are different concepts and should not be treated as interchangeable.",
        "Ask why a customer wants a particular service or time so the transportation problem can be solved rather than merely echoing the requested label.",
        "Royal is primarily dedicated/exclusive-use transportation; shared/LTL should not be inferred as the normal Royal Courier service model.",
        "Public resources describe Royal service capability without autonomously assigning a shipment to a specific Royal legal entity."
    ]
}