Show TOC

Procedure documentationConfiguring Invoices, Invoice PDFs, and Contract Account Balances for OData Consumption

Procedure

Invoices

You can use the Biller Direct functionality to retrieve invoices from the SAP ERP system. This allows customers to see invoices detailing their energy consumption. The API behind this retrieval is GEN_EBPP_GET_DATA. This API retrieves lists of invoices generically for various industries and SAP components.

For this API to work, you must maintain the following Customizing:

  1. You must start an interval for number range object EBPP_EVENT using transaction SNRO.

  2. You must maintain basic Customizing using the Settings for Customer Portal in the Internet activity underStart of the navigation path SAP Utilities Next navigation step Customer Service Next navigation step SAP Multichannel Foundation for Utilities Next navigation step Biller Direct End of the navigation path.

  3. In transaction FQEVENTS for event 1231(Biller Direct: Group Items for Display), the following IS-U function module has to be activated: ISU_GET_ITEMS_1231.

    The ISU_GET_ITEMS_1231 API performs the calculation of remaining amounts and compares the amounts in the IS-U invoice document and the FI-CA posted documents for customer payments.

    There is additional information describing the Biller Direct functionality in the Configuration of SAP Biller Direct for FI-CA documentation. It can be found in the SAP Library at http://help.sap.com/erp2005_ehp_04/helpdata/en/2c/1f34f19abb324bbb2e6683f9bb4f9e/frameset.htmInformation published on SAP site.

Invoice PDFs

You can use the Biller Direct API GEN_EBPP_GET_INVOICE_DETAIL in the SAP ERP system to retrieve an invoice PDF. This API performs generic retrievals of invoice PDFs for various industries and components.

In this API, BAdI FIS_INVOICEDETAIL is used. This BAdI has several SAP-delivered implementations. One of them is specifically for IS-U: ISU_INVOICEDETAIL.

This implementation searches the archive for invoices and tries to retrieve invoice PDFs using ISU_GET_INVOICES_PDF_RAW. If this implementation doesn’t satisfy the business requirements, a new BAdI implementation can be created. For testing purposes, when there is no archive for invoices, you can create a BAdI implementation where the ISU_GET_PDF_FILE API can be used to retrieve a simulated PDF document. This can only be used for testing since PDF simulation is time-consuming and shouldn’t be used in a production environment.

Contract Account Balances

The contract account balance is calculated based on Biller Direct API GEN_EBPP_GET_DATA in the SAP ERP system. The balance is retrieved from the returning structure E_CREDITS.

Since displayed invoices, balances, and PDF files can be customer-specific, OData entity implementations can easily be enhanced following the extensibility guidelines for SAP Multichannel Foundation for Utilities.