MetraPipeline.MTComTaxPlugin.1
The MTComTax plug-in performs US based telecom taxation using Commtax21. Commtax21 21 is a telecommunications taxation package by Vertex. For more information on Commtax21, see Vertex's documentation.
The MetraTech default behavior is to calculate taxes using a Vertex Geocode. The geocode plug-in looks up the geocode based on the users city, state, and ZIP code.
Tag name |
Value type |
Description |
Origin_NPA |
String |
The area code of the originating call. |
Origin_NXX |
String |
The first 3 digits (exchange) of a 7 digit phone number. |
Destination_NPA |
String |
The area code of the destination call |
Destination_NXX |
string |
The destination first 3 digits (exchange) of a 7 digit phone number. |
GeoCode |
Long |
The Geocode is a propietary number for determining the taxation jurisdition for Vertex products. If OverideWithAccountGeoCode is true the GeoCode will be used instead of the NPA/NXX. |
PreTaxAmount |
decimal |
The amount prior to taxation. |
TaxExemptAll |
bool |
Set if the user is exempt from all taxes. If the session property does not exist it will default to false. |
TaxExemptFederal |
bool |
Same as taxExemptAll but for federal taxes. |
TaxExemptState |
bool |
Same as taxExemptAll but for state taxes. |
TaxExemptCounty |
bool |
Same as taxExemptAll but for county taxes. |
TaxExemptCity |
bool |
Same as taxExemptAll but for city taxes. |
InvoiceDate |
Datetime |
The time the call occurred. This is very important to determine which tax rate should be used. |
Country |
String |
Must be "USA" for US taxation, anything else for VAT taxation. |
Tag name |
Value type |
Description |
TaxAmount |
decimal |
The total amount of tax that was calculated. |
FedTax |
decimal |
Federal tax. The property name should be " _FedTax" |
StateTax |
decimal |
State tax. The property should be " _StateTax" |
CountyTax |
decimal |
County tax. The property should be " _CountyTax" |
LocalTax |
decimal |
Local (city or town) tax. The property should be " _LocalTax" |
OtherTax |
decimal |
Any other applicable taxes. The property should be "OtherTax" |
Tag name |
Value type |
Description |
TreatInternationalAsInterstate |
Boolean |
Not used |
OverideWithAccountGeoCode |
Boolean |
Always use the Geocode when determining the taxation jurisdictions. This is the MetraTech default. The default value is True. |
ConfigFile |
String |
The location of the tax configuration file. This should always be tax\taxconfig.xml |
ComTaxConfigFile |
String |
The location of the Commtax configuration file. This should always be tax\MTComTax.xml |
ConfigInstallFile |
String |
File that describes Commtax installation information. This should always be tax\ComTaxInstallInfo.xml |
<configdata>
<!-- Inputs -->
<Origin_NPA>Origin_NPA</Origin_NPA>
<Origin_NXX>Origin_NXX</Origin_NXX>
<Destination_NPA>Destination_NPA</Destination_NPA>
<Destination_NXX>Destination_NXX</Destination_NXX>
<GeoCode>GeoCode</GeoCode>
<PreTaxAmount>PostDiscountAmount</PreTaxAmount>
<TaxExemptAll>taxexempt</TaxExemptAll>
<TaxExemptFederal>TaxExemptFederal</TaxExemptFederal>
<TaxExemptState>TaxExemptState</TaxExemptState>
<TaxExemptCounty>TaxExemptCounty</TaxExemptCounty>
<TaxExemptCity>TaxExemptCity</TaxExemptCity>
<InvoiceDate>DisconnectTime</InvoiceDate>
<Country>CountryName</Country>
<!-- Outputs -->
<TaxAmount>TaxAmount</TaxAmount>
<FedTax>_FedTax</FedTax>
<StateTax>_StateTax</StateTax>
<CountyTax>_CountyTax</CountyTax>
<LocalTax>_LocalTax</LocalTax>
<OtherTax>_OtherTax</OtherTax>
<TreatInternationalAsInterstate ptype="BOOLEAN">yes</TreatInternationalAsInterstate>
<OverideWithAccountGeoCode ptype="BOOLEAN">yes</OverideWithAccountGeoCode>
<ConfigFile>tax\taxconfig.xml</ConfigFile>
<ComTaxConfigFile>tax\MTComTax.xml</ComTaxConfigFile>
<ConfigInstallFile>tax\ComTaxInstallInfo.xml</ConfigInstallFile>
</configdata>
MetraTech by default uses the Geocode to determine the jurisdiction. The NPA/NXX can be generated from using the Phonecrack plug-in given that the service definition contains the origin and destination phone number.