Preskoči na sadržaj

MaxCode Direct Print

Priručnik za desktop aplikaciju i Odoo postavke

Povežite desktop print klijent, registrirajte pisače u Odoo-u, aktivirajte pisače, konfigurirajte izvještaje i opcionalnu automatizaciju te riješite najčešće probleme.

Pregled desktop aplikacije

Prije početka

Potrebno

  • Odoo korisnik s pristupom aplikaciji Print Direct.
  • Desktop računalo koje lokalno ili preko mreže vidi ciljni pisač.
  • MaxCode Print Client instaliran na tom desktop računalu.
  • Odoo URL, naziv baze, korisnički email i lozinka ili API ključ.

Preporučeno

  • Koristite API ključ kada Odoo korisnik ima uključenu dvofaktorsku autentifikaciju.
  • Tijekom uvođenja ostavite Odoo Auth Mode na Both.
  • Koristite stabilan Host ID, najčešće naziv uređaja.
  • Prvo testirajte jedan pisač prije uključivanja pravila automatizacije.

Postavljanje desktop aplikacije

  1. Otvorite MaxCode Print Client na računalu povezanom s pisačem.
  2. Otvorite karticu Connection.
  3. Unesite Host ID. Koristite Use device name osim ako trebate vlastiti stabilni identifikator. Isti Host ID Odoo koristi za povezivanje desktop aplikacije s host machine zapisom.
  4. Unesite Odoo URL, Database i Email.
  5. Unesite lozinku za websocket način rada ili Odoo API ključ za bearer polling.
  6. Postavite Connection Mode na auto za standardnu upotrebu.
  7. Kliknite Save, zatim Start.

Expected result: the status bar shows a connected state, and Odoo can receive host machine status from this desktop app.

Ekran povezivanja desktop aplikacije
Kartica Connection sadrži odabir profila, postavke pokretanja, Host ID, Odoo URL, bazu, email, Connection Mode i Password / API Key.

Vodič kroz desktop ekran

Status veze

Poruka iznad kartica prikazuje aktivni profil ili rezultat povezivanja. Uspješna bearer veza prikazuje Connected with bearer. Donja statusna traka treba prikazati i povezani Odoo URL.

Kontrole profila

Koristite New, Save, Save As i Delete za upravljanje različitim Odoo okruženjima. Spremite promjene prije klika na Start.

Kontrole pokretanja

Enable on startup pokreće aplikaciju zajedno s operacijskim sustavom. Hide to tray on close ostavlja aplikaciju aktivnom kada se prozor zatvori.

Connection Mode

Ostavite polje na auto osim ako podrška zatraži prisilni bearer ili websocket. Auto omogućuje aplikaciji da slijedi konfiguraciju Odoo modula.

Password / API Key

Za bearer polling unesite Odoo API ključ. Za websocket način rada unesite korisničku lozinku. Show koristite samo kada trebate provjeriti vrijednost.

Dijagnostika

Koristite Copy diagnostics, Open log file i Clear logs iz donje trake kada rješavate problem povezivanja ili ispisa.

Kartica pisača u desktop aplikaciji
Kartica Printers prikazuje pisače koje desktop računalo vidi. To su pisači koje Odoo može zatražiti akcijom Fetch and Add Printers.

Načini povezivanja

Auto je preporučena opcija. Desktop aplikacija pita Odoo koji su načini podržani i odabire najbolju opciju.

Način Kada koristiti
Auto Zadani izbor. Pojednostavljuje postavljanje i prati konfiguraciju Odoo modula.
Bearer polling Najbolje za korisnike s uključenim 2FA. Koristi API ključ i ne ovisi o browser session loginu.
Websocket Koristite za starije desktop aplikacije ili instalacije koje još koriste legacy session-based tijek.
Odabir načina povezivanja
Connection Mode može ostati na auto ili se može prisilno postaviti za potrebe podrške.

Odoo postavke

1. Konfigurirajte Auth Mode

  1. Otvorite Print Direct / Configuration / Settings.
  2. Postavite Auth Mode na Both tijekom migracije ili prvog uvođenja.
  3. Koristite Bearer Polling samo ako želite isključiti legacy websocket/session endpointe.
  4. Koristite Websocket samo ako ne želite API-key polling.

2. Registrirajte ili otvorite Host Machine

  1. Otvorite Print Direct / Host Machine.
  2. Pokrenite desktop aplikaciju kako bi mogla registrirati ili ažurirati host machine.
  3. Otvorite host machine zapis i provjerite Host ID, platformu, tvrtke i dodijeljene korisnike.
  4. Kliknite Refresh Status kada trebate zatražiti svježe sistemske informacije.

3. Dohvatite pisače

  1. Ostavite desktop aplikaciju pokrenutu i povezanu.
  2. Otvorite odgovarajući host machine u Odoo-u.
  3. Kliknite Fetch and Add Printers.
  4. Pričekajte da desktop aplikacija vrati listu lokalnih pisača.
Odoo Print Direct Auth Mode postavka
Print Direct postavke uključuju Auth Mode. Both zadržava websocket kompatibilnost i omogućuje bearer polling za desktop klijente s API ključem.
Odoo host machine ekran
Host Machine forma prikazuje Fetch and Add Printers, Refresh Status, online/offline stanje, dodijeljene korisnike, tvrtke, platformu, verziju aplikacije i dohvaćenu listu pisača.

Vodič kroz Odoo ekrane

Host Machine kanban

Host Machine stranica prikazuje svaku registriranu desktop aplikaciju kao karticu. Online/offline oznaka pomaže prepoznati koje su desktop aplikacije trenutno dostupne za dohvat pisača i print jobove.

Auth Mode postavka

Settings stranica sadrži Auth Mode. Both je najsigurnija produkcijska postavka tijekom uvođenja jer stari websocket klijenti i novi bearer polling klijenti mogu raditi istovremeno.

Host Machine forma

Koristite Fetch and Add Printers za zahtjev lokalnih pisača iz desktop aplikacije. Koristite Refresh Status za ažurirane informacije o hostu.

Kartica pisača

Nakon dohvata, tablica pisača prikazuje naziv pisača, sučelje, stanje i tip pisača. Pisač označen kao Inactive treba otvoriti, konfigurirati i aktivirati.

Configuration meni

Configuration meni sadrži Reports, Settings, Default Printer for Attachment, Printing Automation, Attachment Print Rules i administratorske cron zapise.

Lista Print Jobs

Print Jobs koristite za provjeru što je Odoo poslao desktop aplikaciji. Uspješan posao ima stanje Sent ili Done, ovisno o verziji modula i tijeku rada.

Odoo host machine kanban
Host Machine pregled pomaže podršci brzo usporediti Host ID-eve i online/offline stanje.

Aktivacija pisača

Dohvaćeni pisači nisu spremni dok se ne konfiguriraju i aktiviraju. Time se sprječava da Odoo šalje poslove na nepoznat ili pogrešno tipiziran pisač.

  1. Otvorite Print Direct / Printer.
  2. Otvorite pisač kreiran dohvatom s host machine zapisa.
  3. Odaberite ispravan Printer Type. Screenshotovi prikazuju primjere kao PDF and Image i ESCPOS.
  4. Za Windows image printing po potrebi provjerite širinu i visinu papira.
  5. Karticu Reports koristite za povezivanje izvještaja s pisačem.
  6. Kliknite Set Active.
  7. Za ZPL ili ESCPOS kliknite Test Printer prije produkcijske upotrebe.

Expected result: the printer state is Active. Inactive printers should not be used for real print jobs.

Odoo neaktivni pisač prije aktivacije
Neaktivni pisač prikazuje Set Active. Aktivni pisač prikazuje Set Inactive i može se koristiti za izvještaje i print jobove.
Odoo aktivni pisač nakon aktivacije
Nakon aktivacije pisač ima odabrani Printer Type i može primati odgovarajuće izvještaje ili print jobove.

Dodatne Odoo opcije

Izvještaji

Otvorite Print Direct / Configuration / Reports. Dodijelite ispravan tip pisača svakom Odoo izvještaju. Ako izvještaj nije vidljiv na pisaču, provjerite tip pisača na izvještaju.

Zadani pisač za privitke

Otvorite Print Direct / Configuration / Default Printer for Attachment. Konfigurirajte koji pisač obrađuje PDF, slike, ZPL ili druge tipove privitaka po tvrtki.

Pravila automatskog ispisa

Otvorite Print Direct / Configuration / Printing Automation. Koristite ova pravila kada Odoo treba automatski ispisivati nakon radnji kao što su potvrda prodaje, validacija dostave, potvrda nabave ili knjiženje računa.

Pravila ispisa privitaka

Otvorite Print Direct / Configuration / Attachment Print Rules. Filterima odredite koji se privitci trebaju automatski ispisati nakon kreiranja.

Print jobovi

Otvorite Print Direct / Print Jobs za pregled poslova koji čekaju, završenih ili neuspješnih poslova. Koristite Retry nakon rješavanja problema s pisačem ili vezom.

Zakazane akcije

Administratori mogu otvoriti skrivene cron postavke za osvježavanje informacija o hostu, ponovno slanje obavijesti za poslove u redu čekanja ili čišćenje starih print jobova. Ostavite zadane vrijednosti osim ako podrška zatraži promjene.

Odoo Print Direct configuration meni
Configuration meni grupira postavke izvještaja, postavke modula, zadane pisače za privitke, automatizaciju ispisa, pravila ispisa privitaka i cron alate.

Test ispisa

  1. Provjerite da je desktop aplikacija povezana.
  2. Otvorite karticu Printers u desktop aplikaciji i provjerite da je očekivani pisač na listi.
  3. Provjerite da je pisač Active.
  4. Za ZPL ili ESCPOS pisače koristite Test Printer iz zapisa pisača.
  5. Za izvještaje otvorite poslovni zapis i pokrenite konfiguriranu report akciju.
  6. Otvorite Print Direct / Print Jobs i provjerite da posao prelazi u Sent ili Done.
Production checklist: test one manual print first, then one real report print, then enable auto print rules only after both work.
Odoo lista Print Jobs
Lista Print Jobs je operativni audit trag za generirane poslove, odabrane pisače, tip ispisa i konačno stanje.

Rješavanje problema

Problem Što provjeriti
2FA korisnik se ne može povezati Koristite bearer polling s Odoo API ključem. Ostavite Odoo Auth Mode na Both ili Bearer Polling.
Fetch Printers ne radi ništa Provjerite status desktop aplikacije, Host ID, prava API ključa i je li Odoo modul nadograđen nakon instalacije.
Pisač se pojavi, ali ne ispisuje Otvorite zapis pisača, postavite Printer Type, kliknite Set Active i zatim ponovno testirajte.
Izvještaj nedostaje u konfiguraciji pisača Otvorite Configuration / Reports i dodijelite ispravan tip pisača izvještaju.
Print jobovi ostaju u redu čekanja Provjerite da odabrani pisač pripada povezanom host machine zapisu i da desktop aplikacija može pristupiti Odoo-u.
Potrebni su podaci za podršku Koristite Copy diagnostics i Open log file u statusnoj traci desktop aplikacije.