---
title: "Product Webservice 3.0"
slug: "product-webservice-30"
updated: 2026-01-08T20:54:37Z
published: 2026-01-08T20:54:37Z
canonical: "docs.winedirect.com/product-webservice-30"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.winedirect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Webservice 3.0

Enhancing your Data SecurityTo provide the most secure environment for your business, WineDirect is moving all web services to a more secure protocol (HTTPS) **effective February 16, 2026**.  
  
Starting on **February 16, 2026** all API calls not using HTTPS will be redirected to the HTTPS version of the endpoint and return an **HTTP 302 Found** response code. This may break some integrations if redirects cannot be handled by your current implementation. To avoid this, please update your API calls to use only HTTPS endpoints or reach out to your Web Developer or Integration Partner to confirm that your current connections are compatible with HTTPS.

### WSDL:

[https://webservices.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.vin65.com/V300/ProductService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl)

### Methods:

**SearchProducts()** Use this method to search for products.

**GetProductDetail()** Use this method to get a single product.

**AddUpdateProductDetail()** Use this method to add or update a product.

[Page Top](/docs/product-webservice-30#)

# SearchProducts()

### Part Of: Product Webservice 3.0

### WSDL:

[https://webservices.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.vin65.com/V300/ProductService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl)

### Description:

Use the SearchProducts() function to search for products in Vin65. Required fields are indicated by a '*'

### Parameters:

| Attribute | Data Type | Default | Description |
| --- | --- | --- | --- |
| WebsiteIDs | UUID List |  | Available for Enterprise Webservices Comma seperated list of WebsiteIDs in Enterprise Leave blank for all websites |
| ProductID | UUID |  | UUID of the Vin65 Product |
| Title | String 255 |  |  |
| SKU | String 50 |  |  |
| Type | Enumerated ("Product", "Wine", "Spirit", "WineProduct", "Bundle", "GiftCard", "EventTicket", "MarketingCollateral") |  |  |
| IsActive | Boolean |  |  |
| DateModifiedFrom | DateTime |  |  |
| DateModifiedTo | DateTime |  |  |
| MaxRows | Integer | 100 |  |
| Page | Integer | 1 |  |

### Sample Request:

```
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<soap:Body>
  <SearchProducts>
    <Request>
      <Security>
        <Username>//Your Username//</Username>
        <Password>//Your Password//</Password>
      </Security>
      <WebsiteIDs>02FC83E3-5EB4-4AA7-A64A-9710BFD9A12A</WebsiteIDs>
      <ProductID></ProductID>
      <SKU></SKU>
      <Type></Type>
      <IsActive>1</IsActive>
      <DateModifiedFrom>2011-01-01T12:21:43</DateModifiedFrom>
      <DateModifiedTo>2011-09-12T12:21:43</DateModifiedTo>
      <MaxRows>100</MaxRows>
      <Page>1</Page>
    </Request>
  </SearchPro ducts>
</soap:Body>
</soap:Envelope>
```

### Sample Response:

```
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSc hema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body> 
  <SearchProductsResponse>
    <SearchProductsReturn>
      <Errors></Errors>
      <IsSuccessful>true</IsSuccessful>
      <Products>
        <Products>
          <ProductID>87a72632-1cc4-81ae-75a1-ce9b32f638be</ProductID>
          <Title>Decanter</Title>
          <SKU>Vinturi Wine Decanter</SKU>
          <Brand>Pine Wines</Brand>
          <Price>94.00</Price>
          <SalePrice/>
          <Type>Product</Type>
          <Vintage/>
          <isActive>true</isActive>
          <WebsiteID>02FC83E3-5EB4-4AA7-A64A-9710BFD9A12A</WebsiteID>
          <DateModified>2012-04-13T21:27:49.153Z</DateModified>
        </Products>
        <Products>
          <ProductID>c9351da6-a936-4086-3619-93ff763536bf</ProductID>
          <Title>2009 Merlot</Title>
          <SKU>Merlot</SKU>
          <Brand/>
          <Price>99.00</Price>
          <SalePrice/>
          <Type>Wine</Type>
          <Vintage>2009</Vintage>
          <isActive>false</isActive>
          <WebsiteID>02FC83E3-5EB4-4AA7-A64A-9710BFD9A12A</WebsiteID>
          <DateModified>2012-04-13T22:00:12.497Z</DateModified>
        </Products>
      </Products>
      <RecordCount>2</RecordCount>
    </SearchProductsReturn>
  </SearchProductsResponse>
</soapenv:Body>
</soapenv:Envelope>
```

[Page Top](/docs/product-webservice-30#)

# GetProductDetail()

### Part Of: Product Webservice 3.0

### WSDL:

[https://webservices.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.vin65.com/V300/ProductService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl)

### Description:

Use the GetProduct() function to retrieve a single product.

### Parameters:

| Attribute | Data Type | Default | Description |
| --- | --- | --- | --- |
| WebsiteID | UUID |  | Available For Enterprise Webservices UUID of the Vin65 Website Not necessary if ProductID is present Useful if searching by SKU and SKU is not unique across Enterprise |
| ProductID* | UUID |  | UUID of the Vin65 Product One of either the ProductID or SKU is required. |
| SKU* | String 50 |  | One of either the ProductID or SKU is required. |

### Sample Request:

```
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<soap:Body>
  <GetProductDetail>
    <Request>
      <Security>
        <Username>//Your Username//</Us ername>
        <Password>//Your Password//</Password>
      </Security>
      <ProductID>eaecd602-db2a-da9d-8a37-ea0c791fed9f</ProductID>
    </Request>
  </GetProductDetail>
</soap:Body>
</soap:Envelope>
```

### Sample Response:

```
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="https://schem as.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
  <GetProductDetailResponse>
    <GetProductDetailReturn>
      <Errors></Errors>
      <IsSuccessful>true</IsSuccessful>
      <Product>
        <ProductID>eaecd602-db2a-da9d-8a37-ea0c791fed9f</ProductID>
        <Title>Chardonnay</Title>
        <Type>Wine</Type>
        <Brand>Pine Wines</Brand>
        <ActionMessage/>
        <BundleItems/>
        <Description>
          <Description>This is a sample description.</Description>
          <Teaser>This is a sample teaser.</Teaser>
        </Description>
        <IsActive>true</IsActive>
        <IsDisplayOnWebsite>true</IsDisplayOnWebsite>
        <Media/>
        <Photos>
          <Photo>
            <Caption/>
            <DisplayOrder>1</DisplayOrder>
            <Photo>white-bottle.png</Photo>
            <Title/>
          </Photo>
        </Photos>
        <POSTitle>Chardonnay</POSTitle>
        <SKUs>
          <SKU>
            <CostOfGood>10.00</CostOfGood>
            <DisplayOrder>1</DisplayOrder>
            <Inventory>
              <Inventory>
                <CurrentInventory>9935</CurrentInventory>
                <InventoryPool>Default Warehouse Location</InventoryPool>
              </Inventory>
            </Inventory>
            <IsInventoryOn>true</IsInventoryOn>
            <IsNoShippingCharge>false</IsNoShippingCharge>
            <IsNonTaxable>false</IsNonTaxable>
            <MaxOrderQty/>
            <MinOrderQty/>
            <OrderInMultiplesOf/>
            <Prices>
              <Price>
                <Price>32.00</Price>
                <PriceLevel>Retail</PriceLevel>
                <PriceQuantity>1</PriceQuantity>
                <SalePrice/>
              </Price>
              <Price>
                <Price>18.00</Price>
                <PriceLevel>Trade</PriceLevel>
                <PriceQuantity>1</PriceQuantity>
                <SalePrice/>
              </Price>
            </Prices>
            <SKU>Chardonnay</SKU>
            <UPCCode/>
            <UnitDescription>750ml</UnitDescription>
            <Weight>3.0</Weight>
          </SKU>
        </SKUs>
        <SpiritProperties/>
        <SubTitle></SubTitle>
        <VintageNotes/>
        <WebsiteID>f660d5e3-0173-4a19-0838-3eff95f2f20b</WebsiteID>
        <WineProperties>
          <Acid></Acid>
          <Alcohol>14.3</Alcohol>
          <Appellation>Okanagan</Appellation>
          <AvgRating>94.0</AvgRating>
          <Awards>Gold Medal First Place at the 2008 Okanagan Icewine Festival</Awards>
          <BottleSize>750ml</BottleSize>
          <BottleSizeInML>750</BottleSizeInML>
          <BottlesInCase/>
          <BottlingDate/>
          <CGRating/>
          <Fermentation/>
          <FoodPairingNotes/>
          <HarvestDate/>
          <JHRating/>
          <OtherNotes >This is not a real wine, this is a demo website</OtherNotes>
          <PH>3.48</PH>
          <Production></Production>
          <ProductionNotes></ProductionNotes>
          <RPRating>94.0</RPRating>
          <Ratings/>
          <Region>Canada</Region>
          <ResidualSugar>222 g/l</ResidualSugar>
          <STRating/>
          <Sugar></Sugar>
          <Tannin>9.23 g/l</Tannin>
          <TastingNotes>Distinctive character, with rich palate coating textures and lots of layers and depth - this is benchmark Wine</TastingNotes>
          <Type>White</Type>
          <Varietal>Chardonnay</Varietal>
          <VineyardDesignation/>
          <VineyardNotes/>
          <Vintage>2006</Vintage>
          <WARating/>
          <WAndSRating/>
          <WBRating/>
          <WERating/>
          <WNRating/>
          <WSRating/>
          <WineMakerNotes/>
        </WineProperties>
        <DateAdded>2011-10-03T16:50:09.057Z</DateAdded>
        <DateModified>2012-04-18T00:01:21.303Z</DateModified>
      </Product>
      <RecordCount>1</RecordCount>
    </GetProductDetailReturn>
  </GetProductDetailResponse>
</soapenv:Body>
</soapenv:Envelope>
```

# AddUpdateProduct()

### Part Of: Product Webservice 3.0

### WSDL:

[https://webservices.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.vin65.com/V300/ProductService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl](https://webservices.aus.vin65.com/V300/ProductService.cfc?wsdl)

### Description:

Use the AddUpdateProduct() function to add or update a product in Vin65. Required fields are indicated by a '*'

**Note - You must send all product attributes in an update request or they will be cleared out. Recommended practice is to getProductDetails prior to update and sync the changes then push the full product up**

### Parameters:

| Attribute | Data Type | Default | Description |
| --- | --- | --- | --- |
| WebsiteID* | UUID |  | Only required for Enterprise Webservices UUID of the Vin65 Website |
| ProductID | UUID |  | UUID of the Vin65 Product |
| Type* | Enumerated ("Product", "Wine", "Spirit", "WineProduct", "Bundle", "GiftCard", "EventTicket", "MarketingCollateral") |  |  |
| Brand | String 50 |  | If Mode eq 'CreateAttributes' Brand will be created on the fly. If Mode eq 'Strict' Brand must exist or add/update will error. |
| Title | String 255 |  |  |
| POSTitle | String 50 |  |  |
| SubTitle | String 255 |  |  |
| ActionMessage | String 255 |  |  |
| IsActive | Boolean | 0 |  |
| IsDisplayOnWebsite | Boolean | 0 |  |
| Description |  |  |  |
| Description:Teaser | String |  |  |
| Description:Descripton: | String |  |  |
| WineProperties |  |  |  |
| WineProperties:BottlesInCase | Integer |  |  |
| WineProperties:BottleSize | String 50 |  | If Mode eq 'CreateAttributes' BottleSize will be created on the fly. If Mode eq 'Strict' BottleSize must exist or add/update will error. |
| WineProperties:BottleSizeInML | Integer |  | If Mode eq 'CreateAttributes' BottleSize will be created on the fly. If Mode eq 'Strict' BottleSize must exist or add/update will error. |
| WineProperties:Vintage | Integer |  |  |
| WineProperties:Type | String 50 |  | Required if Varietal Provided. If Mode eq 'CreateAttributes' Type will be created on the fly. If Mode eq 'Strict' Type must exist or add/update will error. |
| WineProperties:Varietal | String 255 |  | If Mode eq 'CreateAttributes' Varietal will be created on the fly. If Mode eq 'Strict' Varietal must exist or add/update will error. |
| WineProperties:Region | String 255 |  | Required if Appellation Provided. If Mode eq 'CreateAttributes' Region will be created on the fly. If Mode eq 'Strict' Region must exist or add/update will error. |
| WineProperties:Appellation | String 255 |  | If Mode eq 'CreateAttributes' Appellation will be created on the fly. If Mode eq 'Strict' Appellation must exist or add/update will error. |
| WineProperties:WSRating | Integer |  |  |
| WineProperties:WAndSRating | Integer |  |  |
| WineProperties:CGRating | Integer |  |  |
| WineProperties:RPRating | Integer |  |  |
| WineProperties:JHRating | Integer |  |  |
| WineProperties:STRating | Integer |  |  |
| WineProperties:WNRating | Integer |  |  |
| WineProperties:WERating | Integer |  |  |
| WineProperties:WARating | Integer |  |  |
| WineProperties:WBRating | Integer |  |  |
| WineProperties:AvgRating | Numeric |  | Vin65 Calculated Field |
| WineProperties:HarvestDate | String 255 |  |  |
| WineProperties:Sugar | String 255 |  |  |
| WineProperties:Acid | String 255 |  |  |
| WineProperties:PH | String 255 |  |  |
| WineProperties:Fermentation | String 255 |  |  |
| WineProperties:BottlingDate | String 255 |  |  |
| WineProperties:ResidualSugar | String 255 |  |  |
| WineProperties:Tannin | String 255 |  |  |
| WineProperties:Alcohol | String 255 |  |  |
| WineProperties:TastingNotes | String |  |  |
| WineProperties:Ratings | String |  |  |
| WineProperties:Awards | String |  |  |
| WineProperties:VineyardDesignation | String 255 |  |  |
| WineProperties:VineyardNotes | String |  |  |
| WineProperties:ProductionNotes | String |  |  |
| WineProperties:WineMakerNotes | String |  |  |
| WineProperties:FoodPairingNotes | String |  |  |
| WineProperties:Production | String |  |  |
| WineProperties:OtherNotes | String |  |  |
| SpiritProperties |  |  |  |
| SpiritProperties:Type | String 255 |  |  |
| SpiritProperties:Country | String 255 |  |  |
| SpiritProperties:Region | String 255 |  |  |
| Photos |  |  |  |
| Photos:Photo | String 250 |  | Required if Photo Provided |
| Photos:Title | String 255 |  |  |
| Photos:Caption | String |  |  |
| Photos:DisplayOrder | Integer |  |  |
| BundleItems |  |  |  |
| BundleItems:Quantity | Integer |  | Required if Type is Bundle |
| BundleItems:SKU | String 50 |  | Required if Type is Bundle. SKU must exist before bundle can be created. |
| Media |  |  |  |
| Media:Type | Enumerated ("PDF") |  | Required if Media Provided |
| Media:File | String 255 |  | Required if Media Provided |
| Media:Thumbnail | String 255 |  |  |
| Media:Title | String 255 |  | Required if Media Provided |
| Media:Caption | String 255 |  |  |
| Media:DisplayOrder | Integer |  |  |
| VintageNotes |  |  |  |
| VintageNotes:Vintage | Integer |  | Required if Vintage Note Provided |
| VintageNotes:Note | String |  | Required if Vintage Note Provided |
| SKUs |  |  |  |
| SKUs:SKU | String 50 |  | Required for all SKUs |
| SKUs:CostOfGood | Numeric |  |  |
| SKUs:UPCCode | String 255 |  |  |
| SKUs:UnitDescription | String 255 |  |  |
| SKUs:MinOrderQty | Integer | 1 |  |
| SKUs:MaxOrderQty | Integer |  |  |
| SKUs:OrderInMultiplesOf | Integer |  |  |
| SKUs:Weight | Numeric | 0 |  |
| SKUs:IsNonTaxable | Boolean | 0 |  |
| SKUs:IsNoShippingCharge | Boolean |  |  |
| SKUs:DisplayOrder | Integer |  |  |
| SKUs:Prices |  |  |  |
| SKUs:Prices:PriceLevel | String 50 |  | Price Level must exist or add/update will error. |
| SKUs:Prices:Price | Numeric |  | Required for all SKU Prices |
| SKUs:Prices:SalePrice | Numeric |  |  |
| SKUs:Prices:PriceQuantity | Integer |  |  |
| SKUs:IsInventoryOn | Boolean | 0 |  |
| SKUs:Inventory |  |  |  |
| SKUs:Inventory:InventoryPool* | String 50 |  | Inventory Pool must exist or add/update will error. |
| SKUs:Inventory:CurrentInventory | Integer |  |  |
| DateAdded | Date/Time |  |  |
| DateModified | Date/Time |  |  |

### Sample Request:

```
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<soap:Body>
  <AddUpdateProductDetail>
    <Request>
      <Security>
        <Username>//Your Username//</Username>
        <Password>//Your Password//</Password>
      </Security>
      <Product>
        <WebsiteID></WebsiteID>
        <ProductID></ProductID>
        <Type>Wine</Type>
        <Brand></Brand>
        <Title>Merlot Via Webservice</Title>
        <SubTitle></SubTitle>
        <POSTitle></POSTitle>
        <ActionMessage></ActionMessage>
        <IsActive>false</IsActive>
        <IsDisplayOnWebsite>false</IsDisplayOnWebsite>
        <Description>
          <Teaser></Teaser>
          <Description></Description>
        </Description>
        <WineProperties>
          <BottlesInCase></BottlesInCase>
          <BottleSize>750ml</BottleSize>
          <Vintage></Vintage>
          <Type>Red</Type>
          <Varietal>Merlot</Varietal>
          <Region>Australia</Region>
          <Appellation></Appellation>
          <WSRating></W SRating>
          <WAndSRating></WAndSRating>
          <CGRating></CGRating>
          <RPRating></RPRating>
          <JHRating></JHRating>
          <STRating></STRating>
          <WNRating></WNRating>
          <WERating></WERating>
          <WARating></WARating>
          <WBRating></WBRating>
          <AvgRating></AvgRating>
          <HarvestDate></HarvestDate>
          <Sugar></Sugar>
          <Acid></Acid>
          <PH></PH>
          <Fermentation></Fermentation>
          <BottlingDate></BottlingDate>
          <ResidualSugar></ResidualSugar>
          <Tannin></Tannin>
          <Alcohol></Alcohol>
          <TastingNotes></TastingNotes>
          <Ratings></Ratings>
          <Awards></Awards>
          <VineyardDesignation></VineyardDesignation>
          <VineyardNotes></VineyardNotes>
          <ProductionNotes></ProductionNotes>
          <WineMakerNotes></WineMakerNotes>
          <FoodPairingNotes></FoodPairingNotes>
          <Production></Production>
          <OtherNotes></OtherNotes>
        </WineProperties>
        <Photos>
          <Photo>
            <Photo>Tinsel.jpg</Photo>
            <Title>Testing</Title>
            <Caption></Caption>
            <DisplayOrder>1</DisplayOrder>
          </Photo>
        </Photos>
        <Media>
          <Media>
            <Type>PDF</Type>
            <File>123.jpg</File>
            <Thumbnail></Thumbnail>
            <Title>Media Title</Title>
            <Caption>Caption</Caption>
            <DisplayOrder></DisplayOrder>
          </Media>
          <Media>
            <Type>PDF</Type>
            <File>1234.jpg</File>
            <Thumbnail></Thumbnail>
            <Title>Media2 Title</Title>
            <Caption>Caption2</Caption>
            <DisplayOrder>2</DisplayOrder>
          </Media>
        </Media>
        <VintageNotes>
          <VintageNote>
            <Vintage>2000</Vintage>
            <Note>this is the notes</Note>
          </VintageNote>
          <VintageNote>
            <Vintage>2001</Vintage>
            <Note>this is the notes</Note>
          </VintageNote>
        </VintageNotes>
        <SKUs>
          <SKU>
            <SKU>Merlot</SKU>
            <CostOfGood>10.00</CostOfGood>
            <UPCCode></UPCCode>
            <UnitDescription></UnitDescription>
            <MinOrderQty></MinOrderQty>
            <MaxOrderQty></MaxOrderQty>
            <OrderInMultiplesOf></OrderInMultiplesOf>
            <Weight></Weight>
            <IsNonTaxable></IsNonTaxable>
            <IsNoShippingCharge></IsNoShippingCharge>
            <DisplayOrder></DisplayOrder>
            <Prices>
              <Price>
                <PriceLevel></PriceLevel>
                <Price>200.00</Price>
                <SalePrice></SalePrice>
                <PriceQuantity></PriceQuantity>
              </Price>
            </Prices>
            <IsInventoryOn>1</IsInventoryOn>
            <Inventory>
              <Inventory>
                <InventoryPool></InventoryPool>
                <CurrentInventory>20</CurrentInventory>
              </Inventory>
            </Inventory>
          </SKU>
        </SKUs>
      </Product>
      <Mode>Strict</Mode>
    </Request>
  </AddUpdateProductDetail>
</soap:Body>  
</soap:Envelope>
```

### Sample Response:

```
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="ht tp://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
  <AddUpdateProductDetailResponse>
    <AddUpdateProductDetailReturn>
      <Errors></Errors>
      <IsSuccessful>true</IsSuccessful>
      <ProductID>1ce73176-e448-faac-3d8f-a52333091695</ProductID>
      <RecordCount>1</RecordCount>
    </AddUpdateProductDetailReturn>
  </AddUpdateProductDetailResponse>
</soapenv:Body>
</soapenv:Envelope>
```