IPS QR Code Generator

Šta je ovo?

ips-qr-code je jednostavna CLI aplikacija za generisanje IPS QR kodova. NBS IPS

Instalacija

$ npm i -g ips-qr-code

Primer korišćenja

Note: Broj bankovnog racuna iz primera je nepostojeci

Data URI:

$ ips-qr-code --naziv-platioca "@artbit" --racun-platioca "123456789012345678" --naziv-primaoca "GitHub Ltd," --racun-primaoca "123456789012345678" --sifra-placanja "221" --iznos "RSD1," --svrha-placanja "Example usage" --to-datauri
$ data:image/png;base64,iVBORw0KGg...SUVORK5CYII=

Slika:

$ ips-qr-code --naziv-platioca "@artbit" --racun-platioca "123456789012345678" --naziv-primaoca "GitHub Ltd," --racun-primaoca "123456789012345678" --sifra-placanja "221" --iznos "RSD1," --svrha-placanja "Example usage" --to-file example.png

Terminal:

$ ips-qr-code --naziv-platioca "@artbit" --racun-platioca "123456789012345678" --naziv-primaoca "GitHub Ltd," --racun-primaoca "123456789012345678" --sifra-placanja "221" --iznos "RSD1," --svrha-placanja "Example usage" --to-text

Kao biblioteka

ips-qr-code je napisana kao CLI aplikacija, ali može da se koristi i kao biblioteka, sa doduše malo kriptičnim API-jem jer koristi skraćene oblike opcija u obliku u kom su i same upisane u IPS QR kod.

const generator = require("ips-qr-code");
const qrcode = require("qrcode");
const filename = "test.png";

generator({
    p: "Marko Markovic",
    s: "Uplata po racunu",
    n: "EPS Snabdevanje 11000 Beograd",
    sf: "221",
    i: "RSD1000,00",
    o: "123456789012345611",
    r: "845000000014284968",
    k: "PR",
    v: "01",
    c: 1,
})
.then(ipsString => qrcode.toFile(filename, ipsString))
.catch(error => console.error(error));

Opcije

-k, --kod [string=PR]

Identifikacioni kod koji opisuje sadržaj QR koda. Moguće vrednosti su:

PR – za QR kod na štampanom računu velikih izdavalaca računa
PT – za QR kod na prodajnom mestu, prikazan od strane trgovca
PK – za QR kod na prodajnom mestu, prikazan od strane kupca
EK – za QR kod u aplikaciji e-commerce

-r, --racun-primaoca [string] (required)

Broj računa primaoca plaćanja označava broj tekućeg odnosno drugog platnog računa primaoca plaćanja u skladu s propisima;

-n, --naziv-primaoca [string] (required)

Naziv i sedište primaoca plaćanja označava poslovno ime ili skraćeno poslovno ime primaoca plaćanja, odnosno naziv pod kojim je evidentiran u registru nadležnog organa. Ako naziv primaoca plaćanja sadrži i njegovo sedište, onda nije potrebno navoditi to sedište;

-i, --iznos [string] (required)

Valuta i iznos novčanih sredstava predstavlja oznaku RSD i iznos, u kome se obavezno upisuje decimalna zapeta, iza koje se ne moraju pisati nevažeće decimalne nule (primer: RSD1025). Minimalni iznos naloga je RSD0,01, a maksimalni iznos naloga je RSD99999999999999,99. Pri unosu iznosa, hiljade se ne odvajaju tačkama. Nije dozvoljeno izostaviti cifru za celo mesto u iznosu. Na primer: RSD,01 nije ispravan iznos, ispravno je RSD0,01;

-o, --racun-platioca [string] (required)

Broj računa platioca označava broj tekućeg odnosno drugog platnog računa platioca u skladu s propisima;

-p, --naziv-platioca [string] (required)

Naziv i sedište platioca predstavlja ime i prezime i adresu platioca (ulica, broj i mesto)

--sf, --sifra-placanja [number] (required)

Šifra plaćanja označava numerički podatak od tri cifre, od kojih prva identifikuje način plaćanja, a druge dve osnovu;

-s, --svrha-placanja [string] (required)

Svrha plaćanja označava podatke o nameni i osnovu prenosa, odnosno uplate novčanih sredstava;

-m, --MCC [string]

MCC je oznaka Merchant Code Category – kod kategorije trgovca u skladu sa ISO 18245. Spisak dozvoljenih kodova biće utvrđen tehničkom dokumentacijom sistema IPS NBS;

--jf, --jednokratna-sifra [string]

Jednokratna šifra platioca predstavlja TOTR vrednost (jednokratnu šifru čije je važenje vremenski ograničeno, npr. pet minuta).Banka platioca stvara jednokratnu šifru, ali i izvršava autorizaciju transakcije plaćanja;

--ro, --poziv-na-broj [string]

Poziv na broj odobrenja primaoca plaćanja označava dopunske podatke za primaoca plaćanja u skladu s propisima;

--rl, --referenca-primaoca [string]

Referenca primaoca plaćanja označava dopunske podatke za primaoca plaćanja u slobodnoj formi;

--rp, --referenca-placanja [string]

Referenca koja identifikuje transakciju na prodajnom mestu predstavlja jedinstveni identifikator samog plaćanja, ukupne dužine 19

--scale [number=4]

The scale of the QR code pixels

--margin [number=4]

The size of the margin around the QR code

--bg-color [string=#ffffffff]

The color of the QR code light pixels

--fg-color [string=#000000ff]

The color of the QR code dark pixels

--height [number]

Width of the QR image

--width [number]