Katalogspezifikationen CSV-Format

Dieser Leitfaden richtet sich an Lieferanten, die das CSV-Format verwenden. Er beschreibt alle Katalogfelder mit ihren Funktionen, Anforderungen und technischen Spezifikationen.

Erfassen Sie jeden Artikel in einer eigenen Zeile der Excel-Vorlage products_katalogID_deu.xlsx. Die Katalogfelder entsprechen den Spalten in der Vorlage. Wie Sie die Vorlage herunterladen und nutzen, erfahren Sie im Artikel So erstellen Sie einen Katalog.

Im zweiten Tabellenblatt finden Sie Beispieldaten zur Orientierung.

Pflichtfelder

Pflichtfelder erfüllen gesetzliche Anforderungen (z. B. Energieverbrauchskennzeichnung, Gefahrstoffkennzeichnung) und erhöhen die Sichtbarkeit Ihrer Produkte.

In der Excel-Vorlage sind Pflichtfelder farbig hervorgehoben:

Screenshot zeigt wie ein Pflichtfeld aussieht

Pflichtfeld – muss ausgefüllt werden

Screenshot zeigt wie ein optionales Feld aussieht

Optionales Feld – kann ausgefüllt werden

In den folgenden Abschnitten finden Sie Hinweise zu den Katalogfeldern. Die Reihenfolge entspricht der Spaltenanordnung in der Excel-Vorlage.

Artikeldetails

Grundlegende Felder zur Identifikation und Beschreibung Ihrer Artikel – die Basis für eine erfolgreiche Veröffentlichung im Katalog.

SUPPLIER_AID (Pflichtfeld)

Ihre interne, eindeutige Artikelnummer.

.

Katalogfeld

Beispielwert

Erläuterung

SUPPLIER_AID

987654321

Artikelnummer

Technische Spezifikationen:

  • Maximale Länge: 29 Zeichen

  • Keine Umlaute (ä, ö, ü)

  • Keine Sonderzeichen

  • Jede Artikelnummer darf nur einmal vorkommen. Varianten benötigen jeweils eine eigene Artikelnummer.

EAN-/GTIN (Pflichtfeld)

International standardisierter Produktidentifikator (vergeben z. B. von GS1). Jeder Artikel benötigt eine gültige EAN oder GTIN – sie darf im Katalog nur einmal vorkommen.

Technische Spezifikationen

  • numerische Eingabe

  • EAN-13: 13 Stellen

  • EAN-8: 8 Stellen (nur für Produkte, die ursprünglich unter EAN-8 registriert wurden)

  • GTIN-14: 14 Stellen

  • Ausschließlich geprüfte EAN- oder GTIN-Werte

  • Keine Platzhalterwerte (z. B. 000000000000, N/A oder k. A.) und keine Herstellernummern

  • Eine 13-stellige EAN wird durch Voranstellen einer führenden Null zur 14-stelligen GTIN. Unite unterstützt beide Formate.

  • Jede EAN/GTIN darf nur einmal vorkommen. Varianten benötigen jeweils eine eigene EAN/GTIN.

Ausnahmen gelten nur, wenn:

  • keine EAN oder GTIN vorliegt und Sie stattdessen MANUFACTURER_AID und MANUFACTURER_NAME angeben.

  • für bestimmte Artikelgruppen keine EAN/GTIN existiert (z. B. Blumen).

Beispiele

Format

Wert

Gültige EAN

3141725002386

Entsprechende GTIN

03141725002386

DESCRIPTION_SHORT (Pflichtfeld)

Artikelname, der in Suchergebnissen und auf der Produktdetailseite angezeigt wird.

Technische Spezifikationen

  • Mindestlänge: 10 Zeichen

  • Maximale Länge: 180 Zeichen

  • Keine HTML-Formatierungen

  • Keine Verpackungsangaben

  • Texte in der in der katalogspezifischen Sprache verfassen

Inhalt

  • Nennen Sie markante Unterscheidungsmerkmale wie Größe, Farbe, Breite oder Material.

  • Jeder Artikelname darf nur einmal vorkommen. Varianten benötigen jeweils einen eigenen Artikelnamen.

Beispiel: HP Kopierpapier Copy Paper, A4, 80g, Weiß

DESCRIPTION_LONG (Pflichtfeld)

Detaillierte Artikelbeschreibung mit Eigenschaften wie Farbe, Maßen, Ausführung und Lieferumfang. Wird unterhalb der Produktabbildung auf der Artikeldetailseite angezeigt.

Technische Spezifikationen

  • Maximale Länge: 64.000 Zeichen

  • Bei HTML-Formatierungen CDATA- oder HTML-Escape-Sequenzen verwenden

Erlaubte HTML-Formatierungen

  • Absätze

  • Schriftformatierungen: fett, kursiv, unterstrichen

  • Zeilenumbrüche

  • Listen

Erlaubte HTML-Tags

Funktion

<p> … </p>

Absatz

<b> … </b>

Inhalt wird fett gedruckt dargestellt

<i> … </i>

Inhalt wird kursiv dargestellt

<u> … </u>

Inhalt wird unterstrichen dargestellt

<br>

Zeilenumbruch

<ul>
<li> … </li>
<li> … </li>
</ul>

Aufzählungen

Nicht zulässig

  • Tabellen

  • Externe Links

  • Body-Tags

  • Schriftfarben und -größen

  • Bilder

Inhalt

  • Beschreibung in der in der katalogspezifischen Sprache verfassen

  • Keine Verpackungsangaben

  • Keine Retouren-Informationen

  • Angabe gängiger Normen empfohlen (z. B. DIN, ISO)

  • Artikel vollständig und verständlich beschreiben

  • Korrekte Rechtschreibung und Interpunktion beachten

  • Anforderungen der EmpCo an Umwelt- und Nachhaltigkeitsaussagen beachten; weitere Informationen finden Sie auf der Support-Seite zur EU-EmpCo-Richtlinie.

MANUFACTURER_AID (Pflichtfeld)

Eindeutige Artikelnummer des Herstellers – kann von Ihrer eigenen Artikelnummer (SUPPLIER_AID) abweichen.

Technische Spezifikationen

  • Immer zusammen mit MANUFACTURER_NAME angeben

  • Pro Hersteller darf jede Herstellernummer im Katalog nur einmal vorkommen

  • Bei Produktvarianten sind unterschiedliche Herstellernummern erforderlich

MANUFACTURER_NAME (Pflichtfeld)

Name des Herstellers.

Technische Spezifikationen

  • Herstellernamen und Herstellernummer immer zusammen angeben

  • Keine Firmierung angeben (z. B. GmbH, AG, GmbH & Co. KG)

Preise und Steuern

Legen Sie Preise, Währung und Steuersätze für Ihre Artikel fest. Welche Preisart Sie verwenden, hängt vom Katalogtyp ab.

ARTICLE_PRICE price_type (Pflichtfeld)

Geben Sie die Preisart an:

  • Unite Spotmarket-Katalog (netto EK-Preise): net_list

  • BusinessShop: net_list

  • Exklusivkatalog: net_customer

Technische Spezifikationen

  • PRICE_TYPE1 und PRICE_AMOUNT1 immer zusammen angeben.

  • In der Regel werden nur PRICE_TYPE1 und PRICE_AMOUNT1 befüllt.

  • PRICE_TYPE2 und PRICE_AMOUNT2 nur befüllen, wenn Sie einen zusätzlichen Preis (z. B. Auktionspreis) übermitteln möchten.

PRICE_AMOUNT (Pflichtfeld)

Artikelpreis ohne Umsatzsteuer.

Technische Spezifikationen

  • Dezimaltrennzeichen: Komma (,)

  • Maximale Nachkommastellen: 2

  • Keine Währung, keine Tausendertrennzeichen

Staffelpreise

  • Staffelpreise werden wie Einzelpreise im Feld PRICE_AMOUNT hinterlegt.

  • Der zugehörige Preistyp wird im Feld PRICE_TYPE angegeben.

  • Die Zahl vor dem Doppelpunkt gibt die Staffelgrenze an, ab der der Preis gilt.

  • Die einzelnen Staffeln werden durch ein Leerzeichen voneinander getrennt.

PRICE_QUANTITY (optionales Feld)

Gibt an, auf wie viele Bestelleinheiten sich der Preis bezieht. Wichtig für die korrekte Preisberechnung pro Bestelleinheit.

Technische Spezifikationen

  • Nur positive, ganze Zahlen zulässig

  • Keine 0, negativen Werte oder Tausendertrennzeichen

Beispiel

Katalogfeld

Beispielwert

Erläuterung

UNIT

C62

Stück

PRICE_AMOUNT

25.00

Preis pro 100 Stück

PRICE_QUANTITY

100

Menge, auf die sich der Preis bezieht

Der angezeigte Preis wird automatisch auf die jeweilige Bestelleinheit umgerechnet.

PRICE_CURRENCY (Pflichtfeld)

Währung der Artikelpreise. Für Kataloge in Deutschland ausschließlich EUR (ISO-Code).

TAX (Pflichtfeld)

Umsatzsteuersatz des Artikels.

Technische Spezifikationen

  • Als Dezimalzahl angeben (z. B. 19 % = 0,19)

  • Dezimaltrennzeichen: Komma (,)

  • Der Steuersatz muss dem im Lieferland geltenden Umsatzsteuersatz entsprechen.

Lieferdetails

Legen Sie fest, in welchen Einheiten Ihre Artikel bestellbar sind und wie lange die Lieferung dauert. Korrekte Angaben vermeiden Mengenfehler und Retouren.

DELIVERY_TIME (Pflichtfeld)

Lieferzeit in Werktagen ab Bestellung bis zur Lieferung beim Kunden. Geben Sie eine realistische, individuelle Lieferzeit pro Artikel an.

Technische Spezifikationen:

  • Lieferzeit in Tagen angeben

  • Nur ganze, positive Zahlen

ORDER_UNIT (Pflichtfeld)

Einheit, in der der Artikel bestellbar ist. Der Katalogpreis bezieht sich immer auf diese Einheit.

Technische Spezifikationen

  • Nur gültige UN/CEFACT-Einheiten verwenden (siehe gültige Bestelleinheiten)

  • ORDER_UNIT und CONTENT_UNIT müssen sich unterscheiden

  • Bestelleinheiten nicht im Artikelnamen oder in der Produktbeschreibung angeben

CONTENT_UNIT (Pflichtfeld)

Inhaltseinheit innerhalb der Bestelleinheit (z. B. Stück in einem Karton).

Technische Spezifikationen

  • Nur gültige UN/CEFACT‑Einheiten verwenden

  • CONTENT_UNIT immer zusammen mit NO_CU_PER_OU angeben

  • NO_CU_PER_OU gibt an, wie viele Inhaltseinheiten in der Bestelleinheit enthalten sind

Ausnahme

Für folgende Bestelleinheiten ist keine separate CONTENT_UNIT und keine NO_CU_PER_OU (Verpackungsmenge) nötig:

  • C62 (Stück)

  • SET (Satz)

  • ST (Blatt)

  • PR (Paar)

NO_CU_PER_OU (Pflichtfeld)

Verpackungsmenge: Anzahl der Inhaltseinheiten (CONTENT_UNIT) pro Bestelleinheit (ORDER_UNIT).

Technische Spezifikationen

  • Die Verpackungsmenge im Feld NO_CU_PER_OU ist anzugeben, wenn eine Inhaltseinheit im Feld CONTENT_UNIT hinterlegt ist – und umgekehrt.

  • Nur ganze, positive Zahlen

  • NO_CU_PER_OU (Verpackungsmenge) und QUANTITY_MIN (Mindestbestellmenge) sind unabhängig voneinander und können unterschiedliche Werte haben.

Ausnahmen

Für folgende Bestelleinheiten ist keine separate CONTENT_UNIT und keine NO_CU_PER_OU (Verpackungsmenge) nötig:

  • C62 (Stück)

  • SET (Satz)

  • ST (Blatt)

  • PR (Paar)

QUANTITY_MIN (optionales Feld)

Mindestbestellmenge in Bestelleinheiten (ORDER_UNIT).

Technische Spezifikationen

  • Nur ganze, positive Zahlen

  • Ohne Angabe setzt das System automatisch den Wert 1.

  • QUANTITY_MIN nicht kleiner als QUANTITY_INTERVAL

  • Unabhängig von der NO_CU_PER_OU (Verpackungsmenge)

  • Mindestbestellmenge auf erste Preisstaffel abstimmen – beginnt diese bei 5 Stück, muss QUANTITY_MIN ebenfalls 5 sein 

QUANTITY_INTERVAL (optionales Feld)

Mengenstaffel: Gibt an, in welchen Schritten der Artikel bestellt werden kann (z. B. 5, 10, 25).

Technische Spezifikationen

  • Nur ganze, positive Zahlen

  • Ohne Angabe setzt das System automatisch den Wert 1.

  • QUANTITY_INTERVAL darf nicht größer als QUANTITY_MIN sein.

  • In der Regel entspricht QUANTITY_INTERVAL der QUANTITY_MIN.

Katalogangaben

Mit dem Feld Keyword hinterlegen Sie Suchbegriffe, über die Kunden den Artikel auf Unite finden. Über die Kategorisierung ordnen Sie Ihre Artikel in Kategorien ein – das erleichtert Kunden die Navigation und verbessert die Auffindbarkeit Ihrer Artikel.

KEYWORD (Pflichtfeld)

Suchbegriffe, über die Kunden den Artikel im Katalog finden.

Technische Spezifikationen

  • Maximal 10 Suchbegriffe pro Artikel

  • Mehrere Suchbegriffe durch Komma trennen

  • Hauptbegriff des Artikels als Keyword angeben (z. B. „Kopierpapier") und zusätzlich in DESCRIPTION_SHORT verwenden

Nicht zulässig

  • Kontextfremde Stichwörter

  • Herstellernamen und -nummern

  • EAN-Nummern

  • Personennamen

  • Füll- und Bindewörter (z. B. „mit", „für", „und")

  • Verben

  • Produkteigenschaften und Adjektive (z. B. „weiß", „rund") – diese gehören in ARTICLE_FEATURES

CATALOG_GROUP_ID (Pflichtfeld)

Kategorie, der der Artikel zugeordnet wird. Die GROUP_ID stammt aus der Vorlage categories_KatalogID_deu.xlsx.

Technische Spezifikationen

  • Ein Artikel kann mehreren Kategorien zugeordnet werden.

    • Trennzeichen: Pipe-Zeichen (|) (z. B. 101|102|302).

REFERENCE_FEATURE_SYSTEM_NAME (Pflichtfeld)

Klassifikationssystem, das Sie für Ihren Katalog verwenden (z. B. ECLASS 5.1.4).

Technische Spezifikationen

  • Immer mit Systemname, Version und Klassifikationsnummer angeben

  • Pro Artikel ist eine eindeutige 8-stellige ECLASS-Nummer erforderlich (Version 5.1.4)

  • Ein Artikel kann mehreren Klassifikationssystemen zugeordnet werden (z. B. ETIM, ECLASS 5.1.4, ECLASS 6.1, Zolltarifnummer).

  • Unite unterstützt ECLASS Version 6.0 bis 15.0, ETIM Version 2.0 bis 7.0, UNSPSC-7 und UNSPSC-13.

  • Für Exklusivkataloge: erforderliches Klassifikationssystem beim Kunden erfragen

REFERENCE_FEATURE_GROUP_ID (Pflichtfeld)

8-stelliger Klassifikationsschlüssel aus dem unter REFERENCE_FEATURE_SYSTEM_NAME angegebenen System (z. B. ECLASS-Klassennummer).

Technische Spezifikationen

  • Pro Artikel ist eine gültige Klassen-ID erforderlich (Version 5.1.4)

  • Mehrere Klassen möglich – jede Klassen-ID in einem eigenen Datensatz anlegen

  • Bei ECLASS: 8 Ziffern, keine Sonderzeichen

Mediendaten

Hinterlegen Sie Produktbilder, Produktdatenblätter und Sicherheitsdatenblätter. Mindestens ein Produktbild pro Artikel ist Pflicht. Für bestimmte Artikelgruppen sind Datenblätter gesetzlich erforderlich.

Übersicht: Medienfelder (MIME)

Hinterlegen Sie für jeden Artikel mindestens ein Produktbild. Für bestimmte Artikel – z. B. Gefahrstoffe oder Artikel mit Energieverbrauchskennzeichnung – sind Produktdatenblätter und Sicherheitsdatenblätter Pflicht.

Laden Sie alle Dateien mit exakt demselben Dateinamen wie im Katalog auf den Unite SFTP-Server in das Verzeichnis media hoch.

Technische Spezifikationen

  • Je Datei ein MIME-Element; mehrere MIME-Elemente pro Artikel sind möglich

  • Medienpfade in folgenden Spalten angeben:

    • MIME_SOURCE1–6: Produktbilder (JPG, PNG oder GIF)

    • MIME_SOURCE7: Produktdatenblatt (PDF)

    • MIME_SOURCE8: Sicherheitsdatenblatt (PDF)

Alle Anforderungen zu Produktbildern, Produktdatenblättern und Sicherheitsdatenblättern finden Sie in den jeweiligen Support-Artikeln:

MIME_SOURCE (Pflichtfeld)

Dateiname der referenzierten Bild- oder Dokumentdatei.

Technische Spezifikationen

  • Nur Kleinbuchstaben, Ziffern, Bindestriche (-) und Unterstriche (_)

  • Keine Leerzeichen, Sonderzeichen oder Umlaute

MIME_PURPOSE (Pflichtfeld)

Geben Sie den Verwendungszweck der Mediendatei auf Unite an (z. B. Produktbild oder Datenblatt).

Mögliche Angaben

Katalogfeld

Beispielwert

Erläuterung

MIME_PURPOSE

normal

Produktabbildung

MIME_PURPOSE

data_sheet

Datenblatt

MIME_PURPOSE

safety_data_sheet

Sicherheitsdatenblatt

 

MIME_DESCR (optionales Feld)

Kurze Beschreibung oder Alternativtext der Mediendatei (z. B. „Seitenansicht Drucker XYZ“, „Sicherheitsdatenblatt“)

Zusätzliche Artikeldetails

Ergänzen Sie Ihren Katalog um weitere Angaben wie Anzeigereihenfolge, Artikelmerkmale, Verweise auf ähnliche oder ergänzende Artikel sowie kundenspezifische Kennzeichen. Übermitteln Sie außerdem gesetzlich erforderliche Pflichtangaben.

ARTICLE_ORDER (optionales Feld)

Steuert die Anzeigereihenfolge der Artikel. Artikel mit kleineren Zahlen werden zuerst angezeigt. Ohne Angabe sortiert Unite automatisch alphabetisch.

Technische Spezifikationen

  • Nur positive, ganze Zahlen

ARTICLE_REFERENCE type=similar (optionales Feld)

Artikel, die dem Quellartikel ähnlich sind und als Alternative genutzt werden können.

Technische Spezifikationen

  • Nur Artikelnummern (SUPPLIER_AID) angeben – keine Beschreibungen oder URLs

  • Referenzen nur auf Artikel innerhalb desselben Katalogs möglich

  • Mehrere Artikelnummern mit Pipe-Zeichen (|) trennen

Beispiele

  • Einzeln: 30025

  • Mehrere: 23-555|1083999|A10333e4

ARTICLE_REFERENCE type=accessories (optionales Feld)

Artikel, die als Zubehör zum Quellartikel dienen.

Technische Spezifikationen

  • Nur Artikelnummern (SUPPLIER_AID) angeben – keine Beschreibungen oder URLs

  • Referenzen nur auf Artikel innerhalb desselben Katalogs möglich

  • Mehrere Artikelnummern mit Pipe-Zeichen (|) trennen

Beispiele

  • Einzeln: 34-53468

  • Mehrere: 34-53468|1083999

ARTICLE_REFERENCE type=others (optionales Feld)

Artikel, die in einer sonstigen Beziehung zum Quellartikel stehen – wenn keine andere Verweisart passt.

Technische Spezifikationen

  • Nur Artikelnummern (SUPPLIER_AID) angeben – keine Beschreibungen oder URLs

  • Referenzen nur auf Artikel innerhalb desselben Katalogs möglich

  • Mehrere Artikelnummern mit Pipe-Zeichen (|) trennen

Beispiele

  • Einzeln: 220bz-r2

  • Mehrere: 220bz-r2|113bt-r6

BUYER_AID type, BUYER_AID (optionales Feld)

Kundenspezifische Artikelnummern und Kennzeichen des einkaufenden Unternehmens. Wird ausschließlich in Exklusivkatalogen verarbeitet – für Unite Spotmarket und BusinessShop Kataloge nicht erforderlich.

Technische Spezifikationen

  • Pro Artikel sind bis zu 10 Kennzeichen zulässig

  • Mehrere BUYER_AID-Einträge durch Pipe-Zeichen (|) trennen

    • z. B. KERNSORTIMENT=k|STANDARDSORTIMENT=s

  • Jeden Eintrag mit einem Typ kennzeichnen (z. B. buyer_specific, Warengruppe, KERNSORTIMENT)

  • Welche Kennzeichen hinterlegt werden sollen, stimmen Sie mit Ihrem Kunden ab

FNAME (Pflichtfeld)

Name eines Artikelmerkmals (z. B. Farbe, Material, Gewicht). FNAME und FVALUE werden auf der Produktdetailseite unter „Produktdaten“ angezeigt und helfen Kunden, Artikel schnell zu vergleichen.

Technische Spezifikationen

  • Ein Merkmal besteht immer aus FNAME (Merkmalname), FVALUE (Merkmalwert), optional ergänzt durch FUNIT (Merkmalseinheit)

  • Bezeichnungen sind frei wählbar

  • Die Felder wiederholen sich nummeriert: FNAME1/FVALUE1/FUNIT1 bis FNAME10/FVALUE10/FUNIT10

Pflichtangaben über FNAME und FVALUE

FNAME und FVALUE sind Pflichtfelder. Die Tabelle zeigt, welche Angaben für alle Artikel und welche Angaben für bestimmte Artikelgruppen erforderlich sind. Weitere Informationen erhalten Sie in den jeweiligen Artikeln.

Pflichtangabe

Gilt für

Artikelgewicht

Alle Artikel

Zolltarifnummer

Alle Artikel

GHS-Kennzeichnung

Gefahrstoffe und Gemische

Energieverbrauchskennzeichnung

Elektrische Geräte und Haushaltsgeräte

EUDR-Anforderungen

Artikel aus Holz, Leder, Kautschuk, Soja, Palmöl, Kaffee und Kakao

FVALUE (Pflichtfeld)

Wert eines Artikelmerkmals (z. B. 100, weiß, GHS02).

Technische Spezifikationen

  • FVALUE immer zusammen mit FNAME angeben

  • Mehrere Ausprägungen mit Pipe-Zeichen (|) trennen

FUNIT (optionales Feld)

Einheit eines Artikelmerkmals (z. B. kg, ml, cm). Ergänzt das Merkmalspaar FNAME und FVALUE.

Technische Spezifikationen

  • Nur angeben, wenn das Merkmal eine Einheit erfordert

War dieser Artikel hilfreich?