Part 2. Information Technology

Chapter 4. IDRS Terminal Input

Section 52. Command Codes TPCIN and TPCOL

2.4.52  Command Codes TPCIN and TPCOL

2.4.52.1  (01-01-2008)
Overview of Command Code TPCIN and TPCOL

  1. The Third Party Contact System is designed to maintain a database of all third party contacts that were made regarding a taxpayer during the determination or collection of a tax liability. The database contains data relating to IMF, BMF, NMF and EPMF. Each record on the database contains the contact name or general description of the third party contacted (ex. neighbor, bank name, business associate) along with the date of contact for all contacts made relating to a specific TIN.

  2. Data is input to the third party contact database from Form 12175, ‘Third Party Contact Report Form’ which is filled out by the employee who made the third party contact.

  3. The Third Party Contact System consists of two command codes, TPCIN and TPCOL.

2.4.52.2  (01-01-2010)
Command Code TPCIN (Definer 'A')—Input Format

  1. Command Code TPCIN with definer ‘A’— used to request an input screen for inputting taxpayer and third party contact information from Form 12175. Up to 78 MFT/Taxperiods can be input with each third party contact.

  2. The required input for command code TPCIN with definer ‘A’ without Reprisal is as follows:

    1. Command Code TPCIN

    2. Command Code Definer ‘A’

    3. Taxpayer Identification Number (TIN)

    4. Display File Source Code

    5. Name Control

    6. Employee Identification Number

    7. Plan Number — Required only when EPMF account

    8. MFT/Taxperiod — At least one MFT and taxperiod required (except when EP/EO Determination Case Number is entered or Reprisal is ‘Y’)

    9. Contact is For

    10. Date of Contact

    11. 3RD Party Name

    12. Category Code

  3. The required input for command code TPCIN with definer ‘A’ with Reprisal is as follows:

    1. Taxpayer Identification Number (TIN)

    2. Display File Source Code

    3. Name Control

    4. Employee Identification Number

    5. Date of Contact

    6. Category Code

2.4.52.3  (01-01-2000)
Command Code TPCIN (definer ‘U’) — Update Format

  1. Command Code TPCIN with definer ‘U’ — used to request an update screen. The information relating to the input TIN will return on the screen ready for updating. By inputting the Request Type and the Contact Number at the bottom of the screen, the user will be given the capability to:

    1. change screen data,

    2. delete a contact or,

    3. display third party contact information.

  2. The required input for command code TPCIN with definer ‘U’ is as follows:

    1. Command Code TPCIN

    2. Command Code Definer ‘U’

    3. Taxpayer Identification Number (TIN)

    4. Display File Source Code

2.4.52.4  (01-01-2001)
Command Code TPCIN Error Responses

  1. Error responses are displayed on Line 24 in inverse video. The erroneous literal will display in inverse video and the cursor will appear on the input field.

    1. CC DEFINER INVALID - CHECK INPUT — The input command code definer must be A or U. Correct and re-enter.

    2. NOT EDITED TIN, PLEASE REINPUT — The input TIN must be in SSN or EIN format, or Secondary TIN is missing when contact is for BOTH or Secondary.

    3. INVALID TIN AND FS - PLEASE REINPUT — The TIN and/or Display File Source Code did not meet standard validity criteria. Correct and re-enter.

    4. RECORD NOT FOUND— There is no record found for the requested TIN on the Third Party Contact Database.

    5. INVALID INPUT - MUST BE Y / N — The REPRISAL-IND must be ‘Y’ or ‘N’.

    6. nnn MFT/ TAX PRDS CONTAIN ERRORS — Invalid or inconsistent MFT/Taxperiod(s). The nnn is the total number that are invalid on the screen input.

    7. A CONTACT TYPE MUST BE SELECTED — The screen input does not contain a Contact Type.

    8. INVALID CONTACT DATE — The screen input is a future date or does not meet standard validity criteria.

    9. ALL MFT/TAXPRDS ARE BLANK OR ERRONEOUS — All of the input MFT/Taxperiods are blank or do not meet standard validity criteria.

    10. CASE NUMBER AND/OR CASE TYPE MISMATCH — A Case Type of A, B, E or O must be input when an EP/EO Determination Case Number is input.

    11. CONTACT NAME REQUIRED — The input screen does not contain a Contact Name.

    12. NAME CONTROL NOT FOUND FOR TIN/FS — The input Name Control does not agree with the Name Control on the NAP for input TIN/FS.

    13. MINIMUM REQUIRED FIELDS — The input screen does not contain all necessary required fields.

    14. DISPLAY FS AND PLAN NUMBER INCONSISTENT — A Plan Number was entered for a non-EPMF account. The input Display File Source must be P when a Plan Number is entered.

    15. SSN NOT VALID WITH EP/EO CASE NUMBER — The TIN must be an EIN when EP/EO Case Number is entered.

    16. CONTACT nnn NOT FOUND — There is no contact found for the input Contact Number.

    17. PRIM AND SEC TINS CANNOT BE THE SAME — The input Primary and Secondary TINs must be unique.

    18. PLAN NUMBER NOT VALID WITH EO ACCOUNT— A Plan Number is valid with EPMF accounts only.

    19. DATA CONFLICTS — Both Secondary and BOTH are checked in the Contact Is For. Choose either Secondary or BOTH for valid input.

    20. SECONDARY TIN INVALID WITH EIN — Only a Primary TIN is valid with a BMF account.

    21. INVALID REQUEST - CHECK INPUT — The input Request Type or Contact Number is invalid.

    22. nnn ERROR WRITING TO DATABASE — There is an error updating the third party database. Contact the programmer. The nnn is the database error number.

    23. PAGING ERROR ENCOUNTERED — The attempt to retrieve an additional page was performed before an initial TPCIN/TPCOL request was made.

    24. NO SCREENS AVAILABLE— There are no additional screens available.

    25. COMMAND CODE INVALID— The system did not recognize the input command code. Correct and re-input.

    26. TINS DID NOT FILE JOINTLY FOR TAXYEARS— The primary taxpayer and secondary taxpayer did not file jointly for the input tax period(s).

    27. NAME MAY NOT CONTAIN " REPRISAL" — The work "REPRISAL" is invalid input for the 3rd Party Name.

    28. INVALID CATEGORY CODE— Valid values are 1 through 5, F and i.

    29. MUST CONTAIN NUMERICS — The input for this field must be numerics.

2.4.52.5  (01-01-2000)
Command Code TPCIN Valid Responses

  1. One of the following valid responses will be displayed in inverse video on line 24 when no errors are present:

    1. REQUEST COMPLETED ADD SUCCESSFUL — The third party data has been successfully added to the Third Party Contact Database.

    2. REQUEST COMPLETED DELETE SUCCESSFUL — The requested third party contact has been successfully deleted from the Third Party Contact Database.

    3. REQUEST COMPLETED CHANGE SUCCESSFUL — The requested changes are valid and have been updated to the Third Party Contact record.

2.4.52.6  (01-01-2007)
Command Code TPCOL(definer ' ')

  1. Command Code TPCOL, definer blank — used to display third party contact information relating to the input TIN. This command code is used when a taxpayer requests a list of contacts.

  2. The required input for command code TPCOL is as follows:

    1. Command Code TPCOL

    2. Taxpayer Identification Number (TIN)

    3. Display File Source Code

  3. Command Code TPCOL will display the following:

    1. Systemic Mail Date

    2. Requested Mail Date

    3. Number of Contacts for the input TIN

    4. Taxpayer TIN

    5. Contact

    6. Date Contacted

    7. Mail Out Indicator

2.4.52.7  (01-01-2007)
Command Code TPCOL Error Responses

  1. NO RECORD FOUND- There is no record found on the Third Party Contact database for the requested TIN.

  2. INVALID-TIN AND FS-PLEASE REINPUT — The TIN and/or Display File Source Code did not meet standard validity criteria. Correct and re-enter.

  3. nnn ERROR ACCESSING DATABASE — There is in error accessing the third party contact database. Contact the programmer. The nnn is the database error number.

  4. A PAGING REQUEST WAS ENTERED BEFORE A TPCOL REQUEST— The attempt to retrieve an additional page was performed before an initial TPCOL request was made.

  5. NO SCREENS AVAILABLE — There are no additional screens available.

  6. COMMAND CODE INVALID — The system did not recognize the input command code. Correct and re-input.

  7. NO ADDRESS FOUND — An address cannot be found on the National Account Profile(NAP) for input TIN.

  8. OUT OF RANGE FOR PARTIAL DATE — The input Print Date is either not numeric or older than 199901 or greater than the current date.

  9. NO CONTACTS WERE MADE — No contacts were made for the input TIN.

  10. PROBLEM ACCESSING CONTACT DATABASE — The Third Party Contact Database is not available.

  11. NO CONTACTS WERE MADE AND NO ADDRESS FOUND — No contacts were made and address was found on the NAP for the input TIN.

  12. NAMELINE, STREET, CITY, STATE & ZIP REQUIRED — The nameline, street, city, state or zip are either blank or not valid.

  13. INVALID COMMAND CODE DEFINER — The input Command Code Definer is not blank

2.4.52.8  (01-01-2000)
Command code TPCIN and TPCOL Paging

  1. Command Codes TPCIN and TPCOL will provide the following paging features:

    1. IDRS-like paging when display of multiple third party contacts fill a page.

    2. The paging routine will automatically position the cursor following the Start of Message symbol. When the ENTER key is depressed, the terminal will display the next page or any page designated by overlaying a page number onto the format by Key Input.

    3. No entry code is needed to move from one page to another.

Exhibit 2.4.52-1 
COMMAND CODE TPCIN Input Screen

Description: Screen format to request input screen.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code: TPCIN
1 06 Command Code Definer ‘A’

Exhibit 2.4.52-2 
COMMAND CODE TPCIN Response Screen

Description: Screen layout for inputting Third Party Contact data.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code TPCIN
1 06 Command Code Definer ‘A’
2 02–14 Taxpayer TIN literal
2 16–27 Taxpayer TIN/Display File Source — must be present and in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
2 30–39 Name Ctrl literal
2 41–44 Taxpayer Name Control — must be present.
2 47–58 Employee ID literal
2 60–69 Employee Identification Number — must be present.
3 02–15 Secondary TIN literal
3 17–28 Secondary TIN/Display File Source — input when contact is for Secondary taxpayer or Both Primary and Secondary taxpayers. Must be in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)
3 47–65 Employee Telephone literal
3 67–78 Employee Telephone Number — include area code — optional.
4 47–65 Employee Mail Stop literal
4 67–76 Employee Mail Stop — optional.
6 02–16 Contact Is For: literal
One of the following must be entered:
6 18–25 Primary literal
6 27 Primary Taxpayer — Input ‘X’ when the contact was made concerning the Primary taxpayer only.
6 29–38 Secondary literal
6 40 Secondary Taxpayer — Input ‘X’ when the contact was made concerning the Secondary taxpayer only.
6 42–46 Both literal
6 48 Both Taxpayers — Input ‘X’ when the contact was made concerning both the Primary and Secondary taxpayers.
8 02–17 Date of Contact literal
8 19–26 Date of Contact — must be present and in YYYYMMDD format. Cannot be a future date or before 19980101.
8 29–43 Third Party Name literal
8 45–79 Third Party Name — must be present.
9 29–43 Name Continued literal
9 45–79 Name Continued — optional, used when additional space is needed for the 3rd Party Name.
10 02–15 Category Code literal
10 17 Category Code — must be present and one of the following:
     1 — Individual
     2 — Financial Institution
     3 — Business
     4 — State/Federal Government Organization
     5 — Other
     F — Farm Subsidy (Restricted for W&I use)
     i — Invalid Farm Subsidy (Restricted for W&I use)
12 02–10 Reprisal literal
12 12 Reprisal — overlay ‘N’ with ‘Y’ when reprisal is checked on Form 12175.
When Reprisal is ‘Y’, only the following input is required:
     TIN/Display File Source Code
     Name Control
     Employee — ID
     Category Code
     Date of Contact
12 17–28 Plan Number literal
12 30–32 Plan Number — must be present when EPMF account and must be between 001–999.
12 35–66 EP/EO Determination Case Number literal
12 68–76 EP/EO Determination Case Number — if entered, last digit (Case Type) must be entered.
12 78 Case Type — must be entered when EP/EO Determination Case Number is sent, must be one of the following:
     A — EP Division Headquarters
     B — EO Division Headquarters
     E — EP Determination
     O — EO Determination the Primary and Secondary taxpayers.
14 02–16 MFT Tax Period literal
14 22–80 MFT/Taxperiods — at least one MFT and taxperiod must be entered (except when EP/EO Determination Case Number is input or when Reprisal is ‘Y’). Up to 99 can be added for each Third Party Contact.
15–23 02–80 MFT/Taxperiods

Exhibit 2.4.52-3 
COMMAND CODE TPCIN Error Screen

Description: Screen layout for error messages.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code TPCIN
1 06 Command Code Definer
24 02–79 Error Message

Exhibit 2.4.52-4 
COMMAND CODE TPCIN Input Screen

Description: Screen format to request update screen.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code TPCIN
1 06 Command Code Definer ‘U’
1 07–18 Taxpayer TIN/Display File Source — must be in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)

Exhibit 2.4.52-5 
COMMAND CODE TPCIN Response Screen

Description: Screen layout for updating Third Party Contact data.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code: TPCIN
1 06 Command Code Definer ‘U’
1 07–18 Taxpayer TIN/Display File Source — must be in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)
3 12–40 Third Party Database Contains literal
3 42–44 Number of Contacts
3 46–61 Contacts for TIN literal
3 63–74 Taxpayer TIN/Display File Source
5, 10, 15 03–05 Contact Number
5, 10, 15 07–14 Contact literal
5, 10, 15 15–49 Contact Name
5, 10, 15 51–65 Date Contacted literal
5, 10, 15 66–73 Date Contacted
6, 11, 16 07–16 Name Ctrl literal
6, 11, 16 17–20 Taxpayer Name Control
6, 11, 16 26–39 Category Code literall
6, 11, 16 40 Category Code
6, 11, 16 46–57 Employee ID literal
6, 11, 16 58–67 Employee ID
7, 12, 17 07–17 Employee Phone literal
7, 12, 17 18–20 Employee Phone Number
7, 12, 17 32–46 Employee Mail Stop literal
7, 12, 17 47–56 Employee Mail Stop
7, 12, 17 59–67 Plan Number literal
7, 12, 17 68–70 Plan Number
8, 13, 18 07–70 MFT/Taxperiods
22 10–31 Request Type literal
22 33 Request Type — Must be input. Input one of the following:
    C — to change the taxpayer and/or contact information. When changing a Reprisal to a non-Reprisal, all non-Reprisal input fields must be present (see 52.1.1(3) of this IRM). When changing a non-Reprisal to a Reprisal, only the required fields for Reprisal (see 52.1.1(3)) can be changed and will be taken from the input screen to be stored to the database.
    D — to delete a contact
    L — to list all information that is stored on The Third Party Database regarding this contact
22 37–52 Contact Number literal
22 54–56 Contact Number — input the number of the corresponding Third Party Contact in which you want to perform one of the Request Type actions. Must be entered when Request Type is present.
24 11–14 Page literal
24 16–18 Current Screen Number
24 20–21 Page literal
24 23–25 Total number of screens
24 41–45 Command Code to retrieve additional screen
24 47–49 Next screen number

Exhibit 2.4.52-6 
COMMAND CODE TPCIN Response Screen

Description: Screen response when Request Type C or L is input.
Note:When Request Type 'D' is input, the contact will be deleted from the Third Party Contact Database and only a 'REQUEST COMPLETED-DELETE SUCCESSFUL' message will display on Line 24.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code TPCIN
1 06 Command Code Definer C or L (Request Type)
2 02–14 Taxpayer TIN literal
2 16–27 Taxpayer TIN/Display File Source — will be in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)
2 30–39 Name Ctrl literal
2 41–44 Taxpayer Name Control
2 47–58 Employee ID literal
2 60–69 Employee Identification Number
3 02–15 Secondary TIN literal
3 17–28 Secondary TIN/Display File Source — if present, will be one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)
3 47–65 Employee Telephone literal
3 67–78 Employee Telephone Number — include area code.
4 47–65 Employee Mail Stop literal
4 67–76 Employee Mail Stop
6 02–16 Contact is for: literal
6 18–25 Primary literal
6 27 Primary Taxpayer
6 29–38 Secondary literal
6 40 Secondary Taxpayer
6 42–46 Both literal
6 48 Both Taxpayers
8 02–17 Date of Contact literal
8 19–26 Date of Contact
8 29–43 Third Party Name literal
8 45–79 Third Party Name
9 29–43 Name Continued literal
9 45–79 Name Continued
10 02–15 Category Code literal
10 17 Category Code — will be one of the following:
     1 — Individual
     2 — Financial Institution
     3 — Business
     4 — State/Federal Government Organization
     5 — Other
     F — Farm Subsidy (Restricted for W&I use)
     i — Invalid Farm Subsidy (Restricted for W&I use)
12 02–10 Reprisal literal
12 12 Reprisal — ‘Y’ when checked on Form 12175.
12 17–28 Plan Number literal
12 30–32 Plan Number
12 35–66 EP/EO Determination Case Number literal
12 68–76 EP/EO Determination Case Number
12 78 Case Type
14 02–16 MFT Taxprd literal
14 22–80 MFT/Taxperiods
15–23 02–80 MFT/Taxperiods

Exhibit 2.4.52-7 
COMMAND CODE TPCOL Input Screen

Description: Screen format to request display screen.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code: TPCOL
1 06 Command Code Definer
     blank
1 07–18 Taxpayer TIN/Display File Source — must be in one of the following edited formats:
     nn-nnnnnnnN (NMF EIN)
     nn-nnnnnnnP (EPMF EIN)
     nn-nnnnnnn (BMF EIN)
     nnn-nn-nnnn (IMF SSN)
     nnn-nn-nnnn* (IMF SSN invalid)
     nnn-nn-nnnnV (BMF SSN)
     nnn-nn-nnnnW (BMF SSN invalid)
     nnn-nn-nnnnN (NMF SSN)

Exhibit 2.4.52-8 
COMMAND CODE TPCOL(definer ' ') Response Screen

Description: Screen layout for displaying Third Party Contact data.
This image is too large to be displayed in the current screen. Please click the link to view the image.
LINE POSITION DESCRIPTION
1 01–05 Command Code: TPCOL
3 01–79 literals
4 01–29 literals
4 31–38 Systemic Mail Date
6 01–79 literals
7 01–17 literals
7 19–26 Taxpayer Request Mail Date
9 01–43 Third Party Database Contains literal
9 45–47 Number of Contacts
9 49–64 Contacts for TIN literal
9 66–77 Taxpayer TIN/Display File Source
11, 14, 17, 20 01–07 Contact literal
11, 14, 17, 20 11–45 Contact name
11, 14, 17, 20 47–60 Date Contacted literal
11, 14, 17, 20 64–71 Date Contacted
11, 14, 17, 20 75–76 Mail Out Indicator
     S — the contact was on a list which was mailed to the taxpayer in the periodic mail out.
     R — the contact was on a list which was mailed to the taxpayer by taxpayer request.
12, 15, 18, 21 11–45 Name continued
24 14–17 Page literal
24 19–21 Current Screen Number
24 23–24 Page literal
24 26–28 Total number of screens
24 40–44 Command Code to retrieve additional screen
24 47–49 Next screen number

More Internal Revenue Manual