Guides

Order Event Structure

Suggest Edits

Order Event

Property NameDescription
event*
(required)		"event": "order"
value should be in small case. (Like 'order' NOT 'ORDER')
properties*
(required)		"properties": { "orderId": "1234" "amount": 100.25 "status": "pending" }

Required properties

All properties related to order should be present inside properties, You be sent your custom event properties here too.
userProperties*
(required)		"userProperties": { "uid": '123456' //require properties, unique id of customer. "email": "[email protected]", "phone": "123-456-7890" }
All properties related to customer should be present inside userProperties, You be sent your custom user properties here too.
time*
(required)		"time": {
sentAt: 1629131492259
}
sentAt : The date and time when the event was sent.
appClientId*
(required)		"appClientId": "API_KEY"
Unique id represent the source in Richpanel.
Change for each website, can be found in Richpanel app.

Order Properties

Property NameDescription
orderId*
(required)		"orderId": "1234"
Unique id of order.
orderDbKey
(required)		"orderDbKey": 876541234
If the order has a different database id, it must be provided here or can be kept the same as orderId. We use this to create a link to the order management portal.
amount*
(required)		"amount": 100.25
Total amount of the order.
currency"currency": "USD"
Currency in which the order amount's are defined.
createdAt"createdAt": 1629131492259
The date and time (ISO 8601 format) when the order was created.
updatedAt"updatedAt":1629131492259
The date and time (ISO 8601 format) when the order was updated.
status"status": "processing"
Example: cancelled, proessing, confirmed, or any custom text.
Something that suits your system.
fulfillmentStatus"fulfillmentStatus": "fulfilled"
The order's status in terms of fulfilled line items.
Example: fulfilled, unfulfilled, partially_fulfilled, or any custom text. Something that suits your system.
financialStatus"financialStatus": "paid"
The status of payments associated with the order. Example : paid, pending, partially_refunded, refunded, authorized, or any other text. Something that suits your system.
paymentMethod"paymentMethod": "paypal"
Name of the payment method used.
processingMethod"processingMethod": "express",
statusUrl"statusUrl": "https://ecome.com/26376372301/orders/21a1de0135e78dcda5f9fa2bac72587f/authenticate?key=cf1180676b7f5ec2d83e0bf1e563b126",
discountAmount
shippingAmount
taxAmount
tipAmount
amount		Float properties
"discountAmount": 10.50
"shippingAmount": 25
"taxAmount": 12.25
"tipAmount": 5
amount: 100.00

"discountAmount": total discount amount for the order.
"shippingAmount": Total shipping amount of the order.
"taxAmount": Total amount spend in tax for the order.
tipAmount: Total tip collected from the order.
amount: Total amount of the order.
billingPhone
billingEmail
billingFirstName
billingLastName
billingAddressLine1
billingAddressLine2
billingCity
billingState
billingCountry
billingPostcode		All string properties, and optional
billingPhone: The phone number at the billing address.
billingEmail: The Email at the billing address.
billingFirstName: The first name of the person associated with the payment method.
billingLastName: The last name of the person associated with the payment method.
billingAddressLine1: The street address of the billing address.
billingAddressLine2: An optional additional field for the street address of the billing address.
billingCity: The city, town, or village of the billing address.
billingState: The name of the region (for example, province, state, or prefecture) of the billing address.
billingCountry: The name of the country of the billing address.

billingPostcode: The postal code (for example, zip, postcode, or Eircode) of the billing address.



shippingPhone
shippingEmail
shippingFirstName
shippingLastName
shippingAddressLine1
shippingAddressLine2
shippingCity
shippingState
shippingCountry
shippingPostcode		All string properties, and optional
shippingPhone: The phone number at the shipping address.
shippingEmail: The Email at the shipping address.
shippingFirstName: The first name of the person associated with the shipping address.
shippingLastName: The last name of the person associated with the shipping address.
shippingAddressLine1: The street address of the shipping address.
shippingAddressLine2: An optional additional field for the street address of the shipping address.
shippingCity: The city, town, or village of the shipping address.
shippingState: The name of the region (for example, province, state, or prefecture) of the shipping address.
shippingCountry: The name of the country of the shipping address.
shippingPostcode: The postal code (for example, zip, postcode, or Eircode) of the shipping address.
shippingMethod"shippingMethod": "Free Shipping 2-5 Days",

Name of the shippping method used.
coupons"coupons": ["NEW_USER", "FREE20"]
Coupons use in the order, while placing the order.
items*
(required)		"items": [{
"id": "2493989519418",
"price": 49.99,
"optionId": "31858336956474",
"sku": "A31SSUJZ99COMTL1",
"name": "My Product - L",
"grams": 454,
"quantity": 1,
}]
id: The ID of the product.
price: Price for single quantity of the variant product.
quantity:The number of items that were purchased.
optionId: The ID of the product variant.
sku: The item's SKU (stock keeping unit).
name: The name of the product variant.
grams: The weight of the item in grams.
fulfillment"fulfillment": [{
"id": "2488098717754", //required
"createdAt": 1608611436000,
"updatedAt": 1609187662000,
"status": "delivered",
"tracking": [{
"trackingNumber": "1234578162783",
"trackingCompany": "USPS",
"shippingDate": 1608611436000,
"trackingUrl": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=1234578162783"
}],
"items": [{
"id": "2493989519418", //required, Product base id
"price": 49.99, //required
"optionId": "31858336956474", //product variant id
"sku": "A31SSUJZ99COMTL1",
"name": "My Product - L", //required
"grams": 454,
"quantity": 1, //required
}]
}

id : Unique Id of fulfillment object.
status: Current status of fulfillment.
tracking: Tracking details of fulfillment.
items: Product details of fulfillment.

User Properties Object (userProeprties)

Example:
{
event: "order",
properties: {},
userProperties: {} // User Properties
}

Property NameDescription
uid*
(required)		Unique Id of the user.
phonePhone number of the user.
emailEmail address of the user.
firstNameFirst name of the user
lastNameLast name of the user.
billingAddress"billingAddress": {
"firstName": "Shubhanshu",
"lastName": "Chouhan",
"city": "LOCKPORT",
"state": "Illinois",
"stateCode": "IL",
"country": "United States",
"countryCode": "US",
"postcode": "60441",
"phone": null,
"address1": "201B, lotus chs",
"address2": "",
"company": ""
},

Billing details of the customer.
shippingAddress"shippingAddress": {
"firstName": "Shubhanshu",
"lastName": "Chouhan",
"city": "LOCKPORT",
"state": "Illinois",
"stateCode": "IL",
"country": "United States",
"countryCode": "US",
"postcode": "60441",
"phone": null,
"address1": "201B, lotus chs",
"address2": "",
"email": "[email protected]"
},
Shipping details of the user.
Custom PropertiesAny other properties which belong's to user.

Sample Order Event

{
	"event": "order",
	"properties": {
		"orderId": "11111",
		"orderDbKey": 2589211394106, 
		"email": "[email protected]",
		"amount": 169.97, //required
		"subTotalPrice": 159.97,
		"totalWeight": 2812,
		"weightUnit": "grams",
		"taxAmount": 10,
		"currency": "USD",
    "status": "processing",
		"discountAmount": 149.97,
		"coupons": [
			"code1"
		],
		"deleteFulfillmentAndCreate": true, 
		"statusUrl": "https://abc.com/10672582/orders/fd1051b534691f2cd00495d6f2fcdd45", //tracking url if any
		"paymentStatus": "partially_refunded",
		"fulfillmentStatus": "fulfilled",
		"tipAmount": 0,
		"orderName": "#606243", 
		"paymentMethod": "paypal",
		"paymentGatewayNames": [
			"paypal"
		],
		"processedAt": 1606758898000,
		"processingMethod": "express",
		"items": [{ //required
				"id": "2493989519418", 
				"price": 49.99, //required
				"optionId": "31858336956474", 
				"sku": "A31SSUJZ99COMTL1",
				"name": "My Product - L", 
				"grams": 454,
				"quantity": 1, //required
				"imageURL": [
					"https://cdn.abc.com/s/files/1/1067/2582/products/product1.jpg?v=1605207140"
				]
			},
			{
				"id": "4586759913530",
				"price": 49.99,
				"optionId": "32132068311098",
				"sku": "A31SSUGI85ODGDM1",
				"name": "My Product - M",
				"grams": 454,
				"quantity": 1,
				"imageURL": [
					"https://cdn.abc.com/s/files/1/1067/2582/products/product2.jpg?v=1605207140"
				]
			}
		],
		"billingPhone": null,
		"billingCity": "LOCKPORT",
		"billingPostcode": "60441",
		"billingState": "Illinois",
		"billingCountry": "United States",
		"billingAddressLine1": "201B, lotus CHS",
		"billingAddressLine2": "",
		"firstName": "Shubhanshu",
		"lastName": "Chouhan",
		"shippingPhone": null,
		"shippingCity": "LOCKPORT",
		"shippingPostcode": "60441",
		"shippingState": "Illinois",
		"shippingCountry": "United States",
		"shippingAddressLine1": "201B, lotus CHS",
		"shippingAddressLine2": "",
		"shippingFirstName": "Shubhanshu",
		"shippingLastName": "Chouhan",
		"shippingMethod": "Free Shipping 2-5 Days",
		"fulfillment": [{
			"id": "2488098717754", //required
			"createdAt": 1608611436000,
			"updatedAt": 1609187662000,
			"status": "delivered",
			"quantity": 6,
			"tracking": [{
				"trackingNumber": "1234578162783",
				"trackingCompany": "USPS",
				"shippingDate": 1608611436000,
				"trackingUrl": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=1234578162783"
			}],
			"items": [{ //required
					"id": "2493989519418", //required, Product base id
					"price": 49.99, //required
					"optionId": "31858336956474", //product variant id
					"sku": "A31SSUJZ99COMTL1",
					"name": "My Product - L", //required
					"grams": 454,
					"quantity": 1, //required
				},
				{
					"id": "4586759913530",
					"price": 49.99,
					"optionId": "32132068311098",
					"sku": "A31SSUGI85ODGDM1",
					"name": "My Product - M",
					"grams": 454,
					"quantity": 1,
				}
			]
		}],
    "shippingAmount": 10.45
	},
	"userProperties": { //required
		"uid": "[email protected]", //required, Customer user id in database
		"phone": null,
		"email": "[email protected]",
		"firstName": "Shubhanshu",
		"lastName": "Chouhan",
		"billingAddress": {
			"firstName": "Shubhanshu",
			"lastName": "Chouhan",
			"city": "LOCKPORT",
			"state": "Illinois",
			"stateCode": "IL",
			"country": "United States",
			"countryCode": "US",
			"postcode": "60441",
			"phone": null,
			"address1": "201B, lotus chs",
			"address2": "",
			"company": ""
		},
		"shippingAddress": {
			"firstName": "Shubhanshu",
			"lastName": "Chouhan",
			"city": "LOCKPORT",
			"state": "Illinois",
			"stateCode": "IL",
			"country": "United States",
			"countryCode": "US",
			"postcode": "60441",
			"phone": null,
			"address1": "201B, lotus chs",
			"address2": "",
			"email": "[email protected]"
		},
	},
	"time": {
		"sentAt": 1609966695361 //when event occurred, use this property in case you're updating old orders, or synchronizing old orders
	},
	"appClientId": "API_KEY" //change for each website, can be found in Richpanel app.
}

Note:

  • Make sure to follow the proper format
  • Don't send empty values.

Updated about 3 years ago