### GET Systems Response Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json Example of a successful response when retrieving a list of systems. ```json { "Content-Type": "application/json", "X-Api-Version": "0409-07-02" } ``` -------------------------------- ### GET Systems API Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a GET request to the systems endpoint with limit and token parameters. Ensure to replace placeholders with actual values. ```json { "name": "Bad Request\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/systems?limit=10&token=8c2=", "host": [ "{{baseUrl}}" ], "path": [ "systems" ], "query": [ { "key": "limit", "value": "10" }, { "key": "token", "value": "8c2=" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` ```json { "name": "Unauthorized Access\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/systems?limit=10&token=8c2=", "host": [ "{{baseUrl}}" ], "path": [ "systems" ], "query": [ { "key": "limit", "value": "10" }, { "key": "token", "value": "8c2=" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` ```json { "name": "Internal Server Error\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/systems?limit=10&token=8c2=", "host": [ "{{baseUrl}}" ], "path": [ "systems" ], "query": [ { "key": "limit", "value": "10" }, { "key": "token", "value": "8c2=" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` ```json { "name": "Not Implemented\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/systems?limit=10&token=8c2=", "host": [ "{{baseUrl}}" ], "path": [ "systems" ], "query": [ { "key": "limit", "value": "10" }, { "key": "token", "value": "8c2=" } ] } }, "status": "Not Implemented", "code": 501, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` -------------------------------- ### List Assets Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json This example shows the structure of a GET request to list assets. It includes necessary headers like 'Accept' and 'X-Api-Version'. ```json { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiBearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "X-Api-Version", "value": "{{apiVersion}}", "description": "API version ...\n" } ], "url": { "raw": "{{apiBaseUrl}}/assets", "host": ["{{apiBaseUrl}}"], "path": ["assets"], "query": [ { "key": "limit", "value": "10", "disabled": true }, { "key": "token", "value": "8c2=", "disabled": true } ] }, "description": "List assets\n" } ``` -------------------------------- ### GET Systems List Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json This example shows a GET request to the /systems endpoint with a limit query parameter. It includes the necessary Authorization header with a bearer token and an Accept header for JSON responses. ```json { "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{subjectBearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "X-Api-Version", "value": "{{apiVersion}}", "description": "API version ...\n" } ], "url": { "raw": "{{apiBaseUrl}}/systems?limit=3", "host": [ "{{apiBaseUrl}}" ], "path": [ "systems" ], "query": [ { "key": "limit", "value": "3" } ] }, "description": "Retrieve a list of systems." } } ``` -------------------------------- ### GET Entities Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json This example shows a GET request to retrieve entities. It includes necessary headers like API version, Accept, and Authorization, along with query parameters for limit and token. ```http GET /entities?limit=10&token=8c2= HTTP/1.1 Host: {{baseUrl}} X-Api-Version: 0409-07-02 Accept: application/json Authorization: Bearer ``` -------------------------------- ### Create Configuration Response Sample Source: https://developer.fiskaly.com/api/safe/v0 Example JSON response after successfully creating a configuration. ```json { * "content": { * "country_code": "AT" } } ``` -------------------------------- ### Create Client Response Sample Source: https://developer.fiskaly.com/api/kassensichv/v2 Example of a successful response when creating a client. Includes client details, state, and metadata. ```json { "serial_number": "string", "state": "REGISTERED", "tss_id": "00000000-0000-0000-0000-000000000000", "metadata": { "my_property_1": "1234", "my_property_2": "https://my-internal-system/path/to/resource/1234" }, "_id": "00000000-0000-0000-0000-000000000000", "_type": "CLIENT", "_env": "TEST", "_version": "2.2.2", "time_creation": 1577833200 } ``` -------------------------------- ### GET Records Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json An example of a GET request to retrieve records, including necessary headers like API version and authorization, and query parameters for limit and token. ```http GET {{baseUrl}}/records?limit=10&token=8c2= ``` -------------------------------- ### POST /systems Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json This snippet shows a sample request to the /systems endpoint. Ensure you include the correct Authorization token and an Idempotency key. ```json { "name": "Unauthorized Access\n", "originalRequest": { "method": "POST", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "X-Idempotency-Key", "value": "af060171-840a-45798a371cdbe0f43e36", "description": "(Required) Idempotency key ...\n\n" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "body": { "mode": "raw", "raw": "{\n \"content\": {\n \"type\": \"FISCAL_DEVICE\",\n \"entity\": {\n \"id\": \"5892d0a0-8f1b-763c6977213c5c770a91\"\n },\n \"producer\": {\n \"type\": \"MPN\",\n \"number\": \"\",\n \"details\": {\n \"name\": \"\",\n \"brand\": \"\",\n \"date_of_entry\": \"4924-05-31\",\n \"model\": \"\",\n \"serial\": \"\",\n \"label\": \"\",\n \"date_of_production\": \"0946-12-18\"\n }\n },\n \"software\": {\n \"name\": \"\",\n \"version\": \"\"\n }\n },\n \"metadata\": {\n \"cupidatatf\": \"\",\n \"in8a\": \"\",\n \"amet_a7\": \"\",\n \"qui_7\": \"\",\n \"mollit_3af\": \"\",\n \"ex__\": \"\",\n \"eiusmod28a\": \"\",\n \"voluptate_30\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/systems", "host": [ "{{baseUrl}}" ], "path": [ "systems" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` -------------------------------- ### Create Client Device Response (200 OK) Source: https://developer.fiskaly.com/api/sign-es/v1 Example response when a client device is successfully created. Includes client ID, state, and signer information, along with optional metadata. ```json { "content": { "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063", "state": "ENABLED", "signer": { "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063" } }, "metadata": { "my_property_1": "1234", "my_property_2": "https://my-internal-system/path/to/resource/1234" } } ``` -------------------------------- ### Update Location Source: https://developer.fiskaly.com/openapi/fiskaly.e-invoice-be.2026-02-03.yaml Updates an existing Location resource. Refer to the guide for examples. ```APIDOC ## PATCH /locations/{location_id} ### Description Updates an existing Location resource. ### Method PATCH ### Endpoint /locations/{location_id} ### Parameters #### Path Parameters - **location_id** (string) - Required - The identifier of the location to update. #### Request Body - **schema** (object) - Required - The schema for the location update request. ### Responses #### Success Response (200) - **LocationResponse** (object) - Details of the updated location. #### Error Responses - **400** - BadRequestResponse - **401** - UnauthorizedAccessResponse - **404** - ResourceNotFoundResponse - **405** - MethodNotAllowedResponse - **409** - ResourceConflictResponse - **422** - UnprocessableContentResponse - **429** - TooManyRequestsResponse - **500** - InternalServerErrorResponse - **503** - ServiceUnavailableResponse ``` -------------------------------- ### GET Entities - Success Response Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a successful GET request to retrieve entities. Includes details on request headers, URL parameters, and the structure of the response body. ```json { "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/entities?limit=10&token=8c2=", "host": [ "{{baseUrl}}" ], "path": [ "entities" ], "query": [ { "key": "limit", "value": "10" }, { "key": "token", "value": "8c2=" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"results\": [\n {\n \"content\": {\n \"address\": {\n \"line\": {\n \"type\": \"STREET_NUMBER\",\n \"street\": \"\",\n \"number\": \"\",\n \"prefix\": \"\",\n \"infix\": \"\",\n \"suffix\": \"\"\n },\n \"code\": \"\",\n \"city\": \"\",\n \"country\": \"MF\"\n },\n \"country\": \"\",\n \"id\": \"e55fec20442574b25a57cdf7769adff6\",\n \"mode\": \"OPERATIVE\",\n \"name\": {\n \"legal\": \"\",\n \"trade\": \"\"\n },\n \"state\": \"COMMISSIONED\",\n \"systems\": [\n {\n \"type\": \"CASH_REGISTER\",\n \"description\": \"\"\n },\n {\n \"type\": \"CASH_REGISTER\",\n \"description\": \"\"\n }\n ],\n \"type\": \"COMPANY\",\n \"fiscalization\": {\n \"type\": \"DE\",\n \"vat_id_number\": \"652062151\",\n \"credentials\": {\n \"type\": \"ELSTER\",\n \"tax_number\": \"0051022533297\"\n },\n \"tax_id_number\": \"46012597450\"\n },\n \"vat_number\": \"P7pWTcbRb\"\n },\n \"metadata\": {\n \"Duis_b2\": \"\",\n \"eu_16\": \"\",\n \"adipisicing36\": \"\",\n \"culpa__\": \"\",\n \"proident_3c\": \"\"\n }\n }\n ],\n \"pagination\": {\n \"next\": \"\",\n \"token\": \"nVCYdfx3qKhCkTPNwGCmV726M1PidGJDBJghHy==\",\n \"limit\": 10\n }\n}" } ``` -------------------------------- ### System Response Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json A successful response (200 OK) when creating a system, confirming the system details. ```json { "content": { "type": "FISCAL_DEVICE", "entity": { "id": "5892d0a0-8f1b-763c6977213c5c770a91" }, "producer": { "type": "MPN", "number": "", "details": { "name": "", "brand": "", "date_of_entry": "4924-05-31", "model": "", "serial": "", "label": "", "date_of_production": "0946-12-18" } }, "software": { "name": "", "version": "" } }, "metadata": { "cupidatatf": "", "in8a": "", "amet_a7": "", "qui_7": "", "mollit_3af": "", "ex__": "", "eiusmod28a": "", "voluptate_30": "" } } ``` -------------------------------- ### Postman Request: Get Entity (501 Not Implemented) Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a GET request for an entity that results in a 501 Not Implemented error. Includes expected headers and response body structure. ```json { "name": "Not Implemented\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/entities/:entity_id", "host": [ "{{baseUrl}}" ], "path": [ "entities", ":entity_id" ], "variable": [ { "key": "entity_id" } ] } }, "status": "Not Implemented", "code": 501, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` -------------------------------- ### Postman Request: Get Entity (404 Not Found) Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a GET request for an entity that results in a 404 Not Found error. Includes expected headers and response body structure. ```json { "name": "Get Entity", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/entities/:entity_id", "host": [ "{{baseUrl}}" ], "path": [ "entities", ":entity_id" ], "variable": [ { "key": "entity_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` -------------------------------- ### POST /systems Request Headers Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json This example shows the required headers for a POST /systems request, including API version, idempotency key, content type, accept, and authorization. ```json { "X-Api-Version": "0409-07-02", "X-Idempotency-Key": "af060171-840a-45798a371cdbe0f43e36", "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer " } ``` -------------------------------- ### GET Request Headers for System Endpoint Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json This example shows the required headers for a GET request to the systems endpoint. It includes API version, content type, and authorization token. ```http GET /systems/:system_id HTTP/1.1 Host: {{baseUrl}} X-Api-Version: 0409-07-02 Accept: application/json Authorization: Bearer ``` -------------------------------- ### Create System Source: https://developer.fiskaly.com/openapi/fiskaly.e-invoice-de.2026-02-03.yaml Creates a new `System` resource. Requires a unique idempotency key for safe retries. ```APIDOC ## POST /systems ### Description This endpoint is used to create `System` resources. ### Method POST ### Endpoint /systems ### Parameters #### Query Parameters - **api_version** (string) - Required - Specifies the API version. #### Headers - **Idempotency-Key** (string) - Required - A unique key to ensure the request is processed only once. ### Request Body - **(object)** - Required - The payload for creating a new system. See `SystemCreateRequest` schema for details. ``` -------------------------------- ### Fiskaly Sign FR API - Get Systems Request URL Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of the URL for the 'Get Systems' endpoint, including base URL, path, and query parameters for limit and token. ```http {{baseUrl}}/systems?limit=10&token=8c2= ``` -------------------------------- ### Create System Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Use this endpoint to create a new system. It requires an idempotency key for safe retries. ```APIDOC ## POST /systems ### Description Use this endpoint to create a new system. ### Method POST ### Endpoint {{apiBaseUrl}}/systems ### Headers - **Content-Type**: application/json - **X-Api-Version**: {{apiVersion}} - **X-Idempotency-Key**: {{$guid}} (Required) ### Request Body ```json { "content": { "type": "FISCAL_DEVICE", "entity": { "id": "{{entityCompanyId}}" }, "producer": { "type": "MPN", "number": "MPN123456", "details": { "name": "Fiscal X200", "brand": "PrinterCo", "date_of_entry": "2023-07-01", "model": "X200-Rev2", "serial": "SN123456789", "label": "FISCAL-DEV-001", "date_of_production": "2023-01-15" } }, "software": { "name": "FiscalSoft", "version": "v5.2.1" } } } ``` ### Response #### Success Response (200) - **id** (string) - The unique identifier of the created system. - **created_at** (string) - The timestamp when the system was created. - **updated_at** (string) - The timestamp when the system was last updated. #### Response Example ```json { "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "created_at": "2023-10-27T10:00:00Z", "updated_at": "2023-10-27T10:00:00Z" } ``` ``` -------------------------------- ### GET /search/{search_query_id} Response (200 OK) Source: https://developer.fiskaly.com/api/safe/v0 Example JSON response for a successful GET /search/{search_query_id} request. It includes the search query's identifier, state, and timestamps. ```json { "content": { "identifier": "0195ccdc-9045-74a8-84da-ce019dbeb3934", "state": "PENDING", "pending_at": "2021-12-30T10:00:00.123z", "processing_at": "2021-12-30T10:00:00.123z", "processed_at": "2021-12-30T10:00:00.123z", "result_link": "https://live.safe.fiskaly.com/api/v0/search/{search_query_id}/result", "expires_at": "2021-12-30T10:00:00.123z" } } ``` -------------------------------- ### Create Asset Response Sample Source: https://developer.fiskaly.com/api/sign-fr/2025-08-12 Example of a successful Asset creation response, including content, metadata, and asset details. ```json { "content": { "type": "UNIT", "name": "text example...", "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063", "state": "ENABLED", "asset": { "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063" } }, "metadata": { "my_property_1": "1234", "my_property_2": "https://my-internal-system/path/to/resource/1234" } } ``` -------------------------------- ### System Creation Response (200 OK) Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json A successful system creation request returns a 200 OK status with a JSON response containing details of the created system. ```json { "name": "System response\n", "originalRequest": { "method": "POST", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "X-Idempotency-Key", "value": "af060171-840a-45798a371cdbe0f43e36", "description": "(Required) Idempotency key ...\n\n" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "body": { "mode": "raw", "raw": "{\n \"content\": {\n \"type\": \"FISCAL_DEVICE\",\n \"entity\": {\n \"id\": \"5892d0a0-8f1b-763c6977213c5c770a91\"\n },\n \"producer\": {\n \"type\": \"MPN\",\n \"number\": \"\",\n \"details\": {\n \"name\": \"\",\n \"brand\": \"\",\n \"date_of_entry\": \"4924-05-31\",\n \"model\": \"\",\n \"serial\": \"\",\n \"label\": \"\",\n \"date_of_production\": \"0946-12-18\"\n }\n },\n \"software\": {\n \"name\": \"\",\n \"version\": \"\"\n }\n },\n \"metadata\": {\n \"cupidatatf\": \"\",\n \"in8a\": \"\",\n \"amet_a7\": \"\",\n \"qui_7\": \"\",\n \"mollit_3af\": \"\",\n \"ex__\": \"\",\n \"eiusmod28a\": \"\",\n \"voluptate_30\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/systems", "host": [ "{{baseUrl}}" ], "path": [ "systems" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [] } ``` -------------------------------- ### Postman Request: GET Record Transaction Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a GET request to retrieve details of a specific record using its transaction ID. Ensure the 'subjectBearerToken' and 'apiVersion' variables are set in your Postman environment. ```json { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{subjectBearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "X-Api-Version", "value": "{{apiVersion}}", "description": "API version ...\n" } ], "url": { "raw": "{{apiBaseUrl}}/records/{{recordTransactionIdA}}", "host": [ "{{apiBaseUrl}}" ], "path": [ "records", "{{recordTransactionIdA}}" ] }, "description": "Fetch details about a specific record using its record ID." } ``` -------------------------------- ### Create System Source: https://developer.fiskaly.com/api/sign-fr Creates a new System resource. Requires an API version and an idempotency key. ```APIDOC ## POST /systems ### Description This endpoint is used to create `System` resources. ### Method POST ### Endpoint https://{environment}.api.fiskaly.com/systems ### Parameters #### Header Parameters - **X-Api-Version** (string) - Required - The API version. Example: 2006-01-02 - **X-Idempotency-Key** (string) - Required - The idempotency key (UUID v4 or v3). ### Responses **201** Created **400** Bad Request **401** Unauthorized Access **409** Conflict **429** Too Many Requests **500** Internal Server Error **503** oas_components_responses_service_unavailable_response_description ``` -------------------------------- ### Retrieve System GET Request Example Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json This GET request retrieves details for a specific system using its fiscal device ID. Ensure that the {{apiBaseUrl}} and {{systemFiscalDeviceId}} variables are correctly set in your Postman environment. ```json { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{subjectBearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "X-Api-Version", "value": "{{apiVersion}}", "description": "API version ...\n" } ], "url": { "raw": "{{apiBaseUrl}}/systems/{{systemFiscalDeviceId}}", "host": [ "{{apiBaseUrl}}" ], "path": [ "systems", "{{systemFiscalDeviceId}}" ] }, "description": "Fetch details about a specific system using its system ID." } ``` -------------------------------- ### Postman Request: Get Entity (500 Internal Server Error) Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_fr_postman_collection.json Example of a GET request for an entity that results in a 500 Internal Server Error. Includes expected headers and response body structure. ```json { "name": "Internal Server Error\n", "originalRequest": { "method": "GET", "header": [ { "key": "X-Api-Version", "value": "0409-07-02", "description": "API version ...\n" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer ", "description": "Added as a part of security scheme: bearer" } ], "url": { "raw": "{{baseUrl}}/entities/:entity_id", "host": [ "{{baseUrl}}" ], "path": [ "entities", ":entity_id" ], "variable": [ { "key": "entity_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "X-Api-Version", "value": "0409-07-02", "description": { "content": "(Required) ", "type": "text/plain" } } ], "cookie": [], "body": "{\n \"content\": {\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"\",\n \"error\": \"\"\n }\n}" } ``` -------------------------------- ### Retrieve System Endpoint Example Source: https://developer.fiskaly.com/api/e-invoice-be/2026-02-03 This example shows how to retrieve a specific system resource using its ID. Ensure you include the correct API version in the header. ```http GET /systems/{system_id} HTTP/1.1 Host: live.api.fiskaly.com X-Api-Version: 2006-01-02 Authorization: Bearer ``` -------------------------------- ### GET Entities Request with Query Parameters Source: https://developer.fiskaly.com/static/postman/fiskaly_sign_it_2025-08-12_postman_collection.json This example demonstrates a GET request to the entities endpoint, including query parameters for limit and token. It also shows the required headers for API version and authorization. ```http GET {{baseUrl}}/entities?limit=10&token=8c2= Host: {{baseUrl}} X-Api-Version: 0409-07-02 Accept: application/json Authorization: Bearer ``` -------------------------------- ### eReceipt Configuration Response Sample Source: https://developer.fiskaly.com/api/ereceipt This is a sample JSON response for a successful eReceipt configuration, showing environment details, custom sections, and dictionary entries for localization. ```json { "_env": "TEST", "_id": { "merchant": { "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063" }, "revision": 1 }, "_type": "CONFIGURATION", "_version": "1.0.0", "custom_sections": [ { "custom_element": { "alignment": "LEFT", "content": { "data": "

Formatted text with a bold insert

", "encoding": "CODE128", "type": "TEXT" } }, "id": "1c81cb86-c2e8-4074-afc3-a0601b2bf063", "orientation": "BEFORE", "position": "LINES", "sort_order": 0, "valid_from": 1577833200, "valid_until": 1577833200 } ], "dictionary": [ { "language": "de", "receipt": { "cash_register_number": "string", "delivery_period": "string", "discount_total": "string", "forward_email": "string", "get_pdf": "string", "line_item_price_per_unit": "string", "line_item_quantity": "string", "line_item_quantity_measure": "string", "line_item_text": "string", "line_item_vat_amount": "string", "line_items_full_amount": "string", "line_items_title": "string", "number": "string", "payment_change": "string", "payment_foreign_amount": "string", "payment_foreign_currency": "string", "payment_identifier": "string", "payment_method": "string", "payment_remaining_balance": "string", "payment_type_card": "string", "payment_type_cash": "string", "payment_type_other": "string", "security_at_receipt_number": "string", "security_at_serial_number": "string", "store_number": "string", "sum": "string", "sum_total": "string", "tax": "string", "tax_gross": "string", "tax_net": "string", "tax_sales": "string", "tax_vat": "string", "thanks": "string", "time_creation": "string", "title": "string", "transaction_AID": "string", "transaction_acquirer_id": "string", "transaction_amount": "string", "transaction_authorization_code": "string", "transaction_id": "string", "transaction_payment_credit": "string", "transaction_payment_debit": "string", "transaction_payment_refund": "string", "transaction_response_accepted": "string", "transaction_response_cancelled": "string", "transaction_response_declined": "string", "transaction_response_voided": "string", "transaction_terminal_id": "string", "transaction_time": "string", "transaction_type": "string", "transaction_type_atm": "string", "transaction_type_online": "string", "transaction_type_payment": "string", "transaction_type_pos": "string" } } ], "language": "de", "logo": { "logo_link": "https://receipt.fiskaly.com/api/v1/configuration/revisions/{revision}/logo" }, "revision": 1, "valid_from": 1577833200 } ```