TB.One > Import & Export > Master Data Import via CSV > Article Fields in the Import CSV
These field definitions describe the scope of TB.One's features and technical requirements. The channel requirements may differ from this. Generally, TB.One is able to store more characters per field than the channels will accept. You should aim to provide as many fields as possible while keeping the contents of the individual fields short and concise. Always keep any channel-specific requirements in mind!
You need to provide channel-specific columns for each of your channels.
TIP: |
TIP: |
FIELD NAME |
REQUIRED |
DESCRIPTION |
MULTILINGUAL |
|
|---|---|---|---|---|
p_nr |
Y |
CHAR(50) |
Product number. Used to assign newly created articles to a product. Can also used for existing articles. If the product number changes for an article, it will be moved to a different product. Some channels do not allow this! |
N |
a_nr |
Y |
CHAR(50) |
Article number (SKU). Mandatory for article data. Unique number for this article/variant across all articles ▪do not use spaces or special characters ▪use a maximum of 16 characters |
N |
a_nr2 |
N |
CHAR(50) |
Article number 2 (additional article number) |
N |
a_ean |
Y |
EAN13 |
EAN-code for this article |
N |
a_prodnr |
N |
CHAR(50) |
N |
|
a_chnr[channel] |
N |
CHAR(50) |
Channel article number (if the channel assigns its own article numbers, e.g. Amazon's ASIN); when exporting the product data as PANDA.CSV or ARTICLE.CSV, this column is referenced as "a_nr_channel[channel]". |
N |
a_active |
N |
INT(0/1) |
Indicator for article activation (yes/no). This setting applies to all distribution channels. |
N |
a_active[channel] |
N |
INT(0/1) |
Indicator for channel-specific article activation (yes/no). This setting only applies to the indicated distribution channel. To activate an article on a specific channel, both the field "a_active[channel]" and the field "a_active" need to contain the value "1". |
N |
a_comp[key] mutiple |
N |
CHAR(255) |
Variant information (import key as key; content = variant value; import assignment via TB.One available) If you provide variant dimensions via import, deliver ALL dimensions. The information must be complete. Otherwise, variants already created will be deleted again. |
Y |
ap_comp[key] |
N |
CHAR(255) |
(Non-variant-forming) article component |
Y |
a_tag[key]{seqno} |
N |
CHAR(100) |
Article attributes |
N |
a_provision[channel] |
N |
CHAR(50) |
Commission group for a channel (see channel sign). Commission groups can be created in TB.One under "Channels > [Channel] > Commission groups". |
N |
a_vk[channel/price list key] |
Y |
FLOAT |
Retail price referring to a price list or a channel (see channel sign). |
N |
a_vk_old[channel/price list key] |
N |
FLOAT |
Former selling price referring to a price list or a channel; causes a cross price to be displayed (see channel sign) |
N |
a_uvp[channel/price list key] |
N |
FLOAT |
Manufacturer's suggested retail price (MSRP) referring to a price list or a channel |
N |
a_mwst[channel/price list key] |
N |
INT(0/1) |
VAT rate for sales channel. Possible values are: |
N |
a_ek |
N |
FLOAT |
Purchase price (internal information) |
N |
a_ch_ek[channel/price list key] |
N |
FLOAT |
Net purchase price for distribution channel |
N |
a_base_price[key] |
N |
FLOAT |
Base price; key = import key according to "Basic data > Prices > Base prices" |
N |
a_media[key]{seqno} |
N |
CHAR(255) |
References article media. If the same media should be used for several articles, use the same reference value in this field. |
N |
a_stock |
N |
INT(0/1) |
Stock |
N |
a_warn |
N |
INT(0/1) |
Warning stock (in TB.One, you can filter for articles that have reached the warning stock amount) |
N |
a_delivery |
N |
INT(0/1) |
Delivery time in business days (order to arrival of the shipment) |
N |
a_replace |
N |
INT(0/1) |
Replaceable (1 = yes/0 = no) |
N |
a_repltime |
N |
INT(0/1) |
Replacement time in business days |
N |
a_separate |
N |
INT(0/1) |
Only valid for neckermann.at |
N |
a_maxsep |
N |
INT(0/1) |
Only valid for neckermann.at |
N |
a_shipping_type |
N |
CHAR(50) |
The article's shipping type. The import key according to "Basic data > Shipping > Shipping types" is transferred. |
N |
a_depot |
N |
CHAR(100) |
Storage compartment; the storage compartment can be printed on pick lists and delivery notes. |
N |
a_depot_text |
N |
CHAR(255) |
Comment regarding the storage compartment |
N |
a_pieces |
N |
INT(0/1) |
Number of pack pieces |
N |
The package data is optional. However, if one of the values is specified, all other values become mandatory! |
||||
a_width |
N |
INT(0/1) |
Width of all the article's packages in cm |
N |
a_length |
N |
INT(0/1) |
Length of all the article's packages in cm |
N |
a_height |
N |
INT(0/1) |
Height of all the article's packages in cm |
N |
a_weight |
N |
FLOAT |
Weight of all the article's packages in kg |
N |
a_org_country |
N |
CHAR(2) |
Country of origin (ISO alpha 2) |
N |
a_intrastat |
N |
CHAR(8) |
8-digit IntraStat number |
N |
a_unit |
N |
ENUM |
The article's unit ST = pieces |
N |
a_order_min |
N |
INT |
Minimum order quantity |
N |
a_order_max |
N |
INT |
Maximum order quantity |
N |
a_order_intervall |
N |
INT |
Order interval |
N |
Import of prices on master article level (product detail view, tab "Master article"):
The data transferred via the fields below will be entered in the master article. The import will not change the activation status of the master article's respective data group. If a product's data group for master article price data is active and the individual article is not excluded from master article editing, the price data imported via the fields shown below will be assigned to all of the product's articles.
FIELD NAME |
REQUIRED |
DATA TYPE |
DESCRIPTION |
MULTILINGUAL |
|---|---|---|---|---|
p_master_vk[channel/price list key] |
N |
FLOAT |
Retail price (see channel sign) |
N |
p_master_vk_old[channel/price list key] |
N |
FLOAT |
Former selling price; causes a cross price to be displayed (see channel sign) |
N |
p_master_uvp[channel/price list key] |
N |
FLOAT |
Manufacturer's suggested retail price (MSRP) |
N |
p_master_mwst[channel/price list key] |
N |
INT(1/2) |
VAT rate for the sales channel. Possible values are: |
N |
p_master_ek |
N |
FLOAT |
Purchase price (internal information) |
N |
p_master_ch_ek[channel/price list key] |
N |
FLOAT |
Net purchase price for distribution channel |
N |
Importing pack dimensions individually for each pack piece:
It is possible to transfer individual pack dimensions for each pack piece. Contact Tradebyte to unlock this feature.
If you choose to provide the pack dimensions in this way, transfer the number of pack pieces in "a_pieces" and fill in the separate columns for each pack piece. In this case, each pack piece must be assigned all of the "a_shipping_unit" columns listed below.
FIELD NAME |
REQUIRED |
DATA TYPE |
DESCRIPTION |
MULTILINGUAL |
|---|---|---|---|---|
a_shipping_unit[width]{seqno} |
Y |
INT |
Width of the pack piece (starting with package no. 0) |
N |
a_shipping_unit[length]{seqno} |
Y |
INT |
Length of the pack piece (starting with package no. 0) |
N |
a_shipping_unit[height]{seqno} |
Y |
INT |
Height of the pack piece (starting with package no. 0) |
N |
a_shipping_unit[weight]{seqno} |
Y |
INT |
Weight of the pack piece (starting with package no. 0) |
N |
For further information, see also:
•Master data import via CSV - overview