GLS-Schnittstelle in Billbee: GLS oder GLS ShipIT
· 5 Minuten Lesezeit

Billbee bindet GLS über zwei Kacheln an, weil GLS zwei Schnittstellen hat. Die Kachel „GLS“ nutzt die GLS Web-API und braucht einen Web-API-Nutzer, deine Customer-ID und deine Contact-ID. Die Kachel „GLS ShipIT“ nutzt die neuere ShipIT-Farm-API und braucht API Key, Secret und Kontakt-ID aus dem GLS Developer Portal. Beide richtest du unter „Einstellungen → Versandwege“ ein, und für beide brauchst du einen Geschäftskundenvertrag bei GLS.
GLS oder GLS ShipIT: was ist der Unterschied?
| Kachel „GLS“ | Kachel „GLS ShipIT“ | |
|---|---|---|
| Schnittstelle bei GLS | Web-API | ShipIT-Farm-API |
| Zugangsdaten | Benutzername, Passwort, Customer-ID, Contact-ID | API Key, Secret, Kontakt-ID |
| Woher | vom GLS-Vertrieb | GLS Developer Portal, Freischaltung über den GLS-Vertrieb |
| Versandprodukte | BusinessParcel, Guaranteed24Service, ExpressParcel | Parcel, Express |
| Labeleinstellung in Billbee | Etikettengröße | Label um 90° drehen |
| Besonderheit | Testbetrieb zum Ausprobieren | Gefahrgut (Limited Quantity), Exportprodukte |
Billbee empfiehlt keine der beiden ausdrücklich. Es hängt davon ab, welchen Zugang dir GLS freischaltet. Billbee bezeichnet ShipIT als die neue API. Wenn du neu anfängst, frag deinen GLS-Ansprechpartner deshalb zuerst nach ShipIT.
Die Contact-ID bzw. Kontakt-ID ist bei beiden dieselbe: die ID deiner Abholstelle. Du findest sie in deiner GLS-Versendernummer hinter dem Leerzeichen. Der Teil davor ist die Customer-ID.
Wie richtest du die Kachel „GLS“ ein?
Zuerst fragst du bei deinem GLS-Vertrieb einen Web-API-Nutzer an. Sag dazu, dass er für die Paketscheinerstellung in Billbee gedacht ist. Fehlt dem Nutzer dieses Recht, meldet Billbee später „The provided shipper is not allowed to create shipments“.
Dann in Billbee:
- „Einstellungen → Versandwege“ öffnen, „Versandweg hinzufügen“ klicken, die Kachel „GLS“ wählen.
- Im Reiter „Verbindung“ Name, Customer-ID, Kontakt-ID, Benutzername und Passwort eintragen.
- Den Haken bei „Testbetrieb“ nur setzen, wenn du erst probieren willst. Im Testbetrieb gehen Sendungen nur als Test an GLS, es entstehen keine echten Labels.
- Im Reiter „Allgemein“ Etikettengröße, Referenz und bei Bedarf eine alternative Absenderadresse eintragen. Ohne alternative Adresse steht die Adresse aus deinem GLS-Konto auf dem Label.
- Speichern, dann im Reiter „Produkte“ auf „Produkte abrufen“ klicken.
Wie richtest du die Kachel „GLS ShipIT“ ein?
Bei ShipIT holst du die Zugangsdaten selbst im GLS Developer Portal:
- Im GLS Developer Portal mit deiner E-Mail-Adresse registrieren.
- Unter deiner E-Mail-Adresse den Menüpunkt „Apps“ öffnen und über „+ NEW APP“ eine App mit dem Namen „Billbee“ anlegen.
- „Authentication API v2“ und „ShipIT-Farm API v1“ aktivieren bzw. anfragen. Für Retourenlabels zusätzlich „Shop Returns Customer Plus API v3“.
- Mit „SAVE“ speichern.
- Deinem GLS-Ansprechpartner schreiben, dass du GLS über Billbee nutzen willst. Bitte um Zugang zur ShipIT-Farm-API, zur Customs API und bei Bedarf zur Shop Returns Customer Plus API. Nenne dabei die E-Mail-Adresse deines Teams im Portal und die App-ID.
Danach in Billbee:
- „Einstellungen → Versandwege“ öffnen, „Versandweg hinzufügen“ klicken, die Kachel „GLS ShipIT“ wählen.
- Im Reiter „Verbindung“ Name, API Key, Secret und Kontakt-ID eintragen.
- Im Reiter „Allgemein“ Referenz, bei Bedarf „Label um 90° drehen“ und eine alternative Absenderadresse eintragen.
- Speichern, dann im Reiter „Produkte“ auf „Produkte abrufen“ klicken.
Legst du ein ShipIT-Produkt von Hand über „Hinzufügen“ an, ist der Anzeigename frei, der Produktname muss aber ein gültiger GLS-Produktcode sein. Für Sendungen ins Ausland setzt du beim Produkt den Haken „Export“ und wählst die Frankatur.
Welche Zusatzleistungen gibt es?
Zusatzleistungen hängst du im Reiter „Produkte“ an ein Versandprodukt. Laut Billbee stehen je nach Produkt unter anderem bereit:
- FlexDeliveryService: GLS benachrichtigt den Empfänger, der die Zustellung umlenken kann.
- Lieferung an einen Shop: Zustellung an einen GLS-PaketShop statt an die Haustür.
- Ablage im Briefkasten und Wunschort (bei der Web-API heißt er DepositService).
- Nachnahme und Authentifizierung per PIN (IdentPINService).
- Rücksendung aus einem Shop: erzeugt zum Versandlabel gleich ein Retourenlabel.
- Terminzustellung: bei ShipIT nur für Express.
Bei der Web-API kommen Alterssichtprüfung und umweltneutraler Versand dazu, bei ShipIT Limited Quantity für Gefahrgut in begrenzter Menge.
Wie erstellst du GLS-Retourenlabels über Billbee?
Mit der Zusatzleistung „Rücksendung aus einem Shop“. Du fügst sie im Reiter „Produkte“ zum Versandprodukt hinzu und trägst die Rücksendeadresse ein. Billbee erzeugt dann beim Versand zwei Labels. Im Reiter „Versand“ der Bestellung zeigt die Spalte „Typ“, welches die Sendung und welches die Retoure ist.
Bei ShipIT muss dafür die „Shop Returns Customer Plus API v3“ freigeschaltet sein. Für Otto-Bestellungen verlangt Billbee beide Zeilen, Sendung und Retoure.
Welche Fehlercodes sind typisch?
| Fehler | Kachel | Ursache | Lösung |
|---|---|---|---|
| 0009 „Unauthorized“ bzw. „Wrong username or password“ | GLS | Testbetrieb ist aktiv | Haken bei „Testbetrieb“ entfernen |
| 0004 „The provided shipper is not allowed to create shipments“ | GLS | Konto nicht für den Webservice freigeschaltet | Mail an [email protected], „Billbee“ in den Betreff |
| 0003 „Missing Rights“ | GLS | Nutzer darf die API nutzen, aber keine Labels erstellen | Rechte des Nutzers von GLS prüfen lassen |
| „Error 0: Fehlercode 400: No product of type PARCEL available for this shipment“ | GLS ShipIT | Rücksendeadresse der Retouren-Zusatzleistung fehlerhaft | Rücksendeadresse und Land im Reiter „Produkte“ prüfen |
Häufige Fragen
Brauche ich einen GLS-Vertrag für die Billbee-Schnittstelle?
Ja. Billbee setzt einen Geschäftskundenvertrag bei GLS voraus. Ohne ihn bekommst du weder einen Web-API-Nutzer noch die ShipIT-Freischaltung.
Wo finde ich meine GLS-Contact-ID?
In deiner Versendernummer. Der Teil vor dem Leerzeichen ist die Customer-ID, der Teil dahinter die Contact-ID, also die ID deiner Abholstelle.
Kann ich GLS und GLS ShipIT gleichzeitig verbinden?
Billbee führt beide als eigene Versandwege. Sinnvoll ist das aber höchstens während einer Umstellung. Am Packtisch führen zwei GLS-Anbindungen schnell dazu, dass jemand die falsche erwischt.
Wie lade ich ein GLS-Label nachträglich herunter?
In der Bestellung im Reiter „Versand“. Kauf nicht einfach neu, sonst zahlst du doppelt. Wie das passiert und wie du es verhinderst, steht in Versandlabel doppelt gekauft vermeiden.
Welche anderen Versanddienste kann ich in Billbee anbinden?
DHL, Deutsche Post, DPD, Hermes, UPS und weitere. Die Übersicht steht in Versanddienstleister in Billbee verbinden.
Packhummel, unsere Packtisch-App für Billbee am Mac, kauft GLS-Labels über die Anbindung, die du in Billbee eingerichtet hast. Das Porto läuft weiter über deinen GLS-Vertrag. Noch einmal verbinden musst du GLS dafür nicht. So läuft Packhummel.