/////////////////////////////////////////
                                    //  Voxbone Web Services Release Note  //
                                    /////////////////////////////////////////


Release Info:
=============

release: v0.1 RC1
Developer: Morsiani Vincent
Company: Voxbone S.A.
support: support-dev@voxbone.com


VoxService v1.0 (2006-03-13):
=============================

Note:
The Voxbone Web Service has now reached maturity and changed its status to 1.0.
We will still monitor closely its behaviour and get feedback from customers.

Web Services Operations:
-------------------------

* getAreaForCountries
    [added] return boolean "needPurchaseInfo" to determine if a specific product need the purchase info to be specified.
    [update] the identifier value have changed, it now represent the product identifier instead of an area identifier.
* buyDIDs
    [fixed] the didFormatted now contain the I.164 formatted phone number.
    [note]  this method is deprecated due to the new API purchasing process. please switch to buyDIDsByProductID if possible.
            The medod is currently maintained for backward compatibility but will be removed in the future.
* mapDID : no change to this method.
* [new] buydDIDsByProductID : added to match better the new buying process.
* [new] isPurchaseInfoValid : allow user to validate purchaseInfo before buying process.
* [new] getCitiesInfo : retrieve a list of valid cities and their associated zip code in order to build a valid purchase info parameter.

Operations Specific Description:
--------------------------------

* getCountriesList
    The method now return countries containing products that required purchase info (like all the german DID for exemple)
* buyDIDs & buyDIDsByProductID
    When purchase info is required to buy a specific product, an exception will be thrown and the buying process stopped
    If the provided purchase info are invalid.

* isPurchaseInfoValid
    if the salutation isn't in the following range, an exception will be thrown ( MR, MS, COMPANY )

Voxbone SDK (Java):
===================

Requirements:
-------------

- Sun Java SDK installed
- The following jar file in your classpath:
    * activation.jar
    * FastInfoset.jar
    * jaxrpc-api.jar
    * jaxrpc-impl.jar
    * jaxrpc-spi.jar
    * jsr173_api.jar
    * mail.jar
    * saaj-api.jar
    * saaj-impl.jar


Special Notes:
==============

1)  In order to use the web service, you have to send an email at support-dev@voxbone.com
	and ask us to authorize your account to use the web service.
	please send us your motivation and why you want to use the service.

2)  A sandbox server is now available at the following url : http://sandbox.voxbone.com
    The sandbox wsdl is available at http://sandbox.voxbone.com/ws/services/VoxService?wsdl
    Feel free to create an account on the sandbox to test your implementation before switching to production

3)  You can be warned when your cash is getting low on you account with a tools called "Balance Checker"
    You can active/deactivate this service from our web site.
    Note that the balance checker won't warn you if you go below the thresold by manually buy DID from the website.