Go to full article

Overview

Update a Product which a service provider will intend to change.

Updating a Product

To update a product:

  1. Create a UpdateProduct request.
  2. Provide the Product ID which should be updated.
  3. Optionally provide information which should be changed:
    - Name.
    - Description.
    - Product Category.
    - Product Subcategory.
    - Manufacturer.
    - Colour.
    - SKU.
    - Supplier Name.
    - Supplier Product ID.
    - Barcode.
    - Ledger Code.
    - Allow Fractional Quantity.
    - Can Assign Service.
    - Tax Type.
    - Price Type Group.
    - Price Type.

WSDL

https://api.emersion.com.au/Products.wsdl

Operation name

Products/UpdateProduct



Business Rules

- ID should exist under the owning account. 
- Name is within length limit. (128)
- Description should be within length limit. (255)
- Product Category should exist in list and be owned by Emersion or Caller.
- Product Subcategory should exist in list and be valid under category.
- Manufacturer should exist in list.
- Colour should exist in list. (enum: 'ProductColour')
- SKU should be within length limit. (100) 
- Supplier Name should be within length limit. (255)
- Supplier Product ID should within length limit. (100)
- Barcode Type should exist in list, Barcode Value should within length limit (100) and both should coexist.
- Ledger code should exist in list, otherwise will be created newly and should be within length limit. (200)
- Allow Fractional Quantity should be boolean.
- Can Assign Service should exist in list. (enum: 'ProductInstServiceAssign')
- Tax Type should exist in list.
- Price Type Group should exist in list. (enum: 'ProductTypeGroup')
- Price Type should exist in list and be valid under Product Type Group. (enum: 'ProductType')




SOAP Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api" xmlns:urn1="urn:emersion:types">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:UpdateProductRequest>
         <urn:ID>2008829</urn:ID>
         <!--Optional:-->
         <urn:Name>MelbourneJames7</urn:Name>
         <!--Optional:-->
         <urn:Description>James Kim Test7</urn:Description>
         <!--Optional:-->
         <urn:Category>Security</urn:Category>
         <!--Optional:-->
         <urn:Subcategory>Bond1</urn:Subcategory>
         <!--Optional:-->
         <urn:Colour>Silver</urn:Colour>
         <!--Optional:-->
         <urn:SKU>CHG-SEL-40159777'</urn:SKU>
         <!--Optional:-->
         <urn:Supplier>Ingram Micro9777</urn:Supplier>
         <!--Optional:-->
         <urn:SupplierProductCode>14201-179777</urn:SupplierProductCode>
         <!--Optional:-->
         <urn:Barcode>
            <urn1:Type>Code 93</urn1:Type>
            <urn1:Shortname>Code 93</urn1:Shortname>
            <urn1:Value>998877665544332211999777</urn1:Value>
         </urn:Barcode>
         <!--Optional:-->
         <urn:LedgerCode>JAMES_TEST777</urn:LedgerCode>
         <!--Optional:-->
         <urn:AllowFractionalQuantity>true</urn:AllowFractionalQuantity>
         <!--Optional:-->
         <urn:CanAssignService>required</urn:CanAssignService>
         <!--Optional:-->
         <urn:TaxType>Australian GST Free</urn:TaxType>
         <!--Optional:-->
         <urn:PriceTypeGroup>Electricity</urn:PriceTypeGroup>
         <!--Optional:-->
         <urn:PriceType>Kilowatt Hour (s)</urn:PriceType>
      </urn:UpdateProductRequest>
   </soapenv:Body>
</soapenv:Envelope>




Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information.

NameDescriptionRequired?Field Type

Character

limit

Values

ID

The ID of the product recordYesInteger
A valid product ID

Name

Product descriptionNoString128Jabra Elite 65t

Description

Product type nameNo

String

255

Wireless Earbud Headphones

Category

Product categoryNo

String


Hardware

Subcategory

Product subcategory under its categoryNoString

PSTN Gateways

ManufacturerProduct manufacturer under its categoryNoString
Samsung
ColourProduct colourNoEnumeration
White
SKUStock Keeping Unit, service identification code for a productNoString100CHG-SEL-4015
SupplierSupplier nameNoString255Ingram Micro
SupplierProductCodeSupplier Product IDNoString10014201-17
BarcodeBarcode type
Barcode short name
Barcode value		No
No
No
String
String
String
Code 128
Code 128
998877665544332211
LedgerCodeLedger codeNoString200VOCUS_SIP_TRUNK_RECUR
AllowFractionalQuantityAllow fractional quantityNoBoolean
true
CanAssignServiceCan assign serviceNoEnumeration
optional
TaxTypeTax typeNoString
Australian GST
PriceTypeGroupProduct price type groupNoEnumeration
Default
PriceTypeProduct price type under its price type groupNoEnumeration
Unit(s)