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łówkuAuthorization: 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_idnie utworzy drugiego zamówienia.
Najważniejsze wywołania
GET papers | lista papierów i maksymalnych rozmiarów |
POST quote | wycena wydruków, pakowania i dostawy – bez plików |
POST orders | zamówienie z plikami (albo z zapisanym produktem) i adresem klienta |
GET orders/{id} | status, kwoty, numery przesyłek |
POST orders/{id}/cancel | anulowanie do 12:00 następnego dnia roboczego |
PATCH orders/{id}/shipping | zmiana adresu do chwili nadania |
POST test-orders | zamó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ę.
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.