Product data catalogue – TBCATALOG

The following requirements apply for the product data file, the so-called TB.CAT:

  • File format: XML
  • Coding: UTF-8
  • Maximum file size: 10 MB at upload and import via the TB.One user interface
  • The sequence of the elements is not free.

TB.CAT 1.3 Structure

Node Mandatory Data type (Length) Description
TBCATALOG Y Start of the product data catalogue
Attribute: version Y INT Setting the TB.CAT version serves the identification of the correct XSD for validation. The current version is always “1.3”.
Attribute: channel N String(12) Channel sign, normally 4-digit sign (only export) Based upon this sign, the channel can verify the assignment of the data to ensure technically that they don’t process data of wrong source or destination.
Attribute: creation N UNIX time stamp The creation time of the catalogue is automatically added at export. The creation time serves the recognition of the correct sequence of catalogues and defines for delta loads the time from when changes should be collected and transferred.

Subordinate elements:

Example XML

<?xml version="1.0" encoding="UTF-8"?> <TBCATALOG version="1.3" creation="1378277984"> <SUPPLIER>Dokuaccount</SUPPLIER> <PRODUCTDATA type="full"> <!– delta request control: 0 –> <PRODUCT> <ARTICLEDATA> <ARTICLE>…</ARTICLE> </ARTICLEDATA> </PRODUCT> </PRODUCTDATA> </TBCATALOG> <!– Coding –> <!– Start node with version and (at export) creation time –> <!– Information about data supplier (only export) –> <!– Start of the product data, "Full-Load" –> <!– Sent time stamp (only at Delta-Loads>0) –> <!– Start of a product –> <!– Start of the article data associated with the product –> <!– Details of an article –> <!– End of the article data associated with the product –> <!– End of a product –> <!– End of the product data –> <!– End of the catalogue –>