{{ message.head }}

{{ message.text }}

LynkaHub API · B2B-Integration

LynkaHub API: Verbinden Sie Ihr System direkt mit Lynka

Übermitteln Sie Aufträge für veredelte Textilien, verfolgen Sie Status und Versand und prüfen Sie die aktuelle Lagerverfügbarkeit direkt aus Ihrem ERP-System, Ihrer E-Commerce-Plattform oder Ihrem Auftragsmanagement. Kein manueller Upload, keine doppelte Dateneingabe — eine REST-API für Ihre Aufträge bei Lynka.

  • REST · JSON
  • Version 1.07
  • Testumgebung verfügbar

Funktionsumfang

Vier Dinge, die Ihr System mit Lynka erledigen kann

Die LynkaHub API richtet sich an Distributoren, Wiederverkäufer und Marken, die regelmäßig veredelte Textilien bei Lynka bestellen und diese Aufträge automatisiert übermitteln möchten.

Aufträge übermitteln

Senden Sie Aufträge mit Versanddaten, Lynka-Artikelnummern (SKU) und Veredelungsdaten — Stickerei, Siebdruck, Digitaldruck oder Transfer — für Standard-, Print-on-Demand- und Lagerpositionen.

POST /orders

Auftragsstatus verfolgen

Verfolgen Sie jeden Auftrag vom Eingang bis zum Versand. Der Status zeigt, ob er angenommen wurde, korrigiert werden muss oder versandt wurde — inklusive Sendungsnummer des Versanddienstleisters.

GET /orders/{id}

Lagerverfügbarkeit prüfen

Laden Sie die Verfügbarkeit der Artikel in Ihrem Sortiment herunter — im Lynka-Lager und beim Lieferanten — vollständig oder inkrementell, alle 3 Stunden aktualisiert.

GET /availability

Veredelungen korrigieren

Wird eine einzelne Veredelungsposition abgelehnt, korrigieren und senden Sie nur diese erneut. Der Rest des Auftrags läuft weiter — eine komplette Neuübermittlung ist nicht nötig.

PUT …/decorations/{code}

So funktioniert es

Vom ersten Aufruf bis zum versandten Auftrag

Aufträge werden asynchron verarbeitet: Ihr System übergibt den Auftrag mit einem Aufruf und fragt das Ergebnis mit einem weiteren ab.

  1. Zugang erhalten

    Senden Sie uns die öffentlichen IP-Adressen, von denen Ihr System zugreift. Wir schalten sie frei und stellen Ihnen Ihren Kundencode und API-Schlüssel aus.

  2. Auftrag übermitteln

    Die Antwort 202 bestätigt, dass der Auftrag in der Warteschlange ist, und liefert eine correlationId — speichern Sie diese.

  3. Status abfragen

    Validierung und Übergabe an die Produktion erfolgen im Hintergrund. Fragen Sie den Status ab — alle 15 Minuten genügt.

  4. Sendungsnummer erhalten

    Nach dem Versand wechselt der Status zu SHIPPED und die Sendungsnummer des Versanddienstleisters wird übermittelt.

Auftragsstatus PENDING ACCEPTED SHIPPED REJECTED DUPLICATE FAILED

Endpunkte

Die API im Überblick

Sechs Endpunkte unter /api/v1. Alle Feldregeln, Antwortbeispiele und Fehlercodes finden Sie in der Dokumentation.

MethodeEndpunktZweck
GET/api/v1/healthPrüfen, ob die API erreichbar ist (kein API-Schlüssel nötig)
POST/api/v1/ordersNeuen Auftrag mit Positionen und Veredelungsdaten übermitteln
GET/api/v1/orders/{correlationId}Status einer einzelnen Übermittlung inkl. Fehlern und Sendungsnummern
GET/api/v1/orders?orderNo=…Vollständiger Verlauf aller Übermittlungen zu einer Auftragsnummer
PUT/api/v1/orders/{correlationId}/lines/{lineNo}/decorations/{externalDesignCode}Abgelehnte Veredelungsposition durch korrigierte Daten ersetzen
GET/api/v1/availabilityLagerverfügbarkeit je Lynka-SKU, paginiert und filterbar

Beispiel

So sieht ein Aufruf aus

Standard-HTTPS-Anfragen mit JSON-Daten — jede Programmiersprache oder Integrationsplattform, die HTTP-Anfragen senden kann, lässt sich anbinden.

POST /api/v1/orders
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
Content-Type: application/json

{
  "orderNo": "ORD-2026-00123",
  "shipToName": "John Smith",
  "shipToCountryCode": "PL",
  // … weitere Versandfelder
  "orderLines": [
    {
      "lineNo": 10000,
      "itemNo": "TBC/TU01T/001/3",
      "quantity": 5,
      "orderType": "Standard",
      "designCode": "NZ02033-26-P00062",
      "decorationLines": [
        { "externalDesignCode": "NZ02033-26-P00062", "decorationType": "Embroidery" }
      ]
    }
  ]
}

// 202 Accepted
{ "correlationId": "f9d72f25-7e0d-4ddd-9256-4c7a3ad5dde0", "status": "NEW" }

Die Beispiele sind gekürzt. Die Dokumentation beschreibt alle Felder, Validierungsregeln und Fehlerantworten.

Vor der Integration

Gut zu wissen

  • Gesicherter ZugangJede Anfrage wird anhand Ihrer freigegebenen IP-Adressen sowie des Kundencodes und API-Schlüssels in den Headern geprüft.
  • Asynchrone VerarbeitungEin 202 bedeutet „empfangen“, nicht „gültig“. Feldfehler meldet der Status-Endpunkt.
  • Bestandsdaten alle 3 StundenLaden Sie die vollständige Liste oder mit modifiedAfter nur geänderte Datensätze.
  • Zuerst die TestumgebungSie entwickeln und testen in unserer Testumgebung. Die Produktiv-URL erhalten Sie vor dem Go-live.

FAQ

Fragen zur LynkaHub API

Wer kann die LynkaHub API nutzen?

Die API steht Lynka-Geschäftskunden zur Verfügung — Distributoren, Wiederverkäufern, Werbeagenturen und Marken —, die Aufträge senden und Bestandsdaten aus ihren eigenen Systemen abrufen möchten. Der Zugang wird pro Kunde nach einem kurzen Onboarding freigeschaltet.

Wie erhalte ich API-Zugangsdaten?

Kontaktieren Sie uns und senden Sie die öffentlichen IP-Adressen, von denen Ihr System zugreift. Wir schalten sie frei und stellen Ihren X-Client-Code und X-Api-Key aus. Der Schlüssel wird nur einmal angezeigt — bewahren Sie ihn sicher auf. Geht er verloren, stellen wir einen neuen aus.

Welche Veredelungsarten kann ich über die API bestellen?

Auftragspositionen können Veredelungsdaten für Stickerei, Siebdruck, Digitaldruck, Transfer und Nähen enthalten — mit Platzierung, Größe in Zentimetern, Anzahl der Farben oder Stiche, Pantone-Angaben und Links zu Druckdaten. Positionen können vom Typ Standard, Print-on-Demand (POD) oder Lagerware (Stock) sein.

Woran erkenne ich, dass ein Auftrag korrekt verarbeitet wurde?

Nach der Übermittlung erhalten Sie eine correlationId. Damit fragen Sie den Status ab: ACCEPTED bedeutet, dass der Auftrag in der Produktion angekommen ist, SHIPPED, dass er mit Sendungsnummer unterwegs ist, und REJECTED listet die zu korrigierenden Felder auf. Callbacks gibt es noch nicht — wir empfehlen eine Abfrage alle 15 Minuten pro Auftrag.

Wie aktuell sind die Verfügbarkeitsdaten?

Die Verfügbarkeit wird alle 3 Stunden aktualisiert und zeigt die Mengen im Lynka-Lager und beim Lieferanten für die Artikel in Ihrem Sortiment. Ein vollständiger Abruf alle paar Stunden oder ein inkrementeller Abruf geänderter Datensätze hält Ihren Shop aktuell.

Gibt es eine Testumgebung?

Ja. Jede Integration beginnt in der Testumgebung mit Test-Zugangsdaten. Die Produktiv-URL erhalten Sie vor dem Go-live.

Bereit, Ihr System anzubinden?

Fragen Sie den Zugang an — wir senden Ihnen die vollständige Dokumentation der LynkaHub API (v1.07), Test-Zugangsdaten und Informationen zum Onboarding.

Anmelden