> ## Documentation Index
> Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import (CSV / Excel)

> Verpackungseinheiten, Komponenten und Stücklisten per CSV oder Excel importieren

## Übersicht

Statt Einheiten und Komponenten einzeln anzulegen, importieren Sie sie in großen Mengen aus CSV- oder Excel-Dateien. Der Import ist auf Umfang ausgelegt und bietet für Einheiten und Komponenten eine Vorschau bei Überschreibungen sowie ein Ergebnis mit angelegten, aktualisierten und übersprungenen Zeilen.

Akzeptierte Formate: **CSV** und **Excel** (`.csv`, `.xlsx`, `.xls`).

## Wo die Import-Buttons sind

Die Import-Schaltflächen liegen in der Toolbar der jeweiligen Liste. Jede Schaltfläche ist ein geteilter Button: **Importieren** plus ein Menü zum Herunterladen der passenden Vorlage.

| Import                         | Ort                                                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------- |
| **Verpackungseinheiten**       | Toolbar der Liste **Verpackungseinheiten** (`/packaging`)                                               |
| **Stückliste (Verknüpfungen)** | Toolbar der Liste **Verpackungseinheiten** — verknüpft bestehende Einheiten mit bestehenden Komponenten |
| **Komponenten**                | Toolbar der Liste **Komponenten** (`/packaging/components`)                                             |

<Frame caption="Die Import-Buttons in der Toolbar der Verpackungseinheiten-Liste">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/polygonone/images/ppwr/stammdaten/import-buttons.png" />
</Frame>

## Vorschau und Validierung

<Steps>
  <Step title="Datei wählen">
    Klicken Sie **Importieren** und wählen Sie Ihre CSV-/Excel-Datei. Polygon One liest die Datei und validiert jede Zeile gegen das Schema.
  </Step>

  <Step title="Gültige und ungültige Zeilen">
    Gültige Zeilen werden für den Import vorgemerkt; ungültige Zeilen (z. B. unbekannte Enum-Werte, ungültige GTIN, fehlende Pflichtfelder) werden mit ihrem Grund gemeldet. Fehlt eine als Pflicht gemappte Spalte ganz, wird das als Spaltenfehler ausgewiesen — nicht als stiller Zeilenfehler.
  </Step>

  <Step title="Überschreibungen bestätigen (nur Einheiten & Komponenten)">
    Der Einheiten- und der Komponenten-Import sind ein **Upsert** (Abgleich über die interne Referenz bzw. den Code). Würde der Import einen vorhandenen Wert **überschreiben**, öffnet sich zuerst die Vorschau, in der Sie Zeile für Zeile entscheiden. Reine Ergänzungen (leere Felder befüllen) werden automatisch übernommen.
  </Step>

  <Step title="Ergebnis">
    Am Ende zeigt das Ergebnis, wie viele Zeilen **angelegt**, **aktualisiert**, **übersprungen** wurden und welche **Fehler** aufgetreten sind.
  </Step>
</Steps>

<Frame caption="Die Import-Vorschau mit gültigen, zu bestätigenden und übersprungenen Zeilen">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/polygonone/images/ppwr/stammdaten/import-vorschau.png" />
</Frame>

<Info>
  Der **Stücklisten-Import** (Verknüpfungen) ist reines Anlegen und idempotent: Bereits bestehende Verknüpfungen werden **übersprungen**, nicht dupliziert. Deshalb hat er keine Überschreibungs-Vorschau — nur ein Ergebnis mit verknüpft / bereits verknüpft (übersprungen) / Fehler (unbekannte Referenzen).
</Info>

## Welche Spalten es gibt

Die Vorlagen führen die kanonischen Spaltenüberschriften. Über **Einstellungen → Importe** können Sie für Einheiten und Komponenten eine eigene Spaltenzuordnung speichern; die Vorlage der Stückliste nutzt feste Überschriften.

### Verpackungseinheiten

Kernspalten: **Name**, **Reference** (interne Referenz, Abgleichschlüssel), **Packaging Type**, **Role**, **Supplier**, **Format**, **Recyclability Grade**, **GTIN**, **Width (mm)**, **Height (mm)**, **Depth (mm)**, **Market Member States**, **Notes**, **Own Brand**, **Modifies Conformity**. Dazu zwei Verknüpfungsspalten: **Article Numbers** (verknüpft mit bestehenden Artikeln über deren interne Artikelnummer) und **Component Codes** (verknüpft mit Komponenten).

### Komponenten

Kernspalten: **Code**, **Name**, **Supplier**, **Materials**, **Polymer**, **Mass (g)**, **Recycled Content (%)**, **Recycled Source**, **Recycled Method**, **Contact-sensitive**, **Food-contact**, **Heavy Metals (mg/kg)**, **Heavy Metals Basis**, **Heavy Metals Method**, **PFAS Compliant**, **PFAS Basis**, **PFAS Method**, **PFAS Sum (ppb)**, **Total Fluorine (mg/kg)**, **Notes**.

### Stückliste (Verknüpfungen)

Nur drei feste Spalten: **Unit Reference**, **Component Code**, **Quantity** (leer → 1).

<Info>
  Hinweise zur Auflösung: **Supplier** wird serverseitig über den Namen aufgelöst (kein Treffer → kein Lieferant). Für Einheiten importiert eine leere Spalte **Market Member States** als leere Liste — der Import-Bogen ist maßgeblich und wird **nicht** aus der PPWR-Standardeinstellung nachgefüllt. Beim Stücklisten-Import werden unbekannte Einheiten-/Komponenten-Codes als Fehlerzeilen gemeldet und nicht automatisch angelegt.
</Info>

<Card title="Zurück zum Datenmodell" icon="diagram-project" href="/de/ppwr/stammdaten/uebersicht">
  Wie Artikel, Einheiten und Komponenten zusammenhängen.
</Card>