Part 2. Information Technology
Chapter 3. IDRS Terminal Responses
Section 63. Command Codes RPVUE, RPVCU, and RPPRT
2.3.63 Command Codes RPVUE, RPVCU, and RPPRT
Manual Transmittal
July 31, 2023
Purpose
(1) This transmits revised IRM 2.3.63, IDRS Terminal Responses, Command Codes RPVUE, RPVCU and RPPRT.
Material Changes
(1) IRM 2.3.63.1, updated Internal Controls for this IRM.
Effect on Other Documents
IRM 2.3.63, dated August 15, 2017, is superseded.
Audience
LMSB, SBSE, TEGE, Return Preparer Office, and W&I.
Effective Date
(07-31-2023)
Kaschit Pandya,
Acting, Chief Information Officer
Program Scope and Objectives
(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) Purpose: This transmits revised IRM 2.3.63, IDRS Terminal Responses, Command Codes RPVUE, RPVCU and RPPRT.
(3) Audience: LMSB, SBSE, TEGE, Return Preparer Office, and W&I.
(4) Policy Owner: Kaschit Pandya, Acting Chief Information Officer
(5) Program Owner: Application Development, Corporate Data in Information Technology
(6) Primary Stakeholders: Wage and Investment and Return Preparer’s Office
(7) Program Goals: The goal of the program is to provide support to Return Preparer’s office to improve tax payer compliance by providing comprehensive oversight and support of tax professionals
Background
(1) IRS Return Preparer Office was created in 2010 to oversee registration and suitability of federal tax return preparers.
Responsibilities or Roles and Responsibilities
(1) Return Preparer’s Office personnel responsible for monitoring and tracking the return preparer’s activity using the command codes RPVUE, RPVCU, and RPPRT.
(2) Applications Development is responsible for Operations and Maintenance of the command codes.
Program Management and Review
(1) Program Reports: RPVOL information stored in the database located at MCC is the primary source of information required for Return Preparer’s Office.
(2) Program Effectiveness: N/A
Terms/Definitions/Acronyms
(1) The following table provides common acronyms throughout this IRM:
Acronym | Definition |
|---|---|
ITM | Integrated Talent Management |
IRTF | Individual Return Transactions File |
BRTF | Business Return Transactions File |
BMF | Business Master File |
IMF | Individual Master File |
RPO | Return Preparer’s Office |
W&I | Wage and Investment |
PTIN | (Return) Preparer Tax Identification Number |
SIDN | Site Identifications Number - used in place of a PTIN to query information |
MCC | Martinsburg Computing Center |
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:
NAP INFORMATION NOT FOUND— The National Accounts Profile (NAP) did not find any information for the TIN that was input.
NAP FILE UNAVAILABLE— The National Accounts Profile (NAP) was not available, try again later.
NAP PUT FUNCTION UNSUCCESSFUL
SEVERE ERROR ACCESSING NAP FILE
NAP DATA OUT OF SEQUENCE
EOF REACHED
SOC7 OCCURRED — CONTACT IDRS TECH
REC FOUND WITH INSIGNIFICANT DATA
INVALID REQUEST — CHECK INPUT
MFT WHEN PRESENT MUST HAVE 2 CHARACTERS
TAX PERIOD WHEN PRESENT MUST HAVE 6 CHARACTERS
TXPYR TIN WHEN PRESENT MUST HAVE11–12 CHARACTERS
FORM NUMBER WHEN PRESENT MUST HAVE 4–5 CHARACTERS
DO WHEN PRESENT MUST HAVE 2 CHARACTERS
DEFINER WHEN PRESENT MUST HAVE 2–5 CHARACTERS
MFT MUST BE CONSISTENT WITH FORM NUMBER
FORM NUMBER IS INVALID – CHECK INPUT — Form number must be one of the following: 1040, 1041, 1065, 1120, 1120A or 1120S.
DO CODE IS INVALID — CHECK INPUT— The district office code is not valid.
THE TIN FIELD IS INVALID — CHECK INPUT— The TIN is not numeric or is not in the correct format.
THE PTIN DOES NOT HAVE AN SSN ASSOCIATED WITH IT
PROCESSING YEAR MUST BE > 1999 FOR PTINS— PTIN's did not exist prior to the year 2000.
THE MFT CODE MUST BE 02, 05, 06, 30
THE TAX PERIOD MUST BE NUMERIC — CHECK INPUT
THE RETURN INDICATOR MUST BE I OR B — CHECK INPUT
THE TIN VALIDITY INDICATOR IS INCONSISTENT OR IN ERROR — CHECK INPUT— The display file source code must be space, *, V or W.
THE PTIN FIELD IS INVALID – CHECK INPUT — The format for a PTIN is "P" followed by 8 numerics.
NO RECORDS MATCH THE INPUT TIN. PTIN CROSS REFERENCE FILE NOT ACCESSIBLE
XREF FILE UNAVAILABLE. ONLY INFO FOR INPUT TIN GIVEN. TRY AGAIN LATER
PTIN XREF FILE ERROR, XREF FILE UNACCESSIBLE. ONLY INPUT TIN INFO AVAILABLE
THERE ARE TOO MANY OPTIONAL FIELDS PRESENT.— The maximum number of optional fields is 5.
TOO MANY RECORDS - NARROW SCOPE OF SEARCH
MAXIMUM RECORDS READ (20000). CHANGE SEARCH CRITERIA. COULD BE MORE MATCHES
MAXIMUM RECORDS READ (20000). NO MATCH FOUND. CHANGE SEARCH CRITERIA
FILE ERROR CODE ON RPV FILE, CONTACT IDRS TECHNICIAN
REQUEST CAN NOT BE SERVICED AT THIS TIME, TRY AGAIN LATER
THE REQUESTED RPV ENTRY DOESN'T EXIST
NO RECORDS MATCH THE CRITERIA SELECTED
THE DEFINER CODE IS INVALID— The definer code must be spaces, SM, P or GR.
THE SCREEN REQUESTED IS NOT AVAILABLE — CHECK INPUT
INVALID PROCESSING YEAR. ONLY CURRENT YEAR AND 3 PRIOR YEARS ARE VALID
PAGING ERROR HAS OCCURRED — TRY ENTERING ORIGINAL TRANSACTION AGAIN
PAGE NUMBER IS INVALID. PAGE NUMBER 1 ASSUMED
GROUP NUMBER IS INVALID. GROUP NUMBER 1 ASSUMED
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:
NAP INFORMATION NOT FOUND— The National Accounts Profile (NAP) did not find any information for the TIN that was input.
NAP VSAM FILE UNAVAILABLE— The National Accounts Profile (NAP) was not available, try again later.
NAP PUT FUNCTION UNSUCCESSFUL
SEVERE ERROR ACCESSING NAP FILE
NAP DATA OUT OF SEQUENCE
EOF REACHED
SOC7 OCCURRED — CONTACT IDRS TECH
REC FOUND WITH INSIGNIFICANT DATA
INVALID REQUEST — CHECK INPUT
MFT WHEN PRESENT MUST HAVE 2 CHARACTERS
TAX PERIOD WHEN PRESENT MUST HAVE 6 CHARACTERS
TXPYR TIN WHEN PRESENT MUST HAVE 11–12 CHARACTERS
FORM NUMBER WHEN PRESENT MUST HAVE 4–5 CHARACTERS
DO WHEN PRESENT MUST HAVE 2 CHARACTERS
MFT MUST BE CONSISTENT WITH FORM NUMBER
FORM NUMBER IS INVALID — CHECK INPUT— The form number must be one of the following: 1040, 1041, 1065, 1120, 1120A or 1120S.
DO CODE IS INVALID — CHECK INPUT— The district office code is not valid.
THE TIN FIELD IS INVALID — CHECK INPUT— The TIN is not numeric or is not in the correct format.
THE PTIN DOES NOT HAVE AN SSN ASSOCIATED WITH IT
PROCESSING YEAR MUST BE > 1999 FOR PTINS
PROCESSING YEAR MUST BE > 1999 FOR PTINS— PTIN's did not exist prior to the year 2000.
THE MFT CODE MUST BE 02, 05, 06, 30
THE TAX PERIOD MUST BE NUMERIC — CHECK INPUT
THE RETURN INDICATOR MUST BE I OR B — CHECK INPUT.
THE TIN VALIDITY INDICATOR IS INCONSISTENT OR IN ERROR — CHECK INPUT— The display file source code must be space, *, V or W
THE PTIN FIELD IS INVALID — CHECK INPUT— The format for a PTIN is "P" followed by 8 numerics.
NO RECORDS MATCH THE INPUT TIN. PTIN CROSS REFERENCE FILE NOT ACCESSIBLE
XREF FILE UNAVAILABLE. ONLY INFO FOR INPUT TIN GIVEN. TRY AGAIN LATER
PTIN XREF FILE ERROR, XREF FILE UNACCESSIBLE. ONLY INPUT TIN INFO AVAILABLE
THERE ARE TOO MANY OPTIONAL FIELDS PRESENT— The maximum number of optional fields is 5.
MAXIMUM RECORDS READ (20000). CHANGE SEARCH CRITERIA. COULD BE MORE MATCHES
MAXIMUM RECORDS READ (20000). NO MATCH FOUND. CHANGE SEARCH CRITERIA
FILE ERROR CODE ON RPV FILE, CONTACT IDRS TECHNICIAN
REQUEST CAN NOT BE SERVICED AT THIS TIME, TRY AGAIN LATER
THE REQUESTED RPV ENTRY DOESN'T EXIST
FILE ERROR CODE ON WRITING FILE, CONTACT IDRS TECHNICIAN
INVALID PROCESSING YEAR. ONLY CURRENT YEAR AND 3 PRIOR YEARS ARE VALID
THIS REPORT HAS ALREADY BEEN REQUESTED. A SECOND REPORT WILL NOT BE PRINTED.
INFORMATION FOR BOTH THE INPUT TIN AND THE ASSOCIATED TIN WERE FOUND
INFORMATION WAS FOUND FOR THE INPUT TIN ONLY. INFORMATION WAS NOT FOUND FOR THE ASSOCIATED TIN.
INFORMATION WAS FOUND FOR THE ASSOCIATED TIN ONLY. INFORMATION WAS NOT FOUND FOR THE INPUT TIN
CC RPVCU, RPVUE and RPPRT Input Format
(1) 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.
(2) Record Element Specification
Item Number | Line | Col. | Description and Validity |
|---|---|---|---|
1 | 1 | 1–5 | COMMAND CD — |
2 | 1 | 7–10 | PROCESSING YEAR — |
3 | 1 | 11–21 | TAX PREPAPER TIN— |
4 | 1 | 22 | TAX RETURN TYPE— |
5 | 1 | 23–24 | MFT CD – |
5 | 1 | 23-27 | The same field can be either MFT CD or Page Number or Group Number |
6 | 1 | 26–31 | TAX PRD — |
7 | 1 | 33–43 | TAXPAYER TIN — |
8 | 1 | 44 | TAXPAYER TIN IND — |
9 | 1 | 46–50 | FORM NUMBER – |
10 | 1 | 52–53 | DISTRICT OFFICE CD — |
11 | 1 | 54–58 | TYPE OF RESPONSE CD — |
CC RPVUE, RPVCU and RPPRT Error Screen
(1) This is the response screen layout used for displaying error messages for all RPVOL command codes.
(2) Record Element Specification
Item Number | Line | Col. | Description and Validity |
|---|---|---|---|
1 | 1 | 1–58 | REQUEST RECORD– |
2 | 24 | 1–79 | ERROR MESSAGE – |
CC RPVUE and RPVCU Summary Screen
(1) 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).
(2) Record Element Specification
Item Number | Line | Col. | Description and Validity |
|---|---|---|---|
1 | 1 | 1–58 | REQUEST RECORD — character |
2 | 2 | 25–35 | TAX PREPARER TIN — |
3 | 2 | 65–68 | RETURNS PREPARED COUNT — |
4 | 3 | 25–35 | CROSS REFERENCE TIN — |
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— |
11 | 7 | 22–24 | REFUND RETURNS PERCENT — |
12 | 7 | 63–66 | REFUND RETURNS COUNT — |
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 |
CC RPVUE and RPVCU Page or Group Screen
(1) 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.
(2) 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 |
CC RPPRT Acknowledgment Screen
(1) This screen gives the user a confirmation message when the information is found or an error message when the information is not found.
(2) 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 |
CC RPVUE PTIN information Screen
(1) This screen gives the information to the user about the PTIN entered.
(2) 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 | Effective Date associated with the preparer’s most recent Record of Completion. — character |
15 | 9 | 42-51 | Completion Date associated with the preparer's most recent AFSP refresher course. — 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 | 13 | 13 | OFFICE OWN, Identification of Self-Employed/Owner/Corporate Officer response associated with the preparer’s PTIN account — character |
23 | 13 | 50 | 1040 FILER, Self-reported response for preparing Form 1040 series tax returns associated with the preparer’s PTIN account — character |
24 | 14 | 20 | SYS TX COMP CHECK, Tax Compliance Status associated with the preparer’s PTIN account— character |
25 | 14 | 52 | AFSP TX COMP CHECK EXEMPT, an indicator that says if the preparer is exempt from posessing a "Pass" Tax Compliance Check result— character |
26 | 14 | 78 | SELF ATTEST TX COMP, Self-reported tax compliance response associated with the preparer’s registration or renewal application— character |
27 | 15 | 20 | AFSP RES CRS EXMP, an indicator that says if the preparer is exempt from taking a Annual Federal Tax Refresher (AFTR) course for their AFSP Record of Completion. — character |
28 | 15 | 38 | AFSP INELIG, Ineligible List Status associated with the preparer’s PTIN account— character |
29 | 15 | 58 | RESTRICTED, Prevent PTIN Issuance List Status associated with the preparer’s PTIN account — character |
30 | 16 | 20-80 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE1— character |
31 | 17 | 1-75 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE2— character |
32 | 18 | 1-75 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE3— character |
33 | 19 | 1-75 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE4— character |
34 | 20 | 1-75 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE5— character |
35 | 21 | 1-75 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE6— character |
36 | 22 | 1-77 | PROFESSIONAL CREDENTIALS EXPIRATION DATE LINE7— character |
37 | 10 | 1-8 | BUSINESS INFORMATION EIN— number |
38 | 11 | 1-64 | BUSINESS INFORMATION NAME — character |
39 | 12 | 1-29 | BUSINESS INFORMATION ADDRESS LINE 1 — character |
40 | 12 | 33-72 | BUSINESS INFORMATION ADDRESS LINE 2 — character |
41 | 13 | 33-72 | BUSINESS INFORMATION ADDRESS LINE 3 — character |
42 | 14 | 1-19 | BUSINESS INFORMATION CITY — character |
43 | 14 | 23-24 | BUSINESS INFORMATION STATE — character |
44 | 14 | 27-36 | BUSINESS INFORMATION ZIP — character |
45 | 14 | 39-41 | BUSINESS INFORMATION COUNTRY — character |
46 | 15 | 19-34 | BUSINESS INFORMATION PHONE— number |
47 | 15 | 38-41 | BUSINESS INFORMATION EXTENSION — number |
48 | 16 | 19-78 | Business web site associated with the preparer’s PTIN account — character |
49 | 17 | 13-22 | FILE NUMBER |
50 | 17 | 43-52 | PTIN Renewal Date (most recent date on which PTIN was renewed) — date |
51 | 17 | 70-79 | PTIN Expiration Date (displays if PTIN status is “Expired”)— date |
52 | 18 | 21-30 | AFSP ISS, most recent AFSP Record of Completion issuance date associated with preparer's PTIN account.— date |
53 | 18 | 46-55 | AFSP PARTICIPANT, RTRP License Proficiency (RTRP/SP40/ PTIN/Null) — character |
54 | 19 | 18 | AFSP ROC READ, Flag that says if the preparer is exempt from taking a refresher course for their AFSP Record of Completion. (P/F/NULL) — character |
55 | 19 | 37 | AFSP FEL EXMP, this field indicates the notification status of an AFSP Record of Completion letter in a preparer's secure mailbox. |
56 | 19 | 78 | PREPARER OPT OUT PREPARER DIRECTORY, Self-reported response indicating whether or not the preparer has elected for their information to be included within or excluded from the preparer directory |
57 | 20 | 17 | The registration method associated with a preparers registration (P/O) — character |
58 | 20 | 36 | The renewal method associated with a preparers most recent renewal (P/O/NULL) — character |
59 | 21 | 21-23 | Credit hours for the "Federal Tax Law" continuing education category — character |
59 | 21 | 45-47 | Credit hours for the "Federal Tax Law Updates" continuing education category — character |
60 | 22 | 21-23 | Credit hours for the "Tax-Related Ethics" continuing education category — character |
61 | 23 | 19-28 | Reactivation Date — character |
62 | 23 | 51-60 | Status Change Date — character |
63 | 24 | 1–79 | ERROR MESSAGE IF THE SYSTEM COMES ACROSS ANY ISSUES. |
