Drukowanie etykiet wysyłkowych z aplikacji
CloudPrint drukuje etykietę wysyłkową utworzoną wcześniej przez przewoźnika, marketplace lub system shippingowy. Nie kupuje przesyłki, nie wybiera taryfy i nie generuje tracking number; dostarcza gotowy PDF lub ZPL do właściwej drukarki.
Najpierw utwórz przesyłkę
Pobierz finalną etykietę z API przewoźnika lub platformy wysyłkowej. Następnie przekaż PDF, publiczny adres HTTPS albo ZPL do CloudPrint. Takie rozdzielenie nie myli API przewoźnika z API transportującym dokument do drukarki.
Wybierz PDF albo ZPL
PDF można łatwo obejrzeć, lecz kolejka potrzebuje druku systemowego lub renderera. ZPL jest wydajne dla zgodnej Zebra, ale wymaga document_format=raw, document_raw_language=zpl, profilu ZPL i RAW passthrough.
Przypisz stanowiska
Zapisz printer_id dla stanowiska pakowania lub procesu. Nazwę pokaż człowiekowi, lecz routuj po ID. Gdy drukarka jest offline, 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, darkness i szybkość. Przed produkcją wydrukuj i zeskanuj realne próbki, bo API nie naprawi uciętego kodu.
Oddziel retry od reprintu
Idempotency-Key buduj z ID przesyłki, typu etykiety i wersji operacji. Retry po timeout zachowuje klucz. Świadoma druga kopia dostaje nowy klucz, operatora i powód. Przetestuj wyłączenie agenta, offline, brak nośnika i restart stanowiska.
Lista kontrolna przed wdrożeniem
- Sprawdzaj format dokumentu, rozmiar strony i orientację przed utworzeniem zadania.
- Skalibruj rozmiar etykiety oraz sprawdź sterownik i kolejkę drukarki.
- Zapisuj stabilny identyfikator drukarki, a nie tylko jej nazwę.
- Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.