Druk paragonów ESC/POS z aplikacji
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.