We are using Cloudfare for domain management.
Here are the subdomains defined:
f - for production
test.f - for test environment.
How we write and read from Beds24
Beds24 Wiki https://wiki.beds24.com/index.php/API_V2.0
API https://beds24.com/api/v2/
There are three tokens:
Invitation code, which is generated manually on Beds24, it is alive for 1 hour https://beds24.com/control3.php?pagetype=apiv2
Refresh token, which is generated manually by an API call to Beds24 https://beds24.com/api/v2/#/Authentication/get_authentication_setup
Then save this into Firestore
This is alive indefinitely, as long as it is used once a month
A refresh token is saved into the Firestore Emulator with data import, so it doesn't have to be manually written in every time https://firebase.google.com/docs/emulator-suite/install_and_configure
Access token, which is generated with this API call https://beds24.com/api/v2/#/Authentication/get_authentication_token
It is used to authenticate with every read or write
This is alive for 24 hours
There are three userIds, two PROD and one TEST.
Prod:
Besk (R)
Endrédi Balázs (EB)
Teszt:
TESZT Endrédi Balázs (SRHPO)
Teszt BESK Kft (BESK)
You need to login to this webpage: https://www.szamlazz.hu/szamla/
use this developer account to access this webpage, you can get it from the latest version of the jobelhome credentials
You can access the great developer documentation on this website: https://docs.szamlazz.hu/agent/generating_invoice/request
We get a call from the Beds24 API, with all the necessary data that we need to generate the booking.
We need to get the current exchange rate for today, if it is not available use the one from the last working day.
We use the API of the Hungarian Central Bank to do this, which is available here: https://mnb.hu/arfolyamok.asmx
Then we create a data file that consists of every information that is processed. This info only needs to be mapped to every individual invoice provider.
Then this generic data is mapped to the szamlazz.hu API requirements, that you can read from their docs.
If the invoice file has been created successfully, we store it in GCP storage.
If not, then we store the error file also in GCP.
These files are only stored for one year, we make sure of that within the GCP storage as a lifecycle.
If the invoice has been generated successfully or with an error, we call Gchat and send a notification.
We don't need any certificates to access the API, only the basic ones which can be accessed in the config files called prod-config.json and dev-config.json.
What is NTAK? The National Tourism Data Supply Centre (NTDSC for short, or NTAK in Hungarian) collects data from various types of providers in the hospitality sector, such as: Accommodation: hotels, hostels, and short-term rentals. - In Hungary, it is mandatory to collect the guests' data that's why we created the Registration Form of JHP.
After the guests fill out the registration form, we manually enter the information on vendegem.hu, a free guest data-collecting software. Vendegem.hu forward the guest data to NTAK. Our main goal is to connect NTAK with our self-developed software which can forward the data to NTAK.
Why we should develop software, why vendegem.hu is not enough? At vendegem.hu, we should enter the personal data manually which is a lot of work or the guest can also do it by scanning their I.D. card. Still, usually, it's too complicated for them and not manageable. We want to automatically forward the data we receive in the registration forms to NTAK.
Additional information to start:
https://info.ntak.hu/en/softwares » Property management systems
We keep your registration under ticket number 108291.
A test service location has been created. It will be possible to perform data transmission tests on behalf of this test service location.
To send test messages, they will need a certificate issued by the NTAK system. The process of creating the request file (CSR) required for requesting the certificate can be seen in the PMS interface description. Please send us the generated certificate request file (with .cs extension) in a reply email, on the basis of which we will create the certificate required for data communication.
When sending the created certificate request, please provide the IP address from which you wish to send the test messages, as well as the version number of the software you wish to connect.
The sent IP address is whitelisted and at the same time, based on the CSR file also sent, we create the certificate required for testing. We will send the created certificate as well as the interface test environment endpoints in a reply letter for your kind use. Once you have them, you can start calling the test endpoint and sending test data.
Registration data required to start sending test data:
Name of service provider: Interface_connection_service provider
Service provider tax number: 11223344122
Name of service location: BESK_Kft
Service location NTAK registration number: SZ23002685
The identifier of the PMS system is: JOBELHOME
The version number of the PMS system to be recorded in the test messages to be sent: 1.2
Accommodation data service identifier: 6PWNRDA5
If you do not yet have the valid unified certificate required for sending test data for any of the test interfaces (RMS-TSS-PMS), please send us the certificate request (csr) file as a response to this message in order to create the certificate required for sending data.
If you have any further questions, we are available at +36-1-58-58-326 or by e-mail at dev.support@ntak.hu.
If you are replying to this letter, please do not delete the ticket number from the subject field!
Best regards,
Developer support
phone number: +3615858326
e-mail: dev.support@ntak.hu
Creating a RSA 4096 PKCS10 keypair on Windows
openssl genrsa -passout pass:egyetem -aes256 -out keypair.pem 4096
set OPENSSL_CONF=C:\Users\Attila\Downloads\openssl\openssl.cnf
openssl req -new -key keypair.pem -out certificaterequest.csr -passin pass:egyetem
What is Feratel? It's similar to NTAK but in Germany.
Additional information to start:
https://feratel.atlassian.net/wiki/spaces/CONNECTIVITY/pages/62424130/Visitor+Registration+Interface
https://feratel.atlassian.net/servicedesk/customer/portal/37/user/login?destination=portal%2F37
You can find the login info in the KeePass (JobelHome credentials - Development).
Created test hotel with a matching WebClient account
The data you need to be able to send registrations/reporting forms are as follows:
Company name: JobelHome platform / endicon Ltd.
MappingCode - OPERATION NO: 120923
Municipality number - OESTAT: 41503
CompanyCode for the test environment: VTPMSTEST
You can check the registrations in our user interface, which we call WebClient.
The link and access data are as follows: https://webclient4test.deskline.net/FRT/de/login
You can find the login info in the KeePass (JobelHome credentials - Development).
As explained in the interface description, you can use the GetVTInfo link to retrieve information such as free blocks, valid groups of people, etc.
In principle, would you be interested in the extension we provide for Feratel Pre-Checkin and the digital signature or passport scan? (I think digital signature would be useful - Dorci)
Here is some info about this function:
Overview video for the Pre-CheckIn function - Attention, further manual processing of the registration form in the WebClient (as shown in the video) is not provided for hotel software users.
Contact person: Isabella Ribisel servicedesk.connectivity@feratel.com