Slovenia (FURS)

Full support for Slovenian fiscalization requirements (FURS).

Prerequisites

Requirement	Description
Tax number	Entity with Slovenian tax number
Certificate	Digital certificate (.p12) from FURS

Setup

1. Upload Certificate

Upload FURS certificatetypescript

Copy

import SpaceInvoices from "@spaceinvoices/js-sdk";

const sdk = new SpaceInvoices("YOUR_API_KEY");

await sdk.fursSettings.uploadFursCertificate({
  certificate: fs.readFileSync("certificate.p12").toString("base64"),
  passphrase: "cert-password",
});

Upload Certificate API →

2. Register Business Premise

Register your business location (e.g., P1, OFFICE). This creates the premise and registers it with FURS.

Register premisetypescript

Copy

const premise = await sdk.fursFiscalization.registerFursRealEstatePremise({
  business_premise_name: "PREMISE1",
  real_estate: {
    cadastral_number: "1234",
    community: "Ljubljana",
    city: "Ljubljana",
    street: "Main Street",
    house_number: "1",
    postal_code: "1000",
  },
});

Register Premise API →

3. Register Electronic Device

Register a device for the premise (e.g., D1, POS1). Each device gets its own invoice counter.

Register devicetypescript

Copy

await sdk.fursFiscalization.registerFursElectronicDevice("prm_123", { name: "DEVICE1" });

Register Device API →

4. Enable FURS

Enable FURStypescript

Copy

await sdk.fursSettings.update({ enabled: true });

FURS Settings API →

Fiscalized Invoices

Invoices are automatically fiscalized when FURS is enabled:

Create fiscalized invoicetypescript

Copy

const invoice = await sdk.invoices.create({
  items: [{ name: "Service", quantity: 1, price: 100 }],
  furs: {
    business_premise_name: "PREMISE1",
    electronic_device_name: "DEVICE1",
  },
});

Create Invoice API →

FURS returns confirmation data on the invoice:

Response Fields

eor

Unique invoice identifier from FURS

zoi

Protective mark (security code)

Non-Cash Invoices

Invoices with non-cash payment methods (e.g., bank transfer) don’t require fiscalization:

Skip fiscalizationtypescript

Copy

const invoice = await sdk.invoices.create({
  items: [{ name: "Service", quantity: 1, price: 100 }],
  furs: { skip: true },
});

Create Invoice API →

QR Code

Fiscalized invoices include a verification QR code, embedded automatically in the PDF:

Render PDFtypescript

Copy

const pdf = await sdk.invoices.renderPdf(invoice.id);

Render PDF API →