API Clarification

[Youssef Hassrouty]

Hello Support team,

I have some question about RoomoRama APIs hope you can help me with

1. Can we bulk update the Availability and prices? As per API documentation we can only send one block of date per request
   
2. Is there any way to know the exact error when the API call fail and we get a 422 message
3. What are the Location and address supported by Roomorama? I got error when using the interface that some locations are not supported.
4. when a user use an application registered by another user does all the hooks will be effective and can be used?

I have some question about how Roomorama Booking system works

1. Is it required for the Host to approve the booking to be effective
2. what is the better way to get the booking, does the hook is sufficient or we need also to get all the listing
3. can a host cancel an accepted booking?
4. can the guest cancel an accepted Booking?
5. How can we create a dummy booking to test our Applications and the hooks.
   

finally we have a blocked application we want to use please if anyone could help us with that to proceed with creating the hooks

account info :

• username:erached
• email:era...@codefish.com
• password:ronnys
• application Name: OutSwitch

Awaiting your reply

Kind Regards

Youssef Hassrouty

Senior Developer | Codefish.com

[Donald Piret]

Hi Youssef,

Replied to some of these in private already but will post the answers here anyway for everybody.

On Friday, 30 August, 2013 at 10:54 PM, Youssef Hassrouty wrote:

Hello Support team,

I have some question about RoomoRama APIs hope you can help me with

1. Can we bulk update the Availability and prices? As per API documentation we can only send one block of date per request
   

The API endpoint actually supports collections of these availability objects. So you could post JSON like this

[{date: '2013-08-26', nightly_rate: 280},{date: '2013-08-27', nightly_rate: 290}]

or in xml:

<availabilities>

<availability>

<date>2013-08-26</date>

<nightly_rate>280</nightly_rate>

</availability>

<availability>

<date> … etc.. 

2. Is there any way to know the exact error when the API call fail and we get a 422 message

 I'll see what we can do about the 422 error codes. Could you provide me with a sample API call that fails with this code so that I can use it to write a spec on our end?

1. What are the Location and address supported by Roomorama? I got error when using the interface that some locations are not supported.

We support listing properties in all destinations listed in our destinations API call. If you would like to list a property in a destination that's not part of that list or for which this fails, please send an email to in...@roomorama.com with the city in which you would like to list. Our business team will be able to handle that request from there onwards (or feel free to send it to me and I'll forward it to the appropriate person). 

1. when a user use an application registered by another user does all the hooks will be effective and can be used?

Yup 

I have some question about how Roomorama Booking system works

1. Is it required for the Host to approve the booking to be effective

Yes 

1. what is the better way to get the booking, does the hook is sufficient or we need also to get all the listing

The hook should contain all the necessary information for you to register it into your system. If the data payload is missing some information you believe is critical for your integration to work correctly please let us know and we'll look into integrating it. 

1. can a host cancel an accepted booking?

Yes, but there is a cancellation penalty as described here: https://roomorama.desk.com/customer/portal/articles/12962-for-hosts---how-do-i-cancel-a-confirmed-paid-booking- 

1. can the guest cancel an accepted Booking?

Yes, and he will be subject to the default Roomorama cancellation policy.(https://roomorama.desk.com/customer/portal/articles/12913-how-do-i-cancel-a-booking-). If you are a certified host, you can provide your own cancellation policy for your properties that we will enforce. 

1. How can we create a dummy booking to test our Applications and the hooks.
   

Please use the staging environment (https://staging.roomorama.com, username/pass: roomorama/staging). Note that we regularly reset the data on this environment so you might have to recreate your test data occasionally. You can use test credit card numbers as listed on the following page:

https://www.braintreepayments.com/docs/ruby/reference/sandbox 

finally we have a blocked application we want to use please if anyone could help us with that to proceed with creating the hooks

account info :

• username:erached
• email:era...@codefish.com
• password:ronnys
• application Name: OutSwitch

 Please don't provide your password data on public user groups. Password data should always be kept private.

We're currently investigating this issue with our CSR team, but it seems your account was deleted by our fraud prevention department for the following reasons:

"the title of the property is that most scammers would name their property with the word LUXURY and have a description that would look like they copied it somewhere and have only 1 picture. Also, the host details are from Lebanon which is an OFAC sanctioned country and where we also have confirmed scammers before, but that might not be relevant in this case though since the property is in the US.."

I'll continue the investigation on this case and will keep you updated on any change in procedure we make for the vetting of these accounts.

Best,

Donald