{"id":21597575,"url":"https://github.com/fiskaltrust/middleware-demo-postman","last_synced_at":"2026-01-03T17:40:31.726Z","repository":{"id":47108577,"uuid":"262599954","full_name":"fiskaltrust/middleware-demo-postman","owner":"fiskaltrust","description":"A Postman collection containing examples that demonstrate how to call the fiskaltrust.Middleware via HTTP.","archived":false,"fork":false,"pushed_at":"2023-08-18T11:23:21.000Z","size":181,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-01-24T17:45:13.978Z","etag":null,"topics":["demo-application","http","kassensichv","middleware","pos-systems","postman-collection","rksv"],"latest_commit_sha":null,"homepage":"https://docs.fiskaltrust.cloud","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fiskaltrust.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-09T15:24:55.000Z","updated_at":"2024-07-05T08:13:05.000Z","dependencies_parsed_at":"2025-01-24T17:41:34.953Z","dependency_job_id":"218bec48-6f14-46f1-98ad-c8ca8bf85a2c","html_url":"https://github.com/fiskaltrust/middleware-demo-postman","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskaltrust%2Fmiddleware-demo-postman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskaltrust%2Fmiddleware-demo-postman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskaltrust%2Fmiddleware-demo-postman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskaltrust%2Fmiddleware-demo-postman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fiskaltrust","download_url":"https://codeload.github.com/fiskaltrust/middleware-demo-postman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244209741,"owners_count":20416336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["demo-application","http","kassensichv","middleware","pos-systems","postman-collection","rksv"],"created_at":"2024-11-24T18:09:22.667Z","updated_at":"2026-01-03T17:40:31.701Z","avatar_url":"https://github.com/fiskaltrust.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# fiskaltrust.Middleware demo (Postman collection)\nA Postman collection containing examples that demonstrate how to call the fiskaltrust.Middleware via HTTP.\n\n[![Run in Postman](https://run.pstmn.io/button.svg)](https://middleware-samples.docs.fiskaltrust.cloud/)\n\n## Getting Started\n\n### Prerequisites\nIn order to use this demo collection, the following prerequisites are required:\n- *Postman with the imported collection*: [Download Postman](https://www.postman.com/), an API testing tool, and install it on your machine. Then click on \"Run in Postman\" on the [middleware API docs](https://middleware-samples.docs.fiskaltrust.cloud/) to import the collection.\n- *The fiskaltrust.Middleware* running on your machine, which can be configured and downloaded via the fiskaltrust.Portal ([AT](https://portal.fiskaltrust.at), [DE](https://portal.fiskaltrust.de), [FR](https://portal.fiskaltrust.fr)). Start it (either by running it as a service, or with the `test.cmd` file), and let it run in the background to handle your requests.\n- *Your Cashbox Id* is visible in the portal. It is also displayed in the startup console log of the Middleware. \n\n### Executing the demo requests\nAfter importing the Postman collection, you first need to set the required variables:\n- Right-click on the collection and select _Edit_\n- Open the _Variables_ tab, and enter the values for `cashbox_id` and `base_url` \n   - **cashbox_id** is a GUID and shown either in the Portal or in the log of the Middleware itself\n   - **base_url** is the URL of the Middleware's HTTP endpoint, **without a trailing slash**. This could e.g. look like this: `http://localhost:1500/bda7742e-fb7e-4eb6-b3ee-27e0c48fc316`. Again, this URL is both displayed in the Portal and in the Middleware log.\n\nAfter you configured these two variables, you can easily run the examples by double-clicking them in the \"Collections\" menu.\n\nFor more information about how to use Postman collections, please refer to [their extensive documentation](https://learning.postman.com/docs/postman/collections/intro-to-collections/).\n\n## Documentation\nThe full documentation for the interface can be found on https://docs.fiskaltrust.cloud. It is actively maintained and developed in our [interface-doc repository](https://github.com/fiskaltrust/interface-doc). \n\nMore information is also available after logging into the portal with a user that has the _PosCreator_ role assigned.\n\n### Communication\nThe fiskaltrust.Middleware supports different communication protocols, effectively giving our customers the possibility to use it on all platforms. Hence, different protocols are recommended for different platforms. Given that HTTP is one of the most generally used network communication protocols, it should be supported on all required platforms. Please have a look into our other demo repositories for alternatives, e.g. via gRPC or SOAP.\n\n#### User specific protocols\nWith the helper topology, it is possible to solve every scenario. Please contact our support if you required assistance for a special case scenario.\n\n## Contributions\nWe welcome all kinds of contributions and feedback, e.g. via Issues or Pull Requests. \n\n## Related resources\nOur latest samples are available for the following programming languages and tools:\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/fiskaltrust/middleware-demo-dotnet\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/0/0d/C_Sharp_wordmark.svg/100px-C_Sharp_wordmark.svg.png\" alt=\"csharp\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://github.com/fiskaltrust/middleware-demo-java\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikiversity/de/thumb/b/b8/Java_cup.svg/100px-Java_cup.svg.png\" alt=\"java\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://github.com/fiskaltrust/middleware-demo-node\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/d/d9/Node.js_logo.svg/100px-Node.js_logo.svg.png\" alt=\"node\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://github.com/fiskaltrust/middleware-demo-android\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/d/d7/Android_robot.svg/100px-Android_robot.svg.png\" alt=\"android\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://github.com/fiskaltrust/middleware-demo-postman\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/10251060?s=100\u0026v=4\" alt=\"node\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nAdditionally, other samples (including legacy ones) can be found in our [demo repository](https://github.com/fiskaltrust/demo).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiskaltrust%2Fmiddleware-demo-postman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiskaltrust%2Fmiddleware-demo-postman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiskaltrust%2Fmiddleware-demo-postman/lists"}