TicketUserServices

<back to all web services

RefreshmentsOverviewRequest

Requires Authentication
Requires any of the roles:Admin, TeamAdminRequired permission:Sales.Total
The following routes are available for this service:
POST/sales/refreshments/overview
RefreshmentsOverviewRequest Parameters:
NameParameterData TypeRequiredDescription
OwnerIdbodyintNo
SeriesIdbodyint?No
FromUtcbodyDateTimeNo
ToUtcbodyDateTimeNo
CompareFromUtcbodyDateTime?No
CompareToUtcbodyDateTime?No
BucketbodystringNo
TopEventsLimitbodyintNo
RecentOrdersLimitbodyintNo
RefreshmentsOverviewResult Parameters:
NameParameterData TypeRequiredDescription
CurrentformRefreshmentsKpisNo
PreviousformRefreshmentsKpisNo
DeltaformRefreshmentsDeltasNo
TrendformList<SalesTrendBucket>No
PreviousTrendformList<SalesTrendBucket>No
ProductsformList<RefreshmentsProduct>No
EventsformList<RefreshmentsEventRow>No
ByHourOfDayformList<SalesHourBucket>No
ByDayOfWeekformList<SalesDowBucket>No
ByPaymentMethodformList<RefreshmentsPaymentMethodRow>No
RecentOrdersformList<RefreshmentsRecentOrder>No
HasAnyDataEverformboolNo
BucketformstringNo
FreshnessUtcformDateTimeNo
StatusCodeformintNo
MessageformstringNo
RefreshmentsKpis Parameters:
NameParameterData TypeRequiredDescription
RevenueformdecimalNo
RefundedformdecimalNo
UnitsformintNo
OrdersformintNo
AovformdecimalNo
UnitsPerOrderformdecimalNo
AttendanceformintNo
PerCapformdecimalNo
RefreshmentsDeltas Parameters:
NameParameterData TypeRequiredDescription
RevenueformKpiDeltaNo
RefundedformKpiDeltaNo
UnitsformKpiDeltaNo
OrdersformKpiDeltaNo
AovformKpiDeltaNo
PerCapformKpiDeltaNo
KpiDelta Parameters:
NameParameterData TypeRequiredDescription
AbsformdecimalNo
Pctformdouble?No
DirformstringNo
SalesTrendBucket Parameters:
NameParameterData TypeRequiredDescription
BucketformDateTimeNo
RevenueformdecimalNo
TicketsformintNo
RefreshmentsProduct Parameters:
NameParameterData TypeRequiredDescription
TicketTypeIdformintNo
NameformstringNo
UnitsformintNo
RevenueformdecimalNo
OrdersformintNo
LastSoldAtformDateTime?No
RefreshmentsEventRow Parameters:
NameParameterData TypeRequiredDescription
EventIdformintNo
EventNameformstringNo
EventDateformDateTime?No
RevenueformdecimalNo
UnitsformintNo
OrdersformintNo
AttendanceformintNo
PerCapformdecimalNo
SalesHourBucket Parameters:
NameParameterData TypeRequiredDescription
HourformintNo
RevenueformdecimalNo
OrdersformintNo
TicketsformintNo
SalesDowBucket Parameters:
NameParameterData TypeRequiredDescription
DowformintNo
RevenueformdecimalNo
OrdersformintNo
TicketsformintNo
RefreshmentsPaymentMethodRow Parameters:
NameParameterData TypeRequiredDescription
PaymentMethodIdformstringNo
RevenueformdecimalNo
UnitsformintNo
OrdersformintNo
RefreshmentsRecentOrder Parameters:
NameParameterData TypeRequiredDescription
TicketIdformintNo
CreatedAtformDateTimeNo
EventNameformstringNo
AmountformdecimalNo
UnitsformintNo
PaymentMethodIdformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /sales/refreshments/overview HTTP/1.1 
Host: stubbur-app.azurewebsites.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	ownerId: 0,
	seriesId: 0,
	fromUtc: 0001-01-01,
	toUtc: 0001-01-01,
	compareFromUtc: 0001-01-01,
	compareToUtc: 0001-01-01,
	bucket: String,
	topEventsLimit: 0,
	recentOrdersLimit: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	current: 
	{
		revenue: 0,
		refunded: 0,
		units: 0,
		orders: 0,
		aov: 0,
		unitsPerOrder: 0,
		attendance: 0,
		perCap: 0
	},
	previous: 
	{
		revenue: 0,
		refunded: 0,
		units: 0,
		orders: 0,
		aov: 0,
		unitsPerOrder: 0,
		attendance: 0,
		perCap: 0
	},
	delta: 
	{
		revenue: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		refunded: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		units: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		orders: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		aov: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		perCap: 
		{
			abs: 0,
			pct: 0,
			dir: String
		}
	},
	trend: 
	[
		{
			bucket: 0001-01-01,
			revenue: 0,
			tickets: 0
		}
	],
	previousTrend: 
	[
		{
			bucket: 0001-01-01,
			revenue: 0,
			tickets: 0
		}
	],
	products: 
	[
		{
			ticketTypeId: 0,
			name: String,
			units: 0,
			revenue: 0,
			orders: 0,
			lastSoldAt: 0001-01-01
		}
	],
	events: 
	[
		{
			eventId: 0,
			eventName: String,
			eventDate: 0001-01-01,
			revenue: 0,
			units: 0,
			orders: 0,
			attendance: 0,
			perCap: 0
		}
	],
	byHourOfDay: 
	[
		{
			hour: 0,
			revenue: 0,
			orders: 0,
			tickets: 0
		}
	],
	byDayOfWeek: 
	[
		{
			dow: 0,
			revenue: 0,
			orders: 0,
			tickets: 0
		}
	],
	byPaymentMethod: 
	[
		{
			paymentMethodId: String,
			revenue: 0,
			units: 0,
			orders: 0
		}
	],
	recentOrders: 
	[
		{
			ticketId: 0,
			createdAt: 0001-01-01,
			eventName: String,
			amount: 0,
			units: 0,
			paymentMethodId: String
		}
	],
	hasAnyDataEver: False,
	bucket: String,
	freshnessUtc: 0001-01-01,
	statusCode: 0,
	message: String
}