Skip to content
Space Invoices Documentation

Tax Reports

Tax Reports

Generate Slovenian tax report exports, including KIR and yearly eDavki filings.

Endpoints
IntroductionPOST/tax-reports/kirPOST/tax-reports/si/yearly/normirani/reviewPOST/tax-reports/si/yearly/normirani/exportPOST/tax-reports/si/accounting/vod/exportGET/tax-reports/si/profilePUT/tax-reports/si/profile

Generate KIR export (Issued Invoices Ledger)

POST/tax-reports/kir


Generate a KIR (Knjiga izdanih računov / Evidenca obračunanega DDV) export file for FURS.

This export contains all issued invoices and credit notes for the specified period in FURS-compliant XML format,
packaged in a ZIP archive ready for upload to eDavki.

Period Selection:
- Use month for monthly exports (e.g., month=1 for January)
- Use quarter for quarterly exports (e.g., quarter=1 for Q1)
- Cannot use both month and quarter

Transaction Type Mapping:
- Domestic sales → P7 (taxable supplies) + P14/P15/P16 (VAT by rate)
- Intra-EU B2B → P10 (reverse charge)
- Intra-EU B2C → P7 + P14/P15/P16 (standard VAT)
- Export (third country) → P27 (export exemption)

Credit Notes:
- Included with negative amounts as per FURS specification
- Same field mapping as invoices, but amounts are negated

Important:
- Voided documents are included with zero amounts
- Entity must have a valid Slovenian tax number (SI prefix is automatically removed)

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Query parameters

yearstringrequired

Year for KIR export (e.g., 2025)

monthstringoptional

Month for monthly export (1-12). Cannot be used with quarter.

quarterstringoptional

Quarter for quarterly export (1-4). Cannot be used with month.

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const blob = await sdk.taxReports.generateKirExport({
  year: "2025"
});

const arrayBuffer = await blob.arrayBuffer();
const { writeFile } = await import('node:fs/promises');
await writeFile('download.bin', Buffer.from(arrayBuffer));
console.log('Saved download.bin');

Review yearly Slovenia normirani filing

POST/tax-reports/si/yearly/normirani/review

Build a review draft for the yearly Slovenia DDD-DDD filing for the supported resident normirani s.p. path.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

yearintegerrequired

Tax year for the yearly Slovenia eDavki filing.

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.taxReports.reviewSloveniaYearlyNormiraniReport({
  year: 2025
});

console.log(response);
Response

Returns

entity_idstring
yearinteger
filing_kindstring
profileobject
auto_valuesobject
manual_valuesobject
derived_flagsobject
warningsarray of objects
issue_detailsarray of objects
rule_summaryobject
json
{
  "entity_id": "string",
  "year": 0,
  "filing_kind": "regular_annual",
  "profile": {
    "business_form": "sp",
    "income_tax_regime": "normirani",
    "vat_profile": "standard",
    "tax_residency": "resident",
    "yearly_reporting": {
      "activity_codes": [
        "string"
      ],
      "registration_number": "string",
      "accounting_type": "records",
      "normiranec_insurance_basis": "full_time_self_employed",
      "default_withholding_tax_amount": 0,
      "default_foreign_tax_credit_amount": 0
    },
    "accounting_exports": {
      "preferred_format": "vod_xml",
      "konto_mappings": {
        "receivables": "string",
        "payables": "string",
        "sales_vat_22": "string",
        "sales_vat_95": "string",
        "sales_vat_5": "string",
        "purchase_vat_recoverable_22": "string",
        "purchase_vat_recoverable_95": "string",
        "purchase_vat_recoverable_5": "string",
        "sales_revenue_22": "string",
        "sales_revenue_95": "string",
        "sales_revenue_5": "string",
        "sales_revenue_exempt": "string",
        "sales_revenue_eu_goods": "string",
        "sales_revenue_eu_services": "string",
        "sales_revenue_reverse_charge": "string",
        "sales_revenue_third_country_goods": "string",
        "sales_revenue_third_country_services": "string",
        "purchase_expense_22": "string",
        "purchase_expense_95": "string",
        "purchase_expense_5": "string",
        "purchase_expense_exempt": "string",
        "purchase_expense_eu_goods": "string",
        "purchase_expense_eu_services": "string",
        "purchase_expense_reverse_charge": "string",
        "purchase_expense_third_country_goods": "string",
        "purchase_expense_third_country_services": "string"
      }
    },
    "business_form_source": "stored",
    "inferred_business_form": "sp",
    "supported_exports": {
      "yearly_normirani": true,
      "vod_xml": true,
      "vasco_xml": true,
      "minimax_xml": true
    },
    "unsupported_reason": "string"
  },
  "auto_values": {
    "total_invoice_revenue": 0,
    "total_credit_note_reduction": 0,
    "computed_revenue": 0,
    "adjusted_revenue": 0,
    "normative_expense_rate": 0,
    "normative_expenses": 0,
    "tax_base": 0,
    "income_tax_rate": 0,
    "income_tax_amount": 0,
    "advance_tax_amount": 0,
    "monthly_installment_amount": 0,
    "quarterly_installment_amount": 0
  },
  "manual_values": {
    "withholding_tax_amount": 0,
    "foreign_tax_credit_amount": 0,
    "prior_advance_income_tax_amount": 0,
    "revenue_adjustment_decrease": 0,
    "revenue_adjustment_increase": 0
  },
  "derived_flags": {
    "has_foreign_customers": true,
    "has_foreign_tax_numbers": true,
    "has_non_eur_documents": true
  },
  "warnings": [
    {
      "code": "string",
      "message": "string",
      "severity": "info"
    }
  ],
  "issue_details": [
    {
      "code": "string",
      "title": "string",
      "summary": "string",
      "explanation": "string",
      "action": "string",
      "severity": "info",
      "official_sources": [
        {
          "label": "string",
          "url": "string",
          "issuer": "FURS"
        }
      ],
      "affected_documents": [
        {
          "id": "string",
          "type": "invoice",
          "number": "string",
          "date": "string",
          "customer_name": "string",
          "customer_country_code": "string",
          "customer_tax_number": "string",
          "currency_code": "string",
          "total": 0,
          "total_converted": 0,
          "reason": "string",
          "document_path": "string"
        }
      ]
    }
  ],
  "rule_summary": {
    "normative_expense_rule": "string",
    "income_tax_rule": "string",
    "advance_rule": "string"
  }
}

Export yearly Slovenia normirani XML

POST/tax-reports/si/yearly/normirani/export

Generate a DDD-DDD XML file for the supported resident normirani s.p. path after the yearly review values are confirmed.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

yearintegerrequired

Tax year for the yearly Slovenia eDavki filing.

manual_valuesobjectrequired
import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.taxReports.exportSloveniaYearlyNormiraniReport({
  year: 2025,
  manual_values: {
    withholding_tax_amount: 0,
    foreign_tax_credit_amount: 0,
    prior_advance_income_tax_amount: 0,
    revenue_adjustment_decrease: 0,
    revenue_adjustment_increase: 0
  }
});

console.log(response);
Example:

Export Slovenia VOD XML ZIP

POST/tax-reports/si/accounting/vod/export

Generate a legacy-compatible Slovenian VOD ZIP export for issued documents. The first release contains only VOD_izdani.xml.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

date_fromstring<date>required

Inclusive document date in YYYY-MM-DD format.

date_tostring<date>required

Inclusive document date in YYYY-MM-DD format.

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const blob = await sdk.taxReports.exportSloveniaVodXml({
  date_from: "2025-01-01",
  date_to: "2025-01-31"
});

const arrayBuffer = await blob.arrayBuffer();
const { writeFile } = await import('node:fs/promises');
await writeFile('download.bin', Buffer.from(arrayBuffer));
console.log('Saved download.bin');
Example:

Get Slovenia yearly tax profile

GET/tax-reports/si/profile

Retrieve the normalized Slovenia-specific tax profile stored on the entity, including inferred business form and yearly-export support status.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.taxReports.getSloveniaTaxProfile();

console.log(response);
Response

Returns

business_formstringnullable
income_tax_regimestringnullable
vat_profilestringnullable
tax_residencystringnullable
yearly_reportingobject
accounting_exportsobject
business_form_sourcestring
inferred_business_formstringnullable
supported_exportsobject
unsupported_reasonstringnullable
json
{
  "business_form": "sp",
  "income_tax_regime": "normirani",
  "vat_profile": "standard",
  "tax_residency": "resident",
  "yearly_reporting": {
    "activity_codes": [
      "string"
    ],
    "registration_number": "string",
    "accounting_type": "records",
    "normiranec_insurance_basis": "full_time_self_employed",
    "default_withholding_tax_amount": 0,
    "default_foreign_tax_credit_amount": 0
  },
  "accounting_exports": {
    "preferred_format": "vod_xml",
    "konto_mappings": {
      "receivables": "string",
      "payables": "string",
      "sales_vat_22": "string",
      "sales_vat_95": "string",
      "sales_vat_5": "string",
      "purchase_vat_recoverable_22": "string",
      "purchase_vat_recoverable_95": "string",
      "purchase_vat_recoverable_5": "string",
      "sales_revenue_22": "string",
      "sales_revenue_95": "string",
      "sales_revenue_5": "string",
      "sales_revenue_exempt": "string",
      "sales_revenue_eu_goods": "string",
      "sales_revenue_eu_services": "string",
      "sales_revenue_reverse_charge": "string",
      "sales_revenue_third_country_goods": "string",
      "sales_revenue_third_country_services": "string",
      "purchase_expense_22": "string",
      "purchase_expense_95": "string",
      "purchase_expense_5": "string",
      "purchase_expense_exempt": "string",
      "purchase_expense_eu_goods": "string",
      "purchase_expense_eu_services": "string",
      "purchase_expense_reverse_charge": "string",
      "purchase_expense_third_country_goods": "string",
      "purchase_expense_third_country_services": "string"
    }
  },
  "business_form_source": "stored",
  "inferred_business_form": "sp",
  "supported_exports": {
    "yearly_normirani": true,
    "vod_xml": true,
    "vasco_xml": true,
    "minimax_xml": true
  },
  "unsupported_reason": "string"
}

Update Slovenia yearly tax profile

PUT/tax-reports/si/profile

Update the Slovenia-specific tax profile stored on the entity. Unsupported profiles are stored for future use but remain blocked for yearly export.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

business_formstringoptionalnullable
income_tax_regimestringoptionalnullable
vat_profilestringoptionalnullable
tax_residencystringoptionalnullable
yearly_reportingobjectoptionalnullable
accounting_exportsobjectoptionalnullable
import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.taxReports.updateSloveniaTaxProfile({
  business_form: "sp",
  income_tax_regime: "normirani",
  tax_residency: "resident",
  yearly_reporting: {
    activity_codes: [
      "62.010",
      "47.910"
    ],
    registration_number: "1234567",
    accounting_type: "records",
    normiranec_insurance_basis: "full_time_self_employed",
    default_withholding_tax_amount: 0,
    default_foreign_tax_credit_amount: 0
  }
});

console.log(response);
Example:
Response

Returns

business_formstringnullable
income_tax_regimestringnullable
vat_profilestringnullable
tax_residencystringnullable
yearly_reportingobject
accounting_exportsobject
business_form_sourcestring
inferred_business_formstringnullable
supported_exportsobject
unsupported_reasonstringnullable
json
{
  "business_form": "sp",
  "income_tax_regime": "normirani",
  "vat_profile": "standard",
  "tax_residency": "resident",
  "yearly_reporting": {
    "activity_codes": [
      "string"
    ],
    "registration_number": "string",
    "accounting_type": "records",
    "normiranec_insurance_basis": "full_time_self_employed",
    "default_withholding_tax_amount": 0,
    "default_foreign_tax_credit_amount": 0
  },
  "accounting_exports": {
    "preferred_format": "vod_xml",
    "konto_mappings": {
      "receivables": "string",
      "payables": "string",
      "sales_vat_22": "string",
      "sales_vat_95": "string",
      "sales_vat_5": "string",
      "purchase_vat_recoverable_22": "string",
      "purchase_vat_recoverable_95": "string",
      "purchase_vat_recoverable_5": "string",
      "sales_revenue_22": "string",
      "sales_revenue_95": "string",
      "sales_revenue_5": "string",
      "sales_revenue_exempt": "string",
      "sales_revenue_eu_goods": "string",
      "sales_revenue_eu_services": "string",
      "sales_revenue_reverse_charge": "string",
      "sales_revenue_third_country_goods": "string",
      "sales_revenue_third_country_services": "string",
      "purchase_expense_22": "string",
      "purchase_expense_95": "string",
      "purchase_expense_5": "string",
      "purchase_expense_exempt": "string",
      "purchase_expense_eu_goods": "string",
      "purchase_expense_eu_services": "string",
      "purchase_expense_reverse_charge": "string",
      "purchase_expense_third_country_goods": "string",
      "purchase_expense_third_country_services": "string"
    }
  },
  "business_form_source": "stored",
  "inferred_business_form": "sp",
  "supported_exports": {
    "yearly_normirani": true,
    "vod_xml": true,
    "vasco_xml": true,
    "minimax_xml": true
  },
  "unsupported_reason": "string"
}