Partnerstwo · przewodnik

API dla partnerów

API druku na żądanie: wycena, zamówienia z plikiem, statusy, numery przesyłek i powiadomienia. Klucz testowy i zamówienia testowe bez kosztów.

API jest dla sklepów na własnym systemie i serwisów, które generują grafiki (np. mapy, plakaty personalizowane). Klucze zakładasz w Panelu B2B → zakładka API: testowy od razu, produkcyjny po testach. Pełna dokumentacja z przykładami i formularzem testowym jest w panelu.

Podstawy

  • Adres: https://gicleo.com/wp-json/gcl/v1/partner/, klucz w nagłówku Authorization: Bearer gk_…, JSON, UTF-8, ceny brutto w PLN.
  • Pliki podajesz linkiem https: PDF, JPG, TIFF lub PNG. Drukujemy 1:1, bez kadrowania.
  • Ten sam external_id nie utworzy drugiego zamówienia.

Najważniejsze wywołania

GET paperslista papierów i maksymalnych rozmiarów
POST quotewycena wydruków, pakowania i dostawy – bez plików
POST orderszamówienie z plikami (albo z zapisanym produktem) i adresem klienta
GET orders/{id}status, kwoty, numery przesyłek
POST orders/{id}/cancelanulowanie do 12:00 następnego dnia roboczego
PATCH orders/{id}/shippingzmiana adresu do chwili nadania
POST test-orderszamówienie testowe przechodzące statusy – bez druku i kosztów

Wysyłka i statusy

Metody: kurier, paczkomat, Twoja etykieta (PDF) albo odbiór osobisty. Statusy: przyjęte → sprawdzanie plików → w produkcji → wysłane (z numerem przesyłki) → doręczone. O każdej zmianie powiadamiamy webhookiem podpisanym Twoim sekretem (HMAC-SHA256).

Rozliczenie

Na start każde zamówienie opłacasz przyciskiem „Zapłać”. Przy stałej współpracy – limit i faktura zbiorcza; zamówienia ponad limit czekają na wpłatę.

Otwórz Panel B2B ← Partnerstwo

Zostań partnerem

Załóż konto na gicleo.com i napisz do nas, co sprzedajesz i na jakiej platformie. Włączymy Ci Panel B2B i pomożemy połączyć sklep.

hello@gicleo.com Załóż konto