.. meta::
  :description: Fount
  :keywords: channel manager, wubook fount, booking engine, API, json
  
WuBook Fount Database Access
****************************

.. toctree::
   :maxdepth: 1 

If you're a WuBook Official Fount Partner, you can access our database in order to gain:

     - a list of properties you can sell on your sites.
     - analysis and stats about your reselling activity.

As always, it's easy. Simple POSTs will be enough to get your information.

Authentication
==============

To use the WuBook Fount Database Access, you always need to use your credentials. You're gonna need to POST the following fields:

    - **user**: your username
    - **password**: your password
    - **origin**: the code of your Fount

These fields are always **mandatory**. 

Params or JSON
==============

You always have two ways to send parameters: you can POST a set of paramters or a JSON packed structure.


    - **Simple multiple params**: foo=bar, bat=man
    - **Json single params**: json= JSON.stringify({foo: 'bar', bat: 'man'})

Return Values
=============

You always get a json structure. If an error occurs, you will receive the following structure:

 **{'error': 'Human Readable Error'}**

Property List
=============

You can fetch the list of properties that can be sold on your sites. Specifications are very easy:

    - URL: `https://wubook.net/wbkd/partner/hotel_inventory`
    - Optional Paramters: latitude (default= None), longitude (default= None), range (default= 30 -kilometers-), json (default None).


If you specify latitude and longitude, **only** properties near the identified place will be returned. 
With "near", we mean **distance between** the property and the place is **not greater** than 30 Kilometers by default. 

You can specify as an - **additional and optional parameter** - the range field (as integer, representing a distance in kilometers).

If you don't specify them, we will return a full list of subscribed properties, what you get is a 
JSON response, which is a list of properties. This is an example (with two properties):

.. code-block:: python

  [
    {
      "fax": "wuFax", 
      "phone": "wuPhone", 
      "street": "Viale Wu 42", 
      "postal_code": "666", 
      "partner_id": 1213394817, 
      "city": "wuCity", 
      "name": "Il Tuo Hotel / b&b", 
      "country": "IT", 
      "longitude": null, 
      "latitude": null, 
      "currency": "EUR",
      "email": "bat@man.org",
     }, 
     {
      "fax": "wuFax", 
      "phone": "wuPhone", 
      "street": "Viale Wu 42", 
      "postal_code": "666", 
      "partner_id": 1213394817, 
      "city": "wuCity", 
      "name": "your Hotel / b&b", 
      "country": "IT", 
      "longitude": null, 
      "latitude": null, 
      "currency": "EUR",
      "email": "batman@gcpd.org",
     }
  ]

Business Analysis
=================

You can collect information about your business, querying our server and obtaining- for a given a range of dates- the
number received reservations, the number of the cancelled reservations, impressions and so on.

    **URL**: https://wubook.net/wbkd/partner/origin_analysis

    **Mandatory Paramters**: lcode, dfrom, dto 

The parameter lcode is the property identifier. The parameters **dfrom** and **dto** allow you to specify the range of dates
of your interest.

It's also possible to fetch reservation details. The following query will return all the reservations received between
the specified dates from your origin:

    **URL**: https://wubook.net/wbkd/partner/origin_reservations

That being said, good job and good luck!