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.
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.0.7/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.0.7/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>
    <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.0.7/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.0.7/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>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber0</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType0</assetType>
    </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>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber1</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType1</assetType>
    </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

Parameters

At least one of this ones must be present:

primaryContact, customComplaintCodes, assetCheckInTime or status.

Request Attributes

Name	Condition	Description
assetArrived	required	The time at which the asset arrived at the service location.
assetCheckInTime	optional	The time at which the asset was checked in at the service location.
assetIdentifier:id	optional	The Decisiv Asset Id.
assetInformation:mileage	required	The mileage of the asset when the case is created.
assetInformation:trailer:loaded	required	The status of the trailer.
assetInformation:trailer:unitNumber	required	The unit number of the trailer attached to the asset.
atr	required	Actual time of repair.
authNumber	required	Authorization Number.
breakdown:city	required	The current location city of the asset.
breakdown:driverName	required	The driver’s name.
breakdown:driverPhone	required	The driver’s phone number.
breakdown:location	required	The current location of the asset.
breakdown:state	required	The current location state of the asset.
cause	required	The description of the cause for the case.
complaint	required	The description of the complaint.
confirmedAppointmentTime	required	Confirmed appointment time.
correction	required	The description of the resolution for the case.
customComplaintCodes:code	optional	A set of custom complaint codes (must be defined through Professional Services before use).
customerRequestedAppointmentTime	required	The customer’s preferred appointment time.
customerRequestedCompletionTime	required	The customer’s preferred completion time.
downtime	required	The time at which the asset was not operational.
etr	required	Estimated time of repair.
followupTime	required	The time by which the customer needs to be contacted.
invoiceAmount	required	Invoice total.
invoiceDate	optional	Invoice Date.
invoiceNumber	required	Invoice number.
poNumber	required	Purchase order number.
primaryContact:name	required	The full name of the primary contact.
primaryContact:phone	required	The phone number of the primary contact.
primaryContact:relation	required	The relation of the primary contact.
roNumber	required	Repair order number.
serviceLocationSuggestedAppointmentTime	required	Service location’s preferred appointment time.
status:name	optional	Current status of the case.
tagNumber	required	Tag number for the asset on the lot.
uptime	required	The time at which the asset was operational.
vmrs:code14	optional	Reason for repair.
vmrs:code15	optional	Work Accomplished.
vmrs:code16	optional	Repair priority.
vmrs:code17	optional	Repair site.
vmrs:code82	optional	Operator Report.
vmrs:complaintCode33	optional	Component code for the complaint.
vmrs:complaintCode79	optional	Position code for the complaint.
vmrs:correctionCode33	optional	Component code for the correction.
vmrs:correctionCode79	optional	Position code for the correction.

Request

<?xml version="1.0" encoding="UTF-8"?>
<case xmlns="http://www.decisiv.net/platform_api/0.0.7/Case/CaseRequest"
      xmlns:ct="http://www.decisiv.net/platform_api/0.0.7/Case/CaseTypes"
      xmlns:g="http://www.decisiv.net/platform_api/0.0.7/Case/GroupedUser"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.decisiv.net/platform_api/0.0.7/Case/CaseRequest">
    <assignee>
        <g:id>id0</g:id>
    </assignee>
    <ct:primaryContact>
        <ct:name>name1</ct:name>
        <ct:phone>15558675309</ct:phone>
        <ct:relation>relation0</ct:relation>
    </ct:primaryContact>
    <ct:breakdown>
        <ct:driverName>driver name</ct:driverName>
        <ct:driverPhone>555-555-5555</ct:driverPhone>
        <ct:location>location0</ct:location>
        <ct:city>city0</ct:city>
        <ct:state>state0</ct:state>
    </ct:breakdown>
    <ct:assetInformation>
      <ct:mileage>100</ct:mileage>
      <ct:trailer>
        <ct:unitNumber>unitNumber</ct:unitNumber>
        <ct:loaded>true</ct:loaded>
      </ct:trailer>
    </ct: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>
</case>

Response

A single case response.