SOAP

things every developer should know

What is SOAP protocol?

SOAP (originally Simple Object Access Protocol) is a messaging protocol specification for exchanging structured information in the implementation of web services in computer networks. Its purpose is to induce extensibility, neutrality and independence. It uses XML Information Set for its message format, and relies on application layer protocols, most often Hypertext Transfer Protocol (HTTP) or Simple Mail Transfer Protocol (SMTP), for message negotiation and transmission. See more.

Using GZip compression

All the methods within Cangooroo API work with GZip Compression. It's important to use compression because it reduces the network traffic and the download time between our servers and your application.

Error structure

Our error structure follows the W3C specifications (view reference)

When occurs an error, Cangooroo WebService returns a HTTP status code 500.

Example of an error response:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:tem="http://tempuri.org/"><soap:Body> <soap:Fault> <faultcode>soap:Client</faultcode> <faultstring>Err: Login_Fail - Invalid user or password.</faultstring> <faultactor>http://pp.cangooroo.net/CangoorooWeb/ws/2013/hotel_l.asmx</faultactor> <detail> <errorCode>1001</errorCode> <supportInfo>If necessary, please refer error token #213e1d48-d0b2-482e-b906-a36ddc0f8381</supportInfo> <errorAuxInfo>UserName: teste Password:WRONGPASS</errorAuxInfo> <faultDate>2013-07-21 10:30:17</faultDate> </detail> </soap:Fault></soap:Body></soap:Envelope>

In case you encounter an error, remember to follow our Support's best practices to ensure we will be able to help you.

Tools

Below are some of the tools we recommend you use when it comes for Webservice integration, testing and providing us with all the information we might need to try and help you.

Please remember that we do not give any support to the tools below.

    1. Soap-UI - used to test Webservices (we use it to test Soap Webservices).

    2. Fiddler - used to capture http requests / responses.

    3. Postman - used to test Webservices (we use it to test Rest Webservices).

Insurance