CloudPrint dostarcza przygotowane dane ESC/POS z systemu sprzedażowego, sklepu internetowego lub aplikacji biznesowej do zgodnej lokalnej drukarki paragonowej. Przekazuje polecenia i raportuje status, ale nie rejestruje sprzedaży, nie obsługuje urządzenia fiskalnego i nie tworzy prawnie wymaganego paragonu fiskalnego.
## Oddziel wydruk od fiskalizacji Dane paragonu przygotuj dopiero po zakończeniu operacji sprzedaży lub zamówienia. Jeżeli prawo wymaga kasy fiskalnej, podpisu albo raportowania podatkowego, wykonaj te czynności w certyfikowanym systemie fiskalnym. CloudPrint może wydrukować przygotowany dokument dla klienta lub obsługi, lecz nie zastępuje fiskalizacji. ## Przygotuj bajty ESC/POS w aplikacji Wygeneruj tekst, kody kreskowe, QR, wysuw papieru i cięcie zgodnie z poleceniami obsługiwanymi przez model. Sprawdź kodowanie, stronę kodową oraz rzeczywistą szerokość papieru 58 lub 80 mm. CloudPrint przekazuje strumień bez zmian i nie naprawia nieobsługiwanych znaków. ## Jawnie zadeklaruj język Prześlij dane z `document_format=raw` i `document_raw_language=escpos`. Przed utworzeniem zadania wywołaj `GET /api/v1/printers` i potwierdź, że kolejka ogłasza `escpos` w `capabilities.language_profiles` oraz dostępny kanał RAW. ## Przypisz właściwą drukarkę Zapisz stabilny `printer_id` dla każdej kasy, punktu odbioru lub stanowiska kuchennego. Gdy jedno zamówienie tworzy kilka dokumentów, określ każdą trasę osobno. Nie wybieraj wyłącznie po nazwie kolejki i nie przenoś paragonu do innego punktu bez decyzji operatora. ## Zapobiegaj przypadkowym duplikatom Używaj jednego `Idempotency-Key` dla zamierzonego wydruku i zapisuj zwrócony `print_job_id`. Śledź status do `printed`, `failed` lub `cancelled`. Ponowienie po timeout zachowuje klucz i dane; świadoma druga kopia jest nowym, rejestrowanym dodrukiem. ## Następne kroki