Namespace http://schema.zmags.com/product_data_1.0

Namespace URI
http://schema.zmags.com/product_data_1.0
Target Namespace
http://schema.zmags.com/product_data_1.0
Version
1.0
Date Published
2011-07-27
Schema Language
XML Schema Definition Language 1.0
Documentation
Copyright 2010-2011 Zmags, All rights reserved.
This schema describes the standard Zmags XML format for product data imports.

Introduction to the Product Data XML Schema

Version 1.0

This schema describes the standard Zmags XML format for product data imports. http://schema.zmags.com/product_data_1.0 is the namespace URI for the XML schema that defines the format for product data XML files.

Text encoding

The product data import XML file supports these text encodings: UTF-8, UTF-16, ISO-8859-1, US-ASCII.

Value types

	Product properties can have one of the following value types:
	    text
	    boolean
	    integer
	    decimal
	    timestamp
	    text_list
	    boolean_list
	    integer_list
	    decimal_list
	    timestamp_list
	    
	The input format is as follows:
	    text
	        Simple text. Remember that XML reserved characters (< > " ', &) must be entity encoded.
	        
	        Example:
	            <name>T-shirt (100% cotton)</name>
	            <normal_image_url>http://example.com/image?id=22&amp;cust=101</normal_image_url>
	    boolean
	        true/yes/on/enabled/1   (case-insentitive) maps to true
	        false/no/off/disabled/0 (case-insentitive) maps to false
	        
	        Example:
	            <enabled>False</enabled>
	            
	    decimal
	        Both comma and period decimal separators are supported. The last 
	        comma or period in the value is considered the decimal 
	        separators. The rest are considered thousands separators. 
	        
	        Supports values from -9999999999999999.99 to 9999999999999999.99 (both inclusive).
	        
	        Example:
	            <price>1,200.00</price>
	            
	    integer
	        Supports values from -9223372036854775808 to 9223372036854775807 (both inclusive).
	        
	        Example:
	            <available_to_sell>142</available_to_sell>
	            
	    timestamp
	        yyyy-MM-dd HH:mm:ss z
	        
               yyyy    is the year as a four-digit number
               MM      is the months as a two digit number (1 = January, 12 = December)
               dd      is the day of the month, starting at 1
               HH      is the hour of day (0-23)
               mm      is the minutes of the hour (0-59)
               ss      is the seconds (0-59)
               z       is a time-zone abbreviation, such as CET, PST, EST, GMT.
                       It is possible to specify a time-zone manually as offset
                       from GMT, using the format GMT+HH:mm or GMT-HH:mm, e.g.
                       GMT+2:00. 
	        
	        Example:
	            <sale_started>2009-08-27 21:04:12 PST</sale_started>
	
                (This uses a custom property named sale_started.)
	
	For the list value types, the property is simply repeated and the value 
	format is the same as for the simple type.
	

Built-in property types

	The importer defines the following built-in property types:        
	    product_id                  (of type text)
        enabled                     (of type boolean)
        master_product_id           (of type text)
        default_variant_product_id  (of type text)
        name                        (of type text)
        category_name               (of type text)
        category_id                 (of type text)
        description                 (of type text)
        short_description           (of type text)
        brand                       (of type text)
        manufacturer                (of type text)
        color                       (of type text)
        size                        (of type text)
        price                       (of type decimal, with the additional restriction that negative values are not allowed)
        discount_price              (of type decimal, with the additional restriction that negative values are not allowed)
        discount_rate               (of type decimal)
        available_to_sell           (of type integer)
        age                         (of type integer)
        rating                      (of type decimal)
        recommendable               (of type boolean)
        thumb_image_url             (of type text_list)
        normal_image_url            (of type text_list)
        zoom_image_url              (of type text_list)
	

Schema location

XML schema document is located here.