Features - Connectors Framework - Inbound REST API - Work Orders
Add Work Order
Overview
Creates a Work Order in MobiWork
URL Format
https://{domain}.mobiwork.com/api/rest/{clientId}/{versionNumber}/workOrder/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, this User ID will be taken as a logged in user. If not provided we use an active global administrator ID
Return
Returns a Work Order Object if work order creation is successful or errors will be returned
Request Body XSD
Response Body XSD
Curl Example
HTTP Method: POST
Request: curl -k -X POST -H "https://www.mobiwork.com/api/rest/12014/10.0.78/workOrder/add.html?token=COJL8X2FKSLMMRTYCH2B" -data '<workOrder>
<externalId>AA-WO10001</externalId>
<customerId>456300</customerId>
<customerName>Mobiwork - Construction</customerName>
<description>Add WO API add asset 1</description>
<workOrderTypeId>2573</workOrderTypeId>
<workOrderType>Repair</workOrderType>
<workOrderNumber></workOrderNumber>
<status>OPEN</status>
<customStatusId>1617</customStatusId>
<customStatus>Scheduled</customStatus>
<location>
<addressId>753283</addressId>
<address1>160 Congress park drive</address1>
<address2></address2>
<city>Delray Beach</city>
<state>Florida</state>
<zipCode>33445</zipCode>
<countryId>1</countryId>
<latitude>26.4582132</latitude>
<longitude>-80.09405019999997</longitude>
<name>Mobiwork HQ</name>
<baseDistance>9022407</baseDistance>
</location>
<assetList>
<asset>
<mobiworkAssetId>56951</mobiworkAssetId>
<externalId>API4444</externalId>
<name>Asset Rest API 4</name>
<description>Asset Rest API 4</description>
<modelNumber>44444444444</modelNumber>
<serialNumber>111114444444</serialNumber>
<categoryId>5020</categoryId>
<category>Vehicle</category>
</asset>
<asset>
<mobiworkAssetId></mobiworkAssetId>
<externalId>APIWO-ADD1</externalId>
<name>Asset Rest API ADDWO 1</name>
<description>Asset Rest API ADDWO 1</description>
<modelNumber>WO111111</modelNumber>
<serialNumber>11111111</serialNumber>
<categoryId></categoryId>
<category>Rest</category>
</asset>
</assetList>
</workOrder>'
Response: <?xml version="1.0" encoding="UTF-8" ?>
<response version="1.0.0" statusCode="1">
<workOrder>
<mobiworkWorkOrderId>3218924</mobiworkWorkOrderId>
<externalId>AA-WO10001</externalId>
<customerId>456300</customerId>
<customerName>Mobiwork - Construction</customerName>
<description></description>
<workOrderNumber></workOrderNumber>
<customStatusId>1617</customStatusId>
<customStatus>Scheduled</customStatus>
<location>
<addressId>910512</addressId>
<address1>160 Congress Park Drive</address1>
<address2></address2>
<city>Delray Beach</city>
<state>FL</state>
<zipCode>33445</zipCode>
<countryId>1</countryId>
<latitude>26.4582132</latitude>
<longitude>-80.09405019999997</longitude>
<name></name>
<baseDistance>9022407</baseDistance>
</location>
<createdDate>2017/01/27 16:22:11</createdDate>
<assetList>
<asset>
<mobiworkAssetId>56951</mobiworkAssetId>
<externalId>API4444</externalId>
<name>Asset Rest API 4</name>
<description>Asset Rest API 4</description>
<modelNumber>44444444444</modelNumber>
<serialNumber>111114444444</serialNumber>
<categoryId>5020</categoryId>
<category>Vehicle</category>
</asset>
<asset>
<mobiworkAssetId>56956</mobiworkAssetId>
<externalId>null</externalId>
<name>Asset Rest API ADDWO 1</name>
<description>Asset Rest API ADDWO 1</description>
<modelNumber>null</modelNumber>
<serialNumber>11111111</serialNumber>
</asset>
</assetList>
</workOrder>
</response>