Reverse GeoTAX Info Lookup - Spectrum_OnDemand - enterprise_tax - web_services - 23.1

Guía de servicios web de Spectrum

Product type
Portfolio
Integrate
Product family
Product
Spectrum > Web Services
Version
23.1
Language
Español (México)
Product name
Spectrum Technology Platform
Title
Guía de servicios web de Spectrum
First publish date
2007
ft:lastEdition
2024-02-07
ft:lastPublication
2024-02-07T18:09:34.894393

Reverse GeoTAX Info Lookup permite que las coordenadas de latitud/longitud se proporcionen como entrada e identifica los distritos fiscales que corresponden a la coordinada dada. Específicamente, Reverse GeoTAX Info Lookup puede devolver la siguiente información acerca de una ubicación:

  • Códigos de condado y estado FIPS
  • Nombres de estado y condado
  • Códigos y nombres MCD
  • Códigos y nombres de lugar
  • Distritos de archivos de límite
  • Claves fiscales de referencia cruzada
  • La relación entre las coordenadas de entrada y los polígonos definidos por el usuario
  • Tasas tributarias sobre las ventas y uso, si se obtuvo la licencia para el PreciselyArchivo de tasas tributarias sobre las ventas y uso

Reverse GeoTAX Info Lookup incluye de forma opcional información mejorada sobre las jurisdicciones fiscales para un dirección, lo que incluye:

  • Distritos de primas de seguros: áreas designadas para la recaudación de impuestos que recaen sobre las primas de las pólizas de seguros según la dirección del titular de la póliza. Los distritos de primas de seguros son creados por el gobierno del estado.
  • Distritos fiscales de cargas sociales: áreas designadas para la recaudación de impuestos que recaen sobre los empleadores para contribuir con los servicios e instalaciones del gobierno local o del estado, según la dirección del empleador o el empleado. Por ejemplo, los impuestos que se recaudan para que los distritos destinen a las escuelas, la policía y otros servicios. Los distritos fiscales de cargas sociales son creados por el gobierno local o del estado.
  • Códigos impositivos del sistema de cargas sociales: códigos que representan jurisdicciones específicas que recaudan cargas sociales. La utilización de códigos impositivos del sistema de cargas sociales ofrece ventajas con respecto a la utilización de la información de distritos fiscales de cargas sociales que arroja Reverse GeoTAX Info Lookup:
    • Reverse GeoTAX Info Lookup utiliza una base de datos adicional para determinar los códigos de cargas sociales, lo que deriva en la determinación más exacta de las cargas sociales.
    • Muchos sistemas de cargas sociales usan códigos específicos para determinar las sumas de las retenciones. Puesto que es posible personalizar los códigos de cargas sociales que arroja Reverse GeoTAX Info Lookup, puede configurar un proceso en el que Reverse GeoTAX Info Lookup arroje los códigos exactos de cargas sociales que su sistema requiere, en lugar de arrojar ID jurisdiccionales que, luego, deben ser convertidas en los códigos que utiliza su sistema.
  • Distritos fiscales con finalidades específicas: áreas designadas para la recaudación de impuestos que recaen sobre los residentes para contribuir con servicios especiales para el distrito según la dirección del residente. Algunos ejemplos son los servicios cloacales, los de tránsito y los relacionados con los recursos hídricos. Los distritos fiscales con finalidades específicas son creados mediante acciones legislativas, acciones legales o referendos públicos. Esta información opcional requiere el uso de archivos de límites, para los cuales es necesario obtener una licencia adicional. Comuníquese con su representante de ventas de Precisely para obtener más información.

Utilizando el archivo opcional de tasa tributaria sobre las ventas y uso Precisely, Reverse GeoTAX Info Lookup incluye datos de tasa tributaria para una ubicación, lo que incluye:

Tipo de tasa tributaria:

  • General
  • Automotriz
  • Médico
  • Construcción

Tasas tributarias sobre las ventas o uso para:

  • Estado
  • Condado
  • Municipalidad
  • Hasta 10 SPD
  • Tasa total: la suma de las tasas individuales de estado, condado, municipalidad y SPD.

Formato de entrada requerido

El formato requerido para las coordenadas de entrada es el siguiente:

Nombre de columna Nombre de campo Elemento de respuesta Formato

InputLatitude

Data.InputLatitude

00,000000 o sin el punto decimal 00000000

InputLongitude

Data.InputLongitude

000,000000 o sin el punto decimal 000000000, o

00,000000 o sin el punto decimal 00000000

Reverse GeoTAX Info Lookup es parte de Spectrum Enterprise Tax.

URL del recurso

Extremo del elemento JSON:

http://server:port/rest/ReverseGeoTAXInfoLookup/results.json
https://OnDemandServer/rest/ReverseGeoTAXInfoLookup/results.json

Extremo del XML:

http://server:port/rest/ReverseGeoTAXInfoLookup/results.xml
https://OnDemandServer/rest/ReverseGeoTAXInfoLookup/results.xml
http://server:port/soap/ReverseGeoTAXInfoLookup
https://OnDemandServer/soap/ReverseGeoTAXInfoLookup

Para acceder a una lista de los servidores Spectrum Technology Platform, consulte Conexión a servidores.

Ejemplo con respuesta JSON

El siguiente ejemplo solicita una respuesta JSON:

http://myserver:8080/rest/ReverseGeoTAXInfoLookup/results.json​?Data.InputLatitude=40.018998&Data.InputLongitude=-105.239580
https://spectrum.precisely.com/rest/ReverseGeoTAXInfoLookup/results.json​?Data.InputLatitude=40.018998&Data.InputLongitude=-105.239580

El elemento JSON devuelto por esta solicitud sería:

{"output_port": [{    "Confidence": "100.0",    "ProcessedBy": "GTX",    "County.Code": "013",    "County.Name": "Boulder",    "StateCode": "08",    "InputLatitude": "40.018998",    "InputLongitude": "-105.239580",    "State.Abbreviation": "CO",    "Place.ClassCode": "C1",    "Place.Code": "07850",    "Place.IncorporatedFlag": "Inc",    "Place.Name": "Boulder",    "Place.LastAnnexedDate": "10/2011",    "Place.LastUpdatedDate": "04/2013",    "Place.LastVerifiedDate": "01/2013",    "Place.DistanceToBorder": "000000387",    "Place.PointStatus": "P",    "GNISCode": "002409883",    "GTX.ErrorCode": "",    "GTX.ErrorDescription": "",    "GTX.WarnCode": "",    "GTX.WarnDescription": "" }]}

Ejemplo con respuesta XML

El siguiente ejemplo solicita una respuesta XML:

http://myserver:8080/rest/ReverseGeoTAXInfoLookup/results.xml​?Data.InputLatitude=40.018998&Data.InputLongitude=-105.239580
https://spectrum.precisely.com/rest/ReverseGeoTAXInfoLookup/results.xml​?Data.InputLatitude=40.018998&Data.InputLongitude=-105.239580

El elemento XML devuelto por esta solicitud sería:

ns2:xml.ReverseGeoTAXInfoLookup xmlns:ns2="http://www.pb.com/spectrum/services/ReverseGeoTAXInfoLookup">    <ns2:output_port>       <ns2:Address>          <ns2:Confidence>100.0</ns2:Confidence>          <ns2:ProcessedBy>GTX</ns2:ProcessedBy>          <ns2:County.Code>013</ns2:County.Code>          <ns2:County.Name>Boulder</ns2:County.Name>          <ns2:StateCode>08</ns2:StateCode>          <ns2:InputLatitude>40.018998</ns2:InputLatitude>          <ns2:InputLongitude>-105.239580</ns2:InputLongitude>          <ns2:State.Abbreviation>CO</ns2:State.Abbreviation>          <ns2:Place.ClassCode>C1</ns2:Place.ClassCode>          <ns2:Place.Code>07850</ns2:Place.Code>          <ns2:Place.IncorporatedFlag>Inc</ns2:Place.IncorporatedFlag>          <ns2:Place.Name>Boulder</ns2:Place.Name>          <ns2:Place.LastAnnexedDate>10/2011</ns2:Place.LastAnnexedDate>          <ns2:Place.LastUpdatedDate>04/2013</ns2:Place.LastUpdatedDate>          <ns2:Place.LastVerifiedDate>01/2013</ns2:Place.LastVerifiedDate>          <ns2:Place.DistanceToBorder>000000387</ns2:Place.DistanceToBorder>          <ns2:Place.PointStatus>P</ns2:Place.PointStatus>          <ns2:GNISCode>002409883</ns2:GNISCode>          <ns2:GTX.ErrorCode>""</ns2:GTX.ErrorCode>          <ns2:GTX.ErrorDescription>""</ns2:GTX.ErrorDescription>          <ns2:GTX.WarnCode>""</ns2:GTX.WarnCode>          <ns2:GTX.WarnDescription>""</ns2:GTX.WarnDescription>       </ns2:Address>    </ns2:output_port> </ns2:xml.ReverseGeoTAXInfoLookup>

Ejemplo

A continuación se muestra una solicitud SOAP:

<soapenv:Envelope 	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 	xmlns:rev="http://www.pb.com/spectrum/services/ReverseGeoTAXInfoLookup"> 	<soapenv:Header/> 	<soapenv:Body> 		<rev:ReverseGeoTAXInfoLookupRequest> 			<rev:input_port> 				<rev:Address> 					<!--Optional:--> 					<rev:InputLatitude>40.018998</rev:InputLatitude> 					<!--Optional:--> 					<rev:InputLongitude>-105.239580</rev:InputLongitude> 					<!--Optional:--> 					<rev:BufferWidth></rev:BufferWidth> 					<!--Optional:--> 					<rev:UserBufferWidth></rev:UserBufferWidth> 					<!--Optional:--> 					<rev:user_fields> 						<rev:user_field> 							<rev:name>?</rev:name> 							<rev:value>?</rev:value> 						</rev:user_field> 					</rev:user_fields> 				</rev:Address> 			</rev:input_port> 		</rev:ReverseGeoTAXInfoLookupRequest> 	</soapenv:Body> </soapenv:Envelope> 

Esta sería la respuesta:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">    <soap:Body>       <ns3:ReverseGeoTAXInfoLookupResponse xmlns:ns3="http://spectrum.pb.com/"       xmlns:ns3="http://www.pb.com/spectrum/services/ReverseGeoTAXInfoLookup">          <ns3:output_port>             <ns3:Address>                               <ns3:Confidence>100.0</ns3:Confidence>                <ns3:ProcessedBy>GTX</ns3:ProcessedBy>                <ns3:County.Code>013</ns3:County.Code>                <ns3:County.Name>Boulder</ns3:County.Name>                <ns3:StateCode>08</ns3:StateCode>                <ns3:State.Abbreviation>CO</ns3:State.Abbreviation>                              <ns3:InputLatitude>40.018998</ns3:InputLatitude>                <ns3:InputLongitude>-105.239580</ns3:InputLongitude>                <ns3:GeoTAXKey.MatchCode></ns3:GeoTAXKey.MatchCode>                <ns3:GeoTAXKey.MatchLevel>NoMatch</ns3:GeoTAXKey.MatchLevel><ns3:GeoTAXKey/>                <ns3:Place.ClassCode>C1</ns3:Place.ClassCode>                <ns3:Place.Code>07850</ns3:Place.Code>                <ns3:Place.IncorporatedFlag>Inc</ns3:Place.IncorporatedFlag>                <ns3:Place.Name>Boulder</ns3:Place.Name>                <ns3:Place.LastAnnexedDate>10/2011</ns3:Place.LastAnnexedDate>                <ns3:Place.LastUpdatedDate>04/2013</ns3:Place.LastUpdatedDate>                <ns3:Place.LastVerifiedDate>01/2013</ns3:Place.LastVerifiedDate>                <ns3:Place.PointStatus>P</ns3:Place.PointStatus>                <ns3:Place.DistanceToBorder>000000387</ns3:Place.DistanceToBorder>                <ns3:GNISCode>002409883</ns3:GNISCode>                <ns3:GTX.ErrorCode/>                <ns3:GTX.ErrorDescription/>                <ns3:GTX.WarnCode/>                <ns3:GTX.WarnDescription/>                <ns3:user_fields/>             </ns3:Address>          </ns3:output_port>       </ns3:ReverseGeoTAXInfoLookupResponse>    </soap:Body> </soap:Envelope>