BH Fiscal SDK

Biblioteka za komunikaciju sa TRING fiskalnim printerom.

Instalacija

npm install bh-fiscal-sdk

Inicijalizacija

import FiscalSDK from "bh-fiscal-sdk";

const sdk = new FiscalSDK({
  host: "http://localhost:8085", // URL fiskalnog printera
});

Dostupne metode

printReceipt - Štampanje fiskalnog računa

Metoda za štampanje fiskalnog računa. Vraća Promise koji sadrži informacije o odštampanom računu.

const response = await sdk.printReceipt({
  date: new Date(),
  billId: "1233",
  paymentMethods: [
    {
      /*
        Podržani tipovi:
          - Virman
          - Gotovina
          - Kartica
          - Cek
      */
      type: "Virman",
      amount: 0.50,
    },
  ],
  articles: [
    {
      id: "1",
      name: "Cunga lunga",
      price: 0.50,
      quantity: 2,
      discount: 0,
      /*
        E - opšta stopa (17%)
        K - stopa za artikle oslobođenje plaćanja PDV (0%)
        A - za korisnike koji nisu u sistemu PDV (0%)
      */
      rate: "E"
    }
  ],
});

// Rezultat:
// {
//   id: 123,              // Broj fiskalnog računa
//   date: "2024-01-20",   // Datum računa
//   time: "14:30:00",     // Vrijeme računa
//   amount: 5.00          // Ukupan iznos računa
// }

printPeriodicalReport - Štampanje periodičnog izvještaja

Metoda za štampanje izvještaja za određeni vremenski period.

await sdk.printPeriodicalReport({
  startDate: new Date("2024-01-01"),
  endDate: new Date("2024-01-31"),
});

printDailyReport - Štampanje dnevnog izvještaja

Metoda za štampanje dnevnog izvještaja. Ne zahtijeva parametre.

await sdk.printDailyReport();

printOverview - Štampanje presjeka stanja

Metoda za štampanje trenutnog presjeka stanja. Ne zahtijeva parametre.

await sdk.printOverview();

Obrada grešaka

Sve metode vraćaju Promise i mogu baciti grešku u slučaju problema sa komunikacijom ili drugim greškama. Preporučuje se korištenje try-catch bloka:

try {
  await sdk.printReceipt({
    // ... parametri računa
  });
} catch (error) {
  console.error("Greška prilikom štampanja računa:", error.message);
}