This is API collection primarely for companies offering POS in restaurants and other establishments, which need to add some items to hotel account in Previo PMS.
\nURL address: https://api.previo.app
\nroom -> roomName, guest name can be obtained from guests -> firstName + lastName. Optionaly, but strongly recommended, there could be possibility to choose specific guest (directly from POS) who should pay the items.roomReservationId obtained from previous call of reservations/current. If guest was selected as well, you need to send owner as well. We strongly recommend to send item segment as well (using the segmentId parameter set - ID 3- gastro, ID 1 - bar, ID 12 - restaurant). Complete list of segments can be found here: codebooks/segmentsMost of the connected POSes include settings how to send account items
\nRestaurant consumption (25.6.2015 15:45) - 1pcs - 15% VAT - 200 EUR
Restaurant consumption - 12345789 (25.6.2015 15:45) - 1pcs - 15% VAT - 200 EUR
Beer - 2pcs - 10% VAT - 70 CZK \nGin & Tonic - 1pc - 10% VAT - 150 CZK\n\nAPI priviliges required to use all of the endpoints:
\nPoint of sale
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"How to use","slug":"how-to-use"},{"content":"API priviliges","slug":"api-priviliges"}],"owner":"21342845","collectionId":"8dafc211-1e62-4b01-aee7-25e2807d38d5","publishedId":"2s8YYPFf41","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-11-27T10:22:07.000Z"},"item":[{"name":"hotels","event":[{"listen":"prerequest","script":{"id":"f016d379-e212-483f-970f-fc1b98635b35","exec":["//postman.setEnvironmentVariable(\"username\", \"vitalii.yeremeiev@previo.cz\");","//postman.setEnvironmentVariable(\"password\", \"EU4N8GvTcM\");","//postman.setEnvironmentVariable(\"previo_api_url\", \"https://api.release.previo.info\");","//postman.setEnvironmentVariable(\"previo_api_url\", \"http://api.previo.loc\");","//postman.setEnvironmentVariable(\"previo_api_url\", \"http://api.previo.cz\");"],"type":"text/javascript"}}],"id":"54802b25-05d2-477d-990e-693d40d41159","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{username}}"},{"key":"password","value":"{{password}}"}]},"isInherited":false},"method":"GET","header":[{"key":"X-Previo-App-ID","value":"7","type":"text"}],"body":{"mode":"raw","raw":""},"url":"{{previo_api_url}}/pos/hotels","description":"Get list of hotels and their IDs
\nGlobal list of codes for currencies.
\nGet list of segments assignable to account item, stock item and serivce item. The list of segments is common for all properties.
\nGet all reservations, which are currently on-going, meaning that the guests are in the hotel right now. The output will be list of all ongoing reservations.
\nThis endpoint can be used, if hotel is using access cards integrated with Previo. In response you can get reservation which are connected to particular card number.
\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{username}}"},{"key":"password","value":"{{password}}"}]},"isInherited":true,"source":{"_postman_id":"8dafc211-1e62-4b01-aee7-25e2807d38d5","id":"8dafc211-1e62-4b01-aee7-25e2807d38d5","name":"REST - Point of Sale (POS)","type":"collection"}},"urlObject":{"path":["pos","reservations"],"host":["{{previo_api_url}}"],"query":[{"key":"cardNumber","value":"{{cardNumber}}"}],"variable":[]}},"response":[{"id":"0dba85fb-196e-4886-a60a-a1c90f762076","name":"200","originalRequest":{"method":"GET","header":[{"key":"X-Previo-Hotel-Id","value":"{{hotId}}","type":"text"},{"key":"Card","value":"","type":"text","disabled":true}],"url":{"raw":"{{previo_api_url}}/pos/reservations?cardNumber=C32E77B5000000","host":["{{previo_api_url}}"],"path":["pos","reservations"],"query":[{"key":"cardNumber","value":"C32E77B5000000"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"server","value":"nginx"},{"key":"date","value":"Tue, 21 Mar 2023 10:15:23 GMT"},{"key":"content-type","value":"application/json"},{"key":"transfer-encoding","value":"chunked"},{"key":"vary","value":"Accept-Encoding"},{"key":"expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"cache-control","value":"no-store, no-cache, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"access-control-allow-origin","value":"*"},{"key":"access-control-allow-methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"access-control-allow-headers","value":"X-Requested-With, Content-Type, Authorization, X-Previo-App-ID, X-Previo-Hotel-ID, X-Previo-Language-ID"},{"key":"x-previo-server-instance","value":"web03"},{"key":"content-encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"reservationId\": 67483173,\n \"commissionId\": 89908527,\n \"from\": \"2023-03-21 09:00:00\",\n \"to\": \"2023-03-22 08:00:00\",\n \"voucher\": \"20181258\",\n \"accountItems\": [\n {\n \"roomReservationId\": 89908527,\n \"name\": \"Masáž\",\n \"count\": 1,\n \"price\": 500,\n \"segmentId\": 0,\n \"currencyId\": 1,\n \"vatRate\": 21,\n \"isGroupedByVat\": false,\n \"accountingCode\": null,\n \"vatClassificationCode\": null,\n \"raoId\": null,\n \"owner\": null\n },\n {\n \"roomReservationId\": 89908527,\n \"name\": \"Ubytovací služby (pokoj: 103, termín: 21. 3. 2023 - 22. 3. 2023, hostů: 1)\",\n \"count\": 1,\n \"price\": 100,\n \"segmentId\": 20,\n \"currencyId\": 1,\n \"vatRate\": 10,\n \"isGroupedByVat\": false,\n \"accountingCode\": null,\n \"vatClassificationCode\": null,\n \"raoId\": null,\n \"owner\": null\n },\n {\n \"roomReservationId\": 89908527,\n \"name\": \"Poplatek z pobytu (hostů: 1)\",\n \"count\": 1,\n \"price\": 25,\n \"segmentId\": 6,\n \"currencyId\": 1,\n \"vatRate\": 0,\n \"isGroupedByVat\": false,\n \"accountingCode\": null,\n \"vatClassificationCode\": null,\n \"raoId\": null,\n \"owner\": null\n }\n ],\n \"room\": {\n \"roomId\": 1131924,\n \"roomTypeId\": 605648,\n \"roomName\": \"103\",\n \"roomTypeName\": \"Barbora\"\n },\n \"guestCount\": 1,\n \"guests\": [\n {\n \"id\": 224068446,\n \"name\": \"Lukáš Navrátil\",\n \"firstName\": \"Lukáš\",\n \"lastName\": \"Navrátil\",\n \"sex\": null,\n \"guestCatType\": 3\n }\n ],\n \"cosId\": null\n}"}],"_postman_id":"86835b44-1bd4-4305-90cd-dbdf74750b00"},{"name":"accounts/items","event":[{"listen":"prerequest","script":{"id":"acdf804d-f791-451c-86e7-3d524e6bd0df","exec":[""],"type":"text/javascript"}}],"id":"69d6ae36-7440-4d5d-832c-b08469d2ee70","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{username}}"},{"key":"password","value":"{{password}}"}]},"isInherited":false},"method":"POST","header":[{"key":"X-Previo-Hotel-Id","value":"759281","type":"text"},{"key":"X-Previo-App-ID","value":"7","type":"text"}],"body":{"mode":"raw","raw":"{\n \"roomReservationId\": 103868487,\n \"currencyId\": 1,\n \"isGroupedByVat\": false,\n \"items\": [\n {\n \"name\": \"Bile vino - Savinion 0,75l\",\n \"segmentId\": 1,\n \"count\": 1,\n \"price\": 199.99,\n \"vatRate\": 21,\n \"owner\": null\n },\n {\n \"name\": \"Voda Alpska 0,5l\",\n \"segmentId\": 1,\n \"count\": 2,\n \"price\": 80,\n \"vatRate\": 21,\n \"owner\": null\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{previo_api_url}}/pos/accounts/items","description":"Add new items to hotel account.
\n