🖨️Fiscals

This page provides a description of the available API routes for managing fiscal devices.

PreviousDevices NextHealth check

Last updated 1 year ago

Fiscal device refers to receipt printer that prints cash register receipts (part of ticket closing procedure).

Fiscal device is represented by Fiscal class.

API methods

CRUD actions

These API methods allow for the management of fiscal resources, including creation, reading, updating, and deletion.

Get fiscals

GET http://{server-address}/fiscals

Returns all fiscals that matches query parameters. Result is of type QueryResult<Fiscal>.

Query Parameters

Name

Type

Description

Headers

{
    "items":
    [
        {
            "name": "Virtual",
            "isActive": true,
            "type": "Virtual",
            "version": "",
            "dkp": "88811223344550000",
            "settings":
            {
                "Footer": "Ďakujeme za nákup!"
            },
            "_v": 1
        }
    ],
    "count": 1,
    "totalCount": 1
}

Get fiscal by name

GET http://{server-address}/fiscals/{name}

Result is of type Fiscal.

Path Parameters

Headers

{
    "name": "fiscal1",
    "isActive": true,
    "type": "Virtual",
    "version": "",
    "dkp": "88811223344550000",
    "settings":
    {
        "Footer": "Ďakujeme za nákup!"
    },
    "_v": 1
}{
    "name": "fiscal1",
    "isActive": true,
    "type": "Virtual",
    "version": "",
    "dkp": "88811223344550000",
    "settings":
    {
        "Footer": "Ďakujeme za nákup!"
    },
    "_v": 1
}

{
    "title": "Zdroj nebol nájdený",
    "status": 404
}

Create fiscal

POST http://{server-address}/fiscals

Creates new fiscal. Result is of type Fiscal.

Required rights

Authorized user must have FiscalCreate right assigned.

Headers

Request Body

{
    "name": "fiscal1",
    "isActive": true,
    "type": "Virtual",
    "version": "",
    "dkp": "88811223344550000",
    "settings":
    {
        "Footer": "Ďakujeme za nákup!"
    },
    "_v": 1
}

Create or update fiscal

PUT http://{server-address}/fiscals/{name}

Creates new or updates existing fiscal. Result is of type Fiscal.

Required rights

Authorized user must have assigned FiscalCreate or FiscalUpdate right.

Path Parameters

Headers

Request Body

{
    "name": "fiscal1",
    "isActive": true,
    "type": "Virtual",
    "version": "",
    "dkp": "88811223344550000",
    "settings":
    {
        "Footer": "Ďakujeme za nákup!"
    },
    "_v": 1
}

Delete fiscal by name

DELETE http://{server-address}/fiscals/{name}

Required rights

Authorized user must have FiscalDelete right assigned.

Path Parameters

Headers

{
    "name": "fiscal1",
    "isActive": true,
    "type": "Virtual",
    "version": "",
    "dkp": "88811223344550000",
    "settings":
    {
        "Footer": "Ďakujeme za nákup!"
    },
    "_v": 1
}

{
    "title": "Fiskálna tlačiareň 'eKasa' je označená ako neaktívna.",
    "status": 403
}

RPC actions

These API methods trigger specific actions on fiscal devices. However, it's important to note that depending on the type of fiscal device, some methods may not be supported. Additionally, attempting an action on a fiscal device that is marked as inactive will also result in failure. In both of these cases, making API calls will result in an HTTP status code of 403.

Open cash drawer

POST http://{server-address}/fiscals/{name}/open_drawer

Opens cash drawer on specified device.

Required rights

Authorized user must have FiscalOpenDrawer right assigned.

Path Parameters

Headers

The response body contains no content.

Perform cash transfer

POST http://{server-address}/fiscals/{name}/cash_transfer

This method performs a cash transfer operation on a fiscal device specified by name. It updates the latest daily sales report for the device or creates a new report if none is currently opened. The updated daily sales report is then returned in the response body.

The method accepts CashTransfer in request body.

Required rights

Authorized user must have FiscalCashTransfer right assigned.

Path Parameters

Headers

Request Body

Print ticket copy

POST http://{server-address}/fiscals/{name}/print_record_copy

Prints copy of specified ticket on fiscal printer. Method accepts RecordCopyContext in request body.

Required rights

Authorized user must have FiscalPrintRecordCopy right assigned.

Path Parameters

Headers

Request Body

The response body contains no content.

Print last ticket copy

POST http://{server-address}/fiscals/{name}/print_last_record_copy

Prints copy of last ticket printed on fiscal printer.

Required rights

Authorized user must have FiscalPrintRecordCopy right assigned.

Path Parameters

Headers

The response body contains no content.

Print overview sales report

POST http://{server-address}/fiscals/{name}/print_overview_sales_report

Prints overview sales report on specified fiscal printer.

The overview sales report ("Priebežná uzávierka", "Prehľadová uzávierka" or "X uzávierka" in Slovak) includes financial information on sales from the last daily sales report.

Required rights

Authorized user must have OverviewSalesReport right assigned.

Path Parameters

Headers

The response body contains no content.

Print summary interval sales report

POST http://{server-address}/fiscals/{name}/print_summary_interval_sales_report

Prints summary interval sales report on specified fiscal printer. The generated report consolidates financial information extracted from multiple daily sales reports.

The method accepts IntervalSalesReportContext in request body.

Required rights

Authorized user must have SummaryIntervalSalesReport right assigned.

Path Parameters

Headers

Request Body

The response body contains no content.

Print detailed interval sales report

POST http://{server-address}/fiscals/{name}/print_detailed_interval_sales_report

Prints detailed interval sales report on specified fiscal printer. The generated report consolidates financial information extracted from multiple daily sales reports.

The method accepts IntervalSalesReportContext in request body.

Required rights

Authorized user must have DetailedIntervalSalesReport right assigned.

Path Parameters

Headers

Request Body

The response body contains no content.

Print daily sales report

POST http://{server-address}/fiscals/{name}/daily_sales_report

Performs daily sales closure and prints daily sales report on specified fiscal printer. DailySalesReport is returned in response body. It's important to note that certain fiscal devices only support one daily sales report per day, while other types of fiscal devices allow multiple closures to be performed within the same day.

Required rights

Authorized user must have DoDailySalesReport right assigned.

Path Parameters

Headers

{
    "id": "649ad7516413d6a4de6c8cb4",
    "fiscalName": "eKasa",
    "number": 1,
    "fiscalMemorySerialNumber": "1326585810",
    "openDate": "2023-06-27T08:04:25.605Z",
    "closeDate": "2023-06-27T22:42:13.662Z",
    "currencyLabel": "EUR",
    "cashTransfers":
    [],
    "fiscalInfo":
    {
        "ticketsCount": 7,
        "ticketsAmountIncludingVat":
        {
            "amount": 80.65,
            "currencyLabel": "EUR"
        },
        "invalidTicketsCount": 0,
        "invalidTicketsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "invoiceTicketsCount": 0,
        "invoiceTicketsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "positiveTicketItemsCount": 8,
        "positiveTicketItemsAmountIncludingVat":
        {
            "amount": 80.65,
            "currencyLabel": "EUR"
        },
        "returnedContainerTicketItemsCount": 0,
        "returnedContainerTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "returnedTicketItemsCount": 0,
        "returnedTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "correctionTicketItemsCount": 0,
        "correctionTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "discountTicketItemsCount": 0,
        "discountTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "advanceTicketItemsCount": 0,
        "advanceTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "creditTicketItemsCount": 0,
        "creditTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "voucherTicketItemsCount": 0,
        "voucherTicketItemsAmountIncludingVat":
        {
            "amount": 0.0,
            "currencyLabel": "EUR"
        },
        "vatIncomes":
        [
            {
                "vatCategory": 1,
                "vatRate": 20.0,
                "totalAmount":
                {
                    "amount": 9.45,
                    "currencyLabel": "EUR"
                },
                "vatAmount":
                {
                    "amount": 1.58,
                    "currencyLabel": "EUR"
                }
            },
            {
                "vatCategory": 2,
                "vatRate": 10.0,
                "totalAmount":
                {
                    "amount": 71.2,
                    "currencyLabel": "EUR"
                },
                "vatAmount":
                {
                    "amount": 6.47,
                    "currencyLabel": "EUR"
                }
            },
            {
                "vatCategory": 3,
                "vatRate": 0.0,
                "totalAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                },
                "vatAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                }
            },
            {
                "vatCategory": 4,
                "vatRate": 0.0,
                "totalAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                },
                "vatAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                }
            },
            {
                "vatCategory": 5,
                "vatRate": 0.0,
                "totalAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                },
                "vatAmount":
                {
                    "amount": 0.0,
                    "currencyLabel": "EUR"
                }
            }
        ],
        "grandTotalAmountIncludingVat":
        {
            "amount": 1619.31,
            "currencyLabel": "EUR"
        },
        "roundingDown":
        {
            "amount": -0.02,
            "currencyLabel": "EUR"
        },
        "roundingUp":
        {
            "amount": 0.02,
            "currencyLabel": "EUR"
        }
    },
    "state": "Closed",
    "_v": 2
}

Print daily sales report copy

POST http://{server-address}/fiscals/{name}/daily_sales_report_copy

Prints copy of daily sales report associated with given fiscal printer. Method accepts DailySalesReportCopyContext in request body.

Required rights

Authorized user must have FiscalPrintDailySalesReportCopy right assigned.

Path Parameters

Headers

Request Body

The response body contains no content.

Print last daily sales report copy

POST http://{server-address}/fiscals/{name}/last_daily_sales_report_copy

Prints copy of last daily sales report associated with given fiscal printer.

Required rights

Authorized user must have FiscalPrintDailySalesReportCopy right assigned.

Path Parameters

Headers

The response body contains no content.

Print text

POST http://{server-address}/fiscals/{name}/print_nonfiscal_record

Prints text (nonfiscal record) on selected fiscal device. Method accepts NonfiscalRecordContext in request body.

Required rights

Authorized user must have PrintNonfiscalRecord right assigned.

Path Parameters

Headers

Request Body

The response body contains no content.