Assign GeoTAX InfoPlus identifies the tax districts that apply to a given address. Specifically, Assign GeoTAX InfoPlus returns the following information about an address:
- Latitude/longitude coordinates
- FIPS state codes and county codes
- County names
- MCD/CCD codes and names
- CBSA/CSA codes and names
- Place FIPS and GNIS codes and names
- Incorporated or unincorporated status codes
- Cross-reference tax keys
- Result indicators
- Optionally, the relationship of an address to user-defined polygons
Assign GeoTAX InfoPlus optionally includes enhanced tax jurisdiction information for an address, including:
- Insurance premium districts—Areas designated for the collection of taxes imposed on insurance policy premiums based on the policy holder's address. Insurance premium districts are created by state governments.
- Payroll tax districts—Areas designated for the collection of taxes imposed on employers to support state or local government facilities and services based on the employee's and/or employer's address. Examples include taxes collected for districts to pay for schools, police, or other services. Payroll tax districts are created by state or local governments.
- Payroll system tax codes—Codes that represent specific jurisdictions
that collect payroll tax. Using payroll system tax codes has advantages over using
the payroll tax district information returned by Assign GeoTAX Info:
- Assign GeoTAX InfoPlus uses an additional database to determine payroll tax codes, resulting in more accurate payroll tax determination.
- Many payroll systems use specific codes to determine withholding amounts. Since you can customize the payroll tax codes returned by Assign GeoTAX InfoPlus, you can set up a process where Assign GeoTAX InfoPlus returns the exact payroll tax codes required by your payroll system instead of returning jurisdictional IDs that must then be translated into the codes used by your system.
- Special purpose tax districts—Areas designated for the collection of taxes imposed on residents to support specialized services for residents of the district based on the resident's address. Examples include services such as sewer service, transit service, or water resources. Special purpose tax districts are created by legislative action, court action, or public referendums. This optional information requires the use of boundary files which require an additional license. Contact your Precisely sales representative for more information.
- Sales and Use Tax Rates—Using the optional Precisely Sales and Use Tax Rate file, Assign GeoTAX InfoPlus can return sales and use tax rates for each of the assigned tax jurisdictions as well as the total tax rate for the assigned locations.
Assign GeoTAX Info is part of Spectrum Enterprise Tax.
Resource URL
JSON endpoint:
http://server:port/rest/AssignGeoTaxInfo/results.json
XML endpoint:
http://server:port/rest/AssignGeoTaxInfo/results.xml
http://server:port/soap/AssignGeoTaxInfo
Example with JSON Response
The following example requests a JSON response:
http://myserver:8080/rest/AssignGeoTAXInfo/results.json?Data.AddressLine1=1+Global+View&Data.City=Troy&Data.StateProvince=NY&Data.PostalCode=12180
The JSON returned by this request would be:
{"output_port": [{
"Confidence": "100.0",
"ProcessedBy": "GTX",
"Census.MatchCode": "S",
"Census.MatchLevel": "Street",
"County.Code": "083",
"County.Name": "Rensselaer",
"StateCode": "36",
"LatLong": "42.683028-073.702968",
"LatLong.MatchCode": "R",
"LatLong.MatchLevel": "Rooftop",
"Latitude": "42.683028",
"Longitude": "-073.702969",
"State.Abbreviation": "NY",
"Place.Code": "00000",
"Place.IncorporatedFlag": "Uninc",
"AddressLine1": "1 GLOBAL VW",
"City": "TROY",
"StateProvince": "NY",
"PostalCode": "121808371",
"AddressMatch.MatchCode": "S80",
"AddressMatch.LocationCode": "AS0",
"AddressMatch.LastLine": "TROY,NY 12180-8371"
"AddressMatch.Zip": "12180",
"AddressMatch.Zip4": "8371",
"AddressMatch.GenRC": "S"
"AddressMatch.DataTypeName": "TOMTOM",
"MCD.DistanceToBorder": "000002938",
"Place.DistanceToBorder": "00000000",
"GNISCode": "000000000",
}]}
Example with XML Response
The following example requests an XML response:
http://myserver:8080/rest/AssignGeoTAXInfo/results.xml?Data.AddressLine1=1+Global+View&Data.City=Troy&Data.StateProvince=NY&Data.PostalCode=12180
The XML returned by this request would be:
<ns2:xml.AssignGeoTAXInfoResponse
xmlns:ns2="http://www.precisely.com/spectrum/services/AssignGeoTAXInfo">
<ns2:output_port>
<ns2:Address>
<ns2:Confidence>100.0</ns2:Confidence>
<ns2:ProcessedBy>GTX</ns2:ProcessedBy>
<ns2:Census.MatchCode>S</ns2:Census.MatchCode>
<ns2:Census.MatchLevel>Street</ns2:Census.MatchLevel>
<ns2:County.Code>083</ns2:County.Code>
<ns2:County.Name>Rensselaer</ns2:County.Name>
<ns2:StateCode>36</ns2:StateCode>
<ns2:LatLong>42.683028-073.702968</ns2:LatLong>
<ns2:LatLong.MatchCode>R</ns2:LatLong.MatchCode>
<ns2:LatLong.MatchLevel>Rooftop</ns2:LatLong.MatchLevel>
<ns2:Latitude>42.683028</ns2:Latitude>
<ns2:Longitude>-073.702969</ns2:Longitude>
<ns2:State.Abbreviation>NY</ns2:State.Abbreviation>
<ns2:Place.Code>00000</ns2:Place.Code>
<ns2:Place.IncorporatedFlag>Uninc</ns2:Place.IncorporatedFlag>
<ns2:AddressLine1>1 GLOBAL VW</ns2:AddressLine1>
<ns2:City>TROY</ns2:City>
<ns2:StateProvince>NY</ns2:StateProvince>
<ns2:PostalCode>121808371</ns2:PostalCode>
<ns2:AddressMatch.MatchCode>S80</ns2:AddressMatch.MatchCode>
<ns2:AddressMatch.LocationCode>AS0</ns2:AddressMatch.LocationCode>
<ns2:AddressMatch.LastLine>TROY, NY 12180-8371</ns2:AddressMatch.LastLine>
<ns2:AddressMatch.Zip>12180</ns2:AddressMatch.Zip>
<ns2:AddressMatch.Zip4>8371</ns2:AddressMatch.Zip4>
<ns2:AddressMatch.GenRC>S</ns2:AddressMatch.GenRC>
<ns2:AddressMatch.DataTypeName>TOMTOM</ns2:AddressMatch.DataTypeName>
<ns2:MCD.DistanceToBorder>000002938</ns2:MCD.DistanceToBorder>
<ns2:Place.DistanceToBorder>00000000</ns2:Place.DistanceToBorder>
<ns2:GNISCode>000000000</ns2:GNISCode>
<ns2:LatLong.StreetMatchCode/>
<ns2:LatLong.StreetMatchLevel/>
</ns2:Address>
</ns2:output_port>
</ns2:xml.AssignGeoTAXInfoResponse>
Example
The following shows a SOAP request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ass="http://www.precisely.com/spectrum/services/AssignGeoTAXInfo"
xmlns:spec="http://spectrum.precisely.com/">
<soapenv:Header/>
<soapenv:Body>
<ass:AssignGeoTAXInfoRequest>
<ass:input_port>
<ass:Address>
<ass:AddressLine1>1 Global View</ass:AddressLine1>
<ass:City>Troy</ass:City>
<ass:StateProvince>NY</ass:StateProvince>
<ass:PostalCode>12180</ass:PostalCode>
</ass:Address>
</ass:input_port>
</ass:AssignGeoTAXInfoRequest>
</soapenv:Body>
</soapenv:Envelope>
This would be the response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:AssignGeoTAXInfoResponse xmlns:ns2="http://spectrum.precisely.com/"
xmlns:ns3="http://www.precisely.com/spectrum/services/AssignGeoTAXInfo">
<ns3:output_port>
<ns3:Address>
<ns3:Confidence>100.0</ns3:Confidence>
<ns3:ProcessedBy>GTX</ns3:ProcessedBy>
<ns3:Census.MatchCode>S</ns3:Census.MatchCode>
<ns3:Census.MatchLevel>Street</ns3:Census.MatchLevel>
<ns3:County.Code>083</ns3:County.Code>
<ns3:County.Name>Rensselaer</ns3:County.Name>
<ns3:StateCode>36</ns3:StateCode>
<ns3:LatLong>42.683028-073.702968</ns3:LatLong>
<ns3:LatLong.MatchCode>R</ns3:LatLong.MatchCode>
<ns3:LatLong.MatchLevel>Rooftop</ns3:LatLong.MatchLevel>
<ns3:Latitude>42.683028</ns3:Latitude>
<ns3:Longitude>-073.702969</ns3:Longitude>
<ns3:State.Abbreviation>NY</ns3:State.Abbreviation>
<ns3:Place.Code>00000</ns3:Place.Code>
<ns3:Place.IncorporatedFlag>Uninc</ns3:Place.IncorporatedFlag>
<ns3:AddressLine1>1 GLOBAL VW</ns3:AddressLine1>
<ns3:City>TROY</ns3:City>
<ns3:StateProvince>NY</ns3:StateProvince>
<ns3:PostalCode>121808371</ns3:PostalCode>
<ns3:AddressMatch.MatchCode>S80</ns3:AddressMatch.MatchCode>
<ns3:AddressMatch.LocationCode>AS0</ns3:AddressMatch.LocationCode>
<ns3:AddressMatch.LastLine>TROY, NY 12180-8371</ns3:AddressMatch.LastLine>
<ns3:AddressMatch.Zip>12180</ns3:AddressMatch.Zip>
<ns3:AddressMatch.Zip4>8371</ns3:AddressMatch.Zip4>
<ns3:AddressMatch.GenRC>S</ns3:AddressMatch.GenRC>
<ns3:AddressMatch.DataTypeName>TOMTOM</ns3:AddressMatch.DataTypeName>
<ns3:MCD.DistanceToBorder>000002938</ns3:MCD.DistanceToBorder>
<ns3:Place.DistanceToBorder>00000000</ns3:Place.DistanceToBorder>
<ns3:GNISCode>000000000</ns3:GNISCode>
</ns3:Address>
</ns3:output_port>
</ns3:AssignGeoTAXInfoResponse>
</soap:Body>
</soap:Envelope>