SendLabel x Lingxing

Leitfaden fuer die Lingxing ERP / WMS API-Integration

Diese Seite kann direkt an das Lingxing-Technikteam weitergegeben werden. Sie konzentriert sich auf Testkonten, API-Pfadauswahl, Testablauf und Production-Sicherheitsgrenzen.

Kontaktdaten

SendLabel.de

https://www.sendlabel.de

info@sendlabel.de

+49 151 4581 6823

Depha GmbH, Steinriedendamm 15, Halle 1, Eingang 1, 38108 Braunschweig, Deutschland

Exportiert am: 07.08.2026, 08:33

Zurueck zur normalen Ansicht

Was Sie Erhalten

Unser Admin erstellt oder nutzt ein eigenes Frontend-Konto fuer Lingxing weiter und erzeugt einen Test-API-Key.

Das Paket enthaelt in der Regel Login-E-Mail, Initialpasswort bei neuen Konten, Test-Token / client_secret, empfohlene client_id und die freigeschalteten Kanaele.

- Das Konto ist standardmaessig nur fuer Testintegration freigeschaltet und nicht fuer Production.

- Fuer echte Sendungserstellung muss Production von unserem Team pro Konto separat freigeschaltet werden.

- Zuerst validate_only / dry_run fuer Authentifizierung, Adresslogik und Feldmapping nutzen und erst danach Production beantragen.

Abgrenzung zwischen Testkonto und Kunden-Produktivkonten

Das hier bereitgestellte Konto und Token dienen in erster Linie der plattformweiten Integration, damit Lingxing und SendLabel die technische Validierung zuerst abschliessen koennen.

Wenn spaeter echte Haendler SendLabel innerhalb von Lingxing nutzen, sollten sie dieses gemeinsame Testkonto oder ein einheitliches Lingxing-Production-Zugangsdatenpaar nicht dauerhaft weiterverwenden.

- Jeder echte Kunde sollte sich zuerst auf der SendLabel-Website registrieren oder anmelden und einen eigenen API-Zugangsrequest einreichen.

- Nach der Freigabe schaltet unser Team Production fuer genau dieses Kundenkonto frei und erstellt einen kundenspezifischen Production-API-Key.

- Der Kunde hinterlegt anschliessend seinen eigenen Production-Key in Lingxing, damit Bestellungen, Abrechnung, Risikosteuerung, Audit-Trail und Stornorechte dem jeweiligen Kundenkonto zugeordnet bleiben.

Empfohlener Testablauf

Dies ist der sicherste Testpfad und vermeidet Abrechnungsabweichungen, Kosten oder verbleibende Live-Label.

- Schritt 1: Authentifizierung pruefen und bestaetigen, dass der Request den richtigen Kanal trifft.

- Schritt 2: Mit validate_only Adressstruktur, Pflichtfelder und grundlegende Fachvalidierung pruefen.

- Schritt 3: Mit dry_run erwartete Preise und moegliche Fehlerzweige pruefen, ohne eine echte Sendung zu erzeugen.

- Schritt 4: Falls Production-Tests noetig sind, schaltet unser Team dies pro Konto frei und empfiehlt die Kombination mit Auto-Revoke.

Authentifizierung

Empfohlen ist `Authorization: Bearer <API_KEY>`. Wenn der bestehende Client naeher an nativen UPS-/DHL-Abläufen liegt, werden auch kompatible Header und client_id-Aliase unterstuetzt.

- `Authorization: Bearer <API_KEY>`

- X-API-Key / X-SendLabel-API-Key

- Basic(base64(prefix:key))

- dhl_<API_KEY_PREFIX> / ups_<API_KEY_PREFIX> client_id aliases

Hauefige Einstiegspunkte

Neue Systeme sollten mit der Unified API starten. Bestehende native UPS-/DHL-Clients koennen mit Compat-Routen beginnen, um den Aenderungsaufwand gering zu halten.

- https://www.sendlabel.de/api/v1/shipments/import

- https://www.sendlabel.de/api/v1/orders/{orderId}

- https://www.sendlabel.de/api/v1/orders/{orderId}/tracking

- https://www.sendlabel.de/api/compat/dhl-parcel-de/v1/shipments/import

- https://www.sendlabel.de/api/compat/ups/v1/shipments/import

- https://www.sendlabel.de/api/compat/ups/security/v1/oauth/token

Beispiel fuer Test-Requests

Die folgenden Befehle decken Unified validate_only und UPS-Compat dry_run ab. Wenn diese erfolgreich laufen, sind die meisten Feldmapping-Fragen bereits geklaert.

curl -X POST "https://www.sendlabel.de/api/v1/shipments/import" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-SendLabel-Execution-Mode: validate_only" \
  -H "Idempotency-Key: lingxing-validate-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "carrier": "DHL_PARCEL_DE",
    "shipments": [
      {
        "reference": "LX-10001",
        "recipient": {
          "name": "Max Mustermann",
          "street1": "Lindenstr. 5",
          "postalCode": "70173",
          "city": "Stuttgart",
          "countryCode": "DE"
        },
        "parcel": { "weightKg": 1.2, "lengthCm": 30, "widthCm": 20, "heightCm": 10 }
      }
    ]
  }'

curl -X POST "https://www.sendlabel.de/api/compat/ups/v1/shipments/import" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-SendLabel-Execution-Mode: dry_run" \
  -H "Idempotency-Key: lingxing-ups-dryrun-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "carrier": "UPS",
    "shipments": [
      {
        "reference": "LX-UPS-10001",
        "recipient": {
          "name": "Erika Mustermann",
          "street1": "Lindenstr. 5",
          "postalCode": "70173",
          "city": "Stuttgart",
          "countryCode": "DE"
        },
        "parcel": { "weightKg": 1.5, "lengthCm": 30, "widthCm": 20, "heightCm": 10 }
      }
    ]
  }'

Production-Validierung und Schutzmechanismen

Selbst wenn der API-Key Production-Scopes besitzt, blockiert der Server echte Erstellung weiterhin, solange der kontoweite Production-Schalter nicht freigegeben ist.

Fuer Kunden mit Bedarf an echten Versandtests empfehlen wir kontrollierte Live-Tests mit konfigurierbarer Auto-Revoke-Verzoegerung.

- Testkonten enthalten standardmaessig kein Production.

- Nur dedizierte Integrationstest-Konten sollten fuer Production-Validierung freigegeben werden.

- Auto-Revoke fuer Live-Test-Sendungen aktivieren, um laufende Kosten zu vermeiden.

Checkliste vor der Anbindung

Diese Checkliste eignet sich fuer das technische Kickoff vor Beginn der Implementierung.

- Bestaetigen, dass ein dediziertes Testkonto und kein Admin-Konto verwendet wird.

- Bestaetigen, ob DHL, UPS oder beide Kanaele benoetigt werden.

- Bestaetigen, dass Requests konsistent einen `Idempotency-Key` mitsenden.

- Bestaetigen, dass der Client zuerst das normierte `sendlabelError` auswertet.

- Bestaetigen, dass vor Production-Tests Auto-Revoke und Kostenkontrolle mit uns abgestimmt wurden.