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


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

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


VoxService v1.1 (2006-06-08):
=============================

Improvments:
-------------

[ADDED] new operation: cancelDID( AuthenticationToken, DIDFormatted )
[ADDED] new operation: getAccountBalance( AuthenticationToken )
[ADDED] new operation: getDIDsInfo( AuthenticationToken, Filter )
[ADDED] now the DID container have a "currentMapping" field

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

* getAreaForCountries : get a list of area code for a specified country
* buyDIDs: The medod is currently maintained for backward compatibility but will be removed in the future.
* mapDID : map a DID to a specified URI.
* buydDIDsByProductID : buying a DID from voxbone using your prepaid account.
* isPurchaseInfoValid : allow user to validate purchaseInfo before buying process.
* getCitiesInfo : retrieve a list of valid cities and their associated zip code in order to build a valid purchase info parameter.
* cancelDID : cancel a DID, you will no more billed for the canceled DID.
* getAccountBalance : retrieve you prepaid account balance + information about the balance checker
* getDIDsInfo : retrieve information about selected DIDs

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.

4) For more information about the API implementation you can check the code sample at: http://www.voxbone.com/WSCodeSample.jsf
   or send an email to support-dev@voxbone.com