Internal Use Agreements

You must have Internal Use Service option turned on at your location (within the Agreement Types rates setting) to use these types of agreements.

Internal Use agreements allow you to track the usage of a unit in your fleet that is temporarily unavailable because of internal reasons (for example, an employee is moving a unit from one location to another).

Note: Internal Use agreements do not affect your agreement metrics, such as Length of Use (LOU) or utilization, including on reports.

Setup Requirements

How To ...

Glossary of terms

Battery Level (Current Battery Level (%) / Battery Level Out (%) / Battery Level In (%))

Note: These fields are only displayed for electric vehicles (units with a Fuel Type of Electric). Gas vehicles use Fuel Level.

For electric vehicles in your fleet, the Battery Level (%) represents the percentage measurement of the electric charge remaining in the vehicle's battery (e.g., 80%).

You may see this referenced on unit records, agreements, and reports throughout the application:

  • Current Battery Level (%): The current battery level percentage recorded in the unit's record; when assigning a unit to an open agreement, this field is displayed for reference only and cannot be edited.
  • Battery Level Out (%): The current battery level percentage recorded at the time the unit is assigned to an open agreement; at return during an exchange or close agreement, this field is displayed for reference only and cannot be edited.
  • Battery Level In (%): The current battery level percentage recorded at the time the unit is returned during an exchange or close agreement.

Note that, when an agreement is closed, a unit's returning information is saved as a snapshot, so that if the agreement is re-opened in the future, even if the Fuel Type of that unit has changed to gas, the agreement still displays the battery level at the time the agreement was opened.

Checkout Date

Also known as an agreement's Date Out, this is the date on which an appointment is scheduled for pickup (appointments) or the customer was provided with a unit (agreements) or original unit (exchanges).

In any date field, press T on your keyboard for today's date, and use your keyboard arrows for the next and previous days.

Backdating or predating an agreement: You can only select a past Checkout Date if there is no overlap between two agreements with the same unit. You can only select a future Checkout Date if you assign a Unit Pending status to the agreement by clicking SAVE UNIT PENDING, which displays after selecting a future date. See "Checkout Date and Return Date rules" for the full list of rules regarding agreement date ranges.

Note: When editing an agreement, if you're updating the Checkout or Return Date, you can select a Reason (for example, Parts Availability, Awaiting Customer Authorization, or Work in Progress).

Checkout Date and Return Date rulesClosed

Because units cannot be assigned to agreements with overlapping dates, the following rules apply to the Checkout Date and Return Date (or Expected Return Date) throughout the agreement process.

When opening an agreement:

  • the Checkout Date:
    • must be no later than now, the current date and time.
    • must be on or later than the Service Start Date of the assigned unit.
    • must be later than the most recent Return Date for the assigned unit and before the Checkout Date of the most recent agreement for the unit, if applicable.

    For example, if today is 3/10/2021 and a unit was assigned to agreements from 2/25/2021 - 2/26/2021, then 3/1/2021 - 3/3/2021, then an agreement can be opened between these agreements, if it starts on, say, 02/27/2021, as long as the expected Return Date and time is prior to 3/1/2021.

  • the Expected Return Date:
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When editing an agreement:

  • the Checkout Date:
    • must be no later than now, the current date and time.
    • must be on or later than the Service Start Date of the assigned unit.
    • must be later than the most recent Return Date for the assigned unit.
  • the Expected Return Date:
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When closing an agreement:

Note: The Checkout Date and Return Date are unavailable when performing a quick return.

  • the Return Date:
    • must be now (today's date) or prior to today's date
    • must be later than the Checkout Date
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When reopening an agreement:

  • the Checkout Date:
    • remains the same as it was the last time it was updated.
    • must follow the same rules as when editing an agreement.
  • the Expected Return Date:
    • remains the same as it was the last time it was updated.
    • must follow the same rules as when editing an agreement.

When returning a unit during a unit exchange:

  • the Checkout Date cannot be edited.
  • the Return Date:
    • must be no later than now, the current date and time.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When assigning a replacement unit during a unit exchange:

  • the Checkout Date must be the same as the Return Date of the unit being returned during the exchange.
  • the Expected Return Date:
    • must be no later than now, the current date and time.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When unvoiding an agreement:

  • the Checkout Date:
    • remains the same as it was the last time it was updated.
    • must not conflict with the Checkout Date of another agreement; if so, a message is displayed: "Un-voiding agreement XXXXXX conflicts with agreement YYYYYYY. Agreement XXXXXX cannot be UN-voided".
  • the Expected Return Date:
    • remains the same as it was the last time it was updated.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

Fuel Level

Note: These fields are only displayed for gas vehicles (units with a Fuel Type of Gas). Electric vehicles use Battery Level.

For gas vehicles in your fleet, the Fuel Level represents the amount of fuel in the unit's tank in eighths or sixteenths, depending on your system settings.

You may see this referenced on unit records, agreements, and reports throughout the application:

Other fuel-related fields:

  • Current Fuel Level: The current amount of fuel in the unit's tank; when assigning a unit to an open agreement, this field is displayed for reference only and cannot be edited.
  • Fuel Level Out: The current fuel level amount recorded at the time the unit is assigned to an open agreement; during an exchange (for the returning unit) or close agreement, this field is displayed for reference only and cannot be edited.
  • Fuel Level In: The current fuel level amount recorded at the time the unit is returned during an exchange or close agreement.

Turn on a Low Fuel or Missing Fuel alert, so you can be notified when the fuel level of a unit is less than 1/4, when a unit is returned with less fuel than the Fuel Level Out. See "Alerts: Alerts Panel & Email Alerts" for more information.

Note: Fuel and mileage may be automatically retrieved from a vehicle (for example, though an integration with TSD Telematics). In some cases, you may manually edit these values, but refer to the Help topic on your integration for more information.

Current Miles, Miles Out, Miles In

Updates to this field are logged in the unit history, accessible via the History button on the side panel of a unit record. See "Unit History (Event Logging)" for more information.

The Current Miles on a unit record reflects the current odometer reading of the unit.

Other odometer-related fields:

  • Miles In: The unit's odometer reader at the time of return from an agreement or exchange. Depending on your manufacturer, this may be Customer Miles In and Dealer Miles In on Delivery and Collection agreements.
  • Miles Out: The unit's odometer reading, at the time the unit is assigned to an agreement or exchange. Depending on your manufacturer, this may be Dealer Miles Out and Customer Miles Out on Delivery and Collection agreements.

Notes: 

  • Field validations and restrictions may be applied to this field. Read more. Closed
    • When assigning a unit during open agreement or exchange, a unit's Current Miles is for reference only and unavailable for editing.
    • When editing a unit, an alert is displayed if you edit this field and the new mileage value is less than the previously-saved mileage.
    • All odometer-related fields accept a maximum of six (6) digits, otherwise a message is displayed and the record cannot be saved: "Unit Miles cannot be greater than 999,999."
  • Using TSD Telematics Integration? This information may be retrieved from the device and automatically filled in. Read more. ClosedIf your location uses TSD Telematics (Connected Car Integration), the latest miles and fuel level of a Connected Car unit are filled in based on information received from the telematics device. See "TSD Telematics" for more information.

Driver

The employee serving as the driver on the Internal Use agreement. This list includes all employees eligible to be drivers, based on the Driver setting in the employee record.For locations that use Single Sign-On (SSO) to access the application, TSD Support can designate your employees as Drivers, upon request. Email support@tsdweb.com with a list of employee names you want to be made available as Drivers.

Return Date

The expected Return Date is the date and time the customer is expected to return the assigned unit. When the unit is returned and the agreement is being closed, this becomes the actual Return Date and time. You can view this date on appointments, open agreements, unit exchanges, and unit records of In Use units.

When opening or editing an agreement, you cannot select a Return Date that is more than 29 days from the Checkout Date.

Note: When editing an agreement, if you're updating the Checkout or Return Date, you can select a Reason (for example, Parts Availability, Awaiting Customer Authorization, or Work in Progress).

Business Cases regarding the Return Date:Closed

  • Backdating a return: When closing an agreement or returning a unit during an exchange, you can backdate the Return Date, if needed, as long as it falls after the Checkout Date. See "Checkout Date and Return Date rules" for the full list of rules regarding agreement date ranges.
  • Extending an agreement: When editing the Return Date to extend an agreement (say, if the customer's vehicle isn't ready yet), if the unit has already been assigned to a conflicting future appointment, the application notifies you of the conflict. Tap OK if you want to continue with the agreement extension, which will remove the unit from the conflicting pending appointment.
  • MDL autoMation integration:  For locations using MDL autoMation integration, the Return Date displays the date and time that a returning unit was detected by MDL. See "MDL autoMation Integration" for more information.

Checkout Date and Return Date rules for agreements and exchangesClosed

Because units cannot be assigned to agreements with overlapping dates, the following rules apply to the Checkout Date and Return Date (or Expected Return Date) throughout the agreement process.

When opening an agreement:

  • the Checkout Date:
    • must be no later than now, the current date and time.
    • must be on or later than the Service Start Date of the assigned unit.
    • must be later than the most recent Return Date for the assigned unit and before the Checkout Date of the most recent agreement for the unit, if applicable.

    For example, if today is 3/10/2021 and a unit was assigned to agreements from 2/25/2021 - 2/26/2021, then 3/1/2021 - 3/3/2021, then an agreement can be opened between these agreements, if it starts on, say, 02/27/2021, as long as the expected Return Date and time is prior to 3/1/2021.

  • the Expected Return Date:
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When editing an agreement:

  • the Checkout Date:
    • must be no later than now, the current date and time.
    • must be on or later than the Service Start Date of the assigned unit.
    • must be later than the most recent Return Date for the assigned unit.
  • the Expected Return Date:
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When closing an agreement:

Note: The Checkout Date and Return Date are unavailable when performing a quick return.

  • the Return Date:
    • must be now (today's date) or prior to today's date
    • must be later than the Checkout Date
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When reopening an agreement:

  • the Checkout Date:
    • remains the same as it was the last time it was updated.
    • must follow the same rules as when editing an agreement.
  • the Expected Return Date:
    • remains the same as it was the last time it was updated.
    • must follow the same rules as when editing an agreement.

When returning a unit during a unit exchange:

  • the Checkout Date cannot be edited.
  • the Return Date:
    • must be no later than now, the current date and time.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When assigning a replacement unit during a unit exchange:

  • the Checkout Date must be the same as the Return Date of the unit being returned during the exchange.
  • the Expected Return Date:
    • must be no later than now, the current date and time.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

When unvoiding an agreement:

  • the Checkout Date:
    • remains the same as it was the last time it was updated.
    • must not conflict with the Checkout Date of another agreement; if so, a message is displayed: "Un-voiding agreement XXXXXX conflicts with agreement YYYYYYY. Agreement XXXXXX cannot be UN-voided".
  • the Expected Return Date:
    • remains the same as it was the last time it was updated.
    • must be later than the Checkout Date.
    • if the unit is assigned to another agreement with a Checkout Date that falls after the Checkout Date of the current agreement, then the Return Date must be before the other agreement's Checkout Date. For example, if the Agreement A was opened on 4/3/2021, but the unit is also assigned to Agreement B that was opened on 4/6/2021, then the Return Date of Agreement A must be before 4/6/2021 in order to avoid conflicts.

Reason

When opening an Internal Use agreement, you must select a reason for the agreement from the list of options:

  • Transfer to another office
  • Fuel vehicle
  • Detail car
  • Employee training
  • Employee errand
  • Other

Target Location

On an Internal Use agreement, this is the location to which the unit will be returned; it is set to the current location, by default.