> 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/ueberwachung-und-fehlerbehebung.md).

# Überwachung und Fehlerbehebung

API-Aufrufprotokoll nutzen, typische Fehlermeldungen einordnen und bei Zeitüberschreitung sicher vorgehen.

Diese Seite hilft Ihnen, Probleme schnell einzuordnen und sicher zu lösen, ohne doppelte Sendungen zu erzeugen.

## Wo Sie nachsehen

| Ort                                                        | Was Sie sehen                                                                                                              |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Paketkarte                                                 | **Hochgeladen**, **Verfolgungs-ID**, **Paketnummer**, **Upload-Datum**, **Status-Grund**, Gewicht, Service und **Etikett** |
| **GLS-Pakete**                                             | Alle Pakete, zum Filtern nach Auftrag oder Status                                                                          |
| **API-Aufrufprotokoll** (Rollencenter Unternehmensmanager) | Anfragen an GLS und die Antworten                                                                                          |
| **GLS-Tarifimportstapel**                                  | Status und fehlerhafte Zeilen von Tarifimporten                                                                            |

## Grundregel bei unklarem Ergebnis

Wenn eine Übertragung mit Zeitüberschreitung endet oder Sie nicht sicher sind, ob sie geklappt hat:

1. **Übertragen Sie nicht sofort erneut.**
2. Öffnen Sie die Paketkarte. Ist eine Verfolgungs-ID vorhanden, existiert die Sendung.
3. Prüfen Sie im **API-Aufrufprotokoll**, was GLS geantwortet hat.
4. Prüfen Sie bei GLS, ob die Sendung angelegt wurde.
5. Existiert die Sendung, holen Sie das Etikett mit **Etikett erneut drucken**.
6. Erst wenn sicher ist, dass bei GLS keine Sendung entstanden ist, übertragen Sie erneut.

Verlassen Sie sich bei unterbrochenen Aufrufen nicht auf eine automatische Erkennung doppelter GLS-Sendungen.

## Typische Fehler

### Einrichtung und Anmeldung

| Symptom                                    | Ursache                                                              | Lösung                                                                                                                                           |
| ------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Verbindung testen** schlägt fehl         | Falsche Zugangsdaten, falsche Umgebung oder HTTP-Aufrufe blockiert   | Daten mit GLS abgleichen; Sandbox- und Produktionszugang nicht vermischen; **Allow HttpClient Requests** in den Erweiterungseinstellungen prüfen |
| Nach Umgebungswechsel weiter Anmeldefehler | Alte Zugangsdaten noch gespeichert, weil Felder leer gelassen wurden | Neue Client-ID und neues Client-Geheimnis eintragen                                                                                              |
| GLS-Aktionen oder Seiten fehlen            | Lizenz oder Berechtigungssatz fehlt                                  | Lizenz prüfen; **GLS Integrationsbenutzer** oder **GLS Super User** zuweisen                                                                     |
| Verbindung ok, aber Produkt abgelehnt      | Produkt oder Service nicht im Vertrag                                | Mit GLS klären                                                                                                                                   |

### Pakete und Übertragung

| Symptom                                                    | Ursache                                                           | Lösung                                                                                       |
| ---------------------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Gewichtsfehler vor der Übertragung                         | Paket über 40 kg oder über Kartonmaximum                          | Ware aufteilen, größeren Karton wählen, Gewicht prüfen                                       |
| Unrealistisches Paketgewicht                               | Einheiten passen nicht zu den Stammdaten oder Ersatzwerte greifen | **Maßeinheit**, **Gewichtseinheit**, **Quelle für Paketgewicht** und Artikeleinheiten prüfen |
| Feste Paketanzahl bei der Artikelverteilung wird abgelehnt | Anzahl reicht wegen Grenzen nicht                                 | Anzahl erhöhen oder Karton ändern                                                            |
| Upload blockiert, Incoterm fehlt                           | Zollstrecke erkannt                                               | Incoterm auf der Paketkarte setzen                                                           |
| Upload beanstandet Abholdatum                              | Pick\&Ship oder Pick\&Return ohne Datum                           | **Abholdatum** setzen                                                                        |
| Falsches Produkt bei Mehrpaketsendung                      | Sendungsweite Angaben kommen vom ersten Paket                     | Erstes Paket korrigieren oder getrennt übertragen                                            |
| Hinweis zur Kartonbestandsabbuchung                        | Bestandsbuchung des Kartons fehlgeschlagen                        | Ursache beheben, dann **Kartonbestandsabbuchung wiederholen**                                |

### Etiketten und Nachbearbeitung

| Symptom                                 | Ursache                                          | Lösung                                                                                                                          |
| --------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Sammeldruck ohne Etikettenbild          | Format PDF oder Zebra                            | Für neue Etiketten PNG verwenden; gespeicherte Originaldateien herunterladen, eine Konfigurationsänderung konvertiert sie nicht |
| **Etikett herunterladen** nicht möglich | Paket nicht übertragen oder keine Etikettendaten | Status prüfen; ggf. **Etikett erneut drucken**                                                                                  |
| Storno meldet SCANNED                   | Paket bereits von GLS erfasst                    | Mit GLS klären                                                                                                                  |
| Gewichtsänderung nicht übernommen       | GLS verarbeitet kleine Änderungen ggf. nicht     | Bei Bedarf mit GLS klären                                                                                                       |
| Paket lässt sich nicht löschen          | Paket bereits übertragen                         | **Paket stornieren** verwenden                                                                                                  |

### Tarife

| Symptom                         | Lösung                                                                                        |
| ------------------------------- | --------------------------------------------------------------------------------------------- |
| Importstapel im Status Fehler   | In **Importierte Zeilen** Blatt, Zeile, Spalte und Fehlertext prüfen, Datei korrigieren       |
| Import erkennt Datei nicht      | Leere Vorlage der App verwenden, Blattnamen und Überschriften nicht ändern, TemplateVersion 1 |
| Prüfen und aktivieren bricht ab | Fehler zu Gültigkeit, Zonen, Gewichtsbereichen o. Ä. beheben                                  |
| Berechnung findet keinen Tarif  | Aktiven Tarif, Vertragsreferenz, Ursprung, Versanddatum prüfen                                |

## Beispiel: Artikel passt nicht in den Karton

Bei Smart Packing prüft die lokale Planung die Artikelmaße gegen den gewählten Karton. Im Beispiel ist die längste Artikelkante 25 cm, die größte Kante von TESTBOX aber nur 20 cm. Wählen Sie einen passenden Karton oder berichtigen Sie falsch gepflegte Maße und Einheiten; eine größere Paketanzahl allein ändert diese Maßgrenze nicht.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F7jK5ZjL5nf91ve8ZTOjb%2Fgls-workflow-20261020-21-packpruefung-karton.png?alt=media" alt="Fehlermeldung: GLS-DEMO-TSHIRT mit 25 × 20 × 2 cm passt nicht in TESTBOX mit 20 × 20 × 15 cm"><figcaption><p>Lokale Packprüfung: Artikel GLS-DEMO-TSHIRT (25 × 20 × 2 cm) passt nicht in Box TESTBOX (20 × 20 × 15 cm). Wählen Sie einen passenden Box-Code oder korrigieren Sie die Stammdaten.</p></figcaption></figure>

## Bevor Sie den Support kontaktieren

Notieren Sie installierte Version, Umgebung (Sandbox/Produktion), betroffenes Paket oder Auftrag und den Meldungstext. Siehe [Support](https://docs.solutioo.de/gls-connector/support.md).


---

# 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/ueberwachung-und-fehlerbehebung.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.
