CloudPrint łączy ERP, WMS lub inny system biznesowy z drukarkami w biurze, sklepie albo magazynie. System źródłowy decyduje, co wydrukować, i przygotowuje dokument; CloudPrint kieruje go do wybranej lokalnej kolejki i zwraca wynik.
## Zacznij od zdarzenia biznesowego Twórz operację druku po jednoznacznym zdarzeniu: zwolnieniu zamówienia, zakończeniu kompletacji, przyjęciu towaru albo zatwierdzeniu dokumentu. Fakturę, dokument dostawy lub etykietę wygeneruj w ERP lub WMS przed wywołaniem CloudPrint. Reguły biznesowe pozostają w systemie źródłowym. ## Przypisz drukarki do miejsca i zadania Podczas konfiguracji wywołaj `GET /api/v1/printers`, pozwól administratorowi wybrać kolejkę dla magazynu, stanowiska i typu dokumentu, a następnie zapisz stabilny `printer_id`. Nazwa pomaga użytkownikowi, ale nie jest kluczem routingu. Nie wybieraj po cichu drukarki w innej lokalizacji. ## Dobierz format do kolejki Dla faktur, dokumentów magazynowych i stron używaj PDF. Polecenia urządzenia wysyłaj jako RAW: ZPL, TSPL lub CPCL do zgodnych drukarek etykiet, a ESC/POS do zgodnej drukarki paragonowej. Sprawdź możliwości kolejki; CloudPrint nie tłumaczy języków drukarek. ## Wysyłaj z zaufanego serwera Usługa integracyjna ERP lub WMS powinna wywoływać CloudPrint Public API ze środowiska serwerowego. Tam przechowuj dane dostępowe, nadawaj jeden stabilny `Idempotency-Key` operacji biznesowej i zapisuj własny identyfikator razem z `print_job_id`. ## Traktuj druk jako obserwowalny proces Śledź zadanie do `printed`, `failed` albo `cancelled`. Gdy agent lub drukarka jest niedostępna, pokaż oczekiwanie lub potrzebę interwencji zamiast tworzyć kolejną kopię. Ponowienie po błędzie sieci zachowuje klucz, a zatwierdzony dodruk jest nową operacją. ## Następne kroki