Products.xml files

 Scheme

 products-xml

Detailed Structure

The detailed structure of the Products.Xml file is described in Chapter 4.

Decimal separator

The decimal separator of f decimal number is the dot « . ».

Pictures management

The source images must be specified in the URL attribute. It must indicate a valid and Freely available

url where the picture is stored

[Content_Types].xml file structure

 

The content of this file is fixed:

<?xml version="1.0" encoding="utf-8"?>

<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">

  <Default Extension="xml" ContentType="text/xml" />

  <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml" />

  <Default Extension="png" ContentType="image/jpeg" />

</Types>

Detailed Description of the Products.xml files

Please find hereafter a sample of the product package : APIMPCdiscount_Sample_Products
Hereafter the product xsd file: XSDProducts.zip

 

Product element

This element describes an product.

diagram  product
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content Complex
used by#Link8
element ProductPackage.Products
attributes
Name Type Use Default Fixed annotation
Width xs:byte
Weight xs:byte
Size xs:string
ShortLabel xs:string required
SellerProductId xs:string required
SellerProductFamily xs:string
SellerProductColorName xs:string
CategoryCode xs:string required
ProductKind derived by: xs:string required
Navigation xs:string required
Model xs:string required
ManufacturerPartNumber derived by: xs:string
LongLabel xs:string required
Length xs:byte
ISBN xs:string
Height xs:byte
EncodedMarketingDescription xs:string
Description xs:string required
BrandName xs:string required
source <xs:element name=”Product”>

<xs:complexType>

<xs:sequence>

<xs:element ref=”Product.EanList”/>

<xs:element ref=”Product.ModelProperties”/>

<xs:element ref=”Product.Pictures”/>

</xs:sequence>

<xs:attribute name=”Width”/>

<xs:attribute name=”Weight”/>

<xs:attribute name=”Size”/>

<xs:attribute name=”ShortLabel” use=”required”/>

<xs:attribute name=”SellerProductId” use=”required”/>

<xs:attribute name=”SellerProductFamily”/>

<xs:attribute name=”SellerProductColorName”/>

<xs:attribute name=”CategoryCode” use=”required”/>

<xs:attribute name=”ProductKind” use=”required”/>

<xs:attribute name=”Navigation” use=”required”/>

<xs:attribute name=”Model” use=”required”/>

<xs:attribute name=”ManufacturerPartNumber”/>

<xs:attribute name=”LongLabel” use=”required”/>

<xs:attribute name=”Length”/>

<xs:attribute name=”ISBN”/>

<xs:attribute name=”Height”/>

<xs:attribute name=”EncodedMarketingDescription”/>

<xs:attribute name=”Description” use=”required”/>

<xs:attribute name=”BrandName” use=”required”/>

</xs:complexType>

</xs:element>

 

Attribute Product/@Width

This attribute describes the product width

type xs:byte
properties
isRef 0
source <xs:attribute name=”Weight” type=”xs:byte”/>

 

Attribute Product/@Weight

This attribute describes the product weight.

type xs:byte
properties
isRef 0
source <xs:attribute name=”Weight” type=”xs:byte”/>

 

Attribute Product/@Size

This attribute represents the product Size for varying products.

Warning :

This attribute is require if ProductKind = ‘Variant’ and is not considered if ProductKind=’Standard’

 

Type xs:string
Properties
isRef 0
Source <xs:attribute name=”Size” type=”xs:string”/>

Attribute Product/@ShortLabel

This attribute describes a short label for the product

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”ShortLabel” type=”xs:string” use=”required”/>

 

Attribute Product/@SellerProductId

This attribute describes the seller product id

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”SellerProductId” type=”xs:string” use=”required”/>

 

Attribute Product/@SellerProductFamily

This attribute describes the code of the “family” in which the product is associated in the catalog managed in size and color

Warning :

This attribute is require if ProductKind = ‘Variant’ and is not considered if ProductKind=’Standard’

Type xs:string
Properties
isRef 0
Source <xs:attribute name=”SellerProductFamily” type=”xs:string”/>

 

Attribute Product/@SellerProductColorName

This attribute describes the color name of the product.

Warning :

This attribute is require if ProductKind = ‘Variant’ and is not considered if ProductKind=’Standard’

Type xs:string
Properties
isRef 0
Source <xs:attribute name=”SellerProductColorName” type=”xs:string”/>

 

Attribute Product/@CategoryCode

This attribute describes the category code of the product .

Type xs:string
Properties
isRef 0
use required
Source <xs:attribute name=”CategoryCode” type=”xs:string”/>

 

Attribute Product/@ProductKind

This attribute describes the product type (“Standard” or “Variant”)

type restriction of xs:string
properties
isRef 0
use required
facets
Kind Value annotation
enumeration Standard
enumeration Variant
source <xs:attribute name=”ProductKind” use=”required”> <xs:simpleType>    <xs:restriction base=”xs:string”>      <xs:enumeration value=”Standard”/>      <xs:enumeration value=”Variant”/>    </xs:restriction> </xs:simpleType> </xs:attribute>

Attribute Product/@Navigation

This attribute describes textually the category tree of the product on the seller side

Ex : High-Tech > Photo > Reflex > 10-15 MegaPixels

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”Navigation” type=”xs:string” use=”required”/>

 

Attribute Product/@Model

This attribute contains the name of the product model defining the product and his optional properties.

The name and the optional data structure of the models are available through a GetModelList soap call. The model search is made on category code.

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”Model” type=”xs:string” use=”required”/>

 

Attribute Product/@ManufacturerPartNumber

This attribute describes the MFPN of the product.

type restriction of xs:string
properties
isRef 0
facets
Kind Value annotation
enumeration 678678DD687
source <xs:attribute name=”ManufacturerPartNumber” type=”xs:string” />

 

Attribute Product/@LongLabel

This attribute describes the long label of the product

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”LongLabel” type=”xs:string” use=”required”/>

 

Attribute Product/@Length

This attribute describes the length of the product

type xs:byte
properties
isRef 0
source <xs:attribute name=”Length” type=”xs:byte”/>

 

Attribute Product/@ISBN

This attribute describes the ISBN Code of the product

type xs:string
properties
isRef 0
source <xs:attribute name=”ISBN” type=”xs:string”/>

 

Attribute Product/@Height

This attribute describes the height of the product

type xs:byte
properties
isRef 0
source <xs:attribute name=”Height” type=”xs:byte”/>

 

Attribute Product/@EncodedMarketingDescription

This optional attribute describes the marketing description in the form of simple text or of html.

 

Warning : the text must be encoded in base 64

type xs:string
properties
isRef 0
source <xs:attribute name=” EncodedMarketingDescription” type=”xs:string”/>

 

Attribute Product/@Description

This attribute is the product description

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”Description” type=”xs:string” use=”required”/>

 

Attribute Product/@BrandName

This attribute describes the brand name.

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”BrandName” type=”xs:string” use=”required”/>

 

This element describes the ean list associated to the product, by defaultonly the first occurrence is considered.

 

Product.EanList Element

 

 

diagram  eanlist
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
children ProductEan
used by
element Product
source <xs:element name=”Product.EanList”> <xs:complexType>    <xs:sequence>      <xs:element ref=”ProductEan” maxOccurs=”unbounded”/>    </xs:sequence> </xs:complexType> </xs:element>

 

ProductEan Element

This element describes EAN.

diagram  productean
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
used by
element Product.EanList
attributes
Name Type Use Default Fixed annotation
Ean xs:string required
source <xs:element name=”ProductEan”> <xs:complexType>    <xs:attribute name=”Ean” type=”xs:string” use=”required”/> </xs:complexType> </xs:element>

 

Attribut ProductEan/@Ean

This attribute describes the EAN value

type xs:string
properties
isRef 0
use required

 

 

Product.ModelProperties Element

 

This element describes the product marketing model property list. It contains a list of bounded value (int or varchar).

diagram  product-modelproperties
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
children Int32 String
used by
element Product
source <xs:element name=”Product.ModelProperties”> <xs:complexType>    <xs:sequence>      <xs:element ref=”x:Int32″ minOccurs=”0″/>      <xs:element ref=”x:String” minOccurs=”0″/>    </xs:sequence> </xs:complexType> </xs:element>

 

Example :

<Product.ModelProperties>

  <x:String x:Key="Alimentation">Secteur</x:String>

  <x:String x:Key="Couleur principale">Noir</x:String>

</Product.ModelProperties>

<Product.ModelProperties>

  <x:String x:Key="Genre">Policier-Thriller</x:String>

  <x:String x:Key="Langue">Français</x:String>

  <x:String x:Key="Support de lecture">DVD</x:String>

</Product.ModelProperties>

 

 

Product.Pictures element

The element describes the pictures list associated to the product. There can not be more than 4 pictures.

diagram  product-pictures
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
children ProductImage
used by
element Product
source <xs:element name=”Product.Pictures”> <xs:complexType>    <xs:sequence>      <xs:element ref=”ProductImage” maxOccurs=”unbounded”/>    </xs:sequence> </xs:complexType> </xs:element>

 

ProductImage Element

diagram  productimage
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
used by
element Product.Pictures
attributes
Name Type Use Default Fixed annotation
Uri xs:anyURI required
source <xs:element name=”ProductImage”> <xs:complexType>    <xs:attribute name=”Uri” type=”xs:anyURI” use=”required”/> </xs:complexType> </xs:element>

 

Attribute ProductImage/@Uri

type xs:anyURI
properties
isRef 0
use required
source <xs:attribute name=”Uri” type=”xs:anyURI” use=”required”/>

 

 

ProductPackage Element

diagram  productpackage
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
children ProductPackage.Products
attributes
Name Type Use Default Fixed annotation
Name xs:string required
source <xs:element name=”ProductPackage”> <xs:complexType>    <xs:sequence>      <xs:element ref=”ProductPackage.Products”/>    </xs:sequence>    <xs:attribute name=”Name” type=”xs:string” use=”required”/> </xs:complexType> </xs:element>

 

Attribute ProductPackage/@Name

type xs:string
properties
isRef 0
use required
source <xs:attribute name=”Name” type=”xs:string” use=”required”/>

 

ProductPackage.Products Element

diagram  productpackage-products
namespace clr-namespace:Cdiscount.Service.ProductIntegration.Pivot;assembly=Cdiscount.Service.ProductIntegration
properties
content complex
children Product
used by
element ProductPackage
source <xs:element name=”ProductPackage.Products”> <xs:complexType>    <xs:sequence>      <xs:element ref=”Product” maxOccurs=”unbounded”/>    </xs:sequence> </xs:complexType> </xs:element>