| Description | Maintain ERP Utilities Customer |
| Name | ManageERPCustomerBundleIn |
| Namespace | http://sap.com/xi/A1S/Global |
| Process Component Description | Utilities Management |
| Process Component Name | UtilitiesManagment |
| Process Component Namespace | http://sap.com/xi/AP/CRM/Global |
| Deploymnent Unit Description | Customer Relationship Management |
| Endpoint Activation | By Scoping of Process Component | Operations |
| Release Status | Not Released |
An interface to replicate Business Partner data from an SAP Business Suite system.
The web service interface Maintain Customer 360 In enables you to connect external data sources to SAP C4C systems. The web service interface Maintain Customer 360 In is relevant if your company wants to access and manage Business Partner data from external data sources
Existence of required master data in the system, like:
Business Partners, Contract Accounts
Action codes represent an instruction to the recipient of the web service request to process transmitted message node elements.
Action Code Description
01 Create; the system returns an error message if the node element already exists.
02 Update; the system returns an error message if the node element does not exist.
03 Delete; the system returns an error message if the node element does not exist.
04 Save; the system creates or changes the node element data.
05 Remove; the system deletes the node element. If the node element does not exist, the system does not send an error message.
06 No Action; the system does not change the node element.
Default action code: 04 (Save).
Note: Action code 04 (Save) creates business documents if the system can not identify a matching target business document. This applies in particular if no business document ID or UUID is provided by the web service consumer. The web service consumer (external application) is responsible for providing correct business document IDs or UUIDs. This will avoid accidentially creating duplicate business documents.
List Processing
The processing of node elements with cardinality > 1 (for example a list of descriptions in different languages or a list of telephone numbers) can be controlled using List Complete Transmission Indicators (LCTI). The LCTI indicates whether a list of node elements is transmitted completely. The LCTI of a node element with cardinality > 1 is modeled as an attribute of its parent node element (attribute name: <name of child element>ListCompleteTransmissionIndicator).
LCTI Description
false The list of node elements is not completely transmitted. Hence, all node elements that are not transmitted remain unchanged. If transmitted node elements in the list can be uniquely identified, the system processes the node elements according to the action code. If transmitted node elements in the list cannot be uniquely identified, the system appends the node element to the corresponding list of node elements in the target business document.
true The list of elements is completely transmitted. Hence, all node elements that are not transmitted are deleted. If no node element is transmitted, all the node elements in the system will be removed.
Default list complete transmission indicator: false.
Note: The LCTI refers to the completeness of the list of node elements and does not imply completeness of sub-elements.
Empty and Missing Elements
Optional leaf elements in request messages that are not transmitted within a web service request are not changed in corresponding business documents.
Change State ID
Using change state identifier (element name ChangeStateID), external applications can ensure that a modifying operation is not executed because the state of the business document has changed since the external application last read its data.
The change state ID is an uninterpretable string that is provided by query and read operations and can be utilized by all modifying operations. If the change state identifier is provided when calling a modifying operation, the system does not perform the operation if the state of the business document instance has changed since the change state ID was computed. If the change state ID is not provided by the web service consumer, the system performs the web service operation without checking the state of the business document.
The web service consumer (external application) is responsible for preventing accidental changes to business documents.
Note: For this web service the change state ID does not apply to the ContactPerson, Relationship, CommunicationArrangement, DirectResponsibility, SalesArrangement, or PaymentData node elements.
Object Node Sender Technical Identifier
Request node elements with cardinality > 1 contain an object node sender technical identifier to relate response message elements and log items to corresponding node elements in the request message.
The object node sender technical identifiers are provided as ObjectNodeSenderTechnicalID in request message types and referred to as ReferenceObjectNodeSenderTechnicalID in corresponding response message types.
If the object node sender technical ID is initial, the object node sender technical ID of the parent node element in the request is returned as the reference object node sender technical ID. If the object node sender technical IDs of all parent node elements are initial, the reference object node sender technical ID is returned as initial as well.
Note: The values specified in the ObjectNodeSenderTechnicalID are transient values that establish the correspondence between elements for only a single call. The web service consumer is not required to specify them or to use the same values for different calls. Also, the service provider does not interpret these values at all. Instead, the service provider returns them to the web service consumer in the ReferenceObjectNodeSenderTechnicalID elements.
Note: The ObjectNodeSenderTechnicalID is also used to identify failed business document modifications in a mass operation.
Example
Request:
<Child>
<ObjectNodeSenderTechnicalID>999_A<ObjectNodeSenderTechnicalID>
<Content>Child A: Some correct content</Content>
</Child>
<Child>
<ObjectNodeSenderTechnicalID>999_B<ObjectNodeSenderTechnicalID>
<Content>Child B: Some erroneous content</Content>
</Child>
Response:
<Log>
<Item>
<ReferenceObjectNodeSenderTechnicalID>999_B </ReferenceObjectNodeSenderTechnicalID>
<Note>Error message for Child B</Note>
</Item>
</Log>
Response Message
The structure of the response message consists of two parts:
A business document-specific part containing information about IDs and UUIDs of the created and changed business documents
Log items containing system messages including errors, warnings, and information messages raised by the system during processing of the web service request
None.
| Description | Maintain customer 360 |
| Name | MaintainERPCustomerBundle |
| Synchronous | yes |
| Release Status | Deprecated |
An interface to replicate Business Partner data from an SAP Business Suite system.
The web service interface Maintain Customer 360 In enables you to connect external data sources to SAP C4C systems. The web service interface Maintain Customer 360 In is relevant if your company wants to access and manage Business Partner data from external data sources
Existence of required master data in the system, like:
Business Partners, Contract Accounts
Billing Information, Contracts Information, Service Orders,
Action Code
Action codes represent an instruction to the recipient of the web service request to process transmitted message node elements.
Action Code Description
01 Create; the system returns an error message if the node element already exists.
02 Update; the system returns an error message if the node element does not exist.
03 Delete; the system returns an error message if the node element does not exist.
04 Save; the system creates or changes the node element data.
05 Remove; the system deletes the node element. If the node element does not exist, the system does not send an error message.
06 No Action; the system does not change the node element.
Default action code: 04 (Save).
Note: Action code 04 (Save) creates business documents if the system can not identify a matching target business document. This applies in particular if no business document ID or UUID is provided by the web service consumer. The web service consumer (external application) is responsible for providing correct business document IDs or UUIDs. This will avoid accidentially creating duplicate business documents.
LCTI Description
false The list of node elements is not completely transmitted. Hence, all node elements that are not transmitted remain unchanged. If transmitted node elements in the list can be uniquely identified, the system processes the node elements according to the action code. If transmitted node elements in the list cannot be uniquely identified, the system appends the node element to the corresponding list of node elements in the target business document.
true The list of elements is completely transmitted. Hence, all node elements that are not transmitted are deleted. If no node element is transmitted, all the node elements in the system will be removed.
Request:
<Child>
<ObjectNodeSenderTechnicalID>999_A<ObjectNodeSenderTechnicalID>
<Content>Child A: Some correct content</Content>
</Child>
<Child>
<ObjectNodeSenderTechnicalID>999_B<ObjectNodeSenderTechnicalID>
<Content>Child B: Some erroneous content</Content>
</Child>
Response:
<Log>
<Item>
<ReferenceObjectNodeSenderTechnicalID>999_B </ReferenceObjectNodeSenderTechnicalID>
<Note>Error message for Child B</Note>
</Item>
</Log>
Response Message
The structure of the response message consists of two parts:
A business document-specific part containing information about IDs and UUIDs of the created and changed business documents
Log items containing system messages including errors, warnings, and information messages raised by the system during processing of the web service request
Show full documentation
Show full documentation