Escolar Documentos
Profissional Documentos
Cultura Documentos
Document versions
Author
Alexandr Kravtsov
Alexandr Kravtsov
Alexandr Kravtsov
Alexandr Kravtsov
Date
25.06.13
28.08.13
10.09.13
15.01.14
Version
1.0.
1.1.
1.2.
1.3.
Sergey Ermolaev
Alexandr Kravtsov
24.06.14
19.03.15
1.4.
1.5.
Alexandr Kravtsov
20.05.15
1.6.
Alexandr Kravtsov
Alexandr Kravtsov
Alexandr Kravtsov
09.07.15
03.08.15
17.09.15
1.7.
1.8.
1.9.
Comments
First version of RT CSV interface description
Changes related to new CSV structure.
Description of access to rich media type of content.
Changed document structure.
Extension of documentation by adding a description of
new features and interfaces.
Changes in the specs and gallery images publication
Described few improvements in personalized index file
and rich product CSV files.
Added more detailed description of ReasonsToBuy
content type in CSV interface
Link to personalized index file has been added
Missing columns in product CSV has been added
Structural changes (split of MultimediaObjects column)
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
1 / 13
2 / 13
If you want to upgrade to Full Icecat, you can contact us via the contact form, or click on the request
Full Icecat access link after the User Login (http://www.icecat.biz/en/menu/openIcecat/index.htm),
or fill in and fax the Full Icecat registration form: http://icecat.biz/forum.cgi?
tmpl=view_message.html;message_id=3191;thread_id=1
that you can find as an attachment. You will also find in the attached form (pdf) the standard Full
Icecat tariffs.
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
3 / 13
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
4 / 13
XML: http://www.w3schools.com/xml/xml_syntax.asp
Excel: http://en.wikipedia.org/wiki/Microsoft_Excel_file_format#File_formats
Based on product identifiers described above system make a matching between your feed and Icecat
database. Icecat automatically add necessary information to matched data and generate personal files
that can be downloaded from My Icecat page in CSV or XLS and used for your purposes.
Paragraph 1.4. Interface description describes the interface and related helpful features.
2.3. Types of personalized CSV files
Icecat generates following personal CSV files:
Personal index file (PIF) - personal index file that contains basic information about matched product
data-sheets like product identifiers and paths to XML or URL (based on your subscription) URLs.
File content:
Column title
Description
prod_id
supplier_name
ean_upc
Path
Timestamp
Your product ID
*- Internal product identifier is optional, but its presence in the PIF simplifies the process of data
processing. It allows you to match the ID from your database with specific data-sheet in Icecat catalog.
Last column contains a link to product data-sheet that system generates based on subscription type of
your account (URL / XML) and assignments to local repositories.
Personal catalog file (PCF) - personalized file that contains detailed information per each matched
product. This type of file is available only to users with XML subscription.
File content:
Column title
Description
Requested_prod_id
Requested_GTIN(EAN/UPC)
Requested_Icecat_id
First three columns contains the information for your information that allows you to understand on
what basis Icecat system found a matching between an item from your file and product from Icecat
database.
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
5 / 13
ErrorMessage
Supplier
Prod_id
Icecat_id
GTIN(EAN/UPC)
Category
CatId
ProductFamily
ProductSeries
Model
Updated
Quality
On_Market
Product_Views
HighPic
LowPic
Pic500x500
ThumbPic
Folder_PDF
Folder_Manual_PDF
ProductTitle
ShortDesc
ShortSummaryDescription
LongSummaryDescription
LongDesc
ProductGallery
ProductGallery Resolution
360
EU Energy Label
EU Product Fiche
PDF
Video/mp4
Other multimedia
ReasonsToBuy
Spec
My catalogs rich media assets - CSV file with links to media assets per each product data-sheet that
were matched between your feed and Icecat catalog. This type of file is available only to users with
XML subscription.
File content:
Column title
Explanation
Requested_prod_id
Requested_GTIN(EAN/UPC)
Requested_Icecat_id
ErrorMessage
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
6 / 13
Supplier
Prod_id
Icecat_id
GTIN(EAN/UPC)
HighPic
ProductGallery
ProductGallery Resolution
360
EU Energy Label
EU Product Fiche
PDF
Video/mp4
Other multimedia
ReasonsToBuy
Left block called XML content and contains a general information of your XML subscription:
- Indication of subscription level
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
7 / 13
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
8 / 13
Please also select the column with internal unique product identifier in your database, if applicable.
If you preview is not visible please check if price file format is correct or contact us.
- Click Save button when you finish with column assignments;
- After that you may check a status of file processing in Import status tab;
- As soon as import results are ready and visible in Import status, please open My downloads
tab to check if personalized CSV files are ready. Please be aware, that generating of such file may
take some time, so in case if CSV is not ready you will see a status message.
- In order to access or download your PIF without login in the User Panel, please use the link
below: https://icecat.biz/index.cgi?login_form=user_import_report;type=match;layout=csv;login=
XXXXX;password=XXXXX where XXXXX should be a the login name and password of your Icecat
account. Using this link, you may automate and simplify the process of data processing.
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
9 / 13
Explanation
Requested_Prod_ID
Requested_GTIN_(EAN/UPC)
Requested_Icecat_id
ErrorMessage
Supplier
Prod_id
Icecat_id (product_id)
GTIN (EAN/UPC)
Category
CatId
ProductFamily
ProductSeries
Model
Updated
Quality
On market
Product Views
HighPic
HighPic Resolution
LowPic
Pic500x500
ThumbPic
Folder_PDF
Folder_Manual_PDF
ProductTitle
Short desc
ShortSummaryDescription
LongSummaryDescription
LongDesc
ProductGallery
ProductGallery Resolution
360
EU Energy Label
EU Product Fiche
PDF
Video/mp4
Other multimedia
ReasonsToBuy
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
10 / 13
Columns with product specifications are included with column headers such as Spec #, so that each
new specification (feature) is a new column in the output CSV file. Number of specifications depends
on the number of described feature values in product data-sheet. A cell with specification value
consists of feature name, feature value and measure unit (if present).
Those columns also contain feature group names. Feature groups consist of multiple features which
are listed under the related feature group name.
Example:
Column header - Spec 1
Value - Processor
Column header - Spec 2
Value - Processor clock speed: 3.2 GHz
Column header - Spec N (where N is any spec number)
Value - Display
Column header - Spec N+1
Value Display diagonal: 17
Where:
Processor, Display spec groups
Processor clock speed, Display diagonal feature names
3.2, 17 - feature values
GHz, units
Example string from CSV (feature groups Design , Processor and Memory are marked in red):
"Design","Product type: Notebook","Colour of product: Black, Silver","Form factor:
Clamshell","Processor","Processor clock speed: 1.3 GHz","Processor family: AMD E","Processor model:
E2-3800","Processor cores: 4","Processor threads: 4","Processor cache: 2 MB","Memory","Internal
memory: 8 GB","Internal memory type: DDR3-SDRAM","Maximum internal memory: 16 GB","Memory
form factor: SO-DIMM",..
3.2. URL call details
Icecat real-time CSV interface support URL requests by:
- GTIN (EAN/UPC) code(s)
- GTIN (EAN/UPC) code(s) + category (id)
- MPN(s) + Brand (vendor name)
- MPN(s) + Brand (vendor name) + category (id)
- Icecat internal numerical product identifier(s) (icecat_id)
- Icecat internal numerical product identifier(s) + category (id)
Please find more detailed description of each parameter below:
ean_upc - GTIN (EAN/UPC) code (one or several separated by comma)
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
11 / 13
prod_id - manufacturer part code or comma separated list of part codes (or alternative product code
that came from sources into Icecat db and became m_prod_id based on mapping database)
vendor - manufacturer brand name (or manufacturer brand name from supplier mappings)
icecat_id (product_id) - unique internal Icecat identifier of product data-sheet, also can be listed with
comma separation
lang - language identifier (Icecat return EN data-sheet by default if no lang is selected in URL request)
cat - optional but suggested parameter where user may put Icecat numerical identifier of category
output - type of output (Icecat return productxml if no output is selected)
Important: Red marked parameters are mandatory. A request only with ean_upc or icecat_id
(product_id) without vendor and brand name is recognizable by the system and will return a datasheet.
Below you may find examples of URL calls:
http://data.icecat.biz/xml_s3/xml_server3.cgi?prod_id=<list of product
codes>;vendor=Philips;lang=<lang>;output=productcsv
http://data.icecat.biz/xml_s3/xml_server3.cgi?ean_upc=8711500354532,8711500354501;lang=EN;out
put=productcsv
http://data.icecat.biz/xml_s3/xml_server3.cgi?prod_id=4347B007,8576B064;vendor=canon;lang=IT;ou
tput=productcsv
3.3. Access to rich content
Icecat provide authorized resellers with access to special type of content rich media - via XML,
xml_s3 and real-time CSV interfaces.
CSV with rich media content can be requested by assigned reseller (assigned on brand level) with
special output parameter: output=richproductcsv
Examples:
http://data.icecat.biz/xml_s3/xml_server3.cgi?product_id=17727188;lang=NL;output=richproductcsv
http://data.icecat.biz/xml_s3/xml_server3.cgi?ean_upc=8710103608011;lang=NL;output=richproduct
csv
This type of CSV contains rich media assets that has special restriction requested by respective
brand.
3.4. URL symbols encoding
Since some manufacturer codes may consist of special symbols like +, #, !, %, _ or space Icecat may
process these only if URL encoding of such symbols is included in the URL request.
Examples:
WBE3321A+NFSM = WBE3321A%2BNFSM
3580S4X BNDL = 3580S4X%20BNDL
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
12 / 13
Icecat NV . De Liesbosch 12d . 3439 LC Nieuwegein . The Netherlands . t +31(0) 30 711 4700 . f +31(0) 84 838 5468 . info@icecat.biz . www.icecat.biz
COC:30259744 . Bank ABN Amro:402903846 . IBAN:NL64ABNA0402903846 . BIC:ABNANL2A . VAT:NL820687091B01 . PayPal: info@icecat.biz
13 / 13