Drukowanie etykiet wysyłkowych z aplikacji
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.