Składanie zamówień
Przesyłaj zamówienia z danymi do wysyłki, indeksami Lynka (SKU) i danymi znakowania — haft, sitodruk, druk cyfrowy lub transfer — dla pozycji standardowych, druku na żądanie (POD) i towarów z magazynu.
POST /ordersAPI LynkaHub · Integracja B2B
Składaj zamówienia na znakowaną odzież, śledź ich status i wysyłkę oraz sprawdzaj aktualne stany magazynowe bezpośrednio ze swojego systemu ERP, platformy e-commerce lub systemu obsługi zamówień. Bez ręcznego wgrywania plików i przepisywania danych — jedno REST API dla Twoich zamówień w Lynka.
Możliwości API
API LynkaHub powstało z myślą o dystrybutorach, resellerach i markach, które regularnie zamawiają w Lynka odzież z nadrukiem lub haftem i chcą, by te zamówienia trafiały do nas automatycznie.
Przesyłaj zamówienia z danymi do wysyłki, indeksami Lynka (SKU) i danymi znakowania — haft, sitodruk, druk cyfrowy lub transfer — dla pozycji standardowych, druku na żądanie (POD) i towarów z magazynu.
POST /ordersŚledź każde zamówienie od przyjęcia do wysyłki. Status pokazuje, czy zamówienie zostało przyjęte, wymaga poprawki, czy zostało wysłane — wraz z numerem przesyłki przewoźnika.
GET /orders/{id}Pobieraj dostępność indeksów z Twojego katalogu — w magazynie Lynka i u dostawcy — w całości lub przyrostowo. Dane odświeżane są co 3 godziny.
GET /availabilityJeśli odrzucona zostanie pojedyncza linia znakowania, popraw i wyślij ponownie tylko ją. Reszta zamówienia jest realizowana dalej — nie trzeba składać go od nowa.
PUT …/decorations/{code}Jak to działa
Zamówienia przetwarzane są asynchronicznie: Twój system przekazuje zamówienie jednym wywołaniem, a wynik sprawdza kolejnym.
Prześlij nam publiczne adresy IP, z których będzie łączył się Twój system. Dodamy je do listy dozwolonych adresów i wydamy Twój kod klienta oraz klucz API.
Odpowiedź 202 potwierdza przyjęcie zamówienia do kolejki i zwraca correlationId — zapisz go.
Walidacja i przekazanie do produkcji odbywają się w tle. Sprawdzaj status — wystarczy raz na 15 minut.
Po wysyłce status zmienia się na SHIPPED, a API zwraca numer przesyłki przewoźnika.
Endpointy
Sześć endpointów pod adresem /api/v1. Pełne zasady walidacji pól, przykłady odpowiedzi i kody błędów znajdziesz w dokumentacji.
| Metoda | Endpoint | Zastosowanie |
|---|---|---|
| GET | /api/v1/health | Sprawdzenie dostępności API (bez klucza API) |
| POST | /api/v1/orders | Złożenie nowego zamówienia z pozycjami i danymi znakowania |
| GET | /api/v1/orders/{correlationId} | Status pojedynczego zgłoszenia, w tym błędy i numery przesyłek |
| GET | /api/v1/orders?orderNo=… | Pełna historia zgłoszeń dla jednego numeru zamówienia |
| PUT | /api/v1/orders/{correlationId}/lines/{lineNo}/decorations/{externalDesignCode} | Zastąpienie odrzuconej linii znakowania poprawionymi danymi |
| GET | /api/v1/availability | Stany magazynowe dla indeksów Lynka, ze stronicowaniem i filtrami |
Przykład
Standardowe żądania HTTPS z danymi w formacie JSON — połączenie nawiąże każdy język programowania lub platforma integracyjna obsługująca HTTP.
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",
// … pozostałe pola adresu dostawy
"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"
}
]
}
Przykłady są skrócone. Dokumentacja opisuje wszystkie pola, reguły walidacji i odpowiedzi błędów.
Zanim zaczniesz integrację
202 oznacza „przyjęte”, a nie „poprawne”. Błędy w polach zwraca endpoint statusu.modifiedAfter.FAQ
API jest dostępne dla klientów biznesowych Lynka — dystrybutorów, resellerów, agencji reklamowych i marek — którzy chcą przesyłać zamówienia i pobierać stany magazynowe ze swoich systemów. Dostęp przyznajemy indywidualnie po krótkim wdrożeniu.
Skontaktuj się z nami i prześlij publiczne adresy IP, z których będzie łączył się Twój system. Dodamy je do listy dozwolonych adresów i wydamy Twój X-Client-Code oraz X-Api-Key. Klucz jest wyświetlany tylko raz, więc przechowuj go bezpiecznie — w razie utraty wydamy nowy.
Pozycje zamówienia mogą zawierać dane znakowania dla haftu, sitodruku, druku cyfrowego, transferu i szycia — wraz z miejscem znakowania, wymiarami w centymetrach, liczbą kolorów lub ściegów, kolorami Pantone i linkami do plików graficznych. Pozycje mogą być typu Standard, druk na żądanie (POD) lub towar z magazynu (Stock).
Po złożeniu zamówienia otrzymujesz correlationId. Na jego podstawie sprawdzisz status: ACCEPTED oznacza, że zamówienie trafiło do produkcji, SHIPPED — że zostało wysłane i ma numer przesyłki, a REJECTED zawiera listę pól do poprawy. Powiadomienia zwrotne (callback) nie są jeszcze dostępne — zalecamy sprawdzanie statusu raz na 15 minut dla każdego zamówienia.
Stany magazynowe odświeżane są co 3 godziny i pokazują ilości w magazynie Lynka oraz u dostawcy dla indeksów z Twojego katalogu. Jedno pełne pobranie co kilka godzin lub wywołanie przyrostowe dla zmienionych rekordów wystarczy, by Twój sklep był aktualny.
Tak. Każda integracja zaczyna się w środowisku testowym z testowymi danymi dostępowymi. Adres produkcyjny przekazujemy przed uruchomieniem.
Poproś o dostęp, a prześlemy Ci pełną dokumentację API LynkaHub (v1.07), testowe dane dostępowe i informacje o wdrożeniu.