Freight Quote Request
Also known as: freight_quote_request, quote_request, rate_request, freight_rate_request, shipping_quote_request, transportation_quote_request, RFQ Submission, Request for Freight Pricing
Measures each successfully submitted request for freight pricing that is assigned a durable quote request identifier by an approved intake system. It captures the commercial channel, requested service, shipment characteristics, route, timing, and handling requirements needed to analyze quoting demand and downstream conversion.
Event Serialization
alwaysBusiness Use Case
Revenue Management reviews quote-request volume, lane mix, shipment complexity, and downstream booking conversion by transport mode and service level. If a high-demand lane shows increasing requests but low quote completion or booking conversion, the team can adjust carrier capacity, pricing rules, service coverage, or staffing and then monitor whether turnaround time and conversion improve.
Business Criticality
High
Journey / Navigation Area
Monetization
Owning Function
Revenue Management
Calculation Notes
1️⃣ Emit event after validation of minimum shipment details and assignment of quote_request_id. 2️⃣ Exclude form views, draft saves, field-validation errors, and abandoned forms. 3️⃣ Deduplicate unique requests on quote_request_id and retain earliest valid request_timestamp unless marked as material resubmission. 4️⃣ Treat retries with unchanged quote_request_id as duplicates. 5️⃣ Genuine customer revisions should update the request entity or emit a separate revision event. 6️⃣ Apply standard digital inactivity timeout of 30 minutes for session-based analysis; include requests without session_id. 7️⃣ Interpret dates in local calendar, store timestamps in UTC, and use governed exchange rate for currency conversion.
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | generate_lead |
| Adobe | generate_lead |
Data Mappings
W3 Data Layer
{
"digitalData": {
"event": [
{
"eventInfo": {
"eventId": "evt_fqr_01JQ8K9R2M7N4P6T3V5X",
"eventName": "generate_lead",
"eventTimestamp": "2025-03-25T14:30:00Z"
},
"attributes": {
"formId": "freight-quote-form",
"hsCode": "940360",
"leadId": "lead_00123456",
"userId": "user_00876543",
"currency": "USD",
"formName": "Freight pricing request",
"incoterm": "DAP",
"oversize": false,
"accountId": "acct_00098765",
"commodity": "general_merchandise",
"sessionId": "session_01JQ8K7W9B2D4F6H8M",
"originCity": "Chicago",
"pickupDate": "2025-04-01",
"volumeUnit": "m3",
"weightUnit": "kg",
"packageType": "carton",
"palletCount": 4,
"totalVolume": 18.75,
"totalWeight": 1250.5,
"customerType": "business",
"deliveryDate": "2025-04-04",
"intakeSystem": "quote_management_platform",
"originRegion": "IL",
"packageCount": 24,
"serviceLevel": "standard",
"sourceSystem": "digital_analytics",
"declaredValue": 25000,
"equipmentType": "dry_van",
"originCountry": "US",
"transportMode": "road",
"quoteRequestId": "FQR-2025-00012345",
"temperatureMax": 8,
"temperatureMin": 2,
"destinationCity": "Dallas",
"temperatureUnit": "C",
"liftgateRequired": true,
"originPostalCode": "60601",
"requestedService": "freight_transportation",
"commercialChannel": "web",
"destinationRegion": "TX",
"hazardousMaterial": false,
"destinationCountry": "US",
"residentialDelivery": false,
"destinationPostalCode": "75201",
"temperatureControlled": false,
"transitTimePreference": "standard"
}
}
]
}
}GA4 Data Layer
{
"event": "generate_lead",
"form_id": "freight-quote-form",
"hs_code": "940360",
"lead_id": "lead_00123456",
"user_id": "user_00876543",
"currency": "USD",
"event_id": "evt_fqr_01JQ8K9R2M7N4P6T3V5X",
"incoterm": "DAP",
"oversize": false,
"commodity": "general_merchandise",
"form_name": "Freight pricing request",
"account_id": "acct_00098765",
"session_id": "session_01JQ8K7W9B2D4F6H8M",
"origin_city": "Chicago",
"pickup_date": "2025-04-01",
"volume_unit": "m3",
"weight_unit": "kg",
"package_type": "carton",
"pallet_count": 4,
"total_volume": 18.75,
"total_weight": 1250.5,
"customer_type": "business",
"delivery_date": "2025-04-04",
"intake_system": "quote_management_platform",
"origin_region": "IL",
"package_count": 24,
"service_level": "standard",
"source_system": "digital_analytics",
"declared_value": 25000,
"equipment_type": "dry_van",
"origin_country": "US",
"transport_mode": "road",
"event_timestamp": "2025-03-25T14:30:00Z",
"temperature_max": 8,
"temperature_min": 2,
"destination_city": "Dallas",
"quote_request_id": "FQR-2025-00012345",
"temperature_unit": "C",
"liftgate_required": true,
"requested_service": "freight_transportation",
"commercial_channel": "web",
"destination_region": "TX",
"hazardous_material": false,
"origin_postal_code": "60601",
"destination_country": "US",
"residential_delivery": false,
"temperature_controlled": false,
"destination_postal_code": "75201",
"transit_time_preference": "standard"
}Adobe Client Data Layer
{
"data": {
"formId": "freight-quote-form",
"hsCode": "940360",
"leadId": "lead_00123456",
"userId": "user_00876543",
"eventId": "evt_fqr_01JQ8K9R2M7N4P6T3V5X",
"currency": "USD",
"formName": "Freight pricing request",
"incoterm": "DAP",
"oversize": false,
"accountId": "acct_00098765",
"commodity": "general_merchandise",
"sessionId": "session_01JQ8K7W9B2D4F6H8M",
"originCity": "Chicago",
"pickupDate": "2025-04-01",
"volumeUnit": "m3",
"weightUnit": "kg",
"packageType": "carton",
"palletCount": 4,
"totalVolume": 18.75,
"totalWeight": 1250.5,
"customerType": "business",
"deliveryDate": "2025-04-04",
"intakeSystem": "quote_management_platform",
"originRegion": "IL",
"packageCount": 24,
"serviceLevel": "standard",
"sourceSystem": "digital_analytics",
"declaredValue": 25000,
"equipmentType": "dry_van",
"originCountry": "US",
"transportMode": "road",
"eventTimestamp": "2025-03-25T14:30:00Z",
"quoteRequestId": "FQR-2025-00012345",
"temperatureMax": 8,
"temperatureMin": 2,
"destinationCity": "Dallas",
"temperatureUnit": "C",
"liftgateRequired": true,
"originPostalCode": "60601",
"requestedService": "freight_transportation",
"commercialChannel": "web",
"destinationRegion": "TX",
"hazardousMaterial": false,
"destinationCountry": "US",
"residentialDelivery": false,
"destinationPostalCode": "75201",
"temperatureControlled": false,
"transitTimePreference": "standard"
},
"event": "generate_lead"
}XDM Mapping
{
"_id": "evt_fqr_01JQ8K9R2M7N4P6T3V5X",
"_freight": {
"quoteRequest": {
"formId": "freight-quote-form",
"hsCode": "940360",
"leadId": "lead_00123456",
"userId": "user_00876543",
"currency": "USD",
"formName": "Freight pricing request",
"incoterm": "DAP",
"oversize": false,
"accountId": "acct_00098765",
"commodity": "general_merchandise",
"sessionId": "session_01JQ8K7W9B2D4F6H8M",
"originCity": "Chicago",
"pickupDate": "2025-04-01",
"volumeUnit": "m3",
"weightUnit": "kg",
"packageType": "carton",
"palletCount": 4,
"totalVolume": 18.75,
"totalWeight": 1250.5,
"customerType": "business",
"deliveryDate": "2025-04-04",
"intakeSystem": "quote_management_platform",
"originRegion": "IL",
"packageCount": 24,
"serviceLevel": "standard",
"sourceSystem": "digital_analytics",
"declaredValue": 25000,
"equipmentType": "dry_van",
"originCountry": "US",
"transportMode": "road",
"quoteRequestId": "FQR-2025-00012345",
"temperatureMax": 8,
"temperatureMin": 2,
"destinationCity": "Dallas",
"temperatureUnit": "C",
"liftgateRequired": true,
"originPostalCode": "60601",
"requestedService": "freight_transportation",
"commercialChannel": "web",
"destinationRegion": "TX",
"hazardousMaterial": false,
"destinationCountry": "US",
"residentialDelivery": false,
"destinationPostalCode": "75201",
"temperatureControlled": false,
"transitTimePreference": "standard"
}
},
"eventType": "web.formFilledOut",
"timestamp": "2025-03-25T14:30:00Z"
}Parameters
{
"channel": "string - controlled submission channel such as web, mobile_app, API, EDI, email_assisted, call_center, or sales_agent",
"user_id": "string - authenticated or pseudonymous identifier for the individual submitting the request",
"account_id": "string - identifier for the commercial account associated with the request; nullable for consumer or guest requests",
"quote_type": "string - requested pricing type such as spot, contract, budgetary, renewal, or tender",
"session_id": "string - digital session identifier associated with the submission; nullable for API, batch, or agent-created requests",
"campaign_id": "string - marketing or sales campaign identifier credited with originating the request; nullable when unattributed",
"customer_id": "string - persistent identifier for the customer requesting the quote; nullable for unidentified prospects",
"device_type": "string - device class used for digital submission, such as desktop, mobile, tablet, or other; nullable for non-digital channels",
"length_unit": "string - UCUM-compatible unit for linear length, normally m or ft; required when linear_length is populated",
"pickup_date": "string - requested pickup date in ISO 8601 calendar-date format using the origin location's local date",
"volume_unit": "string - UCUM-compatible volume unit, normally m3 or ft3",
"weight_unit": "string - UCUM-compatible weight unit, normally kg or lb",
"pallet_count": "integer - total number of pallets; zero when the shipment is not palletized",
"total_volume": "number - non-negative total shipment volume expressed in the accompanying volume unit",
"total_weight": "number - non-negative total shipment weight expressed in the accompanying weight unit",
"distance_unit": "string - unit for estimated_distance, normally km or mi; required when estimated_distance is populated",
"incoterm_code": "string - ICC Incoterms code applicable to the shipment, such as EXW, FOB, CIF, DAP, or DDP; nullable when not relevant",
"linear_length": "number - non-negative loading-space length required by the shipment; nullable when not provided",
"package_count": "integer - total number of handling units or packages included in the request",
"shipment_type": "string - shipment classification such as full_truckload, less_than_truckload, full_container_load, less_than_container_load, or parcel",
"source_system": "string - authoritative application or integration that accepted and persisted the request",
"declared_value": "number - non-negative declared commercial value of the shipment in the accompanying value currency",
"equipment_type": "string - requested equipment or container type such as dry_van, reefer, flatbed, tanker, or container_40ft",
"packaging_type": "string - primary packaging form such as pallet, carton, crate, drum, bag, or loose",
"request_status": "string - intake status at event time, normally submitted, accepted, or queued",
"stackable_flag": "boolean - indicates whether the freight may be safely stacked during transport",
"transport_mode": "string - requested primary mode such as road, rail, air, ocean, intermodal, or parcel",
"value_currency": "string - ISO 4217 currency code applicable to declared_value",
"pricing_currency": "string - ISO 4217 currency in which the customer expects the freight quote",
"quote_request_id": "string - globally unique, immutable identifier assigned to the freight quote request",
"request_timestamp": "string - ISO 8601 UTC timestamp when the request was successfully persisted by the intake system",
"commodity_category": "string - controlled classification of the primary goods being transported",
"estimated_distance": "number - non-negative route distance estimated at request time; nullable when routing has not completed",
"origin_postal_code": "string - normalized postal code for the shipment origin at the precision permitted by privacy policy",
"flexible_dates_flag": "boolean - indicates whether pickup or delivery dates may be adjusted during quotation",
"origin_country_code": "string - ISO 3166-1 alpha-2 country code for the shipment origin",
"origin_location_type": "string - origin facility classification such as warehouse, port, airport, residence, store, or supplier",
"commodity_description": "string - business-safe description of the freight contents with personal and payment data excluded",
"destination_postal_code": "string - normalized postal code for the shipment destination at the precision permitted by privacy policy",
"hazardous_material_flag": "boolean - indicates whether any item is declared as regulated hazardous material",
"requested_delivery_date": "string - requested delivery date in ISO 8601 calendar-date format using the destination location's local date; nullable when unspecified",
"service_level_requested": "string - requested delivery service tier such as economy, standard, expedited, or guaranteed",
"destination_country_code": "string - ISO 3166-1 alpha-2 country code for the shipment destination",
"insurance_requested_flag": "boolean - indicates whether cargo insurance pricing was requested",
"accessorial_service_codes": "array<string> - deduplicated controlled codes for requested additional services such as liftgate, inside_delivery, detention, or residential_delivery",
"destination_location_type": "string - destination facility classification such as warehouse, port, airport, residence, store, or customer_site",
"temperature_controlled_flag": "boolean - indicates whether temperature-controlled handling or equipment is required",
"customs_clearance_required_flag": "boolean - indicates whether customs brokerage or clearance service was requested",
"special_instructions_present_flag": "boolean - indicates whether operational instructions were provided without transmitting the free-text instructions in the analytics event"
}Source Data
Digital Analytics, Customer Relationship Management, Quote Management Platform, Transportation Management System, API Gateway, and EDI Integration Platform
Dependencies
[ "customer_dimension", "commercial_account_dimension", "digital_session_dimension", "location_dimension", "currency_dimension", "campaign_dimension", "freight_quote_created_event", "freight_quote_delivered_event", "freight_quote_accepted_event", "freight_booking_created_event", "freight_quote_request_cancelled_event" ]
Report Attributes
Request Date Submission Channel Source System Customer Commercial Account Quote Type Transport Mode Shipment Type Service Level Equipment Type Origin Country Destination Country Origin-Destination Lane Domestic or Cross-Border Shipment Commodity Category Shipment Weight Band Distance Band Hazardous Material Indicator Temperature Control Indicator Campaign Device Type
Segment Eligibility
true
Governance
Dimensions
Related Dimensions
Derived Dimensions
Derived Entities
Derived Metrics
Derived KPIs
Governance & Metadata
GitHub
catalog/events/freight-quote-request.yml