HUD will use this site to provide technical updates for PHA personnel and vendors responsible for interfacing with the future modernized IMS/PIC system.

Request for 50058 Software Vendor Contact Information

HUD is working on refining its list of 50058 software vendor contact information. Send us a message with the subject line "50058 software vendor mailing list update" to let us know the name of your company and the email address(es) that you would like to be included on our mailing list for future HIP (and possibly PIH system) vendor calls and other 50058 software communications related to HIP. If you are a PHA that builds your own 50058 software, please let us know that. If you wish to be updated about HIP in general, you do not need to send us an email at this time.

Third Party Vendor Testing Information for HIP

Requesting Permission to Test and System Access

• (UPDATED) Interconnection Security Agreement (ISA) and Memorandum of Understanding (MOU) - software vendors wanting to participate in testing will be required to first complete a new ISA and MOU agreement. In order to ensure that you receive information we send out regarding HIP and testing, please make sure you have first requested to be added to our 50058 software vendor mailing list as detailed at the top of this page. Please contact the HIP team at HUDITVendorComms@HUD.gov with your company name and the words "request to complete ISA and MOU agreement" (e.g., Softwareville request to complete ISA/MOU agreement) in the subject line. We will provide each vendor with the instructions for completing the ISA and MOU agreements. You can also view information about the ISA and MOU agreement process. Once the ISA and MOU agreement is signed by HUD, you will be able to use the information below to let HUD know which users we need to provision user accounts for so that they can access the HIP test environment.
• (UPDATED) The User Access Request spreadsheet should only be used to provide information about users requiring access once the ISA and MOU has been signed by HUD or to add, reactivate, or remove users for those software vendors that are already testing. Whenever submitting this file, please provide a list of dates in the body of your email within a week of your email that the users will be available. The link in the email the user will receive to set up their password is only valid for 24 hours.
• Accessing the HIP community portal and password resets
• Navigating the System

Technical Information

• The HIP team will provide the technical information for how to connect to the test environment to a software vendor when their access is approved.
• HUD-50058 and HUD-50058 MTW Expansion special program codes for line 2n
• JSON Mapping (as of 12/13/23) - this file contains three tabs. One is for the mapping of the 2020 version of the 50058 forms. The other two are for the 2024 version of the 50058 forms. There are notes at the top of each tab that describe the contents of the tab.
• List of error codes being used in HIP to validate 50058 submissions (as of 12/13/23). This file contains two tabs - one for the error codes that validate the 2020 version of the 50058 forms and the other for the error codes that validate the 2024 version of the forms. Please read the introduction tab as this provides information about the tabs, including that the 2024 version of the forms are still under development.

Technical Reference Guide (TRG)

• Technical Reference Guide (TRG) for the 2024 version of the 50058 forms dated 12/13/23
  • Changes made to the TRG for the 2024 version of the forms - this list of cumulative of all changes made since the original posting on 10/06/23
• Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 12/13/23
  • Changes made to the TRG for the 2020 version of the forms - this list of cumulative of all changes made since the original posting on 12/22/20
• Previous versions of the TRG for the 2024 version of the 50058 forms:
  • Technical Reference Guide (TRG) for the 2024 version of the 50058 forms dated 10/06/23
• Previous versions of the TRG for the 2020 version of the 50058 forms:
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 10/06/23
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 07/21/23
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 10/25/22
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 09/27/22
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 03/14/22
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 08/20/21
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 06/25/21
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 06/15/21
  • Technical Reference Guide (TRG) for the 2020 version of the 50058 forms dated 12/22/20

Information for Testing

• Housing Information Portal (HIP) IT Vendor UAT Overview (Added 02/10/23)
• Sample Test Scripts – examples of 50058 submissions that could be used for testing (Added 02/07/23)
• Sample JSON Files for MTW Expansion and Regular 50058s (Added 04/01/22)

The sample JSON files are provided to give an example of how a basic JSON file would be formatted. Due to personally identifiable information (PII), if these files are going to be used for testing, you will need to provide a dummy SSN and it is suggested that you also change other details for the household members. In the near future, we will include a sample of a bulk submission file, but for now these files are only for the submission of one household.

IT Vendor Call Materials

• February 8, 2023 IT Vendor Call Slides (Added 02/10/23)
• January 2022 IT Vendor Call Slides (Added 01/31/22)
• May 2021 IT Vendor Call Slides (Added 05/26/21)
• April 2021 IT Vendor Call Slides (Added 04/28/21)
• March 2021 IT Vendor Call Slides (Added 03/31/21)

Questions or Comments?

Last updated June 27, 2024