Contractors

1. On the top menu bar, click System Management ( ) > Administration > General > Contractors
2. On the Contractor Summary page, click Add a Contractor
3. On the Add a Contractor page, fill in the fields. See Modify Contractor, step 3, below

1. On the Contractor Summary page, in the Name column, click the contractor
2. On the Contractor Details page, click Modify this Contractor

3. On the Modify a Contractor / Add an Contractor page, fill in the fields:

   Contractor Locator Information

    

   Field	Description
   Description	A note about or description of the contractor
   Name	The name of the contractor

    

   Email Information

    

   Email	Description
   Pager	Email address of contractor's pager
   Primary	Contractor's most important or preferred email address to receive tickets from you. If unknown, contact the contract locator
   Secondary	Contractor's backup or less important email address

    

   Ticket Management Information

   Use these settings to let contractors be assigned tickets and work on them

   Setting	Description
   Allow Tickets to be Assigned to this Contractor	Check to allow tickets to be assigned to this contractor To send the contract locator's phone number with the positive response to the excavator, add a callback number for the contract locator.  You must configure the callback feature: Excavator Positive Response Settings
   Allow this Contractor to Enter Responses for Tickets	Check to allow contractor to respond to tickets Positive response to one call center: Allows contractor to send positive responses to the one call center Positive response to excavator: Allows contractor to send positive responses to the excavator
   Add Response to Tickets when Assigned to this Contractor	Choose the response to be added to tickets assigned to this contractor By default responses close tickets. To keep tickets open, check the box for Tickets Will Remain Open after a Response is Added

    

4. Click Save

1. On the Contractor Details page, click Reset Contractor Authentication Code. Result: The page reloads and a new code is generated

   If receiving responses from a contract locator, resetting this authentication code prevents their responses from being received until they update their system with this new code.

1. On the Contractor Details page, click Generate Contractor Response Information

2. The Contract Locator Response Information window appears. Send this information to the contract locator, so they can configure their system with the response codes needed to respond to tickets and the authentication code identifying the company whose tickets they are updating.

    

   Field	Description
   Authentication Code	The code that identifies the company the contractor is responding to
   Company Name	The name of your contractor
   Contract Locator	The name of the contractor
   One Call Center	The organization that receives dig requests from excavators sends them in tickets to companies that own facilities
   Registration Code	The code that identifies the company the contract locator is working for (in some cases, the registration code identifies the facility owned by the company)
   Response	The update to the ticket. Responses can be complete or ongoing and can be used for positive responses to one call centers and excavators
   Response Code	The code that identifies the response. Contract locators send these codes to respond to tickets

    

To assign tickets to a contract locator, see Ticket Assigned Notifications

1. On the top menu bar, click System Management ( )>Administration>Ticket Management>Ticket Notifications
2. On the Ticket Notifications Overview page, in the left column, click End of Day Audit Notifications

3. On the End of Day Audit Notifications page, click Add an End of Day Audit Notification

    

   Where to Send the Notification

    

   Notification	Description
   To a recipient defined for my company	Choose recipient
   To an email address I specify	Type email address
   To a device defined for my company	Choose device. To set up devices, see Devices.

    

    

   When to Send Notification

   Choose when to send the notification.

    

   Description for the Notification

   Type the description (name or notes).

    

   Review the notification

   Click Back to go back and make corrections

    

4. Click Finish. The End of Day Audit Notification Detail page appears

Contact Irth Solutions support for a document that can be sent to the Contract Locator on the web service specifics.

Example

This is the protocol the contract locator must use to send responses back to UtiliSphere by webservice.