{
  "openapi": "3.0.1",
  "info": {
    "title": "Nine Digit eKasa",
    "description": "HTTP API of eKasa, the certified cash register software for the Slovak eKasa system. Your software sends sales, locations and print requests to the eKasa service, which stores them in the CHDÚ storage, registers them in the eKasa system of the Financial Administration and prints the receipts.\n\n- **Address:** the service listens on `http://localhost:3010` on the same device; from another device in the local network use the device's address and the same port.\n- **Format:** requests and responses are JSON in UTF-8.\n- **Errors:** error responses use the problem details format (RFC 7807) with an eKasa error code in `code`, see [Error codes](https://ekasa.ninedigit.sk/en/docs/rest-api/error-codes).\n- **Sign-in:** off by default; when it is turned on in the web interface, send HTTP Basic credentials. See [Connection and security](https://ekasa.ninedigit.sk/en/docs/security).\n\nGuides on receipts, VAT, printing and QR payments are in the [documentation](https://ekasa.ninedigit.sk/en/docs).",
    "contact": {
      "name": "Nine Digit, s.r.o.",
      "url": "https://www.ninedigit.sk",
      "email": "info@ninedigit.sk"
    },
    "version": "9"
  },
  "paths": {
    "/api/v1/certificates": {
      "get": {
        "tags": [
          "Certificates"
        ],
        "summary": "Latest certificates",
        "description": "Finds the latest certificate of each cash register matching the filter.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits; `null` to not filter by cash register.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "Certificates found.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CertificateInfoDTO"
                  }
                },
                "example": [{"alias":"88812345678900001","dic":"2020123456","cashRegisterCode":"88812345678900001","issueDate":"2025-03-12T09:41:27+01:00","expirationDate":"2027-03-12T09:41:27+01:00","serialNumber":"2B0A","isNotYetValid":false,"isValid":true,"isAboutToExpire":false,"daysToExpire":416,"isExpired":false},{"alias":"88812345678900002","dic":"2020123456","cashRegisterCode":"88812345678900002","issueDate":"2025-06-02T14:18:05+02:00","expirationDate":"2027-06-02T14:18:05+02:00","serialNumber":"3C1B","isNotYetValid":false,"isValid":true,"isAboutToExpire":false,"daysToExpire":498,"isExpired":false}]
              }
            }
          },
          "400": {
            "description": "The query is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":"0HLLND37G80V8:00000001","code":-900,"errors":{"CashRegisterCode":["A value for the 'CashRegisterCode' parameter or property was not provided."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","code":null,"traceId":"0HLLNCVD3CIK1:00000001","instance":"/api/v1/certificates"}
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Certificates"
        ],
        "summary": "Add certificate",
        "description": "Adds a certificate (authentication data) of a cash register.",
        "requestBody": {
          "description": "Certificate data.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CertificateDTO"
              },
              "example": {"keyStoreType":"PKCS12","alias":"88812345678900001","data":"MIITbgIBAzCCEygGCSqGSIb3DQEHAaCCExkEghMVMIITETCCBX4GCSqGSIb3DQEHAaCCBW8EggVrMIIFZzCCBWMGCyqGSIb3DQEMCgECoIIE+jCCBPYwKAYKKoZIhvcNAQwBAzAaBBR/MBZglKl5XQe7ZLoFhUEhUvMypgICBAAEggTITioyYrL8z+fZRZdQqW7v2jc/Pro8IaNclc+fzdRiHN6SWsecHT2FLtKYoAbgbPe0KakEYfj7LxloBGMUgVx7gaHghwxVkf2pwIdWgORQ5M3UMqeeMCFzV6dHOMUvoEnhejNPoUFxk/MV/RwF3V/omrYEQN5jAU/7LWWn9xvI9ANPvSRYuP6lsSUPNPsvqub0QcedbsKlxezBkAiFCBi+aAhXebmp76g1boE5ilYC6liD5bR0CeYq557Vp/2tWV9hXMTXvFDN2f24h08oNFSHus5mYWmKM5ZeOiCfzdAy9ARKzGC1sw+giYymUkgmfHwOc23XJHBn/Vk9m74J0TjE4RvbaSEV9SZBjdAwBEVzkUt8B/Q7AWwIz2fEX+yKVtByy0L4uNe29bxQ+XXw8boldoRo3PgRKgohZJuRraGMdRDGnCWUZzbJmdjrPghIJgP4qOMb7oAhHe+IkmbUjl6LrbRTYPWSiGXrazdFGr46ECvkLK3/hslfnMhVpLHHvzEQbHrkHevnpPTZJsExEwkqf3H7mE6HgqqElU5sHrrBDV/+Ef+4DeEH7RqdP9EV9Wy3mI7DO7kAg+p8hjE8DmG4vgXwhACdVn6ZVok9Zmhj4r01XqR9X7iO7MWSF8/aXJKM+DMnz4zPTBU4HJWrpiHC4wNvR94qZJhO9sObM1yyo5sRRCmDePpLmp6ndxoyOjt5TqOuuNRBRmGiNOiipGtckoV8FZXeZFu9isYiQA9U8ObI/+PJQ7oYoj6MkItC5hffOJJ2hg+X9JMeM/cRluoo3rWfGmmUKlVFQrmMrn4X9P70CvZkWIcSMcMenJqY/YIc+1uTSCbxCguCCIhw0MV8N6s6luGG/uXilY0fdtS58NkSYqsF2gJxP8AyGl7ylTWRO5uyogMdcAwXr1zhwNeacBYnFst8gb/b/nkwfmg2TXQvo5l3DUd1VeGeUanpY3tFwYb3NoOWjQPPLMSOY17mpHiRBAPSqZ0Dxdm3YvxSTZ8aly+CPH5J5/ul09ClDVAClYTJNw0dDePm/+APRulKNFyxknqsNFRhoUT0mYAD5Vv6T/koFfiRspLXZzHetKp59pMt/hifnrbR2pOEt5Na8RqZskyEN6JSvl7dlZOLb8/s7eSi4XrYM7JqBOXvNIlGJ7R1nmcQKsHEGC8N164jneFx9EtHjhQ0FBS5hO6d743HAozgiZ+WvijtIdFcjpsv/e/5K5lju89cMG6jH7MOo/fUfGqCu07NrLpZxhoUpUlX62xL1lRn4BdPpwHrMBcq5EZshFwA+VY7ilHDovC/y2rdOwPDC+WrDXTwyOI+YXNbYMMa7xoXuJexnhoMPalk5xrpCQUA4EbdW6sx3b5Rg2bZIzcsBncHhYzhLf8qPxmWC+erFnGTYI8B3OaL8yGQcrBAEvwLP1b1O7kL0c34NEjcJ7/ENwd4JVZXlDIr37qNYUYg0ERzjX18H1db5ywSCMM99cfd0UreBbfiQNH3SpeTyu0IYDi3RoyOJz+/L6lmIcPOb/OKheUCuXeMJ/0uGzQG7dqsuOqbpbOCdyfNkaJte8s/avoQklZfs1wt+5fY3TEuaIkGkiv0hz29iqLkpNwkg6aHfLB2ub/e2rFLOxuQ1pF4/EmKMVYwMQYJKoZIhvcNAQkUMSQeIgA4ADgAOAAxADIAMwA0ADUANgA3ADgAOQAwADAAMAAwADEwIQYJKoZIhvcNAQkVMRQEElRpbWUgMTU0ODkzNDU4OTE5MjCCDYsGCSqGSIb3DQEHBqCCDXwwgg14AgEAMIINcQYJKoZIhvcNAQcBMCgGCiqGSIb3DQEMAQYwGgQUEXa1MC2hctvQuNkIUGScz65lVF8CAgQAgIINOGzdDugbuy+UXtj/aSWi1qUN5xx+vZiKWyz0M7ukMeyxCHyXLDMMKGtaCWoY2fVvdUPCH7SPwhLy+uALkSDpAJC+6xL8WN+JV3QYECPOS9IhLa2HMa1mSr1Y6BfPBpW+70xdr20T+Djw2svMlrkLflxyO9JJXpCxKmIYlAEdedBYyybDViHXmjshHdTb7CVeh4rD0evZc4mrUIZG5WoXkgfRKjjS2PNYaHmfo2MXsDq287Qayu7OInW283mK9/0WI3wKoHxsncfZeUgDIbje8+IMUCnDnzw79QFzYHVsHupBfK0oG8QH6gkXKR3TgQ7U6dA0KXapN6Z3yXCFqvkucnthFaCe99EF60ve22ybuKPlpvngvDAkEY25Th/Zc5kJKbOvyft2aAfVFbSDhxbH1Y+KzR7Sgm6t2BVoNF9qcm0kyUmHExRs34COWKoVC3ETcL5DmrtZbkGHC1ciV9ipdP1BfAK1OsWK1rmdCwrK6jqwHMcJVWGTTKFyLSza2h9gaBb0sQe5+X8i5yWTYdvf3ujbC5+EawhbqeyFU30ul+R8rSbwz7PKO2HotBfI9cKy74WZ3w03Cfo1b1/t61KVr5gxtmLHvtgkDsuveodq6eAgJttNUiGlFy82qF+095hS/dmxfU7l3VcG3uclsavkW6xEMX+H/MlE1QW6ck8Y/eXIGBSDTTVi9DJDAo6Wsn8qVTXYpkVbaH4FT2wTbBJVcjw22nV+P8Itoxoguj6p7XPhb2Ie87f9QH2u4kHu3qj5RVyX5hY2XXSyNVUiQ2NrfIkS8bxWvli9d6+iGjtSXnb93EUbDj6NnH7rvFmvY+7QSnZpxgvhnWTM9SXg8nmvwi/GdQOBrRIf9g/j80c/iu/2BSuGuqae523T2xnsaPQB+nSNPe3dmnf5FagARhdHo+zxpuulk7bzliyc6twje0tkcn2FGQFk0P9ILPzAYgwy66KxONdKXJP9RN3H1g0L7Z9FV5Le09kzkAQwioDsg5VMph7QHdcyg8axzhj9QkV5dJft0uvDMJXceolCODiA6hYYvnJa/pc83WMS1HTUUhioTBo4wWALp590xh1jX67wCY5kmsbjgrBN8Hys86/YNZK+ApvafFPuTdcplbCzkoL4KzapZVMnyrXt3CihqcGdyrE3hjKMVeNXe8rk6sy2ktY3AzRQapaFkHj3zBtl6XjlYVtnngTBqyMFnkr43MiDkJ2xFekoefSYJ0Qi9+sptsvVOpHG5UxylPY5UGlTn/WXI6PWjUdBWBU7OPS38aBuBs7hCGqTLmR4q6XgL71ThlvhRCA+adq0gJAjrXfkBqBol7ohwkNNN5O3DU0OGNZnO9tZK1nafRNvoDJDiDlQj95sjK9QTIO4Qd4nzuNZQTtyM5PXgTjKfHp6JQwRJZBbb9kYRlyKvQZzQ1bA8a8R/+275dFKfxhM7desv+ooUa+SmbZtK1XESMG9uUJ/qLxUGOgGKbso4jHWw+LZaglyIc6QfbnnY90hBmInp+rJOPDovEQeLHp5ffbXZwupbIfqSv3VTRCY6U8mPA3ynF/Ienf9fP4PcTHyvgkk87Ank0fn9VpVvGfBWX7opuy9bb9Dkc9/crPPUdlHR+OMkePyp2gy8lpB6MFFbKXLEbtDNXxYfO719ojDOM4PYrplKSYh4NpdNP/HL82LTfD6EVgWInMCZ5yZSKS2lKkzVmWj8nY0b1/BFglXbunLqhblZNXgIAsKua5W5ny8ticSbeq5fkqtc2eLlu5g0bDGDK9+wc0wd3H/8Z+6DHGmGi4bnX/2wxP2a3swo2rV2ZMfQapSpfGfuY3HUqpIwBahbYKPwn2E2NOLhAYVu3W6qucXAWISMfVpj5RZ2I5WFQwVFBBl/GdlptMUTiL0LMhaDXfnyYNv4c+bmDza092LVKvieFh5/lYrNd95ogU4B6buw0m468VPiM+GJ7c/iY3B1gVYq82O0O3rYod7ctD7MwObmb0nTdo7eNsR/NHOeeWttU6ZsvFjiHO7yoNJcbrRsRTZONh3SufGgSdWUzPuR6NsptuqFomvLWHctazWUAK2iMhNt8QmY528GVVRzeYWH5AgTHF60E6CRcz6wzbHdG7AXFlVf/rR4v/l8C9zv5lV3Ss778F9mDsTzCgY6niR1OeEa97Jcxn8asgrVegtCRtdOtwDNG+8/QZmpJVx5c5orJX7ULF4sg2lLYI96RtB055OkOAqfofhApO+w+9MEfFfdZooWJxzOh/eI66x8CY0DDgFcdd7chUjRoe2Y46MdxHZnLcwCfJSZwDgQyhs33gZJI5eaVqvIW2tNj8qn11xdD+6P/BN6H2FdKbi6AXpsFAv7vyBVO6v9Y4tSYCalZxETa+J0LQiLt6H1A7rUYCco/WKLwlV/SarMfR3t8tDoUERsuho9GrDRHRwVK7zIBOKAsUOS1AEE65LZ3ed6ynM2ogOTa2rbJvmvixk9gGNc4LJmSvqHNF8GQ/XKi4iq0d6OhwFX2dYDab5nsJsR4i2AnJIr56E+bGv/RBW96DXukBpXeX4EoUl20el5fAMwKL3MGwRJWf9ZsZ7SuGByIodgch0OdAmjMhoHVQw3BkBm4ABD7guyJrU2YFxSsadpGYpzXWsZ8IWAYomAFhVTXJJlZQ7Tt2QKJZeVm1TlNDdDC5U+nVgFK2ZQUheL8satcbRrWHzvOgHzo2u6A02vkzCwrm4Ez5DAEJTqyvqjb/alT0Q7+wgMLLqL7dT2IEsHFJlXsuWDeoQO39thwSGLWdGOlY2TBpO4qcJB7OdgVKdUTRKQuOrPHqMwBW5S3bivE6UluWbJx5745zR/fjLquZCFpwrCSU1yvgqyGj6RqWCv0xl46mt0PT46FTWuDjlFl+zBrA7ScziJmHIA3JoXLHPMDMgSqHASfvDFNv0sOfwyJPFo003M6uJOEDSipVDWnMQQA4aNpxoumnYJCbciMb5t8DwoH/rCsDjiTUYP8b/Xwocs90zcRL38fl3fNtIcKt80EOtbCBI3AMMdA6GZQPDitaVJIxlEccGveu4q9xpmxXs10re7OpPAh2NAI4ezOo/etww8QVkoSmnqftRVnG9QzQ8dJIcb2FiX+P1ii1Q9aqn5uPgpg8giKSQPrYGYKEEx82jYpMFtS2z9xtDqtkt+xryF9Pp+s2M8uf/1BSQaM6FvZUq241DT4CqR8sA6bZWyO0EAGJM7QBQcXciNQihmzuXiEo5Z3hTp8+YM8y6UlNBRo/+CceUlaPvamrzLG7FQ+jZpbosDkkw3156AfswrcdF9gKHUsdfHpYVKeduLKHCqSgQfBoFJCqXuz2XTjldMmzdmideer3ZTNVMl0ayEZKbf8I8psz7081q07Jp2N3/wZeIoXkuRpmsk6mMANtOCaapfTlWXe4/Q+u06jNzpF0elG5f6YSgbmNwCaUekXLe3zRTZMBIypl0Mx9J4XAuTiVCfE4wQYJE+YFg+xpMB5eoeft8rfGT0qeSlf6JoUB/1PhjcRY0eSURX4eO1HjQ8WRpMqgty/ij5fRb3GHXZmF3oK0Hs2eOD+LhAY/77cWk08ErFIEBWOjVScBFDGDwg1uhIA152BIzD/BZ7EZvNvSQVtomt4l3ojY+4IFkz+MfXtQlbKptQOIeuFwyW+/+IIluJKPU5VKPFp+x5brqPjgWgyNgiXuykt3N943Uf02lyQUG5VLQMcBhspPXQjGm+Zp0Nk72kxG5Nd0J36BCwrhajUYTY5A32tZylfCW8wWF4Ps1lANsupyg6liWnYdyN+HpLk2bV5ZQZZMpnS235fMGmUdq1qwt2yRuBAW3OuSGsjnGVeKHePdw+Uxtyej07l2xjo7PGQ2MmQbpPMLIFgFkegyQCBYtAf3Q1S9beJIYI0Jc/3tbazo4/wFamoAGmzoECW0guSJZZiJ/qIpPM+sgJGL50lKoKdjdhhXT70WDfLGUqg4llELxIm1QbHO/CxWbpK09sU6b79uU0s5Si9vkcP+Osdpsz4+DwLZqFe5eO/S19pgdSCYwwP0v48+VAqlpN1Tr+cl8JmoK8v/kEXwA0LP0XVailozD0iFGQdsddrNO7adQq1j/jyFeUXrzxVRGdYsEz68ibN3gha1F5zywKTEpdVS0T1934knPG3gML1WjQHhC011GuZWakY5/EaJrgY6IVOSmGXlIsjeDfmPTjNMq6ZYb3QkrfHt7tlyZ5vjMw0/hbLr3fQ4E3OPy8KlJMDa8oj2h+18yn8PBuewveVhNooYUwaQmEiqNKfs7wp3sEdWWs50FZ9gv7xdtO1xIRu9kTSok7lg4n3Che9cREsJI6Yv1gyMlYygrzWxmMSaYnNkYSqqQt7lC2a4N/h6qMaJh0q4cRJ+mUHd6T0hgyQ0p/k7UOD9kP2bfyxIUX1ky6Zoc+lK67b8FsLEklHM7LPM9BeaLzXRSMWkWvnUwml+XWIgDdngSfk/AGbI6RCUODmr4MPVtLhIAsazrFrRp8cIm5tIPBDlhLtjcCFYe7nP1G/XaSp9HsjA9MCEwCQYFKw4DAhoFAAQUIRcwWzft7vcw7txJ/XfQZ+QsQa4EFIt/mfLE1RsHqwjr0LQlCxr3syVsAgIEAA==","password":"Heslo123"}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Certificate added.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificateInfoDTO"
                },
                "example": {"alias":"88812345678900001","dic":"2020123456","cashRegisterCode":"88812345678900001","issueDate":"2025-03-12T09:41:27+01:00","expirationDate":"2027-03-12T09:41:27+01:00","serialNumber":"2B0A","isNotYetValid":false,"isValid":true,"isAboutToExpire":false,"daysToExpire":416,"isExpired":false}
              }
            }
          },
          "400": {
            "description": "The certificate data is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":"0HLLND37G80V8:00000001","code":-900,"errors":{"Data":["Pole 'Data' nesmie byť prázdne."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","code":null,"traceId":"0HLLNCVD3CIK1:00000001","instance":"/api/v1/certificates"}
              }
            }
          }
        }
      }
    },
    "/api/v1/certificates/latest": {
      "get": {
        "tags": [
          "Certificates"
        ],
        "summary": "Latest certificate",
        "description": "Gets the latest certificate of a cash register, regardless of its validity.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "Certificate found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificateInfoDTO"
                },
                "example": {"alias":"88812345678900001","dic":"2020123456","cashRegisterCode":"88812345678900001","issueDate":"2025-03-12T09:41:27+01:00","expirationDate":"2027-03-12T09:41:27+01:00","serialNumber":"2B0A","isNotYetValid":false,"isValid":true,"isAboutToExpire":false,"daysToExpire":416,"isExpired":false}
              }
            }
          },
          "400": {
            "description": "filter is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":"0HLLND37G80V8:00000001","code":-900,"errors":{"CashRegisterCode":["A value for the 'CashRegisterCode' parameter or property was not provided."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","code":null,"traceId":"0HLLNCVD3CIK1:00000001","instance":"/api/v1/certificates"}
              }
            }
          },
          "404": {
            "description": "No certificate was found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/certificates/valid/latest": {
      "get": {
        "tags": [
          "Certificates"
        ],
        "summary": "Latest valid certificate",
        "description": "Gets the latest currently valid certificate of a cash register.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "Valid certificate found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificateInfoDTO"
                },
                "example": {"alias":"88812345678900001","dic":"2020123456","cashRegisterCode":"88812345678900001","issueDate":"2025-03-12T09:41:27+01:00","expirationDate":"2027-03-12T09:41:27+01:00","serialNumber":"2B0A","isNotYetValid":false,"isValid":true,"isAboutToExpire":false,"daysToExpire":416,"isExpired":false}
              }
            }
          },
          "400": {
            "description": "filter is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":"0HLLND37G80V8:00000001","code":-900,"errors":{"CashRegisterCode":["A value for the 'CashRegisterCode' parameter or property was not provided."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","code":null,"traceId":"0HLLNCVD3CIK1:00000001","instance":"/api/v1/certificates"}
              }
            }
          },
          "404": {
            "description": "No valid certificate was found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/connectivity/status": {
      "get": {
        "tags": [
          "Connectivity"
        ],
        "summary": "Get connectivity status",
        "description": "Gets the current connectivity status.",
        "responses": {
          "200": {
            "description": "Connectivity status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectivityMonitorStatusDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/health": {
      "get": {
        "tags": [
          "Health"
        ],
        "summary": "Get health status",
        "description": "Gets the health of the cash register.\r\n\r\nWhen authentication is enabled, an unauthenticated client receives 401 with an authentication\r\nchallenge, as with the rest of the API. Only the overall state and the states of the individual checks\r\n(`details=false`) are available to every client.",
        "parameters": [
          {
            "name": "tag",
            "in": "query",
            "description": "Optional list of tags that limits the checks performed. Pass it as a repeated parameter\r\n(`?tag=storage&tag=queue`) or as a comma-separated list (`?tag=storage,queue`). Checks\r\nmarked with at least one of the tags are performed; without any tag, all checks are performed. An\r\nunknown tag results in 400 with the list of available tags.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "details",
            "in": "query",
            "description": "`false` returns only the overall state and the states of the individual checks, without their\r\n             description and data (`description`, `data`). This is available to every client, even\r\n             without authentication, e.g. for monitoring whether the API is running. Defaults to `true`.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Health report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthReportDTO"
                }
              }
            }
          },
          "400": {
            "description": "The query contains an unknown tag.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "401": {
            "description": "Authentication is required for the full report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuthenticationProblemDetails"
                }
              }
            }
          }
        }
      },
      "head": {
        "tags": [
          "Health"
        ],
        "summary": "Get health status",
        "description": "Gets the health of the cash register.\r\n\r\nWhen authentication is enabled, an unauthenticated client receives 401 with an authentication\r\nchallenge, as with the rest of the API. Only the overall state and the states of the individual checks\r\n(`details=false`) are available to every client.",
        "parameters": [
          {
            "name": "tag",
            "in": "query",
            "description": "Optional list of tags that limits the checks performed. Pass it as a repeated parameter\r\n(`?tag=storage&tag=queue`) or as a comma-separated list (`?tag=storage,queue`). Checks\r\nmarked with at least one of the tags are performed; without any tag, all checks are performed. An\r\nunknown tag results in 400 with the list of available tags.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "details",
            "in": "query",
            "description": "`false` returns only the overall state and the states of the individual checks, without their\r\n             description and data (`description`, `data`). This is available to every client, even\r\n             without authentication, e.g. for monitoring whether the API is running. Defaults to `true`.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Health report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthReportDTO"
                }
              }
            }
          },
          "400": {
            "description": "The query contains an unknown tag.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "401": {
            "description": "Authentication is required for the full report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuthenticationProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/identities": {
      "get": {
        "tags": [
          "Identities"
        ],
        "summary": "Latest identities",
        "description": "Finds the latest identity of each cash register.",
        "responses": {
          "200": {
            "description": "List of identities.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityDTO"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Identities"
        ],
        "summary": "Add identity",
        "description": "Adds an identity.",
        "requestBody": {
          "description": "Identity to add.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IdentityDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The added identity.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/identities/{cashRegisterCode}": {
      "get": {
        "tags": [
          "Identities"
        ],
        "summary": "Latest identity",
        "description": "Gets the latest identity of a cash register.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "path",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "required": true,
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "Identity found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityDTO"
                }
              }
            }
          },
          "404": {
            "description": "No identity was found for the cash register code.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","instance":"/api/v1/certificates"}
              }
            }
          }
        }
      }
    },
    "/api/v1/index_table/status": {
      "get": {
        "tags": [
          "IndexTable"
        ],
        "summary": "Get index table status",
        "description": "Gets the status of the index table.",
        "responses": {
          "200": {
            "description": "Index table status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IndexTableStatusDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/index_table/restore": {
      "post": {
        "tags": [
          "IndexTable"
        ],
        "summary": "Restore index table",
        "description": "Restores the index table from the records in the CHDÚ storage.",
        "parameters": [
          {
            "name": "mode",
            "in": "query",
            "description": "Restoration mode: `Full` reads the storage from the first block to the last used block,\r\n`BackwardsPartial` reads it from the end back to the last backup record.",
            "schema": {
              "$ref": "#/components/schemas/IndexTableRestorationMode"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Index table restored."
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": { }
              }
            }
          }
        }
      }
    },
    "/api/v1/index_table/clear": {
      "post": {
        "tags": [
          "IndexTable"
        ],
        "summary": "Clear index table",
        "description": "Clears the index table.",
        "responses": {
          "200": {
            "description": "Index table cleared."
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": { }
              }
            }
          }
        }
      }
    },
    "/api/v1/license/verify": {
      "post": {
        "tags": [
          "License"
        ],
        "summary": "Verify license",
        "description": "Verifies the license of the connected CHDÚ storage.",
        "parameters": [
          {
            "name": "force",
            "in": "query",
            "description": "`true` to obtain the license again instead of using the cached result.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "License verification result.",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseVerificationResultDTO"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseVerificationResultDTO"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseVerificationResultDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/logs": {
      "get": {
        "tags": [
          "Logs"
        ],
        "summary": "Download logs",
        "description": "Downloads the application logs.\r\n\r\nThe format of the returned logs is determined by the \"Accept\" HTTP header. Use \"application/zip\" (or \"*/*\")\r\nfor a ZIP archive.",
        "responses": {
          "200": {
            "description": "ZIP archive with the application logs."
          },
          "406": {
            "description": "The `Accept` header does not allow `application/zip`."
          }
        }
      }
    },
    "/api/v1/payments/qr": {
      "post": {
        "tags": [
          "Payments"
        ],
        "summary": "Create QR payment",
        "description": "Creates a new QR payment.\r\n\r\nObtains the QR payment identifier, which is the first step of a QR payment. The payment ID is generated by\r\nthe eKasa system of the Financial Administration. The calling application should keep the payment ID in case\r\nan error occurs later in the payment process. The payment status can be retrieved repeatedly using the\r\npayment ID.",
        "requestBody": {
          "description": "QR payment request.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QrPaymentRequestDTO"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "QR payment created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentDTO"
                },
                "example": {"transactionId":"QR-618300cdd6d64580bad8353dc2a394c5","amount":7.59,"currencyCode":"EUR","merchant":{"iban":"SK4811000000002944116480","name":"Kaviaren Pod Hradom, s.r.o."},"cashRegisterCode":"88812345678900001","createdAt":"2026-01-20T10:15:00+01:00","expiresAt":"2026-01-20T10:17:00+01:00","payments":[],"status":"pending","paidAmount":0.00,"remainingAmount":7.59,"overpaidAmount":0.00,"links":[{"provider":"payme","version":"2.0","url":"https://payme.sk/2/m/PME?IBAN=SK4811000000002944116480&AM=7.59&CC=EUR&PI=QR-618300cdd6d64580bad8353dc2a394c5&CN=Kaviaren+Pod+Hradom%2C+s.r.o."}]}
              }
            }
          },
          "500": {
            "description": "The QR payment could not be initiated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentInitializationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-701-qrpaymentinitializationerror","title":"Chyba vytvorenia QR platby","status":500,"detail":"Nepodarilo sa nadviazať sieťové spojenie so službou okamžitých platieb.","code":-701,"traceId":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/payments/qr/{id}": {
      "get": {
        "tags": [
          "Payments"
        ],
        "summary": "Get QR payment",
        "description": "Gets a QR payment.\r\n\r\nReturns information about the QR payment.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "QR payment ID (transaction ID) returned when the payment was created.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "await",
            "in": "query",
            "description": "`false` returns the response immediately with the current payment status, `true` returns it\r\n             only after the payment is completed. Defaults to `false`.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "QR payment found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentDTO"
                },
                "example": {"transactionId":"QR-618300cdd6d64580bad8353dc2a394c5","amount":7.59,"currencyCode":"EUR","merchant":{"iban":"SK4811000000002944116480","name":"Kaviaren Pod Hradom, s.r.o."},"cashRegisterCode":"88812345678900001","createdAt":"2026-01-20T10:15:00+01:00","expiresAt":"2026-01-20T10:17:00+01:00","payments":[],"status":"pending","paidAmount":0.00,"remainingAmount":7.59,"overpaidAmount":0.00,"links":[{"provider":"payme","version":"2.0","url":"https://payme.sk/2/m/PME?IBAN=SK4811000000002944116480&AM=7.59&CC=EUR&PI=QR-618300cdd6d64580bad8353dc2a394c5&CN=Kaviaren+Pod+Hradom%2C+s.r.o."}]}
              }
            }
          },
          "404": {
            "description": "The QR payment was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentNotFoundProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-702-qrpaymentnotfoundnerror","title":"QR platba nebola nájdená","status":404,"detail":"QR platba s identifikátorom 'QR-618300cdd6d64580bad8353dc2a394c5' nebola nájdená.","code":-702,"traceId":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/payments/qr/{id}/render": {
      "post": {
        "tags": [
          "Payments"
        ],
        "summary": "Render QR payment",
        "description": "Renders a QR payment.\r\n\r\nDisplays the QR payment using the rendering method specified in the request body.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "QR payment ID (transaction ID) returned when the payment was created.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Render request specifying the rendering method.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QrPaymentRenderRequestDTO"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The QR payment was rendered."
          },
          "404": {
            "description": "The QR payment was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentNotFoundProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-702-qrpaymentnotfoundnerror","title":"QR platba nebola nájdená","status":404,"detail":"QR platba s identifikátorom 'QR-618300cdd6d64580bad8353dc2a394c5' nebola nájdená.","code":-702,"traceId":null}
              }
            }
          },
          "500": {
            "description": "The QR payment could not be rendered.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/payments/qr/{id}/print_non_delivery_notice": {
      "post": {
        "tags": [
          "Payments"
        ],
        "summary": "Print non-delivery notice",
        "description": "Prints a non-delivery notice for a QR payment whose completion was not confirmed.\r\n\r\nPrints a notice that the QR payment was not processed, for the case when the cash register does not receive\r\nconfirmation of the payment within the time limit.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "QR payment ID (transaction ID) returned when the payment was created.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The notice was printed."
          },
          "404": {
            "description": "The QR payment was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentNotFoundProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-702-qrpaymentnotfoundnerror","title":"QR platba nebola nájdená","status":404,"detail":"QR platba s identifikátorom 'QR-618300cdd6d64580bad8353dc2a394c5' nebola nájdená.","code":-702,"traceId":null}
              }
            }
          },
          "500": {
            "description": "The notice could not be printed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QrPaymentProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/printers/pdf/receipt": {
      "get": {
        "tags": [
          "Printers"
        ],
        "summary": "Get receipt PDF",
        "description": "Gets the PDF file of a receipt.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          },
          {
            "name": "Year",
            "in": "query",
            "description": "Year the receipt was issued, from 2019 to 9999. Required together with `Month` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "Month",
            "in": "query",
            "description": "Month the receipt was issued, from 1 to 12. Required together with `Year` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ReceiptNumber",
            "in": "query",
            "description": "Receipt number, from 1 to 4294967295. Required unless `Id` or `ExternalId` is set.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "PDF file of the receipt."
          },
          "404": {
            "description": "The PDF file of the receipt was not found."
          }
        }
      }
    },
    "/api/v1/printers/status": {
      "get": {
        "tags": [
          "Printers"
        ],
        "summary": "Get printer status",
        "description": "Gets the printer status.\r\n\r\nA printer error may (depending on the type of storage used) prevent printing receipts or opening the cash\r\ndrawer.",
        "parameters": [
          {
            "name": "printerName",
            "in": "query",
            "description": "Printer name; the default printer when omitted.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Printer status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrinterStatusDTO"
                },
                "example": {"state":"Ready","paperState":"NearEnd","errorState":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/printers/{printerName}/info": {
      "get": {
        "tags": [
          "Printers"
        ],
        "summary": "Get printer info",
        "description": "Gets information about a printer.\r\n\r\nSome built-in printers have the number of characters per line fixed by the application, so the values\r\nactually used for printing may differ from the settings. The values may also differ depending on\r\nwhether an external printer is currently connected.",
        "parameters": [
          {
            "name": "printerName",
            "in": "path",
            "description": "Printer name.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Printer information.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrinterInfoDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/printers/print": {
      "post": {
        "tags": [
          "Printers"
        ],
        "summary": "Print non-fiscal document",
        "description": "Prints a non-fiscal document on the default printer.\r\n\r\nPrints a non-fiscal document on the printer. The printed data is stored in the CHDÚ storage.",
        "requestBody": {
          "description": "Text output to print.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TextPrintContextDTO"
              },
              "example": {"text":"This is the content of non-fiscal print output. Please see formatting options in the documentation.","contentFlags":["PriceInformation"],"cashRegisterCode":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The non-fiscal document was printed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrintResultDTO"
                },
                "example": {"printed":true}
              }
            }
          },
          "202": {
            "description": "The request was accepted, but the printer was not ready at the time of printing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrintResultDTO"
                },
                "example": {"printed":false}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/printers/open_drawer": {
      "post": {
        "tags": [
          "Printers"
        ],
        "summary": "Open cash drawer",
        "description": "Opens the cash drawer.\r\n\r\nOpens the cash drawer if it is connected to the printer.",
        "parameters": [
          {
            "name": "pin",
            "in": "query",
            "description": "Pin number on the cash drawer connector; the pin from the application configuration when omitted.",
            "schema": {
              "$ref": "#/components/schemas/DrawerPin"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The command to open the cash drawer was sent to the printer.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenDrawerResultDTO"
                },
                "example": {"opened":true}
              }
            }
          },
          "202": {
            "description": "The request was accepted, but the printer was not ready when the open drawer command was sent.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenDrawerResultDTO"
                },
                "example": {"opened":false}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/product/info": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "Get product info",
        "description": "Gets information about the API, the cash register software and the currently connected CHDÚ storage.",
        "responses": {
          "200": {
            "description": "Information about the API, the cash register software and the currently connected CHDÚ storage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EKasaProductInfoDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/product/info/ppekk": {
      "get": {
        "tags": [
          "Product"
        ],
        "summary": "Get PPEKK info",
        "description": "Gets information about the cash register software (PPEKK).",
        "responses": {
          "200": {
            "description": "Name and version of the cash register software.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductIdDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/queue/items/unprocessed": {
      "get": {
        "tags": [
          "Queue"
        ],
        "summary": "Get unsent messages",
        "description": "Gets the unsent data messages from the queue.\r\n\r\nUse a GET request to get the data messages from the queue. To get only their count, use a HEAD request: the\r\nresponse body is empty, the HTTP status code is 204 and the 'Content-Range' header contains the number of\r\nmessages.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "State",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegisterTokenFilterState"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all messages when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all messages when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterTokenDTO"
                  }
                },
                "example": [{"requestContext":{"type":"Receipt","id":"0826db63-a26a-450f-8502-68543b4378be","externalId":null,"uuid":"15641aab-b70c-4b3b-82bf-eb948c835b96","originUUID":"f7f5e7c8-2598-4dfb-a0f1-d07e6207e53e","createDate":"2026-01-20T09:55:00+01:00","cashRegisterCode":"88812345678900001","receiptNumber":7,"sendingCount":3},"result":null,"error":null,"state":"Created"}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          },
          "500": {
            "description": "Unexpected error."
          }
        }
      },
      "head": {
        "tags": [
          "Queue"
        ],
        "summary": "Get unsent messages",
        "description": "Gets the unsent data messages from the queue.\r\n\r\nUse a GET request to get the data messages from the queue. To get only their count, use a HEAD request: the\r\nresponse body is empty, the HTTP status code is 204 and the 'Content-Range' header contains the number of\r\nmessages.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "State",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegisterTokenFilterState"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all messages when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all messages when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterTokenDTO"
                  }
                },
                "example": [{"requestContext":{"type":"Receipt","id":"0826db63-a26a-450f-8502-68543b4378be","externalId":null,"uuid":"15641aab-b70c-4b3b-82bf-eb948c835b96","originUUID":"f7f5e7c8-2598-4dfb-a0f1-d07e6207e53e","createDate":"2026-01-20T09:55:00+01:00","cashRegisterCode":"88812345678900001","receiptNumber":7,"sendingCount":3},"result":null,"error":null,"state":"Created"}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          },
          "500": {
            "description": "Unexpected error."
          }
        }
      }
    },
    "/api/v1/requests/receipts": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register receipt",
        "description": "Registers a receipt of any type.",
        "requestBody": {
          "description": "Receipt registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"payments":[{"name":"Hotovosť","amount":7.60}],"roundingAmount":0.0,"receiptType":"Invalid","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Find receipt registrations",
        "description": "Finds receipt registrations.\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationRecordProcessStatus"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      },
      "head": {
        "tags": [
          "Requests"
        ],
        "summary": "Find receipt registrations",
        "description": "Finds receipt registrations.\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationRecordProcessStatus"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      }
    },
    "/api/v1/requests/receipts/cash_register": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register cash register receipt",
        "description": "Registers a cash register receipt.",
        "requestBody": {
          "description": "Cash register receipt registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterCashRegisterReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"payments":[{"name":"Hotovosť","amount":7.60}],"roundingAmount":0.0,"receiptType":"CashRegister","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/paragon": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register paragon",
        "description": "Registers a paragon.",
        "requestBody": {
          "description": "Paragon registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterParagonReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"issueDate":"2026-01-18T10:15:00+01:00","paragonNumber":1,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"payments":[{"name":"Hotovosť","amount":7.60}],"roundingAmount":0.0,"receiptType":"Paragon","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/invoice": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register invoice receipt",
        "description": "Registers an invoice payment receipt.",
        "requestBody": {
          "description": "Invoice payment receipt registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterInvoiceReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"amount":186.00,"roundingAmount":0.0,"invoiceNumber":"FA-2026-0012","payments":null,"receiptType":"Invoice","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/invoice_paragon": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register invoice paragon",
        "description": "Registers an invoice payment paragon.",
        "requestBody": {
          "description": "Invoice payment paragon registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterInvoiceParagonReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"issueDate":"2026-01-18T10:15:00+01:00","invoiceNumber":"FA-2026-0012","paragonNumber":1,"amount":186.00,"roundingAmount":0.0,"payments":null,"receiptType":"InvoiceParagon","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/invalid": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register invalid receipt",
        "description": "Registers an invalid receipt.",
        "requestBody": {
          "description": "Invalid receipt registration request with optional print settings.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterInvalidReceiptRequestContextDTO"
              },
              "example": {"request":{"data":{"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"payments":[{"name":"Hotovosť","amount":7.60}],"roundingAmount":0.0,"receiptType":"Invalid","headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","cashRegisterCode":"88812345678900001"},"externalId":null},"print":null}
            }
          }
        },
        "responses": {
          "200": {
            "description": "The receipt was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the receipt was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "400": {
            "description": "The receipt is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IApiProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Tlačiareň 'pdf12' nebola nájdená.","code":null,"traceId":"0HLLN8QFOGJQN:00000002","instance":"/api/v1/requests/receipts/cash_register"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/print_copy": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Print receipt copy",
        "description": "Prints a copy of a receipt.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          },
          {
            "name": "Year",
            "in": "query",
            "description": "Year the receipt was issued, from 2019 to 9999. Required together with `Month` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "Month",
            "in": "query",
            "description": "Month the receipt was issued, from 1 to 12. Required together with `Year` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ReceiptNumber",
            "in": "query",
            "description": "Receipt number, from 1 to 4294967295. Required unless `Id` or `ExternalId` is set.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The receipt copy was printed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrintResultDTO"
                },
                "example": {"printed":false}
              }
            }
          },
          "202": {
            "description": "The request was accepted, but the printer was not ready at the time of printing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrintResultDTO"
                },
                "example": {"printed":false}
              }
            }
          },
          "403": {
            "description": "The receipt copy cannot be printed, e.g. the receipt was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-104-receiptnotfound","title":"Doklad sa nenašiel","status":403,"code":-104,"traceId":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/receipt": {
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Find receipt",
        "description": "Finds a receipt.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          },
          {
            "name": "Year",
            "in": "query",
            "description": "Year the receipt was issued, from 2019 to 9999. Required together with `Month` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "Month",
            "in": "query",
            "description": "Month the receipt was issued, from 1 to 12. Required together with `Year` and `ReceiptNumber`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ReceiptNumber",
            "in": "query",
            "description": "Receipt number, from 1 to 4294967295. Required unless `Id` or `ExternalId` is set.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The receipt was found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterReceiptResultDTO"
                },
                "example": {"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}}
              }
            }
          },
          "404": {
            "description": "The receipt was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","instance":"/api/v1/certificates"}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/receipts/next_number": {
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Get next receipt number",
        "description": "Gets the number of the next receipt.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "Unique receipt identifier from the client's numbering whose number will be used by the next receipt registration request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReceiptIdDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/locations/current": {
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Get current locations",
        "description": "Finds the current locations of the cash registers.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits; `null` to not filter by cash register.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "List of the current cash register locations.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterLocationResultDTO"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/locations": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register location",
        "description": "Registers a location of any type.",
        "requestBody": {
          "description": "Location registration request of a portable cash register.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterLocationRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The location was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the location was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/locations/gps": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register GPS location",
        "description": "Registers a GPS location.",
        "requestBody": {
          "description": "Location registration request of a portable cash register as GPS coordinates.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterGpsLocationRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The location was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the location was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/locations/address": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register address location",
        "description": "Registers a location as a physical address.",
        "requestBody": {
          "description": "Location registration request of a portable cash register as a physical address.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterPhysicalAddressLocationRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The location was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the location was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests/locations/other": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Register other location",
        "description": "Registers a location in free-form text.",
        "requestBody": {
          "description": "Location registration request of a portable cash register in another format.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterOtherLocationRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The location was registered in the eKasa system.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          },
          "202": {
            "description": "The request was accepted and stored, but the location was not registered in the eKasa system (it will be sent later from the queue).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegisterLocationResultDTO"
                },
                "example": {"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null}
              }
            }
          }
        }
      }
    },
    "/api/v1/requests": {
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Find registrations",
        "description": "Finds the registration results of receipts and locations.\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationRecordProcessStatus"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}},{"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"GPS","longitude":48.142233,"latitude":17.100189},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"Other","value":"Taxi BL-123AA"},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      },
      "head": {
        "tags": [
          "Requests"
        ],
        "summary": "Find registrations",
        "description": "Finds the registration results of receipts and locations.\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Processing state of the request.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationRecordProcessStatus"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}},{"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"GPS","longitude":48.142233,"latitude":17.100189},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"Other","value":"Taxi BL-123AA"},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      }
    },
    "/api/v1/requests/unprocessed": {
      "get": {
        "tags": [
          "Requests"
        ],
        "summary": "Find unprocessed registrations",
        "description": "Finds the results of unprocessed registrations (not yet registered in the eKasa system).\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}},{"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"GPS","longitude":48.142233,"latitude":17.100189},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"Other","value":"Taxi BL-123AA"},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      },
      "head": {
        "tags": [
          "Requests"
        ],
        "summary": "Find unprocessed registrations",
        "description": "Finds the results of unprocessed registrations (not yet registered in the eKasa system).\r\n\r\nA `HEAD` request returns 204 with an empty body and the total count of matching registrations in\r\nthe `Content-Range` header.",
        "parameters": [
          {
            "name": "Type",
            "in": "query",
            "description": "Request type. Receipt number bounds are allowed only for the `Receipt` type.",
            "schema": {
              "$ref": "#/components/schemas/RegistrationType"
            }
          },
          {
            "name": "Id",
            "in": "query",
            "description": "Unique identifier of the request.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "ExternalId",
            "in": "query",
            "description": "Client-defined unique identifier of the request (1 to 40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ReceiptNumberFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the receipt number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ReceiptNumberTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the receipt number; must not be lower than the lower bound.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "DateFrom",
            "in": "query",
            "description": "Lower bound (inclusive) of the creation date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateTo",
            "in": "query",
            "description": "Upper bound (inclusive) of the creation date; must not be earlier than the lower bound.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Skip",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Take",
            "in": "query",
            "description": "Pagination; all registrations when omitted.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET request succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RegisterResultDTO"
                  }
                },
                "example": [{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"data":{"id":"O-7DBCDA8A56EE426DBCDA8A56EE426D1A"},"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":null,"error":null},{"$type":"Receipt","request":{"data":{"receiptType":"CashRegister","amount":7.60,"roundingAmount":0.01,"issueDate":"2026-01-20T10:15:00+01:00","receiptNumber":2,"invoiceNumber":null,"paragonNumber":null,"icdph":"SK1234567890","ico":"76543210","basicVatAmount":null,"reducedVatAmount":0.93,"secondReducedVatAmount":0.09,"taxFreeAmount":null,"nonTaxableAmount":null,"taxBaseBasic":null,"taxBaseReduced":4.87,"taxBaseSecondReduced":1.70,"items":[{"type":"Positive","name":"Cappuccino","price":5.80,"unitPrice":2.90,"quantity":{"amount":2.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":19.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":"Dvojité espresso s napeneným mliekom."},{"type":"Positive","name":"Maslový croissant","price":1.79,"unitPrice":1.79,"quantity":{"amount":1.0000,"unit":"ks"},"referenceReceiptId":null,"vatRate":5.0,"specialRegulation":null,"voucherNumber":null,"seller":null,"description":null}],"vatRatesTaxSummary":null,"okp":"04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0","pkp":"GYTIYJs5LL1uYIJJZa1Drt5U138nMsKfWn8lAbwwoGoRnhWWvoKUcqlyvH1kj97zpldDvzgWRGM0RHerb+an8CqLO5TfDHzJFGyV36EJA9i1fWl+kFofWjmuRLsTvumJPYaBTjHroL7lvyZbSZUF6CWnYOpPkmeNnQR7QZHhQDJrrtQUz9/yWQ6wvzjLK5gic3lh/l0bvtRKfUeSYis4xIwII2N+N/zCn1Py/lj9f6QgEDECT0+uh1sU8XN/ALrrtaHUfeNxWhNDOJu6+yov1OiUdi1Zw5FsVRMrmn56eo8BO1igaa1HakGTae5bNPwbZZWvDawIU6qNqiVhjwrguw==","payments":[{"name":"Hotovosť","amount":7.60}],"headerText":"Kaviareň Pod Hradom","footerText":"Ďakujeme za návštevu!","createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":null,"isSuccessful":false,"error":{"message":"Zlé vstupné hodnoty","code":-2}},{"$type":"Location","request":{"data":{"location":{"$type":"Address","streetName":"Zámocká","municipality":"Bratislava","buildingNumber":"12","postalCode":"81101","propertyRegistrationNumber":1234},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"GPS","longitude":48.142233,"latitude":17.100189},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null},{"$type":"Location","request":{"data":{"location":{"$type":"Other","value":"Taxi BL-123AA"},"createDate":"2026-01-20T10:15:00+01:00","dic":"1234567890","cashRegisterCode":"88812345678900001"},"id":"00000000-0000-0000-0000-000000000000","externalId":null,"date":"2026-01-20T10:15:00+01:00","sendingCount":1},"response":{"processDate":"2026-01-20T10:15:01+01:00"},"isSuccessful":true,"error":null}]
              }
            }
          },
          "204": {
            "description": "HEAD request succeeded."
          }
        }
      }
    },
    "/api/v1/requests/unprocessed/process": {
      "post": {
        "tags": [
          "Requests"
        ],
        "summary": "Process unprocessed requests",
        "description": "Starts processing of the unprocessed requests in the background.",
        "parameters": [
          {
            "name": "cashRegisterCode",
            "in": "query",
            "description": "Optional cash register code (ORP) whose unprocessed requests are processed.",
            "schema": {
              "pattern": "^[0-9]{16,17}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Processing was started."
          }
        }
      }
    },
    "/api/v1/settings": {
      "get": {
        "tags": [
          "Settings"
        ],
        "summary": "Get settings",
        "description": "Gets the current settings.",
        "responses": {
          "200": {
            "description": "The saved settings.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConfigurationDto"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Settings"
        ],
        "summary": "Save settings",
        "description": "Saves new settings.\r\n\r\nValues that are not specified are replaced with the last saved values.",
        "requestBody": {
          "description": "Settings to save.",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "$ref": "#/components/schemas/ApiConfigurationDto"
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiConfigurationDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiConfigurationDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ApiConfigurationDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Settings saved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConfigurationDto"
                }
              }
            }
          },
          "400": {
            "description": "The settings are invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiValidationProblemDetails"
                },
                "example": {"type":"https://ekasa.ninedigit.sk/docs/rest-api/error-codes#900-validationerror","title":"One or more validation errors occurred.","status":400,"traceId":null,"code":-900,"errors":{"Items[0].Name":["Názov nesmie byť prázdny."]}}
              }
            }
          }
        }
      }
    },
    "/api/v1/settings/hosting/https/certificates/pfx": {
      "get": {
        "tags": [
          "Settings"
        ],
        "summary": "Download HTTPS certificate",
        "description": "Downloads the public HTTPS certificate of the service (without the private key) for installation in the\r\nclient's trusted certificate store.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Format: `der` (binary, .cer) or `pem` (text, .crt). Defaults to `der`.",
            "schema": {
              "$ref": "#/components/schemas/HostingCertificateExportFormat"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The certificate file."
          },
          "404": {
            "description": "No HTTPS certificate is available.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                },
                "example": {"title":"Internal server error","status":500,"detail":"Specified method is not supported.","instance":"/api/v1/certificates"}
              }
            }
          }
        }
      }
    },
    "/api/v1/storage/info": {
      "get": {
        "tags": [
          "Storage"
        ],
        "summary": "Get storage info",
        "description": "Gets information about the CHDÚ storage.\r\n\r\nReturns information about the storage selected in the application configuration.",
        "responses": {
          "200": {
            "description": "CHDÚ storage information.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorageInfoDTO"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/storage/devices": {
      "get": {
        "tags": [
          "Storage"
        ],
        "summary": "List storage devices",
        "description": "Lists all connected CHDÚ storage devices.\r\n\r\nLists the available storage devices connected to the computer. To use one of the devices, update the CHDÚ\r\nstorage port in the application settings.",
        "responses": {
          "200": {
            "description": "List of currently connected devices.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StorageDeviceDTO"
                  }
                },
                "example": [{"type":"SerialPort","vendorId":4292,"vendorName":"Silicon Labs","productId":60000,"productName":"CP2102N USB to UART Bridge Controller","serialPortName":"COM3","storageModel":"ChduSk","serialNumber":null,"storageVersion":null},{"type":"SerialPort","vendorId":1155,"vendorName":"STMicroelectronics","productId":22336,"productName":"CHDU Lite VCP","serialPortName":"COM4","storageModel":"ChduLite","serialNumber":null,"storageVersion":null}]
              }
            }
          }
        }
      }
    },
    "/api/v1/storage/last_receipt_number": {
      "get": {
        "tags": [
          "Storage"
        ],
        "summary": "Get last receipt number",
        "description": "Gets the number of the last receipt stored in the CHDÚ storage.",
        "parameters": [
          {
            "name": "CashRegisterCode",
            "in": "query",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "schema": {
              "type": "string",
              "example": "88812345678900001"
            },
            "example": "88812345678900001"
          }
        ],
        "responses": {
          "200": {
            "description": "The last stored receipt was found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReceiptIdDTO"
                }
              }
            }
          },
          "204": {
            "description": "No receipt of the cash register is stored in the CHDÚ storage."
          }
        }
      }
    },
    "/api/v1/system/restart": {
      "head": {
        "tags": [
          "System"
        ],
        "summary": "Restart service",
        "description": "Restarts the eKasa API service at the application level, without restarting the application at the\r\noperating system level (the Windows service or the macOS daemon).\r\n\r\nThe response is returned immediately and the restart runs in the background, because the restart shuts\r\ndown the very host that serves this request. The client should poll `GET /api/v1/health` to find\r\nout when the API is available again. A `HEAD` request does not restart the service.",
        "responses": {
          "204": {
            "description": "The restart was scheduled."
          }
        }
      },
      "post": {
        "tags": [
          "System"
        ],
        "summary": "Restart service",
        "description": "Restarts the eKasa API service at the application level, without restarting the application at the\r\noperating system level (the Windows service or the macOS daemon).\r\n\r\nThe response is returned immediately and the restart runs in the background, because the restart shuts\r\ndown the very host that serves this request. The client should poll `GET /api/v1/health` to find\r\nout when the API is available again. A `HEAD` request does not restart the service.",
        "responses": {
          "204": {
            "description": "The restart was scheduled."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApiAuthenticationConfigurationDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether requests must be authenticated. At least one user is required when enabled."
          },
          "requireHttps": {
            "type": "boolean",
            "description": "Whether requests with HTTP Basic credentials over plain HTTP are rejected (HTTP 401).\r\nRequires HTTPS to be enabled. When omitted, the stored value is kept.",
            "nullable": true
          },
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiUserAuthenticationConfigurationDto"
            },
            "description": "Users allowed to sign in.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Authentication settings of the HTTP API."
      },
      "ApiCertificatesConfigurationDto": {
        "type": "object",
        "properties": {
          "pfx": {
            "type": "string",
            "description": "Base64-encoded PFX (PKCS#12) certificate with its private key. Never returned in responses; send it to replace the stored certificate.",
            "nullable": true
          },
          "password": {
            "type": "string",
            "description": "Optional password of the PFX certificate. Never returned in responses; send it to replace the stored password.",
            "nullable": true
          },
          "hasPfx": {
            "type": "boolean",
            "description": "In responses, whether a certificate is stored. In requests, `false` removes the stored certificate;\r\n`null` or `true` keeps it unless NineDigit.eKasa.API.Configuration.ApiCertificatesConfigurationDto.Pfx is sent.",
            "nullable": true
          },
          "hasPassword": {
            "type": "boolean",
            "description": "In responses, whether a certificate password is stored. In requests, `false` removes the stored password;\r\n`null` or `true` keeps it unless NineDigit.eKasa.API.Configuration.ApiCertificatesConfigurationDto.Password is sent.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Certificate of the HTTPS endpoint."
      },
      "ApiConfigurationDto": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "integer",
            "description": "Schema version of the stored configuration, used for one-time migrations.",
            "format": "int32"
          },
          "authentication": {
            "$ref": "#/components/schemas/ApiAuthenticationConfigurationDto"
          },
          "cors": {
            "$ref": "#/components/schemas/ApiCorsConfigurationDto"
          },
          "hosting": {
            "$ref": "#/components/schemas/ApiHostingConfigurationDto"
          },
          "extensions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ApiExtensionOptionsDto"
            },
            "description": "Settings of the API extensions, keyed by extension name (case-insensitive).",
            "nullable": true
          },
          "cultureName": {
            "type": "string",
            "description": "Culture used for texts printed on receipts and for messages, for example sk-SK.",
            "nullable": true,
            "example": "sk-SK"
          },
          "storage": {
            "$ref": "#/components/schemas/ClientStorageConfigurationDTO"
          },
          "eKasaClient": {
            "$ref": "#/components/schemas/ClientEKasaClientConfigurationDTO"
          },
          "queueProcessor": {
            "$ref": "#/components/schemas/ClientQueueProcessorConfigurationDTO"
          },
          "dateTimeProvider": {
            "$ref": "#/components/schemas/ClientDateTimeProviderConfigurationDTO"
          },
          "connectivityMonitor": {
            "$ref": "#/components/schemas/ClientInternetConnectivityMonitorConfigurationDTO"
          },
          "printers": {
            "$ref": "#/components/schemas/ClientPrintersConfigurationDTO"
          },
          "qrPayments": {
            "$ref": "#/components/schemas/ClientQrPaymentsConfigurationDTO"
          }
        },
        "additionalProperties": false,
        "description": "Settings of the eKasa client and its HTTP API."
      },
      "ApiCorsConfigurationDto": {
        "type": "object",
        "properties": {
          "allowOrigins": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Origins allowed to call the API from a browser.",
            "nullable": true
          },
          "allowPrivateNetworkAccess": {
            "type": "boolean",
            "description": "Whether browsers may call the API from public websites (Private Network Access); `null` uses the default.",
            "nullable": true
          },
          "exposedHeaders": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional response headers exposed to browser scripts.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "CORS (cross-origin resource sharing) settings of the HTTP API."
      },
      "ApiErrorCode": {
        "enum": [
          "Unknown",
          "Unauthenticated",
          "ValidationError",
          "QrPaymentNotFoundError",
          "QrPaymentInitializationError",
          "QrPaymentError",
          "LicenseVerificationInProgress",
          "LicenseNotActivated",
          "LicenseInvalidError",
          "LicenseError",
          "PrinterNotReady",
          "PrintReceiptError",
          "PrinterNotFound",
          "PrinterError",
          "StorageForbiddenDeviceModel",
          "StorageForbiddenEKasaEnvironment",
          "StorageAmbiguity",
          "StorageNotFound",
          "StorageDuplicateKey",
          "StorageDICMismatch",
          "StorageInsufficientSpace",
          "StorageError",
          "CertificateExpired",
          "CertificateNotFound",
          "CertificateError",
          "IdentityNotFound",
          "ServiceUnavailable",
          "InvalidEKasaEnvironment",
          "ReceiptNotFound",
          "InvalidReceiptNumber",
          "InvalidTime",
          "ClientLocked",
          "GeneralError"
        ],
        "type": "string",
        "description": "Error code of an API error response.\n\n- `Unknown`: Unknown error.\n- `Unauthenticated`: The caller is not authenticated.\n- `ValidationError`: Validation failed.\n- `QrPaymentNotFoundError`: The QR payment was not found.\n- `QrPaymentInitializationError`: Creating the QR payment failed.\n- `QrPaymentError`: QR payment error.\n- `LicenseVerificationInProgress`: License verification is in progress.\n- `LicenseNotActivated`: The license is not activated.\n- `LicenseInvalidError`: The license is invalid.\n- `LicenseError`: License error.\n- `PrinterNotReady`: The printer is not ready.\n- `PrintReceiptError`: Printing the receipt failed.\n- `PrinterNotFound`: The printer was not found.\n- `PrinterError`: The printer reported an error.\n- `StorageForbiddenDeviceModel`: The device model is not supported for the storage in use.\n- `StorageForbiddenEKasaEnvironment`: The storage belongs to a different eKasa environment.\n- `StorageAmbiguity`: The storage is ambiguous.\n- `StorageNotFound`: The storage was not found.\n- `StorageDuplicateKey`: Duplicate identifier.\n- `StorageDICMismatch`: The tax identification number (DIČ) does not match the one in the storage.\n- `StorageInsufficientSpace`: The storage is full.\n- `StorageError`: Storage error.\n- `CertificateExpired`: The certificate has expired.\n- `CertificateNotFound`: The certificate was not found.\n- `CertificateError`: Certificate error.\n- `IdentityNotFound`: The identity was not found.\n- `ServiceUnavailable`: The service is restarting or stopping and did not complete the request; the caller may retry it later.\n- `InvalidEKasaEnvironment`: The request targets a different eKasa environment than the one in use.\n- `ReceiptNotFound`: The receipt was not found.\n- `InvalidReceiptNumber`: The receipt number is invalid.\n- `InvalidTime`: The local time is invalid.\n- `ClientLocked`: The client is locked; the request could not be processed.\n- `GeneralError`: General error."
      },
      "ApiExtensionOptionsDto": {
        "type": "object",
        "properties": {
          "isEnabled": {
            "type": "boolean",
            "description": "Whether the extension is enabled."
          }
        },
        "additionalProperties": { },
        "description": "Settings of an API extension. Extension-specific settings are additional properties of this object."
      },
      "ApiHostingConfigurationDto": {
        "type": "object",
        "properties": {
          "instanceName": {
            "type": "string",
            "description": "Instance name: a DNS label (lowercase letters, digits and hyphens, 1 to 63 characters, not starting or\r\nending with a hyphen). The host is announced as `{InstanceName}.ekasa.local`, or as `ekasa.local` when empty.",
            "nullable": true
          },
          "port": {
            "type": "integer",
            "description": "TCP port of the HTTP endpoint, from 1 to 65535; defaults to 3010.",
            "format": "int32",
            "nullable": true
          },
          "bindStandardPorts": {
            "type": "boolean",
            "description": "Whether the host also binds the standard ports 80 (HTTP) and 443 (HTTPS); defaults to `false`. Ignored on Android.",
            "nullable": true
          },
          "enableMdns": {
            "type": "boolean",
            "description": "Whether the host name is announced on the local network (mDNS); on by default. When omitted,\r\nthe stored value is kept.",
            "nullable": true
          },
          "https": {
            "$ref": "#/components/schemas/ApiHttpsConfigurationDto"
          }
        },
        "additionalProperties": false,
        "description": "Hosting settings of the HTTP API."
      },
      "ApiHostingHttpsMode": {
        "enum": [
          "disabled",
          "enabled",
          "redirect",
          "httpsOnly"
        ],
        "type": "string",
        "description": "How the HTTP and HTTPS endpoints are exposed.\n\n- `Disabled`: HTTPS is off; only the HTTP endpoint is served.\n- `Enabled`: Both HTTP and HTTPS endpoints are served.\n- `Redirect`: HTTPS is served; the HTTP endpoint only redirects requests (HTTP 307) to the HTTPS endpoint.\n- `HttpsOnly`: Only the HTTPS endpoint is served; HTTP is not available."
      },
      "ApiHttpsConfigurationDto": {
        "type": "object",
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/ApiHostingHttpsMode"
          },
          "port": {
            "type": "integer",
            "description": "TCP port of the HTTPS endpoint, from 1 to 65535; defaults to 4010.",
            "format": "int32",
            "nullable": true
          },
          "certificates": {
            "$ref": "#/components/schemas/ApiCertificatesConfigurationDto"
          }
        },
        "additionalProperties": false,
        "description": "HTTPS endpoint settings."
      },
      "ApiUserAuthenticationConfigurationDto": {
        "type": "object",
        "properties": {
          "userName": {
            "type": "string",
            "description": "User name; must not be empty.",
            "nullable": true
          },
          "password": {
            "type": "string",
            "description": "Password of the user. Never returned in responses; send it to set or change the password (required for a new user).",
            "nullable": true
          },
          "hasPassword": {
            "type": "boolean",
            "description": "In responses, whether the user has a password set.",
            "nullable": true
          },
          "plainTextPassword": {
            "type": "string",
            "description": "Password of the user. Never returned in responses; send it to set or change the password (required for a new user).",
            "nullable": true,
            "writeOnly": true
          }
        },
        "additionalProperties": false,
        "description": "User allowed to sign in to the HTTP API."
      },
      "ApiValidationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Validation errors by property path; each value lists the messages for that property.",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "Validation error of the request (HTTP 400); lists the invalid fields and their error messages."
      },
      "Architecture": {
        "enum": [
          "X86",
          "X64",
          "Arm",
          "Arm64",
          "Wasm",
          "S390x",
          "LoongArch64",
          "Armv6",
          "Ppc64le",
          "RiscV64"
        ],
        "type": "string",
        "description": "Processor architecture of the device the service runs on."
      },
      "AuthenticationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "authScheme": {
            "type": "string",
            "description": "Authentication scheme that failed; `null` when not known.",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "The request is not authenticated (HTTP 401)."
      },
      "CashRegisterGpsLocationDTO": {
        "required": [
          "cashRegisterCode",
          "location"
        ],
        "type": "object",
        "properties": {
          "location": {
            "$ref": "#/components/schemas/GeoCoordinatesDTO"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Location of a portable cash register given as GPS coordinates."
      },
      "CashRegisterLocationDTO": {
        "required": [
          "cashRegisterCode",
          "location"
        ],
        "type": "object",
        "properties": {
          "location": {
            "$ref": "#/components/schemas/LocationDTO"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Location of a portable cash register."
      },
      "CashRegisterOtherLocationDTO": {
        "required": [
          "cashRegisterCode",
          "location"
        ],
        "type": "object",
        "properties": {
          "location": {
            "$ref": "#/components/schemas/OtherLocationDTO"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Location of a portable cash register given as free text."
      },
      "CashRegisterPhysicalAddressLocationDTO": {
        "required": [
          "cashRegisterCode",
          "location"
        ],
        "type": "object",
        "properties": {
          "location": {
            "$ref": "#/components/schemas/PhysicalAddressDTO"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Location of a portable cash register given as a physical address."
      },
      "CashRegisterReceiptDTO": {
        "required": [
          "cashRegisterCode",
          "items"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptItemDTO"
            },
            "description": "Receipt items."
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Cash register receipt (sale)."
      },
      "CashRegisterType": {
        "enum": [
          "Standard",
          "Portable"
        ],
        "type": "string",
        "description": "Type of the cash register.\n\n- `Standard`: Standard cash register with a fixed point of sale.\n- `Portable`: Portable cash register used at different points of sale at different times."
      },
      "CertificateDTO": {
        "required": [
          "alias",
          "data",
          "keyStoreType"
        ],
        "type": "object",
        "properties": {
          "keyStoreType": {
            "$ref": "#/components/schemas/KeyStoreType"
          },
          "alias": {
            "type": "string",
            "description": "Certificate identifier (alias).",
            "example": "88812345678900001"
          },
          "data": {
            "type": "string",
            "description": "Certificate content.",
            "example": ""
          },
          "password": {
            "type": "string",
            "description": "Certificate password.",
            "nullable": true,
            "example": ""
          }
        },
        "additionalProperties": false,
        "description": "Certificate data."
      },
      "CertificateInfoDTO": {
        "required": [
          "alias",
          "cashRegisterCode",
          "daysToExpire",
          "expirationDate",
          "isAboutToExpire",
          "isExpired",
          "isNotYetValid",
          "issueDate",
          "isValid",
          "serialNumber"
        ],
        "type": "object",
        "properties": {
          "alias": {
            "type": "string",
            "description": "Certificate identifier (alias).",
            "example": "88812345678900001"
          },
          "dic": {
            "type": "string",
            "description": "Tax identification number (DIČ) of the certificate holder.",
            "nullable": true,
            "example": "2020123456"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP) the certificate was issued for.",
            "example": "88812345678900001"
          },
          "issueDate": {
            "type": "string",
            "description": "Date and time the certificate was issued.",
            "format": "date-time",
            "example": "2019-01-30T16:07:01+01:00"
          },
          "expirationDate": {
            "type": "string",
            "description": "Date and time the certificate expires.",
            "format": "date-time",
            "example": "2021-01-29T16:07:01+01:00"
          },
          "serialNumber": {
            "type": "string",
            "description": "Certificate serial number.",
            "example": "2B0A"
          },
          "isNotYetValid": {
            "type": "boolean",
            "description": "Indicates whether the certificate's validity period has not started yet."
          },
          "isValid": {
            "type": "boolean",
            "description": "Indicates whether the certificate is valid at the current time."
          },
          "isAboutToExpire": {
            "type": "boolean",
            "description": "Indicates whether the certificate is valid at the current time and expires within 30 days.\r\nThe period is defined by Act No. 289/2008 Coll., § 4a (2) (s)."
          },
          "daysToExpire": {
            "type": "integer",
            "description": "Number of days left until the certificate expires.",
            "format": "int32"
          },
          "isExpired": {
            "type": "boolean",
            "description": "Indicates whether the certificate has expired.",
            "example": false
          }
        },
        "additionalProperties": false,
        "description": "Certificate information."
      },
      "ClientDateTimeProviderConfigurationDTO": {
        "type": "object",
        "properties": {
          "validateTime": {
            "type": "boolean",
            "description": "Indicates whether the local time is validated against the e-kasa server time.",
            "nullable": true,
            "example": true
          },
          "timeShiftThresholdMilliseconds": {
            "type": "integer",
            "description": "Tolerance of a local clock shift above which the shift is treated as a time change. If time validation is enabled, such a change triggers a new time check when possible, and if the shifted time exceeds the allowed difference from the server time, the local time is declared invalid.",
            "format": "int32",
            "nullable": true,
            "example": 1000
          },
          "serverTimeThresholdSeconds": {
            "type": "integer",
            "description": "Maximum allowed difference between the local time and the e-kasa server time; when exceeded and time validation is enabled, the local time is considered invalid.",
            "format": "int32",
            "nullable": true,
            "example": 3600
          },
          "requestTimeoutMilliseconds": {
            "type": "integer",
            "description": "Timeout of the time validation request, in milliseconds.",
            "format": "int32",
            "nullable": true,
            "example": 5000
          }
        },
        "additionalProperties": false,
        "description": "Settings of the time service that validates the local time against the e-kasa server time."
      },
      "ClientEKasaClientConfigurationDTO": {
        "type": "object",
        "properties": {
          "environment": {
            "$ref": "#/components/schemas/EKasaEnvironment"
          },
          "timeoutMilliseconds": {
            "type": "integer",
            "description": "Timeout of a request to the e-kasa server, in milliseconds.",
            "format": "int32",
            "nullable": true,
            "example": 10000
          }
        },
        "additionalProperties": false,
        "description": "Settings of the client that communicates with the e-kasa server."
      },
      "ClientInternetConnectivityMonitorConfigurationDTO": {
        "type": "object",
        "properties": {
          "retryTimeoutMilliseconds": {
            "type": "integer",
            "description": "Interval in milliseconds after which the internet connection is checked again.",
            "format": "int32",
            "nullable": true,
            "example": 15000
          },
          "requestTimeoutMilliseconds": {
            "type": "integer",
            "description": "Timeout of the internet connection check request, in milliseconds.",
            "format": "int32",
            "nullable": true,
            "example": 5000
          }
        },
        "additionalProperties": false,
        "description": "Settings of the service that monitors the internet connection."
      },
      "ClientPrintersConfigurationDTO": {
        "type": "object",
        "properties": {
          "printReceiptIdBarcode": {
            "type": "boolean",
            "description": "Indicates whether the unique receipt identifier is printed as a barcode in addition to the QR code. The default value is `false`."
          },
          "pos": {
            "$ref": "#/components/schemas/ClientPrintersPosPrinterConfigurationDTO"
          },
          "pdf": {
            "$ref": "#/components/schemas/ClientPrintersPdfPrinterConfigurationDTO"
          },
          "email": {
            "$ref": "#/components/schemas/ClientPrintersEmailPrinterConfigurationDTO"
          }
        },
        "additionalProperties": false,
        "description": "Printer settings."
      },
      "ClientPrintersEmailPrinterConfigurationDTO": {
        "type": "object",
        "properties": {
          "credentials": {
            "$ref": "#/components/schemas/CredentialsDTO"
          },
          "authenticate": {
            "type": "boolean",
            "description": "Indicates whether the credentials are used to authenticate to the SMTP server. The default value is `false`.",
            "nullable": true
          },
          "host": {
            "type": "string",
            "description": "SMTP server host name or address.",
            "nullable": true,
            "example": "smtp.gmail.com"
          },
          "port": {
            "type": "integer",
            "description": "SMTP server port. The default value is 25.",
            "format": "int32",
            "nullable": true
          },
          "enableSsl": {
            "type": "boolean",
            "description": "Indicates whether SSL/TLS is used for the SMTP connection. The default value is `false`.",
            "nullable": true
          },
          "validateServerCertificate": {
            "type": "boolean",
            "description": "Indicates whether the SMTP server certificate is validated. The default value is `true`.",
            "nullable": true
          },
          "checkCertificateRevocation": {
            "type": "boolean",
            "description": "Indicates whether certificate revocation is checked for the SSL/TLS connection. The default value is `true`.",
            "nullable": true
          },
          "timeout": {
            "type": "integer",
            "description": "Time in milliseconds to wait for the e-mail to be sent. The default value is 5000 ms.",
            "format": "int32",
            "nullable": true,
            "example": 5000
          },
          "addressFrom": {
            "type": "string",
            "description": "Sender e-mail address.",
            "nullable": true,
            "example": "receipts@merchant.com"
          },
          "displayName": {
            "type": "string",
            "description": "Sender display name.",
            "nullable": true,
            "example": "SportMax"
          },
          "subject": {
            "type": "string",
            "description": "E-mail subject.",
            "nullable": true,
            "example": "Váš e-doklad z predajne SportMax"
          },
          "body": {
            "type": "string",
            "description": "E-mail message body.",
            "nullable": true,
            "example": "Ďakujeme za nákup v našej predajni. Doklad nájdete v prílohe tejto správy."
          }
        },
        "additionalProperties": false,
        "description": "Settings for sending receipts by e-mail."
      },
      "ClientPrintersPdfPrinterConfigurationDTO": {
        "type": "object",
        "properties": {
          "pageOrientation": {
            "$ref": "#/components/schemas/PdfPageOrientation"
          },
          "pageSize": {
            "$ref": "#/components/schemas/PdfPageSize"
          },
          "outputDirectory": {
            "type": "string",
            "description": "Output directory where the electronic receipts are saved.",
            "nullable": true,
            "example": "receipts"
          },
          "retentionDays": {
            "type": "number",
            "description": "Number of days after which the created electronic receipts are deleted.",
            "format": "double",
            "nullable": true,
            "example": 31
          }
        },
        "additionalProperties": false,
        "description": "PDF printing settings."
      },
      "ClientPrintersPosPrinterConfigurationDTO": {
        "type": "object",
        "properties": {
          "connection": {
            "$ref": "#/components/schemas/PosPrinterConnection"
          },
          "codePageName": {
            "type": "string",
            "description": "IANA name of the character set used by the printer.",
            "nullable": true,
            "example": "ibm852"
          },
          "codePageTableNumber": {
            "type": "integer",
            "description": "Number of the printer character code table.",
            "format": "int32",
            "nullable": true,
            "example": 18
          },
          "charactersPerLine": {
            "type": "integer",
            "description": "Number of characters per line.",
            "format": "int32",
            "nullable": true,
            "example": 42
          },
          "feedLinesCount": {
            "type": "integer",
            "description": "Number of additional blank lines fed at the end of the receipt before the paper is cut, on top of the 5 lines that are always fed.",
            "format": "int32",
            "nullable": true,
            "example": 0
          },
          "useCondensedFont": {
            "type": "boolean",
            "description": "Indicates whether condensed printing with a smaller font is used (obsolete, use `font` with FontB instead).",
            "nullable": true,
            "deprecated": true
          },
          "font": {
            "$ref": "#/components/schemas/EscPosFont"
          },
          "allowInversion": {
            "type": "boolean",
            "description": "Indicates whether inverted (white on black) text may be printed on the receipt.",
            "nullable": true,
            "example": true
          },
          "logo": {
            "$ref": "#/components/schemas/ClientPrintersPosPrinterLogoConfigurationDTO"
          },
          "qrCode": {
            "$ref": "#/components/schemas/ClientPrintersPosPrinterQrCodeConfigurationDTO"
          },
          "drawer": {
            "$ref": "#/components/schemas/ClientPrintersPosPrinterDrawerConfigurationDTO"
          }
        },
        "additionalProperties": false,
        "description": "POS (receipt) printer settings."
      },
      "ClientPrintersPosPrinterDrawerConfigurationDTO": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Enables or disables opening the cash drawer before a receipt is printed.",
            "nullable": true,
            "example": false
          },
          "pin": {
            "$ref": "#/components/schemas/DrawerPin"
          }
        },
        "additionalProperties": false,
        "description": "Cash drawer opening settings."
      },
      "ClientPrintersPosPrinterLogoConfigurationDTO": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the logo stored in the printer is printed.",
            "nullable": true,
            "example": false
          },
          "memoryAddress": {
            "type": "integer",
            "description": "Printer memory address where the logo is stored.",
            "format": "int32",
            "nullable": true,
            "example": 1
          },
          "mode": {
            "$ref": "#/components/schemas/LogoSize"
          }
        },
        "additionalProperties": false,
        "description": "Logo printing settings."
      },
      "ClientPrintersPosPrinterQrCodeConfigurationDTO": {
        "type": "object",
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/EscPosQrCodeMode"
          },
          "enableMargin": {
            "type": "boolean",
            "description": "Indicates whether a margin is inserted before and after the QR code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "QR code printing settings."
      },
      "ClientQrPaymentsConfigurationDTO": {
        "type": "object",
        "properties": {
          "merchant": {
            "$ref": "#/components/schemas/ClientQrPaymentsMerchantConfigurationDTO"
          },
          "paymentTimeoutSeconds": {
            "type": "integer",
            "description": "Time in seconds after which an unpaid QR payment is marked as expired.",
            "format": "int32",
            "nullable": true,
            "example": 120
          },
          "environment": {
            "$ref": "#/components/schemas/QrPaymentEnvironment"
          },
          "recipientMessage": {
            "type": "string",
            "description": "Optional message for the payment recipient, carried in the QR payment link.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Settings of the QR payment service."
      },
      "ClientQrPaymentsMerchantConfigurationDTO": {
        "type": "object",
        "properties": {
          "iban": {
            "type": "string",
            "description": "Merchant bank account number in IBAN format.",
            "nullable": true,
            "example": "SK4811000000002944116480"
          },
          "name": {
            "type": "string",
            "description": "Name of the merchant as registered with the bank for the account, used for payee verification of instant payments.",
            "nullable": true,
            "example": "Merchant Name, s.r.o."
          }
        },
        "additionalProperties": false,
        "description": "Merchant account that receives QR payments."
      },
      "ClientQueueProcessorConfigurationDTO": {
        "type": "object",
        "properties": {
          "maxRetryCount": {
            "type": "integer",
            "description": "Maximum number of retries of a failed request after which the queue processor is paused. A request that cannot be read from the storage is removed from the queue instead of pausing the processor, and returns to the queue the next time it is loaded from the storage.",
            "format": "int32",
            "nullable": true,
            "example": 3
          }
        },
        "additionalProperties": false,
        "description": "Settings of the queue processor that sends queued (offline) requests to the e-kasa server."
      },
      "ClientStorageConfigurationDTO": {
        "type": "object",
        "properties": {
          "serialNumber": {
            "type": "string",
            "description": "Serial number of the storage, used only for testing or for the storage models NineDigit.eKasa.StorageModel.ChduSkImage, NineDigit.eKasa.StorageModel.ChduLiteImage and NineDigit.eKasa.StorageModel.SwissBitImage.",
            "nullable": true
          },
          "storageModel": {
            "type": "string",
            "description": "Model of the protected data storage.",
            "nullable": true
          },
          "indexTableFilePath": {
            "type": "string",
            "description": "Absolute or relative path to the file or directory where the index table is stored.",
            "nullable": true,
            "example": "indexTable.dat"
          },
          "chduSerialPortName": {
            "type": "string",
            "description": "Serial port to which the storage is connected.",
            "nullable": true,
            "example": "COM3 or /dev/ttyS0"
          },
          "chduResponseTimeoutMilliseconds": {
            "type": "integer",
            "description": "Maximum time in milliseconds to wait for a response from the storage. The default value is 1200 ms.",
            "format": "int32",
            "nullable": true,
            "example": 1200
          },
          "chduPrinterBaudRate": {
            "type": "integer",
            "description": "Baud rate of the communication between the storage and the serial printer connected to it. The default value is 38400.",
            "format": "int32",
            "nullable": true,
            "example": 19200
          }
        },
        "additionalProperties": false,
        "description": "Settings of the protected data storage (CHDÚ)."
      },
      "ConnectivityMonitorStatusDTO": {
        "type": "object",
        "properties": {
          "requestDate": {
            "type": "string",
            "description": "Date and time (UTC) the internet connection state was determined.",
            "format": "date-time"
          },
          "state": {
            "$ref": "#/components/schemas/InternetConnectionState"
          }
        },
        "additionalProperties": false,
        "description": "Result of the internet connection check."
      },
      "CredentialsDTO": {
        "type": "object",
        "properties": {
          "userName": {
            "type": "string",
            "description": "User name.",
            "nullable": true
          },
          "password": {
            "type": "string",
            "description": "Password.",
            "nullable": true
          },
          "hasPassword": {
            "type": "boolean",
            "description": "Indicates whether a password has been set for the user name.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Credentials for the SMTP server."
      },
      "DateTimeRangeDTO": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "description": "Start of the range, or `null` when the range has no lower bound.",
            "format": "date-time",
            "nullable": true
          },
          "to": {
            "type": "string",
            "description": "End of the range, or `null` when the range has no upper bound.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Date and time range."
      },
      "DeviceType": {
        "enum": [
          "SerialPort",
          "SdCard"
        ],
        "type": "string",
        "description": "Type of the connected storage device.\n\n- `SerialPort`: Device connected via a serial port.\n- `SdCard`: Device in the form of an SD card."
      },
      "DrawerPin": {
        "enum": [
          "Pin2",
          "Pin5"
        ],
        "type": "string",
        "description": "Pin of the RJ11 cash drawer connector.\n\n- `Pin2`: Pin 2.\n- `Pin5`: Pin 5."
      },
      "EKasaEnvironment": {
        "enum": [
          "Production",
          "Playground"
        ],
        "type": "string",
        "description": "The e-kasa environment in which requests are registered.\n\n- `Production`: Production environment.\n- `Playground`: Test (playground) environment."
      },
      "EKasaErrorDTO": {
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error description from the eKasa system.",
            "example": "Zlé vstupné hodnoty."
          },
          "code": {
            "type": "integer",
            "description": "Error code from the eKasa system, or `null` when none was returned.",
            "format": "int32",
            "nullable": true,
            "example": -2
          }
        },
        "additionalProperties": false,
        "description": "Error returned by the eKasa system when registering a request."
      },
      "EKasaProductInfoDTO": {
        "required": [
          "api",
          "chdu",
          "ppekk",
          "swid",
          "vendorName"
        ],
        "type": "object",
        "properties": {
          "vendorName": {
            "type": "string",
            "description": "Vendor name.",
            "example": "Nine Digit, s.r.o."
          },
          "swid": {
            "type": "string",
            "description": "Unique identifier of the cash register software (SWID).",
            "example": "F5838FA8195427FEC53541F044A52B6CC7BCC67A"
          },
          "api": {
            "$ref": "#/components/schemas/ProductIdDTO"
          },
          "ppekk": {
            "$ref": "#/components/schemas/ProductIdDTO"
          },
          "chdu": {
            "$ref": "#/components/schemas/ProductIdDTO"
          },
          "operatingSystem": {
            "$ref": "#/components/schemas/OperatingSystemInfoDTO"
          }
        },
        "additionalProperties": false,
        "description": "Information about the cash register software."
      },
      "EscPosFont": {
        "enum": [
          "FontA",
          "FontB",
          "FontC"
        ],
        "type": "string",
        "description": "Font used to print the receipt.\n\n- `FontA`: Standard font with a character size of 12 × 24 dots.\n- `FontB`: Condensed font with a character size of 9 × 17 dots.\n- `FontC`: Special font with a character size of 9 × 24 dots; it may not be supported by all printer models."
      },
      "EscPosQrCodeMode": {
        "enum": [
          "EscPos",
          "Bitmap",
          "Sanei",
          "Masung"
        ],
        "type": "string",
        "description": "Graphic mode used to print the QR code.\n\n- `EscPos`: Native ESC/POS QR code command.\n- `Bitmap`: QR code printed as a bitmap image.\n- `Sanei`: Sanei variant of the ESC/POS QR code command.\n- `Masung`: Masung variant of the ESC/POS QR code command."
      },
      "GeoCoordinatesDTO": {
        "required": [
          "latitude",
          "longitude"
        ],
        "type": "object",
        "properties": {
          "longitude": {
            "type": "number",
            "description": "Longitude (X).",
            "format": "double",
            "example": 17.165377
          },
          "latitude": {
            "type": "number",
            "description": "Latitude (Y).",
            "format": "double",
            "example": 48.14896
          }
        },
        "additionalProperties": false,
        "description": "GPS coordinates (WGS 84) of the place where the cash register issues receipts.\r\nUse this type when the cash register can obtain its GPS coordinates in the WGS 84 system."
      },
      "HealthReportDTO": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HealthReportEntryDTO"
            },
            "description": "Results of the individual health checks.",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/HealthStatus"
          },
          "totalDuration": {
            "type": "integer",
            "description": "Total duration of all checks in milliseconds.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Health report of the API service."
      },
      "HealthReportEntryDTO": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the health check.",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "Description of what the check found, or `null` when not provided or details are omitted.",
            "nullable": true,
            "readOnly": true
          },
          "data": {
            "type": "object",
            "additionalProperties": { },
            "description": "Additional data reported by the check, or `null` when details are omitted.",
            "nullable": true,
            "readOnly": true
          },
          "duration": {
            "type": "integer",
            "description": "Duration of the check in milliseconds.",
            "format": "int32",
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/HealthStatus"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the health check, or `null` when none are set.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Result of a single health check."
      },
      "HealthStatus": {
        "enum": [
          "Unhealthy",
          "Degraded",
          "Healthy"
        ],
        "type": "string",
        "description": "Result of a health check.\n\n- `Healthy`: the component works.\n- `Degraded`: the component works with a limitation, attention is recommended.\n- `Unhealthy`: the component does not work."
      },
      "HostingCertificateExportFormat": {
        "enum": [
          "pem",
          "der"
        ],
        "type": "string",
        "description": "Export format of the hosting (HTTPS) certificate.\n\n- `Pem`: Base64-encoded PEM format.\n- `Der`: Binary DER format."
      },
      "IApiProblemDetails": {
        "type": "object",
        "properties": {
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          },
          "extensions": {
            "type": "object",
            "additionalProperties": { },
            "description": "Additional members of the problem details object.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Error response in the RFC 7807 problem details format. The `code` property identifies the error type\r\nand the set of additional properties."
      },
      "IdentityDTO": {
        "required": [
          "corporateBodyFullName",
          "dic",
          "organizationUnit",
          "physicalAddress"
        ],
        "type": "object",
        "properties": {
          "dic": {
            "type": "string",
            "description": "Tax identification number (DIČ).",
            "example": "1234567890"
          },
          "ico": {
            "type": "string",
            "description": "Business identification number (IČO), if one was assigned.",
            "nullable": true,
            "example": "76543210"
          },
          "icdph": {
            "type": "string",
            "description": "VAT identification number (IČ DPH), if the business is a VAT payer.",
            "nullable": true,
            "example": "SK1234567890"
          },
          "corporateBodyFullName": {
            "type": "string",
            "description": "Full business name.",
            "example": "Finančná správa i.n.t."
          },
          "organizationUnit": {
            "$ref": "#/components/schemas/IdentityOrganizationUnitDTO"
          },
          "physicalAddress": {
            "$ref": "#/components/schemas/IdentityPhysicalAddressDTO"
          }
        },
        "additionalProperties": false,
        "description": "Identity of the business (taxpayer) the cash register is registered to."
      },
      "IdentityDeliveryAddressDTO": {
        "required": [
          "postalCode"
        ],
        "type": "object",
        "properties": {
          "postalCode": {
            "type": "string",
            "description": "Postal code assigned by the postal authorities for mail delivery.",
            "example": "98045"
          }
        },
        "additionalProperties": false,
        "description": "Delivery address."
      },
      "IdentityOrganizationUnitDTO": {
        "required": [
          "cashRegisterCode",
          "cashRegisterType"
        ],
        "type": "object",
        "properties": {
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP).",
            "example": "88812345678900001"
          },
          "cashRegisterType": {
            "$ref": "#/components/schemas/CashRegisterType"
          },
          "hasRegistrationException": {
            "type": "boolean",
            "description": "Indicates whether the business has been granted an exemption from sending data from the cash register to the eKasa system.",
            "example": false
          },
          "organizationUnitName": {
            "type": "string",
            "description": "Name of the organization unit (a subdivision of the business that is not a separate legal entity).",
            "nullable": true,
            "example": "Caffé Haus"
          },
          "physicalAddress": {
            "$ref": "#/components/schemas/IdentityPhysicalAddressDTO"
          }
        },
        "additionalProperties": false,
        "description": "Organization unit (point of sale) of the business."
      },
      "IdentityPhysicalAddressDTO": {
        "required": [
          "country",
          "streetName"
        ],
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "description": "Country name.",
            "example": "Slovenská republika"
          },
          "streetName": {
            "type": "string",
            "description": "Street name; when the municipality has no street names, the municipality name.",
            "example": "Horná"
          },
          "municipality": {
            "type": "string",
            "description": "Municipality (town or village) name.",
            "nullable": true,
            "example": "Štrkovec"
          },
          "buildingNumber": {
            "type": "string",
            "description": "Building name or house number.",
            "nullable": true,
            "example": "7"
          },
          "propertyRegistrationNumber": {
            "type": "string",
            "description": "Property registration number (súpisné číslo) of the building.",
            "nullable": true,
            "example": "560"
          },
          "deliveryAddress": {
            "$ref": "#/components/schemas/IdentityDeliveryAddressDTO"
          }
        },
        "additionalProperties": false,
        "description": "Physical address."
      },
      "IndexTableRestorationMode": {
        "enum": [
          "Full",
          "BackwardsPartial"
        ],
        "type": "string",
        "description": "Index table restoration mode.\n\n- `Full`: Full restoration of the index table from the first block to the last used block.\n- `BackwardsPartial`: Partial restoration of the index table, performed from the end of the data medium back to the last backup record in the storage."
      },
      "IndexTableStatusDTO": {
        "required": [
          "indexTableBlocksCount",
          "storageBlocksCount"
        ],
        "type": "object",
        "properties": {
          "indexTableBlocksCount": {
            "type": "integer",
            "description": "Number of storage blocks covered by the index table.",
            "format": "int32",
            "example": 1234567890
          },
          "storageBlocksCount": {
            "type": "integer",
            "description": "Number of used storage blocks.",
            "format": "int32",
            "example": 1234567890
          }
        },
        "additionalProperties": false,
        "description": "Status of the index table."
      },
      "InternetConnectionState": {
        "enum": [
          "Unknown",
          "Up",
          "Down"
        ],
        "type": "string",
        "description": "State of the internet connection.\n\n- `Unknown`: The connection state is not known yet.\n- `Up`: The internet connection is available.\n- `Down`: The internet connection is not available."
      },
      "InvalidReceiptDTO": {
        "required": [
          "cashRegisterCode",
          "items"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptItemDTO"
            },
            "description": "Receipt items."
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Invalid receipt (neplatný doklad)."
      },
      "InvoiceParagonReceiptDTO": {
        "required": [
          "amount",
          "cashRegisterCode",
          "invoiceNumber",
          "issueDate",
          "paragonNumber"
        ],
        "type": "object",
        "properties": {
          "issueDate": {
            "type": "string",
            "description": "Date and time the paragon was issued.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "invoiceNumber": {
            "type": "string",
            "description": "Invoice number.",
            "example": "201801001"
          },
          "paragonNumber": {
            "type": "integer",
            "description": "Paragon number.",
            "format": "int32",
            "example": 1
          },
          "amount": {
            "type": "number",
            "description": "Total amount in EUR.",
            "format": "double",
            "example": 15
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Invoice payment paragon (an invoice payment issued on a paragon while the cash register could not be used, registered later)."
      },
      "InvoiceReceiptDTO": {
        "required": [
          "amount",
          "cashRegisterCode",
          "invoiceNumber"
        ],
        "type": "object",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Total amount in EUR.",
            "format": "double",
            "example": 15
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "invoiceNumber": {
            "type": "string",
            "description": "Invoice number.",
            "example": "201801001"
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Invoice payment receipt."
      },
      "KeyStoreType": {
        "enum": [
          "PKCS12"
        ],
        "type": "string",
        "description": "Type of the security certificate store.\n\n- `PKCS12`: PKCS #12 key store."
      },
      "LicenseVerificationResultAlertCallToActionDTO": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Action name to display in the user interface, for example the label of a button that opens the URL.",
            "nullable": true
          },
          "url": {
            "type": "string",
            "description": "URL the user should be sent to for more information about the alert.",
            "format": "uri",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Call to action that gives the user more information about the alert."
      },
      "LicenseVerificationResultAlertDTO": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/LicenseVerificationResultAlertType"
          },
          "message": {
            "type": "string",
            "description": "Alert message.",
            "nullable": true
          },
          "code": {
            "type": "integer",
            "description": "Alert code, or `null` when not set. The list of values is available in the\r\n<see href=\"https://ekasa.ninedigit.sk/docs\">online documentation</see>.",
            "format": "int32",
            "nullable": true
          },
          "priority": {
            "type": "integer",
            "description": "Alert priority, or `null` when not set; a higher value means a higher priority.",
            "format": "int32",
            "nullable": true
          },
          "callToAction": {
            "$ref": "#/components/schemas/LicenseVerificationResultAlertCallToActionDTO"
          }
        },
        "additionalProperties": false,
        "description": "Alert raised during license verification."
      },
      "LicenseVerificationResultAlertType": {
        "enum": [
          "info",
          "warning",
          "error"
        ],
        "type": "string",
        "description": "Type of an alert returned by license verification.\n\n- `Info`: Informational alert that requires no action.\n- `Warning`: Warning about a license issue that should be resolved (for example an upcoming expiration).\n- `Error`: Error that indicates the license is not valid."
      },
      "LicenseVerificationResultDTO": {
        "type": "object",
        "properties": {
          "processTime": {
            "type": "string",
            "description": "Date and time the verification was processed.",
            "format": "date-time"
          },
          "storage": {
            "$ref": "#/components/schemas/LicenseVerificationResultStorageDTO"
          },
          "features": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LicenseVerificationResultFeatureDTO"
            },
            "description": "Results of the feature verification, or `null` when not available.",
            "nullable": true
          },
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LicenseVerificationResultAlertDTO"
            },
            "description": "Alerts related to the license, or `null` when there are none.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Result of the license verification."
      },
      "LicenseVerificationResultFeatureDTO": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "description": "Unique name (SKU) of the feature.",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Indicates whether the license is valid for the feature."
          },
          "version": {
            "type": "string",
            "description": "Version of the feature that was verified, or `null` when not specified.",
            "nullable": true
          },
          "validity": {
            "$ref": "#/components/schemas/DateTimeRangeDTO"
          },
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LicenseVerificationResultAlertDTO"
            },
            "description": "Alerts related to the feature, or `null` when there are none.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Result of the verification of a licensed feature."
      },
      "LicenseVerificationResultStorageDTO": {
        "type": "object",
        "properties": {
          "isValid": {
            "type": "boolean",
            "description": "Indicates whether the license is valid for the storage."
          },
          "isInCustomerWarranty": {
            "type": "boolean",
            "description": "Indicates whether the storage is under customer warranty, or `null` when warranty information is not available.",
            "nullable": true
          },
          "customerWarranty": {
            "$ref": "#/components/schemas/DateTimeRangeDTO"
          },
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LicenseVerificationResultAlertDTO"
            },
            "description": "Alerts related to the storage, or `null` when there are none.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Result of the license verification for the storage."
      },
      "LocationDTO": {
        "type": "object",
        "additionalProperties": false,
        "description": "Location of a cash register: NineDigit.eKasa.API.DTOs.GeoCoordinatesDTO, NineDigit.eKasa.API.DTOs.PhysicalAddressDTO\r\nor NineDigit.eKasa.API.DTOs.OtherLocationDTO."
      },
      "LocationRegistrationDataDTO": {
        "required": [
          "cashRegisterCode",
          "createDate",
          "dic",
          "location"
        ],
        "type": "object",
        "properties": {
          "location": {
            "$ref": "#/components/schemas/LocationDTO"
          },
          "createDate": {
            "type": "string",
            "description": "Date and time the receipt or the portable cash register location record was created in the cash register.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "dic": {
            "type": "string",
            "description": "Tax identification number (DIČ) of the seller, a string of 10 digits.",
            "example": "1234567890"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Data of a location registration."
      },
      "LogoSize": {
        "enum": [
          "Normal",
          "DoubleWidth",
          "DoubleHeight",
          "Quadruple"
        ],
        "type": "string",
        "description": "Size used to print the logo.\n\n- `Normal`: Normal size.\n- `DoubleWidth`: Double width.\n- `DoubleHeight`: Double height.\n- `Quadruple`: Double width and double height."
      },
      "NonfiscalReceiptContentFlags": {
        "enum": [
          "None",
          "PriceInformation"
        ],
        "type": "string",
        "description": "Flags describing the content of a non-fiscal document that requires special handling.\n\n- `None`: The document contains no data that requires special handling.\n- `PriceInformation`: The document contains price information for goods or services (for example unit price, total price or discounts)."
      },
      "OpenDrawerResultDTO": {
        "required": [
          "opened"
        ],
        "type": "object",
        "properties": {
          "opened": {
            "type": "boolean",
            "description": "Indicates whether the cash drawer was opened, or `null` when it is not known\r\n(for example when the receipt is not delivered to a printer).",
            "nullable": true,
            "example": true
          }
        },
        "additionalProperties": false,
        "description": "Result of the cash drawer opening operation."
      },
      "OperatingSystem": {
        "enum": [
          "Windows",
          "Linux",
          "MacOS",
          "Android"
        ],
        "type": "string",
        "description": "Operating system on which the application runs.\n\n- `Windows`: Microsoft Windows.\n- `Linux`: Linux.\n- `MacOS`: Apple macOS.\n- `Android`: Android."
      },
      "OperatingSystemInfoDTO": {
        "type": "object",
        "properties": {
          "platform": {
            "$ref": "#/components/schemas/OperatingSystem"
          },
          "architecture": {
            "$ref": "#/components/schemas/Architecture"
          },
          "description": {
            "type": "string",
            "description": "Operating system description.",
            "nullable": true,
            "example": "Microsoft Windows 10.0.26200"
          },
          "version": {
            "type": "string",
            "description": "Operating system version.",
            "nullable": true,
            "example": "Microsoft Windows NT 10.0.26200.0"
          }
        },
        "additionalProperties": false,
        "description": "Operating system information."
      },
      "OtherLocationDTO": {
        "required": [
          "value"
        ],
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Free-text description of the location.",
            "example": "Taxi ABC EČ vozidla = BA 123 AA; odpočívadlo Zeleneč D1"
          }
        },
        "additionalProperties": false,
        "description": "Location of a cash register given as free text."
      },
      "ParagonReceiptDTO": {
        "required": [
          "cashRegisterCode",
          "issueDate",
          "items",
          "paragonNumber"
        ],
        "type": "object",
        "properties": {
          "issueDate": {
            "type": "string",
            "description": "Date and time the paragon was issued.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "paragonNumber": {
            "type": "integer",
            "description": "Paragon number.",
            "format": "int32",
            "example": 1
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptItemDTO"
            },
            "description": "Receipt items."
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Paragon (a receipt issued on paper while the cash register could not be used, registered later)."
      },
      "PdfPageOrientation": {
        "enum": [
          "Portrait",
          "Landscape"
        ],
        "type": "string",
        "description": "Page orientation.\n\n- `Portrait`: Portrait orientation.\n- `Landscape`: Landscape orientation."
      },
      "PdfPageSize": {
        "enum": [
          "A4",
          "A5",
          "Receipt80mm"
        ],
        "type": "string",
        "description": "Page size of the PDF document.\n\n- `A4`: Standard A4 size (210 × 297 mm).\n- `A5`: A5 size (148 × 210 mm).\n- `Receipt80mm`: Receipt format with a width of 80 mm."
      },
      "PhysicalAddressDTO": {
        "required": [
          "municipality",
          "streetName"
        ],
        "type": "object",
        "properties": {
          "streetName": {
            "type": "string",
            "description": "Street name; when the municipality has no street names, the municipality name.",
            "example": "Horná"
          },
          "municipality": {
            "type": "string",
            "description": "Municipality (town or village) name.",
            "example": "Štrkovec"
          },
          "buildingNumber": {
            "type": "string",
            "description": "Building name or house number.",
            "nullable": true,
            "example": "7"
          },
          "postalCode": {
            "type": "string",
            "description": "Postal code.",
            "nullable": true,
            "example": "98045"
          },
          "propertyRegistrationNumber": {
            "type": "integer",
            "description": "Property registration number (súpisné číslo) of the building.",
            "format": "int64",
            "nullable": true,
            "example": 560
          }
        },
        "additionalProperties": false,
        "description": "Location of a cash register given as a physical address."
      },
      "PosPrinterConnection": {
        "enum": [
          "Internal",
          "Usb"
        ],
        "type": "string",
        "description": "Printer on which paper receipts are printed.\n\n- `Internal`: Printer connected to the data storage (CHDU-SK and CHDU Lite models), or the built-in printer of the device when the device is a payment terminal.\n- `Usb`: External printer connected to the device via USB (available only for the SwissBit storage and the virtual SwissBitImage and InMemory storages)."
      },
      "PrintResultDTO": {
        "required": [
          "printed"
        ],
        "type": "object",
        "properties": {
          "printed": {
            "type": "boolean",
            "description": "Indicates whether the output was printed on the printer, or `null` when it is not known\r\n(for example when the output is not delivered to a printer).",
            "nullable": true,
            "example": true
          }
        },
        "additionalProperties": false,
        "description": "Result of the printing operation."
      },
      "PrinterErrorStatus": {
        "enum": [
          "None",
          "CutterError",
          "Recoverable",
          "Unrecoverable"
        ],
        "type": "string",
        "description": "Kind of error reported by the printer that is not related to paper.\n\n- `None`: The printer reports no error of this kind.\n- `CutterError`: Error of the automatic paper cutter.\n- `Recoverable`: Error that clears by itself once its cause is gone, for example an overheated print head or low supply voltage; printing can be retried without servicing the device.\n- `Unrecoverable`: Fault that cannot be cleared without servicing the device, for example a mechanical failure."
      },
      "PrinterInfoDTO": {
        "type": "object",
        "properties": {
          "connection": {
            "$ref": "#/components/schemas/PosPrinterConnection"
          },
          "text": {
            "$ref": "#/components/schemas/PrinterTextInfoDTO"
          }
        },
        "additionalProperties": false,
        "description": "Printer information."
      },
      "PrinterPaperStatus": {
        "enum": [
          "Ready",
          "CoverOpen",
          "NearEnd",
          "Empty",
          "PaperJam"
        ],
        "type": "string",
        "description": "Current state of the paper or the paper mechanism in the printer.\n\n- `Ready`: Paper is loaded correctly and the printer is ready to print.\n- `CoverOpen`: The printer cover is open and printing cannot continue.\n- `NearEnd`: The printer detects that the paper roll is nearly empty.\n- `Empty`: There is no paper in the printer.\n- `PaperJam`: A paper jam was detected in the printer."
      },
      "PrinterStatus": {
        "enum": [
          "Unknown",
          "Ready",
          "Error"
        ],
        "type": "string",
        "description": "Printer status.\n\n- `Unknown`: The printer status is unknown.\n- `Ready`: The printer is ready.\n- `Error`: The printer is not ready (busy or in an error state)."
      },
      "PrinterStatusDTO": {
        "type": "object",
        "properties": {
          "state": {
            "$ref": "#/components/schemas/PrinterStatus"
          },
          "paperState": {
            "$ref": "#/components/schemas/PrinterPaperStatus"
          },
          "errorState": {
            "$ref": "#/components/schemas/PrinterErrorStatus"
          }
        },
        "additionalProperties": false,
        "description": "Result of the printer status check."
      },
      "PrinterTextInfoDTO": {
        "type": "object",
        "properties": {
          "layout": {
            "$ref": "#/components/schemas/PrinterTextLayout"
          },
          "charactersPerLine": {
            "type": "integer",
            "description": "Number of characters per line after device model adjustments.\r\n<br>`null` for a proportional font, where a line has no width in characters.\r\n",
            "format": "int32",
            "nullable": true,
            "example": 42
          }
        },
        "additionalProperties": false,
        "description": "Description of the text the printer produces."
      },
      "PrinterTextLayout": {
        "enum": [
          "Monospace",
          "Proportional"
        ],
        "type": "string",
        "description": "Type of the printer font.\n\n- `Monospace`: Monospaced font: all characters have the same width, so lines can be composed by counting characters and the number of characters per line is fixed.\n- `Proportional`: Proportional font: the width depends on the character, so the number of characters per line is not fixed."
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "Error response in the problem details format (RFC 7807)."
      },
      "ProductIdDTO": {
        "required": [
          "name",
          "version"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name.",
            "example": "Portos eKasa"
          },
          "version": {
            "type": "string",
            "description": "Product version; it may start with the letter 'v' and may be a semantic version string.",
            "example": "v1.23"
          }
        },
        "additionalProperties": false,
        "description": "Product information."
      },
      "QrPaymentDTO": {
        "type": "object",
        "properties": {
          "transactionId": {
            "type": "string",
            "description": "Unique payment identifier.",
            "nullable": true,
            "example": "QR-618300cdd6d64580bad8353dc2a394c5"
          },
          "amount": {
            "type": "number",
            "description": "Requested payment amount.",
            "format": "double",
            "example": 19.99
          },
          "currencyCode": {
            "type": "string",
            "description": "Currency code in ISO 4217 format.",
            "nullable": true,
            "example": "EUR"
          },
          "merchant": {
            "$ref": "#/components/schemas/QrPaymentMerchantDTO"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP) the payment belongs to.",
            "nullable": true,
            "example": "88812345678900001"
          },
          "createdAt": {
            "type": "string",
            "description": "Date and time the payment was created.",
            "format": "date-time",
            "example": "2025-10-24T13:12:11+02:00"
          },
          "expiresAt": {
            "type": "string",
            "description": "Date and time until which the payment is expected.",
            "format": "date-time",
            "example": "2025-10-24T13:14:11+02:00"
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QrPaymentEntryDTO"
            },
            "description": "Payments received for this QR payment.",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/QrPaymentStatus"
          },
          "paidAmount": {
            "type": "number",
            "description": "Sum of all received payments.",
            "format": "double",
            "example": 0
          },
          "remainingAmount": {
            "type": "number",
            "description": "Amount still missing to reach the requested amount; never negative.",
            "format": "double",
            "example": 19.99
          },
          "overpaidAmount": {
            "type": "number",
            "description": "Extra amount received above the requested amount; 0 when none.",
            "format": "double"
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QrPaymentLinkDTO"
            },
            "description": "Payment links for paying the remaining amount of the QR payment.\r\nEmpty when the remaining amount is zero or the payment is in a final state.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "QR payment (instant bank transfer requested by a QR code)."
      },
      "QrPaymentEntryDTO": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Amount received.",
            "format": "double"
          },
          "receivedAt": {
            "type": "string",
            "description": "Date and time the payment notification was received.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Payment received for a QR payment."
      },
      "QrPaymentEnvironment": {
        "enum": [
          "production",
          "integration"
        ],
        "type": "string",
        "description": "Environment of the QR payment service.\n\n- `Production`: Production environment.\n- `Integration`: Integration (test) environment."
      },
      "QrPaymentInitializationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "Creating the QR payment failed (HTTP 500)."
      },
      "QrPaymentLinkDTO": {
        "type": "object",
        "properties": {
          "provider": {
            "$ref": "#/components/schemas/QrPaymentLinkSchemeProvider"
          },
          "version": {
            "type": "string",
            "description": "Version of the payment link scheme.",
            "nullable": true,
            "example": "2.0"
          },
          "url": {
            "type": "string",
            "description": "URL of the payment link.",
            "nullable": true,
            "example": "https://payme.sk/2/m/PME?IBAN=SK4811000000002944116480&AM=7.59&CC=EUR&PI=QR-618300cdd6d64580bad8353dc2a394c5&CN=Kaviaren+Pod+Hradom%2C+s.r.o."
          }
        },
        "additionalProperties": false,
        "description": "Payment link for paying a QR payment."
      },
      "QrPaymentLinkSchemeProvider": {
        "enum": [
          "payme"
        ],
        "type": "string",
        "description": "Provider of the payment link scheme used for QR payments.\n\n- `Payme`: PAY by square payment link (payme.sk) supported by Slovak banking apps."
      },
      "QrPaymentMerchantDTO": {
        "type": "object",
        "properties": {
          "iban": {
            "type": "string",
            "description": "Bank account number (IBAN).",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "Merchant name under which the account is registered at the bank, used to verify the payee\r\nof an instant payment.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Merchant receiving QR payments."
      },
      "QrPaymentNotFoundProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "The QR payment was not found (HTTP 404)."
      },
      "QrPaymentProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "URI reference that identifies the problem type; links to the error code description in the documentation.",
            "nullable": true
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the problem type (in Slovak).",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the response.",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence of the problem (in Slovak).",
            "nullable": true
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "traceId": {
            "type": "string",
            "description": "Identifier of the request trace, for matching the error with the service logs.",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that caused the problem.",
            "nullable": true
          }
        },
        "additionalProperties": { },
        "description": "QR payment error (HTTP 500)."
      },
      "QrPaymentRenderRequestDTO": {
        "type": "object",
        "properties": {
          "rendererName": {
            "$ref": "#/components/schemas/QrPaymentRendererName"
          }
        },
        "additionalProperties": false,
        "description": "Request to render a QR payment."
      },
      "QrPaymentRendererName": {
        "enum": [
          "posPrinter"
        ],
        "type": "string",
        "description": "Identifier of the way the QR code of a QR payment is presented to the customer.\n\n- `PosPrinter`: The QR payment instructions are printed on the connected printer."
      },
      "QrPaymentRequestDTO": {
        "type": "object",
        "properties": {
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP) the QR payment belongs to.",
            "nullable": true,
            "example": "88812345678900001"
          },
          "amount": {
            "type": "number",
            "description": "Amount to pay; a positive number.",
            "format": "double",
            "example": 19.99
          },
          "comment": {
            "type": "string",
            "description": "Optional text note.",
            "nullable": true,
            "example": ""
          },
          "recipientMessage": {
            "type": "string",
            "description": "Optional message for the payee, carried in the QR payment link.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request to create a QR payment."
      },
      "QrPaymentStatus": {
        "enum": [
          "pending",
          "partiallyPaid",
          "paid",
          "overpaid",
          "expired"
        ],
        "type": "string",
        "description": "Current status of a QR payment, determined automatically from the received amounts and the expiration time.\n\n- `Pending`: The payment has been created, but no incoming payment has been received yet.\n- `PartiallyPaid`: A partial payment has been received, but the full amount is not yet covered.\n- `Paid`: The payment has been fully settled; the received amount equals the requested amount.\n- `Overpaid`: More funds were received than requested.\n- `Expired`: The payment request expired before it was fully paid."
      },
      "QuantityDTO": {
        "required": [
          "amount"
        ],
        "type": "object",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Quantity of the goods sold or the service provided.",
            "format": "double",
            "example": 2.145
          },
          "unit": {
            "type": "string",
            "description": "Unit of the goods sold or the service provided.",
            "nullable": true,
            "example": "x"
          }
        },
        "additionalProperties": false,
        "description": "Quantity of the goods sold or the service provided, with its unit."
      },
      "ReceiptBaseDTO": {
        "required": [
          "cashRegisterCode"
        ],
        "type": "object",
        "properties": {
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null` when not set.",
            "nullable": true,
            "example": ""
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Receipt."
      },
      "ReceiptIdDTO": {
        "type": "object",
        "properties": {
          "cashRegisterCode": {
            "pattern": "^[0-9]{16,17}$",
            "type": "string",
            "description": "Cash register code (ORP).",
            "nullable": true,
            "example": "88812345678900001"
          },
          "year": {
            "maximum": 9999,
            "minimum": 2019,
            "type": "integer",
            "description": "Year the receipt was issued.",
            "format": "int32",
            "example": 2019
          },
          "month": {
            "maximum": 12,
            "minimum": 1,
            "type": "integer",
            "description": "Month the receipt was issued.",
            "format": "int32",
            "example": 4
          },
          "receiptNumber": {
            "maximum": 4294967295,
            "minimum": 1,
            "type": "integer",
            "description": "Receipt number.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Receipt identifier."
      },
      "ReceiptItemDTO": {
        "required": [
          "name",
          "price",
          "quantity",
          "type",
          "unitPrice"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/ReceiptItemType"
          },
          "name": {
            "type": "string",
            "description": "Name of the goods or service.",
            "example": "Coca cola"
          },
          "price": {
            "type": "number",
            "description": "Total price of the goods or service in EUR.",
            "format": "double",
            "example": 30
          },
          "unitPrice": {
            "type": "number",
            "description": "Unit price of the goods or service in EUR.",
            "format": "double",
            "example": 15
          },
          "quantity": {
            "$ref": "#/components/schemas/QuantityDTO"
          },
          "referenceReceiptId": {
            "type": "string",
            "description": "Identifier of the receipt that the corrected or returned item refers to.",
            "nullable": true,
            "example": "O-7DBCDA8A56EE426DBCDA8A56EE426D1A"
          },
          "vatRate": {
            "type": "number",
            "description": "VAT rate in percent, or `null` for an item not subject to VAT (for example the sale or return\r\nof returnable containers). `null` is allowed only for Positive, ReturnedContainer, Correction and\r\nDiscount items and is required for ReturnedContainer items.",
            "format": "double",
            "nullable": true,
            "example": 23
          },
          "specialRegulation": {
            "$ref": "#/components/schemas/TaxFreeReason"
          },
          "voucherNumber": {
            "type": "string",
            "description": "Number of the single-purpose voucher exchanged for the goods or service.",
            "nullable": true,
            "example": "201801001"
          },
          "seller": {
            "$ref": "#/components/schemas/SellerDTO"
          },
          "description": {
            "type": "string",
            "description": "Optional additional description of the item, shown on the receipt.",
            "nullable": true,
            "example": "Dátum spotreby je uvedený na obale"
          }
        },
        "additionalProperties": false,
        "description": "Receipt item."
      },
      "ReceiptItemType": {
        "enum": [
          "Positive",
          "ReturnedContainer",
          "Returned",
          "Correction",
          "Discount",
          "Advance",
          "Voucher"
        ],
        "type": "string",
        "description": "Type of the receipt item.\n\n- `Positive`: Positive item: the amount for goods sold or a service provided.\n- `ReturnedContainer`: Returned containers (negative item): the amount paid out for returned deposit containers.\n- `Returned`: Returned item (negative item): cancellation of a registered item after it was issued on a receipt, when goods or a service are returned.\n- `Correction`: Correction item (positive or negative): negation of an item of a receipt already registered in the e-kasa system, used when the item is corrected.\n- `Discount`: Discount (negative item): the amount of discounts granted.\n- `Advance`: Deducted advance (negative item): the amount of a previously received advance payment, stated on the receipt issued when the remaining price for the goods or service is paid.\n- `Voucher`: Voucher redemption (negative item): the amount of a single-purpose voucher exchanged for goods or a service."
      },
      "ReceiptPaymentDTO": {
        "required": [
          "amount",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the means of payment.",
            "example": "Hotovosť"
          },
          "amount": {
            "type": "number",
            "description": "Total amount in EUR.",
            "format": "double",
            "example": 15
          }
        },
        "additionalProperties": false,
        "description": "Payment (means of payment) on a receipt."
      },
      "ReceiptRegistrationDataDTO": {
        "required": [
          "amount",
          "basicVatAmount",
          "cashRegisterCode",
          "createDate",
          "dic",
          "footerText",
          "headerText",
          "icdph",
          "ico",
          "invoiceNumber",
          "issueDate",
          "items",
          "nonTaxableAmount",
          "okp",
          "paragonNumber",
          "payments",
          "pkp",
          "receiptNumber",
          "receiptType",
          "reducedVatAmount",
          "secondReducedVatAmount",
          "taxBaseBasic",
          "taxBaseReduced",
          "taxBaseSecondReduced",
          "taxFreeAmount",
          "vatRatesTaxSummary"
        ],
        "type": "object",
        "properties": {
          "receiptType": {
            "$ref": "#/components/schemas/ReceiptType"
          },
          "amount": {
            "type": "number",
            "description": "Total amount in EUR.",
            "format": "double",
            "example": 15
          },
          "roundingAmount": {
            "type": "number",
            "description": "Rounding amount in EUR.\r\nA price paid in cash is rounded to 5 euro cents. A remainder of the unrounded cash price lower than\r\nhalf of 5 euro cents is rounded down; a remainder equal to or higher than half of 5 euro cents\r\nis rounded up. When the cash price is the sum of prices of several pieces of the same or different\r\ngoods, only the resulting cash price is rounded. A cash price of 1 or 2 euro cents is rounded\r\nto 5 euro cents.",
            "format": "double",
            "example": 0.02
          },
          "issueDate": {
            "type": "string",
            "description": "Date and time the receipt was issued; for a paragon, the date and time the paragon was issued.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "receiptNumber": {
            "type": "integer",
            "description": "Receipt number.",
            "format": "int32",
            "example": 1
          },
          "invoiceNumber": {
            "type": "string",
            "description": "Invoice number, or `null` for receipts other than invoice payments.",
            "nullable": true,
            "example": "201801001"
          },
          "paragonNumber": {
            "type": "integer",
            "description": "Paragon number, or `null` when the receipt is not a paragon.",
            "format": "int32",
            "nullable": true,
            "example": 1
          },
          "icdph": {
            "type": "string",
            "description": "VAT identification number (IČ DPH), if the business is a VAT payer.",
            "nullable": true,
            "example": "SK1234567890"
          },
          "ico": {
            "type": "string",
            "description": "Business identification number (IČO), if one was assigned.",
            "nullable": true,
            "example": "76543210"
          },
          "basicVatAmount": {
            "type": "number",
            "description": "VAT amount for the basic VAT rate, or `null`. It is calculated from the total amount of all items\r\nwith the basic VAT rate and rounded to the nearest euro cent (below 0.005 EUR down, from 0.005 EUR up).",
            "format": "double",
            "nullable": true,
            "example": 25
          },
          "reducedVatAmount": {
            "type": "number",
            "description": "VAT amount for the reduced VAT rate, or `null`. It is calculated from the total amount of all items\r\nwith the reduced VAT rate and rounded to the nearest euro cent (below 0.005 EUR down, from 0.005 EUR up).",
            "format": "double",
            "nullable": true,
            "example": 7.93
          },
          "secondReducedVatAmount": {
            "type": "number",
            "description": "VAT amount for the second reduced VAT rate, or `null`. It is calculated from the total amount of all items\r\nwith the second reduced VAT rate and rounded to the nearest euro cent (below 0.005 EUR down, from 0.005 EUR up).",
            "format": "double",
            "nullable": true,
            "example": 7.93
          },
          "taxFreeAmount": {
            "type": "number",
            "description": "Total amount received for goods sold or services provided that are exempt from VAT or subject to\r\na special regulation, or `null`. For a business that is not a VAT payer, the total of all items.",
            "format": "double",
            "nullable": true,
            "example": 50
          },
          "nonTaxableAmount": {
            "type": "number",
            "description": "Total amount of items not subject to VAT (for example the sale or return of returnable containers), or `null`.",
            "format": "double",
            "nullable": true,
            "example": 0
          },
          "taxBaseBasic": {
            "type": "number",
            "description": "Total tax base for all items with the basic VAT rate, or `null`. It is calculated as the total\r\namount of all items with the basic VAT rate minus the calculated VAT for these items.",
            "format": "double",
            "nullable": true,
            "example": 125
          },
          "taxBaseReduced": {
            "type": "number",
            "description": "Total tax base for all items with the reduced VAT rate, or `null`. It is calculated as the total\r\namount of all items with the reduced VAT rate minus the calculated VAT for these items.",
            "format": "double",
            "nullable": true,
            "example": 79.3
          },
          "taxBaseSecondReduced": {
            "type": "number",
            "description": "Total tax base for all items with the second reduced VAT rate, or `null`. It is calculated as the total\r\namount of all items with the second reduced VAT rate minus the calculated VAT for these items.",
            "format": "double",
            "nullable": true,
            "example": 79.3
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptItemDTO"
            },
            "description": "Receipt items, or `null` for receipt types without items.",
            "nullable": true
          },
          "vatRatesTaxSummary": {
            "$ref": "#/components/schemas/VatRatesTaxSummaryDTO"
          },
          "okp": {
            "type": "string",
            "description": "Cash register verification code (OKP)."
          },
          "pkp": {
            "type": "string",
            "description": "Cash register signature code (PKP)."
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReceiptPaymentDTO"
            },
            "description": "Payments (means of payment) used to settle the receipt.",
            "nullable": true
          },
          "headerText": {
            "type": "string",
            "description": "Header text of the receipt, or `null`.",
            "nullable": true,
            "example": ""
          },
          "footerText": {
            "type": "string",
            "description": "Footer text of the receipt, or `null`.",
            "nullable": true,
            "example": "Ďakujeme za nákup"
          },
          "createDate": {
            "type": "string",
            "description": "Date and time the receipt or the portable cash register location record was created in the cash register.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "dic": {
            "type": "string",
            "description": "Tax identification number (DIČ) of the seller, a string of 10 digits.",
            "example": "1234567890"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "example": "88812345678900001"
          }
        },
        "additionalProperties": false,
        "description": "Data of a registered receipt."
      },
      "ReceiptRegistrationResultReceiptDataDTO": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique receipt identifier (UID) assigned by the eKasa system.",
            "example": "O-7DBCDA8A56EE426DBCDA8A56EE426D1A"
          }
        },
        "additionalProperties": false,
        "description": "Receipt data returned by the eKasa system after the receipt was registered."
      },
      "ReceiptType": {
        "enum": [
          "CashRegister",
          "Invalid",
          "Paragon",
          "Invoice",
          "InvoiceParagon",
          "Deposit",
          "Withdraw"
        ],
        "type": "string",
        "description": "Type of the receipt.\n\n- `CashRegister`: Cash register receipt.\n- `Invalid`: Invalid receipt (non-fiscal document marked as invalid).\n- `Paragon`: Paragon: a paper receipt written by hand while the cash register was out of order, registered in the cash register after it works again.\n- `Invoice`: Invoice payment.\n- `InvoiceParagon`: Paragon for an invoice payment.\n- `Deposit`: Cash deposit document (marked \"Vklad\").\n- `Withdraw`: Cash withdrawal document (marked \"Výber\")."
      },
      "RegisterCashRegisterReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterCashRegisterReceiptRequestDTO"
          },
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a cash register receipt, with optional print settings."
      },
      "RegisterCashRegisterReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CashRegisterReceiptDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a cash register receipt."
      },
      "RegisterGpsLocationRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CashRegisterGpsLocationDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register the location of a portable cash register given as GPS coordinates."
      },
      "RegisterInvalidReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterInvalidReceiptRequestDTO"
          },
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invalid receipt, with optional print settings."
      },
      "RegisterInvalidReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/InvalidReceiptDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invalid receipt."
      },
      "RegisterInvoiceParagonReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterInvoiceParagonReceiptRequestDTO"
          },
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invoice payment paragon, with optional print settings."
      },
      "RegisterInvoiceParagonReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/InvoiceParagonReceiptDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invoice payment paragon."
      },
      "RegisterInvoiceReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterInvoiceReceiptRequestDTO"
          },
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invoice payment receipt, with optional print settings."
      },
      "RegisterInvoiceReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/InvoiceReceiptDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register an invoice payment receipt."
      },
      "RegisterLocationRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CashRegisterLocationDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register the location of a portable cash register."
      },
      "RegisterLocationResultDTO": {
        "required": [
          "error",
          "isSuccessful",
          "request",
          "response"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterLocationResultRequestDTO"
          },
          "response": {
            "$ref": "#/components/schemas/RegisterLocationResultResponseDTO"
          },
          "isSuccessful": {
            "type": "boolean",
            "description": "Whether the eKasa system accepted the request (`true`), rejected it (`false`),\r\nor the request could not be sent yet (`null`).",
            "nullable": true
          },
          "error": {
            "$ref": "#/components/schemas/EKasaErrorDTO"
          }
        },
        "additionalProperties": false,
        "description": "Result of the location registration."
      },
      "RegisterLocationResultRequestDTO": {
        "required": [
          "data",
          "date",
          "externalId",
          "id",
          "sendingCount"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/LocationRegistrationDataDTO"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the request.",
            "format": "uuid"
          },
          "externalId": {
            "type": "string",
            "description": "Client-defined unique identifier of the request; `null` when none was provided.",
            "nullable": true
          },
          "date": {
            "type": "string",
            "description": "Date and time the eKasa client sent the request. On repeated sending attempts it can be\r\nlater than the date the data message was created.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "sendingCount": {
            "type": "integer",
            "description": "Sequence number of the attempt to send the request to the eKasa system.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Location registration request as sent to the eKasa system."
      },
      "RegisterLocationResultResponseDTO": {
        "required": [
          "processDate"
        ],
        "type": "object",
        "properties": {
          "processDate": {
            "type": "string",
            "description": "Date and time the eKasa system processed the successfully registered request.",
            "format": "date-time",
            "example": "2021-01-29T16:07:01+01:00"
          }
        },
        "additionalProperties": false,
        "description": "Response of the eKasa system to a location registration request."
      },
      "RegisterOtherLocationRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CashRegisterOtherLocationDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register the location of a portable cash register given as free text."
      },
      "RegisterParagonReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterParagonReceiptRequestDTO"
          },
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a paragon, with optional print settings."
      },
      "RegisterParagonReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ParagonReceiptDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a paragon."
      },
      "RegisterPhysicalAddressLocationRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CashRegisterPhysicalAddressLocationDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register the location of a portable cash register given as a physical address."
      },
      "RegisterReceiptPrintContextDTO": {
        "required": [
          "printerName"
        ],
        "type": "object",
        "properties": {
          "printerName": {
            "type": "string",
            "description": "Name of the printer the receipt is sent to: `pos`, `pdf` or `email`.",
            "example": "pos"
          }
        },
        "additionalProperties": false,
        "description": "Print settings of a receipt."
      },
      "RegisterReceiptRequestContextDTO": {
        "required": [
          "request"
        ],
        "type": "object",
        "properties": {
          "print": {
            "$ref": "#/components/schemas/RegisterReceiptPrintContextDTO"
          },
          "request": {
            "$ref": "#/components/schemas/RegisterReceiptRequestDTO"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a receipt, with optional print settings."
      },
      "RegisterReceiptRequestDTO": {
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ReceiptBaseDTO"
          },
          "externalId": {
            "type": "string",
            "description": "Optional client-defined request identifier (1 to 40 characters). When set, it must be unique\r\nacross all requests in the CHDÚ storage.",
            "nullable": true,
            "example": "5A81F3F664E1E30428A949E5"
          }
        },
        "additionalProperties": false,
        "description": "Request to register a receipt."
      },
      "RegisterReceiptResultDTO": {
        "required": [
          "error",
          "isSuccessful",
          "request",
          "response"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterReceiptResultRequestDTO"
          },
          "response": {
            "$ref": "#/components/schemas/RegisterReceiptResultResponseDTO"
          },
          "isSuccessful": {
            "type": "boolean",
            "description": "Whether the eKasa system accepted the request (`true`), rejected it (`false`),\r\nor the request could not be sent yet (`null`).",
            "nullable": true
          },
          "error": {
            "$ref": "#/components/schemas/EKasaErrorDTO"
          }
        },
        "additionalProperties": false,
        "description": "Result of a receipt registration."
      },
      "RegisterReceiptResultRequestDTO": {
        "required": [
          "data",
          "date",
          "externalId",
          "id",
          "sendingCount"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ReceiptRegistrationDataDTO"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the request.",
            "format": "uuid"
          },
          "externalId": {
            "type": "string",
            "description": "Client-defined unique identifier of the request; `null` when none was provided.",
            "nullable": true
          },
          "date": {
            "type": "string",
            "description": "Date and time the eKasa client sent the request. On repeated sending attempts it can be\r\nlater than the date the data message was created.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "sendingCount": {
            "type": "integer",
            "description": "Sequence number of the attempt to send the request to the eKasa system.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Data of a receipt registration request."
      },
      "RegisterReceiptResultResponseDTO": {
        "required": [
          "data",
          "processDate"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ReceiptRegistrationResultReceiptDataDTO"
          },
          "processDate": {
            "type": "string",
            "description": "Date and time the eKasa system processed the successfully registered request.",
            "format": "date-time",
            "example": "2021-01-29T16:07:01+01:00"
          }
        },
        "additionalProperties": false,
        "description": "Response of the eKasa system to a receipt registration request."
      },
      "RegisterResultDTO": {
        "required": [
          "error",
          "isSuccessful",
          "request",
          "response"
        ],
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/RegisterResultRequestDTO"
          },
          "isSuccessful": {
            "type": "boolean",
            "description": "Whether the eKasa system accepted the request (`true`), rejected it (`false`),\r\nor the request could not be sent yet (`null`).",
            "nullable": true
          },
          "response": {
            "$ref": "#/components/schemas/RegisterResultResponseDTO"
          },
          "error": {
            "$ref": "#/components/schemas/EKasaErrorDTO"
          }
        },
        "additionalProperties": false,
        "description": "Result of a registration request (receipt or location) sent to the eKasa system."
      },
      "RegisterResultRequestDTO": {
        "required": [
          "date",
          "externalId",
          "id",
          "sendingCount"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the request.",
            "format": "uuid"
          },
          "externalId": {
            "type": "string",
            "description": "Client-defined unique identifier of the request; `null` when none was provided.",
            "nullable": true
          },
          "date": {
            "type": "string",
            "description": "Date and time the eKasa client sent the request. On repeated sending attempts it can be\r\nlater than the date the data message was created.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "sendingCount": {
            "type": "integer",
            "description": "Sequence number of the attempt to send the request to the eKasa system.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Data of a registration request sent to the eKasa system."
      },
      "RegisterResultResponseDTO": {
        "required": [
          "processDate"
        ],
        "type": "object",
        "properties": {
          "processDate": {
            "type": "string",
            "description": "Date and time the eKasa system processed the successfully registered request.",
            "format": "date-time",
            "example": "2021-01-29T16:07:01+01:00"
          }
        },
        "additionalProperties": false,
        "description": "Response of the eKasa system to a registration request."
      },
      "RegisterState": {
        "enum": [
          "Created",
          "Initializing",
          "InitializeFailed",
          "Initialized",
          "Processing",
          "ProcessFailed",
          "Processed",
          "Canceled",
          "Faulted"
        ],
        "type": "string",
        "description": "Processing state of a registration request.\n\n- `Created`: The request has been created.\n- `Initializing`: The request is being initialized.\n- `InitializeFailed`: Initialization of the request failed.\n- `Initialized`: The request is initialized.\n- `Processing`: The request is being processed.\n- `ProcessFailed`: Processing of the request failed.\n- `Processed`: The request has been processed successfully.\n- `Canceled`: Processing of the request was canceled and will not continue.\n- `Faulted`: Processing of the request failed and will not continue."
      },
      "RegisterTokenDTO": {
        "type": "object",
        "properties": {
          "requestContext": {
            "$ref": "#/components/schemas/RegisterTokenRequestContextDTO"
          },
          "result": {
            "$ref": "#/components/schemas/RegisterTokenResultDTO"
          },
          "error": {
            "$ref": "#/components/schemas/RegisterTokenErrorDTO"
          },
          "state": {
            "$ref": "#/components/schemas/RegisterState"
          }
        },
        "additionalProperties": false,
        "description": "Registration state of a request, including repeated sending attempts."
      },
      "RegisterTokenErrorDTO": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message.",
            "nullable": true
          },
          "eKasaErrorCode": {
            "type": "integer",
            "description": "Error code returned by the eKasa system when it rejected the item; otherwise `null`.",
            "format": "int32",
            "nullable": true,
            "example": -2
          }
        },
        "additionalProperties": false,
        "description": "Error that prevented the queue item from being processed."
      },
      "RegisterTokenFilterState": {
        "enum": [
          "Created",
          "Initializing",
          "InitializeFailed",
          "Initialized",
          "Processing",
          "ProcessFailed",
          "Processed",
          "Canceled",
          "Faulted",
          "Unprocessed"
        ],
        "type": "string",
        "description": "Processing state used to filter registration requests.\n\n- `Created`: Created requests.\n- `Initializing`: Requests being initialized.\n- `InitializeFailed`: Requests whose initialization failed.\n- `Initialized`: Initialized requests.\n- `Processing`: Requests being processed.\n- `ProcessFailed`: Requests whose processing failed.\n- `Processed`: Processed requests.\n- `Canceled`: Canceled requests.\n- `Faulted`: Faulted requests.\n- `Unprocessed`: Unprocessed requests (alias that matches all requests not yet successfully processed)."
      },
      "RegisterTokenRequestContextDTO": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/RegistrationType"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the request.",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "description": "Client-defined unique identifier of the request; `null` when none was provided.",
            "nullable": true
          },
          "uuid": {
            "type": "string",
            "description": "UUID of the data message.",
            "nullable": true
          },
          "originUUID": {
            "type": "string",
            "description": "UUID of the original (first) request. Equal to NineDigit.eKasa.API.DTOs.RegisterTokenRequestContextDTO.UUID when NineDigit.eKasa.API.DTOs.RegisterTokenRequestContextDTO.SendingCount is 1.",
            "nullable": true
          },
          "createDate": {
            "type": "string",
            "description": "Date and time the data message was sent from the cash register to the eKasa system.",
            "format": "date-time",
            "example": "2019-01-29T16:07:01+01:00"
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Cash register code (ORP code), a string of 16 or 17 digits.",
            "nullable": true,
            "example": "88812345678900001"
          },
          "receiptNumber": {
            "type": "integer",
            "description": "Receipt number when the request registers a receipt; otherwise `null`.",
            "format": "int32",
            "nullable": true,
            "example": 1
          },
          "sendingCount": {
            "type": "integer",
            "description": "Sequence number of the attempt to send the request to the eKasa system.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Subset of the request information stored in the CHDÚ storage."
      },
      "RegisterTokenResultDTO": {
        "type": "object",
        "properties": {
          "processDate": {
            "type": "string",
            "description": "Date and time the eKasa system processed the successfully registered request.",
            "format": "date-time",
            "example": "2021-01-29T16:07:01+01:00"
          }
        },
        "additionalProperties": false,
        "description": "Result of a registration for a queue item."
      },
      "RegistrationRecordProcessStatus": {
        "enum": [
          "Unprocessed",
          "Processed",
          "Unfinished",
          "Failed"
        ],
        "type": "string",
        "description": "Status of a receipt or location registration request.\n\n- `Unprocessed`: Unprocessed requests, that is requests that are either unfinished or failed; this value is a combination of `Unfinished` and `Failed`.\n- `Processed`: Processed requests, that is requests successfully registered; these requests contain a response.\n- `Unfinished`: Unfinished requests, that is requests without a response, for example because the registration timed out.\n- `Failed`: Failed requests, that is requests rejected by the e-kasa server; these requests contain a response with the corresponding error."
      },
      "RegistrationType": {
        "enum": [
          "Receipt",
          "Location"
        ],
        "type": "string",
        "description": "Type of the registration request.\n\n- `Receipt`: Receipt registration.\n- `Location`: Location registration of a portable cash register."
      },
      "SellerDTO": {
        "required": [
          "id",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the seller on whose behalf goods were sold or services provided: DIČ or IČ DPH, depending on NineDigit.eKasa.API.DTOs.SellerDTO.Type.",
            "example": "SK2004567890"
          },
          "type": {
            "$ref": "#/components/schemas/SellerIdType"
          }
        },
        "additionalProperties": false,
        "description": "Identification of the seller on whose behalf goods were sold or services provided."
      },
      "SellerIdType": {
        "enum": [
          "DIC",
          "ICDPH"
        ],
        "type": "string",
        "description": "Type of the identifier of the seller on whose behalf the goods were sold or the service was provided.\n\n- `DIC`: Tax identification number (DIČ).\n- `ICDPH`: VAT identification number (IČ DPH)."
      },
      "StorageCapacityDTO": {
        "required": [
          "total",
          "used"
        ],
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "description": "Total capacity in bytes.",
            "format": "int64",
            "example": 8589934592
          },
          "used": {
            "type": "integer",
            "description": "Used capacity in bytes.",
            "format": "int64",
            "example": 2173430
          }
        },
        "additionalProperties": false,
        "description": "Capacity of the CHDÚ storage."
      },
      "StorageDeviceDTO": {
        "required": [
          "serialPortName",
          "storageModel",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/DeviceType"
          },
          "vendorId": {
            "type": "integer",
            "description": "Vendor ID reported by the bus; `null` when not available.",
            "format": "int32",
            "nullable": true
          },
          "vendorName": {
            "type": "string",
            "description": "Vendor name reported by the bus; `null` when not available.",
            "nullable": true
          },
          "productId": {
            "type": "integer",
            "description": "Product ID reported by the bus; `null` when not available.",
            "format": "int32",
            "nullable": true
          },
          "productName": {
            "type": "string",
            "description": "Product name reported by the bus; `null` when not available.",
            "nullable": true
          },
          "serialPortName": {
            "type": "string",
            "description": "Address of the serial port the CHDÚ storage is connected to."
          },
          "storageModel": {
            "type": "string",
            "description": "Model of the CHDÚ storage."
          },
          "serialNumber": {
            "type": "string",
            "description": "Unique serial number of the storage; `null` when not available.",
            "nullable": true
          },
          "storageVersion": {
            "type": "string",
            "description": "Storage version (for example \"1.0\" or \"1.1\"); `null` when not available.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Connected storage device."
      },
      "StorageInfoDTO": {
        "required": [
          "capacity",
          "isReadOnly",
          "product"
        ],
        "type": "object",
        "properties": {
          "product": {
            "$ref": "#/components/schemas/StorageProductInfoDTO"
          },
          "capacity": {
            "$ref": "#/components/schemas/StorageCapacityDTO"
          },
          "isReadOnly": {
            "type": "boolean",
            "description": "Whether the storage is read-only."
          }
        },
        "additionalProperties": false,
        "description": "Information about the CHDÚ storage."
      },
      "StorageProductInfoDTO": {
        "required": [
          "name",
          "serialNumber",
          "vendorName",
          "version"
        ],
        "type": "object",
        "properties": {
          "vendorName": {
            "type": "string",
            "description": "Storage vendor name.",
            "example": "Nine Digit, s.r.o."
          },
          "name": {
            "type": "string",
            "description": "Storage product name.",
            "example": "Portos eKasa CHDÚ"
          },
          "version": {
            "type": "string",
            "description": "Storage version.",
            "example": "v1.0"
          },
          "serialNumber": {
            "type": "string",
            "description": "Unique serial number of the storage.",
            "example": "3A21D0E474C0"
          }
        },
        "additionalProperties": false,
        "description": "Product and vendor information of the CHDÚ storage."
      },
      "TaxFreeReason": {
        "enum": [
          "VATReverseCharge",
          "VATExemptionGood",
          "TravelAgency",
          "UsedGood",
          "Artwork",
          "CollectiblesAndAntiques"
        ],
        "type": "string",
        "description": "Reason why a zero VAT rate was assigned to the item, if one was assigned.\n\n- `VATReverseCharge`: Zero VAT rate because of the reverse charge mechanism.\n- `VATExemptionGood`: Zero VAT rate because the item is exempt from VAT.\n- `TravelAgency`: Zero VAT rate because of the special VAT scheme for travel agents.\n- `UsedGood`: Zero VAT rate because of the special VAT scheme for second-hand goods.\n- `Artwork`: Zero VAT rate because of the special VAT scheme for works of art.\n- `CollectiblesAndAntiques`: Zero VAT rate because of the special VAT scheme for collectors' items and antiques."
      },
      "TextPrintContextDTO": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "Text of the non-fiscal receipt to print. May be empty only when NineDigit.eKasa.API.DTOs.TextPrintContextDTO.CashRegisterCode is set.",
            "nullable": true
          },
          "contentFlags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NonfiscalReceiptContentFlags"
            },
            "description": "Types of business-relevant data the non-fiscal receipt contains.\r\n<para />\r\nThe value determines special processing and printing rules that can follow from Slovak legislation,\r\nin particular § 5 (3) (t) of the Act on the use of the electronic cash register.\r\nWhen omitted, the receipt is assumed to contain price information.",
            "nullable": true
          },
          "cashRegisterCode": {
            "type": "string",
            "description": "Optional cash register code. When set, the identification data of that cash register are printed before the text.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request to print a non-fiscal receipt (free text)."
      },
      "VatRateTaxSummaryDTO": {
        "type": "object",
        "properties": {
          "vatRate": {
            "type": "number",
            "description": "VAT rate in percent, or `null` for items not subject to VAT\r\n(for example the sale or return of returnable packaging).",
            "format": "double",
            "nullable": true,
            "example": 23
          },
          "vatBase": {
            "type": "number",
            "description": "Total tax base for the VAT rate.",
            "format": "double",
            "example": 10
          },
          "vatAmount": {
            "type": "number",
            "description": "VAT amount for the VAT rate.",
            "format": "double",
            "example": 2.3
          },
          "totalAmount": {
            "type": "number",
            "description": "Total turnover for the VAT rate.",
            "format": "double",
            "example": 12.3
          }
        },
        "additionalProperties": false,
        "description": "Turnover summary for a single VAT rate."
      },
      "VatRatesTaxSummaryDTO": {
        "type": "object",
        "properties": {
          "totalVatBase": {
            "type": "number",
            "description": "Total of the tax bases.",
            "format": "double",
            "readOnly": true
          },
          "totalVatAmout": {
            "type": "number",
            "description": "Total VAT amount.",
            "format": "double",
            "readOnly": true
          },
          "totalTaxableAmount": {
            "type": "number",
            "description": "Total amount of items subject to VAT.",
            "format": "double",
            "readOnly": true
          },
          "totalNonTaxableAmount": {
            "type": "number",
            "description": "Total amount of items not subject to VAT (for example the sale or return of returnable packaging).",
            "format": "double",
            "readOnly": true
          },
          "totalAmount": {
            "type": "number",
            "description": "Total amount of items subject to VAT and items not subject to VAT.",
            "format": "double",
            "readOnly": true
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VatRateTaxSummaryDTO"
            },
            "description": "Turnover summaries per VAT rate, including the summary of items not subject to VAT.",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Turnover summary broken down by VAT rate."
      }
    }
  }
}
