Get Started with Geo for Communications SaaS Pro Soap
Follow the steps below to get started with Avalara Geo for Communications SaaS Pro Soap.
Find your Geo for Communications account
Check your inbox for an email from your customer account manager (CAM) that includes your username and password. If you can't find the email, check your spam folder or contact your CAM.
Run a sample request
You now have the necessary items to run a test request:
- AFC Geo username
- AFC Geo password
Let's get the server time from the GetServerTime method using Postman.
- Create a new POST request and set the endpoint URL based on the best binding for your organization.
- Configure TLS 1.2:
Navigate to the Settings tab to disable "TLS 1" and "TLS 1.1" to ensure that TLS 1.2 is used.
- Set up your XML Soap header:
Content-Type
: text/xmlSOAPAction
: http://tempuri.org/ILocatorService/GetServerTimeThe SOAPAction value is updated based on the method you are using.
- Create the body of GetServerTime and submit the request.
Sample Basic HTTP Binding input
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:s="s"> <soapenv:Header> <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <o:UsernameToken> <o:Username>USERNAME</o:Username> <o:Password>PASSWORD</o:Password> </o:UsernameToken> </o:Security> </soapenv:Header> <soapenv:Body> <tem:GetServerTime/> </soapenv:Body> </soapenv:Envelope>
Sample Basic HTTP Binding response
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <s:Header> <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <u:Timestamp u:Id="_0"> <u:Created>2019-01-29T19:54:40.527Z</u:Created> <u:Expires>2019-01-29T19:59:40.527Z</u:Expires> </u:Timestamp> </o:Security> </s:Header> <s:Body> <GetServerTimeResponse xmlns="http://tempuri.org/"> <GetServerTimeResult>Jan 29, 2019 7:54:40 PM</GetServerTimeResult> </GetServerTimeResponse> </s:Body> </s:Envelope>
Sample Custom Binding input
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/" xmlns:s="s"> <soap:Header> <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <o:UsernameToken> <o:Username>USERNAME</o:Username> <o:Password>PASSWORD</o:Password> </o:UsernameToken> </o:Security> </soap:Header> <soap:Body> <tem:GetServerTime/> </soap:Body> </soap:Envelope>
Sample Custom Binding response
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:Body> <GetServerTimeResponse xmlns="http://tempuri.org/"> <GetServerTimeResult>Jan 29, 2019 7:54:40 PM</GetServerTimeResult> </GetServerTimeResponse> </s:Body> </s:Envelope>
Review XML sample code
For XML examples, see the Customizing Geocoding Requests chapter in the Avalara for Communications Geo SaaS Pro Soap Developer Guide.
Other Languages
For C#, Java, and PHP examples, download sample code from the Avalara/Communications-Developer-Content repo on GitHub.
Prepare to integrate with Geo for Communications
- Access the AFC Geo Production environment.
- View the Communications Geo SaaS Pro Soap Developer Guide for sample code, XML property information, endpoints, methods, and other useful information. Download sample code for other languages from the Avalara/Communications-Developer-Content repo on GitHub.
- See Best Practices for other integration recommendations.
I'm in - now what?
You've made it through establishing you AFC Geo SaaS Pro Soap account, running test transactions, and integrating AFC Geo with your systems. Let's dive more into the details:
Customize your geocoding requests