A Postman collection containing examples that demonstrate how to use RKSV.Sign, the receipt-signing-only API for Austria.
\nThis Postman collection is meant as a quickstart guide for working with the RKSV.Sign API. For a more detailled description of the methods and alternatives to the REST endpoints, please refer to our documentation.
\nIn order to use this demo collection, the following prerequisites are required:
\nAfter importing the Postman collection, you first need to set the required variables:
\naccount_id and account_access_token. These values are used for the API that creates CashBoxes.cashbox_id, cashbox_access_token) are automatically set. If an existing CashBox should be used, please set these values manually.After you configured these two variables, you can easily run the examples by double-clicking them in the \"Collections\" menu.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"13633406","collectionId":"802fc637-7edb-4114-bcae-b0dc53242bcf","publishedId":"UzBsKR9N","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00A7CE"},"publishDate":"2022-06-27T19:49:12.000Z"},"item":[{"name":"Creating a CashBox","item":[{"name":"Create CashBox","event":[{"listen":"test","script":{"id":"55150ce7-ad0c-45ba-a91c-15643c6f737c","exec":["var jsonData = JSON.parse(responseBody);\r","pm.collectionVariables.set(\"cashbox_id\", jsonData.cashBoxId);\r","pm.collectionVariables.set(\"cashbox_access_token\", jsonData.accessToken);"],"type":"text/javascript"}}],"id":"98757421-9fa2-419f-8ddd-1f60b20701e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accountid","value":"00000000-0000-0000-0000-000000000000","type":"text"},{"key":"accesstoken","value":"REQUIRED","type":"text"}],"body":{"mode":"raw","raw":"\"{\r\n \\\"ftCashBoxId\\\": \\\"|[cashbox_id]|\\\",\r\n \\\"ftSignaturCreationDevices\\\": [\r\n {\r\n \\\"Id\\\": \\\"|[scu0_id]|\\\",\r\n \\\"Package\\\": \\\"fiskaltrust.RKSVSign\\\",\r\n \\\"Configuration\\\": {\r\n \\\"ProductNumber\\\": \\\"4154+020301\\\",\r\n \\\"CompanyName\\\": \\\"The sample in this section shows how to create an RKSV.Sign CashBox.
\n","_postman_id":"c7c7014d-ce3e-4577-aeff-f5e302d15b4b"},{"name":"Signing","item":[{"name":"Echo","id":"414a01c1-2b13-484b-81db-f8de84ea4a42","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"(Required)
\n","key":"cashboxId","value":"00000000-0000-0000-0000-000000000000"},{"description":"(Required)
\n","key":"accessToken","value":"REQUIRED"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"message\": \"Hello RKSV.Sign!\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rksv-sandbox.fiskaltrust.at/api/v0/iatsscd/echo","description":"The echo method can be used to test if the endpoint is available and the authentication parameters are correct. This method returns the exact same data that was sent in the request.
\n","urlObject":{"path":["api","v0","iatsscd","echo"],"host":["https://rksv-sandbox.fiskaltrust.at"],"query":[],"variable":[]}},"response":[{"id":"c1f1e92f-a4bb-4986-88f9-b062469b6f88","name":"Success","originalRequest":{"method":"POST","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text","description":"(Required) "},{"key":"accessToken","value":"REQUIRED","type":"text","description":"(Required) "},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"message\": \"Hello RKSV.Sign!\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rksv-sandbox.fiskaltrust.at/v0/iatsscd/echo"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Hello RKSV.Sign!\"\n}"}],"_postman_id":"414a01c1-2b13-484b-81db-f8de84ea4a42"},{"name":"Sign","id":"8cabb430-1ece-4a25-a066-8ccbe1379ef7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text"},{"key":"accessToken","value":"REQUIRED","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"dataBase64\": \"U29tZSBlbmNvZGVkIGRhdGE=\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rksv-sandbox.fiskaltrust.at/api/v0/iatsscd/sign","description":"The sign method can be used to sign a receipt. The RKSV-compliant receipt data is passed as a Base64-encoded JSON object in the request body. The signature is returned Base64-encoded as a JSON object in the response body.
\n","urlObject":{"path":["api","v0","iatsscd","sign"],"host":["https://rksv-sandbox.fiskaltrust.at"],"query":[],"variable":[]}},"response":[{"id":"3fc00e69-aba3-40a6-a480-3a93d8002db3","name":"Success","originalRequest":{"method":"POST","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text","description":"(Required) "},{"key":"accessToken","value":"REQUIRED","type":"text","description":"(Required) "},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"dataBase64\": \"sE34PMAI4GhOsglNEZcKHw==\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rksv-sandbox.fiskaltrust.at/v0/iatsscd/sign"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"signedDataBase64\": \"KHl67grYp7krlDcUaYVP7w==\"\n}"}],"_postman_id":"8cabb430-1ece-4a25-a066-8ccbe1379ef7"},{"name":"Certificate","id":"a50d507d-c45f-491c-98ce-74ac5ed441e5","request":{"method":"GET","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text"},{"key":"accessToken","value":"REQUIRED","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://rksv-sandbox.fiskaltrust.at/api/v0/iatsscd/certificate","description":"The certificate method is used to obtain the certificate of the RKSV.Sign service. The certificate is returned as a Base64-encoded JSON object in the response body.
\n","urlObject":{"path":["api","v0","iatsscd","certificate"],"host":["https://rksv-sandbox.fiskaltrust.at"],"query":[],"variable":[]}},"response":[{"id":"322593bc-6e87-4db3-a3f2-61213f587713","name":"Success","originalRequest":{"method":"GET","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text","description":"(Required) "},{"key":"accessToken","value":"REQUIRED","type":"text","description":"(Required) "}],"url":"https://rksv-sandbox.fiskaltrust.at/v0/iatsscd/certificate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"certificateBase64\": \"OeBMLNLQCzSdehEaGuVMI0yOXKEJlDIuz44WK3QJXwE=\"\n}"}],"_postman_id":"a50d507d-c45f-491c-98ce-74ac5ed441e5"},{"name":"ZDA","id":"1b044cc5-3bfc-4be6-bcac-4e893527113f","request":{"method":"GET","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text"},{"key":"accessToken","value":"REQUIRED","type":"text"}],"url":"https://rksv-sandbox.fiskaltrust.at/api/v0/iatsscd/zda","description":"The ZDA method is used to obtain the short sign of the certificate service operator of the RKSV.Sign service. The ZDA is returned as a JSON object in the response body.
\n","urlObject":{"path":["api","v0","iatsscd","zda"],"host":["https://rksv-sandbox.fiskaltrust.at"],"query":[],"variable":[]}},"response":[{"id":"45aee77e-9373-46d2-aa96-515e4dadd2f1","name":"Success","originalRequest":{"method":"GET","header":[{"key":"cashboxId","value":"00000000-0000-0000-0000-000000000000","type":"text","description":"(Required) "},{"key":"accessToken","value":"REQUIRED","type":"text","description":"(Required) "}],"url":"https://rksv-sandbox.fiskaltrust.at/v0/iatsscd/zda"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"zda\": \"AT-3\"\n}"}],"_postman_id":"1b044cc5-3bfc-4be6-bcac-4e893527113f"}],"id":"0595f2a5-eafd-4011-a2d8-682ff3856276","description":"The samples in this section demonstrate how to use the RKSV.Sign API.
\n","_postman_id":"0595f2a5-eafd-4011-a2d8-682ff3856276"}],"event":[{"listen":"prerequest","script":{"id":"52af12da-1550-4a63-b219-5f76132ed9c5","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"589d5587-2755-4c5d-a1a6-3ea5e5c2fc60","type":"text/javascript","exec":[""]}}],"variable":[{"key":"account_id","value":"00000000-0000-0000-0000-000000000000","type":"string"},{"key":"account_access_token","value":"REQUIRED","type":"string"},{"key":"helipad_base_url","value":"https://helipad-sandbox.fiskaltrust.cloud","type":"string"},{"key":"cashbox_id","value":"00000000-0000-0000-0000-000000000000","type":"string"},{"key":"outlet_number","value":"1","type":"string"},{"key":"cashbox_access_token","value":"REQUIRED","type":"string"},{"key":"rksvsign_base_url","value":"https://rksv-sandbox.fiskaltrust.at","type":"string"}]}