Corporate API

Introduction

If you have a corporate account, these functions can be very useful to program the wubook services.

Note

To launch these functions, you need to use a Token acquired with the credentials of your corporate account.

Global Information

corporate_fetch_accounts(token[, acode])

Returns a KV struct, each Key being the account code, and the Value being another KV struct with the information about the account (email, prepaid_amount, list of properties).

corporate_get_providers_info(token[, acodes=[]])

Returns a list of providers that accessed corporate’s sub-accounts through Wired, each value of this list being a KV struct with the fields pkey (Provider Key), emails (of the provider) and acode (the accessed account code).

The filter acodes is a list of account codes; an empty one will return information for every corporate’s sub-account.

corporate_fetch_channels(token, lcode)

corporate_get_channels(token[, filters])

The corporate_get_channels(), called without the filters argument, returns all of the channels of all of your properties. If you want to filter results, you can pass them inside the KV structure filters, which supports the following (optional and not exclusive) filters:

• dfrom: channels expiring not before this european date

• dto: channels expiring before this european date

• lcodes: a list of lcode, to return channels of a specific set of properties

corporate_fetchable_properties(token)

This function is used to receive a list of properties having new reservations to be fetched. If you use the Push Notification feature, this function could be periodically called (let’s say with a 4 hours frequence) to prevent problems arising from missing notifications. That’s of course seriously better than periodically cycling all of your properties with a fetch_new_bookings() call.

Note

This function could return False Positive cases: properties tagged as “fetchable” but having no new reservations/modifications/cancellations. If you want them to desappear from the list, please, call mark_bookings()

Create accounts and properties

corporate_new_property(token, lodg, woodoo_only, acode)

corporate_new_account_and_property(token, lodg, woodoo_only, account)

Those functions are used to add new properties on your corporate account. The first one will be used when the new property has to be associated to an existing account. The second one will be used when you also need a new account owning the property.

For both functions, the lodg parameter is a KV struct containing the following values:

Field	Meaning
name	The name of the property
address	The address of the property
url	The url of its site
zip	Zip code
city	City
phone	Phone
contact_email	Email
booking_email	Email
country	Two digits code (IT, ES, ..)
timezone (optional)	List of available Timezones

While using corporate_new_account_and_property(), you need to pass a similar KV structure to define a new account, having the following values:

Field	Meaning
first_name	The name of the account owner
last_name	The last name of the account owner
phone	Phone
lang	Two digits code (IT, ES, ..)
email	Email
currency	Three digits code (EUR, USD, ..)

Notice that both functions return information about the new property and, eventually, the new account. The return values is in fact a KV structure containing the lcode (property identifier), acode and password (username and password assigned to the new account) values.

Click on the following link to have a corporate_new_account_and_property() xml example.

+ show/hide code

<methodCall>
  <methodName>corporate_new_account_and_property</methodName>
  <params>
    <param>
      <value>
        <string>9573126409.1799</string>
      </value>
    </param>
    <param>
      <value>
        <struct>
          <member>
            <name>phone</name>
            <value>
              <string>phone</string>
            </value>
          </member>
          <member>
            <name>name</name>
            <value>
              <string>name</string>
            </value>
          </member>
          <member>
            <name>zip</name>
            <value>
              <string>zip</string>
            </value>
          </member>
          <member>
            <name>city</name>
            <value>
              <string>city</string>
            </value>
          </member>
          <member>
            <name>url</name>
            <value>
              <string>a</string>
            </value>
          </member>
          <member>
            <name>country</name>
            <value>
              <string>IT</string>
            </value>
          </member>
          <member>
            <name>address</name>
            <value>
              <string>s</string>
            </value>
          </member>
          <member>
            <name>email</name>
            <value>
              <string>foo@bar.com</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
    <param>
      <value>
        <int>1</int>
      </value>
    </param>
    <param>
      <value>
        <struct>
          <member>
            <name>lang</name>
            <value>
              <string>it</string>
            </value>
          </member>
          <member>
            <name>first_name</name>
            <value>
              <string>a</string>
            </value>
          </member>
          <member>
            <name>last_name</name>
            <value>
              <string>b</string>
            </value>
          </member>
          <member>
            <name>currency</name>
            <value>
              <string>USD</string>
            </value>
          </member>
          <member>
            <name>phone</name>
            <value>
              <string>999</string>
            </value>
          </member>
          <member>
            <name>email</name>
            <value>
              <string>foo@bar.com</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodCall>

Managing subaccounts and properties

corporate_set_password(token, subaccount_code, password)

corporate_recovery_link(token, subaccount_code)

corporate_destroy_subaccount(token, subaccount_code)

corporate_remove_property(token, subaccount_code, lcode)

Function corporate_set_password() let you set the password for one of your subaccounts.

Function corporate_recovery_link() let you generate a link to set a new password for one of your subaccounts. This function returns a link via API and sends an SMS with the secret code to the phone number of the subaccount owner. The secret code is meant to be used on the page linked via the API to set the new password.

Note

For corporate_recovery_link() it is mandatory that the subaccount has a mobile phone number correctly set up on WuBook.

Function corporate_destroy_subaccount() let you destroy a subaccount.

Note

The procedure is irreversible, you will not be able to recover your subaccount’s data. For corporate_destroy_subaccount() it is mandatory to not have confirmed reservations with furure checkout nor transactions waiting for payments in any property.

Function corporate_remove_property() let you remove a property from a subaccount.

Note

For corporate_remove_property() it is mandatory to not have confirmed reservations nor transactions waiting for payments.

Renewing services

corporate_set_autorenew_wb(token, lcode, set_autorenew)

corporate_set_autorenew_zak(token, lcode, set_autorenew)

Those functions allows to setup the autorenew feature. They accept the argument set_autorenew, which is an integer. If 1, you are activating the autorenew feature, while 0 disables it.

corporate_set_channel_status(token, lcode, lchans, running)

Since channels don’t have autorenew but can only be either running or paused, the function for them is a bit different.

running is a boolean integer:

• If 0, it will change the status to paused for the channels in lchans

• If 1, it will change the status to running for the channels in lchans

lchans argument is an array of Channel IDs.

Balance and transactions

Corporates can programmatically read the additional costs that WuBook is registering for your users. It is possible to use the following functions:

corporate_balance_transactions(token)

corporate_balance_details(token, transaction_id)

dtype_mapping(token)

The first function returns the list of your transactions. Notice that a transaction is a container of atomic costs. The result of such function is an array, each item having the following meaning:

• id: guess what! the transaction id!! Surprise :)

• closed_at: if frozen, this is the date of the transaction closure

• details: the anatomy of the transaction

• paid: is this transaction already paid?

Few remarks: the details field does not contain atomic costs. It aggregates them. For example, if you have 2 costs of the same type, then you will receive the sum of such costs, tagged with their related type. The transaction having id==0 (zero) is the current transaction, where current costs are inserted. It’s never closed, never paid.

The function corporate_balance_details is used to retrieve all the atomic costs of a transaction. You obviously must specify the transaction ID and you can use ID=0 to read the current costs (costs associated to the current transaction). Its return value is again an array, each item having the following meaning:

• descr: description

• shortdescr: short description

• embargo: we will not require a payment until this date

• registered: the registration time

• currency: currency

• dtype: the type of cost

• name: the name of the type

• amount: the cost

• lcode: if not null, this cost has been generated for the related property

• account: the user account code who generates the cost

The function dtype_mapping returns an array of cost types. Each item consists on a KV structure with two keys:

• dtype: the cost type

• name: the cost name

Compatible timezones for a new property

Here you can find all the timezones available for corporate_new_property and corporate_new_account_and_property:

• Africa/Abidjan

• Africa/Accra

• Africa/Addis_Ababa

• Africa/Algiers

• Africa/Asmara

• Africa/Bamako

• Africa/Bangui

• Africa/Banjul

• Africa/Bissau

• Africa/Blantyre

• Africa/Brazzaville

• Africa/Bujumbura

• Africa/Cairo

• Africa/Casablanca

• Africa/Ceuta

• Africa/Conakry

• Africa/Dakar

• Africa/Dar_es_Salaam

• Africa/Djibouti

• Africa/Douala

• Africa/El_Aaiun

• Africa/Freetown

• Africa/Gaborone

• Africa/Harare

• Africa/Johannesburg

• Africa/Juba

• Africa/Kampala

• Africa/Khartoum

• Africa/Kigali

• Africa/Kinshasa

• Africa/Lagos

• Africa/Libreville

• Africa/Lome

• Africa/Luanda

• Africa/Lubumbashi

• Africa/Lusaka

• Africa/Malabo

• Africa/Maputo

• Africa/Maseru

• Africa/Mbabane

• Africa/Mogadishu

• Africa/Monrovia

• Africa/Nairobi

• Africa/Ndjamena

• Africa/Niamey

• Africa/Nouakchott

• Africa/Ouagadougou

• Africa/Porto-Novo

• Africa/Sao_Tome

• Africa/Tripoli

• Africa/Tunis

• Africa/Windhoek

• America/Adak

• America/Anchorage

• America/Anguilla

• America/Antigua

• America/Araguaina

• America/Argentina/Buenos_Aires

• America/Argentina/Catamarca

• America/Argentina/Cordoba

• America/Argentina/Jujuy

• America/Argentina/La_Rioja

• America/Argentina/Mendoza

• America/Argentina/Rio_Gallegos

• America/Argentina/Salta

• America/Argentina/San_Juan

• America/Argentina/San_Luis

• America/Argentina/Tucuman

• America/Argentina/Ushuaia

• America/Aruba

• America/Asuncion

• America/Atikokan

• America/Bahia

• America/Bahia_Banderas

• America/Barbados

• America/Belem

• America/Belize

• America/Blanc-Sablon

• America/Boa_Vista

• America/Bogota

• America/Boise

• America/Cambridge_Bay

• America/Campo_Grande

• America/Cancun

• America/Caracas

• America/Cayenne

• America/Cayman

• America/Chicago

• America/Chihuahua

• America/Costa_Rica

• America/Creston

• America/Cuiaba

• America/Curacao

• America/Danmarkshavn

• America/Dawson

• America/Dawson_Creek

• America/Denver

• America/Detroit

• America/Dominica

• America/Edmonton

• America/Eirunepe

• America/El_Salvador

• America/Fort_Nelson

• America/Fortaleza

• America/Glace_Bay

• America/Goose_Bay

• America/Grand_Turk

• America/Grenada

• America/Guadeloupe

• America/Guatemala

• America/Guayaquil

• America/Guyana

• America/Halifax

• America/Havana

• America/Hermosillo

• America/Indiana/Indianapolis

• America/Indiana/Knox

• America/Indiana/Marengo

• America/Indiana/Petersburg

• America/Indiana/Tell_City

• America/Indiana/Vevay

• America/Indiana/Vincennes

• America/Indiana/Winamac

• America/Inuvik

• America/Iqaluit

• America/Jamaica

• America/Juneau

• America/Kentucky/Louisville

• America/Kentucky/Monticello

• America/Kralendijk

• America/La_Paz

• America/Lima

• America/Los_Angeles

• America/Lower_Princes

• America/Maceio

• America/Managua

• America/Manaus

• America/Marigot

• America/Martinique

• America/Matamoros

• America/Mazatlan

• America/Menominee

• America/Merida

• America/Metlakatla

• America/Mexico_City

• America/Miquelon

• America/Moncton

• America/Monterrey

• America/Montevideo

• America/Montserrat

• America/Nassau

• America/New_York

• America/Nipigon

• America/Nome

• America/Noronha

• America/North_Dakota/Beulah

• America/North_Dakota/Center

• America/North_Dakota/New_Salem

• America/Nuuk

• America/Ojinaga

• America/Panama

• America/Pangnirtung

• America/Paramaribo

• America/Phoenix

• America/Port-au-Prince

• America/Port_of_Spain

• America/Porto_Velho

• America/Puerto_Rico

• America/Punta_Arenas

• America/Rainy_River

• America/Rankin_Inlet

• America/Recife

• America/Regina

• America/Resolute

• America/Rio_Branco

• America/Santarem

• America/Santiago

• America/Santo_Domingo

• America/Sao_Paulo

• America/Scoresbysund

• America/Sitka

• America/St_Barthelemy

• America/St_Johns

• America/St_Kitts

• America/St_Lucia

• America/St_Thomas

• America/St_Vincent

• America/Swift_Current

• America/Tegucigalpa

• America/Thule

• America/Thunder_Bay

• America/Tijuana

• America/Toronto

• America/Tortola

• America/Vancouver

• America/Whitehorse

• America/Winnipeg

• America/Yakutat

• America/Yellowknife

• Antarctica/Casey

• Antarctica/Davis

• Antarctica/DumontDUrville

• Antarctica/Macquarie

• Antarctica/Mawson

• Antarctica/McMurdo

• Antarctica/Palmer

• Antarctica/Rothera

• Antarctica/Syowa

• Antarctica/Troll

• Antarctica/Vostok

• Arctic/Longyearbyen

• Asia/Aden

• Asia/Almaty

• Asia/Amman

• Asia/Anadyr

• Asia/Aqtau

• Asia/Aqtobe

• Asia/Ashgabat

• Asia/Atyrau

• Asia/Baghdad

• Asia/Bahrain

• Asia/Baku

• Asia/Bangkok

• Asia/Barnaul

• Asia/Beirut

• Asia/Bishkek

• Asia/Brunei

• Asia/Chita

• Asia/Choibalsan

• Asia/Colombo

• Asia/Damascus

• Asia/Dhaka

• Asia/Dili

• Asia/Dubai

• Asia/Dushanbe

• Asia/Famagusta

• Asia/Gaza

• Asia/Hebron

• Asia/Ho_Chi_Minh

• Asia/Hong_Kong

• Asia/Hovd

• Asia/Irkutsk

• Asia/Jakarta

• Asia/Jayapura

• Asia/Jerusalem

• Asia/Kabul

• Asia/Kamchatka

• Asia/Karachi

• Asia/Kathmandu

• Asia/Khandyga

• Asia/Kolkata

• Asia/Krasnoyarsk

• Asia/Kuala_Lumpur

• Asia/Kuching

• Asia/Kuwait

• Asia/Macau

• Asia/Magadan

• Asia/Makassar

• Asia/Manila

• Asia/Muscat

• Asia/Nicosia

• Asia/Novokuznetsk

• Asia/Novosibirsk

• Asia/Omsk

• Asia/Oral

• Asia/Phnom_Penh

• Asia/Pontianak

• Asia/Pyongyang

• Asia/Qatar

• Asia/Qostanay

• Asia/Qyzylorda

• Asia/Riyadh

• Asia/Sakhalin

• Asia/Samarkand

• Asia/Seoul

• Asia/Shanghai

• Asia/Singapore

• Asia/Srednekolymsk

• Asia/Taipei

• Asia/Tashkent

• Asia/Tbilisi

• Asia/Tehran

• Asia/Thimphu

• Asia/Tokyo

• Asia/Tomsk

• Asia/Ulaanbaatar

• Asia/Urumqi

• Asia/Ust-Nera

• Asia/Vientiane

• Asia/Vladivostok

• Asia/Yakutsk

• Asia/Yangon

• Asia/Yekaterinburg

• Asia/Yerevan

• Atlantic/Azores

• Atlantic/Bermuda

• Atlantic/Canary

• Atlantic/Cape_Verde

• Atlantic/Faroe

• Atlantic/Madeira

• Atlantic/Reykjavik

• Atlantic/South_Georgia

• Atlantic/St_Helena

• Atlantic/Stanley

• Australia/Adelaide

• Australia/Brisbane

• Australia/Broken_Hill

• Australia/Darwin

• Australia/Eucla

• Australia/Hobart

• Australia/Lindeman

• Australia/Lord_Howe

• Australia/Melbourne

• Australia/Perth

• Australia/Sydney

• Canada/Atlantic

• Canada/Central

• Canada/Eastern

• Canada/Mountain

• Canada/Newfoundland

• Canada/Pacific

• Europe/Amsterdam

• Europe/Andorra

• Europe/Astrakhan

• Europe/Athens

• Europe/Belgrade

• Europe/Berlin

• Europe/Bratislava

• Europe/Brussels

• Europe/Bucharest

• Europe/Budapest

• Europe/Busingen

• Europe/Chisinau

• Europe/Copenhagen

• Europe/Dublin

• Europe/Gibraltar

• Europe/Guernsey

• Europe/Helsinki

• Europe/Isle_of_Man

• Europe/Istanbul

• Europe/Jersey

• Europe/Kaliningrad

• Europe/Kirov

• Europe/Kyiv

• Europe/Lisbon

• Europe/Ljubljana

• Europe/London

• Europe/Luxembourg

• Europe/Madrid

• Europe/Malta

• Europe/Mariehamn

• Europe/Minsk

• Europe/Monaco

• Europe/Moscow

• Europe/Oslo

• Europe/Paris

• Europe/Podgorica

• Europe/Prague

• Europe/Riga

• Europe/Rome

• Europe/Samara

• Europe/San_Marino

• Europe/Sarajevo

• Europe/Saratov

• Europe/Simferopol

• Europe/Skopje

• Europe/Sofia

• Europe/Stockholm

• Europe/Tallinn

• Europe/Tirane

• Europe/Ulyanovsk

• Europe/Vaduz

• Europe/Vatican

• Europe/Vienna

• Europe/Vilnius

• Europe/Volgograd

• Europe/Warsaw

• Europe/Zagreb

• Europe/Zurich

• Indian/Antananarivo

• Indian/Chagos

• Indian/Christmas

• Indian/Cocos

• Indian/Comoro

• Indian/Kerguelen

• Indian/Mahe

• Indian/Maldives

• Indian/Mauritius

• Indian/Mayotte

• Indian/Reunion

• Pacific/Apia

• Pacific/Auckland

• Pacific/Bougainville

• Pacific/Chatham

• Pacific/Chuuk

• Pacific/Easter

• Pacific/Efate

• Pacific/Fakaofo

• Pacific/Fiji

• Pacific/Funafuti

• Pacific/Galapagos

• Pacific/Gambier

• Pacific/Guadalcanal

• Pacific/Guam

• Pacific/Honolulu

• Pacific/Kanton

• Pacific/Kiritimati

• Pacific/Kosrae

• Pacific/Kwajalein

• Pacific/Majuro

• Pacific/Marquesas

• Pacific/Midway

• Pacific/Nauru

• Pacific/Niue

• Pacific/Norfolk

• Pacific/Noumea

• Pacific/Pago_Pago

• Pacific/Palau

• Pacific/Pitcairn

• Pacific/Pohnpei

• Pacific/Port_Moresby

• Pacific/Rarotonga

• Pacific/Saipan

• Pacific/Tahiti

• Pacific/Tarawa

• Pacific/Tongatapu

• Pacific/Wake

• Pacific/Wallis

• US/Alaska

• US/Arizona

• US/Central

• US/Eastern

• US/Hawaii

• US/Mountain

• US/Pacific