CalcTaxAuthTaxAmtsColombia

Calculate Tax Authority Tax Amount - COL - 00 - 76C

Minor Business Rule

Object Name: B76C0009

Parent DLL: CLOC

Location: Client/Server

Language: C

Functional Description

Purpose
To calculate the five tax authority tax amounts and return the five authorities and the related 
fields from the Tax Rate/Area table (F4008). This process takes into consideration the Colombian Tax Set Up 

( Company Tax Payer, Supplier Tax Payer, etc ).


Setup Notes and Prerequisites

• You must provide a tax amount and a taxable amount. 
 

Special Logic

This function calculates a tax amount for each tax authority.   
• Parses tax explanation and determines what type of taxes.  If tax type is non-tax exits program.  

• Checks for tax rate/area - if blank sets error and exits program.
• Retreives tax rate area
• Get Colombian Tax Set Up. 
• Calculates tax amount for each tax authority.  Flags first non-zero amount for use in rounding.  If 
all are zero, authority one will be used for rounding. 

• Handles rounding. Five amounts must total tax amount. Adjusts first non-zero amount. 
• Calculates GST and PST rates and uses them to calculate GST non-recoverable amount.  
• Returns tax authority related fields from Tax Rate/Area table (F4008).

Technical Specifications

Parameters:
TXA1szTaxarea1RequiredTaxRate/Area
DSVJjdDateservicecurrencyRequiredService/Tax  

                                                Date 

ITMmnIdentifiershortitemNo RequiredItem Number - 

                                                Used to 

                                                retreive tax 

                                                rate/area

TXR1mnTaxrate1Tax rate 1

TXR2mnTaxrate2OTax rate 2

TXR3mnTaxrate3OTax rate 3

TXR4mnTaxrate4OTax rate 4

TXR5mnTaxrate5OTax rate 5

TA1mnTaxauthority1OTax auth 1

TA2mnTaxauthority2OTax auth 2

TA3mnTaxauthority3OTax auth 3

TA4mnTaxauthority4OTax auth 4

TA5mnTaxauthority5OTax auth 5

GL01szGlclassbytaxarea1OG/L class                        

                                                auth 1

GL02szGlclassbytaxarea2OG/L class 

                                                auth 2

GL03szGlclassbytaxarea3OG/L class 

auth 3

GL04szGlclassbytaxarea4OG/L class 

auth 4

GL05szGlclassbytaxarea5O      G/L class 

auth 5

STAMmnAmtAuth1OTax amt auth1 

STAMmnAmtAuth2OTax amt auth2 

STAMmnAmtAuth3OTax amt auth3 

STAMmnAmtAuth4OTax amt auth4 

STAMmnAmtAuth5OTax amt auth5 

STAMmnNonRecoverGSTONon 

                                                recoverable 

                                                GST amount 


STAMmnTaxAmtIRequired. Tax 

amount 

ATXAmnTaxableAmtIRequired. 

Taxable 

Amount 

EXR2szTaxexemptreasonIRequired. Tax 

explanation 

code 

TC2 (Ficm)cTaxcalcmethodOTax 

calculation 

method - tax 

on tax flag 

TT3 (evat)cVATRecoerableFlag3OVat 

recoverable 

flag 3

TT4 (evat)cVATRecoerableFlag4OVat 

recoverable 

flag 4

TT5 (evat)cVATRecoerableFlag5OVat 

recoverable 

flag 5

TAXAszDescriptiontaxareaOTax rate/area 

description 

FVTcFactorvaluetypeOFactor value 

type 

AN8mnAddressNumberIRequired. 

Address 

Number 

CRRMcCurrencyModeIRequired. 

Currency Mode 

DOCmnDocVoucherInvoiceEINo 

Required. 

Document 

Number 

DCTszDocumentTypeINo 

Required. 

Document Type 

KCOszCompanyKeyINo 

Required. 

Company Key

SFXszDocumentPayItemINo 

Required.Pay 

Item

LNIDmnLineNumberINo 

Required. 

Line Number 

NLINmnNoOfLinesOnOrderINo 

Required. 

Number of 

Lines

MCUszCostCenterIRequired. 

Cost Center

CTIDszComputerIdINo 

Required. 

Computer Id

EV01cCallTaxCalcFlagINo 

Required. 

Flag

AC07szReportCodeAddBook007IRequired.

Category Code 

007 

MTAXmnMaximumTaxAmtOTax Amt

EV01cSystemCodeFlagIRequired.

'1' A/R ;

'2' A/P;

'3' G/L

COszCompanyIRequired.

Company


Related Tables 

F4008Tax Rates 

Related Business Functions

B76C0006GetColombianTaxSetUp


^

Data Structure

D76C0009 - Calculate Tax Authority tax Amounts - COL - 00        - 76C

Parameter NameData ItemData TypeReq/OptI/O/Both
szTaxarea1TAcharNONENONE

Tax Area-Payroll. The code of a taxing authority. All time entries for this Cost Center default to the value entered in this field.

jdDateservicecurrencyDSVJJDEDATENONENONE

A date that indicates when you purchased goods or services, or when you incurred a tax liability. 

mnIdentifiershortitemITMMATH_NUMERICNONENONE

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

mnTaxrate1TXR1MATH_NUMERICNONENONE

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. 

mnTaxrate2TXR2MATH_NUMERICNONENONE

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. 

mnTaxrate3TXR3MATH_NUMERICNONENONE

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. 

mnTaxrate4TXR4MATH_NUMERICNONENONE

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. 

mnTaxrate5TXR5MATH_NUMERICNONENONE

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.

mnTaxauthority1aTA1MATH_NUMERICNONENONE

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.

mnTaxauthority2TA2MATH_NUMERICNONENONE

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.

mnTaxauthority3TA3MATH_NUMERICNONENONE

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.

mnTaxauthority4TA4MATH_NUMERICNONENONE

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.

mnTaxauthority5TA5MATH_NUMERICNONENONE

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.

szGlclassbytaxarea1GL01charNONENONE

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.

szGlclassbytaxarea2GL02charNONENONE

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.

szGlclassbytaxarea3GL03charNONENONE

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.

szGlclassbytaxarea4GL04charNONENONE

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.

szGlclassbytaxarea5GL05charNONENONE

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.

mnAmtAuth1STA1MATH_NUMERICNONENONE

Of the total taxes calculated for this document (invoice, voucher, etc.), the dollar value of the tax liability attributable to the first of five 
possible taxing authorities who may comprise the tax area.

mnAmtAuth2STA2MATH_NUMERICNONENONE

Of the total taxes calculated for this document (invoice, voucher, etc.), the dollar value of the tax liability attributable to the second of five 
possible taxing authorities who may comprise the tax area.

mnAmtAuth3STA3MATH_NUMERICNONENONE

Of the total taxes calculated for this document (invoice, voucher, etc.), the dollar value of the tax liability attributable to the third of five 
possible taxing authorities who may comprise the tax area.

mnAmtAuth4STA4MATH_NUMERICNONENONE

Of the total taxes calculated for this document (invoice, voucher, etc.), the dollar value of the tax liability attributable to the fourth of five 
possible taxing authorities who may comprise the tax area.

mnAmtAuth5STA5MATH_NUMERICNONENONE

Of the total taxes calculated for this document (invoice, voucher, etc.), the dollar value of the tax liability attributable to the fifth of five possible 
taxing authorities who may comprise the tax area.

mnNonRecoverGSTRCLAMATH_NUMERICNONENONE

You can use this field to define the limit amount (or maximum amount) of a Recovery.  The Recovery Limit amount is the maximum amount 
which will be allowed over the term of the Lease. After the system calculates the Recovery amount deductible from Gross Overage Rent for the 
given billing period, it adjusts the Recovery amount so as to not exceed the Recovery Limit for the life of the Lease.

mnTaxAmtSTAMMATH_NUMERICNONENONE

The amount assessed and payable to tax authorities. It is the total of the VAT, use, and sales taxes (PST).

mnTaxableAmtATXAMATH_NUMERICNONENONE

The amount on which taxes are assessed.

szTaxexemptreasonEXR2charNONENONE

A value in user defined code table 00/EX that controls how a tax is assessed and distributed to the general ledger revenue and expense 
accounts. You assign this code to customers or suppliers to set up a default code for their transactions. Do not confuse this code with the 
taxable, non-taxable code. A single invoice or voucher can have both taxable and non-taxable items. The entire invoice or voucher, however, 
must have one tax explanation code.

cTaxcalcmethodFICMcharNONENONE

A code that specifies the tax method that the Vertex payroll-tax calculation system uses to calculate certain taxes. The codes are defined in 
UDC 07/TM. This code can also determine the form that the employee receives for year-end tax reporting. For example, when you enter C, 
a contract employee receives IRS Form 1099-M rather than IRS Form W-2. If a form is not specified in Description 2, the system generates 
IRS Form W-2. For employees who are paid multiple times within one pay period, the system should review previous payments within the same 
pay period and then adjust tax amounts. To specify this function, enter S. If a tax method exists for an employee in addition to the normal tax 
method that is set up in the Employee Master Information table (F060116), the system can use the alternative tax method to interactively 
process interim payments. To specify this function, enter Z. Some values, such as S and Z, might require additional setup in the UDC table.

cVATRecoverableFlag3EVATcharNONENONE

The Vat Recovery Flag is used to identify transactions for which the VAT tax may be recovered by the company. Valid Values:    0 NOT 
Recoverable    1 Potential recovery possible

cVATRecoverableFlag4EVATcharNONENONE

The Vat Recovery Flag is used to identify transactions for which the VAT tax may be recovered by the company. Valid Values:    0 NOT 
Recoverable    1 Potential recovery possible

cVATRecoverableFlag5EVATcharNONENONE

The Vat Recovery Flag is used to identify transactions for which the VAT tax may be recovered by the company. Valid Values:    0 NOT 
Recoverable    1 Potential recovery possible

szDescriptiontaxareaTAXAcharNONENONE

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.

cFactorValueTypeFVTcharNONENONE

A code that indicates whether the Factor Value is a multiplier (%) or an additional/deductable amount (A) when applied to an order's price.

mnAddressNumberAN8MATH_NUMERICNONENONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

cCurrencyModeCRRMcharNONENONE

An option that specifies whether the system displays amounts in the domestic or foreign currency. On  The system displays amounts in the 
foreign currency of the transaction. Off  The system displays amounts in the domestic currency of the transaction.

mnDocVoucherInvoiceEDOCMATH_NUMERICNONENONE

A number that identifies the original document, such as a voucher, invoice, or journal entry. On entry forms, you can assign the document 
number or let the system assign it using the Next Numbers program (P0002). Matching document numbers (DOCM) identify related documents 
in the Accounts Receivable and Accounts Payable systems. Examples of original and matching documents are: Accounts Payable     o 
Original document - voucher     o Matching document - payment  Accounts Receivable     o Original document - invoice     o Matching document - 
receipt  Note: In the Accounts Receivable system, the following transactions simultaneously generate original and matching documents: 
deductions, unapplied receipts, chargebacks, and drafts.

szDocumentTypeDCTcharNONENONE

A user defined code (00/DT) that identifies the origin and purpose of the transaction.  PeopleSoft reserves several prefixes for document 
types, such as, vouchers, invoices, receipts, and timesheets. The reserved document type prefixes for codes are: P Accounts payable 
documents R Accounts receivable documents  T Time and Pay documents I Inventory documents  O Purchase order documents  S Sales order 
documents 

szCompanyKeyKCOcharNONENONE

A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher, 
or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the 
document company to retrieve the correct next number for that company. If two or more original documents have the same document number and 
document type, you can use the document company to locate the desired document.

szDocumentPayItemSFXcharNONENONE

A number that identifies the pay item for a voucher or an invoice. The system assigns the pay item number. If the voucher or invoice has 
multiple pay items, the numbers are sequential.

mnLineNumberLNIDMATH_NUMERICNONENONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

mnNoOfLinesOnOrderNLINMATH_NUMERICNONENONE

A number representing the number of lines on either a purchase or sales order. or The number of receivers recorded during the receipts 
process.  This field will be used in Voucher Matching.

szCostCenterMCUcharNONENONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

szComputerIDCTIDcharNONENONE

szJobNumberJOBcharNONENONE

Job Number

cCallTaxCalcFlagEV01charNONENONE

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

szReportCode007AC07charNONENONE

One of 30 reporting codes that you can assign to an address in the Address Book system. Category Code 07 is used in the 1099 process to 
identify the box on the 1099 form in which a voucher or pay item should be reported. Examples include: 01 Rents 13 Nontaxable 
distributions 61  Interest income A7  Nonemployee compensation

mnMaximumTaxAmtMTAXMATH_NUMERICNONENONE

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. 

cSystemCodeFlagEV01charNONENONE

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

szCompanyCOcharNONENONE

A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company 
Constants table (F0010) and must identify a reporting entity that has a complete balance sheet. At this level, you can have intercompany 
transactions. Note: You can use company 00000 for default values such as dates and automatic accounting instructions. You cannot use company 00000 
for transaction entries.

mnCurrencyConverRateOvCRRMATH_NUMERICOPTNONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

Related Functions

None

Related Tables

F4008 Tax Areas