Trendsic Platform Service

<back to all web services

DispatchReportRequest

Requires Authentication
The following routes are available for this service:
POST,OPTIONS/v1/dashboard/dispatch
DispatchReportRequest Parameters:
NameParameterData TypeRequiredDescription
FromDatebodyDateTimeNo
ToDatebodyDateTimeNo
LocationIdsbodyList<Guid>No
DispatchReportResponse Parameters:
NameParameterData TypeRequiredDescription
StatsformList<DashboardStatTile>No
UnitformstringNo
TrendformList<DispatchReportDayRow>No
ByModuleformList<DispatchReportModuleRow>No
ByLaneformList<DispatchReportLaneRow>No
ByTruckformList<DispatchReportTruckRow>No
ByDriverformList<DispatchReportDriverRow>No
JobsformList<DispatchReportJobRow>No
IncidentsformList<DispatchReportIncidentRow>No
HoldsformList<DispatchReportHoldRow>No
ResponseStatusformResponseStatusNo
DashboardStatTile Parameters:
NameParameterData TypeRequiredDescription
KeyformstringNo
LabelformstringNo
ValueformdoubleNo
PreviousValueformdouble?No
UnitformstringNo
DeltaPctformdouble?No
DispatchReportDayRow Parameters:
NameParameterData TypeRequiredDescription
LabelformstringNo
LoadsformintNo
RevenueformdoubleNo
PayformdoubleNo
QtyformdoubleNo
AvgCycleMinsformdouble?No
DispatchReportModuleRow Parameters:
NameParameterData TypeRequiredDescription
ModuleformstringNo
LoadsformintNo
QtyformdoubleNo
RevenueformdoubleNo
PayformdoubleNo
DispatchReportLaneRow Parameters:
NameParameterData TypeRequiredDescription
SupplierNameformstringNo
SourceLabelformstringNo
LoadsformintNo
QtyformdoubleNo
RevenueformdoubleNo
AvgCycleMinsformdouble?No
DispatchReportTruckRow Parameters:
NameParameterData TypeRequiredDescription
TruckLabelformstringNo
DriverLabelformstringNo
LoadsformintNo
QtyformdoubleNo
RevenueformdoubleNo
PayformdoubleNo
AvgCycleMinsformdouble?No
DaysActiveformintNo
DispatchReportDriverRow Parameters:
NameParameterData TypeRequiredDescription
DriverformstringNo
DriverContactIdformint?No
LoadsformintNo
QtyformdoubleNo
PayformdoubleNo
DaysActiveformintNo
UnpricedformintNo
DispatchReportJobRow Parameters:
NameParameterData TypeRequiredDescription
JobCodeformstringNo
CustomerformstringNo
CargoformstringNo
RouteformstringNo
MilesformintNo
Revenueformdouble?No
Payformdouble?No
MarginPctformdouble?No
ClosedUtcformDateTime?No
DispatchReportIncidentRow Parameters:
NameParameterData TypeRequiredDescription
KindformstringNo
OpenedformintNo
ResolvedformintNo
AvgResolveMinsformdouble?No
DispatchReportHoldRow Parameters:
NameParameterData TypeRequiredDescription
ScopeKindformstringNo
HoldsformintNo
PausedMinsformintNo
WeatherformintNo
FromIncidentsformintNo

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 /v1/dashboard/dispatch HTTP/1.1 
Host: api.dev.dynamics.trendsic.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	FromDate: 0001-01-01,
	ToDate: 0001-01-01,
	LocationIds: 
	[
		00000000000000000000000000000000
	]
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Stats: 
	[
		{
			Key: String,
			Label: String,
			Value: 0,
			PreviousValue: 0,
			Unit: String
		}
	],
	Unit: String,
	Trend: 
	[
		{
			Label: String,
			Loads: 0,
			Revenue: 0,
			Pay: 0,
			Qty: 0,
			AvgCycleMins: 0
		}
	],
	ByModule: 
	[
		{
			Module: String,
			Loads: 0,
			Qty: 0,
			Revenue: 0,
			Pay: 0
		}
	],
	ByLane: 
	[
		{
			SupplierName: String,
			SourceLabel: String,
			Loads: 0,
			Qty: 0,
			Revenue: 0,
			AvgCycleMins: 0
		}
	],
	ByTruck: 
	[
		{
			TruckLabel: String,
			DriverLabel: String,
			Loads: 0,
			Qty: 0,
			Revenue: 0,
			Pay: 0,
			AvgCycleMins: 0,
			DaysActive: 0
		}
	],
	ByDriver: 
	[
		{
			Driver: String,
			DriverContactId: 0,
			Loads: 0,
			Qty: 0,
			Pay: 0,
			DaysActive: 0,
			Unpriced: 0
		}
	],
	Jobs: 
	[
		{
			JobCode: String,
			Customer: String,
			Cargo: String,
			Route: String,
			Miles: 0,
			Revenue: 0,
			Pay: 0,
			MarginPct: 0,
			ClosedUtc: 0001-01-01
		}
	],
	Incidents: 
	[
		{
			Kind: String,
			Opened: 0,
			Resolved: 0,
			AvgResolveMins: 0
		}
	],
	Holds: 
	[
		{
			ScopeKind: String,
			Holds: 0,
			PausedMins: 0,
			Weather: 0,
			FromIncidents: 0
		}
	],
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}