2.3.63  Command Codes RPVUE, RPVCU and RPPRT

Manual Transmittal

June 20, 2013

Purpose

(1) This transmits revised IRM 2.3.63, IDRS Terminal Responses, Command Codes RPVUE, RPVCU and RPPRT.

Background

None.

Material Changes

(1) IRM Handbook 102.3 has been renumbered to IRM 2.3.

(2) Beginning in PY2002, the valid input for the district office code will be the universal location code (ULC). For PY2001 and prior, continue to use the old district office codes.

(3) The PTIN information is added to RPVUE screen.

(4) Distribution - You have received a copy of this IRM section because you are on the Distribution List for IRM 2.3, IDRS Terminal Responses. Each section has its own catalogue number used for ordering and distributing purposes. You may adjust the subsequent distribution of this section to meet your office’s needs by adjusting your quarterly IMDDS Order Point Summary Report (IMR02).

Effect on Other Documents

IRM 2.3.63, dated 05-14-2012, is superseded.

Audience

LMSB, SBSE, TEGE, and W&I.

Effective Date

(07-01-2013)

Terence V. Milholland
Chief Technology Officer

2.3.63.1  (01-01-2007)
General Information on RPVOL

  1. The Return Preparer Inventory On-Line (RPVOL) system provides users access to Tax Preparer and associated taxpayer data. This information is extracted from the Individual Return Transaction File (IRTF) and the Business Return Transaction File (BRTF). The current year data and three prior years are maintained.

  2. The RPVOL system consists of three command codes and two batch programs. Command code RPVCU is used to search for the current cycle data. Command code RPVUE retrieves current year or any three prior years information. Command code RPPRT will generate a print request along with a confirmation screen.

2.3.63.2  (03-20-2006)
Command Code RPVCU

  1. This command code accesses the current cycle data only.

  2. All input parameters are the same for command code RPVCU and command code RPVUE.

  3. See Section 63.3 for terminal responses.

2.3.63.3  (03-20-2006)
Command Code RPVUE

  1. This command code accesses the current year or three prior years data.

  2. The output can be a summary screen, page request screen or group request screen depending on the definer.

  3. The following informational messages for CC RPVCU and RPVUE can be found on line 24:

    1. NAP INFORMATION NOT FOUND— The National Accounts Profile (NAP) did not find any information for the TIN that was input.

    2. NAP FILE UNAVAILABLE— The National Accounts Profile (NAP) was not available, try again later.

    3. NAP PUT FUNCTION UNSUCCESSFUL

    4. SEVERE ERROR ACCESSING NAP FILE

    5. NAP DATA OUT OF SEQUENCE

    6. EOF REACHED

    7. SOC7 OCCURRED — CONTACT IDRS TECH

    8. REC FOUND WITH INSIGNIFICANT DATA

    9. INVALID REQUEST — CHECK INPUT

    10. MFT WHEN PRESENT MUST HAVE 2 CHARACTERS

    11. TAX PERIOD WHEN PRESENT MUST HAVE 6 CHARACTERS

    12. TXPYR TIN WHEN PRESENT MUST HAVE11–12 CHARACTERS

    13. FORM NUMBER WHEN PRESENT MUST HAVE 4–5 CHARACTERS

    14. DO WHEN PRESENT MUST HAVE 2 CHARACTERS

    15. DEFINER WHEN PRESENT MUST HAVE 2–5 CHARACTERS

    16. MFT MUST BE CONSISTENT WITH FORM NUMBER

    17. FORM NUMBER IS INVALID – CHECK INPUT — Form number must be one of the following: 1040, 1041, 1065, 1120, 1120A or 1120S.

    18. DO CODE IS INVALID — CHECK INPUT— The district office code is not valid.

    19. THE TIN FIELD IS INVALID — CHECK INPUT— The TIN is not numeric or is not in the correct format.

    20. THE PTIN DOES NOT HAVE AN SSN ASSOCIATED WITH IT

    21. PROCESSING YEAR MUST BE > 1999 FOR PTINS— PTIN's did not exist prior to the year 2000.

    22. THE MFT CODE MUST BE 02, 05, 06, 30

    23. THE TAX PERIOD MUST BE NUMERIC — CHECK INPUT

    24. THE RETURN INDICATOR MUST BE I OR B — CHECK INPUT

    25. THE TIN VALIDITY INDICATOR IS INCONSISTENT OR IN ERROR — CHECK INPUT— The display file source code must be space, *, V or W.

    26. THE PTIN FIELD IS INVALID – CHECK INPUT — The format for a PTIN is "P" followed by 8 numerics.

    27. NO RECORDS MATCH THE INPUT TIN. PTIN CROSS REFERENCE FILE NOT ACCESSIBLE

    28. XREF FILE UNAVAILABLE. ONLY INFO FOR INPUT TIN GIVEN. TRY AGAIN LATER

    29. PTIN XREF FILE ERROR, XREF FILE UNACCESSIBLE. ONLY INPUT TIN INFO AVAILABLE

    30. THERE ARE TOO MANY OPTIONAL FIELDS PRESENT.— The maximum number of optional fields is 5.

    31. TOO MANY RECORDS - NARROW SCOPE OF SEARCH

    32. MAXIMUM RECORDS READ (20000). CHANGE SEARCH CRITERIA. COULD BE MORE MATCHES

    33. MAXIMUM RECORDS READ (20000). NO MATCH FOUND. CHANGE SEARCH CRITERIA

    34. FILE ERROR CODE ON RPV FILE, CONTACT IDRS TECHNICIAN

    35. REQUEST CAN NOT BE SERVICED AT THIS TIME, TRY AGAIN LATER

    36. THE REQUESTED RPV ENTRY DOESN'T EXIST

    37. NO RECORDS MATCH THE CRITERIA SELECTED

    38. THE DEFINER CODE IS INVALID— The definer code must be spaces, SM, P or GR.

    39. THE SCREEN REQUESTED IS NOT AVAILABLE — CHECK INPUT

    40. INVALID PROCESSING YEAR. ONLY CURRENT YEAR AND 3 PRIOR YEARS ARE VALID

    41. PAGING ERROR HAS OCCURRED — TRY ENTERING ORIGINAL TRANSACTION AGAIN

    42. PAGE NUMBER IS INVALID. PAGE NUMBER 1 ASSUMED

    43. GROUP NUMBER IS INVALID. GROUP NUMBER 1 ASSUMED

2.3.63.4  (03-20-2006)
Command Code RPPRT

  1. This command code is accessed with the same inputs as command code RPVUE with the exception of the definer.

  2. Reports are generated weekly. If no information matches the request, the user will be notified on-line.

  3. The following informational messages for CC RPPRT can be found on lines 14 and 15:

    1. NAP INFORMATION NOT FOUND— The National Accounts Profile (NAP) did not find any information for the TIN that was input.

    2. NAP VSAM FILE UNAVAILABLE— The National Accounts Profile (NAP) was not available, try again later.

    3. NAP PUT FUNCTION UNSUCCESSFUL

    4. SEVERE ERROR ACCESSING NAP FILE

    5. NAP DATA OUT OF SEQUENCE

    6. EOF REACHED

    7. SOC7 OCCURRED — CONTACT IDRS TECH

    8. REC FOUND WITH INSIGNIFICANT DATA

    9. INVALID REQUEST — CHECK INPUT

    10. MFT WHEN PRESENT MUST HAVE 2 CHARACTERS

    11. TAX PERIOD WHEN PRESENT MUST HAVE 6 CHARACTERS

    12. TXPYR TIN WHEN PRESENT MUST HAVE 11–12 CHARACTERS

    13. _____ 4–5 CHARACTERS

    14. DO WHEN PRESENT MUST HAVE 2 CHARACTERS

    15. MFT MUST BE CONSISTENT WITH FORM NUMBER

    16. FORM NUMBER IS INVALID — CHECK INPUT— The form number must be one of the following: 1040, 1041, 1065, 1120, 1120A or 1120S.

    17. DO CODE IS INVALID — CHECK INPUT— The district office code is not valid.

    18. THE TIN FIELD IS INVALID — CHECK INPUT— The TIN is not numeric or is not in the correct format.

    19. THE PTIN DOES NOT HAVE AN SSN ASSOCIATED WITH IT

    20. PROCESSING YEAR MUST BE > 1999 FOR PTINS

    21. THE MFT CODE MUST BE 02, 05, 06, 30

    22. THE TAX PERIOD MUST BE NUMERIC — CHECK INPUT

    23. THE RETURN INDICATOR MUST BE I OR B — CHECK INPUT

    24. THE TIN VALIDITY INDICATOR IS INCONSISTENT OR IN ERROR — CHECK INPUT— The display file source code must be space, * , V or W.

    25. THE PTIN FIELD IS INVALID — CHECK INPUT— The format for a PTIN is "P" followed by 8 numerics.

    26. NO RECORDS MATCH THE INPUT TIN. PTIN CROSS REFERENCE FILE NOT ACCESSIBLE

    27. XREF FILE UNAVAILABLE. ONLY INFO FOR INPUT TIN GIVEN. TRY AGAIN LATER

    28. PTIN XREF FILE ERROR, XREF FILE UNACCESSIBLE. ONLY INPUT TIN INFO AVAILABLE

    29. THERE ARE TOO MANY OPTIONAL FIELDS PRESENT— The maximum number of optional fields is 5.

    30. MAXIMUM RECORDS READ (20000). CHANGE SEARCH CRITERIA. COULD BE MORE MATCHES

    31. MAXIMUM RECORDS READ (20000). NO MATCH FOUND. CHANGE SEARCH CRITERIA

    32. FILE ERROR CODE ON RPV FILE, CONTACT IDRS TECHNICIAN

    33. REQUEST CAN NOT BE SERVICED AT THIS TIME, TRY AGAIN LATER

    34. THE REQUESTED RPV ENTRY DOESN'T EXIST

    35. FILE ERROR CODE ON WRITING FILE, CONTACT IDRS TECHNICIAN

    36. INVALID PROCESSING YEAR. ONLY CURRENT YEAR AND 3 PRIOR YEARS ARE VALID

    37. THIS REPORT HAS ALREADY BEEN REQUESTED. A SECOND REPORT WILL NOT BE PRINTED.

    38. INFORMATION FOR BOTH THE INPUT TIN AND THE ASSOCIATED TIN WERE FOUND

    39. INFORMATION WAS FOUND FOR THE INPUT TIN ONLY. INFORMATION WAS NOT FOUND FOR THE ASSOCIATED TIN.

    40. INFORMATION WAS FOUND FOR THE ASSOCIATED TIN ONLY. INFORMATION WAS NOT FOUND FOR THE INPUT TIN

Exhibit 2.3.63-1 
CC RPVCU, RPVUE and RPPRT Input Format

This screen represents all of the possible fields of the input request. Items 1 through 4 are required fields while the remaining fields are optional. The optional fields are followed by a comma. Missing optional fields are represented by a comma. Also note that items 7 and 8 can be variable lengths. The items following are positioned with items 7 and 8 being the maximum length.

This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–5 COMMAND CD —
RPVUE
RPVCU
RPPRT
2 1 7–10 PROCESSING YEAR —
ccyy (current year or 3 prior years)
3 1 11–21 TAX PREPAPER TIN—
nnn-nn-nnnn
nn-nnnnnnn
Pnnnnnnnn
4 1 22 TAX RETURN TYPE—
I (IMF)
B (BMF)
P (PTIN)
5 1 23–24 MFT CD –
30, 02, 05, or 06
6 1 26–31 TAX PRD —
ccyymm
7 1 33–43 TAXPAYER TIN —
nnn-nn-nnnn
nn-nnnnnnn
8 1 44 TAXPAYER TIN IND —
blank, *, V or W
9 1 46–50 FORM NUMBER –
1040, 1041, 1065, 1120, 1120A or 1120S
10 1 52–53 DISTRICT OFFICE CD —
nn

Note:

for returns filed after 01–01–2002 (PY2002) use the Universal Location Code (ULC) and for returns filed prior to 01–01–2002 (PY2001 and prior) use the old district office codes
11 1 54–58 TYPE OF RESPONSE CD —
Blank (Summary screen)
SM (Summary screen)
Pnnnn (Page request screen)
GRnnn (Group request screen)

Exhibit 2.3.63-2 
CC RPVUE, RPVCU and RPPRT Error Screen

This is the response screen layout used for displaying error messages for all RPVOL command codes.

This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–58 REQUEST RECORD–
Character
2 24 1–79 ERROR MESSAGE –
Character

Exhibit 2.3.63-3 
CC RPVUE and RPVCU Summary Screen

This response screen contains various counts of Tax Preparer summary information along with the number of pages or screens of information related to the request. The user can then request a specific page (or screen) or a specific group of pages (or screens).

This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–58 REQUEST RECORD — character
2 2 25–35 TAX PREPARER TIN —
nnn-nn-nnnn
nn-nnnnnnn
Pnnnnnnnn
3 2 65–68 RETURNS PREPARED COUNT —
numeric
4 3 25–35 CROSS REFERENCE TIN —
nnn-nn-nnnn
Pnnnnnnnn
5 5 1–35 PRIMARY NAME — character
6 5 36–70 SECONDARY NAME — character
7 6 1–35 STREET ADDRESS — character
8 6 37–58 CITY — character
9 6 60–61 STATE CD — character
10 6 64–73 ZIP CD—
nnnnn-nnnn
11 7 22–24 REFUND RETURNS PERCENT —
numeric
12 7 63–66 REFUND RETURNS COUNT —
numeric
13 8 22–24 EIC PERCENT — numeric
14 8 63–66 EIC COUNT — numeric
15 9 18–21 PROCESSING YEAR — character
16 13 20–23 TOTAL PAGE COUNT — numeric
17 14 21–23 TOTAL GROUP COUNT — numeric
18 24 1–79 ERROR MESSAGE — character

Exhibit 2.3.63-4 
CC RPVUE and RPVCU Page or Group Screen

This response screen is used to display taxpayer information for a given tax preparer. One page is equivalent to one screen. Each page of the multiple page screen or group screen has a layout identical to the single page request. One group is equivalent to 20 pages or screens.

Note:

Money amounts are only for IMF returns.

This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–58 REQUEST RECORD — character
2 1 68–71 PAGE NUMBER — character
3 1 76–79 TOTAL PAGE COUNT— character
4 3,8,13,18 9–19 TAXPAYER TIN — character
5 3,8,13,18 26–27 MFT CD — character
6 3,8,13,18 37–42 TAX PRD— character
7 3,8,13,18 49–65 DLN — character
8 3,8,13,18 75–76 GROUP CODE — character
9 4,9,14,19 7–17 BALANCE DUE OR REFUND AMT — numeric
10 4,9,14,19 27–37 ACCEPTABLE TOTAL TAX AMT — numeric
11 4,9,14,19 51–61 TAXABLE INCOME AMT — numeric
12 4,9,14,19 69–79 SCHEDULE F PROFIT LOSS AMT — numeric
13 5,10,15,20 7–17 EARNED INCOME CREDIT AMT — numeric
14 5,10,15,20 27–37 GAS CREDIT AMT — numeric
15 5,10,15,20 51–61 TOTAL CONTRIBUTIONS AMT— numeric
16 5,10,15,20 69–79 SCHEDULE C PROFIT LOSS AMT — numeric
17 6,11,16,21 7–17 JOB EXPNS N MISC DEDUCTNS AMT — numeric (job expense and miscellaneous deductions amount
18 6,11,16,21 27–37 TOT RNTL N RYLTY INCM LOSS AMT — numeric (total rental real estate and royalty income/loss amount)
19 6,11,16,21 51–61 PTRNSHP S CORP INCM LOSS AMT — numeric (partnership and S corporation income/loss amount)
20 24 1–79 ERROR MESSAGE — character

Exhibit 2.3.63-5 
CC RPPRT Acknowledgment Screen

This screen gives the user a confirmation message when the information is found or an error message when the information is not found.

This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–53 REQUEST RECORD — character
2 3 15–25 TAX PREPARER TIN — character
3 6 1–35 PRIMARY NAME — character
4 7 1–35 SECONDARY NAME — character
5 8 1–35 STREET ADDRES S — character
6 9 1–22 CITY — character
7 9 27–28 STATE CD — character
8 9 33–42 ZIP CD — nnnnn-nnnn
9 11 18–21 PROCESSING YEAR — numeric
10 13 1–79 VERIFICATION MESSAGE— character
11 14 1–79 CONFIRMATION MESSAGE/ERROR MESSAGE — character
12 15 1–79 CONFIRMATION MESSAGE (cont.) — character

Exhibit 2.3.63-6 
CC RPVUE PTIN information Screen

This screen gives the information to the user about the PTIN entered.

This image is too large to be displayed in the current screen. Please click the link to view the image.
This image is too large to be displayed in the current screen. Please click the link to view the image.

Record Element Specification

Item Number Line Col. Description and Validity
1 1 1–53 REQUEST RECORD — character
2 2 15–25 TAX PREPARER TIN — character
3 2 57–66 PTIN NUMBER ISSUANCE DATE— character
4 3 17–27 ASSOCIATED TIN— number
5 3 57–61 PTIN STATUS— character, some of the statuses are Provisional/Active
6 5 1-60 PERMANENT MAILING ADDRESS NAME — character
7 5 62-65 PERMANENT MAILING ADDRESS SUFFIX— character
8 6 1-30 PERMANENT MAILING ADDRESS,ADDRESS LINE1— character
9 7 1-40 PERMANENT MAILING ADDRESS ADDRESS LINE2— character
10 7 41-40 PERMANENT MAILING ADDRESS ADDRESS LINE3— character
11 8 1-20 PERMANENT MAILING ADDRESS CITY— character
12 8 27-28 PERMANENT MAILING ADDRESS STATE— character
13 8 42-51 PERMANENT MAILING ADDRESS COUNTRY— character
14 9 17-26 SUSPENSION START DATE — character
15 9 42-51 SUSPENSION END DATE — character
16 10 10-19 PHONE NUMBER — number
17 10 28-31 EXTENSION — number
18 10 39-48 DATE OF BIRTH — character
19 11 13-52 E-MAIL ADDRESS — character
20 12 9-15 EFIN # — number
21 12 25-34 CAF # — number
22 12 38-46 SUPERVISOR PTIN — character
23 12 66 SUPERVISED PREPARATION? — character
24 13 13 OFFICE OWN? — character
25 13 33 TAX COMPLIANCE ISSUES?— character
26 13 50 1040 FILER? — character
26 13 77 FELONY? — character
27 14 18 CHECKS TAX COMPLIANCE?— character
28 14 29 CHECKS BACK GROUND? — character
29 14 39 CHECKS TEST? — character
30 14 53 CHECKS SDN LIST? — character
31 14 69 CHECKS RESTRICTED? — character
32 15 20-80 PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE1— character
33 16 1-45 PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE2— character
34 18 1-8 BUSINESS INFORMATION EIN— number
35 19 1-64 BUSINESS INFORMATION NAME — character
36 20 1-29 BUSINESS INFORMATION ADDRESS LINE 1 — character
37 20 33-72 BUSINESS INFORMATION ADDRESS LINE 2 — character
38 21 33-72 BUSINESS INFORMATION ADDRESS LINE 3 — character
39 22 1-19 BUSINESS INFORMATION CITY — character
40 22 23-24 BUSINESS INFORMATION STATE — character
41 22 27-36 BUSINESS INFORMATION ZIP — character
42 22 39-41 BUSINESS INFORMATION COUNTRY — character
43 23 19-34 BUSINESS INFORMATION PHONE— number
44 23 38-41 BUSINESS INFORMATION EXTENSION — number
45 13
14
19-78
19-58
Business web site associated with the preparer’s PTIN account — character
46 14 13-22 FILE NUMBER
47 14 43-52 PTIN Renewal Date (most recent date on which PTIN was renewed) — date
48 14 54-68 PTIN Expiration Date (displays if PTIN status is “Expired”)— date
49 15 21-30 Certificate Issuance Date Associated with an account— date
50 15 46-55 RTRP License Proficiency (RTRP/SP40/ PTIN/Null) — character
51 16 18 Competency Test Pass (P/F/NULL) — character
52 16 37 Background Check Exempt (Y/N/Null) — character
53 17 17 The registration method associated with a preparers registration (P/O) — character
54 17 36 The renewal method associated with a preparers most recent renewal (P/O/NULL) — character
55 18 21-23 Credit hours for the "Federal Tax Law" continuing education category — character
56 19 21-23 Credit hours for the "Federal Tax Law Updates" continuing education category — character
57 20 21-23 Credit hours for the "Tax-Related Ethics" continuing education category — character
58 24 1–79 ERROR MESSAGE IF THE SYSTEM COMES ACROSS ANY ISSUES.

More Internal Revenue Manual