Show full documentation

 Show full documentation

Definition

An interface to create and update a service confirmation

Business Context and Use

This web-service is used to create or modify existing service confirmation.

It consists of the MaintainBundle operation. The MaintainBundle is used to create or update one or more instances of the service confirmation.

Prerequisites

• The interface can be used to create a service confirmation only by the action create with reference.

• The interface can be used to update an existing service confirmation.

• The interface can not be used to update an instance with the create operation. The update needs to be send separately in the next session.

Example

• The request below will create a service confirmation with reference to the provided service order.

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <BasicMessageHeader>
 </BasicMessageHeader>
 <ServiceConfirmation>
  <CreateWithReferenceToServiceOrder>true</CreateWithReferenceToServiceOrder>
  <BaseServiceOrderID>195</BaseServiceOrderID>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

The response would contain the result of the above operation.

In case of successful execution, the response would contain the Service Confirmation ID and UUID.

• The following is the response for successful execution of the request above.

Response

<nm:ServiceConfirmationBundleMaintainConfirmation_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com>
 <ServiceConfirmation>
  <ID>291</ID> 
  <UUID>00163e02-8660-1ed2-a4f3-e8edaa34aad3</UUID> 
  <ChangeStateID>20130323095150.6414670</ChangeStateID> 
 </ServiceConfirmation>
</nm:ServiceConfirmationBundleMaintainConfirmation_sync>

In case of a failed execution, the response would contain error message(s) in the log.

• The following is a sample XML for updating a service confirmation by adding an item and updating the buyerID.

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <BasicMessageHeader/>
 <ServiceConfirmation>
  <ID>291</ID>
  <BuyerID>Token20</BuyerID>
  <Item ActionCode="01">
   <ID>30</ID>
   <Description languageCode="EN">String 121</Description>
   <Product ActionCode="01">
    <ProductInternalID>MCD-0498</ProductInternalID>
   </Product>
  </Item>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

• To update the quantity with a different unit you need to supply the QuantityMeasureUnitCode at the Product. The following XML adds an item with quantity 8 day(s)

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <BasicMessageHeader/>
 <ServiceConfirmation ItemListCompleteTransmissionIndicator="false">
  <ID>306</ID>
  <Item actionCode="04">
   <ID>20</ID>
   <Product>
    <ProductInternalID>MCD-0498</ProductInternalID>
    <QuantityMeasureUnitCode>DAY</QuantityMeasureUnitCode>
   </Product>
   <ScheduleLine>
   <Quantity unitCode="DAY">8</Quantity>
   </ScheduleLine>
  </Item>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

Invoke Action

• The following is a sample XML request to call upon the action FinishFulfilmentProcessing (Release Item without order completion) for the Item.

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <ServiceConfirmation>
  <ID>291</ID>
  <Item>
   <ID>10</ID>
   <FinishFulfilmentProcessingItem>true</FinishFulfilmentProcessingItem>
  </Item>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

• The following is a sample XML request to call upon the action ConfirmExecutionItem (Complete service confirmation item with completion of corresponding order item) for the Item.

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <ServiceConfirmation>
  <ID>306</ID>
  <Item>
   <ID>10</ID>
   <ConfirmExecutionItem>true</ConfirmExecutionItem>
  </Item>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

Constraints and Integrity Conditions

More Information

General Information

You can find general information about Web services, their structure and consumption in the Web Services documentation. Please open the Web Services document in a new window.

Scenarios

In the following scenario, two service confirmation are created in one request.

Request

<n0:ServiceConfirmationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
 <BasicMessageHeader>
 </BasicMessageHeader>
 <ServiceConfirmation>
  <CreateWithReferenceToServiceOrder>true</CreateWithReferenceToServiceOrder>
  <BaseServiceOrderID>195</BaseServiceOrderID>
 </ServiceConfirmation>
 <ServiceConfirmation>
  <CreateWithReferenceToServiceOrder>true</CreateWithReferenceToServiceOrder>
  <BaseServiceOrderID>200</BaseServiceOrderID>
 </ServiceConfirmation>
</n0:ServiceConfirmationBundleMaintainRequest_sync>

Response

<nm:ServiceConfirmationBundleMaintainConfirmation_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:ASL:/1SAI/TAEE6C08A29BF52D55485CD:804">
<ServiceConfirmation>
<ID>293</ID>
<UUID>00163e02-8660-1ed2-a4f4-20e2ab9b2b2d</UUID>
<ChangeStateID>20130323100419.8800150</ChangeStateID>
</ServiceConfirmation>
<ServiceConfirmation>
<ID>294</ID>
<UUID>00163e02-8660-1ed2-a4f4-20e2ab9bcb2d</UUID>
<ChangeStateID>20130323100419.8800150</ChangeStateID>
</ServiceConfirmation>
</nm:ServiceConfirmationBundleMaintainConfirmation_sync>

 Show full documentation

 Show full documentation

No documentation available.