F4008AOCGetTaxRateAreas

F4008 AOC Get Tax Rate/Areas

Minor Business Rule

Object Name: B32C0150

Parent DLL: CMFG

Location: Client/Server

Language: C

Data Structure

D32C0150A - F4008 AOC Get Tax Rate/Areas

Parameter NameData ItemData TypeReq/OptI/O/Both
cTypeOfRequestEV01charOPTNONE

An option that specifies the type of processing for an event.

cErrorCodeEV01charOPTNONE

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTNONE

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

szTaxRateAreaTXA1charOPTNONE

A code that identifies a tax or geographic area that has common tax rates and tax authorities. The system validates the code you enter 
against the Tax Areas table (F4008). The system uses the tax rate area in conjunction with the tax explanation code and tax rules to calculate tax 
and G/L distribution amounts when you create an invoice or voucher.

szTaxRateAreaDescriptionTAXAcharOPTNONE

Text that names or describes the tax rate/area.  You can use this 30-character field, for example, to identify a zip code for a tax area or to 
partially describe the geographic area.

mnTaxAuthority1TA1MATH_NUMERICOPTNONE

The address book number of the tax agency that has jurisdiction in the tax area. You pay and report sales, use, or VAT taxes to this 
agency. Examples include states, counties, cities, transportation districts, provinces, and so on. You can specify up to five tax authorities for a single 
tax area.

mnTaxRate1TXR1MATH_NUMERICOPTNONE

A number that identifies the percentage of tax that should be assessed or paid to the corresponding tax authority, based on the tax area.  
Enter the percentage as a whole number and not as the decimal equivalent. For example, to specify 7 percent, enter 7, not .07. 

mnTaxAuthority2TA2MATH_NUMERICOPTNONE

The address book number of the tax agency that has jurisdiction in the tax area. You pay and report sales, use, or VAT taxes to this 
agency. Examples include states, counties, cities, transportation districts, provinces, and so on. You can specify up to five tax authorities for a single 
tax area.

mnTaxRate2TXR2MATH_NUMERICOPTNONE

A number that identifies the percentage of tax that should be assessed or paid to the corresponding tax authority, based on the tax area.  
Enter the percentage as a whole number and not as the decimal equivalent. For example, to specify 7 percent, enter 7, not .07. 

mnTaxAuthority3TA3MATH_NUMERICOPTNONE

The address book number of the tax agency that has jurisdiction in the tax area. This is the agency to whom you pay and report sales, use, 
or VAT taxes. Examples include states, counties, cities, transportation districts, provinces, and so on. You can specify up to five tax 
authorities for a single tax area.

mnTaxRate3TXR3MATH_NUMERICOPTNONE

A number that identifies the percentage of tax that should be assessed or paid to the corresponding tax authority, based on the tax area.  
Enter the percentage as a whole number and not as the decimal equivalent. For example, to specify 7 percent, enter 7, not .07. 

mnTaxAuthority4TA4MATH_NUMERICOPTNONE

The address book number of the tax agency that has jurisdiction in the tax area. You pay and report sales, use, or VAT taxes to this 
agency. Examples include states, counties, cities, transportation districts, provinces, and so on. You can specify up to five tax authorities for a single 
tax area.

mnTaxRate4TXR4MATH_NUMERICOPTNONE

A number that identifies the percentage of tax that should be assessed or paid to the corresponding tax authority, based on the tax area.  
Enter the percentage as a whole number and not as the decimal equivalent. For example, to specify 7 percent, enter 7, not .07. 

mnTaxAuthority5TA5MATH_NUMERICOPTNONE

The address book number of the tax agency that has jurisdiction in the tax area. You pay and report sales, use, or VAT taxes to this 
agency. Examples include states, counties, cities, transportation districts, provinces, and so on. You can specify up to five tax authorities for a single 
tax area.

mnTaxRate5TXR5MATH_NUMERICOPTNONE

A number that identifies the percentage of tax that should be assessed or paid to the corresponding tax authority, based on the tax area.  
Enter the percentage as a whole number and not as the decimal equivalent. For example, to specify 7 percent, enter 7, not .07.

jdExpirationDateEFDJJDEDATEOPTNONE

The date when a transaction, contract, obligation, preference, or policy rule ceases to be in effect.

jdEffectiveDateEFTJJDEDATEOPTNONE

The date when a transaction, contract, obligation, preference, or policy rule becomes effective.

szTaxRateArea1GLOffsetGL01charOPTNONE

A code that indicates how to locate the tax account for general ledger entries. This field points to automatic accounting instructions (AAIs) 
that, in turn, point to the tax account. Examples are:        PTyyyy - for A/P (VAT only)        RTyyyy - for A/R (VAT only)        GTyyyy - for G/L (VAT 
only)        4320 - for Sales Orders        4400 and 4410 - for Purchase Orders  When setting up VAT and Canadian GST, PTyyyy, RTyyyy, and 
GTyyyy are the only valid values. For the A/P system, a second G/L Offset (PT_ _ _ _) is required when your tax setup involves VAT plus use 
taxes (tax explanation code B). Use AAI PT_ _ _ _ to designate the use tax portion of the setup. For sales taxes, the Accounts Payable and 
Accounts Receivable systems ignore the values in this field. However, the Sales Order Management and Procurement systems require values in 
this field.

szTaxRateArea2GLOffsetGL02charOPTNONE

Code that indicates how to locate the tax account for general ledger entries. This field points to automatic accounting instructions (AAIs) that, 
in turn, point to the tax account. Examples are:   PTxxxx       for A/P (VAT only)   RTxxxx      for A/R (VAT only)   GTxxxx      for G/L (VAT only)   
SOTxxx      for Sales Orders    OPTxxx and OPAxxx      for Purchase Orders  For VAT and Canadian GST, only PTxxxx, RTxxxx, and GTxxxx are valid. 
For sales taxes, the A/P and A/R systems ignore the values in this field. For sales taxes, the Sales Order and Purchaser Order systems 
require values in this field. For the General Accounting system, VAT journal entries require values in this field. At this time, however, the system 
only uses the first G/L offset.

szTaxRateArea3GLOffsetGL03charOPTNONE

Code that indicates how to locate the tax account for general ledger entries. This field points to automatic accounting instructions (AAIs) that, 
in turn, point to the tax account. Examples are:   PTxxxx       for A/P (VAT only)   RTxxxx        for A/R (VAT only)   GTxxxx       for G/L (VAT only)   
SOTxxx       for Sales Orders    OPTxxx and OPAxxx       for Purchase Orders  For VAT and Canadian GST, only PTxxxx, RTxxxx, and GTxxxx are 
valid. For sales taxes, the A/P and A/R systems ignore the values in this field. For sales taxes, the Sales Order and Purchaser Order systems 
require values in this field. For the General Accounting system, VAT journal entries require values in this field. At this time, however, the system 
only uses the first G/L offset.

szTaxRateArea4GLOffsetGL04charOPTNONE

Code that indicates how to locate the tax account for general ledger entries. This field points to automatic accounting instructions (AAIs) that, 
in turn, point to the tax account. Examples are:   PTxxxx     for A/P (VAT only)   RTxxxx     for A/R (VAT only)   GTxxxx     for G/L (VAT only)   SOTxxx   
  for Sales Orders    OPTxxx and OPAxxx     for Purchase Orders  For VAT and Canadian GST, only PTxxxx, RTxxxx, and GTxxxx are valid. 
For sales taxes, the A/P and A/R systems ignore the values in this field. For sales taxes, the Sales Order and Purchaser Order systems require 
values in this field. For the General Accounting system, VAT journal entries require values in this field. At this time, however, the system only 
uses the first G/L offset.

szTaxRateArea5GLOffsetGL05charOPTNONE

Code that indicates how to locate the tax account for general ledger entries. This field points to automatic accounting instructions (AAIs) that, 
in turn, point to the tax account. Examples are:   PTxxxx     for A/P (VAT only)   RTxxxx     for A/R (VAT only)   GTxxxx     for G/L (VAT only)   SOTxxx   
  for Sales Orders    OPTxxx and OPAxxx     for Purchase Orders  For VAT and Canadian GST, only PTxxxx, RTxxxx, and GTxxxx are valid. 
For sales taxes, the A/P and A/R systems ignore the values in this field. For sales taxes, the Sales Order and Purchaser Order systems require 
values in this field. For the General Accounting system, VAT journal entries require values in this field. At this time, however, the system only 
uses the first G/L offset.

mnShortItemNumberITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

szSecondItemNumberLITMcharOPTNONE

A number that identifies the item. The system provides three separate item numbers plus an extensive cross-reference capability to 
alternative item numbers. The three types of item numbers are: Item Number (short) An 8-digit, computer-assigned item number. 2nd Item Number A 
25-digit, user defined, alphanumeric item number. 3rd Item Number  Another 25-digit, user defined, alphanumeric item number. In addition to 
these three basic item numbers, the system provides an extensive cross-reference search capability. You can define numerous 
cross-references to alternative part numbers. For example, you can define substitute item numbers, replacements, bar codes, customer numbers, or 
supplier numbers.

szThirdItemNumberAITMcharOPTNONE

The system provides three separate item numbers plus an extensive cross-reference capability to alternate item numbers. These item 
numbers are as follows: 1.  Item Number (short) - An 8-digit, computer-assigned item number. 2.  2nd Item Number - The 25-digit, free-form, user 
defined alphanumeric item number. 3.  3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item number.  In addition to 
these three basic item numbers, an extensive cross-reference search capability has been provided (see XRT). Numerous cross references to 
alternate part numbers can be user defined, such as substitute item numbers, replacements, bar codes, customer numbers, or supplier 
numbers.

szUnitOfMeasureUOMcharOPTNONE

A user defined code (00/UM) that indicates the quantity in which to express an inventory item, for example, CS (case) or BX (box).

cFactorValueTypeFVTYcharOPTNONE

A code that indicates whether the factor value is a multiplier (%) or an additional/deductible cash amount ($) when applied to an order's 
price.

mnMaximumTaxAmountMTAXMATH_NUMERICOPTNONE

A number that identifies the maximum amount that an item can be taxed. If the unit cost of an item is more than the amount that you specify in 
this field, the maximum unit cost becomes taxable. Note: This field is used for processing sales and purchase orders only. This field is 
required for processing taxes in the state of Tennessee. 

cTaxCalculationMethod1TC1charOPTNONE

This code is used to determine if the tax calculated for this tax authority is to based on the taxable amount plus any tax calculated for a 
previous tax authority.  If the value is N, only the taxable amount will be considered in the calculation of tax for this authority.  If the value is Y, the 
taxable amount plus any tax calculated for any previous tax authorities will be added together to calculate tax for this authority.

cTaxCalculationMethod2TC2charOPTNONE

An option that is used in Canada to specify whether to calculate PST tax after GST has been added to the product value. Valid settings 
are: On The system calculates PST tax after GST has been added to the product value. Off The system calculates the PST before GST has been 
added to the product value.  For example, suppose that you have a tax area set up with 7% GST and 8% PST, and you turn on the option to 
calculate tax on tax. If you enter a voucher for a taxable amount of 1000 CAD, the system calculates the GST as 70 CAD, adds it to the taxable 
amount, and multiplies the PST by that result (1070 CAD). If you do not use compound taxes, the system calculates PST on the taxable 
amount only. Note: This option is valid only for tax explanation codes that begin with the letters B and C. To calculate compound taxes for tax 
explanation code V, use tax explanation code V+.

cTaxCalculationMethod3TC3charOPTNONE

This code is used to determine if the tax calculated for this tax authority is to based on the taxable amount plus any tax calculated for a 
previous tax authority.  If the value is N, only the taxable amount will be considered in the calculation of tax for this authority.  If the value is Y, the 
taxable amount plus any tax calculated for any previous tax authorities will be added together to calculate tax for this authority.

cTaxCalculationMethod4TC4charOPTNONE

This code is used to determine if the tax calculated for this tax authority is to based on the taxable amount plus any tax calculated for a 
previous tax authority.  If the value is N, only the taxable amount will be considered in the calculation of tax for this authority.  If the value is Y, the 
taxable amount plus any tax calculated for any previous tax authorities will be added together to calculate tax for this authority.

cTaxCalculationMethod5TC5charOPTNONE

This code is used to determine if the tax calculated for the tax authority is to based on the taxable amount plus any tax calculated for a 
previous tax authority.  If the value is N, only the taxable amount will be considered in the calculation of tax for this authority.  If the value is Y, the 
taxable amount plus any tax calculated for any previous tax authorities will be added together to calculate tax for this authority.

cTaxType1TT1charOPTNONE

Future Use.

cTaxType2TT2charOPTNONE

Future Use.

cTaxType3TT3charOPTNONE

An option that indicates the percent of VAT that is not recoverable. You enter the nonrecoverable percentage in the Tax Rate field to the left 
of this option. Valid settings are: On Not recoverable. The system multiplies the percentage that you specify by the total tax amount and 
reduces the amount of VAT that is recoverable from the first tax authority. Off Recoverable. All of the VAT tax is recoverable. Note: This option is 
valid only with tax explanation codes that begin with the letters C, B, and V.

cTaxType4TT4charOPTNONE

An option that indicates the percent of VAT that is not recoverable. You enter the nonrecoverable percentage in the Tax Rate field to the left 
of this option. Valid settings are: On Not recoverable. The system multiplies the percentage that you specify by the total tax amount and 
reduces the amount of VAT that is recoverable from the first tax authority. Off Recoverable. All of the VAT tax is recoverable. Note: This option is 
valid only with tax explanation codes that begin with the letters C, B, and V.

cTaxType5TT5charOPTNONE

An option that indicates the percent of VAT that is not recoverable. You enter the nonrecoverable percentage in the Tax Rate field to the left 
of this option. Valid settings are: On Not recoverable. The system multiplies the percentage that you specify by the total tax amount and 
reduces the amount of VAT that is recoverable from the first tax authority. Off Recoverable. All of the VAT tax is recoverable. Note: This option is 
valid only with tax explanation codes that begin with the letters C, B, and V.

idGenericLongGENLNGIDOPTNONE

General purpose ID variable.

Related Functions

None

Related Tables

F4008 Tax Areas