User Guide

This section provides you with all information and steps to successfully assign service items for rental on Digando and handle Digando rental contracts.

• Preparing Service Items for Rental
• Assigning and Deleting Service Items for Rental
• Receiving and Handling Bookings
• Error Handling
  • Error 500
  • Invalid Product Data
  • Undefined Data

Preparing Service Items for Rental

Before a service item can be uploaded to Digando for rental, make sure the following is set up properly:

The product type is correctly assigned to the service item.
The rent locations are set up and mapped in both Digando and TRASER Rental 365.
The rent class for the service item is set up, and the price lines are mapped to Digando identifiers.

Assigning and Deleting Service Items for Rental

In order to make your service items available for rental in Digando, they have to be assigned as follows:

• Open the Service Item Card page of the service item you want to make available for rental in Digando.
• In the menu bar, click on the Rental > Digando > Create Product button to upload the service item along with all rental information to Digando.
• After successful upload, the value of the Digando Status field in the Digando Interface FastTab changes to Created.
• If the service item should no longer be available for rental or Digando, click on the Rental > Digando > Delete Product button in the menu bar. The service item (product) is then set on hold in Digando, i.e., it has Status = Entwurf (Draft).

Receiving and Handling Bookings

This subsection describes where to find Digando booking requests and how to proceed with them.

When a customer made a booking in Digando, they receive an order confirmation, and a booking request is created in TRASER Rental 365. All requests can be found in the Digando Booking Request Header List table which is sorted from newest to oldest entry by default.

• The Digando Booking Request Header List table is updated automatically whenever service items are delivered or returned between Digando and TRASER Rental 365. It is also possible to click on the Fetch Bookings button in the menu bar to manually request booking headers from Digando. Additionally, the Booking Update Job Queue updates the table upon each run.
• When clicking on an entry, the Digando Booking Request Card page opens to show all details:
  • The Booking Entry FastTab shows the applicable booking number from Digando as well as general information.
  • The Booking Line FastTab shows the service item selected in Digando including all charges.
    If additional lines with Identifier = Accessories are available, the Rent Class Code column must be manually filled for these lines as well.
  • The Organization and Contact Person FastTab shows the customer contact information.
    • The Vat ID value is used to map existing organizations as well as contacts in TRASER Rental 365.
    • If the organization and contact records are not yet available in TRASER Rental 365, new records must be manually created before a rental contract can be created!
  • The Rental Data FastTab shows general rental information.
  • The Billing and Shipping FastTab shows general billing and shipping information.
• If all requirements are fulfilled, click on the Create Contract button in the menu bar to create a rental contract and proceed per your default work instructions.
  • If not all requirements are met (e.g., service item damaged or in repair longer than expected, new customer has low credit rating, etc.), you can click on the Cancel Booking button in the menu bar. The cancellation is also directly sent to Digando, and the booking request is cancelled as well. The Process Status value in the Digando Booking Request Header List table is changed to Document Cancelled.
• Open the rental contract by confirming the dialog with Yes, and proceed with your default rental contract handling. The Process Status value in the Digando Booking Request Header List table is changed to Document Created.
• Each rental contract status change in TRASER Rental 365 is directly reflected in Digando as well.

Error Handling

In case of errors, please check the Digando Transactions table which logs all communication between Digando and TRASER Rental 365. Each transaction's JSON file can be downloaded via the Show Transaction Data button in the menu bar for troubleshooting.

Error 500

If an error message containing "statusCode":500 is available in the Error column, the Digando server could not be reached. Usually, this error is fixed by Digando. Erroneous entries are not automatically sent again.

If you want to retry a transaction, wait until Digando confirms that the servers are online again. Then select the corresponding entry with Status = Error and click on the Reset Status button in the menu bar. When the job queue runs the next time, another transaction attempt is made.

Invalid Product Data

If an error message containing Product type ID is missing is available in the Error column, there was an attempt to upload a service item which does not have a product type supported by Digando or which was not mapped correctly.

Please check that the service item mapping is correct and valid. If there is no product type available, kindly contact Digando to add the service item to their product type list.

Undefined Data

If an error message containing Cannot read properties of undefined is available in the Error column, there was an attempt to update a service item in Digando, but there was a mapping mismatch or missing data to map the service item to the Digando product.

Please check the transaction data of the entry in the JSON file by clicking on the Show Transaction Data button in the menu bar to make sure that all values are correct and correspond to the mappings in both Digando and TRASER Rental 365.