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 /ordersLynkaHub API · B2B-Integration
Ü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.
Funktionsumfang
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.
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 /ordersVerfolgen 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}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 /availabilityWird 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
Aufträge werden asynchron verarbeitet: Ihr System übergibt den Auftrag mit einem Aufruf und fragt das Ergebnis mit einem weiteren ab.
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.
Die Antwort 202 bestätigt, dass der Auftrag in der Warteschlange ist, und liefert eine correlationId — speichern Sie diese.
Validierung und Übergabe an die Produktion erfolgen im Hintergrund. Fragen Sie den Status ab — alle 15 Minuten genügt.
Nach dem Versand wechselt der Status zu SHIPPED und die Sendungsnummer des Versanddienstleisters wird übermittelt.
Endpunkte
Sechs Endpunkte unter /api/v1. Alle Feldregeln, Antwortbeispiele und Fehlercodes finden Sie in der Dokumentation.
| Methode | Endpunkt | Zweck |
|---|---|---|
| GET | /api/v1/health | Prüfen, ob die API erreichbar ist (kein API-Schlüssel nötig) |
| POST | /api/v1/orders | Neuen 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/availability | Lagerverfügbarkeit je Lynka-SKU, paginiert und filterbar |
Beispiel
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" }
GET /api/v1/orders/f9d72f25-7e0d-4ddd-9256-4c7a3ad5dde0
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
// 200 OK
{
"orderNo": "ORD-2026-00123",
"status": "SHIPPED",
"validationErrors": null,
"decorationErrors": null,
"trackingNumbers": "00340434161094042557"
}
GET /api/v1/availability?limit=1000&offset=0&onlyAvailable=true
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
// 200 OK
{
"total": 16269,
"items": [
{
"lynkaSKU": "XXX/00512/03",
"availabilityQtyLynka": "10.0000",
"availabilityQtyVend": "100.0000",
"lastModifiedDateTime": "2026-08-03T14:45:00Z"
}
]
}
Die Beispiele sind gekürzt. Die Dokumentation beschreibt alle Felder, Validierungsregeln und Fehlerantworten.
Vor der Integration
202 bedeutet „empfangen“, nicht „gültig“. Feldfehler meldet der Status-Endpunkt.modifiedAfter nur geänderte Datensätze.FAQ
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.
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.
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.
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.
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.
Ja. Jede Integration beginnt in der Testumgebung mit Test-Zugangsdaten. Die Produktiv-URL erhalten Sie vor dem Go-live.
Fragen Sie den Zugang an — wir senden Ihnen die vollständige Dokumentation der LynkaHub API (v1.07), Test-Zugangsdaten und Informationen zum Onboarding.