Add Asset

Overview
Creates an Asset in MobiWork

URL Format
https://{domain}.mobiwork.com/api/rest/{clientId}/{versionNumber}/asset/add.html?token=XXXXXXXX&userId={userId}

Arguments

clientId required	MobiWork assigned unique ID of the company
versionNumber required	Version number of MobiWork API SDK release. Current version is: 10.0.78
token required	Part of URL as a request parameter and is required in every call to verify access to API calls
userId optional	If provided in URL, this User ID will be taken as a logged in user

Return
Returns an Asset Object if asset creation is successful or errors will be returned

Request Body XSD

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="request">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="asset"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="asset">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="externalId"/>
        <xs:element ref="name"/>
        <xs:element ref="description"/>
        <xs:element ref="modelNumber"/>
        <xs:element ref="locationId"/>
        <xs:element ref="customer"/>
        <xs:element ref="serialNumber"/>
        <xs:element ref="warrantStartDate"/>
        <xs:element ref="sku"/>
        <xs:element ref="warrantEndDate"/>
        <xs:element ref="status"/>
        <xs:element ref="typeName"/>
        <xs:element ref="categoryName"/>
        <xs:element ref="categoryId"/>
        <xs:element ref="assignedTo"/>
        <xs:element ref="enabled"/>
        <xs:element ref="warehouseId"/>
        <xs:element ref="parentAssetId"/>
        <xs:element ref="subCategoryName"/>
        <xs:element ref="subCategoryId"/>
        <xs:element ref="manufacturer"/>
        <xs:element ref="tag"/>
        <xs:element ref="customFields"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="externalId" type="xs:NCName" minOccurs="0"/>
  <xs:element name="name" type="xs:string" minOccurs="0"/>
  <xs:element name="description" type="xs:string" minOccurs="0"/>
  <xs:element name="modelNumber" type="xs:integer" minOccurs="0"/>
  <xs:element name="locationId" type="xs:integer" minOccurs="0"/>
  <xs:element name="customer" type="xs:string" minOccurs="0"/>
  <xs:element name="serialNumber" type="xs:NMTOKEN"/>
  <xs:element name="warrantStartDate" type="xs:string" minOccurs="0"/>
  <xs:element name="sku" type="xs:string" minOccurs="0"/>
  <xs:element name="warrantEndDate" type="xs:string" minOccurs="0"/>
  <xs:element name="status" type="xs:NCName" minOccurs="0"/>
  <xs:element name="typeName" type="xs:NCName" minOccurs="0"/>
  <xs:element name="categoryName" type="xs:NCName" minOccurs="0"/>
  <xs:element name="categoryId" type="xs:integer" minOccurs="0"/>
  <xs:element name="assignedTo" type="xs:string" minOccurs="0"/>
  <xs:element name="enabled" type="xs:boolean" minOccurs="0"/>
  <xs:element name="warehouseId" type="xs:integer" minOccurs="0"/>
  <xs:element name="parentAssetId" type="xs:integer" minOccurs="0"/>
  <xs:element name="subCategoryName" type="xs:string" minOccurs="0"/>
  <xs:element name="subCategoryId" type="xs:integer" minOccurs="0"/>
  <xs:element name="manufacturer" type="xs:NCName" minOccurs="0"/>
  <xs:element name="tag" type="xs:string" minOccurs="0"/>
  <xs:element name="customFields">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" ref="customField" minOccurs="0"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="customField">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="apiName"/>
        <xs:element ref="value"/>
        <xs:element ref="index"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="apiName" type="xs:NCName"/>
  <xs:element name="value" type="xs:string"/>
  <xs:element name="index" type="xs:integer"/>
</xs:schema>

Response Body XSD

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="response">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="asset"/>
      </xs:sequence>
      <xs:attribute name="statusCode" use="required" type="xs:integer"/>
      <xs:attribute name="version" use="required" type="xs:NMTOKEN"/>
    </xs:complexType>
  </xs:element>
  <xs:element name="asset">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="mobiworkAssetId"/>
        <xs:element ref="externalId"/>
        <xs:element ref="name"/>
        <xs:element ref="description"/>
        <xs:element ref="modelNumber"/>
        <xs:element ref="serialNumber"/>
        <xs:element ref="manufacturer"/>
        <xs:element ref="tag"/>
        <xs:element ref="beacon"/>
        <xs:element ref="rfid"/>
        <xs:element ref="barcode"/>
        <xs:element ref="sku"/>
        <xs:element ref="categoryId"/>
        <xs:element ref="category"/>
        <xs:element ref="subCategoryId"/>
        <xs:element ref="subCategory"/>
        <xs:element ref="customFields"/>
        <xs:element ref="location"/>
        <xs:element ref="status"/>
        <xs:element ref="enabled"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="mobiworkAssetId" type="xs:integer"/>
  <xs:element name="externalId" type="xs:NCName"/>
  <xs:element name="description" type="xs:string"/>
  <xs:element name="modelNumber" type="xs:integer"/>
  <xs:element name="serialNumber" type="xs:NMTOKEN"/>
  <xs:element name="manufacturer" type="xs:NCName"/>
  <xs:element name="tag" type="xs:string"/>
  <xs:element name="beacon" type="xs:NCName"/>
  <xs:element name="rfid" type="xs:NCName"/>
  <xs:element name="barcode">
    <xs:complexType/>
  </xs:element>
  <xs:element name="sku" type="xs:string"/>
  <xs:element name="categoryId" type="xs:integer"/>
  <xs:element name="category" type="xs:NCName"/>
  <xs:element name="subCategoryId" type="xs:integer"/>
  <xs:element name="subCategory" type="xs:NCName"/>
  <xs:element name="customFields">
    <xs:complexType/>
  </xs:element>
  <xs:element name="location">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="addressId"/>
        <xs:element ref="address1"/>
        <xs:element ref="address2"/>
        <xs:element ref="city"/>
        <xs:element ref="state"/>
        <xs:element ref="zipCode"/>
        <xs:element ref="countryId"/>
        <xs:element ref="latitude"/>
        <xs:element ref="longitude"/>
        <xs:element ref="name"/>
        <xs:element ref="baseDistance"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="addressId" type="xs:integer"/>
  <xs:element name="address1" type="xs:string"/>
  <xs:element name="address2" type="xs:string"/>
  <xs:element name="city" type="xs:string"/>
  <xs:element name="state" type="xs:NCName"/>
  <xs:element name="zipCode">
    <xs:complexType/>
  </xs:element>
  <xs:element name="countryId" type="xs:integer"/>
  <xs:element name="latitude" type="xs:decimal"/>
  <xs:element name="longitude" type="xs:decimal"/>
  <xs:element name="baseDistance" type="xs:integer"/>
  <xs:element name="status" type="xs:NCName"/>
  <xs:element name="enabled" type="xs:boolean"/>
  <xs:element name="name" type="xs:string"/>
</xs:schema>

Curl Example

HTTP Method:	POST
Request:	curl -X POST -H "https://platform.mobiwork.com/api/rest/12014/10.0.78/asset/add.html?token=COJL8X2FKSLMMRTYCH2B" -data '<request> <asset> <externalId>API11122</externalId> <name>FORD FLEET TRUCK2</name> <description>FORD FLEET TRUCK2</description> <modelNumber></modelNumber> <serialNumber>1FDE5C1206F422322</serialNumber> <warrantStartDate></warrantStartDate> <warrantEndDate></warrantEndDate> <status>Active</status> <typeName>Vehicle</typeName> <categoryName>Vehicle</categoryName> <subCategoryName>FORD FLEET TRUCK</subCategoryName> <customFields> <customField> <apiName>valueofassets</apiName> <value>40000</value> <index>0</index> </customField> <customField> <apiName>LicenseTag</apiName> <value>18011TF</value> <index>0</index> </customField> <customField> <apiName>ServicedBy</apiName> <value>Royal Palm Auto Spa</value> <index>0</index> </customField> <customField> <apiName>OilFilterNumber</apiName> <value>8111</value> <index>0</index> </customField> </customFields> </asset> </request>'
Response:	<?xml encoding="UTF-8" ?> <response version="10.0.78" statusCode="1"> <asset> <mobiworkAssetId>56944</mobiworkAssetId> <externalId>API11122</externalId> <name>FORD FLEET TRUCK2</name> <description>FORD FLEET TRUCK22</description> <modelNumber></modelNumber> <serialNumber>1FDE5C1206F422322</serialNumber> <customFieldList> <customField> <apiName>LicenseTag</apiName> <fieldType>1</fieldType> <value></value> <name>License Tag</name> </customField> <customField> <apiName>ServicedBy</apiName> <fieldType>6</fieldType> <value></value> <name>Serviced By</name> </customField> <customField> <apiName>OilFilterNumber</apiName> <fieldType>1</fieldType> <value></value> <name>Oil Filter Number</name> </customField> <customField> <apiName>valueofassets</apiName> <fieldType>1</fieldType> <value></value> <name>Value of asset</name> </customField> <customField> <apiName>images</apiName> <fieldType>25</fieldType> <value></value> <name>Additional Images</name> </customField> </customFieldList> </asset> </response>