Pickup Scheduling Completion
Also known as: Pickup Schedule Completed, Pickup Booking Completed, Pickup Booking Confirmed, Pickup Scheduled, Schedule Pickup Success, Pickup Confirmation, Carrier Pickup Booked
Records each successful completion of a pickup scheduling flow after a durable pickup booking and confirmation identifier have been created by the responsible scheduling system. It measures confirmed pickup scheduling activity across customers, shipments, carriers, channels, locations, service levels, and requested pickup windows.
Event Serialization
alwaysBusiness Use Case
Transportation Operations reviews completion rate, confirmation latency, and reschedule rate by carrier, origin region, scheduling channel, and service level. When a carrier or channel shows declining first-attempt completion or excessive confirmation latency, the team can redirect booking volume, adjust pickup cutoffs, correct integration failures, expand slot capacity, or require carrier remediation before missed pickups affect fulfillment commitments.
Business Criticality
High
Journey / Navigation Area
Checkout
Owning Function
Transportation Operations
Calculation Notes
1️⃣ Emit event only after booking is confirmed with non-null booking_confirmation_id. 2️⃣ Do not emit for form submission, slot selection, or cancellations. 3️⃣ Deduplicate curated event counts by event_id; retain earliest valid record if event_id is unavailable. 4️⃣ Confirmed reschedules are separate activations; exclude from first-time scheduling metrics unless requested. 5️⃣ Increase attempt_number only after failed submissions, not for page views or edits. 6️⃣ Use event_timestamp in UTC for completion time; recalculate lead_time_minutes if conflicts arise. 7️⃣ Exclude test accounts and invalid records from certified reporting.
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | purchase |
| Adobe | purchase |
Data Mappings
W3 Data Layer
{
"event": [
{
"pickup": {
"channel": "{{channel}}",
"currency": "{{currency}}",
"timezone": "{{timezone}}",
"accountId": "{{account_id}}",
"carrierId": "{{carrier_id}}",
"pickupFee": 0,
"appVersion": "{{app_version}}",
"customerId": "{{customer_id}}",
"deviceType": "{{device_type}}",
"locationId": "{{location_id}}",
"originCity": "{{origin_city}}",
"pickupDate": "{{pickup_date}}",
"shipmentId": "{{shipment_id}}",
"volumeUnit": "{{volume_unit}}",
"weightUnit": "{{weight_unit}}",
"carrierName": "{{carrier_name}}",
"rateQuoteId": "{{rate_quote_id}}",
"totalVolume": 0,
"totalWeight": 0,
"insidePickup": false,
"locationType": "{{location_type}}",
"originRegion": "{{origin_region}}",
"packageCount": 0,
"serviceLevel": "{{service_level}}",
"sourceSystem": "{{source_system}}",
"bookingStatus": "confirmed",
"commodityType": "{{commodity_type}}",
"originCountry": "{{origin_country}}",
"promotionCode": "{{promotion_code}}",
"recurrenceType": "{{recurrence_type}}",
"trackingNumber": "{{tracking_number}}",
"customerSegment": "{{customer_segment}}",
"estimatedCharge": 0,
"integrationType": "{{integration_type}}",
"leadTimeMinutes": 0,
"pickupBookingId": "{{pickup_booking_id}}",
"pickupWindowEnd": "{{pickup_window_end}}",
"recurringPickup": false,
"bookingCreatedAt": "{{booking_created_at}}",
"liftgateRequired": false,
"originPostalCode": "{{origin_postal_code}}",
"contactlessPickup": false,
"hazardousMaterial": false,
"pickupWindowStart": "{{pickup_window_start}}",
"residentialPickup": false,
"carrierResponseCode": "{{carrier_response_code}}",
"bookingConfirmationId": "{{booking_confirmation_id}}",
"confirmationCreatedAt": "{{confirmation_created_at}}",
"carrierBookingReference": "{{carrier_booking_reference}}"
},
"eventInfo": {
"eventId": "{{event_id}}",
"eventName": "purchase",
"eventType": "conversion",
"timestamp": "{{event_timestamp}}",
"eventAction": "complete"
}
}
]
}GA4 Data Layer
{
"event": "purchase",
"event_id": "{{event_id}}",
"ecommerce": {
"items": [
{
"price": 0,
"item_id": "{{shipment_id}}",
"quantity": 0,
"item_name": "Pickup scheduling",
"item_brand": "{{carrier_name}}",
"item_variant": "{{pickup_booking_id}}",
"item_category": "{{service_level}}",
"item_category2": "{{location_type}}",
"item_category3": "{{commodity_type}}"
}
],
"value": 0,
"coupon": "{{promotion_code}}",
"channel": "{{channel}}",
"currency": "{{currency}}",
"shipping": 0,
"timezone": "{{timezone}}",
"account_id": "{{account_id}}",
"carrier_id": "{{carrier_id}}",
"pickup_fee": 0,
"affiliation": "{{channel}}",
"app_version": "{{app_version}}",
"customer_id": "{{customer_id}}",
"device_type": "{{device_type}}",
"location_id": "{{location_id}}",
"origin_city": "{{origin_city}}",
"pickup_date": "{{pickup_date}}",
"shipment_id": "{{shipment_id}}",
"volume_unit": "{{volume_unit}}",
"weight_unit": "{{weight_unit}}",
"carrier_name": "{{carrier_name}}",
"total_volume": 0,
"total_weight": 0,
"inside_pickup": false,
"location_type": "{{location_type}}",
"origin_region": "{{origin_region}}",
"package_count": 0,
"rate_quote_id": "{{rate_quote_id}}",
"service_level": "{{service_level}}",
"source_system": "{{source_system}}",
"booking_status": "confirmed",
"commodity_type": "{{commodity_type}}",
"origin_country": "{{origin_country}}",
"transaction_id": "{{booking_confirmation_id}}",
"recurrence_type": "{{recurrence_type}}",
"tracking_number": "{{tracking_number}}",
"customer_segment": "{{customer_segment}}",
"estimated_charge": 0,
"integration_type": "{{integration_type}}",
"recurring_pickup": false,
"lead_time_minutes": 0,
"liftgate_required": false,
"pickup_booking_id": "{{pickup_booking_id}}",
"pickup_window_end": "{{pickup_window_end}}",
"booking_created_at": "{{booking_created_at}}",
"contactless_pickup": false,
"hazardous_material": false,
"origin_postal_code": "{{origin_postal_code}}",
"residential_pickup": false,
"pickup_window_start": "{{pickup_window_start}}",
"carrier_response_code": "{{carrier_response_code}}",
"confirmation_created_at": "{{confirmation_created_at}}",
"carrier_booking_reference": "{{carrier_booking_reference}}"
},
"event_timestamp": "{{event_timestamp}}"
}Adobe Client Data Layer
{
"data": {
"pickup": {
"channel": "{{channel}}",
"currency": "{{currency}}",
"timezone": "{{timezone}}",
"accountId": "{{account_id}}",
"carrierId": "{{carrier_id}}",
"pickupFee": 0,
"appVersion": "{{app_version}}",
"customerId": "{{customer_id}}",
"deviceType": "{{device_type}}",
"locationId": "{{location_id}}",
"originCity": "{{origin_city}}",
"pickupDate": "{{pickup_date}}",
"shipmentId": "{{shipment_id}}",
"volumeUnit": "{{volume_unit}}",
"weightUnit": "{{weight_unit}}",
"carrierName": "{{carrier_name}}",
"rateQuoteId": "{{rate_quote_id}}",
"totalVolume": 0,
"totalWeight": 0,
"insidePickup": false,
"locationType": "{{location_type}}",
"originRegion": "{{origin_region}}",
"packageCount": 0,
"serviceLevel": "{{service_level}}",
"sourceSystem": "{{source_system}}",
"bookingStatus": "confirmed",
"commodityType": "{{commodity_type}}",
"originCountry": "{{origin_country}}",
"promotionCode": "{{promotion_code}}",
"recurrenceType": "{{recurrence_type}}",
"trackingNumber": "{{tracking_number}}",
"customerSegment": "{{customer_segment}}",
"estimatedCharge": 0,
"integrationType": "{{integration_type}}",
"leadTimeMinutes": 0,
"pickupBookingId": "{{pickup_booking_id}}",
"pickupWindowEnd": "{{pickup_window_end}}",
"recurringPickup": false,
"bookingCreatedAt": "{{booking_created_at}}",
"liftgateRequired": false,
"originPostalCode": "{{origin_postal_code}}",
"contactlessPickup": false,
"hazardousMaterial": false,
"pickupWindowStart": "{{pickup_window_start}}",
"residentialPickup": false,
"carrierResponseCode": "{{carrier_response_code}}",
"bookingConfirmationId": "{{booking_confirmation_id}}",
"confirmationCreatedAt": "{{confirmation_created_at}}",
"carrierBookingReference": "{{carrier_booking_reference}}"
}
},
"event": "purchase",
"eventInfo": {
"eventId": "{{event_id}}",
"eventType": "commerce.purchases",
"timestamp": "{{event_timestamp}}"
}
}XDM Mapping
{
"_id": "{{event_id}}",
"commerce": {
"order": {
"priceTotal": 0,
"purchaseID": "{{pickup_booking_id}}",
"currencyCode": "{{currency}}",
"confirmationNumber": "{{booking_confirmation_id}}"
},
"purchases": {
"value": 1
}
},
"eventType": "commerce.purchases",
"timestamp": "{{event_timestamp}}",
"identityMap": {
"CustomerID": [
{
"id": "{{customer_id}}",
"primary": true,
"authenticatedState": "authenticated"
}
]
},
"productListItems": [
{
"SKU": "{{shipment_id}}",
"name": "Pickup scheduling",
"quantity": 0,
"priceTotal": 0
}
],
"_pickupScheduling": {
"channel": "{{channel}}",
"currency": "{{currency}}",
"timezone": "{{timezone}}",
"accountId": "{{account_id}}",
"carrierId": "{{carrier_id}}",
"pickupFee": 0,
"appVersion": "{{app_version}}",
"customerId": "{{customer_id}}",
"deviceType": "{{device_type}}",
"locationId": "{{location_id}}",
"originCity": "{{origin_city}}",
"pickupDate": "{{pickup_date}}",
"shipmentId": "{{shipment_id}}",
"volumeUnit": "{{volume_unit}}",
"weightUnit": "{{weight_unit}}",
"carrierName": "{{carrier_name}}",
"rateQuoteId": "{{rate_quote_id}}",
"totalVolume": 0,
"totalWeight": 0,
"insidePickup": false,
"locationType": "{{location_type}}",
"originRegion": "{{origin_region}}",
"packageCount": 0,
"serviceLevel": "{{service_level}}",
"sourceSystem": "{{source_system}}",
"bookingStatus": "confirmed",
"commodityType": "{{commodity_type}}",
"originCountry": "{{origin_country}}",
"promotionCode": "{{promotion_code}}",
"recurrenceType": "{{recurrence_type}}",
"trackingNumber": "{{tracking_number}}",
"customerSegment": "{{customer_segment}}",
"estimatedCharge": 0,
"integrationType": "{{integration_type}}",
"leadTimeMinutes": 0,
"pickupBookingId": "{{pickup_booking_id}}",
"pickupWindowEnd": "{{pickup_window_end}}",
"recurringPickup": false,
"bookingCreatedAt": "{{booking_created_at}}",
"liftgateRequired": false,
"originPostalCode": "{{origin_postal_code}}",
"contactlessPickup": false,
"hazardousMaterial": false,
"pickupWindowStart": "{{pickup_window_start}}",
"residentialPickup": false,
"carrierResponseCode": "{{carrier_response_code}}",
"bookingConfirmationId": "{{booking_confirmation_id}}",
"confirmationCreatedAt": "{{confirmation_created_at}}",
"carrierBookingReference": "{{carrier_booking_reference}}"
}
}Parameters
{
"user_id": "string - pseudonymous identifier for the authenticated or recognized user completing the schedule",
"event_id": "string - globally unique identifier for this event activation, used for event-level deduplication",
"order_id": "string - unique identifier for the commercial order or fulfillment order associated with the shipment",
"platform": "string - application platform on which scheduling was completed, such as web, iOS, Android, partner_api, or internal",
"carrier_id": "string - unique identifier for the carrier assigned to perform the pickup",
"session_id": "string - identifier for the digital session in which pickup scheduling was completed, when applicable",
"device_type": "string - normalized device class used in a digital scheduling flow, such as desktop, mobile, tablet, or unknown",
"origin_city": "string - normalized city name for the pickup origin",
"pickup_type": "string - operational pickup classification, such as on_demand, scheduled, recurring, drop_trailer, or parcel",
"shipment_id": "string - unique identifier for the shipment associated with the scheduled pickup",
"volume_unit": "string - unit for total_volume, such as m3, ft3, or in3",
"weight_unit": "string - unit for total_weight, restricted to an approved code such as kg or lb",
"total_volume": "number - total declared shipment volume included in the pickup request, when supplied",
"total_weight": "number - total declared shipment weight included in the pickup request",
"event_version": "string - version of the event payload contract used by the producer",
"package_count": "integer - total number of packages, handling units, pallets, or parcels included in the pickup request",
"service_level": "string - normalized transportation or pickup service level selected for the shipment",
"source_system": "string - system that emitted the event, such as web application, TMS, mobile application, or carrier booking service",
"attempt_number": "integer - sequential scheduling attempt number for the pickup_request_id, beginning at 1",
"correlation_id": "string - identifier used to trace the scheduling transaction across digital, integration, TMS, and carrier systems",
"event_timestamp": "string - UTC ISO 8601 timestamp when the pickup booking became durably confirmed",
"organization_id": "string - unique identifier for the shipper organization or business entity",
"pickup_timezone": "string - IANA timezone applicable to the pickup location and pickup window",
"reschedule_flag": "boolean - indicates that the completion replaced a previously confirmed pickup schedule",
"completion_method": "string - mechanism that finalized the booking, such as synchronous_carrier_confirmation, asynchronous_confirmation, manual_confirmation, or standing_schedule",
"completion_status": "string - terminal scheduling result; must equal confirmed for a valid completion event",
"lead_time_minutes": "integer - whole minutes from event_timestamp to confirmed_window_start, based on UTC timestamps",
"pickup_address_id": "string - tokenized or master-data identifier for the physical pickup address",
"pickup_request_id": "string - stable identifier for the pickup request across attempts, confirmations, and reschedules",
"commodity_category": "string - normalized high-level category of goods included in the pickup",
"origin_postal_code": "string - postal or ZIP code for the pickup origin",
"origin_region_code": "string - standardized state, province, or administrative region code for the pickup origin",
"schedule_flow_type": "string - scheduling workflow type, such as new_booking, reschedule, recurring_pickup, bulk_booking, or return_pickup",
"scheduling_channel": "string - channel used to schedule the pickup, such as web, mobile_app, API, call_center, EDI, or operations_console",
"customer_account_id": "string - unique identifier for the customer account responsible for the shipment",
"origin_country_code": "string - ISO 3166-1 alpha-2 country code for the pickup origin",
"shipper_location_id": "string - identifier for the customer facility, warehouse, store, or site where pickup will occur",
"carrier_service_code": "string - carrier-defined code for the booked pickup or transportation service",
"confirmed_window_end": "string - ISO 8601 timestamp for the end of the confirmed pickup window",
"requested_window_end": "string - ISO 8601 timestamp for the end of the pickup window requested by the user",
"confirmed_pickup_date": "string - local calendar date confirmed by the scheduling system in YYYY-MM-DD format",
"contact_required_flag": "boolean - indicates whether the carrier must contact the pickup location before arrival",
"requested_pickup_date": "string - local calendar date initially requested for pickup in YYYY-MM-DD format",
"confirmed_window_start": "string - ISO 8601 timestamp for the start of the confirmed pickup window",
"requested_window_start": "string - ISO 8601 timestamp for the start of the pickup window requested by the user",
"booking_confirmation_id": "string - unique confirmation or booking reference returned by the authoritative scheduling system",
"confirmation_latency_ms": "integer - elapsed milliseconds between final schedule submission and receipt of durable confirmation",
"hazardous_material_flag": "boolean - indicates whether the pickup includes regulated hazardous materials",
"special_instructions_flag": "boolean - indicates whether pickup instructions beyond standard service requirements were provided"
}Source Data
Transportation Management System (TMS), Carrier Booking APIs, Digital Analytics, Mobile Applications, EDI Integrations, and Customer Service Scheduling Systems
Dependencies
[ "pickup_scheduling_started", "pickup_schedule_submitted", "pickup_slot_selected", "pickup_scheduling_failed", "pickup_scheduling_abandoned", "pickup_rescheduled", "pickup_cancelled", "shipment_id", "pickup_request_id", "booking_confirmation_id", "event_timestamp", "carrier_id", "confirmed_window_start", "confirmed_window_end", "pickup_timezone" ]
Report Attributes
Event Date Confirmed Pickup Date Carrier Carrier Service Customer Account Shipper Organization Shipper Location Origin Country Origin Region Origin City Scheduling Channel Platform Device Type Schedule Flow Type Pickup Type Service Level Pickup Lead Time Band Confirmation Latency Band First-Attempt Completion Indicator Reschedule Indicator Hazardous Material Indicator Commodity Category
Segment Eligibility
true
Governance
Dimensions
Related Dimensions
Derived Dimensions
Derived Entities
Derived Metrics
Governance & Metadata
GitHub
catalog/events/pickup-scheduling-completion.yml