All narrative and code from here on are in Slovenian, because the vast majority of UPN QR users and all online examples encountered so far are Slovenian. Despite this, a UPN QR version using English field markings is available in accordance with the translated standard.
When using the English translation, beware that the currency, decimal separators, and date formatting all remain unaltered Slovenian.
Pronunciation is /tsekin/.
Primeri
Nekaj primerov je vidnih v GIF oziroma v PDF.
Privzeti primer z vsemi možnimi in hkrati privzetimi argumenti se nahaja tudi v ./upn-qr/upn-qr.typ:
#import "@preview/cekinar:0.1.0": *
// Argumenti, ki so samo nizi, so prazni na način `""`, medtem ko je to drugod `none`/`bool`
#show: cekinar.with(
znesek: none, // Znesek (`none`, `int`, `float`, `decimal`)
datum: none, // Datum plačila (`none`, `datetime`)
rok: none, // Rok plačila (`none`, `datetime`)
nujno: false, // Stopnja nujnosti (`bool`)
polog: false, // Označitev pologa (`bool`)
dvig: false, // Označitev dviga (`bool`)
namen: ( // Namen plačila:
koda: "", // -> Koda namena (`str`)
opis: "", // -> Obrazložitev (`str`)
),
plačnik: ( // Plačnik, desno zgoraj na roza podlagi:
ime: "", // -> Ime plačnika (`str`)
ulica: "", // -> Ulica plačnika (`str`)
kraj: "", // -> Kraj plačnika (`str`)
iban: "", // -> IBAN plačnika (`str`)
referenca: "", // -> Referenca plačnika (`str`)
podpis: none, // -> Podpis plačnika (`none`, `content`)
),
prejemnik: ( // Prejemnik, desno spodaj na rumeni podlagi:
ime: "", // -> Ime prejemnika (`str`)
ulica: "", // -> Ulica prejemnika (`str`)
kraj: "", // -> Kraj prejemnika (`str`)
iban: "", // -> IBAN prejemnika (`str`)
referenca: "", // -> Referenca prejemnika (`str`)
),
logotip: ( // Oznaka trgovine oziroma tiskarja, desno spodaj na rumeni podlagi:
logo: none, // -> Logotip trgovine oziroma tiskarja (`none`, `content`)
naziv: "", // -> Naziv trgovine oziroma tiskarja (`str`)
),
možnosti: ( // Preklapljanje koristnih funkcionalnosti:
qr: false, // -> Koda QR (`bool`)
ročno: false, // -> Ročno ali strojno izpolnjevanje (`bool`, `dictionary`)
jezik: "sl", // -> Jezik predtiskanega besedila ("en", "sl")
nalog: "", // -> Vrsta naloga (druge možne vrednosti so naštete v Pomembno)
kamuflaža: "", // -> Dodaten A4, tretjino pokrit s kamuflažo ("", "redko", "sreda", "gosto")
vodni-žig: "", // -> Vodni žig (`str`)
postavitev: "A4/1", // -> Postavitev UPN QR ("", "A4/1", "A4/3")
prozorno: false, // -> Prozornost strani in predela potrdila (`bool`)
),
)
Sprememba vrednosti v slovarju možnosti lahko vpliva na skladnost s standardom.
Pomembno
Pisave:
- Privzeto sta glavna pisava in pisava za strojno izpolnjevanje enaki standardni Myriad Pro in Courier New:
myriad-pro-regular.otfinmyriad-pro-semibold.otf:- Povezave ni, ker licenca Adobe ni dopustna
courier-new-bold.ttf:- Povezave ni, ker licenca Monotype ni dopustna
- Pisavi Le Asterix in Le Obelix v standardu ponazarjata ročno izpolnjevanje:
- V paketu sploh nista uporabljeni, predvsem ker:
- Licenca ni dopustna
- Je par pisav preveč
- Vsebnost šumnikov ni razvidna
- V paketu sploh nista uporabljeni, predvsem ker:
- Ko pa katerakoli izmed privzetih pisav ni najdena, se uporabi nadomestna:
- Hind
hind-regular.ttfinhind-regular.ttf:- Glavna pisava, nadomestna za Myriad Pro
- Licenca SIL OFL 1.1
courier-prime-bold.ttf:- Strojno izpolnjevanje, nadomestno za Courier New
- Licenca SIL OFL 1.1
- Hind
- Za ponazoritev ročnega izpolnjevanja se vselej uporabi nadomestna pisava:
indie-flower-regular.ttf:- Ročno izpolnjevanje
- Licenca SIL OFL 1.1
Povzeto, za pravilno uporabo paketa so pričakovane posebej naložene pisave:
- Strojno izpolnjevanje (prvo ali drugo):
- Tri originalne pisave Myriad Pro Regular, Myriad Pro Semibold in Courier New Bold
- Tri nadomestne pisave Hind XYZ, Hind XYZ, in Courier Prime XYZ
- Ročno izpolnjevanje pričakuje pisavo Indie Flower
Neupoštevanje standarda v primeru pisave, ko je:
- Nenameščena:
- Typst Universe še nima mehanizma za upravljanje pisav:
- Uporabnik jih mora zagotoviti sam, posebej
- Typst Universe še nima mehanizma za upravljanje pisav:
- S kupno licenco:
- Vse pisave v UPN QR jo imajo:
- Ne morejo biti vključene v paket:
- V repozitoriju so zato nadomestne pisave:
- Prenos njihovih datotek poteka posebej
- V repozitoriju so zato nadomestne pisave:
- Ne morejo biti vključene v paket:
- Vse pisave v UPN QR jo imajo:
- Njena vdelava prepovedana:
- V Typstu je še ni možno izklopiti
- Javljena napaka pri izvozu PDF/A:
- Z danimi pisavami se to ne zgodi
Ročno izpolnjevanje se ne odraža v kodi QR. Vanjo je strogo vključeno strojno izpolnjeno.
Vsaka izmed štirih vrst vpeljanih nalogov ima izjemo, ki ni upoštevana, zato v teh primerih raje uporabite privzeti nalog brez omejitev "". Izjeme, po nalogih:
"plačilo-obveznosti": vpis reference je obvezen v primeru plačila obveznih dajatev in drugih javnofinančnih prihodkov (JFP), na primer dohodnin, DDV, prispevkov, glob, prekrškov in upravnih taks"registriran-izdajatelj": vpis imena, priimka, ulice in kraja plačnika ter zneska je neobvezen za registrirane izdajatelje UPN QR, na primer humanitarne dejavnosti"polog-gotovine": podpis in žig plačnika sta obvezna v odvisnosti od internih zahtev posameznega izdajatelja oziroma banke"dvig-gotovine": podpis in žig plačnika sta obvezna v odvisnosti od internih zahtev posameznega izdajatelja oziroma banke
Koda QR je vedno prikazana za nalog "registriran-izdajatelj".
Izpolnjevanje Rok plačila in Namen plačila mora biti enake vrste. Razlog za to odločitev je z vejico združen skupen izpis v predelu potrdila. V slovarju možnosti.ročno sta zaradi ohranitve doslednosti z drugimi vnosi njuna ključa vseeno ločena možnosti.ročno.rok in možnosti.ročno.namen.opis, namesto možnosti.ročno.rok-opis-namena.
Presledki se ne upoštevajo v dolžinah IBAN in referenc.
Šumniki in podobni znaki v dolžinah zavzemajo več kot eno mesto, razen izjemoma za ročno izpolnjevanje vpisnega polja Namen plačila. Iz standarda namreč ni dovolj razvidno, na katero dolžino se nanašajo znaki.
Funkcionalnosti
Kronološko:
- Cekinar v0.?.0 (prvotno za Typst v?.??.?):
- [ ] Izpolnitev vseh TODO-komentarjev
- [ ] Prikaz napak raje z opozorili
- [ ] UPN QR kot svoj element v Typstu
- [ ] Vdelani vnosi PDF preko obrazcev
- [ ] Prenos pisav kot del paketa
- [ ] Možnost izklopa vdelave pisave pri izvozu PDF
- Cekinar v0.1.0 (prvotno za Typst v0.15.1):
- [x] Upoštevanje standarda:
- [x] Dimenzije
- [x] Pisava:
- [x] Datoteke vseh originalnih in nadomestnih pisav
- [x] Barve:
- [x] Odtenki vseh barv Pantone in nadomestnih CMYK
- [x] QR
- [x] Izpolnjevanje:
- [x] Strojno
- [x] Ročno s samodejno poravnavo znakov v celice
- [x] Neodvisnost paketa
- [x] Omogočen izvoz PDF/UA-1
- [x] Dodatne nastavitve
- [x] Upoštevanje standarda:
S tem paketom proizveden UPN QR se v primerjavi z naključnim po vsej verjetnosti razlikuje:
- Logotip trgovine oziroma tiskarne v desnem spodnjem kotu
- Odtenek barv ozadja:
- Navadno opazno v zelo stisnjenih rastrskih formatih
- Prevod v angleščino, v kolikor je izbran:
- Drugod še nevideno
- Domnevna predhodna izvedba:
- Vsebuje več polj, kot je Izjava
- Položaji polj, oznak za skeniranje in oznak UPN QR so spremenjeni
- Besedila nad vpisnimi polji so spremenjena
- Velikost pisav izpolnjevanja v vpisnih poljih predela potrdila:
- Ime plačnika in Ime prejemnika, strojno in ročno izpolnjevanje:
- Dodeljena je nekoliko nestandardna najmanjša pisava, saj ju najdaljša kombinacija nizov pri uporabljeni standardni velikosti pisave vertikalno prelije za enkratnik velikosti pripadajočega vpisnega polja
- V potrdilu se pojavi hierarhija, kjer je izmed vseh treh uporabljenih velikosti pisav najbolj opazen znesek na sredini
- Znesek, strojno izpolnjevanje:
- Paket jo vpelje na podlagi standarda
- Ime plačnika in Ime prejemnika, strojno in ročno izpolnjevanje:
- V standardu neopredeljeni deli:
- Ločnice celic v mrežah:
- V angleškem se na slikah celo pojavijo črtkane
- Ločnica za mikroperforacijo:
- Njena prisotnost na slikah je nedosledna:
- Kadar je prisotna, lahko kot na Sliki 2 preseže meji UPN QR
- Najverjetneje zgolj tiskarju predstavlja mikroperforacijo
- Njena prisotnost na slikah je nedosledna:
- Obrobe:
- Poiskano v samih primerih UPN QR, kar zadeva debelino, gre za par različnih:
- Razvidni sta 0,221 pt in 0,443 pt, a primerjano s sicer definiranimi debelinami črt v standardu ju je smiselno zaokrožiti na 0,25 pt in 0,5 pt
- UPN QR jo ima na slikah standarda vedno tanko in temne barve:
- Najverjetneje zgolj tiskarju predstavlja robove
- Vpisna polja jo imajo na slikah vsa iste debeline in barve
- Koda QR jo ima na Sliki 2, vendar ni jasno, kam spada
- Poiskano v samih primerih UPN QR, kar zadeva debelino, gre za par različnih:
- Ločila:
- Pika med celicama mreže
- Vejica med celicama mreže:
- Ni označljivo, zato ne pripada nobeni vdelani pisavi:
- Najbolj se približa pogosti pisavi Helvetica Neue Black
- Ni označljivo, zato ne pripada nobeni vdelani pisavi:
- Paket jih vpelje na podlagi naključnega primerka
- Ločnice celic v mrežah:
Paket lahko opozarja na (zaenkrat javlja napako za):
- Neizpolnjena vpisna polja:
- Ob vklopu so za neobvezna javljena opozorila (zaenkrat ne), za obvezna pa napake:
- Pri tem se privzame, da bo vse izpolnjeno v Typstu, celo podpis, ki pa je vedno neobvezen
- Upošteva se vzajemno izključujočnost binarnih polj Polog in Dvig
- Ob vklopu so za neobvezna javljena opozorila (zaenkrat ne), za obvezna pa napake:
- Neskladnosti s standardom:
- Neustrezna pisava:
- Odstopanje datotek pisav od pričakovanih
- Neustrezna pisava:
Paket samodejno, brez možnosti izklopa, opozarja na (zaenkrat javlja napako za) pravilnost:
- Formatiranja:
- IBAN:
- Velike tiskane črke
- Referenc:
- Velike tiskane črke
- Vezaja v referenci SI (vedno javi napako)
- Zneska
- Datuma plačila
- Roka plačila
- Kode namena:
- Velike tiskane črke
- IBAN:
- Vnašanja:
- Kode namena
- IBAN
- Referenc
Paket ne:
- Spreminja vnosov uporabnika, razen morebitnih presledkov, novih vrstic, formata črk in formata zneska
- Preverja pravilnosti transakcije:
- Ujemanje podatkov
- Verification of Payee (VoP)
- Preverja zapisov okrajšav kot stalnih dodatkov ob imenih gospodarskih subjektov
Paket:
- Prepreči prelive izven dodeljenih vpisnih polj:
- Izjema so izredno dolgi nizi brez presledkov
- Ni namenjen izvozu HTML
- Naj bo uporabljen na lastno odgovornost:
- Zlasti ni zagotovil glede ustreznosti tiska, zato kot tiskar sami zagotovite ustrezne robove, barve in mikroperforacije
- Odsvetovano je razpošiljanje izvozov PDF in SVG, ki ju je preprosteje potvoriti v primerjavi s tiskom ali izvozom PNG
Viri
Sorodni Typst paketi:
Standard ZBS:
UPN QR v drugih paketih:
UPN QR v novicah:
Drugo
Nejasnosti, donacije ali morebitne spremembe naborov SEPA-IBAN, referenc SI in kod namena sporočite v predalniku Issues. Še posebej morebiten vpogled o neznanih barvah Pantone.
Priporočila:
- Paket lahko uporabite v kombinaciji s page bleed
- Če vas v ogledovalniku PDF moti sicer neobstoječa bela mreža na kodi QR, uporabite implementacijo iz paketa
zebra
Licenca
Obstoječi paketi ali templati kod QR na Typst Universe imajo celo licence GPL, zato je licenca EUPL-1.2 temu in jeziku primerna. Uporablja jo na primer paket ibanator.
