Klaviyo Notify Events and Data Definitions

Overview
Pre-shipment Events
Delivery Journey Events
Return Journey Events
Data Dictionary & Associated Fields

Overview

When Narvar is integrated with Klaviyo, customer data and carrier update information are passed from Narvar to Klaviyo during supported events. Narvar captures customer order data and carrier updates during multiple events.

Pre-shipment Events

Event: Order Confirmation Standard

Event Definition: Notification of an order being confirmed.

Notification Type: order_confirmation

Delivery Journey Events

Event: Just Shipped

Event Definition: Notification indicating that a label has been generated for the shipment.

Notification Type: just_shipped

Event: Shipment Confirmation/On Its Way

Event Definition: Notification indicating that a shipment has been picked up and inserted into the carrier network.

Notification Type: shipment_confirmation_standard

Event: Carrier Delay

Event Definition: Notification of a package experiencing a carrier delay en route to the customer.

Notification Type: delay_overdue

Event: Customs Delay Standard

Event Definition: Notification of a shipment delayed with the carrier due to customs.

Notification Type: customs_delay_standard

Event: Delivery Anticipation Standard

Event Definition: Notification of a shipment scheduled to arrive the next day.

Notification Type: delivery_anticipation_standard

Event: Out for Delivery

Event Definition: Notification of a shipment that's scheduled to arrive that day and is out for delivery.

Notification Type: outfordelivery_standard

Event: Delivered

Event Definition: Notification of a shipment that's been delivered to the destination.

Notification Type: delivered_standard

Event: Delivered To Other Recipient

Event Definition: Notification of a shipment that's been delivered to a recipient other than the actual customer (a neighbor, building reception, office reception, etc).

Notification Type: delivered_to_other_recipient_standard

Event: Missed Delivery

Event Definition: Notification that a carrier unsuccessfully attempted to deliver a package.

Notification Type: delivery_attempt_standard

Returns Journey Events

Event: Returns Initiated

Event Definition: Notification that is sent once a return has been initiated using any return method.

Notification Type: workflow_return_initiated_standard

Event: Returns On Its Way

Event Definition: Notification that a package that's been returned is now en route to the warehouse or final destination where the return will be completed by the brand.

Notification Type: workflow_return_on_its_way_standard

Event: Return Cancellation

Event Definition: Notification that a return has been canceled by the customer.

Notification Type: workflow_return_cancellation_standard

Event: Return Delivered

Event Definition: Notification that a returned package has arrived at its final destination (warehouse, store, etc).

Notification Type: workflow_return_delivered_standard

Data Dictionary & Associated Fields

All fields are strings or array of strings.

Anytime one of the events mentioned above is triggered the following data is captured by Narvar and sent to Klaviyo:

Customer Properties

Customer Email - email
Customer First Name - first_name
Customer Last Name - last_name
Customer Phone Number - phone_number
City - city
Region - region
Country - country
Zip Code - zip

Order Properties

Customer Order Number - order_number
Customer Phone Number - phone
Value of Order - value
Notification Type - notification_type
Notification Lookup I.D. - notification_lookup_id
Notification Triggered - notification_triggered_by_tracking_number
Notification Locale - notification_locale
Notification Date - notification_date
Order Placement Date - placement_date

Billing Properties

Billing Details - billed_to
- First Name - first_name
- Last Name - last_name
- Phone Number - phone
- Phone Number Extension - phone_extension
- Email - email
- Fax - fax
- Language - language
- Address Line 1 - line1
- Address Line 2 - line2
- Address Line 3 - line3
- Address City - city
- Address State - state
- Address Zip - zip
- Address Country - country

Payment Properties

Order Amount - amount
Payment Tax Rate - tax_rate
Payment Tax Amount - tax_amount
Payment Total Amount - payments

Shipment Properties

Shipment Details - shipments (array) {
- Tracking Number - tracking_number
- Tracking URL - tracking_url
- Delivery Status - shipment_status
- Items in the Shipment - items (array) {
  - Product Sku Number - product_sku
  - Item Quantity - quantity
  - Item I.D. - item_id
  - Customer Name - name
  - Item Description - description
  - Item Color - color
  - Item Price - price
  - Item Size - size
  - Order Discount Percent - discount_percent
  - Order DIscount Amount - discount_amount
  - Image URL - image_url
  - Item URL - item_url

}

‘Ship To’ Details - ship_to (array) {

First Name - first_name
Last Name - last_name
Phone Number - phone
Phone Extension - phone_extension
Email - email
Fax Number - fax
Language - language
Address Line 1 - line1
Address Line 2 - line2
Address Line 3 - line3
Address City - city
Address State - state
Address Zip Code - zip
Address Country - country

}

Shipment Date - ship_date
Shipment Carrier - carrier
Shipment Lookup I.D. - lookup_id
Package Status - package_status
Shipment Tiny Tracking URL - tiny_tracking_url
Shipment Notification Date - notification_date
nauth
Estimated Delivery Date - edd
Carrier Shipping Method - carrier_description

}

Pickup Properties

Pickup Details - pickups
- Current Pickup - current_pickup
- Pickups Delivered - pickups_delivered
- Other Pickups - other_pickups

Items in Order Properties

Items in Order - items (array) {
- Product Sku Number - product_sku
- Item Quantity - quantity
- Item I.D. - item_id
- Name - name
- Description - description
- Color - color
- Price - price
- Size - size
- Discount Percent - discount_percent
- Discount Amount - discount_amount
- Item Image URL - image_url
- Item URL - item_url

}

Order Published Date - published_date

Table of Contents