Understanding Historical Usage (HU) transactions (867)¶
The Historical Usage (HU) transactions (867) file provides past meter usage data for a facility. This data is critical for consumption analysis, billing accuracy, and forecasting. It ensures that the system reflects accurate historical consumption values, enabling effective decision-making and compliance with utility requirements.
Configure and request Historical Usage (867) transactions¶
It outlines the steps to configure historical usage in the application, ensuring past meter readings are accurately recorded in the system. Proper configuration aligns the system records with utility-provided historical consumption data and supports accurate reporting, billing, and compliance.
Request historical consumption for an existing end User¶
Use these steps to manually request historical consumption data for an existing end user:
- Log in to the nGenue application.
- Click the search icon and type end user in the search bar.
-
Double-click on the End user in the search results to open the End user screen. This screen provides a detailed view of the selected end user’s profile, contracts, facilities, and transaction history.
-
Select the LDC, then click Load end users (includes inactive) button.
-
From the results, select the desired facility. A facility represents the specific location or meter point where gas consumption is recorded.
-
Click the Facility icon at the top center of the screen. This will open the Facility screen linked to the selected end user’s location.
- The Facility screen has two main sections: Facility selection and Facility details.
- In the Facility details screen, locate the Pending EDI actions grid:
- Right-click and select Add new EDI action for this facility. This initiates a new EDI transaction request for the facility.
- Select Historical consumption usage request from the dropdown list. This option tells the system to request past consumption data from the utility.
- Schedule the action date and click Accept. The action date determines when the system will send the request to the utility. Ensure the date is set according to your operational needs.
- Right-click and select Add new EDI action for this facility. This initiates a new EDI transaction request for the facility.
-
The EDI service process the request on the scheduled date. The system automatically packages the request into an EDI-compliant file format.
-
The system generates an outbound file and sends it to the utility.
- The Facility screen updates the EDI status to Awaiting response. This status indicates that the utility has received the request and the system is waiting for the return EDI file containing the historical consumption data.
Request historical consumption for a prospect¶
Follow these steps to request historical usage for a prospect record:
- Navigate to Quote engine screen.
- Load Prospect record.
- Select Historical Usage option.
- Click Request HU button.
- System automatically:
- Validates available prospect data
- Schedules the 814 request
- Generates a tracking ID
Historical Usage transaction processing¶
The following outlines how the system handles outbound and inbound historical usage requests and responses.
Outbound process (Supplier to utility)¶
This process outlines how the system sends historical usage requests to the utility:
- The request is added to the EDI Schedule.
- The EDI service processes it at the scheduled time.
- The system generates an outbound file in the specified format (e.g.,
C:/Data/Utility/Outbound/X12
). - Files are processed by 3 PM and transmitted to the utility by 4 PM (if using FTP).
- The file is sent via:
- Utility FTP
- utility website upload (depending on the communication method).
- The system creates an Activity log entry for tracking.
- The transaction appears in:
- Pending EDI actions (once pickup by the EDI server).
- Activity log (after triggering the request).
Inbound process (Utility to supplier)¶
This process explains how the system receives and processes the utility’s response:
- The utility sends an inbound 814 response file (acceptance/rejection).
-
The EDI service processes the inbound file from the FTP by:
- Decrypting and validating the file.
- If accepted:
- Updating the Historical Usage status to Accepted.
- Awaiting the 867 file containing historical data.
- If rejected:
- Recording the rejection in Activity log.
- Creating a review task.
-
The system moves processed files to thearchive.
Handling Historical Usage 867 file¶
These steps describe how the system processes and records historical usage data received from the utility:
- The utility sends an inbound 867 file containing historical usage data.
- The EDI service processes the file:
- validating and decrypting it.
- Updating the Monthly usage screen with the source labeled History.
- If processing succeeds:
- The Activity log confirms the data.
- The Facility screen updates the EDI status to Accepted.
- If processing fails
- The Activity log records the error.
- The system creates a review task.
Conclusion¶
Configuring historical usage ensures that the system maintains accurate past consumption records for each facility. This process supports correct billing, enables reliable forecasting, and maintains compliance with utility data requirements. Proper setup also streamlines future updates and minimizes the need for manual corrections.