> ## 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.

# Dyntag verknüpfen

> QR-Codes und Dyntag-IDs pro Position zuordnen und beim Batch-Versand automatisch mit dem neuen Betriebsmittel verknüpfen.

Mit der **Dyntag-Verknüpfung** verbindest du jede importierte Position direkt mit einem physisch vorbereiteten QR-Code (Dyntag), ohne den Schritt anschließend in Lizard nachholen zu müssen. Das ist besonders nützlich, wenn du Geräte vor dem Inventarisieren bereits etikettiert hast.

## Was ist ein Dyntag?

Ein **Dyntag** ist die kurze Lizard-ID hinter einem QR-Code-Etikett (z. B. `mamyV6C8+A`). Sie ist auf dem Etikett aufgedruckt und steckt auch in der zugehörigen URL `https://dynt.ag/<id>`. Über diese ID weiß Lizard, welches physische Gerät zu welchem Datensatz gehört.

<Tip>
  Wenn du QR-Codes mit einem Scanner einliest, erhältst du normalerweise die volle URL. ExpressImport extrahiert die ID daraus automatisch — du musst nichts bereinigen.
</Tip>

## Wann diese Funktion nutzen?

* Du hast deine Geräte **vor dem Inventarisieren etikettiert** und willst die Verknüpfung gleich beim Import setzen
* Deine CSV enthält eine Spalte mit **Dyntag-IDs oder QR-Code-URLs** aus einem Scanner-Export
* Du möchtest **Dyntag-Erstprüfungen** zusammen mit dem Item anlegen (Kombination mit [Prüfergebnissen](/expressimport/pruefergebnisse))

## Voraussetzungen

* Vorbereitete Dyntag-Etiketten oder eine Liste der Dyntag-IDs
* Ein Katalog (siehe [Katalog erstellen](/expressimport/katalog-erstellen))
* Schreibrechte auf Dyntag-Verknüpfungen in Lizard

## Quellen für Dyntag-Werte

ExpressImport unterstützt zwei Wege, um Dyntags zu hinterlegen:

<Tabs>
  <Tab title="Via CSV-Mapping (empfohlen)">
    In der CSV-Spalte hinterlegst du eine Dyntag-ID oder eine vollständige URL pro Zeile. Beim Import wird der Wert pro Position automatisch übernommen.

    <Steps>
      <Step title="CSV-Spalte vorbereiten">
        Lege eine Spalte in deiner Liste an — etwa `Dyntag`, `QR-Code` oder `lizardid`. Werte können IDs oder URLs sein.
      </Step>

      <Step title="CSV-Import aktivieren">
        Folge den Schritten in [CSV-Import](/expressimport/csv-import) und ordne die Spalte dem Feld **Dyntag (Lizard-ID)** zu.

        <Check>
          ExpressImport erkennt Spalten mit Namen wie `dyntag`, `lizardid`, `shortid` oder `qrcode` automatisch und schlägt das Mapping vor.
        </Check>
      </Step>

      <Step title="Items erzeugen">
        Beim Generieren der Items wird die Dyntag-ID je Zeile aus der CSV übernommen.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manuell pro Position">
    Wenn du die Items mit dem Kopien-Generator anlegst, kannst du die Dyntag-ID nachträglich in der Item-Karte eintragen.

    <Steps>
      <Step title="Item öffnen">
        Klicke auf eine Position, um das Bearbeitungsdialog zu öffnen.
      </Step>

      <Step title="Dyntag eintragen">
        Trage die ID oder URL in das Dyntag-Feld ein.
      </Step>

      <Step title="Speichern">
        Bestätige mit **Speichern**. Die Dyntag-Anzeige erscheint auf der Item-Karte.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## URL-Erkennung

ExpressImport entfernt URL-Präfixe automatisch — egal aus welcher Quelle die Werte stammen:

| Eingabe                      | Übernommener Dyntag |
| ---------------------------- | ------------------- |
| `mamyV6C8+A`                 | `mamyV6C8+A`        |
| `https://dynt.ag/mamyV6C8+A` | `mamyV6C8+A`        |
| `dynt.ag/XY-42`              | `XY-42`             |
| `http://dynt.ag/ABC123`      | `ABC123`            |

So kannst du Scanner-Exports oder Browser-URLs direkt einfügen, ohne sie vorher zu bereinigen.

## Versand-Workflow

Beim Klick auf **Batch senden** wird je Position folgender Ablauf ausgeführt:

<Steps>
  <Step title="Item erstellen">
    Lizard legt das Betriebsmittel an und gibt die Item-UUID zurück.
  </Step>

  <Step title="Dyntag verknüpfen">
    Sofort danach wird ein zweiter Request abgesetzt, der die Dyntag-ID an die soeben erstellte Item-UUID anhängt.

    <Check>
      Bei Erfolg erscheint auf der Item-Karte ein grüner Dyntag-Status.
    </Check>
  </Step>
</Steps>

<Note>
  Wird zusätzlich ein [Prüfergebnis](/expressimport/pruefergebnisse) hinterlegt, sendet ExpressImport bis zu **drei Requests pro Position** (Item, Dyntag, Prüfergebnis). Das interne Pacing von 250 ms zwischen den Requests verhindert, dass Lizard das Rate-Limit von 500 Requests pro Minute meldet.
</Note>

## Status pro Position

Auf jeder Item-Karte siehst du den Dyntag-Status separat vom Item-Erstellungsstatus:

| Status         | Bedeutung                       |
| -------------- | ------------------------------- |
| Kein Badge     | Kein Dyntag hinterlegt          |
| Grau           | Wartet auf Versand              |
| Gelb (Spinner) | Verknüpfung läuft               |
| Grün           | Verknüpfung erfolgreich         |
| Rot            | Fehler — Detail unter der Karte |

Im Versand-Panel siehst du außerdem einen Zähler **N Dyntag-Fehler**, der unabhängig von Item-Fehlern und Prüfergebnis-Fehlern hochgezählt wird.

## Fehlerbehandlung

<Accordion title="Dyntag bereits einem anderen Item zugeordnet">
  Eine Dyntag-ID kann nur einem aktiven Item zugewiesen sein. Wenn der QR-Code schon in Lizard vergeben ist, schlägt die Verknüpfung fehl. Prüfe in Lizard, welches Item den Dyntag belegt, und löse die alte Verknüpfung — oder verwende einen freien Dyntag.
</Accordion>

<Accordion title="Dyntag nicht gefunden / ungültig">
  Die ID existiert in Lizard nicht. Mögliche Ursachen:

  * Tippfehler in der CSV-Zeile
  * Die ID gehört zu einem anderen Lizard-Tenant
  * Der Dyntag wurde aus dem System entfernt

  Korrigiere den Wert und starte den Batch-Versand erneut. Das Item bleibt in Lizard bestehen — nur die Verknüpfung wird nachgeholt.
</Accordion>

<Accordion title="Item erstellt, aber Dyntag-Fehler">
  Das Betriebsmittel ist in Lizard angelegt, lediglich die Verknüpfung ist fehlgeschlagen. Du kannst den Dyntag direkt in Lizard manuell zuweisen, oder den Fehler in ExpressImport korrigieren und den Batch erneut senden — bereits erstellte Items werden dabei nicht dupliziert.
</Accordion>

<Accordion title="Mehrere Items mit derselben Dyntag-ID">
  ExpressImport sendet alle Verknüpfungen — Lizard akzeptiert aber nur die erste. Die anderen erhalten den Fehler aus der vorigen Frage. Stelle sicher, dass jede Position eine eindeutige ID bekommt, bevor du sendest.
</Accordion>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="CSV-Import" href="/expressimport/csv-import">
    Dyntag-Spalte aus Excel oder einem Scanner-Export übernehmen.
  </Card>

  <Card title="Prüfergebnisse hinterlegen" href="/expressimport/pruefergebnisse">
    Dyntag und Erstprüfung in einem Arbeitsschritt anlegen.
  </Card>

  <Card title="Batch-Import" href="/expressimport/batch-import">
    Items, Dyntags und Prüfergebnisse gesammelt an Lizard senden.
  </Card>
</CardGroup>