Status Operational Status

Add an Operator (Driver)

  • Last edited on

Use this to add an operator (driver) to the system.

Request Data 

Required Information
Name Description
action adminoperators
operation add
format xml
fname Operator's first name. An arbitrary text string of up to 32 characters in length.
lname Operator's last name. An arbitrary text string of up to 32 characters in length.
location The location that the operator is assigned to.
pin Must be set to a 4 digit number. This parameter lets users add an operator's PIN, which is mandatory for logging into a tablet.

Important: Either a tag number or an exsid must be supplied when adding an operator.
Optional Information
logvers logvers 2 includes the operator database id in the reply XML.
  • 1 This is the standard output.
  • 2 This includes the operator dbid in the XML reply.

Note: If no logvers is supplied logvers=1 will be assumed.
tag Zonar Systems™ RFID tag number of the operator. A non zero 32 bit integer quantity.

Important: If not specified then an exsid must be supplied.
empnum Operator's employee number. An arbitrary text string of up to 20 characters in length. If specified this must be unique.
cdl Operator's Commercial Drivers License number. An arbitrary text string of up to 20 characters in length. If specified this must be unique.
exsid External System Identifier. An arbitrary text string of up to 40 characters in length. This must be unique per operator.

Important: If not specified then an tag must be supplied.

Data Returned

A success or error message.

Example Request

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&customer=zzo2544&action=adminoperators&operation=add&format=xml&fname=John&lname=Smith&tag=1234567&location=Seattle&pin=1234&exsid=231

Example Success Reply

<?xml version="1.0"?>
<success ver="1">
 <action>adminoperators</action>
</success>

Example Error Reply

<?xml version="1.0"?>
<error ver="1.0">
 <action>adminoperators</action>
 <code>202</code>
 <message>Failed to add operator. The Zonar Tag Number 3 is being used by another driver. Please choose another. errcode: 1</message>
</error>

Driver Management