EndPrintNR4FormsCache

Cache for Print NR4 Forms

Minor Business Rule

Object Name: B7700440

Parent DLL: CPAY

Location: Client/Server

Language: C

Data Structure

D7700440 - DS for Init/End NR4 Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
szCacheName_VC11AVC11AcharOPTNONE

This is a generic field used as a work field in Everest.

Related Functions

None

Related Tables

None
InitializePrintNR4FormsCache

InitializePrintNR4FormsCache

Cache for Print NR4 Forms

Minor Business Rule

Object Name: B7700440

Parent DLL: CPAY

Location: Client/Server

Language: C

Data Structure

D7700440 - DS for Init/End NR4 Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
szCacheName_VC11AVC11AcharOPTNONE

This is a generic field used as a work field in Everest.

Related Functions

None

Related Tables

None
ReadPrintNR4FormsCache

ReadPrintNR4FormsCache

Cache for Print NR4 Forms

Minor Business Rule

Object Name: B7700440

Parent DLL: CPAY

Location: Client/Server

Language: C

Data Structure

D7700440B - DS for Write/Read NR4 Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
szCompany_COCOcharOPTNONE

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.

szEmpLastName_EMPLNAMEEMPLNAMEcharOPTNONE

A field indicating the employee's last name. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

szEmpFirstName_EMPFNAMEEMPFNAMEcharOPTNONE

A field indicating the employee's first name. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

cEmpMiddleInitial_EMPMIEMPMIcharOPTNONE

A field indicating the employee's middle initial. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

szAddressLine1_ADD1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szAddressLine2_ADD2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szEmployerName_NAMENAMEcharOPTNONE

A generic field used for names, addresses, descriptions or remarks.

mnPrimaryFormControlNo_PFCNOPFCNOMATH_NUMERICOPTNONE

A form control number.

cFirstTimeIntoCacheFlag_EV01EV01charOPTNONE

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

cEndOfCacheFlag_EV01EV01charOPTNONE

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

idCacheCursor_GENLNGGENLNGIDOPTNONE

General purpose ID variable.

szCacheName_VC11AVC11AcharOPTNONE

This is a generic field used as a work field in Everest.

cAmendType_AMNDTAMNDTcharOPTNONE

The amend status of this record for this year-end ID. Valid values are: Blank Not amended 1 Amended

szAddressLine3_ADD3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

cEmpOrSumRecFlag_EV01EV01charOPTNONE

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

szAddressLine4_ADD4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szAddressLine5_ADD5ADD5charOPTNONE

The fifth line of the mailing address in the Address Book system.

szTaxAreaWork_TARATARAcharOPTNONE

A code that identifies a geographical location and the tax authorities for an employee work site, including employee and employer statutory 
requirements. In the Vertex payroll tax calculation software, the tax area code is synonymous with GeoCode. To determine the valid codes 
for your location, refer to the documentation for the tax calculation software that you are using.

cRecipientTypeBox11_NRCTNRCTcharOPTNONE

A code that classifies the recipient of the NR4 form. This code is printed on the NR4 form. Valid values are assigned by the Canada 
Customs and Revenue Agency (CCRA) and are defined in UDC 77Y/RT.

szPayerRemitterID_NRIDNRIDcharOPTNONE

The Payer or Remitter Identification Number.

szTaxIdentificationNo_TAXXTAXXcharOPTNONE

A number that identifies your company to the tax authority. This number can include the tax ID number for an individual, a federal or state 
corporate tax ID, a sales tax number, and so on. This number has specifically been established for the Payroll system to handle the 
requirements of taxing authorities that require more than 9 positions for the tax identification number. Do not enter hyphens (dashes), slashes, spaces, or 
other punctuation in the tax identification number.

szSocSecurityNoBox13_SSNSSNcharOPTNONE

A number that indicates the tax ID. In the United States, the tax ID is the social security number. In Canada, it is the social insurance number. 
If you add employee information for a non-US or non-Canadian company, you can leave this field blank. However, if the international code is 
set to Y and the default company is non-Canadian and non-United States, you can enter a 16-character number for the tax ID. The system 
does not permit duplicate tax ID numbers. Also, the number cannot include dashes. For example, if a social security number of nn-nn-nnnn is 
used, the number should be entered as follows: 123456789.

szIncomeCode1Box14_ICC1ICC1charOPTNONE

A code that indicates the source of income. This code is printed on the NR4 form. Valid values are assigned by the Canada Customs and 
Revenue Agency (CCRA) and are defined in UDC 77/IC.

mnAmountGross1Box16_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

mnAmountTax1Box17_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

szIncomeCode2Box24_AMNTICC2charOPTNONE

A code that indicates the source of income. This code is printed on the NR4 form. Valid values are assigned by the Canada Customs and 
Revenue Agency (CCRA) and are defined in UDC 77/IC.

szCurrencyCode2Box25_AMNTCC2charOPTNONE

The currency code of the amount of gross income reported in box 16 or 26 and the amount of tax withheld reported in box 17 or 27. Income 
should be reported in Canadian funds if possible. However, if you cannot convert gross income (box 16 or 26) and tax withheld (box 17 or 27), 
the Canada Customs and Revenue Agency (CCRA) converts both amounts to Canadian funds, based on the currency code and the average 
annual rate as published by the Bank of Canada on December 31, 2001. Valid three-letter codes are assigned by the CCRA and are 
defined in UDC 77/CU.

szExemptionCode1Box18_EXC1EXC1charOPTNONE

A code that gives the authority under the Income Tax Act or a bilateral tax treaty to exempt the amount from Part XIII withholding tax, or to 
apply a reduced withholding rate. Valid values are assigned by the Canada Customs and Revenue Agency (CCRA) and are defined in UDC 
77/EX.

mnAmountGross1Box26_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

mnAmountTax1Box27_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

szExemptionCode2Box28_EXC2EXC2charOPTNONE

A code that gives the authority under the Income Tax Act or a bilateral tax treaty to exempt the amount from Part XIII withholding tax, or to 
apply a reduced withholding rate. Valid values are assigned by the Canada Customs and Revenue Agency (CCRA) and are defined in UDC 
77/EX.

szCountryCodeBox12_CCPRCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

szCOAddressLine1_ADD1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szCOAddressLine2_ADD2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szCOAddressLine3_ADD3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCOAddressLine4_ADD4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCOAddressLine5_ADD5ADD5charOPTNONE

The fifth line of the mailing address in the Address Book system.

mnAddressNumberAN8MATH_NUMERICOPTNONE

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

szCurrencyCode1Box15_CC1CC1charOPTNONE

The currency code of the amount of gross income reported in box 16 or 26 and the amount of tax withheld reported in box 17 or 27. Income 
should be reported in Canadian funds if possible. However, if you cannot convert gross income (box 16 or 26) and tax withheld (box 17 or 27), 
the Canada Customs and Revenue Agency (CCRA) converts both amounts to Canadian funds, based on the currency code and the average 
annual rate as published by the Bank of Canada on December 31, 2001. Valid three-letter codes are assigned by the CCRA and are 
defined in UDC 77/CU.

Related Functions

None

Related Tables

None
WritePrintNR4FormsCache

WritePrintNR4FormsCache

Cache for Print NR4 Forms

Minor Business Rule

Object Name: B7700440

Parent DLL: CPAY

Location: Client/Server

Language: C

Data Structure

D7700440B - DS for Write/Read NR4 Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
szCompany_COCOcharOPTNONE

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.

szEmpLastName_EMPLNAMEEMPLNAMEcharOPTNONE

A field indicating the employee's last name. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

szEmpFirstName_EMPFNAMEEMPFNAMEcharOPTNONE

A field indicating the employee's first name. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

cEmpMiddleInitial_EMPMIEMPMIcharOPTNONE

A field indicating the employee's middle initial. This field is populated from the alpha name. This field is used for SUI Magnetic Media 
Reporting.

szAddressLine1_ADD1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szAddressLine2_ADD2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szEmployerName_NAMENAMEcharOPTNONE

A generic field used for names, addresses, descriptions or remarks.

mnPrimaryFormControlNo_PFCNOPFCNOMATH_NUMERICOPTNONE

A form control number.

cFirstTimeIntoCacheFlag_EV01EV01charOPTNONE

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

cEndOfCacheFlag_EV01EV01charOPTNONE

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

idCacheCursor_GENLNGGENLNGIDOPTNONE

General purpose ID variable.

szCacheName_VC11AVC11AcharOPTNONE

This is a generic field used as a work field in Everest.

cAmendType_AMNDTAMNDTcharOPTNONE

The amend status of this record for this year-end ID. Valid values are: Blank Not amended 1 Amended

szAddressLine3_ADD3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

cEmpOrSumRecFlag_EV01EV01charOPTNONE

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

szAddressLine4_ADD4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szAddressLine5_ADD5ADD5charOPTNONE

The fifth line of the mailing address in the Address Book system.

szTaxAreaWork_TARATARAcharOPTNONE

A code that identifies a geographical location and the tax authorities for an employee work site, including employee and employer statutory 
requirements. In the Vertex payroll tax calculation software, the tax area code is synonymous with GeoCode. To determine the valid codes 
for your location, refer to the documentation for the tax calculation software that you are using.

cRecipientTypeBox11_NRCTNRCTcharOPTNONE

A code that classifies the recipient of the NR4 form. This code is printed on the NR4 form. Valid values are assigned by the Canada 
Customs and Revenue Agency (CCRA) and are defined in UDC 77Y/RT.

szPayerRemitterID_NRIDNRIDcharOPTNONE

The Payer or Remitter Identification Number.

szTaxIdentificationNo_TAXXTAXXcharOPTNONE

A number that identifies your company to the tax authority. This number can include the tax ID number for an individual, a federal or state 
corporate tax ID, a sales tax number, and so on. This number has specifically been established for the Payroll system to handle the 
requirements of taxing authorities that require more than 9 positions for the tax identification number. Do not enter hyphens (dashes), slashes, spaces, or 
other punctuation in the tax identification number.

szSocSecurityNoBox13_SSNSSNcharOPTNONE

A number that indicates the tax ID. In the United States, the tax ID is the social security number. In Canada, it is the social insurance number. 
If you add employee information for a non-US or non-Canadian company, you can leave this field blank. However, if the international code is 
set to Y and the default company is non-Canadian and non-United States, you can enter a 16-character number for the tax ID. The system 
does not permit duplicate tax ID numbers. Also, the number cannot include dashes. For example, if a social security number of nn-nn-nnnn is 
used, the number should be entered as follows: 123456789.

szIncomeCode1Box14_ICC1ICC1charOPTNONE

A code that indicates the source of income. This code is printed on the NR4 form. Valid values are assigned by the Canada Customs and 
Revenue Agency (CCRA) and are defined in UDC 77/IC.

mnAmountGross1Box16_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

mnAmountTax1Box17_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

szIncomeCode2Box24_AMNTICC2charOPTNONE

A code that indicates the source of income. This code is printed on the NR4 form. Valid values are assigned by the Canada Customs and 
Revenue Agency (CCRA) and are defined in UDC 77/IC.

szCurrencyCode2Box25_AMNTCC2charOPTNONE

The currency code of the amount of gross income reported in box 16 or 26 and the amount of tax withheld reported in box 17 or 27. Income 
should be reported in Canadian funds if possible. However, if you cannot convert gross income (box 16 or 26) and tax withheld (box 17 or 27), 
the Canada Customs and Revenue Agency (CCRA) converts both amounts to Canadian funds, based on the currency code and the average 
annual rate as published by the Bank of Canada on December 31, 2001. Valid three-letter codes are assigned by the CCRA and are 
defined in UDC 77/CU.

szExemptionCode1Box18_EXC1EXC1charOPTNONE

A code that gives the authority under the Income Tax Act or a bilateral tax treaty to exempt the amount from Part XIII withholding tax, or to 
apply a reduced withholding rate. Valid values are assigned by the Canada Customs and Revenue Agency (CCRA) and are defined in UDC 
77/EX.

mnAmountGross1Box26_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

mnAmountTax1Box27_AMNTAMNTMATH_NUMERICOPTNONE

An amount for a specific box on a year-end form.

szExemptionCode2Box28_EXC2EXC2charOPTNONE

A code that gives the authority under the Income Tax Act or a bilateral tax treaty to exempt the amount from Part XIII withholding tax, or to 
apply a reduced withholding rate. Valid values are assigned by the Canada Customs and Revenue Agency (CCRA) and are defined in UDC 
77/EX.

szCountryCodeBox12_CCPRCCPRcharOPTNONE

A user defined code list 00/CN that indicates the country in which the employee resides.

szCOAddressLine1_ADD1ADD1charOPTNONE

The first line of a mailing address for an employee, customer, or supplier in the Address Book system. The U.S. Internal Revenue Service 
(IRS) restricts the size of the address that prints on an employee's year-end tax return. To comply with IRS regulations, the system has the 
following restrictions:   o  On W-2 returns, the system prints only the last three nonblank address lines plus the city, state, and postal code.   o  On 
1099 returns, the system prints only the last nonblank address line plus the city, state, and postal code.   o  On other U.S. federal magnetic 
media, the system prints only the last nonblank address line plus the city, state, and postal code.

szCOAddressLine2_ADD2ADD2charOPTNONE

The second line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, 
and postal code.

szCOAddressLine3_ADD3ADD3charOPTNONE

The third line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that prints 
on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCOAddressLine4_ADD4ADD4charOPTNONE

The fourth line of the mailing address for an employee, customer, or supplier in the Address Book system. Attention Payroll users: The 
Internal Revenue Service (IRS) restricts the size of the address that prints on employee's year-end forms. To comply with IRS regulations, the 
address that prints on W-2 forms includes only the last three nonblank address lines plus the city, state, and postal code. The address that 
prints on 1099 forms includes only the last nonblank address line plus the city, state, and postal code. If you process year-end information using 
the federal magnetic media format, the address that prints on those forms contains only the last nonblank address line plus the city, state, and 
postal code.

szCOAddressLine5_ADD5ADD5charOPTNONE

The fifth line of the mailing address in the Address Book system.

mnAddressNumberAN8MATH_NUMERICOPTNONE

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

szCurrencyCode1Box15_CC1CC1charOPTNONE

The currency code of the amount of gross income reported in box 16 or 26 and the amount of tax withheld reported in box 17 or 27. Income 
should be reported in Canadian funds if possible. However, if you cannot convert gross income (box 16 or 26) and tax withheld (box 17 or 27), 
the Canada Customs and Revenue Agency (CCRA) converts both amounts to Canadian funds, based on the currency code and the average 
annual rate as published by the Bank of Canada on December 31, 2001. Valid three-letter codes are assigned by the CCRA and are 
defined in UDC 77/CU.

Related Functions

None

Related Tables

None