CloudPrint drukuje etykietę wysyłkową utworzoną wcześniej przez przewoźnika, platformę handlową lub system wysyłkowy. Nie kupuje przesyłki, nie wybiera taryfy i nie generuje numeru śledzenia; dostarcza gotowy PDF albo zgodne dane RAW do właściwej drukarki.
## Najpierw utwórz przesyłkę Pobierz gotową etykietę z API przewoźnika lub platformy wysyłkowej. Następnie przekaż ją jako PDF, publiczny adres HTTPS albo dane RAW w języku ZPL, TSPL lub CPCL. Przewoźnik odpowiada za przesyłkę i etykietę, a CloudPrint za jej wydruk. ## Wybierz PDF albo język RAW etykiety PDF można łatwo obejrzeć, lecz kolejka potrzebuje druku systemowego lub mechanizmu renderowania. Dla RAW ustaw `document_format=raw` oraz dokładny `document_raw_language`: `zpl`, `tspl` lub `cpcl`. Wybrana drukarka musi zgłaszać ten język i obsługę RAW. ## Przypisz stanowiska Zapisz `printer_id` dla stanowiska pakowania lub procesu. Nazwę pokaż użytkownikowi, lecz wybieraj drukarkę według identyfikatora. Gdy drukarka jest niedostępna, zatrzymaj proces i poproś o jawny wybór, aby etykieta klienta nie trafiła do innego magazynu. ## Dopasuj nośnik i kod Strona musi odpowiadać fizycznej etykiecie; w razie potrzeby podaj `media_width_mm`, `media_height_mm` i `dpi`. Skalibruj czujnik, gęstość i szybkość druku. Przed uruchomieniem wydrukuj i zeskanuj rzeczywiste próbki, ponieważ API nie naprawi uciętego kodu. ## Oddziel ponowienie żądania od ponownego wydruku `Idempotency-Key` buduj z identyfikatora przesyłki, typu etykiety i wersji operacji. Ponowienie żądania po przekroczeniu limitu czasu zachowuje klucz. Świadoma druga kopia otrzymuje nowy klucz oraz informację o operatorze i powodzie. Przetestuj wyłączenie agenta, niedostępną drukarkę, brak nośnika i ponowne uruchomienie stanowiska. ## Następne kroki