{{ message.head }}

{{ message.text }}

API LynkaHub · Integracja B2B

API LynkaHub: połącz swój system bezpośrednio z Lynka

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.

  • REST · JSON
  • Wersja 1.07
  • Dostępne środowisko testowe

Możliwości API

Cztery rzeczy, które Twój system może robić z Lynka

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.

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 /orders

Śledzenie statusu zamówienia

Ś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}

Sprawdzanie stanów magazynowych

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 /availability

Korekta znakowania

Jeś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

Od pierwszego wywołania do wysłanego zamówienia

Zamówienia przetwarzane są asynchronicznie: Twój system przekazuje zamówienie jednym wywołaniem, a wynik sprawdza kolejnym.

  1. Uzyskaj dostęp

    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.

  2. Złóż zamówienie

    Odpowiedź 202 potwierdza przyjęcie zamówienia do kolejki i zwraca correlationId — zapisz go.

  3. Sprawdź status

    Walidacja i przekazanie do produkcji odbywają się w tle. Sprawdzaj status — wystarczy raz na 15 minut.

  4. Odbierz numer przesyłki

    Po wysyłce status zmienia się na SHIPPED, a API zwraca numer przesyłki przewoźnika.

Statusy zamówień PENDING ACCEPTED SHIPPED REJECTED DUPLICATE FAILED

Endpointy

API w skrócie

Sześć endpointów pod adresem /api/v1. Pełne zasady walidacji pól, przykłady odpowiedzi i kody błędów znajdziesz w dokumentacji.

MetodaEndpointZastosowanie
GET/api/v1/healthSprawdzenie dostępności API (bez klucza API)
POST/api/v1/ordersZł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/availabilityStany magazynowe dla indeksów Lynka, ze stronicowaniem i filtrami

Przykład

Jak wygląda wywołanie

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" }

Przykłady są skrócone. Dokumentacja opisuje wszystkie pola, reguły walidacji i odpowiedzi błędów.

Zanim zaczniesz integrację

Warto wiedzieć

  • Bezpieczny dostępKażde żądanie jest weryfikowane na podstawie listy dozwolonych adresów IP oraz kodu klienta i klucza API przesyłanych w nagłówkach.
  • Przetwarzanie asynchroniczneOdpowiedź 202 oznacza „przyjęte”, a nie „poprawne”. Błędy w polach zwraca endpoint statusu.
  • Stany magazynowe co 3 godzinyPobieraj pełną listę lub tylko zmienione rekordy za pomocą modifiedAfter.
  • Najpierw środowisko testoweBudujesz i testujesz integrację w naszym środowisku testowym. Adres produkcyjny przekazujemy przed uruchomieniem.

FAQ

Pytania o API LynkaHub

Kto może korzystać z API LynkaHub?

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.

Jak uzyskać dane dostępowe do API?

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.

Jakie metody znakowania mogę zamówić przez API?

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).

Skąd mam wiedzieć, że zamówienie zostało poprawnie przetworzone?

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.

Jak aktualne są dane o stanach magazynowych?

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.

Czy jest dostępne środowisko testowe?

Tak. Każda integracja zaczyna się w środowisku testowym z testowymi danymi dostępowymi. Adres produkcyjny przekazujemy przed uruchomieniem.

Chcesz połączyć swój system?

Poproś o dostęp, a prześlemy Ci pełną dokumentację API LynkaHub (v1.07), testowe dane dostępowe i informacje o wdrożeniu.

Zaloguj się