WithholdingReportsStoreGetRecord

Withholding Certificates Store -Get Printed Value - C - 76C

Minor Business Rule

Object Name: B76C0020

Parent DLL: CLOC

Location: Client/Server

Language: C

Functional Description

Purpose
The general function of this program is to store in memory a summary of the records printed by the 
UBE R76C0001; values that will be retrieved at the end of the UBE. The program will store or retrieve 

the records depending on the value that the parameter  cCacheActionCode  takes. If this parameter takes 

a value of 1, the record is stored in Memory. If the parameter  takes a value of 2, the record 

retrieved is the record stored in the position that the parameter idPointerToCursor indicates. If the 

parameter cCacheActionCode is 3, the cache is destroyed.


Setup Notes and Prerequisites
• The parameter cCacheActionCode must have a value either 1, 2 or 3.
• If the value of the parameter cCacheActionCode is equal to 2, you must provide either the position 
in memory of the record to be read or the key for the first record stored in Cache. 

• Before calling the function with an action code of 2 you must have called the function with a value 
of 1.

• When finished retrieving all the records you must terminate the Cache by calling the function with 
an action code of 3.


Special Logic


• If the Pointer to cursor is null, the record retrieved will be the first record found with the key 
given as a parameter.    


Technical Specifications

Parameters:
AN8mnAddressNumberI/ORequired.
If cCacheActionCode = 1 

the parameter is 

required.

MATH01mnCertificateNumberI/ORequired.

If cCacheActionCode = 1 

the parameter is 

required.

ALPHszAphaNameI/ONo Required.

Third Party Name 

TAXszTaxIdI/ONo Required.

Tax ID 

CXTDszPersonCorporationI/O No Required.

DescriptionPerson Corporation 

Description. Ej : NIT , 

C.C, EXT

ATXAmnAmountTaxableI/ONo Required.

Taxable Amount 

STAMmnAmtTaxI/ONo Required.

Tax Amount

EV01cCacheActionCodeIRequired.

Action Code .

1 - Store in Cache

2 - Retrieve from Cache

3 - Destroy Cache 

DTAIszErrorMessageONo Required.

If any problem occurs 

when the cache is 

initialized or the record 

is stored or the record 

is retrieved. The error 

message is returned in 

this parameter.

GENLNGidPointerToCursorI/ORequired.

This parameter is 

required when you want to 

retrieve a record 

different to the first. 

TXR1mnTaxRate1I/ONo Required.

Tax Rate 



^

Data Structure

D76C0020A - Withholding Certificates Store-Get Printed Values - C - 76C

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICNONENONE

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

mnCertificateNumberMATH01MATH_NUMERICNONENONE

- - - Good Performance Low Value. 

szNameAlphaALPHcharNONENONE

The text that names or describes an address. This 40-character alphabetic field appears on a number of forms and reports. You can enter 
dashes, commas, and other special characters, but the system cannot search on them when you use this field to search for a name.

szTaxIdTAXcharNONENONE

The identification code required by various tax authorities. This can be a social security number, federal or state corporate tax ID, sales tax 
number, and so on. The system verifies the number and prints the separators in their correct format, according to the value of TAXC 
(Person/Corporation Code). If no value exists for TAXC, the system uses the Corporate Entity. Attention Accounts Payable users: The Supplier Master 
record supplies the default value for the tax ID for 1099 processing.

szPersonCorporationDescriptionCXTDcharNONENONE

A code that designates the type of taxpayer. The allowed codes are :     "C" = Individual     "A" = Corporate Entity     "E" = Foreign Individual 
This code is printed on the different reports that the Colombian tax Direction requires.

mnAmountTaxableATXAMATH_NUMERICNONENONE

The amount on which taxes are assessed.

mnAmtTaxSTAMMATH_NUMERICNONENONE

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

cCacheActionCodeEV01charNONENONE

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

szErrorMessageDTAIcharNONENONE

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.

idPointerToCursorGENLNGIDNONENONE

General purpose ID variable.

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. 

Related Functions

None

Related Tables

None