ValidateTaxIDColombia

Validate Tax ID - COL - 01

Minor Business Rule

Object Name: B76C0001

Parent DLL: CLOC

Location: Client/Server

Language: C

Functional Description

Purpose
This function is used to:

• Calculate  and validate the Check Digit for the Tax ID (NIT). The check digit is calculated using an
special mathematical routine.
• Edit the Tax ID (NIT).

Setup Notes and Prerequisites
The UDC H00/TA  has to be set up.

Special Logic
• The business function will edit the Tax ID (NIT) when the field Person/Corporation Code is equal to
'C' or the Special Handling Code for the UDC H00/TA is equal to 'Y'.

• The check digit is calculated if the UDC H00/TA takes a value of 'Y'  in the field Special Handling
Code (for the person/corporation code given ).

• When the field Tax ID has the character '-' in the last position, the business function calculates
the check digit.

Moreover; if a value is preceded by the character '-', the check digit calculated is validated
against the check digit entered. If the check digit entered is invalid, an error (2787) is returned.

Technical Specifications
Parameters:
TAXszTaxId[21]I/ORequired
TAXCcPersonCorporationCodeIRequired
CJCNmnIdentificationNumberO
CJCDcCheckDigitO
CXTDszPersonCorporationDescription[4]O
DTAIsErrorO

^

Data Structure

D76C0001 - Validate Tax ID - COL - 00 - 76C

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szTaxId	TAX	char	OPT	NONE
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.
cPersonCorporationCode	TAXC	char	OPT	NONE
A code that designates the type of taxpayer. For 1099 reporting for U.S. suppliers and foreign suppliers, the system chooses only records with a code of P or N. Valid values for U.S. entities are: Blank or C Corporate entity (the Tax ID prints as 12-3456789) P Individual (the Tax ID prints as 123-45-6789) N Noncorporate entity (the Tax ID prints as 12-3456789) Valid values for non-U.S. entities are: 1 Individual 2 Corporate entity 3 Both an individual and a corporate entity 4 Noncorporate entity 5 Customs authority
mnIdentificationNumber	CJCN	MATH_NUMERIC	OPT	NONE
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. Do not enter separator characters. The system verifies the number and prints the separators in their correct format, according to the value of TAXC (Person/Corporation Code). If there is no value for TAXC, the system does not format this number. When you add new line items to a supplier's worktable record, the supplier master record supplies the default value for the tax ID.
cCheckDigit	CJCD	char	OPT	NONE
It is the NIT check digit.
szPersonCorporationDescription	CXTD	char	OPT	NONE
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.
szError	DTAI	char	OPT	NONE
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.

Related Functions

X0005 Get User Defined Codes

Related Tables