Scheme

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
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

Attribute Product/@Weight

This attribute describes the product weight.

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’

Attribute Product/@ShortLabel

This attribute describes a short label for the product

Attribute Product/@SellerProductId

This attribute describes the seller product id

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’

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’

Attribute Product/@CategoryCode

This attribute describes the category code of the product .

Attribute Product/@ProductKind

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

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

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.

Attribute Product/@ManufacturerPartNumber

This attribute describes the MFPN of the product.

Attribute Product/@LongLabel

This attribute describes the long label of the product

Attribute Product/@Length

This attribute describes the length of the product

Attribute Product/@ISBN

This attribute describes the ISBN Code of the product

Attribute Product/@Height

This attribute describes the height of the product

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

Attribute Product/@Description

This attribute is the product description

Attribute Product/@BrandName

This attribute describes the brand name.

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

Product.EanList Element

diagram
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
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

Product.ModelProperties Element

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

diagram
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
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
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

ProductPackage Element

diagram
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

ProductPackage.Products Element

diagram
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>