> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GS1-QR-Code

> Erstellen Sie einen GS1-konformen QR-Code für Handel und Lieferkette.

## Wofür er gedacht ist

Ein GS1-QR-Code kodiert einen [GS1 Digital Link](https://ref.gs1.org/standards/digital-link/) – eine aus GS1-Anwendungskennungen (Application Identifiers, AIs) aufgebaute URI, die ein Produkt, einen Standort, eine Sendung oder ein anderes Objekt der Lieferkette identifiziert. In der App wird die Kategorie beschrieben als "GS1 Application Identifier codes for products, locations & logistics."

Anders als die anderen Quick-Code-Typen auf dieser Seite ist GS1 kein Formular mit nur einem Bildschirm: Es handelt sich um einen eigenen 5-stufigen Assistenten unter `/qr/quick/gs1`, getrennt von der generischen Quick-Code-Oberfläche, da die Daten eines GS1-Codes strukturiert sind (eine primäre Kennung plus optionale Qualifikatoren, zusätzliche Attribute und Auflösungsziele) statt aus einer Handvoll flacher Felder zu bestehen.

<Note>
  GS1 ist die einzige Quick-Code-Kategorie, die entweder **Dynamic** oder **Static** sein kann – welches von beiden zutrifft, hängt vollständig vom in Schritt 1 gewählten Resolver ab, nicht von einem separaten Typumschalter. Siehe **Schritt 1: Resolver** unten.
</Note>

## Die 5 Schritte

Die Schrittanzeige des Assistenten zeigt **Resolver → Identify → Data Attributes → Resolution → Review**. Der Schritt **Resolution** erscheint nur, wenn Sie in Schritt 1 einen von Scanova gehosteten Resolver wählen (**Scanova Resolver** oder **Your Custom Domain**) – wählen Sie stattdessen **GS1 Global Resolver** oder **Custom Resolver**, wird Schritt 4 vollständig übersprungen, da Scanova für einen Code, den es nicht auflöst, kein Ziel zu konfigurieren hat.

### 1. Resolver – wer löst diesen Code auf?

Dies entscheidet, welche Domain im finalen Digital Link erscheint und ob der entstehende QR-Code dynamisch oder statisch ist:

| Option              | Domain                                     | QR-Typ  | Hinweise                                                                                                       |
| :------------------ | :----------------------------------------- | :------ | :------------------------------------------------------------------------------------------------------------- |
| Scanova Resolver    | `scnv.io`                                  | Dynamic | Standard. Von Scanova gehostet – funktioniert sofort.                                                          |
| Your Custom Domain  | Eine Ihrer verifizierten eigenen Domains   | Dynamic | Erfordert ein Kontingent im Rahmen eines Plans mit eigener Domain; andernfalls gesperrt (mit Upgrade-Hinweis). |
| GS1 Global Resolver | `id.gs1.org`                               | Static  | Wird durch die eigene Infrastruktur von GS1 aufgelöst, nicht durch Scanova.                                    |
| Custom Resolver     | Eine von Ihnen eingegebene Resolver-Domain | Static  | Sie kontrollieren den Resolver; Scanova speichert nur die Kennungsdaten.                                       |

<Frame caption="Schritt 1: Resolver, mit Scanova Resolver als Standardauswahl">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step1-resolver.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=e5ede2d1db0f5289ad5c633b423b39e4" alt="Schritt 1 des GS1-Assistenten, Resolver, mit vier Resolver-Optionen und Scanova Resolver als Standardauswahl" width="1280" height="720" data-path="images/v2/qr-codes/create/gs1/gs1-step1-resolver.png" />
</Frame>

### 2. Identify – was identifiziert dieser Code?

Wählen Sie die **Application Identifier**, die zu dem passt, was Sie kennzeichnen (zum Beispiel `(01) Global Trade Item Number (GTIN)`, die Standardauswahl), und geben Sie deren **Value** ein. Das Wertefeld erzwingt die tatsächlichen GS1-Regeln der AI live – erforderliche Länge, rein numerisches vs. alphanumerisches Format sowie für die AIs `00` und `01` eine gültige GS1-Prüfziffer.

Jede Application Identifier kann außerdem **Qualifiers** anbieten – für GTIN sind dies Serial Number (AI 21), Consumer Product Variant (AI 22) und Batch or Lot Number (AI 10), alle optional. Neben Serial Number befindet sich ein Link "Need more than one? Bulk generate" zu [Bulk-Operationen](/de/qr-codes/manage/folders-tags-bulk-operations), um auf einmal eine Reihe serialisierter Codes zu erzeugen.

### 3. Data Attributes

Ein optionaler Schritt, um zusätzliche, nach GS1-AI gekennzeichnete Werte an denselben Code anzuhängen – Daten, Maße und Ähnliches. Die meisten GS1-Codes benötigen dies nicht; der Schritt startet eingeklappt mit einem Umschalter "Add data attributes" statt leerer Felder.

### 4. Resolution (nur bei von Scanova gehosteten Resolvern)

Konfigurieren Sie, worauf der Code beim Scannen tatsächlich verweist. Ein Eintrag **Product Page** ist stets vorhanden und faktisch erforderlich – er ist das Ziel, auf dem ein einfacher Scan landet. Sie können weitere Linktypen hinzufügen (**Datasheet**, **Video**, **Custom**), die GS1-fähige Apps separat auffinden können.

Wählen Sie für jeden Eintrag:

* **Simple URL** – eine reine Ziel-URL, oder
* **Existing QR** – verweist auf einen Ihrer anderen dynamischen, Nicht-GS1-QR-Codes (eine Website-URL, ein Page-Builder-QR-Code, ein Dokument oder ein App-Store-QR-Code, je nachdem, welche Absicht Sie wählen).

Der Product-Page-Eintrag bietet außerdem **Auto-build a page** – dies erstellt eine echte Landingpage als QR-Code aus den bereits eingegebenen AI-Werten (nachdem Sie in einem Vorschaudialog ein Theme gewählt haben) und verknüpft sie als "Existing QR"-Referenz dieses Eintrags, sodass es ein normaler Page-Builder-QR-Code bleibt, den Sie anschließend weiter bearbeiten können.

<Frame caption="Schritt 4: Resolution, Konfiguration des erforderlichen Ziels Product Page">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step4-resolution.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=bb7025263a719c8db5e5237ad4c5a72f" alt="Schritt 4 des GS1-Assistenten, Resolution, mit dem erforderlichen Product-Page-Eintrag auf Simple URL mit einem Zielfeld sowie einer Option, weitere Linktypen hinzuzufügen" width="1280" height="744" data-path="images/v2/qr-codes/create/gs1/gs1-step4-resolution.png" />
</Frame>

<Note>
  Ein GS1-Code kann niemals auf einen anderen GS1-Code als Auflösungsziel verweisen – diese Option wird in der Auswahl vollständig herausgefiltert, nicht nur davon abgeraten.
</Note>

### 5. Review & publish

Zeigt die zusammengesetzte **Digital-Link-Vorschau** (z. B. `https://scnv.io/LpqE/01/04012345678901`) sowie eine allgemein verständliche Zusammenfassung dessen, was der Code identifiziert, wer ihn auflöst und wo ein Scan landet. Sie können den QR-Code hier auch vor der Veröffentlichung umbenennen.

<Frame caption="Schritt 5: Review and publish, mit dem zusammengesetzten Digital Link und einer allgemein verständlichen Zusammenfassung">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/gs1/gs1-step5-review.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=d9b316051d08951102bd4af11a08a16f" alt="Schritt 5 des GS1-Assistenten, Review and publish, mit dem zusammengesetzten Digital Link, einer allgemein verständlichen Zusammenfassung und der Publish-Schaltfläche" width="1280" height="776" data-path="images/v2/qr-codes/create/gs1/gs1-step5-review.png" />
</Frame>

## Einen GS1-QR-Code erstellen

<Steps>
  <Step title="Create QR Code öffnen und Quick Code auswählen">
    Gehen Sie in der Seitenleiste zu **QR Codes** und klicken Sie dann auf **Create QR Code** (oder navigieren Sie zu `/qr/create`). Klicken Sie auf die Karte **Quick Code**.
  </Step>

  <Step title="GS1 auswählen">
    Klicken Sie im Raster der Quick-Code-Typen unter **GS1** im Bereich **Dynamic** oben auf **Configure**. Dadurch öffnet sich der Assistent unter `/qr/quick/gs1`.
  </Step>

  <Step title="Einen Resolver auswählen">
    Wählen Sie im Schritt **Resolver**, wer den Code auflöst. **Scanova Resolver** ist standardmäßig ausgewählt und erfordert keine weitere Einrichtung – klicken Sie auf **Continue**.
  </Step>

  <Step title="Festlegen, was der Code repräsentiert">
    Wählen Sie im Schritt **Identify** eine Application Identifier aus und geben Sie deren Wert ein (zum Beispiel eine 14-stellige GTIN). Fügen Sie bei Bedarf Qualifikatoren hinzu und klicken Sie dann auf **Continue**.
  </Step>

  <Step title="Datenattribute hinzufügen (optional)">
    Überspringen Sie diesen Schritt, sofern Sie keine zusätzlichen GS1-Attribute anhängen müssen, und klicken Sie dann auf **Continue**.
  </Step>

  <Step title="Resolution konfigurieren">
    Wenn Sie einen von Scanova gehosteten Resolver gewählt haben, legen Sie mindestens ein Ziel für **Product Page** fest – entweder eine Simple URL, einen vorhandenen QR-Code oder eine automatisch erstellte Page – und klicken Sie dann auf **Continue**.
  </Step>

  <Step title="Überprüfen und veröffentlichen">
    Überprüfen Sie den zusammengesetzten Digital Link und die Zusammenfassung, passen Sie bei Bedarf den Namen des QR-Codes an und klicken Sie dann auf **Publish**. Ein Panel öffnet sich, um Ordner und Tags des QR-Codes zu bestätigen und das QR-Design anzupassen, bevor Sie bestätigen.
  </Step>
</Steps>

## Erstellung über die API

Um einen GS1-QR-Code über die API statt über die Benutzeroberfläche zu erstellen, verwenden Sie die Kategorie-ID `31` (in der Referenztabelle **Category dropdown reference** von [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) als **GS1** bezeichnet, `allowed_qr_types: "bt"` – sowohl `"dy"` als auch `"st"` sind für `qr_type` gültig, entsprechend dem gewählten Resolver). Der `info`-Payload ist ein **reines Array** typisierter Blöcke, einer pro Assistentenschritt mit Daten:

```json theme={null}
[
  {
    "type": "resolver",
    "data": { "name": "scanova_resolver", "domain": "scnv.io" }
  },
  {
    "type": "primaryKey",
    "data": { "id": "01", "value": "04012345678901" }
  },
  {
    "type": "qualifier",
    "data": [{ "id": 21, "value": "SER456" }]
  },
  {
    "type": "dataAttributes",
    "data": [{ "id": "3103", "value": "000195" }]
  },
  {
    "type": "resolution",
    "data": {
      "linkType": "pip",
      "name": "simple_url",
      "target": { "url": "https://acme.com/products/widget-42" }
    }
  }
]
```

`qualifier`, `dataAttributes` und `resolution`-Blöcke sind jeweils optional und wiederholbar (ein `resolution`-Block pro konfiguriertem Linktyp); `resolver` und `primaryKey` sind erforderlich. Das `target` eines `resolution`-Blocks ist entweder `{ "url": "..." }` (wenn `name` gleich `"simple_url"` ist) oder `{ "qrid": "..." }` (wenn `name` gleich `"qr_reference"` ist) – `resolution`-Blöcke entfallen vollständig bei den Resolvern `gs1`/`custom_resolver`, die kein von Scanova gehostetes Ziel zu speichern haben.

Das vollständige Anfrageschema finden Sie unter [Create QR Code](/v1/api-reference/endpoint/qr_manager/create).

## Weiterführende Informationen

* [Produkt-QR-Code](/de/qr-codes/create/product) – eine Marketing-Landingpage für ein Produkt, im Gegensatz zum strukturierten Supply-Chain-Bezeichner von GS1.
* [Ordner, Tags & Bulk-Operationen](/de/qr-codes/manage/folders-tags-bulk-operations) – eine Reihe serialisierter GS1-Codes in großer Menge erzeugen und Codes nach der Veröffentlichung organisieren.
* [Quick Code vs. vollständige Page](/de/qr-codes/create/quick-code-vs-page) – wie GS1 sich in die anderen Quick-Code-Typen einordnet.
