CRM and CX Blogs by SAP
Stay up-to-date on the latest developments and product news about intelligent customer experience and CRM technologies through blog posts from SAP experts.
cancel
Showing results for 
Search instead for 
Did you mean: 
1,979
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)