serbian-fiscal-bill-parser v1.0.3

serbian-fiscal-bill-parser

Library for parsing official fiscal bills issued in Serbia obtained via POS terminals in any store. Parser accepts raw bill text and outputs info in JSON format. Raw bill text can be obtained by scanning QR code on any bill which is a link that begins with https://suf.purs.gov.rs/v/?vl=.

Please note, this library is not a crawler. It is up to you to write code which gets raw bill from suf.purs.gov.rs site.

Example usage

1. Create a new NodeJS script app.mjs
2. Run npm install --save serbian-fiscal-bill-parser in your terminal
3. Paste the following code

import { SerbianFiscalBillParser } from 'serbian-fiscal-bill-parser'

let bill = 
`============ ФИСКАЛНИ РАЧУН ============
106481835
KOMPRODUKT RVU
1234567-МАРКЕТ НЕРЕВA 33
БАЛКАНСКА 123 
Београд-Стари Град
Касир:                                31
ЕСИР број:                      123/2.34
ЕСИР време:         06.05.2023. 20:33:41
-------------ПРОМЕТ ПРОДАЈА-------------
Артикли
========================================
Назив   Цена         Кол.         Укупно
VODA PROLOM 1.5 L (Ђ)                   
        89,99          6          539,94
----------------------------------------
Укупан износ:                     539,94
Платна картица:                   539,94
========================================
Ознака       Име      Стопа        Порез
Ђ           О-ПДВ   20,00%         89,99
----------------------------------------
Укупан износ пореза:               89,99
========================================
ПФР време:          06.05.2023. 20:33:54
ПФР број рачуна: 4A17FLHG-4WJ7FLWW-12345
8                                       
Бројач рачуна:           123456/123456ПП
========================================

======== КРАЈ ФИСКАЛНОГ РАЧУНА =========`;

let parser = new SerbianFiscalBillParser();
let result = parser.parse(bill);
console.log(JSON.stringify(result, null, ' '));

1. Run the script with node app.mjs. You should see the following output:

{
 "company": {
  "pib": "106481835",
  "name": "KOMPRODUKT RVU",
  "city": "Београд",
  "address": "БАЛКАНСКА 123",
  "municipality": "Стари Град"
 },
 "pos": {
  "id": "1234567",
  "name": "МАРКЕТ НЕРЕВA 33"
 },
 "items": [
  {
   "name": "VODA PROLOM 1.5 L",
   "measurementUnit": "kom",
   "vatType": 0.2,
   "price": 539.94,
   "amount": 6,
   "unitPrice": 89.99
  }
 ],
 "price": 539.94
}

Contributing

Feel free to create an issue if you notice any problems with the library. Add the link of the bill when creating an issue so that I can use it for testing. This is the link that is obtained by scanning the QR code on the bill.

Also pull requests are welcome.