The “Accommodation Tax”, is a tax that charges the resident (client) who has used a room or an apartment and is imposed after his stay in the accommodation, and before his departure from it. The amount of the charged tax, depends on the category of the accommodation.
This guide demonstrates how to create “Accommodation Tax” for clients located in Greece (myDATA document type “8.2 Accommodation Tax”)
- The guide assumes you’re working on a new Elorus organization, so this step can be omitted.
First lets create a contact so there is someone to bill. In a business context, contacts are individuals or businesses whom you transact with; typically your clients, leads, suppliers and partners. Since Elorus will let you manage your sales as well as your expenses, a contact may represent either a client or a supplier (or even both).
curl -X POST -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/contacts/ -d '{"client_type": "1", "company":"Elorus SA", "vat_number":"0123456789", "addresses":[{"address":"Theofilopoulou 13", "city":"Athens", "zip":"11743", "country": "GR", "ad_type": "bill"}], "is_client": true, "is_supplier":false}'
Filter e.g. by “company”, to get the contact ID. Retrieved contact ID in this case is “2480647926494267071”.
curl -X GET -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/contacts/?company="Elorus SA"
First, by going to the Elorus' UI > menu Settings > Taxes > Add, you must enter the “Accommodation Tax” that applies to your business.
It is a one-time process to activate the ability to add “Accommodation Tax” to your account from now on.
Search by “title” e.g. “Ξενοδοχεία 3 αστέρων”, to get the tax ID. Retrieved tax ID in this case is “2624067035251869663”.
curl -X GET -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/taxes/?search="Ξενοδοχεία 3 αστέρων"&search_fields=title
The final step, is to create the “Accommodation Tax” as a received payment. The list below describes all the needed fields.
curl -X POST -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/cashreceipts/ -d '{"transaction_type":"at", "contact":"2480647926494267071", "date":"2022-11-30", "taxes":["2624067035251869663"], "quantity": "1", "mydata_document_type":"8.2", "payment_method": "3"}'