> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/gls-connector/schnellstart.md).

# Schnellstart

Erster vollständiger GLS-Versand aus einem Verkaufsauftrag in der Sandbox, mit Kontrolle und anschließender Produktionsumstellung.

In diesem Ablauf versenden Sie einen Verkaufsauftrag vollständig: Pakete bilden, an GLS übertragen, Etikett prüfen und drucken. Arbeiten Sie dabei in einer **Business-Central-Sandbox mit GLS-Sandbox-Zugang**. Die Produktionsumstellung folgt am Ende als getrennter Schritt.

{% hint style="info" %}
Die Abbildungen vom 20.10.2026 zeigen vorhandene Demobelege in GLS Connector 26.13.40.1015. Personenbezogene Angaben und Versandkennungen sind bereinigt. Die Beispiele erläutern unterschiedliche Arbeitsschritte und zeigen daher nicht durchgehend denselben Beleg.
{% endhint %}

## Voraussetzungen

* App installiert, Berechtigungssatz **GLS Super User** (Einrichtung) oder **GLS Integrationsbenutzer** (Versand).
* [Einrichtung](https://docs.solutioo.de/gls-connector/einrichtung.md) mit Umgebung Sandbox und erfolgreichem **Verbindung testen**.
* Mindestens ein [GLS-Karton](https://docs.solutioo.de/gls-connector/einrichtung/kartons-und-artikel.md) oder ein Standard-Maximalgewicht.
* Ein Testdebitor mit vollständiger **inländischer** Lieferadresse und ein Artikel mit gepflegtem Gewicht. Verwenden Sie fiktive Testdaten beziehungsweise die von GLS bereitgestellten Testadressen.
* Etikettenformat **PNG**, wenn Sie den integrierten Druck testen möchten.

## Ablauf

{% stepper %}
{% step %}

#### Verkaufsauftrag vorbereiten

1. Legen Sie einen Verkaufsauftrag für den Testdebitor an.
2. Erfassen Sie eine oder mehrere Artikelzeilen.
3. Prüfen Sie die Lieferadresse: Straße, Hausnummer, PLZ, Ort und Land müssen vollständig sein.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F2HMP41T9RwRnLzrIWUDl%2Fgls-workflow-20261020-17-auftrag-artikelzeilen.png?alt=media" alt="Verkaufsauftragszeilen mit GLS Demo T-Shirt, Menge 20, und GLS Demo Hoodie, Menge 20"><figcaption><p>Artikelzeilen eines bestehenden Demo-Verkaufsauftrags: GLS Demo T-Shirt und GLS Demo Hoodie mit jeweils Menge 20.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Pakete bilden

1. Wählen Sie im Verkaufsauftrag **GLS-Versand** → **Artikel auf Pakete verteilen**.
2. Setzen Sie **Anzahl Pakete** ausdrücklich auf **1**; der Dialog schlägt zunächst 2 vor.
3. Wählen Sie bei Bedarf einen geeigneten **Box-Code** und bestätigen Sie mit **OK**.

Die App legt das Paket und seine Artikelpositionen mit den verteilten Mengen an. Vorher muss kein Paket bestehen; ein zusätzliches Hinzufügen derselben Artikel ist nicht erforderlich. An GLS wird noch nichts übertragen.

Diese Aktion ersetzt vorhandene, noch nicht hochgeladene Pakete des Auftrags. Beginnen Sie den Schnellstart deshalb mit einem neuen Testauftrag. Bereits hochgeladene Pakete bleiben erhalten.

Für automatische Vorschläge nutzen Sie später **Smart Packing**. **Mehrere Pakete erstellen** erzeugt dagegen zunächst leere Paketköpfe. Details: [Mehrpaket- und Stapelverarbeitung](https://docs.solutioo.de/gls-connector/taegliche-arbeit/mehrpaket-und-stapel.md).

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FwbhuF2tETWTXGVQQbvRh%2Fgls-workflow-20261020-19b-paketverteilung-eins.png?alt=media" alt="Dialog Artikel auf Pakete verteilen mit Anzahl Pakete 1 und leerem Box-Code"><figcaption><p>Dialog „Artikel auf Pakete verteilen“ mit Anzahl Pakete 1, wie im Schnellstart beschrieben; der optionale Box-Code bleibt leer. OK legt das Paket mit den zugeordneten Artikelzeilen lokal an, ohne Übertragung an GLS.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Pakete prüfen

1. Öffnen Sie die angelegten Pakete, zum Beispiel über **GLS-Pakete**.
2. Kontrollieren Sie Artikel und Mengen, Empfänger, tatsächliches Gesamtgewicht, Karton, Produkt und Service.
3. Korrigieren Sie das Gewicht, wenn es nicht zum tatsächlichen Paket passt.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F4FqL8yw3E7yQ2vi164er%2Fgls-workflow-20261020-24-paketkarte-vor-versand.png?alt=media" alt="Paketkarte 46, Auftrag 101017: PARCEL, Referenz GLS-DEMO-VA-03-P2, 60 × 40 × 35 cm, Hochgeladen Nein, Etikett-Platzhalter"><figcaption><p>Offene Demo-Paketkarte 46 zu Auftrag 101017 mit Produkt PARCEL, Service „Kein“, Kundenreferenz GLS-DEMO-VA-03-P2 und Maßen 60 × 40 × 35 cm; „Hochgeladen“ steht auf Nein, der Etikettenbereich zeigt einen Platzhalter. „Etikett generieren“ erstellt für dieses Paket eine neue GLS-Sendung.</p></figcaption></figure>

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F8QtMdf4ZF2dH0Btm4Eb8%2Fgls-workflow-20261020-25-paketinhalt-vor-versand.png?alt=media" alt="Paket-Artikel: GLS-DEMO-TSHIRT Menge 10 à 0,25 und GLS-DEMO-HOODIE Menge 10 à 0,75"><figcaption><p>Paket-Artikel des offenen Demo-Pakets: GLS-DEMO-TSHIRT (Menge 10, 0,25 je Einheit) und GLS-DEMO-HOODIE (Menge 10, 0,75 je Einheit), zusammen 10 kg Artikelgewicht. Prüfen Sie vor der Übertragung tatsächliches Gewicht, Mengen und Einheiten.</p></figcaption></figure>
{% endstep %}

{% step %}

#### An GLS übertragen

1. Wählen Sie im Verkaufsauftrag **Pakete an GLS übertragen**.
2. Vor der Übertragung prüft die App unter anderem Gewicht (feste Obergrenze 40 kg und Kartonmaxima), bei Zollstrecken den Incoterm und bei Abholservices das Abholdatum.
3. Alle offenen Pakete des Auftrags werden als eine Sendung an GLS übertragen. Bei mehreren offenen Paketen enthält sie mehrere Paketpositionen.
   {% endstep %}

{% step %}

#### Ergebnis kontrollieren

1. Öffnen Sie die Paketkarte. **Hochgeladen** ist gesetzt; **Paketnummer**, **Verfolgungs-ID** und **Upload-Datum** sind gefüllt. Bei PNG sehen Sie das Bild im Bereich **Etikett**.
2. Wählen Sie **Etikett herunterladen** und prüfen Sie Adresse, Produkt und Lesbarkeit.
3. Wählen Sie im Verkaufsauftrag **GLS-Etiketten drucken** und drucken Sie über Ihren üblichen Business-Central-Druckweg.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FqdXTT3sGJRVbtWO0dDYm%2Fgls-workflow-20261020-14-uebertragungsstatus.png?alt=media" alt="GLS-Daten eines Testpakets: Hochgeladen aktiv, Upload-Datum 15.10.2026 14:08, Druckformat PNG; Paketnummer und Verfolgungs-ID geschwärzt"><figcaption><p>GLS-Daten eines bestehenden Testpakets: „Hochgeladen“ aktiviert, Upload-Datum 15.10.2026 14:08, Druckformat PNG, nicht storniert. Paketnummer und Verfolgungs-ID sind vorhanden, aber geschwärzt.</p></figcaption></figure>

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2Fiawlxiikv25ggcLrPwoA%2Fgls-workflow-20261020-11-etikettendruck-dialog.png?alt=media" alt="Anforderungsseite GLS Etikettendruck mit Browser-Drucker, Layout GLS-Etiketten, ID-Filter 10 und den Schaltflächen Drucken sowie Vorschau &#x26; schließen"><figcaption><p>„GLS Etikettendruck“ mit browsergesteuertem Drucker, Layout „GLS-Etiketten“ und Paketfilter. „Vorschau &#x26; schließen“ öffnet die Vorschau; „Drucken“ startet den gewählten Druckweg.</p></figcaption></figure>

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FLePYkL6HAN5gfE4ZvqJ8%2Fgls-workflow-20261020-12-label-vorschau.png?alt=media" alt="Vorschau eines vorhandenen GLS-Etiketts mit Aufdruck TEST, Demo-Empfänger und Testadresse; Absender, Sendungsnummer, Barcodes und QR-Codes geschwärzt"><figcaption><p>Ausschnitt eines vorhandenen GLS-TEST-Etiketts vom 15. Oktober 2026 in der Business-Central-Vorschau mit Demo-Empfänger und GLS-Testadresse. Absender- und Kontaktdaten, Sendungsnummer sowie Barcodes und QR-Codes sind unkenntlich gemacht.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Storno üben

Wählen Sie auf einem Testpaket **Paket stornieren** und bestätigen Sie. Bei Rückmeldung CANCELLED oder CANCELLATION\_PENDING wird das Paket lokal als storniert gekennzeichnet. So lernen Sie den Ablauf kennen, bevor Sie ihn produktiv brauchen.
{% endstep %}
{% endstepper %}

## Wenn etwas nicht klappt

| Situation                                      | Was Sie tun                                                                                                                                           |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Übertragung wird mit Gewichtsmeldung abgelehnt | Gewicht oder Kartonwahl korrigieren, ggf. Artikel auf mehrere Pakete verteilen                                                                        |
| Meldung zu fehlendem Incoterm                  | Lieferadresse prüfen; bei Auslandssendung Incoterm auf der Paketkarte setzen                                                                          |
| Zeitüberschreitung oder unklare Antwort        | **Nicht** sofort erneut übertragen. Erst Paketkarte, API-Aufrufprotokoll und GLS prüfen                                                               |
| Kein Bild im Sammeldruck                       | Etikettenformat PNG verwenden; siehe [Etiketten, Druck und Tracking](https://docs.solutioo.de/gls-connector/taegliche-arbeit/drucken-und-tracking.md) |

Weitere Fälle: [Überwachung und Fehlerbehebung](https://docs.solutioo.de/gls-connector/ueberwachung-und-fehlerbehebung.md).

## Umstellung auf Produktion

Prüfen Sie die Produktion getrennt; ein erfolgreicher Sandbox-Test überträgt sich nicht automatisch.

1. Installieren Sie die App in der Produktionsumgebung und weisen Sie die Berechtigungen zu.
2. Öffnen Sie den Assistenten, wählen Sie die Produktionsumgebung und bestätigen Sie die Warnung.
3. Tragen Sie **neue** Client-ID, Client-Geheimnis und Kontakt-ID des Produktionszugangs ein. Leere Felder würden die bisherigen Werte behalten.
4. Wählen Sie **Verbindung testen** und danach **Fertigstellen**.
5. Legen Sie Kartons und Stammdaten an, falls nicht vorhanden.
6. Klären Sie vor dem ersten Echtversand mit GLS, dass die genutzten Produkte und Services freigegeben sind.
7. Versenden Sie anschließend einen ersten echten Auftrag kontrolliert und prüfen Sie Etikett, Druck und Verfolgungs-ID.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.solutioo.de/gls-connector/schnellstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
