Assets

Assets are equipment owned by customers.

Get a single asset

GET /assets/{id}

Returns an asset.

Response Attributes

Name Value
assetType The vehicle type.
casesURL The cases URL.
chassisID The vehicle chassis identifier.
createdAt The date the record was created.
engine:name The vehicle engine name.
engineDisplacement The vehicle engine displacement.
engineHours The vehicle engine hours.
engineFuel The vehicle engine fuel.
engineHorsepower The vehicle engine horse power.
engineMake The vehicle engine make.
engineSerialNumber The vehicle engine serial number.
id The numerical record id.
make:name The vehicle make name.
mileage The vehicle mileage.
model:name The vehicle model name.
owner:name The vehicle owner name.
recallPending The vehicle recall pending.
serialNumber The serial number of the vehicle.
updatedAt The date the record was last updated.
unitNumber The vehicle unit number.
URL The object URL.
VIN Vehicle Identification Number.
warrantyStartDate The vehicle warranty start date.
year The vehicle year.

Response

<?xml version="1.0" encoding="UTF-8"?>
<asset xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse">
    <URL>URL0</URL>
    <casesURL>casesURL0</casesURL>
    <id>id0</id>
    <VIN>vin0</VIN>
    <serialNumber>serialNumber0</serialNumber>
    <year>year0</year>
    <make>
        <name>name0</name>
    </make>
    <model>
        <name>name1</name>
    </model>
    <engine>
        <name>name2</name>
    </engine>
    <engineDisplacement>engineDisplacement0</engineDisplacement>
    <engineFuel>engineFuel0</engineFuel>
    <engineHorsepower>engineHorsepower0</engineHorsepower>
    <engineMake>engineMake0</engineMake>
    <engineSerialNumber>engineSerialNumber0</engineSerialNumber>
    <owner>
        <name>name3</name>
    </owner>
    <chassisID>chassisID0</chassisID>
    <mileage>0</mileage>
    <engineHours>0</engineHours>
    <unitNumber>unitNumber0</unitNumber>
    <warrantyStartDate>2006-05-04</warrantyStartDate>
    <recallPending>false</recallPending>
    <assetType>assetType0</assetType>
</asset>

List assets

GET /assets

Returns a collection of assets. These results can be filtered using optional parameters.

Query

Filtering

chassis_id, serial_number, unit_number, vin

Sorting

Not supported

Limit

10 results

Response Attributes

See Response Attributes above

Response

<?xml version="1.0" encoding="UTF-8"?>
<assets xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:d="http://www.decisiv.net/platform_api/0.3-beta/Case/Department"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse">
    <asset>
        <URL>URL0</URL>
        <casesURL>casesURL0</casesURL>
        <id>id0</id>
        <VIN>vin0</VIN>
        <serialNumber>serialNumber0</serialNumber>
        <year>year0</year>
        <make>
            <name>name0</name>
        </make>
        <model>
            <name>name1</name>
        </model>
        <engine>
            <name>name2</name>
        </engine>
        <engineDisplacement>engineDisplacement0</engineDisplacement>
        <engineFuel>engineFuel0</engineFuel>
        <engineHorsepower>engineHorsepower0</engineHorsepower>
        <engineMake>engineMake0</engineMake>
        <engineSerialNumber>engineSerialNumber0</engineSerialNumber>
        <owner>
            <name>name3</name>
        </owner>
        <chassisID>chassisID0</chassisID>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber0</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType0</assetType>
        <department>
          <d:code>code0</d:code>
          <d:description>description0</d:description>
        </department>
    </asset>
    <asset>
        <URL>URL1</URL>
        <casesURL>casesURL1</casesURL>
        <id>id1</id>
        <VIN>vin1</VIN>
        <serialNumber>serialNumber1</serialNumber>
        <year>year1</year>
        <make>
            <name>name4</name>
        </make>
        <model>
            <name>name5</name>
        </model>
        <engine>
            <name>name6</name>
        </engine>
        <engineDisplacement>engineDisplacement1</engineDisplacement>
        <engineFuel>engineFuel1</engineFuel>
        <engineHorsepower>engineHorsepower1</engineHorsepower>
        <engineMake>engineMake1</engineMake>
        <engineSerialNumber>engineSerialNumber1</engineSerialNumber>
        <owner>
            <name>name7</name>
        </owner>
        <chassisID>chassisID1</chassisID>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber1</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType1</assetType>
        <department>
          <d:code>code1</d:code>
          <d:description>description1</d:description>
        </department>
    </asset>
</assets>

List cases for an asset

GET /assets/{id}/cases

Returns a list of cases.

Query

Filtering

closed, ro_number

Sorting

Records are sorted by created_at in descending order.

Limit

5 results

Response

A list of cases.

Create a case for an asset

Create a case for a fleet or customer asset.

POST /assets/{id}/cases

Request Attributes

Name Value
assetArrived The time at which the asset arrived at the service location.
assetCheckInTime The time at which the asset was checked in at the service location.
assetDepartedTime The time at which the asset was departed from the service location.
assetIdentifier:id The Decisiv Asset Id.
assetInformation:engineHours The engine hours of the asset when the case is created.
assetInformation:mileage The mileage of the asset when the case is created.
assetInformation:trailer:loaded The status of the trailer.
assetInformation:trailer:unitNumber The unit number of the trailer attached to the asset.
atr Actual time of repair.
authNumber Authorization Number.
breakdown:city The current location city of the asset.
breakdown:driverName The driver’s name.
breakdown:driverPhone The driver’s phone number.
breakdown:location The current location of the asset.
breakdown:state The current location state of the asset.
cause The description of the cause for the case.
complaint The description of the complaint.
confirmedAppointmentTime Confirmed appointment time.
coreTotal The total cost for Core parts.
correction The description of the resolution for the case.
customComplaintCodes:code A set of custom complaint codes (must be defined through Professional Services before use).
customerRequestedAppointmentTime The customer’s preferred appointment time.
customerRequestedCompletionTime The customer’s preferred completion time.
customers:billingCustomer:id The Billing Customer ID.
customers:shippingCustomer:id The Shipping Customer ID.
department:code The case department code.
downtime The time at which the asset was not operational.
etr Estimated time of repair.
followupTime The time by which the customer needs to be contacted.
freight The cost for Freight.
hazWaste The cost for Hazardous Waste.
invoiceAmount Invoice total.
invoiceDate Invoice Date.
invoiceNumber Invoice number.
laborTotal The total cost for Labor.
partsTotal The total cost for Parts.
poNumber Purchase order number.
primaryContact:email The email of the primary contact.
primaryContact:name The full name of the primary contact.
primaryContact:phone The phone number of the primary contact.
primaryContact:relation The relation of the primary contact.
roNumber Repair order number.
serviceLocationSuggestedAppointmentTime Service location’s preferred appointment time.
severity A decimal value indicating the severity of the estimate.
shopSupplies The cost of the Shop Supplies.
status:name Current status of the case.
tagNumber Tag number for the asset on the lot.
tax The amount of tax charged.
total The accumulated total.
uptime The time at which the asset was operational.
vmrs:code14 Reason for repair.
vmrs:code15 Work Accomplished.
vmrs:code16 Repair priority.
vmrs:code17 Repair site.
vmrs:code82 Operator Report.
vmrs:complaintCode33 Component code for the complaint.
vmrs:complaintCode79 Position code for the complaint.
vmrs:correctionCode33 Component code for the correction.
vmrs:correctionCode79 Position code for the correction.

Request

<?xml version="1.0" encoding="UTF-8"?>
<case xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseRequest"
      xmlns:ct="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseTypes"
      xmlns:g="http://www.decisiv.net/platform_api/0.2/Case/GroupedUser"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:d="http://www.decisiv.net/platform_api/0.3-beta/Case/Department"
      xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseRequest">
    <assignee>
        <g:id>id0</g:id>
    </assignee>
    <primaryContact>
        <ct:name>name0</ct:name>
        <ct:phone>phone0</ct:phone>
        <ct:email>email0</ct:email>
        <ct:relation>relation0</ct:relation>
    </primaryContact>
    <breakdown>
        <ct:driverName>driver name</ct:driverName>
        <ct:driverPhone>driver phone</ct:driverPhone>
        <ct:location>location0</ct:location>
        <ct:city>city0</ct:city>
        <ct:state>state0</ct:state>
    </breakdown>
    <assetDepartedTime>2006-05-04T18:13:51.0</assetDepartedTime>
    <assetInformation>
      <ct:engineHours>engineHours0</ct:engineHours>
      <ct:mileage>mileage0</ct:mileage>
      <ct:trailer>
        <ct:unitNumber>unitNumber</ct:unitNumber>
        <ct:loaded>true</ct:loaded>
      </ct:trailer>
    </assetInformation>
    <cause>cause0</cause>
    <correction>correction0</correction>
    <complaint>complaint0</complaint>
    <downtime>2006-05-04T18:13:51.0</downtime>
    <uptime>2006-05-04T18:13:51.0</uptime>
    <customerRequestedAppointmentTime>2006-05-04T18:13:51.0</customerRequestedAppointmentTime>
    <serviceLocationSuggestedAppointmentTime>2006-05-04T18:13:51.0</serviceLocationSuggestedAppointmentTime>
    <confirmedAppointmentTime>2006-05-04T18:13:51.0</confirmedAppointmentTime>
    <customerRequestedCompletionTime>2006-05-04T18:13:51.0</customerRequestedCompletionTime>
    <followupTime>2006-05-04T18:13:51.0</followupTime>
    <assetArrived>2006-05-04T18:13:51.0</assetArrived>
    <assetCheckInTime>2006-05-04T18:13:51.0</assetCheckInTime>
    <etr>2006-05-04T18:13:51.0</etr>
    <atr>2006-05-04T18:13:51.0</atr>
    <poNumber>poNumber0</poNumber>
    <roNumber>roNumber0</roNumber>
    <invoiceAmount>0.00</invoiceAmount>
    <invoiceNumber>invoiceNumber0</invoiceNumber>
    <authNumber>authNumber0</authNumber>
    <tagNumber>tagNumber0</tagNumber>
    <department>
        <d:code>code0</d:code>
    </department>
    <customers>
      <billingCustomer>
        <ct:id>billingCustomer0</ct:id>
      </billingCustomer>
      <shippingCustomer>
        <ct:id>shippingCustomer0</ct:id>
      </shippingCustomer>
    </customers>
</case>

Response

A single case response.