Skip to Content
Technical Articles

Cloud For Customer Utilities – Extend Utilities Financial

Any coding or configuration examples provided in this document are only examples and are NOT intended for use in a productive system. The example is only done to better explain and visualize the topic.

The objective of this blog is to share the details required to extend C4C Utilities Online UIs. Specifically in this blog,we will focus on UIs and scenario related to Utilities Financials.

Please refer the following blogs to know the steps involved for extensibility

Scope of this Blog is to give required details for extending Utilities Financial’s Scenarios & UIs-:-

  1. Extending Utilities Financial
    1. Invoices
    2. Payments
    3. Open Items
    4. Installment Plan
    5. Payment Plan
    6. Promise To Pay

1. Extending Utilities Financial 

Utilities Financial is available in below places.

  • Customer / Account (TI) – Utilities Financial(Facet)

For Extending “Utilities Financial” following node needs to be extended.

  • Header Area – OverviewAccountBalance

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node OverviewAccountBalance{
		[Label("Financial Header Info")] element Ext_Fin_Header_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
        } 
} 

Targeted UI Details –

Exceptions UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesFinancialAccountOverview

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)

1.1 Invoices

Invoices is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Invoices (Table)

For Extending “Utilities Financial – Invoices” following nodes need to be extended.

  • Invoices -:- Invoices
  • Billing Documents -:- Invoices-UtilitiesFinancialBillingDocuments
  • Contract Overview -:- Invoices-FinancialContractOverview
  • Simulated Document -:- Invoices-SimulatedFinancialDocument

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node Invoices{
		[Label("Invoices Additional Info")] element Ext_Invoices_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
      		node FinancialContractOverview {
			[Label("Financial Contract Overview ")] element Ext_FinConOverview_Info	:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
      		node UtilitiesFinancialBillingDocuments {
			[Label("Billing Documents Info")] element Ext_Bill_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
      		node SimulatedFinancialDocument {
			[Label("Simulated Document Info")] element Ext_Sim_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
        } 
} 

Targeted UI Details –

Invoices UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesFinancialAccountOverview

Actions –

  • Full Reversal -:- UtilitiesFullReversal
  • Adjustment Reversal -:- UtilitiesAdjustmentReversal
  • Rebill -:- UtilitiesFinancialRebill
  • One Time Payment -:- UtilitiesFinancialActionsBADI
  • Invoice Now, Bill Now, Invoice Simulation, Bill and Invoice, Submit MR -:- UtilitiesCreateBillingActions

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)

Action Services -:-

  • Invoice Now, Bill Now, Invoice Simulation, Bill and Invoice, Submit MR – COD_UTILITIES_CR_BILL_ACTION(ECC) / ISU_C4C_CR_BILL_ACTION(S/4 HANA)
  • Full Reversal – COD_UTILITIES_BICO_REVERSE(ECC) / ISU_C4C_BICO_REVERSE(S/4 HANA)
  • Adjustment Reversal – COD_UTILITIES_BICO_REVERSE_ADJ(ECC)/ ISU_C4C_BICO_REVERSE_ADJ(S/4 HANA)
  • Rebill – COD_UTILITIES_BICO_REBILL(ECC)/ ISU_C4C_BICO_REBILL(S/4 HANA)
  • OneTimePayment –
    • New Bank Save – COD_UTIL_BANK_PAYMENT_METHOD(ECC)/ ISU_C4C_BANK_PAYMENT_METHOD(S/4 HANA)
    • Submit Onetime Payment – COD_UTIL_ONETIMEPAY_MODIFY(ECC) / ISU_C4C_UTIL_ONETIMEPAY_MODIFY(S/4 HANA)

1.2 Payments

Payments is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Payments(Table)

For Extending “Utilities Financial – Payments” following node needs to be extended.

  • Payments – Payments

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node Payments{
		[Label("Payment Additional Info")] element Ext_Payment_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
        } 
} 

Targeted UI Details –

Payments UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesFinancialAccountOverview

Action(Cancel Payment) – UtilitiesFinancialActionsBADI

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)

Action(Cancel Payment) Service – COD_UTIL_SCHED_PAYMENTS_MODIFY(ECC) / ISU_C4C_SCHED_PAYMENTS_MODIFY(S/4 HANA)

1.3 Open Items

Open Items is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Open Items (Table)

For Extending “Utilities Financial – Open Items” following nodes need to be extended.

  • Open Items – OpenItems
  • Document Lock – OpenItems-FinancialDocumentLocks

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node OpenItems {
		[Label("Open Item Additional Info")] element Ext_OpenItems_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
      		node FinancialDocumentLocks{
			[Label("Financial Doc Additional Info")] element Ext_Fin_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
        } 
} 

Targeted UI Details –

Open Items UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesFinancialAccountOverview

Actions

  • Create Locks – UtilitiesFinancialCreateLocks
  • Edit Locks – UtilitiesFinancialEditLocks
  • Delete Locks – UtilitiesFinancialDeleteLocks
  • Manual Posting  and Deferral – UtilitiesFinancialActionsBADI

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)

Action Services -:-

  • Create, Edit and Delete Locks – COD_UTILITIES_LOCKS(ECC) / ISU_C4C_LOCKS(S/4 HANA)
  • Manual Posting – COD_UTILITIES_MANUAL_POSTING(ECC) / ISU_C4C_MANUAL_POSTING(S/4 HANA)
  • Deferral – COD_UTIL_ACC_OVERVIEW_MODIFY(ECC) / ISU_C4C_ACC_OVERVIEW_MODIFY(S/4 HANA)

1.4 Installment Plan

Installment Plan is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Installment Plan (Table)

For Extending “Utilities Financial – Installment Plan” following nodes need to be extended.

  • Installment Plan -:- InstallmentPlan
  • Installments -:- InstallmentPlan-FinancialInstallments

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node InstallmentPlan{
		[Label("Installment Plan Additional Info")] element Ext_InstallmentPlan_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
      		node FinancialInstallments{
			[Label("Installments Additional Info")] element Ext_Installments_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
        } 
} 

Targeted UI Details –

Installment Plan UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesFinancialAccountOverview

Action – UtilitiesInstallmentPlan

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)

Action Service – COD_UTILITIES_INSTALLMENT_PLAN(ECC)/ ISU_C4C_INSTALLMENT_PLAN(S/4 HANA)

1.5 Payment Plan

Payment Plan is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Payment Plan (Table)

For Extending “Utilities Financial – Payment Plan” following nodes need to be extended.

  • Contract Details-:- BudgetBillingContracts (Table during Create Action)
  • Payment Plan -:- BudgetBillingContracts-BudgetBillingPaymentPlan
  • Payment Plan Item -:- BudgetBillingContracts-BudgetBillingPaymentPlan-BudgetBillingPaymentPlanItem

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node BudgetBillingContracts {
		[Label("BB Contract Info")] element Ext_BB_Contract_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
      		node BudgetBillingPaymentPlan{
			[Label("BB Plan Info")] element Ext_BB_Plan_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
                        node BudgetBillingPaymentPlanItem{
			        [Label("BB Plan Item Info")] element Ext_BB_Plan_Item_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	         }   
      	    } 
        } 
} 

Targeted UI Details –

Payment Plan UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_BUDGET_BILLING_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read -:- UtilitiesBudgetBillingOverview

Action -:- UtilitiesBudgetBillingActions

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_BUDGET_BILLING(ECC)/ ISU_C4C_BUDGET_BILLING(S/4 HANA)

Action Service – COD_UTILITIES_BUDGET_BILLING(ECC)/ ISU_C4C_BUDGET_BILLING(S/4 HANA)

1.6 Promise To Pay

Promise To Pay is available in below place.

  • Customer / Account (TI) – Utilities Financial(Facet) – Promise To Pay(Table)

For Extending “Utilities Financial – Promise To Pay” following nodes need to be extended.

  • Promise To Pay – PromisetoPay
  • P2P Payment Deadline- PromisetoPay-P2PPaymentDeadlines

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node PromisetoPay{
		[Label("Promise to Pay Additional Info")] element Ext_P2P_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
      		node P2PPaymentDeadlines{
			[Label("P2P Payment Info")] element Ext_P2P_Deadline_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
      	    } 
        } 
} 

Targeted UI Details –

Promise To Pay UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_PROMISE_PAY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesP2PGet

Action – UtilitiesP2PModify

ISU Side Web Service Details – 

Read Service – ISU_C4C_PROMISE2PAY_GET(S/4 HANA)

Action Service – ISU_C4C_PROMISE2PAY_MODIFY(S/4 HANA)

Be the first to leave a comment
You must be Logged on to comment or reply to a post.