Add Product

Overview
Creates a Product in MobiWork

URL Format
https://{domain}/api/rest/{clientId}/{versionNumber}/product/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 Product Object if product 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="product"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="product">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="externalId"/>
        <xs:element ref="name"/>
        <xs:element ref="description"/>
        <xs:element ref="type"/>
        <xs:element ref="price"/>
        <xs:element ref="cost"/>
        <xs:element ref="quantity"/>
        <xs:element ref="sku"/>
        <xs:element ref="modelNumber"/>
        <xs:element ref="hasSerialNumbers"/>
        <xs:element ref="priceIncludesTax"/>
        <xs:element ref="taxable"/>
        <xs:element ref="tax"/>
        <xs:element ref="enabled"/>
        <xs:element ref="category"/>
        <xs:element ref="customFields"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="externalId" type="xs:NCName" minOccurs="0"/>
  <xs:element name="description" type="xs:string" minOccurs="0"/>
  <xs:element name="type" type="xs:integer"/>
  <xs:element name="price" type="xs:decimal"/>
  <xs:element name="cost" type="xs:decimal"/>
  <xs:element name="quantity" type="xs:integer" minOccurs="0"/>
  <xs:element name="sku" type="xs:integer" minOccurs="0"/>
  <xs:element name="modelNumber" type="xs:integer" minOccurs="0"/>
  <xs:element name="hasSerialNumbers" type="xs:boolean" minOccurs="0"/>
  <xs:element name="priceIncludesTax" type="xs:boolean" minOccurs="0"/>
  <xs:element name="taxable" type="xs:boolean" minOccurs="0"/>
  <xs:element name="tax" type="xs:decimal"/>
  <xs:element name="enabled" type="xs:boolean" minOccurs="0"/>
  <xs:element name="category" type="xs:string" minOccurs="0"/>
  <xs:element name="customFields" minOccurs="0">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="customField"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="customField">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="apiName"/>
        <xs:element ref="fieldType"/>
        <xs:element ref="value"/>
        <xs:element ref="name"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="apiName" type="xs:NCName"/>
  <xs:element name="fieldType" type="xs:integer"/>
  <xs:element name="value" type="xs:string"/>
  <xs:element name="name" type="xs:string"/>
</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="product"/>
      </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="product">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="mobiworkProductId"/>
        <xs:element ref="externalId"/>
        <xs:element ref="name"/>
        <xs:element ref="description"/>
        <xs:element ref="type"/>
        <xs:element ref="price"/>
        <xs:element ref="cost"/>
        <xs:element ref="quantity"/>
        <xs:element ref="sku"/>
        <xs:element ref="modelNumber"/>
        <xs:element ref="hasSerialNumbers"/>
        <xs:element ref="priceIncludesTax"/>
        <xs:element ref="taxable"/>
        <xs:element ref="tax"/>
        <xs:element ref="enabled"/>
        <xs:element ref="competitorProduct"/>
        <xs:element ref="genericPart"/>
        <xs:element ref="createdDate"/>
        <xs:element ref="categoryId"/>
        <xs:element ref="category"/>
        <xs:element ref="customFields"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="mobiworkProductId" type="xs:integer"/>
  <xs:element name="externalId" type="xs:NCName"/>
  <xs:element name="description">
    <xs:complexType/>
  </xs:element>
  <xs:element name="type" type="xs:NCName"/>
  <xs:element name="price" type="xs:decimal"/>
  <xs:element name="cost" type="xs:decimal"/>
  <xs:element name="quantity" type="xs:decimal"/>
  <xs:element name="sku">
    <xs:complexType/>
  </xs:element>
  <xs:element name="modelNumber">
    <xs:complexType/>
  </xs:element>
  <xs:element name="hasSerialNumbers" type="xs:boolean"/>
  <xs:element name="priceIncludesTax" type="xs:boolean"/>
  <xs:element name="taxable" type="xs:boolean"/>
  <xs:element name="tax" type="xs:decimal"/>
  <xs:element name="enabled" type="xs:boolean"/>
  <xs:element name="competitorProduct" type="xs:boolean"/>
  <xs:element name="genericPart" type="xs:boolean"/>
  <xs:element name="createdDate" type="xs:string"/>
  <xs:element name="categoryId" type="xs:integer"/>
  <xs:element name="category" type="xs:string"/>
  <xs:element name="customFields">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="customField"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="customField">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="fieldType"/>
        <xs:element ref="apiName"/>
        <xs:element ref="index"/>
        <xs:element ref="value"/>
        <xs:element ref="name"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="fieldType" type="xs:integer"/>
  <xs:element name="apiName" type="xs:NCName"/>
  <xs:element name="index" type="xs:integer"/>
  <xs:element name="value" type="xs:string"/>
  <xs:element name="name" type="xs:string"/>
</xs:schema>

Curl Example

HTTP Method:	POST
Request:	curl -k -X POST -H "https://www.mobiwork.com/api/rest/12014/10.0.78/product/add.html?token=COJL8X2FKSLMMRTYCH2B" -data '<request> <product> <externalId>API1113</externalId> <name>Test API New 3</name> <description>Test API New 3</description> <type>PARTS_MATERIALS</type> <price>77.76</price> <cost>38.88</cost> <quantity>1</quantity> <sku></sku> <modelNumber>152885555</modelNumber> <hasSerialNumbers>false</hasSerialNumbers> <priceIncludesTax>false</priceIncludesTax> <taxable>true</taxable> <tax>0.12</tax> <enabled>true</enabled> <category>Under ground fittings</category> <customFields> <customField> <apiName>Field1</apiName> <fieldType>1</fieldType> <value></value> <name>Field1</name> </customField> </customFields> </product> </request>'
Response:	<?xml encoding="UTF-8" ?> <response version="10.0.78" statusCode="1"> <product> <mobiworkProductId>307969</mobiworkProductId> <externalId>API1113</externalId> <name>Test API New 3</name> <description>Test API New 3</description> <type>PARTS_MATERIALS</type> <price>77.76</price> <cost>38.88</cost> <quantity>0</quantity> <sku></sku> <modelNumber>152885555</modelNumber> <hasSerialNumbers>false</hasSerialNumbers> <priceIncludesTax>true</priceIncludesTax> <taxable>true</taxable> <tax>0.12</tax> <enabled>true</enabled> <createdDate>2016/10/19</createdDate> <categoryId>969</categoryId> <category>Under ground fittings</category> <customFieldList> <customField> <apiName>ProductImg</apiName> <fieldType>25</fieldType> <value></value> <name>Product Img</name> </customField> <customField> <apiName>Field1</apiName> <fieldType>1</fieldType> <value></value> <name>Field1</name> </customField> </customFieldList> </product> </response>