Skip to main content
Avalara Help Center

Get Started with Geo for Communications SaaS Pro Soap

This article applies to:

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.

  1. Create a new POST request and set the endpoint URL based on the best binding for your organization.
  2. Set up your XML Soap header:
    1. Content-Type: text/xml
    2. SOAPAction: http://tempuri.org/ILocatorService/GetServerTime

         The SOAPAction value is updated based on the method you are using.

      AFC Geo SaaS Pro Soap Header
  3. 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

  1. Access the AFC Geo Production environment.
  2. 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.
  3. 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

Address geocoding

Latitude/longitude coordinate pair geocoding

Special tax jurisdictions

Scoring

AFC Geo Product User Manual

AFC Geo Getting Started Manual

  • Was this article helpful?