GeoLocationEvent

Event occured in the mobile app

The GeoLocationEvent entity represents event occurred in the field and usually reported by a mobile application like the SLA.Field Sales app. Example for such events are: Invoice created, Visit Started, Route started, Route closed , etc.

It can be used to analyze the progress and performance of the mobile fleet in the field.

This entity is available for read via the Data API

Field name	Field data type	Description
DMS_ROWID	string	the PK of the record
amount	decimal	the amount of the event
longitude	decimal	the longitude portion of the event location
latitude	decimal	the latitude portion of the event location
duration	integer	the duration of the event ( only if internalEventTypeCode==105, e.g. VisitStop )
distance	integer	the distance from the customer in meters
inRoute	integer	0 if the event is not planned , 1 if the event is planned, e.g. having a corresponding EstimatedRouteStop
vehicleId	string	the DMS_ROWID of the corresponding Vehicle
eventType	integer
sourceAppCode	string	the code of the mobile app generated the event
accountNo	string	the customer number
accountName	string	the customer name
geohash	string	the longitude and latitude represented as geohash
geo8hash	string	the longitude and latitude represented as geohash limited to 8 characters
geo6hash	string	the longitude and latitude represented as geohash limited to 6 characters
refDocumentNo	string	the document number generated from the mobile app (like the invoice number for example)
dateCreated	datetime	the date and time of the of the event occurrence
dayCreated	date	the day (date without time ) when the event occured
dateProcessed	datetime	The date and time when the event was received by the server
userCreated	string	the user (mobile) created the event
syncLogId	string	the identifier of the syncpacket from which the event was obtained
internalEventTypeName	string	user friendly name of the event type based on the GeoLocationEventTypes entity
internalEventTypeCode	integer	The estimated geoLocationEventType Code - see the GeoLocationEventTypes below.
visitNo	string	the unique code of the visit (generated on visit start by the mobile app). there might be multiple events occuring during a single visit
driverCode	string	the unique code of the driver
vehicleCode	string	the unique code of the vehicle
divisionName	string	the name of the division as per the route, vehicle, driver
territoryName	string	the name of the territory assigned to the route, vehicle, driver

Every GeoLocationEvent has a internalEventTypeCode field which indicates the type of the event as sent from the mobile app.

The following internalEventTypeCode values are sent by the SLA.Field Sales app:

Code	Event Type	Description
0	Sales Order	Sales Order was created
1	Invoice	Invoice was created
5	Skip	Customer was skipped
7	Payment	Payment was collected
9	Return Order	Return Order was created
12	Inventory Load	Inventory Load Request sent
13	Inventory Unload	Inventory Unload Request sent
15	Action	Custom action was competed
101	Start Visit	Visit was started
105	Stop Visit	Visit was completed
166	Route Start	A route was started
167	Route Stop	A route was closed
201	Survey	A survey was completed
303	Update Customer Location	Customer location was updated
305	Truck Receive	Truck Recieve was completed
306	Truck Send	Truck Send was completed
307	Reschedule	Customer visit was rescheduled
308	Receive Inventory	Inventory was received
1000	EWallet TopUp
1001	EWallet Payment
1002	EWallet Card Assigned
1003	Stock Count	Stock Count was completed
1004	Sales Quote	Sales Quote was created