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

# Batch-Import

> Positionen mit dem Kopien-Generator erzeugen, Inkrement-Logik nutzen und in Lizard importieren.

Mit dem **Batch-Import** erzeugst du aus einer Vorlage viele Betriebsmittel auf einmal und überträgst sie gebündelt an Lizard. Auf dieser Seite lernst du den Kopien-Generator, die Inkrement-Logik und den Versandprozess kennen.

## Voraussetzungen

* Ein vorhandener Katalog (siehe [Katalog erstellen](/expressimport/katalog-erstellen))
* Gültige Anmeldung mit Lizard-Token
* Schreibrechte auf die gewählte Kategorie in Lizard

## Positionen generieren

<Steps>
  <Step title="Katalog öffnen">
    Wähle in der Übersicht den Katalog, für den du Positionen erstellen möchtest.
  </Step>

  <Step title="Basis-Item anlegen">
    Fülle die Attribute für die erste Position aus. Dieses Item dient als Vorlage für alle Kopien.
  </Step>

  <Step title="Anzahl der Kopien wählen">
    Gib im Feld **Anzahl Kopien** an, wie viele Positionen du erzeugen möchtest.
  </Step>

  <Step title="Kopien generieren">
    Klicke auf **Generieren**. ExpressImport legt die Kopien an und wendet die Inkrement-Logik auf markierte Felder an.

    <Check>
      Die generierten Positionen erscheinen in der Liste und können einzeln bearbeitet werden.
    </Check>
  </Step>
</Steps>

## Inkrement-Logik

ExpressImport erkennt den numerischen Suffix eines Wertes und zählt ihn automatisch hoch. Führende Nullen bleiben dabei erhalten.

| Ausgangswert | Kopien | Ergebnis                                   |
| ------------ | ------ | ------------------------------------------ |
| `ABC123`     | 3      | `ABC123`, `ABC124`, `ABC125`               |
| `RS-0050`    | 4      | `RS-0050`, `RS-0051`, `RS-0052`, `RS-0053` |
| `12345`      | 2      | `12345`, `12346`                           |

<Info>
  Die Inkrement-Logik gilt für die Betriebsmittelnummer und für alle Attribute, bei denen im Katalog das **Inkrement-Flag** gesetzt ist.
</Info>

<Tip>
  Nutze sprechende Präfixe wie `RS-0001` statt reiner Zahlen. Das erleichtert das Wiederfinden in Lizard und verhindert Kollisionen mit anderen Beständen.
</Tip>

## Positionen prüfen und bearbeiten

Vor dem Versand solltest du die generierten Positionen kontrollieren:

* **Einzeln bearbeiten** — klicke auf eine Karte, um Attribute anzupassen
* **Löschen** — entferne einzelne Positionen aus dem Batch
* **Duplizieren** — erzeuge eine weitere Kopie auf Basis einer bestehenden Position

<Warning>
  Bereits übertragene Positionen kannst du in ExpressImport nicht zurückholen. Prüfe den Batch sorgfältig, bevor du ihn sendest.
</Warning>

## Batch senden

<Steps>
  <Step title="Vorschau öffnen">
    Klicke auf **Batch senden**. ExpressImport zeigt eine Übersicht aller Positionen, die übertragen werden.
  </Step>

  <Step title="Versand starten">
    Bestätige mit **Jetzt senden**. Die Positionen werden einzeln an Lizard übertragen — mit einem internen Pacing von 250 ms pro Request, um die Lizard-API nicht zu überlasten (das Lizard-Rate-Limit liegt bei 500 Requests pro Minute).
  </Step>

  <Step title="Fortschritt beobachten">
    Ein Fortschrittsbalken zeigt den Status an. Fehlerhafte Positionen werden markiert und können korrigiert und erneut gesendet werden.

    <Check>
      Nach erfolgreichem Abschluss siehst du eine Zusammenfassung mit der Anzahl erstellter Betriebsmittel — getrennt nach Items, Dyntag-Verknüpfungen und Prüfergebnissen.
    </Check>
  </Step>
</Steps>

## Bis zu drei Requests pro Position

Wenn du im Katalog [Prüfergebnisse](/expressimport/pruefergebnisse) aktiviert hast oder Positionen mit [Dyntag](/expressimport/dyntag-verknuepfen) hinterlegst, sendet ExpressImport pro Item bis zu drei aufeinanderfolgende Requests:

| Reihenfolge | Request                | Voraussetzung                      |
| ----------- | ---------------------- | ---------------------------------- |
| 1           | Item anlegen           | immer                              |
| 2           | Dyntag verknüpfen      | Position hat eine Dyntag-ID        |
| 3           | Prüfergebnis hochladen | Katalog hat Prüfergebnis aktiviert |

Jeder Request hat einen eigenen Status und einen eigenen Zähler im Versand-Panel:

* **N Items** — erfolgreich erstellt
* **N Dyntag-Fehler** — Item erstellt, aber Verknüpfung fehlgeschlagen
* **N Prüf.-Fehler** — Item erstellt, aber Beleg-Upload fehlgeschlagen

<Info>
  Schlägt einer der Folge-Requests fehl, bleibt das bereits erstellte Item in Lizard bestehen. Du kannst Dyntag oder Prüfergebnis nachträglich in Lizard manuell ergänzen — oder den Fehler korrigieren und den Batch erneut senden. Bereits erfolgreiche Items werden nicht doppelt angelegt.
</Info>

## Fehlerbehandlung

<Accordion title="Einzelne Positionen schlagen fehl">
  Die fehlgeschlagenen Positionen bleiben im Katalog und sind rot markiert. Öffne die Position, korrigiere den Fehler (z. B. fehlendes Pflichtfeld) und sende den Batch erneut. Bereits erfolgreiche Positionen werden nicht doppelt übertragen.
</Accordion>

<Accordion title="Rate-Limit von Lizard erreicht (429)">
  Lizard erlaubt maximal 500 Requests pro Minute und Nutzer. ExpressImport hält sich durch das interne Rate-Limit daran. Falls du den Fehler dennoch siehst, warte eine Minute und starte den Batch neu.
</Accordion>

<Accordion title="Token abgelaufen (401)">
  Dein Lizard-Token ist ungültig oder abgelaufen. Melde dich ab, hinterlege einen neuen Token und starte den Batch-Versand erneut.
</Accordion>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Prüfergebnisse hinterlegen" href="/expressimport/pruefergebnisse">
    Werksbescheinigung oder Erstprüfung gleich beim Versand mit anhängen.
  </Card>

  <Card title="Dyntag verknüpfen" href="/expressimport/dyntag-verknuepfen">
    QR-Codes pro Position automatisch mit dem Item verbinden.
  </Card>

  <Card title="CSV-Import" href="/expressimport/csv-import">
    Items aus einer CSV-Liste mit individuellen Werten pro Zeile erzeugen.
  </Card>

  <Card title="Speicher verwalten" href="/expressimport/speicher-verwalten">
    Speicher-Übersicht prüfen und versendete Kataloge aufräumen.
  </Card>
</CardGroup>