Quantcast
Channel: SAP Cloud for Customer
Viewing all 262 articles
Browse latest View live

Document types for Activities in C4C -finetuning

$
0
0

The finetuning option ‘Maintain document types’ for activities is not visible in all cases.

 

s1.jpg

s2.jpg

 

You have to set the following scoping options in ‘integration into Sales, Service, and Marketing processes’.

 

s3.jpg

 

The reason behind is that if you have a CRM integration it might be required to configure separate document types for the activities and map them accordingly in the codelist mapping.

 

This option is not available in C4C without integration in order to keep the configuration simple.

 

This might be changed in a future release- I will update the blog once this dependency has changed.


Plan and Drive Targeted Activities for Consistent, Optimized Retail Execution

$
0
0

Last week, we provided an overview of our retail execution capabilities in C4C and how the entire process is centered around the visit, which the sales user performs at the customer site or any other location.

 

(In case you’d like to refer back to our first blog entry providing an overview on retail execution follow this link: http://scn.sap.com/community/cloud-for-customer/blog/2016/07/08/transform-your-visits-to-win-at-the-shelf-with-retail-execution-in-sap-hybris-cloud-for-customer)

 

This week, we’ll go more in depth in regards to our route planning capabilities that allow users to plan and generate mass visits in advance, as well as how activity plans and routing rules can be utilized to properly route desired tasks and surveys to visits.

 

Plan Your Visits Efficiently using Routes


In C4C, routes act as the single point of entry for visit planning. Users can create custom route plans for sales personnel or utilize templates to conveniently re-generate often used route plans.

 

Key Features


  • Organize list of accounts to be visited with
  • Addition of accounts by search / query
  • Suggested accounts based on due / overdue accounts with no current visits planned
  • Honor account/sales-area based visit frequency and recurrence when planning across proposed date ranges
  • Exclusions of days of the week from planning
  • Honor account-level visiting hours
  • Automatic rescheduling
  • Re-align correct start and end times automatically for all visits upon time value changes
  • Manage visit attendees in route
  • Generate mass visits from a route
  • Link to generated visits within route

 

Visit Proposal


When creating a route, users can utilize queries to specify accounts that need to be visited. When planning visits for accounts that are due to be visited for a specified date range, additional criteria such as sales area, region, classification and account types can be used to further narrow down the desired short list.


After the desired criteria is maintained, users can also initiate visit recurrence, such that the route will display the number of recurring visits that would prospectively occur in the proposed date range. If the accounts are then selected for addition to the route plan, the first visit will be added on the account visit due date, with each recurring visit being added based on the visit frequency maintained in the account.

 

Route - Visit Proposal.jpg

Validating Route before Visit Generation


After adding accounts to be visited to the route, the route will validate that the proposed date and time coincides with the account’s visiting hours or existing items on the user’s Calendar. If not, warnings are displayed onscreen to notify the user of any existing conflicts.

Route - Validations.png

 

Within the route, users can view a prospective driving route to be taken day by day, and make changes to the route taken directly in the map view. Using the up and down arrows, users will see the route changes and driving route reflected in real-time. After the map view is closed, the new desired route changes for the day will then be reflected in the route plan. 


Route - Map View.jpg

Users can also utilize a calendar preview to get an idea of the employee’s schedule before and after visits are generated from the route plan.

 

Route - Calendar.png

Planning and Routing Tasks/Surveys to Visits


Activity plans and routing rules are used to determine what tasks and surveys sales representatives should expect within their visits.  Desired tasks are defined directly within the activity plan, while valid and active surveys are added. Notes and attachments maintained at the task level within the activity plan are also transferred to the tasks once they are determined for a visit.

 

Within the activity plan, administrators can maintain tasks of one-time frequency. While by default, tasks are determined each time, tasks can be designated for one-time execution per account. Once the one-time task has been completed, all future visits for that account will no longer contain the task; however, if the visit containing the one-time task is cancelled, or the visit is completed without completing the one-time task, the task is then moved to an existing future visit within the validity date range, or awaits in the system for another visit to be determined. Upon transfer of the one-time task, characteristics like the task owner/processor, territory, and organizational unit are updated to reflect the current visit where it exists.


HTML5 - Activity Plan.png

 

Routing rules are account-driven conditions which can be maintained as separate “OR” or grouped “AND” conditions to create as simple or as complex structures as needed to match specific account and visit criteria. Upon rule match, the activity plans maintained within the routing rule object will have their worklists determined for the visit.      

 

HTML5 - Routing Rule.png

By maintaining automatic/manual assignment, validity date ranges and routing conditions, administrators have complete control over the sales representative’s worklist when they execute their visits. Administrators can also designate tasks/surveys as mandatory, and utilize scoping configurations to ensure that mandatory tasks/surveys are completed before the sales rep can check out of the visit.


After visits are created for an account, there is a background job that executes every eight minutes to determine worklist items for new visits. In addition, there’s also a nightly background job that refreshes visits with the latest worklist items and survey products that are newly relevant for the visit based on new activity plan or routing criteria. The visit can also be manually refreshed with the latest worklist items by triggering the ‘Refresh Visit’ action directly within the visit.


Worklist items that were designated to be automatically assigned will directly display in the relevant worklists within the visit. Sales representatives would have the option to manually add worklist items that are currently unassigned.

 

Visit - Task Facet.png

Visit - Survey Facet.png

 

Hopefully, this blog entry provided some insights as to how route and activity planning can be effectively used to prepare and plan visits for sales representatives while ensuring proper task and survey execution. Let us know your thoughts on this topic and keep an eye out for next week’s blog entry where we’ll delve deeper into other focus areas of retail execution.

Single Sign On with Microsoft Azure

$
0
0

Hello,

 

We are seeing more and more installations where Cloud for Customer should be configured to use Microsoft Azure as SSO Identity Provider. In the past, we have seen some trouble regarding the NameID format. We worked on a solution and now Microsoft has added C4C as a preset to their Azure Gallery.

 

Microsoft has published a tutorial about how to configure C4C with Azure using their preset:

https://azure.microsoft.com/en-us/documentation/articles/active-directory-saas-sap-customer-cloud-tutorial


Best Regards,

Stefan

C4C Migration Workbench - Checkbox fields in Modify Mode

$
0
0

The behavior of checkbox (aka. indicator, boolean, etc.) fields in the C4C Migration Workbench can be confusing when using the modify mode. With this blog post I want to explain the behavior.

 

 

C4C Migration Workbench - Modify Mode

The Modify mode is used to update individual fields of already migrated records, e.g. update the ABC-Classification of an already migrated Account. You can change the migration mode for each migration file in the Properties window, which opens when clicking on the Properties button.

Don't confuse the Modify Mode with the Enhance Mode, which is used to upload new entries in sheets for already migrated objects, e.g. upload additional Addresses for an already migrated Customer.


The description of the Modify mode says Migration mode to modify field contents only for those fields for which there is an entry in the template. Blank field contents are ignored. For example, to populate new field extensions. - But this is not valid for checkbox fields, like the Prospect field in Accounts. - This is what this blog post is about.


The Migration workbench knows 2 values for checkbox fields, "X" and "empty". Where X means true (checked) and empty means false (unchecked). Given that, checkbox fields are never considered as blank. This means that if you leave a checkbox field empty while using the Modify mode, the field will be set to false - no matter what the value was before.


In my previous example, where I want to update the ABC classification (or any other field on the root node) of an account which has the Prospect flag checked (= true), I must maintain the Prospect field as X in the migration file for all records where the Prospect flag shall remain checked. Otherwise the empty value in this record will be interpreted as false and the Prospect becomes a Customer by mistake.


This behavior is valid for all other checkbox fields (standard and custom) in all other migration files as well. - be aware of it when using the Modify mode in the Migration Workbench.


Eduard

SAP Hybris Cloud for Customer - All About Integration

$
0
0

(click to zoom)
First.gif

This blog serves as a one-point-reference for all SAP Hybris Cloud for Customer (C4C) integration content, and is updated every release. I am consolidating all the existing resources here, and have introduced a Troubleshooting section. Here, you will find FAQs related to specific topics. Feel free to ask questions on these blogs, as the team that developed the content is monitoring the SCN blog comments, and will respond to your queries.

 

You will find all the official guides on SAP Service Marketplace(SMP).

Getting_Started.pngDuring_Impl.pngTroubleshoot.png
Getting Started

High-level information on C4C integration

 

          C4C-ERP Demo 1

          C4C-ERP Demo 2

          C4C-CRM Demo1

          C4C-CRM Demo 2

During Integration

Information that can be used to
configure and set up C4C integration

 

 

** - Coming soon

Troubleshoot Problems

Frequently asked questions on CRM and ERP integration

 


border.PNG

Before you start integrating C4C with any product

While it is common to jump into integration activities, it is also important to:

  • Involve people skilled in SAP middleware, technical connectivity, and the product being integrated with C4C
  • Meticulously understand your company’s business requirement
  • Go through the integration guides available for your integration topic to understand the technical aspects
  • Know how to use the following enablement material, which will come in handy during implementation:
    • Basic message monitoring to help you analyze an issue ** (info coming soon)
    • What information can you get from the integration flow excel ** (info coming soon)
    • How to use the mapping description files ** (info coming soon)

line border blue.png

S/4HANA

 

We have standard pre-packed integration to connect SAP Hybris Cloud for Customer with:

 

line border blue.png

SAP SuccessFactors Employee Central


C4C integration with Employee Central is currently a point-to-point integration, without any SAP middleware. You have the following collateral with information:

 

line border blue.png

SAP CRM/ERP Integration

Here, you will find host of information to help understand various phases of configuration in CRM/ERP integration

 

HCI Configuration

These how-to guides describe how to configure C4C with CRM/ERP using SAP HANA Cloud Integration

 

PI Configuration

How-to guides by RDS - These guides describe configuration of C4C with ERP or CRM using SAP NetWeaver Process integration

 

Initial Load

 

Extending Integration Content

 

SSL configuration

SSL is used for communication from C4C to your on-premise applications.  Additionally, C4C uses X.509 certificates for secure communication.  These how-to guides describe SSL configuration for ABAP, Java, and how to configure X.509 for PI.

 

Monitoring

line border blue.png

OData or SOAP APIs


API Overview

  • Integration Guide for Custom Data on SAP Help Portal - Overview of various architecture options for exchanging data between your SAP Cloud solutions and an external solution

 

Mashups

 

ODATA Services

 


SOAP APIs

 

 

line border blue.png

HCP: SAP HANA Cloud Platform & SAP HANA Cloud Portal

line border blue.png

 

Jam Integration

 

Tenant Management

Tenant Management when using SDK and Integration

line border blue.png

If you have any request, suggestion, or issues with any content available on the blog, please leave your thoughts as comments, and I will get back to you. Looking forward to bringing the developers close to customers!!!

Employee Replication

$
0
0

back2.png

Overview

This blog gives you an overview and explains the frequently asked questions on the replication of Employee master data from an external system to SAP Hybris Cloud for Customer. The external system may be SAP ERP, SAP CRM or SAP SuccessFactors Employee Central (EC). Also, the replication is unidirectional from the external system into SAP Hybris Cloud for Customer (Cloud). Employee replication is mediated from SAP CRM/SAP ERP to Cloud through SAP HCI/PI system, whereas the EC integration is a point-to-point integration.


EMP_RLP.png

Once you scope and configure for Employee replication in SAP Hybris Cloud for Customer, a background job is scheduled by default to run every day. This job reads the employee replication requests received in the staging area and creates employees in SAP Hybris Cloud for Customer.

It is important that a SAP Hybris Cloud for Customer administrator looks into the failed requests in Employee Staging, and either corrects the issue or marks the request as irrelevant.

 

Best Practices

 

To avoid any errors, follow these best practices:

  • Replicate organization center data from SAP ERP/CRM and only then replicate employees. Otherwise, employee replication will fail due to missing organizations.
  • Use employee replication interface to replicate employees, instead of business partner replication interface.
  • To minimize replication errors, employees from Employee Central should be sent to SAP Hybris Cloud for Customer through an initial load. This creates an organization center hierarchy in SAP Hybris Cloud for Customer, minimizing replication errors.

 

Frequently Asked Questions

 

Is it possible to replicate business partners with employee role, if the BP has already been replicated with some other role?

If a Business Partner (BP) is replicated as contact/customer to SAP Hybris Cloud for Customer, it is not possible again to replicate the same BP as employee.

Error: A FATAL EXCEPTION is raised for instance sharing scenario.

 

What is the significance of Employee Type in replication? Give an example use case where employee replication is affected due to Employee Type Validity?

Employee Type data contains information on the duration of employee’s validity in the system. Say an employee is terminated in CRM/ERP, and Employee Type Validity end date will have termination date of an employee. If employee is sent to Cloud for Customer, whose validity date extends beyond the termination date, then the employee is set to inactive and his user is locked in Cloud for Customer.

Most common use case where employee replication fails is because organization assignment validity is extended beyond employee type validity.

Error Text: “Assigned employee <EMP_NAME> is not valid from <DATE> to <DATE>”.

 

Can we use business partner service interface to replicate employees from CRM to Cloud for Customer?

BP service interface should not be used to replicate employees. Instead, use Employee replication service to replicate employees from ERP/CRM.

 

 

How to manage employee replication background job?

Background job is scheduled only when employee replication is scoped. By default, it is scheduled to run once a day, but a key user can re-schedule the job as required. It is recommended not to configure it to run on “Single Run” or “Start Immediately” option. By doing so, the background job schedule instance moves to “Completed” status and re-run will not be possible. In such a case, an incident is required to create Background job schedule from backend.

 

 

What are the steps to migrate employees using migration template?

Follow these steps to replicate employees using a migration template:

  • Navigate to Data Integration  Complete Employee Master Data Replication work center view.
  • To launch Migration workbench, click Actions  Upload Complete Data.
  • Download migration template from the launched view.
  • Follow these guidelines while filling the template:
    • On the Grouping tab, make an entry in key column “File Creation Date Time” in the format “YYYY-MM-DD hh:mm:ss”.
    • On the other tabs, maintain the same value for “File Creation Date Time”.
    • In the “Person ID Type” column, enter the value “1” for ERP remote employee ID, or “2” for CRM business partner remote ID.
  • Upload the filled template using migration workbench.
  • After the data is successfully uploaded, navigate to Data Integration  Complete Employee Master Data Replication work center view.
  • Verify the data is loaded into staging.

 

 

Can we replicate private address of an employee to C4C?

Employee view in Cloud for Customer shows work place address and not private address. Hence, private address is not replicated.

 

How is ID mapping used in employee replication?

On replication, Cloud for Customer maintains a mapping between employee IDs in the external system and the Cloud for Customer system.

When an employee is replicated, the replication service checks the existence of external ID in this ID mapping. If external ID is not found,

it creates a new employee in Cloud for Customer, else if it finds the mapping, it updates existing employee data.

 

 

Is it possible to send an employee without organization assignments? What are the common failure use cases around org-assignments to employee?

Yes, it is possible to replicate an employee without org-assignment.

Most common issues around org-assignments to employee are that the replication fails if:

  • An employee assigned to an organizational unit is not replicated to Cloud for Customer.

       Error Text: “Remote org unit <REMOTE_ORG_ID> with definition Functional Unit from <REMOTE_SYSTEM> not yet replicated”.

  • An org-assignment validity extends beyond employee validity.

       Error Text: “Assigned employee <EMP_NAME> is not valid from <DATE> to <DATE>”.

 

 

What is complete transmission date in the context of employee replication? And what are unchanged indicator and how do they influence employee replication?

Complete Transmission Start Date (CTSD) is the date from which complete data of an employee is transmitted.

For example, if CTSD is 01.01.2013, then all data of an employee from this date, say Personal Details, Org-assignment, and Workplace Address are transmitted to Cloud for Customer.

 

Unchanged indicator is provided to restrict modification of data in Cloud for Customer. It is always set to false during initial replication of an employee. Following unchanged indicators can be set on the employee replication request:

  • PersonalDetailsUnchangedIndicator: If true, update to Personal details data of employees is restricted.
  • WorkplaceAddressUnchangedIndicator: If true, update to Workplace details data of employees is restricted.
  • OrganisationalAssignmentUnchangedIndicator: If true, update to Organizational assignment data of employees is restricted.
  • EmployeeTypeUnchangedIndicator: If true, update to Employee Type data of employees is restricted.
  • IdentityUnchangedIndicator: If true, update to Identity data of employees is restricted.

 

 

Which attributes are mandatory for employee replication?

Following attributes are mandatory to successfully replicate employees to Cloud for Customer.

  • Business System ID

        Error Text: “Remote system instance ID missing”

  • Remote Employee ID/Business Partner Remote ID

        Error Text: “Remote employee ID or Remote business partner ID missing”.

  • Last Name of an Employee

        Error Text: “Last Name mandatory. Enter last name”.

  • Employee Type data

        Error Text: “Employee type missing for remote employee <REMOTE_ID> from <REMOTE_SYSTEM>”.

 

 

What are the effects of changing business system after the initial load of employees to Cloud for Customer?

When employees are replicated from an external system, ID mappings (Remote ID – Local ID) are maintained in Cloud for Customer, with respect to a business system from where an employee is replicated. If the business system changes after the initial load, all employees are again created in Cloud for Customer.

In case if such a situation arises where a business system has to be changed after initial load, then first update the business system in ID mapping for all the employees. This could be done either by Data Workbench or ID mapping download/upload utility.

Once the existing ID mappings are updated with new business system, employee will not get duplicated in the Cloud for Customer system.

 

 

How are the employees from staging processed? Is it in sequential or parallel processing mode?

Employees from the staging are processed via background job in parallel processing mode. Employees from external system are sent in packets to Cloud for Customer employee staging. The processing of employee replication request also happens in packets, and in a packet if one replication fails the entire packet will fail to replicate in parallel processing mode. Packet with failed replication request will be processed in sequential mode.

 

 

Can an IDOC have multiple instances of the same employee?

An IDOC will not have multiple instances of the same employee.

 

 

How to configure Cloud for Customer to integrate with Employee Central.

Please refer the following document on SAP Service Marketplace: INTEGRATION: EC Service Center + Cloud for Customer

• INTEGRATION with Employee Central - Mappings at Field Level

 

 

Which attributes of Employee Central are mapped to attributes in Cloud for Customer?

Please refer the following document on SAP Service Marketplace: INTEGRATION with Employee Central - Mappings at Field Level

 

Is it possible to assign same user ID to different employees in Cloud for Customer?

For every employee replicated, business user is created with a unique user ID. Same user ID cannot be shared or multiple employees cannot have same user ID. It is possible to update the user ID in Cloud for Customer but again it should not be assigned to some other user.

Error Text: “An identity with the same ID <USER_ID> (<Employee Name>) already exists”.

 

Can we use attribute "ScheduleProcessingDirectlyIndicator" to process employee replication request immediately?

Please do not use this attribute as it is not supported. Instead the workaround is to schedule the employee replication background job to run at shorter intervals of time like every hour or two.

 

How to ensure that employee replication is working fine?

Key user or administrator needs to regularly monitor the employee replication job and employee staging for the failed jobs or failed replication requests. For every failed request, look at the error and take the necessary action either by correcting the data in the staging or by marking it as irrelevant, if the data is outdated.

 

 

Why is Employee staging view failing to load the data?

This issue usually occurs if there is any inconsistency in FSI. By FSI reload it should get resolved.

 

Note

If your issue is still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• Cloud for Customer Message ID

• IDoc number from ERP/CRM.

Material / Customer Material Replication

$
0
0

back2.png

 

Overview

 

This blog gives you an overview and explains the frequently asked questions on the replication of materials from an SAP on-premise system to SAP Hybris Cloud for Customer. The external system may be SAP ERP or SAP CRM, and is a unidirectional replication via HCI/PI as middleware.

 

Material_FAQ.png

 

Materials are sent out of ERP using IDocs. Message type MATMAS_CFS is used to trigger the IDoc. Once a material is created in ERP (MM01), we trigger the idoc using BD10 transaction. Based on the logical system setup in WE20, the IDocs are sent out of ERP.

In case of CRM the IDoc used is CRMXIF_PRODUCT_MATERIAL_SAVE and this will be triggered whenever a material entry is saved. Based on the logical system setup in WE20, the IDocs are sent out of CRM.

 

Frequently Asked Questions

 

What should be done if I need same material numbers while replicating from ERP to Cloud for Customer?

The element <ReceiverID> </ReceiverID> also has to be mapped to the MATNR field from IDOC. If the MATNR is numeric, please make sure that you are not deleting the leading 0’s. This is in addition to the mapping of MATNR to the ID field, which is available in standard mapping. For alphanumeric IDs, send it as it is. Refer to SAP Note 2181670.

 

Why are the sales text or description not getting replicated?

Check for the Text Type code list mapping. When code list mapping is not maintained, the text is ignored from the payload and NO error is raised.

In addition, if it is a language independent text, maintain the fine tuning activity "Communication Language for Data Replication".

 

One of these error messages:

"Process quantity unit is not valid".
"Quantity type <UoM> not valid; it must be a trading type".
"Activation not permitted: Base Quantity type missing. - Quantity Type missing"
"Activation not permitted; sales quantity type missing"

The code list mapping for the Unit of Measure is missing.

For all error messages which hints on quantity type, first check for existence of valid and unique code list mapping for the UoM.

Note: In Cloud for Customer, a UoM is linked to a quantity type. We categorize a quantity type as either standard quantity (e.g. length with UoM as cm, mm etc) or trading quantity (e.g. Carton, Bag etc where Uom and quantity type are both same).
In Cloud for Customer we do not allow maintaining a quantity conversion between standard quantity types. This is to avoid user from overwriting the standard. For example, we know 1000 gm = 1 kg and this should not be overwritten with a wrong value by user and hence this check.


Error: Conversion between <UoM1> and <UoM2> already exists.

This can be due to two causes:

1. The code list mapping for more than 1 UoM in the message is to the same external UoM code.

2. Code list mapping is missing for one of the UoM.

 

Error when integration message is trying to unblock Sales Process Info.

Check if the material is in blocked status. If so, the incoming payload should also have the root status as Active. A blocked material cannot have unblocked sales process info.

What do you suggest as the next step ?

You need to unblock the material in On premise and then send the new payload where material status and sales process info status are active.

 

Error: ID mapping for external value <value> of Product Category Key in CRM Suite missing.

Product category has to be replicated first before starting with product replication.

What do you suggest as the next step ?

Replicate product category via the initial load report for the same and then restart the messages.

 

Error: ‘Deletion of salesProcessInfo not possible’.

The replication request has SalesProcessInformationListCompleteTransmissionIndicator as true. This then attempts to delete all node data in SalesProcessInformation. However, deletion of these nodes is only allowed if the instance has *never been active* even once. So the incoming message should always contain the previous salesProcessInformation information.

In case you are not able to provide this information then the SalesProcessInformationListCompleteTransmissionIndicator should be false. But here you have to note that there would be a difference in data between the on-premise system and Cloud for Customer.

PI Content change for this issue was made in 1511 release.

 

Error: Conversion between UoM missing.

All UoM available in the payload as part of sales UoM should have a conversion maintained to the base UoM where, In addition, the code list mapping should also be maintained uniquely for these UoM.

 

 

Note:

If your issue is still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• Cloud for Customer Message ID

• IDoc number from ERP/CRM.

Activity Replication

$
0
0

back2.png

Overview

 

This blog gives you an overview and explains the frequently asked questions on the replication of activities between an SAP on-premise system and SAP Hybris Cloud for Customer. The external system may be SAP ERP or SAP CRM. Activities in Cloud for Customer include phone call, task, appointment, and e-mail. When an activity is created, there is bi-directional integration between cloud and on-premise. Campaign references are also enabled in activity replication. The CRM web UI saves an e-mail text as an SAP Office Document. Both the e-mail subject and e-mail body text is replicated into the e-mail activity. This enables the colleagues from different teams to gain visibility into all activities for a particular account and/or opportunity.

 

Business Value

 

Collaborative activity management assures that sales and service teams across Cloud and on-premise teams will have visibility to all activities for a particular account and/or opportunity.

 

Process Flow

 

Activity replication is bi-directional. Replication request will be sent from a source system to middleware, where the request is processed and transformed into corresponding target system format. On successful replication, confirmation request will be sent from target system to source system.

 

activityflow.JPG

 

 

Best Practices

 

To avoid any errors, follow these best practices:

 

  1. Ensure correct configuration of communication arrangement before creating any activity.
  2. Maintain code list mapping for “Processing type code “, “group code”, and ”Role Code”.
  3. Complete all fine-tuning activities relevant for “Activity” replication.
  4. Keep integration content up-to-date with each release, as there might be some crucial fixes on mappings.
  5. Maintain value mappings relevant for activity replication.

 

Problem Areas

 

Typical areas where issues might arise are due to:

 

  1. Code list mapping not maintained correctly
  2. Value mappings not done
  3. Communication arrangement and scoping was not done
  4. PI/HCI content not up-to-date with the release
  5. Using old type code for activity replication in PI. Previously each activity used to have separate replication requests and interfaces, but now all activities make use of generic interfaces created for all activity types that is supported in Cloud for Customer and the type code is 1783.

 

Frequently Asked Questions

 

What should I do when there is an activity confirmation message failure?


Correct the code list mapping for Processing Type Code.

 

 

How do I solve errors related to missing code list mapping?

 

Please check the bloghere.

 

What should I do if specific fields getting cleared during replication?

Check the payload and see if the field is received as blank. If so, check if a wrong middleware mapping is causing this. We have now enabled extended xml handling, and if the segment is missing from the payload the value will not be cleared. The clearing happens only if the segment comes with a blank value, and this mostly needs a middle ware correction.


Activity text is not getting replicated or Code list mapping for the TextCollectionTextTypeCode values are ignored during activity replication?


For business activity, the code listsActivity / Text / TypeCode are not handled by code list mapping, and is instead handled in PI. You must maintain correct value mapping in PI.

In addition if it is a language independent text, maintain the fine tuning activity "Communication Language for Data Replication".

 

 

While replicating business activity from Cloud for Customer to CRM system, few parties are not replicating even though parties are present in payload?


Please check that all parties have correct role code present in payload.

 

 

Why are the appointment fields getting cleared after receiving a confirmation from CRM?


The reason is either wrong mapping or wrong configuration is maintained in routing conditions of PI. Both Activity and Activity Confirmation messages have same IDOC type, and hence when the confirmation message comes into PI, the PI system routes it to all three mappings of: 1. Activity Replication and 2. Activity Confirmation replication and 3.Customer Quote Sales Order Notification.

 

I am not able to see a particular activity under the work center or activity type?


Ensure that code list mapping is maintained correctly for group code.

 

I receive a dump while saving an activity?


If there is an issue in the outbound communication arrangement for activity, it causes a dump while an activity is saved.


Errors


Error: Reading of key mapping for external ID type <type> and external ID <id> failed


There are duplicate ID mapping maintained for the external ID by mistake. One of this has to be cleaned.

 

Error: "No query result; BO BUSINESS_ACTIVITY, node ROOT


Here are one of the reasons that could cause this error:

  • A wrong PI mapping is maintained, hence sending the wrong external activity ID in the payload causing Cloud for Customer to query for the wrong activity.
  • The mentioned activity was deleted manually by a user which causes the query to fail.
  • The BTD reference was wrongly created which is less likely to occur.

 

Error: "Duplicate detected for External ID"


Change the PI mapping for field TypeCode, and use generic type 1783 instead of individual type code of each activity i.e. Task, Appointment etc.


Error: ID mapping for external value ******** of Business Partner ID missing


There could be one of the following reasons:

  • The party mentioned in the payload is not available in Cloud for Customer or
  • If the customer was manually created, the party ID mapping is not maintained in Cloud for Customer.


Error : Error in message header mapping; agent class is CL_APCRM_ACT_REPL_CONF_IPA


Do the following:

  • Check for the sender and receiver system in the payload, and see if this corresponds to the entry maintained in communication arrangement for activity replication.
  • If the sender system is wrong, ask customer to first check the logical system entry created in on-premise system is correct, and then use the same name as maintained in Cloud for Customer communication arrangement.

 

Error: ‘Update not possible; existing data for ACTIVITY not fully specified’


Wrong ActionCode is sent from PI. The action code should be either 04 for save / update and 05 for delete.


Error: Party role <name> (<category>) is not supported for party role category <name> (<category>)”


Mapping for Party Role to the corresponding Category is missing. Correct the mapping in the fine tuning activity ‘Party Role Definition’.


 

Error: "E/EA/723/MessageHeader (The start tag <IDOC begin=&quot; 1&quot ;> or the end tag < /IDOC> is missing.)"


This message indicates that you are using point-to-point (P2P) integration scenario. P2P integration is now deprecated, and SAP encourages using middleware based integration.


 

Error: Error calling * - Modify: BO BUSINESS_ACTIVITY

Check if any custom development is implemented in Cloud Studio. If so, first check the Cloud Studio solution for issues.


Automatic Code List Mapping

$
0
0

back2.png

 

The following blog explains the frequently asked questions on the automatic code list mapping upload from an SAP on-premise system to SAP Hybris Cloud for Customer. The external system may be SAP ERP, SAP CRM or S4HANA.

If you want more information about the code list mappings in SAP Hybris Cloud for Customer you can check the blog here.


Frequently Asked Questions

 

Why is the replication message failing with error for missing code list mapping although I have maintained the mapping for the particular code?

For the particular scenario check if the code list mapping group is maintained in the communication arrangement and the mapping has been maintained for the same mapping group in the code list mapping. The following screenshot shows you where you can assign the mapping group in your communication arrangement.

   01.png

 


Why do a particular code list not available in the merged excel?

          There could be 2 reasons for the same.

      1. Check if the downloaded merged file from C4C has the code list available in the CodeList.csv file. If it is not available please follow the steps below:

Case 1. You are using the Mapping Group ‘SAP On Premise Integration’ for the merge: This means that none of the scenarios you have scoped is using the code list or you have manually deleted the default entry from the Code List Mapping UI for the particular code list. To include the code in your merged excel create a default entry as shown in the screen shot below for the code list against the code list mapping group you are using.

Case 2. You are using a Custom Created mapping group for the merge. In such a case you will have to create an entry in the code list mapping UI as shown below for all the code lists you want to be part of the merge.

 

02.png

b. The codes are available in the download from SAP Hybris Cloud for Customer but is not present in the merged files: The configuration in ERP/CRM could be wrong in this case. See if the notes which has the configuration changes for CRM and ERP are applied in the system(ERP : 2081161,CRM: 2084679)

 

 

The system throws an error ‘Error in reading the input files.’ when I try to upload?

This happens when you have manually edited the input file names inside the merged archive. The system expects the csv file names not to be changed. Check if the merged archive file which you are uploading have the following csv files inside: 

      03.png

 

 

The system throws an error ‘Inconsistent values in field ACTION_CODE in CODE LIST MAPPING at line no’ when I try to upload?

This happens when the description field has a quote (“) in ERP. The quotes in description is not supported in SAP Hybris Cloud for Customer. To correct this issue manually edit the mentioned file in the error and go to the line number and either change the entry to correct format or remove it.

 


The upload was successful but there were errors/warnings raised. Where do I see the list of errors/warnings?

The messages which were raised can be viewed in the application log screen. Navigate to the results tab to see all the warnings and/or errors raised during the upload.

        04.png

 

Following are the details of errors/warnings which are raised during the upload and how can you react to them.

Errors:

a. The Upload of the merged file to C4C fails due to non-unique ISO Country Code in the log: ‘ISO code is still in use and not unique’.

Please implement the following notes in CRM/ERP: 2269166, 2277842

 

b. Upload to C4C fails with the error in the log: ‘RFC exception SYSTEM_FAILURE raised; the application running deliberately caused an abort with short dump.’

The upload has produced a backend dump. The dump can be checked in the backend transaction ST22. The Application information of the dump tells us which code list is causing the issue. To proceed remove the code list from the mapping and the code csv and upload. For the code which causes the dump further analysis is needed via the ticket.


               Warnings:

a.  Mapping for Local Data Type <CODE> incomplete. Not all codes are mapped.

This means all the codes which exit for the particular data type in C4C is not mapped. Since your external system is the base for the merge we only make sure that all the codes in the external system will be mapped to a corresponding code in C4C. This message is just for information and would not affect any feature when using the replication services.

 

b. Description for <CODE> codevalue <VALUE> in language <LANGUAGECODE> has not been updated.

We do not update the descriptions for any code in a language if it already exist in C4C. This is an information to the user so that if he wants to keep the same description in C4C as the external system he can manually change them in the fine-tuning activity.

 

Note

If yourissueis still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• The downloaded and merged zip files

General Issues with Integration

$
0
0

back2.png

 

Overview

 

This blog gives you an overview and explains the frequently asked questions on the generic aspects of integration between SAP Hybris Cloud for Customer to SAP CRM, SAP ERP or any external system. It also covers issue related to SAP hybris cloud for customer connectivity with HCI , PI etc.

 

 

When you configure your SAP Hybris Cloud for Customer solution, for integrating with SAP ERP, SAP CRM or any external system ,you must observe dependencies that arise from the activities in different systems. We therefore strongly recommend that you perform the activities in standard guides in the sequence in which they are documented. Pay special attention to the prerequisites, if mentioned, at the beginning of each section.

 

 

Before you start working through end to end implementation, ensure that you have downloaded the most recent version of integration guides available at http://service.sap.com/cloud4customer. Also, make sure you have checked end to end connectivity settings via standard report provided by SAP.                                         

 

 

Frequently Asked Questions

 

 

While replicating from ERP to Cloud for Customer using HCI system, all outbound idocs in ERP are failing with the following error

"No IDoc saved in target system (SOAP HTTP)”

Above error means SOAP application processing was started in the target system i.e in HCI system. However, errors occurred in the target system due to unknown reason, which means that IDocs cannot be saved in ERP. Hence for more details about failure please check in target systems error log i.e. HCI

 

 

 

When sending message from soapUI to the C4C the message fails in Cloud for Customer with error message
"SRT: Plain SOAP: Reliable messaging (RM) configured, but no Messaging ID and no WSRM assertion provided

Make sure the protocol defined in the Communication System of Cloud for Customer should be selected as Web Services. Also, make sure end point url to which you are sending request from soapUI or via any middleware into C4C inbound service then it should have MessageID at end as shown below.

e.g. https://<host>:<port>/sap/bc/srt/scs/sap/businesspartnererpreplicationi?MessageId=FA163ED10E711EE696DE10B08BF81EED

 

How can i add new users and authorizations in SAP HCI tenant? Who is authorised to add new users?

An admin user can go to HANA Cloud Platform cockpit and add further admin and users and assign them roles and authorizations. By default, SAP HCI uses SAP Cloud identity provider. Hence all the users must have valid S—userids or P-user ids that can be requested/generated from Service Market Place or SAP Community Network.


Where are all the roles & authorizations mentioned, that can be assigned to users?

Please look at https://cloudintegration.hana.ondemand.com/PI/help> Operating SAP HCI > User Management for SAP HCI > Managing Users and Roles Assignments > Defining Authorizations


While replicating account, messages are failing with following dump error?

Short dump: AP-BP-OR - MESSAGE_TYPE_X_TEXT - CL_COD_OUTBOUND_ERROR_HANDLINGCP

Check if the communication arrangement "Deprecated: Account Inbound for IDocs" is active, and the ERP integration for Cloud for Customer to ERP is scoped correctly.


While replicating account from C4C to ERP using HCI with certificate-based authentication , we are getting following error in C4C

"SRT: HTTP error: ("HTTP Code 500: Internal Server Error - Details see in error log of transaction SRTUTIL")'

also,  HCI tail log shows following error:
'Inbound processing in endpoint at https://abcdefg.xyz.hana.ondemand.com/cxf/COD/ERP/BusinessPartnerReplicationin failed with message "[CXF][Transport][HttpException]:HTTP response '401: Unauthorized' when communicating with https://host.com:443/sap/bc/srt/idoc?sap-client=100", caused by "HTTP response '401: Unauthorized' when communicating with https://host.com:443/sap/bc/srt/idoc?sap-client=100"

You could have following problems :

1) If host.com is a reverse proxy in front of on-premise then it might be that it is not forwarding the HCI client certificate in  http header to ERP(intermediate might be not trustworthy)

2) You did not map the HCI client cert in ERP SM30 vusrextid

3) The HCI client cert is not trusted on host.com

 

 

By retrieving the packaging information from BADI package_changes which is called in CL_AMDCI_OCNRQ_A_PEND_PACK_CH – Execute results into et_package of 2.6 million records and causes dump.

"Short dump: AP-RC-MCI - TSV_TABH_POOL_NO_ROLL_MEMORY -

CL_AMDCI_OCN_REQUEST==========CP"

You have loaded a huge amount of business partner addresses (IDOC ADRMAS) and contact person workplace addresses (IDOC ADR3MAS) without loading the mandatory business partners via IDOC DEBMAS_CFS. All the transferred messages are failing in the Cloud for Customer inbound, because they have a missing reference, due to the fact, that the corresponding DEBMAS_CFS was not processed.

 

Check whether you can send the corresponding DEBMAS_CFS IDOCS and afterwards restart the failed messages in Cloud for Customer. If this is not possible, cancel the failed messages in Cloud for Customer.

 

 

 

While replicating employee replication I receive the following error.

Error: Start date must not be later than end date Interface error; WS-Application; LOD-HCM-RPL; HumanCapitalManagementMasterDataReplicationEmploye

Following messages failed due to start-date greater then end-date. There are number of places where <ValidityPeriod> node appear in the payload and has <StartDate> and <EndDate> elements.Value of <StartDate> should be less than value of <EndDate>. But if messages have <StartDate> greater than <EndDate>. Then it will fail with above error. Please check the payload and re-trigger the messages.

 

 

While deploying integration flow, I receive the following error

"Erroneous Integration Flows is CRITICAL."

Above error occurs when your deploy iflow with same name again. Hence ,check and remove any existing duplicate iflow from HCI tenant.



 

While updating an ERP Customer from C4C in ERP sales area fields gets deleted.

This happens whenever in the IDOC the E1KNVVM segment does not contain the value "/" for all the fields, which should not be touched during replication. In the most recent SP for the middleware content, the logic is available. Please update your content accordingly. If you prefer to fix the message mapping manually, please assign the constant value / to all of the fields in IDOC segment E1KNVVM, which are not already mapped. This should fix the issue.

 

 

 

While replicating data between PI to Cloud for Customer, it is failing with Certificate Error   ( PI -> HTTPS -> C4C)

One of the reason could be that complete chain of SAP Hybris Cloud for Customer server certificate is not imported in PI trust store. Try importing complete chain and check if this resolve the error or not. Incase if this doesnt resolve error , please take SMICM trace at level 3 for more detailed info.




Dump occurs if you click on "Document Flow" in sales quote . Following are the steps to reproduce dump. :Woc Sales => Sales Qoute "xyz" -> select "Document Flow" -> Exception Occurred.

An internal error occurred during message processing. For error details check MPL ID AFVbI-YbL8jty25IcWoKaRREfwjV in message monitoring.

Above error comes when processing stops at HCI for some reason. Please go through complete log in HCI and search with given MPL ID for more detail info on error.

 

 

 

Why is employee address replication failing with following ID mapping error?

Error: "ID mapping for external value 148778 of Address missing"

Check SAP Note 2056045 - Initial Load of Business Partner from ERP to C4C should be done in a sequence.

 

 

When replicating data from ERP to Cloud for Customer via HCI, I receive the following error in ERP

IOException:Unable to tunnel through proxy. Proxy returns

"HTTP/1.1

502 Host not found"

One of the reason could proxy settings are not maintained correctly in transaction sm59. Please check hostname,port, proxy again. Incase if this doesnt resolve the issue , further details could be obtained via SMICM trace at level 3.

 

 

 

While deploying iflow I am getting following error

'java.lang.IllegalStateException: Secure Storage service returns no credentials for alias XYZ'

This error occurs when iflow is deployed with basic authentication and credential name XYZ is not deployed into tenant. It is mandatory to deploy credential in your HCI tenant with given name as maintained at receiver channel before using basic authentication in iflow .

 

 

Note

If yourissueis still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• Cloud for Customer Message ID

• IDoc number from ERP/CRM.

SURVEY A2A SERVICE : Manage_Survey_Response_In

$
0
0

SURVEY A2A SERVICE

Manage_Survey_Response_In

 

Business Context:

This service provides a procedure to capture the answer/responses from third party system( a native external application) to the C4C Survey.

 

Survey A2A enables the external application to send Asynchronous responses of the survey in the Cloud for Customer system through an external portal (which is part of integrated software system of the business enterprise). 


2 Response Capture Service Details


In the Survey A2A service, the structure fields are derived from the Questionnaire BO.

 

Query all the Questions with Answers for a Response Item:

To query all the questions in the survey we can use the below URL:


https://<C4CSystem>/sap/c4c/odata/v1/survey/ResponseCollection('<key1>')/ResponseItem(‘<key2>’)/QuestionAnswers

 

<Key1>-> corresponds to Questionnaire -> Valuation_Collection Node

 

<Key2>-> corresponds to Questionnaire -> Valuation Node


Below is the sample XML to capture responses


Note : 1 ) This A2A Webservice also supports the inclusion of new surveys to Visit while at the same time                    responses can be captured

          2 ) Only Survey Type 'Checklists' are supported with this A2A web service


<n0:SurveyResponseMaintainBundleRequest xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
<MessageHeader>
<UUID >12345678-90AB-CDEF-0123-456789ABCDEF</UUID>
<ReferenceUUID>12345678-90AB-CDEF-0123-456789ABCDEF</ReferenceUUID>
<CreationDateTime>2016-05-23T12:00:00.1234567Z</CreationDateTime>
<SenderBusinessSystemID>Q9CCLNT400</SenderBusinessSystemID> 
“Business System (Sender ID) Message communication arrangement should be configured”
</MessageHeader>
<SurveyResponseRequestMessage>
<MessageHeader>
<UUID>12345678-90AB-CDEF-0123-456789ABCDEF</UUID>
<ReferenceUUID>12345678-90AB-CDEF-0123-456789ABCDEF</ReferenceUUID>
<CreationDateTime>2016-05-23T12:00:00.1234567Z</CreationDateTime>
</MessageHeader>
<ID>1161</ID> 
“Survey Root ID
<!--Zero or more repetitions:-->
<ValuationCollection>
<ValuationCollectionUUID>00163E12-BA69-1EE5-B9C5-182304D5BB97</ValuationCollectionUUID> “This has to be a new UUID when attaching the survey to the Visit for the first time
<!--Zero or more repetitions:-->
<Valuation>
<!--Optional:-->
<ValuationUUID>00163E12-BA69-1EE5-B9C5-182304D5DB97</ValuationUUID>
“Valuation UUID can be blank when attaching survey for the first time, but must be filled for update cases
<Answers>
<QuestionUUID>00163E12-BA69-1EE5-B9C4-C5E9F681DA63</QuestionUUID>Survey-> Element UUID
<QuestionOptionUUID>00163E12-BA69-1EE5-B9C4-CA74CB0D5A95</QuestionOptionUUID>>Survey -> Element Value UUID
<Indicator>true</Indicator>
</Answers>
<Answers>
<QuestionUUID>00163E12-BA69-1EE5-B9C4-D0DDE0E65AA5</QuestionUUID>
<QuestionOptionUUID>00163E12-BA69-1EE5-B9C4-D16FFC4F3AA6</QuestionOptionUUID>
<Amount currencyCode="USD">234</Amount>
</Answers>
</Valuation>
<BusinessTransactionDocumentUUID>00163E12-BA40-1EE6-8898-FB33BD4F54C2</BusinessTransactionDocumentUUID>
” Visit’s UUID, this is the important field when attaching the survey to a Visit, not needed for update cases where survey is already attached to the corresponding visit


<BusinessTransactionDocumentTypeCode>12</BusinessTransactionDocumentTypeCode>
“Visit’s BTD Type Code, as mentioned above in the same manner this is also not needed for update cases where survey is already attached to the corresponding visit

  </ValuationCollection>
</SurveyResponseRequestMessage>
</n0:SurveyResponseMaintainBundleRequest>

 

3 Communication Arrangement


In the communication arrangement, communication settings must be made for both inbound and outbound communications


It is an Asynchronous service thus it sends the response back only for successfulweb service calls via a separate message for the confirmation of posting

Note : for failed messages / failed postings there is no response back to the calling application (In C4C general A2A Asynchronous services do not send the error messages / failure notification of failed messages/web services call)


We have attached two files "Survey A2A Manage Response Structure.txt", "Communication Arrangement Overview.JPG" for your reference,  and also the above sample xml should guide you through the forming of web service call structure


I hope this document has been helpful . Please leave a comment in case you want us to explain anything more about this topic.


Moving Your C4C Solution From Test to Production - The Copying Process

$
0
0

Moving Your Solution From Test to Production - The Copying Process and Duplicate Work Required

 

 

When the test solution profile is copied over, only certain configurations are copied to a new (fresh) production tenant.

Many customisations have to be either imported or manually redone in the production tenant.

 

I have highlighted below the copying processes and additional work that is required in the production tenant.

The lists below are in no way exhaustive but will serve to provide a guide as to the work required during the move from the test C4C solution to the new production system.

 

Initial test system copying by SAP to the new production system will only include:

 

The scope

All the fine tuning entries

KUT adaptations, extension fields,    (as long as non previously exist in Production)

Page layouts & code list restrictions  (as long as non previously exist in Production)

 

 

Level 0 master data objects:

 

These will be copied over to the staging area of the migration workbench but will need to be manually committed to the new production tenant:

 

BANK_DIRECTORY (bank directories)

ORG_CENTER (organizational structure)

JOB (jobs)

PRODUCT_CATEGORY (product categories)

L0_TRANSPORT_LANE (transport lanes)

L0_TRANSPORT_ZONE (transport zones)

 

Level O master data is automatically transferred to migration templates which then sit in the staging area as prepopulated templates awaiting import by the user into the production tenant.

 

 

Customisations Requiring Export from Test and Import into Production System

 

Many configurations that have been created in the test tenant will require exporting out of the test system, saving on to your desktop and then importing into the new production system via the import function in each of the respective business objects or workcentres.

 

The non exhaustive list below gives you an idea of the type of customisations requiring export from Test then import into Production:

 

Code list mapping

ID mapping

Customised and New Reports

KPIs & Dashboards

Forms

Custom objects

Language Adaptations

OData service

Organisation chart (if not accepted via Level 0 data transfer)

Lead routing

Realignment runs

 

 

Customisations which have to be manually redone in the Production tenant.

 

There are some customisations which cannot be copied or imported into the Production tenant.

Below are some of the customisations which have to be manually redone in the production system.

 

Business roles

Workflow rules

Work Distribution

Email and fax settings

Service Level Agreements

Mashup authoring

Report assignment to workcenters

 

The extent and nature of the replication work required will of course depend on the scope of the solution being implemented.

 

I hope this helps to guide fellow SCN users during their project implementations.

 

Regards

Majid

SAP Hybris RTC User Guide

$
0
0

Hello,

 

as we recently had some talks with customers where the question came up how to switch on and to use SAP RTC let me post here the current admin/user guide explaining this in detail (as PDF on Google drive because of file size):

 

     SAP C4C RTC 1605 User Guide v1 1.pdf

 

Please feel free to get back to me if you have any questions and/or need additional information.

 

 

Regards

 

Roland

Business (Marketing) Attribute

$
0
0

back2.png

 

Overview

Business Attribute and Business Attribute Set replication are unidirectional from CRM to C4C.

Business Attribute Assignment to a business partner is bidirectional.

Please check the blog http://scn.sap.com/docs/DOC-63799 for further details on Business (Marketing) Attribute Replication

 

Frequently Asked Questions

 

Error: Attribute <attribute name> not known– The marketing attribute set replication failed in Cloud for Customer
Attribute <attribute name> or AttributeSet <name> not known– The marketing attribute assignment replication failed in Cloud for Customer

The marketing attributes have to be replicated first before replicating attribute sets which refer to the attributes. Replicate the attribute set before the assignment replication is triggered.

 

Inbound IDoc CLFMAS for attribute assignment processed successfully, but did not save the changes

Check in the CRM system if the attribute is set as local class (check box). If this is set, then the changes will not happen via replication. Such attribute assignments can only be changed from within the system. If these have to be enabled for replication the local flag needs to be unchecked.

 

Error: Marketing Attribute not removed during attribute set replication

In Cloud for Customer, an attribute which is currently assigned to a business partner cannot be removed from the attribute set. So this error is an expected behavior from the BO.

If the attribute has to be removed from the attribute set, then all active assignments have to first be removed.

 

Error: Code list mapping for UoM

Maintain the code list mapping for UoM in MarketingAttribute.

 

Issues with IDoc generation in CRM

Replicate the marketing attribute to SAP Hybris Cloud for Customer as outlined in this blog.

 

Scope Limitations in Business Attribute Replication from SAP CRM On-Premise to Cloud for Customer

You can find it in SAP Note 2278929


Note

If yourissueis still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• Cloud for Customer Message ID

• IDoc number from ERP/CRM.

Sales Document (Quote / Order) Replication

$
0
0

back2.png


Sales Process

C4C supports Sales Quote/ Order replication between SAP ERP and SAP CRM systems.

Sales Quote Process is Bi-directional depends upon the Code List mapping Sales Quote will be replicated as Quote only or Follow-up document as order also

Sales order Process is Bi-directional and it supports Create/Modify/Delete

Sales Quote and Order are replicated between C4C and SAP ERP/CRM systems through middleware as PI/HCI.

SO.JPG

ERP <--> C4C:

  • Replicate Sales Quote from ERP to C4C by maintaining the Code list(CL) mapping correctly (For E.g., Quote to be replicated successfully as Quote in C4C Item Category/ Processing Type code in standard should be AG and Item Processing type code should be AGN)
  • In Follow-up document creation If Sales Quote document to be replicated as Sales Order in ERP, correct CL mapping and CL Mapping should be mapped in Communication arrangement(CA) (For E.g., Quote to replicated as Order in ERP CL Mapping for Processing type code should be TA and Item Processing type code should be TAN).
  • Replication of Sales Order from ERP to C4C and Vice versa will be done via correct CL mapping (For E.g., Processing Type Code should be TA and Item Processing type code should be TAN)
  • Sales Quote/Order is sent out of ERP using IDocs. Message Type: COD_REPLICATE_SALES_ORDER is used to trigger the IDoc. Once a Sales Quote/Order is created the IDoc will be triggered automatically using Message Control elements maintained.
  • Based on the logical system setup in WE20, the IDocs are sent out of ERP.
  • Sales Quote and order pricing is carried out in Synchronous call from C4C to ERP
  • CRM Opportunity Follow-up document as Order from C4C to ERP .


FAQ’s:


Error saying fault code:soap:Client
faultstring:Message part{http://sap.com/xi/sapglobal20/Global
}ExternalSalesDocumentDataQuery_sync was not recognized” Retrieving customer Group from configuration not possible

Target WSDL which C4C system refers to is different to what have been configured in the Communication Arrangement

Correct Message Mapping/ Iflow mapping needs to be done

 

Customer Numbers exceeding 10 Characters are not supported in C4C

It needs to be checked if the exernal ID is being mapped as the receiver ID. This is wrong and receiver ID should be determined via ID mapping.


After upgrade some feature is not working or some data is not replicated

Check the PI/HCI version and see if the most recent mapping is available in customer system.


Not able to Upload code list to C4C, Warning in showing some issue with buffering.

clear the buffer for the backend table CODD_CODE_METADATA, basically clearing one field value from there


Fatal exception with text as either Business / Logical system not identified

Check for the sender and receiver system in the payload and see if this corresponds to the entry maintained in communication arrangement.

Also if the sender system is wrong as customer to check the logical system entry created in on premise is correct and uses the same name as is given in C4C communication arrangement.


HTTP Code: 500 ( SRT: Unexpected failure in SOAP processing occurred: ("No Web serviceconfiguration for this access path: "/sap Sender interface operation: <name>

Issue in PI Configuration for issues any. Ask customer to check if the receiver / interface determination are configured correctly.

Check if the configuration is existing. If customer is using custome PI mapping then check if it is it as per the standard we have delivered.


While Requesting Pricing, customer gets the errors - Pricing could not be processed.

Check if customer is mixing up  External Pricing and Internal Pricing. This is not allowed.


Error when executing report RCOD_CREATE_CONNECTIVITY_SIMPL to enable C4C-ERP integration
"Definition for inboun srv. ECC_SALESORDER009QR does not exist"

Necessary to install the mentioned EhPs. Enabling the functionality through the corresponding SP's is not sufficient

ERP 6.0, EHP 0, Support Package15(SAP_APPL), SAP BASIS K267.0, Support Package 18 (SAP_BASIS)
Sales order in accounts will need ERP 6.0 EHP2
Sales order in opportunity will need ERP 6.0 EHP3
Quotes and sales order as PDF in an opportunity will need ERP 6.0 EHP 4


Party Role ZU ‘End Customer’ is not getting transferred to C4C (ZU can be any custom code)

Check code list mapping for the role code. It needs to be maintained.


Getting error in Order "Process Quantity unit not Valid"

Check code list mapping for the unit of measure. It needs to be maintained for the UoM in payload.


Opportunity pricing request does not contain full sales area data (sales office/group are missing)

Sales office & group are currently not supported for integration.


FSCM credit check status is not replicated / issues related to this

Note 2180566& 2196639


Sales Person can give additional discount at items or overall discount at total pricing.
To do so they can click on Add button at block Product Pricing or Total Pricing respectively.
After clicking they see all the price components available (207 in our case) within the system instead of just the discount ones which are 8-10.

The conditions which are available for entry are returned by the pricing service. So you can restrict the available condition by implementing the BADI for the service in ERP.
The BADI is called BADI COD_SLS_SE_ADJUST_DATA. It can be found in the
IMG under :
Integration with Other mySAP.com Components->Integration with SAP Cloud for Customer
àApplication-Specific SettingsàSales Processing->BADIsàQuotation Pricing Request Service: Inbound and Outbound Mapping.
In the method ADJUST_EXPORT_DATA the customer can change
cs_sales_order_data-create_cond_type_hd for the header conditions and cs_sales_order_data-create_cond_type_it and remove the conditions types he doesn't want. This should be done per pricing procedure.


Sales quote with External price is not working

Check one of the following

i) Is the CA maintained and configured correctly.

ii) Is there multiple CA for the pricing outbound.

iii) iflow / PI mapping version is recent

iv) Check ID mapping is correct and no duplicate entries are there in ID mapping


Any issue related to item category code not valid or wrong item category code after replication

Check the detailed session on code list mapping for item category code in quick start guide and see if this is followed.


Delta replication of quote / order dumps in ERP

Check the output type (COD4 is thestandard delivered one). The Change output program and form routine is filled with RCOD_OUTPUT_COD4 and ALE_PROCESSING. Please remove these entries as these entries should be blank unless you have any custom requirement.
The program RCOD_OUTPUT_COD4 and ALE_PROCESSING should be filled in the processing routines section for output type COD4.


Operations with cond. of type F not allowed. F can be other codes as well.

Refer the note 593246 for supported condition types.


Sales document text not getting replicated

Check for the text type code list mapping. When code list mapping is not maintained the text is ignored from the payload and NO error is raised.

In addition if it is a language independent text the fine tuning activity with the name "Communication Language for Data Replication" should be maintained.


Delta replication of sales order is not happening from ERP or orders corresponding to a specific document type are not replicating from ERP to C4C.

Check the blog for maintaining and configuring condition types for sales documents (url link to be added).


Inbound IDocs dump in ERP for sales order replication

Check if the PI / HCI mapping version is the recent one. Also check if customer has done any custom mapping. This can occur mostly due to data issues.


Error with 0-value on external pricing from ERP

To achieve this scenario the customer has to adjust his HCI/PI content in the following way:
a) IT_ORDER_CONDITIONS_X-COND_COUNT should be '01' in case of the required condition type and value 0.00.
b) IT_ORDER_CONDITIONS_X-UPDATEFLAG should be 'U' in case of the required condition type and value 0.00
c) IT_ORDER_CONDITIONS-COND_COUNT should be '01' in case of the required condition type and value 0.00.


Attachment replication is not happening

Check if the confirmation messages are getting processed in ERP and also the counter replication from ERP to C4C are happening. Check qsg for the complete cycle of replication.

BINREL creation is mandatory for attachment replication (details available in qsg)

 

Note

If yourissueis still not resolved, then please raise an incident for SAP Support. Also, please send the following information in the incident:

• Problem description

• Steps to reproduce

• Cloud for Customer Message ID

• IDoc number from ERP/CRM.

 

 

 

 

 

 





Create a Logical port in SOA Management for Consumer Proxy

$
0
0

(e.g taken is E2E Connectivity check)

 

Go to SOA Management from your ERP system and search for the consumer proxy 'CO_CODERINT_CONNECTIVITY_CHECK'

1.jpg

In case of CRM system the consumer proxy is CO_CRMPCD_CONNECTIVITY_CHECK_C

2.jpg

Click the proxy and open it.

Now in the configurations tab under Define Logical Ports click on Create button.

3.jpg

Select Manual Configuration while clicking the Create button.

4.jpg

This will take you to the step by step process to create the port.

Give a name to your logical port and a description.

Select the checkbox for making this the default port if this needs to be.

 

5.jpg

In step 2 select the authentication method.

I have used User ID / Password of the PI system.

6.jpg

If you want to use certificate based authentication select the radio button as below and select your certificate from the list.

7.jpg

In step 3 give the following information. (These are specific to your land scape and please don’t copy the values from screen shot).

 

  • URL Access Path - Middleware service path URL for webservice call.
    • In case of SAP NetWeaver Process integration (PI) the service path can be obtained from sender agreement which should be of format :-  /XISOAPAdapter/MessageServlet?senderParty=&senderService=<ERP Business System              Name>&receiverParty=&receiverService=&interface=ConnectivityCheckConsumer&interfaceNamespace=http%3A%2F%2Fsap.com%2Fxi%2FCODERINT
    • In case of HCI :- /cxf/CRM/COD/SimpleConnect

 

  • Computer Name - Name of computer of above PI / HCI system.
  • URL Port - Port number of the URL. For PI the port can be obtained from SMICM or ICM admin. For
  • HCI it can be set to 443.
  • URL Protocol - Protocol for webservice call. For example HTTP/HTTPS.
  • Proxy Host - Name of proxy host if a proxy is used for the http connection (optional)
  • Proxy Port - Port number of proxy host if a proxy is used for the http connection (optional)
  • Proxy User - Name of user if a proxy is used for the http connection (optional)
  • Proxy - Password - Password for the user if a proxy is used for the http connection (optional)

8.jpg

In step 4 give the below shown values and click Next

9.jpg

Click Next and click Finish.

10.jpg

You can see the new port as shown.

You can click the display port button and ping the port to see if the parameters entered are correct.

11.jpg

12.jpg

Once this is fine, you can consume this proxy via this port as default.

Custom OVS with prepopulated filter parameter from landing page

$
0
0

Provide a new F4 search help based on a custom object, once the F4 opens, the search parameters on top of the search results should be prepopulated based on the landing page’s field values.

Demo: in this demo, the prepopulated value is TypeCode.

    1. All of available values in custom object that OVS bases on.

1.png

    2. Landing page contains field UUID which is enabled Object Value Selection created in step 1.

2.jpg.png

    3. Set value of landing page field TypeCode as 1 - Not Released and trigger value help on field UUID.

3.png

    4. Set value of landing page field TypeCode as 3 – Released and trigger value help on field UUID.

4.png

 

Technical Steps: (key message only)

    1. In the OVS UI component, you have to create new in-port parameter, name it TypeCode here.

5.png

    2. Create custom query and enable TypeCode as search parameter.

6.png

    3. Create event handler to assign in-port TypeCode to search parameter TypeCode.

7.png

    4. Set this event handler as Inport OnFire event of OVS UI component.

8.png

    5. On the landing page, you have to bind corresponding value to the in-port parameter created before.

9.png

C4C Fast order entry - show existing quantities

$
0
0

This blog explains the feature ‘show existing quantities in the fast order entry screen’ in detail and should help to understand the functionality of this feature better. Also it should help to know better what you can expect from the feature and what you can not expect.

 

The basic intention of this feature is to help you to avoid double entries of products in the fast order entry screen. Therefore C4C tells you if a certain item you are about to choose was already entered and it also shows you the entered quantity.

 

Small example:

 

f1.jpg

You have already entered a product in the fast order entry screen…

 

 

f2.jpg

…now you want to enter more items via selection from a product list …

 

 

f3.jpg

As soon as you mark an item- the system will show you the existing quantity. The existing quantity is the sum off all item lines containing the same material ID. So if you have entered a material twice in the fast order entry- the existing quantity is the sum of these two.

 

It only shows the quantity for the marked items at the time when you mark them- this has performance reasons. Since there can be many products in the product list it was decided not to show the existing quantity automatically for all items in the list.

 

You have now 2 options

 

Option 1 : keep the line marked -> this will create a second order line in the fast order entry. It will not increase the existing order line!!

Option 2: unmark the item and increase the quantity of the order line which already exists in the fast order entry.

 

 

 

also Important to know:

f5.jpg

If you choose all products of a list by flagging the list itself and not by flagging the single items one by one – the existing quantities are NOT shown- this works as designed and has the same performance reasons as described above. To make use of the feature you have to flag the items one by one!!!!

Custom Extensions - via SAP Cloud Applications Studio and SAP Hana Cloud Platform

$
0
0

In this blog, I have listed down the different tools that SAP provides for partners and customers to customize and extend the SAP Hybris Cloud for Customer solution. The blog focuses on extensions that are built using SAP Cloud Applications Studio and SAP HANA Cloud Platform and gives a guidance on when to use which tool.

 

Introduction: SAP Hybris Cloud for Customer provides a broad spectrum of flexibility for partners and customers to customize the core solution. The customization are done at different levels by different personas of the system.

 

Flexibility.png

 

End users– The business users of the SAP Hybris Cloud for Customer can personalize their screen using the rich features of the in-built Key User Tools (KUT).

Key users– The key users or Administration users can configure, adapt and extend the solution using the in-built Key users Tools (KUT) capabilities without modifying the core. These changes shall be applied to all users of the system.

IT development or Partner– The IT developers of partners and customers can extend and customize the core solution by building integrations, and developing extension solutions using SAP Cloud Applications Studio or building side-by-side extensions using SAP HANA Cloud Platform.

 

 

SAP Cloud Applications Studio:

SAP Cloud Applications Studio is a software development kit (SDK) which enables SAP partners and customers to adapt and enhance the capabilities of SAP’s Cloud solutions (SAP Hybris Cloud for Customer and SAP Business ByDesign).

Certain business scenarios of the customer would require customization which involves implementation of simple to complex business logic or coding. Such custom extension development cannot be handled using the Key user tool and hence partners and customers would require to use the SAP Cloud Applications Studio. The Studio is the development environment that provides a comprehensive set of features which allows you to develop, deploy, and test custom extension solutions that runs in the same runtime environment of that of the core cloud solution.

 

For more details on SAP Cloud Applications Studio refer Overview

 

 

Typical use cases of custom extensions where SAP Cloud Applications Studio is recommended.

  1. Extension solutions requiring development of new UI screens and business logic that should are seamlessly integrate with the existing Cloud solution and follow the same UI patterns/style of the standard screens.
  2. Customization that requires modification of existing standard screens with additional business logic.
  3. Customizations that require extension of existing artifacts or creation of new artifacts (such as Business Objects, Forms, Data sources, Reports, Web services etc.) of the Cloud Solution.
  4. Extension solutions that require enhancement of the existing core business process. (Business object extensions, process extension scenarios, enhancement implementations etc.)
  5. Extensions that require creation of new approvals processes, and notification tasks within the cloud solution.
  6. Customizations that require integration of the C4C solution to the external cloud/on-premise, SAP/3rd Party web services using SOAP, REST protocols.

 

SAP HANA Cloud Platform:

SAP HANA Cloud Platform is the centerpiece of SAP’s extension strategy in the Cloud. As an open, standards-based Platform-as-a-Service (PaaS) environment it provides partners with out-of-the-box capabilities to enhance the SAP Hybris Cloud for Customer scope. SAP HANA Cloud Platform makes it easier for partners to build entirely new cloud solution and enable new processes to meet their unique business needs.

The SAP HANA Cloud Platform facilitates the entire application lifecycle of SAP Hybris Cloud for Customer extensions by providing the following features for developers:

  • A flexible, scalable, and highly adaptable platform
  • Integration with SAP Hybris Cloud for Customer based on SOAP, REST, OData and E-Mail
  • Comprehensive, built-in services to quickly create new applications or adapt existing applications into either custom or generic extension applications
  • Functionality that allows for the building of feature-rich mobile and social media apps
  • Access to continuous innovation and latest technologies to expand markets and scope
  • Framework that standardizes development workflows for increased developer productivity and better quality
  • Secured integration with on-premise back-ends

 

Typical use cases of custom extensions where SAP HANA Cloud Platform is recommended.

  1. If you have to build an external customer portal, for example, for service scenarios to engage with customers and integrate with C4C.
  2. If you have to build loosely coupled or side to side C4C extension solutions from the scratch using Java development environment or native HANA XS.
  3. If you have to build extension solutions in a continuous development wave manner and maintain separate code lines for development and maintenance.

SAP Hybris Cloud for Customer : Party Definition and Determination Made Easy

$
0
0

In this new series of SAP Cloud for Customer blogs we will be highlighting some key aspects of how party roles are defined in customer master data and how party determination is executed for transactions in SAP Hybris Cloud for Customer.

 


Why do we need party determination :-  In any business transaction many different parties are involved for example in a sales order there will be a seller and buyer in its very basic form . In addition there could be other parties as well for example , where should the products be shipped termed as Ship to party , who will be paying the invoice termed as Payee .


In more complex B2B transactions there could be many more stakeholders termed as parties who are involved in a business transaction and hence it is imperative that an ideal enterprise application provides a flexible and easily configurable party determination mechanism .

 

Why is it important to have a easy to configure and transparent party determination mechanism :- As sales rep , when a user is creating a business transaction , he/she should be able to understand how the system determined the various parties which are determined automatically . The more complex party determination mechanism the more in-transparent it is to the end user.

 

What we offer in SAP Hybris in Cloud for Customer :- We offer an open and flexible party role definition and determination mechanism for most of the sales and service transactions . You can define custom party roles in cloud for customer and also configure the determination steps. Let me break down the whole concept in four areas as follows :-

 

1)  Party role and business partner relationship definition (standard and custom)

2)  Party role maintenance in customer master

3)  Party role configuration in transactions

4)  Party role determination in transactions

 

 

 

Party role definition :- You can  browse through and change the properties of standard party roles by navigating through the path business configuration ---> Fine tuning --> Party Role Definition .

You can rename the standard party roles delivered out of the box .     

P1.jpg

Fig 1: BC Fine tuning activity for configuring Party Roles.

 

 

 

Responsibility Role indicator means if a party role can be assigned to an employee , Assigning an employee to a party role in account will be possible only if the responsibility indicator is set for a party role.

 

In addition you can mark a party role to be sales area dependent by marking the indicator 'Sales Data' in the BC tuning activity . Sales area dependency indicator means a party role can be assigned per sales area . Let me explain this with an example

An organization can have many diversified businesses for example a large construction company can have interests in ports , highway construction and government projects each represented by a sales org.

Employee responsible(sales) or owner for an account if marked as sales area dependent means that an account can have owner each for ports / highways and projects in essence one (or more ) sales rep responsible for each line of business .

This sales area based role assignment plays a very important role in the involved party determination in transactions which will be discussed later in this blog.

 

Unique indicator means if one or more employees can be assigned to a party role . For example if you have marked Employee Responsible (Sales) as unique can only one employee as owner for an account  .

if this flag is set along with the sales area flag it means that the uniqueness check will be done in combination with sales areas , in essence you will be allowed to maintain one party role records per sales areas ( you will not be allowed to create two records with the same role for same sales area ) .

 

 

Business Partner Relationships :-

All other relationships or party assignment can be done using the business partner relationship concept in SAP Hybris Cloud for Customer . These relationships are primarily used to define relationships for example account to partner or account to account ( ship to / bill to / payee) .

You can define custom relationships using the BC fine tuning path

You can  browse through and change the properties of standard party roles by navigating through the path business configuration ---> Fine tuning --> General business Partners -->Maintain Relationships--> 


P5.jpg

 

Fig 2 - BC fine tuning activity to create new relationships .

 

As shown above you can also mark relationship to be sales area dependent , this means that you can maintain relationships per sales area . Let me explain this with an example .

A account can be assigned to be sales org 1 (SO1) and sales org 2 (SO2) , ship to party for SO1 is P1 and ship to party for SO2 is P2.

the system during party determination in transaction will consider the sales area information maintained on the transaction to determine the correct ship to party which means that if the transaction belongs to SO1 then P1 will be picked up as ship to party or if transaction belong to SO2 then P2 will be assigned as ship to in party in the transaction.

 

I will also explain the correlation between roles and relationships later in this blog.

 

 

Party role maintenance in account .

You can assign employees and other business partners in account master data . As shown below you can define the account team member in face 'Account Team' tab . By default you will observe that all the party roles marked as 'Responsibility Role' will be available in the account team create view .

 

P3.jpg

Fig 3 :- Assign party role to account

 

Business partner relationship maintenance :-

You can maintain relations for an account under the tab 'Relationships'.

P10.jpg

Fin 4 :- Relationship assignment in accounts .

 

How are party roles and relationships related :-

If you are creating your own party role ( which are not responsibility role ) and would like this party role to be used in a transaction , you can link a party role with a new relationship in the BC as shown in Fig 1 . The system for a new party role automatically offers a default determination step as shown below by reading the relationship record from the account . For example if you define a new role say "Preferred Sales Partner" and link to a new relationship called say "Has Preferred Sales Partner" in the party role definition . In the next step you can assign this relationship in account master by creating a new relationship record for the account using relationship "Has Preferred Sales Partner" .

If you want this new role "Preferred Sales Partner" to used in the opportunity , go to opportunity fine tuning as show in fig 5 below and then assign this party role in the configuration .

The system during opportunity creation will first try to find if there is a relationship 'Has Preferred Sales Partner' for the account and then will assign this Business partner to role "Preferred Sales Partner" in the opportunity.

 

 

Party Role Assignment Configuration in Transactions :-

Now that we have defined our master data setup , let us understand how these are used in transactions . As shared earlier one of the most prominent usage of party role and relationship records is in the transactions involved party determination .

 

Let us take a use case to understand the determination configuration better . Assuming that I am creating a sales opportunity and as a sales rep, I expect the system to automatically determine key sales team members automatically from the account master/territory additionally I also expect that key parties such as Ship to Party , Bill to Party , Payee etc are also determined from account master data.

 

Well SAP Hybris Cloud for Customer provides for all prominent sales and service transaction a very flexible and robust party determination configuration feature . As shared in the example above , let us see where can we configure the parties which should be automatically added and determined in the sales quote . go to business configuration ---> Fine tuning --> lead--> Maintain involved parties.

P17.jpg

P18.jpg

 

 

P19.jpg

 

Fig 5 :- Involved party configuration in transaction

 

For each of the party roles configured , you can active - deactivate party roles . Additionally you can configure the determination steps using which the system will read business partner assigned to the party role . For example in the determination steps for employee responsible for employee responsible , the system will try to search for employee responsible from account team if there is employee responsible maintained in account team then this employee is assigned as employee responsible in opportunity . Note the system also considers the sales area information while executing this determination .

 

please refer to the blog post to learn how sales area information is determined in sales transactions

Sales Organisation / distribution channel / division determination : - Combined Sales Area Determination in C4C Sales Transactions

 

 

So you can assign individual employee responsible for each sales area and dependent  on the sales area determined in the transaction the system will determined the employee responsible and assign that employee in the transaction .

In case multiple records are maintained for the same role and same sales area then the system will assign the one which is marked as main in the account master record.

 

P90.jpg

Fig 6 : Sample relationship setup

So in case the sales area determined in the transaction is SO1/D1/DIV1 and hence E1 will be determined .

 

For custom party roles the system also the offers the possibility to configure party determination using rules . For example you can define on what conditions should a party role be determined in the transaction as shown below. the rules are considered in the party determination procedure  as shown in fig 9.

P99.jpg

 

Fig 7 : Rule definition for Transactions party determinations .

 

P100.jpg

Fig 8: Determination steps using rules.

 

Follow up from transaction in party determination :- In case you are creating transaction as a follow up or copy , the sytem will copy the relevant party roles from the preceding document . This will by default be the first determination step for all party roles .

 

 

 

Other blog posts on this topic.

 

Party Role Determination in a Sales Document for Cloud for Customer

also http://scn.sap.com/docs/DOC-6921455

Viewing all 262 articles
Browse latest View live


<script src="https://jsc.adskeeper.com/r/s/rssing.com.1596347.js" async> </script>