Other Data Type Schema

Documentation for the 'other' data type schema, including required and optional fields, and JSON example.

The "other" data type allows for the integration of generic event data into the Solink platform, accommodating a broad range of applications beyond the predefined retail and restaurant categories. Time is absolute and must adhere to the convention defined here.

Required Object Fields

FieldTypeDescription
dataSourceIdStringUnique identifier of the data source generating the event.
dataTypeStringMust be set to "other" to specify which data type the current event is.
eventTypeStringDescribes the type of event.
eventUniqueIdStringUnique id which identifies the event, unique per location.
schemaVersionStringMust be set to "1" to specify which version of the schema is being used for this event (e.g. "1", "2", etc).
siteExternalIdStringUnique location identifier within the customer's set of locations.
startTimeNumber | StringStart time of the event in either Unix time format milliseconds or ISO-8601 compliant format.

Optional Object Fields

FieldTypeDescription
employeeIdStringUnique employee id to identify the employee involved in the event.
employeeNameStringThe name of the employee involved in the event.
endTimeNumber | StringEnd time of the event in either Unix time format milliseconds or ISO-8601 compliant format.
eventDetailsStringAdditional searchable information about the event.
itemsArrayList of items related to the event
notesStringAdditional notes or comments about the event.
statusStringStatus of the event.

Required Item Object Fields

FieldTypeDescription
descriptionStringDescription of the item.
quantityNumberQuantity of the item, defaults to 1.
timeNumber | StringSpecific time for the item in either Unix time format milliseconds or ISO-8601 compliant format., defaults to event's startTime.
typeStringItem type.

JSON Example

Below is an example of how the "other" data type could be structured in JSON format for submission:

{
  "dataType": "other",
  "schemaVersion": "1",
  "startTime": 1557943653649,
  "endTime": 1557943678649,
  "siteExternalId": "123",
  "dataSourceId": "1",
  "eventUniqueId": "93688-START",
  "eventType": "Start Batch",
  "eventDetails": "Additional Details",
  "employeeId": "27",
  "employeeName": "MICHELLE",
  "status": "START",
  "items": [
    {
      "type": "",
      "quantity": 1.0,
      "description": "",
      "time": 1555898203000
    }
  ]
}