Katalog

Next Admin | Katalog-Import (CSV)

Übersicht

Im Shopgate Backend können Sie über das Menü Katalog > Daten hochladen auf einfache Art und Weise Informationen zu Kategorien, Produkten und Beständen manuell importieren. Dieser Prozess kann auch via FTP-Upload vereinfacht und automatisiert werden. Alternativ bieten wir für eine komplette Integration auch eine API an, um in Echtzeit Daten auszutauschen.

In diesem Support Dokument behandeln wir insbesondere unser CSV-Format, den manuellen Upload sowie die Import-Logs. 

 

Bildschirmfoto_2020-10-29_um_15.49.12.png

Dateien herunterladen

Sie können über das Shopgate Backend sowohl Beispiel-Dateien als auch den bereits im System verfügbaren Katalog herunterladen. Klicken Sie auf Download.CSV um sich unsere Beispiel-Dateien herunter zu laden. 
Wenn Sie unter den Boxen für Kategorie oder Produkte auf den Link Aktuelle CSV herunterladen klicken, wird ein neuer Export ausgelöst. Der Export kann je nach Größe des Katalogs einige Minuten dauern. Nach Abschluss des Prozesses erhalten Sie eine E-Mail mit einem Link zum Herunterladen der Datei. Diese Datei entspricht dem für den Upload benötigten Format.

Formatieren der CSV-Dateien

Um die CSV-Dateien für den Upload vorzubereiten, müssen Sie das von uns vorgegebene Format einhalten:

  • Encoding: UTF-8
  • Trenner für Spalten: Komma
  • Bei Spaltennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden

Kategorie CSV

Die Kategorie CSV legt den Rahmen für das Hochladen von Produkten und Inventar fest. Diese Kategorien sind erforderlich, um eine Produkt-Taxonomie zu erstellen, damit Kunden den Katalog durchsuchen können. Die meisten E-Commerce- und POS-Systeme verfügen über eine vorhandene Taxonomie, die Sie exportieren können.
Eine Beispiel-Datei finden Sie unter Download.CSV

Spaltenname

Erforderlich

Beschreibung

Typ

Max. Länge

Default Wert

ImportType

Erforderlich, hat Fallback

Legt den Typ des Import für diese Zeile fest. Die Optionen sind "Hinzufügen / Ändern" ("Add / Change" AC) oder "Löschen ("Delete" D). "AC" legt einen nicht vorhandenen Eintrag neu an oder aktualisiert bereits vorhandene Daten. "D" löscht existierende Daten.

Text

3

Wird kein Wert angegeben, wird der Typ "AC" genutzt.

CategoryCode

Erforderlich

Primärer Schlüssel / eindeutiger Identifier für eine Kategorie.

Text

- -

Name

Erforderlich

Name der Kategorie

Text

- -

SequenceID

Erforderlich, hat Fallback

Sortierung der Kategorien. Absteigend (ID = 1 wird ganz oben angezeigt).

Zahl

255

Wird kein Wert geliefert, werden die Kategorien anhand der Reihenfolge in der Datei importiert.

ParentCategoryCode

Erforderlich, hat Fallback

Code der übergeordneten Kategorie

Text

 

Wird kein Wert geliefert, wird diese Kategorie in der obersten Ebene angezeigt.

Image

Nicht erforderlich

URL zu einem Kategorie-Bild

URL

255

Wird kein Bild geliefert, wird das eingestellte Default-Bild angezeigt. 

CategoryDescription

Nicht erforderlich

Kurzbeschreibung der Kategorie

Text

255

Wird keine Beschreibung geliefert, bleibt dieses Feld im Frontend leer.

 

 

Produkt CSV

Die Produkt-CSV enthält wichtige Informationen zu jedem Produkt. Jede Zeile repräsentiert einen Produktdatensatz. Jede Produktvariante benötigt einen eigenen Datensatzeintrag. Konfigurierbare Produkte haben bis zu drei Optionen (z. B. Größe, Material, Farbe).
Eine Beispiel-Datei finden Sie unter Download.CSV

Spaltenname

Erforderlich

Beschreibung

Typ

Max. Länge

Default Wert

ImportType

Required, but has fallback

Indicates if record (row) is an "Add / Change", or "Delete". A value of "AC" indicates that the record should be added if it's not already present or updated if it is already present. A value of "D" indicates that the record should be deleted from the system.

Text

3

If no value is

present the record

will be defaulted to "AC".

ProductCode

Required

Primary key or record identifier for a sales item

Text

   

Sequence

Optional

Product rank sort order. 

Number

 

A number 1 to n.

localecode

Required, but has fallback

Locale code for the catalog / item record

Text

5

By default this will be set to the default locale code on the merchant account.

currencycode

Required, but has fallback

Currency code for the catalog / item record

Text

3

By default this will be set to the default currency on the merchant account.

Name

Required

User friendly product name that is displayed / used in the category list, product detail, cart, order, order confirmation, order summary, and in some notificiations.

Text

255

Item name

shortdescription

Optional

User friendly product short description that is normally displayed on the category list page and on the product detail page

Text

500

Optional quick decription of a product

longdescription

Required, but has fallback

User friendly product long description that is normally displayed on the product detail page

Text

65535

Optional long "detailed" decription of a product

ProductImages

Required, but has fallback

Optional list of product images

URL

255

Optional, but recommended, link to a product image URL that will be used in category lists and on the PDP. A list of multiple URLs can be provided. URLs delimited by a tilde ~

sku

Required, but has fallback

Item Stock Keeping Unit Code

Text

255

If no value is present the record will be defaulted to the ProductCode value

upc

Required, but has fallback

Optional UPC or Barcode number for search / discovery

Text

255

Optional field that enables additional search options for this product that is generally set to BARCODE or UPC value of the product

mfgpartnum

Required, but has fallback

Optional Manufacturing part number for search / discovery

Text

255

Optional field that enables additional search options for this product

itemprice

Required

Item price per quantiy ordered

Decimal

8,2

Item Price

Status

Required

Item status

Text

{Active,

Inactive}

If no value is present the record will be defaulted to "Active"

saleprice

Required, but has fallback

Item price value for items on sale, will be displayed a strike through price normally

Decimal

8,2

 

ItemUnitOfMeasure

Required, but has fallback

Default unit of measure for a product. For example "each", "kg", "lb", "cm" etc.

Text

10

If no value is present the record will be defaulted to "Each"

UnitValue

Required, but has fallback

Amount that the product contains of the unit specified above

Decimal

8,2

If no value is present the record will be defaulted to "1"

UnitPriceRefUom

Optional

Unit used for displaying the unit price information, see Displaying Unit Price Information

Text

10

 

UnitPriceRefValue

Optional

Amount for displaying the Unit Price Information

Decimal

8,2

 

HasCatchWeight

Required, but has fallback

 

Determines if product is treated as Catch Weight product

 

{True, False}

If no value is present the record will be defaulted to "False"

ModelType

Required

Sets the "model" or type of a product record.

Text

{Standard,

Configurable,

Variant}

 

InventoryManaged

Required, but has fallback

Inventory management setting for this product. Denotes if inventory is tracked / managed for a product record

boolean

{True, False}

If no value is present the record will be defaulted to "False"

InventoryTreatment

Optional

Allows you to set    the how the product should be displayed when out of stock.

Text

{hideInStorefront, 

showOutOfStock}

 

ParentProductCode

Optional, no fallback

Parent Product Code for variant product records

Text

255

If the record is a type of Variant, then this field is required and must reference the "Parent Product Code" that will enable the configuration of this product.

TaxClass

Required, but has fallback

Product specific tax class

Text

255

If no value is provided, the configurated default product tax class will be used. Tax classes are set up in the Admin under Settings > Taxes

FulfillmentMethods

Required

A list of supported / enabled fulfillment methods for this product.

Text

{directShip,

BOPIS,

ROPIS}

If no value is present the record will be defaulted to "ROPIS"

Properties

Required, but has fallback

A list of key value pairs for product properties that can be used to provide additional information on product specs or properies to help shoppers find additional product details. These are displayed on the product detail page.

Text Key / Value

Key(255):

Value(255)

Name / Value pairs and a single product have currently have any number of unique properties. They are formatted as follows in the properties field:

DisplayedAttributeName:DisplayedAttributeValue

Ie: Department:Grocery

To send more than one property per product each name/value pair should be seperated with a value sub-delimiter which is set to "~".

Ie: "Department:Grocery~Size:24 16oz Cans""

Categories

Required

List of category names that the product should be listed in

Text

255

Name of the categories (must match existing categories) that the product should be listed in. Must be tilde delimited

CategoryCode

Required

List of category codes that the product should be listed in. Multiple entries delimited with ~ 

Text

255

Code of the categories (must match existing categories) that the product should be listed in. If both this and Categories field are present on the record this one will be used and the Categories field will be ignored.

ProductOption1

Optional, no fallback

Name of First Product Option

Text

255

First configurable option for a "configurable" product or the first set value for a product "variant". The product option fields (1-3) and their value fields, along with the ParentProductCode field are used for "configurable products" or "Parent/Child Products"

Ie: T-Shirt that comes in Small, Medium, or Large."

ProductOption1Value

Optional, no fallback

ParentProduct:

List of possible values of variant configurations

Variant:

Single value of variant record

Text

255

First configurable list of options for a "configurable" product or the first set value for a product "variant"

ProductOption2

Optional, no fallback

Name of Second Product Option

Text

255

Second configurable option for a "configurable" product or the first set value for a product "variant"

ProductOption2Value

Optional, no fallback

ParentProduct:

List of possible values of variant configurations

Variant:

Single value of variant record

Text

255

Second configurable list of options for a "configurable" product or the first set value for a product "variant"

ProductOption3

Optional, no fallback

Name of Third Product Option

Text

255

Third configurable option for a "configurable" product or the first set value for a product "variant"

ProductOption3Value

Optional, no fallback

ParentProduct:

List of possible values of variant configurations

Variant:

Single value of variant record

Text

255

Third configurable list of options for a "configurable" product or the first set value for a product "variant"

 

 

Inventar CSV

Eine Beispiel-Datei finden Sie unter Download.CSV

Spaltenname

Erforderlich

Beschreibung

Typ

Max. Länge

Default Wert

ImportType

Required, but has fallback

Indicates if record (row) is an "Add / Change", or "Delete". A value of "AC" indicates that the record should be added if it's not already present or updated if it is already present. A value of "D" indicates that the record should be deleted from the system.

Text

3

If no value is present the record will be defaulted to "AC".

productCode

Required

Primary key or record identifier for a sales item.

In many cases product code and SKU are the same for merchants, however they can be different. The product code acts as the primary key in the Shopgate system for a sales item.

example: "MTH-001"

Text

 

 

sku

Required

Item Stock Keeping Unit Code

Text

255

If no value is present the record will be defaulted to the ProductCode value

locationCode

Required

Indicates the location code for this inventory record. example: "en-us"

Text

255

Must match existing setup location code

onHand

Required

The numberic on hand count of this item at this location

Number

 

Must be a whole number

safetyStock

Required, but has fallback

The quantity of inventory that you would like to no be availble for digital orders, thus reserving them for Walk-ins

Number

 

Must be a whole number

bin

Required, but has fallback

Aisle, Row, Shelve Location for where this item is locationed in the store. example: 45-12

Text

50

 

binLocation

Required, but has fallback

Shelve location for this item in this location. example: 123

Text

50

 

 

 

CSV Dateien hochladen

Sobald Sie Ihre CSV-Dateien korrekt formatiert haben, ziehen Sie diese einfach per Drag & Drop in das entsprechende Feld, um sie hochzuladen. Wenn Sie zum ersten Mal Inhalte hochladen, beginnen Sie mit Kategorien und fahren Sie dann mit den Produkten und zuletzt Beständen fort. Der Import wird sofort gestartet und kann bis zu 15 Minuten benötigen. Den aktuellen Status sehen Sie in den Import-Logs. Nach Abschluss des Imports sind Details zu Kategorie-, Produkt- und Inventar-Daten unter den entsprechenden Menü-Punkten im Backend verfügbar.

Import-Logs

Sie finden im Backend unter Einstellungen > Importe Informationen zu allen Importen.  Dies gilt sowohl für Imports via manuellem CSV-Upload als auch via FTP oder per API. Unter anderem sehen Sie zu jedem Import in der Übersicht den jeweiligen Status (z.B. "Gestartet", "Abgeschlossen" oder "Abgebrochen"), die Entitäten (z.B. "Kategorien" oder "Produkte") und eine Statistik. In der Detail-Ansicht eines einzelnen Imports sehen Sie zusätzliche Informationen wie eine Log-Datei mit exakten Fehlern etc.
War dieser Beitrag hilfreich?

Beiträge in diesem Abschnitt

Sie finden nicht, was Sie suchen?
Wir helfen Ihnen gerne — erstellen Sie ein Support-Ticket.
Kontaktieren Sie den Support