.. meta::
  :description: Reservations Confirmation
  :keywords: Woodooapi 



Reservations Confirmation
=========================

The OTA can optionally require from WuBook the confirmation receipt of reservations.
This confirmation can be used to mark all the already returned reservations and to not send them back again in the
following **get_bookings** response, unless another event of modification/cancellation has occurred.
This behavior is not mandatory, meaning that the OTA can also choose to always return all reservations in
the requested date range.

Request from WooDoo
-------------------

::

 {
   "action":"confirm_bookings",
   "data":{
       "confirmBookings":[
            {
            "booking_id":"123",
            "status":"new",
            “booking_modification_id”: “1001”
            },
            {
            "booking_id":"234",
            "status":"modified",
            “booking_modification_id”: “2002”
            }
       ]
    }



+------------------------+-------------+-------------+-------------------------------------------------------------------+
| **Field**              |  Mandatory  |  **Type**   |  **Description**                                                  |
+========================+=============+=============+===================================================================+
|  booking_id            |    Yes      |    String   |   The OTA boooking identifier to be confirmed                     |
+------------------------+-------------+-------------+-------------------------------------------------------------------+
|  status                |    Yes      |    String   |   The status of the reservation to be confirmed                   |
+------------------------+-------------+-------------+-------------------------------------------------------------------+
| booking_modification_id|    No       |    String   |   Identifier of the booking event. We will return this            |
|                        |             |             |   key-value element in booking confirmation if the same           |
|                        |             |             |   key-value element is included in booking json                   |
|                        |             |             |   (pushed or returned by get_bookings)                            |
+------------------------+-------------+-------------+-------------------------------------------------------------------+


Response from channel
---------------------

::

 {
   "code": 200,
 }


**Optional**

In case the OTA chooses to return just the unconfirmed reservations, it would be preferable but not
mandatory, to implement a variation of **get_bookings** service that accepts an additional parameter used to
specify when any ( **also**) confirmed reservations should be returned (unconfirmed should be always returned)

::

 {
 "action":"get_bookings",
 "data":{
     "start_time":"2015-09-20 15:00:00",
     "return_also_confirmed": true
  }
 }


The default request made by WuBook will use **return_also_confirmed= false**, and if
the key is not specified in the request, a default **false** value should be intended.
It will be **true** only in particular cases in which WuBook needs to fetch again reservations already retrieved and confirmed before.