Pitney Bowes Tax Calculator (Preview)

Pitney Bowes Tax Calculator (Preview)

Pitney Bowes Tax Calculator allows anyone to determine local tax jurisdictions & tax rates in the United States based on address inputs or location coordinates

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Flow Premium All Flow regions except the following:
     -   US Government (GCC)
PowerApps Premium All PowerApps regions except the following:
     -   US Government (GCC)

It is critical for any billing, commerce, payment, or payroll application or service. To learn more, visit the documentation page: http://locate.pitneybowes.com/geotax

To use this integration, you need to have an account on the Pitney Bowes Developer Hub. Follow steps below to get your API Key and Secret.

If you see an error while using the connector you may look up the error code for more information.

Get the API Key and Secret

  • Register for a Pitney Bowes Developer Account.
  • Sign In with your Developer Account and select API Keys in the Locate menu.

You will see your API key and Secret listed on API Key page.

You're now ready to start using this integration.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Creating a connection

To connect your account, you will need the following information:

API Key
securestring
The API Key for this api
Secret
securestring
Your client secret for Pitney Bowes

Actions

Get IPD Tax by Address

This will accept 'address' as a parameter and will return one or many IPDs details for that region in which address will fall.

Required Parameters

Address
string
The address to be searched.

Optional Parameters

Return Lat/Lon
string
This preference Option sets flag for returning geometry coordinates(Y/N)
Lat/Lon Format
string
(default is Decimal) - Returns Desired Latitude Longitude Format

Returns

Get IPD Tax for batch requests

Get IPD Tax for batch requests

Optional Parameters

Unique ID
string
Main Address Line
string
Address Last Line
string
Place Name
string
State or Province
string
Area Name 2
string
City or Town
string
Area Name 4
string
Postal Code
string
Postal Code Ext
string
Three-digit ISO country code
string
Address Number
string
Street Name
string
Unit Type
string
Unit Value
string
Fall Back to Geographic
string
Match mode
string
Distance Unit
string
FIND_ADDR_POINT_INTERP
string
FIND_SEARCH_AREA
string
FIND_ADDRESS_RANGE
string
FIND_EXPANDED_SEARCH_RADIUS
string
FIND_ALTERNATE_LOOKUP
string
FIND_STREET_CENTROID
string
FIND_FIRST_LETTER_EXPANDED
string
Output Casting
string
Lat/Lon offset
string
Squeeze Street End Points
string
Return Geometry coordinates(Y/N)
string
Return Census Fields(Y/N)
string
Use GeoTAX Auxiliary File(Y/N)
string
Lat/Lon Return Format
string
Width ofPolygon Buffers
string

Returns

Get Tax By Address

This service calculates and returns taxes applicable at a specific address. Address, purchase amount and supported tax rate type are inputs to the service.

Required Parameters

Tax Type
string
The tax rate id.
Address
string
The address to be searched.
Purchase Amount
string
The amount on which tax to be calculated.

Returns

Get Tax By Location

This service calculates and returns tax applicable at a specific location. Longitude, latitude, purchase amount and supported tax rate type are inputs to the service.

Required Parameters

Tax Type
string
The tax rate id.
Latitude
string
Latitude of the location.
Longitude
string
Longitude of the location.
Purchase Amount
string
The amount on which tax to be calculated.

Returns

Get Taxrate By Address

Retrieves tax rates applicable to a specific address. This service accepts address and supported tax rate type as inputs to retrieve applicable tax rates.

Required Parameters

Tax Type
string
The tax rate id.
Address
string
The address to be searched.

Returns

Get Taxrate By Location

Retrieves tax rates applicable to a specific location. This service accepts longitude, latitude and supported tax rate type as inputs to retrieve applicable tax rates.

Required Parameters

Tax Type
string
The tax rate id.
Latitude
string
Latitude of the location.
Longitude
string
Longitude of the location.

Returns

Post Tax By Address

This is a Batch offering for 'Tax By Address' service. It accepts a single address, purchase amount or a list of addresses, purchase amounts and retrieve applicable taxes.

Required Parameters

Tax Type
string
The tax rate id.

Optional Parameters

Purchase Amount
string
Unique ID
string
Main Address
string
Address Last Line
string
Place Name
string
State or Province
string
Area Name 2
string
City or Town
string
Area Name 4
string
Postal Code
string
Postal Code Ext
string
Three-digit ISO country code
string
Address Number
string
Street Name
string
Unit Type
string
Unit Value
string
Distance Unit
string
Buffer Width
string
User Buffer Width
string
Fall Back to Geographic
string
Match mode
string
Distance Unit
string
FIND_ADDR_POINT_INTERP
string
FIND_SEARCH_AREA
string
FIND_ADDRESS_RANGE
string
FIND_EXPANDED_SEARCH_RADIUS
string
FIND_ALTERNATE_LOOKUP
string
FIND_STREET_CENTROID
string
FIND_FIRST_LETTER_EXPANDED
string
Output Casting
string
Lat/Lon offset
string
Squeeze Street End Points
string
Return Geometry coordinates(Y/N)
string
Return Census Fields(Y/N)
string
Use GeoTAX Auxiliary File(Y/N)
string
Lat/Lon Return Format
string
Width ofPolygon Buffers
string

Returns

Post Tax By Location

This is a Batch offering for 'Tax By Location' service. It accepts a single location coordinate, purchase amount or a list of location coordinates, purchase amounts and retrieve applicable tax.

Required Parameters

Tax Type
string
The tax rate id.

Optional Parameters

Purchase Amount
string
Unique ID
string
Geometry Type
string
Coordinates(lat, lon)
double
Fall Back to Geographic
string
Match mode
string
Distance Unit
string
FIND_ADDR_POINT_INTERP
string
FIND_SEARCH_AREA
string
FIND_ADDRESS_RANGE
string
FIND_EXPANDED_SEARCH_RADIUS
string
FIND_ALTERNATE_LOOKUP
string
FIND_STREET_CENTROID
string
FIND_FIRST_LETTER_EXPANDED
string
Output Casting
string
Lat/Lon offset
string
Squeeze Street End Points
string
Return Geometry coordinates(Y/N)
string
Return Census Fields(Y/N)
string
Use GeoTAX Auxiliary File(Y/N)
string
Lat/Lon Return Format
string
Width ofPolygon Buffers
string

Returns

Post Taxrate By Address

This is a Batch offering for 'Taxrate By Address' service. It accepts a single address or a list of addresses and retrieve applicable tax rates.

Required Parameters

Tax Type
string
The tax rate id.

Optional Parameters

Unique ID
string
Main Address Line
string
Address Last Line
string
Place Name
string
State or Province
string
Area Name 2
string
City or Town
string
Area Name 4
string
Postal Code
string
Postal Code Ext
string
Three-digit ISO country code
string
Address Number
string
Street Name
string
Unit Type
string
Unit Value
string
Distance Unit
string
Buffer Width
string
User Buffer Width
string
Fall Back to Geographic
string
Match mode
string
Distance Unit
string
FIND_ADDR_POINT_INTERP
string
FIND_SEARCH_AREA
string
FIND_ADDRESS_RANGE
string
FIND_EXPANDED_SEARCH_RADIUS
string
FIND_ALTERNATE_LOOKUP
string
FIND_STREET_CENTROID
string
FIND_FIRST_LETTER_EXPANDED
string
Output Casting
string
Lat/Lon offset
string
Squeeze Street End Points
string
Return Geometry coordinates(Y/N)
string
Return Census Fields(Y/N)
string
Use GeoTAX Auxiliary File(Y/N)
string
Lat/Lon Return Format
string
Width ofPolygon Buffers
string

Returns

Post Taxrate By Location

This is a Batch offering for 'Taxrate By Location' service. It accepts a single location coordinate or a list of location coordinates and retrieve applicable tax rates.

Required Parameters

Tax Type
string
The tax rate id.

Optional Parameters

Purchase Amount
string
Unique ID
string
Geometry Type
string
Coordinates(lat, lon)
double
Fall Back to Geographic
string
Match mode
string
Distance Unit
string
FIND_ADDR_POINT_INTERP
string
FIND_SEARCH_AREA
string
FIND_ADDRESS_RANGE
string
FIND_EXPANDED_SEARCH_RADIUS
string
FIND_ALTERNATE_LOOKUP
string
FIND_STREET_CENTROID
string
FIND_FIRST_LETTER_EXPANDED
string
Output Casting
string
Lat/Lon offset
string
Squeeze Street End Points
string
Return Geometry coordinates(Y/N)
string
Return Census Fields(Y/N)
string
Use GeoTAX Auxiliary File(Y/N)
string
Lat/Lon Return Format
string
Width ofPolygon Buffers
string

Returns

Definitions

address

Matched Address Last line
string
Matched Address State Name
string
Matched Address Zip code
string
Matched Address address number
string
Matched Address apartment/house number
string
Matched Address apartment/house type
string
Matched Address city Name
string
Matched Address country ISO code
string
Matched Address county name
string
Matched Address formatted Address
string
Matched Address locality Name
string
Matched Address main addressLine
string
Matched Address place Name
string
Matched Address street Name
string
Matched Address zip code extension
string
addressLine1
string
addressLine2
string
addressLine3
string
businessName
string
city
string
county
string
displayName
string
latitude
string
longitude
string
objectId
string
postalCode
string
stateProvince
string
status
string
streetSide
string
urbanizationName
string

Geometry

Coordinates(lat, lon)
array of double
Geometry Type
string

SpecialPurposeDistrict

3-digit district type code
string
SPD Name
string
SPD compiled date
string
SPD district code
string
SPD effective date
string
SPD update date
string
SPD version date
string

UseTax

County Use Tax Amount
double
County Use Tax Rate
double
Municipality Use Tax Amount
double
Municipality Use Tax Rate
double
State Use Tax Amount
double
State Use Tax Rate
double
Total Use Tax Amount
double
Total Use Tax Rate
double
spdsTax
array of SpecialPurposeDistrictTax
specialTaxRulesApplied
boolean
specialTaxRulesDescriptor
string

County

County Code
string
County Name
string
fips
string

SalesTax

County Sales Tax Amount
double
County Sales Tax Rate
double
Municipality Sales Tax Aount
double
Municipality Sales Tax Rate
double
Special Tax Rules Applied
boolean
Special Tax Rules Descriptor
string
State Sales Tax Amount
double
State Sales Tax Rate
double
Total Sales Tax Amount
double
Total Sales Tax rate
double
spdsTax
array of SpecialPurposeDistrictTax

Cbsa

code
string
name
string

taxResponse

Probability that the point falls in the specified Place
double
census
Census
gnisCode
string
jurisdiction
TaxJurisdiction
latLongFields
LatLongFields
matchedAddress
address
objectId
string
salesTax
SalesTax
useTax
UseTax

taxResponses

taxResponses
array of taxResponse

SpecialPurposeDistrictTax

District Number of SPD
string
Tax Amount for SPD
double
Tax rate for SPD
double

TaxJurisdiction

county
County
place
Place
spds
array of SpecialPurposeDistrict
state
State

LatLongFields

geometry
Geometry
matchCode
string
matchLevel
string
streetMatchCode
string
streetMatchLevel
string

Mcd

code
string
name
string

Census

cbsa
Cbsa
matchCode
string
matchLevel
string
mcd
Mcd
tract
string

State

State Code
string
State Name
string
fips
string

Place

Place Class Code
string
Place Code
string
Place Incorporated Flag
string
Place Last Annexed Date
string
Place Last Verified Date
string
Place Last updated Date
string
Place Name
string

TaxDistrictResponseList

taxDistrictResponse
array of TaxDistrictResponse

TaxDistrictResponse

Number of Insurance Premium Tax Districts
integer
Percentage Overlap of Geocode
double
Unique ID
string
census
Census
ipds
array of ipd
jurisdiction
IPDTaxJurisdiction
latLongFields
LatLongFields
matchedAddress
address

IPDTaxJurisdiction

county
County
place
Place
state
State

ipd

IPD Effective Date
string
IPD Expiration Date
string
IPD ID
string
IPD Name
string
Tax code descriptions
string
boundaryBuffer
BoundaryBuffer
districtType
DistrictType
rates
array of rate

DistrictType

Insurance Premium Districts Type
string
value
string

BoundaryBuffer

bufferRelation
BufferRelation
distanceToBorder
DistanceToBorder

rate

Tax Rate Format
string
Tax Rate Format Description
string
Tax Rate Name
string
value
string

BufferRelation

Buffer Relation Description
string
Buffer Relation Value
string

DistanceToBorder

Distance to Border Value
string
Ditance to Border Unit
string