Description | Manage Sales Quotes |
Name | ManageCustomerQuoteIn |
Namespace | http://sap.com/xi/A1S/Global |
Product | SAP Business ByDesign |
Process component | Customer Quote Processing |
Process component namespace | http://sap.com/xi/AP/CRM/Global |
Deployment unit | Customer Relationship Management |
Endpoint Activation | By Scoping of Process Component | Operations |
|
Release Status | Released |
Technical documentation on the SAP API Business Hub | Manage Sales Quotes |
General web service documentation | A2X Web Services (SOAP) |
An interface to replicate or create customer quotes from a source system or file to a target system.
This Web service is used to create, modify, and delete existing customer quotes.
It has the MaintainBundle and CheckMaintainBundle operations. The MaintainBundle is used to update one or more instances of the Customer Quote business object. The CheckMaintainBundle is used to check if the one or more instances of the Customer Quote business object can be maintained.
For an Account to be used in a Customer Quote, its Sales Arrangement needs to be maintained. Otherwise currency will not be determined.
To create a simple consistent CustomerQuote, the consumer has to provide the Account Party information and one or more Items.
Example
The following request would create a Customer Quote with the following information:
Customer Quote with ID returned in response,
Buyer ID as PSM CRM ABSL Test - Example_01,
Posting date as 2006-03-28T12:00:00.1234567Z,
Customer Quote name as PSM CRM ABSL Test - CallCustomerQuoteExample1,
Item ID as 10,
Item date as 2006-03-28T12:00:00.1234567Z,
Item product as MCF-0001,
Buyer party as MC9785.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote> <BuyerID>PSM CRM ABSL Test - Example_01</BuyerID> <DateTime>2006-03-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">PSM CRM ABSL Test - CallzCustomerQuoteExample1</Name> <Item> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">6</Quantity> </ItemScheduleLine> </Item> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response would contain the result of the above operation.
In case of successful execution, the response would contain the Customer Quote ID and UUID.
The following is the response for successful execution of the above request.
Response
<nm:CustomerQuoteBundleMaintainConfirmation_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy"> <CustomerQuote> <ChangeStateID>20121211062856.7192640</ChangeStateID> <UUID>00163e02-86fa-1ed2-90eb-8122c5b94ae3</UUID> <ID>611</ID> </CustomerQuote> </nm:CustomerQuoteBundleMaintainConfirmation_sync>
In case of failed execution, the response would contain error message(s).
To Create multiple Items via the web service use items node in the XML.
Here is a sample XML for creating a new customer quote with 2 items.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <BuyerID>PSM CRM ABSL Test - Example_01</BuyerID> <DateTime>2006-03-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">PSM CRM ABSL Test - CallzCustomerQuoteExample1</Name> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">6</Quantity> </ItemScheduleLine> </Items> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCF-0036</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">10</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Here is a sample XML for creating a simple consistent Customer Quote with two Item, Account, BillTo and SalesUnit information.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <BillToParty> <PartyID>MC6049</PartyID> </BillToParty> <BuyerID>ExternalReference_101</BuyerID> <Name>CustomerQuote_Description_test</Name> <PostingDate>2011-10-13T15:30:00Z</PostingDate> <DataOriginTypeCode>4</DataOriginTypeCode> <Items> <ID>10</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>5</Quantity> </ItemScheduleLine> </Items> <Items> <ID>20</ID> <ItemProduct> <ProductInternalID>MCF-0036</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>5</Quantity> </ItemScheduleLine> </Items> <RequestedFulfillmentPeriodPeriodTerms> <StartDateTime timeZoneCode="UTC">2011-11-20T00:00:00Z</StartDateTime> </RequestedFulfillmentPeriodPeriodTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Elements | Description |
---|---|
FollowUpProcessingTypeCustomerContractIndicator | An indicator to indicate this service call is creating a Quote for Contract |
Indicator | |
Not a quote for contract | |
X | Create a quote for contract |
Elements | Description |
---|---|
FollowUpProcessingTypeServiceOrderIndicator | An indicator to indicate this service call is creating a Service Quote or not. |
Indicator | |
Not a service quote | |
X | Create a service quote |
Elements | Description |
---|---|
DistributionChannelCode | A distribution channel is a channel via which goods or services reach the customer. |
Code Value Description | |
01 Direct sales | |
02 Indirect sales |
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <BuyerID>ExternalReference_ID</BuyerID> <DataOriginTypeCode>4</DataOriginTypeCode> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <BillToParty> <PartyID>MC6049</PartyID> </BillToParty> <SalesAndServiceBusinessArea actionCode="01"> <DistributionChannelCode>01</DistributionChannelCode> </SalesAndServiceBusinessArea> <RequestedFulfillmentPeriodPeriodTerms> <StartDateTime timeZoneCode="UTC">2011-11-20T00:00:00Z</StartDateTime> </RequestedFulfillmentPeriodPeriodTerms> <Item> <ID>10</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>5</Quantity> </ItemScheduleLine> </Item> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
CashDiscountTermsCode is a coded representation of an agreement of cash discounts for a payment.
CashDiscountTermsCode is used in sales orders, purchase orders, and invoices. The corresponding terms of payment deliver information for financial planning, dunning, and payment transactions. Examples of the possible semantics of the codes are:
· 14 days 3%, 30 2%, 45 net: Payable in 45 days without deduction or within 30 days with 2% cash discount or within 14 days with 3%
· Days 0%, 0/0, 0 net: Payable immediately without deductions
ServiceTerms are the characteristics used for valuation of the services in the Sales Order.
Elements | Description |
---|---|
WarrantyID | The warranty product's ID |
ServicePriorityCode | A coded representation of the (linear ordered) ranking of urgencies. |
ServiceProvisionLocationTypeCode | A coded representation of the type of a location at which a service will be provided. |
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <Name languageCode="EN">Service Quote 1</Name> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <ServiceTerms> <ServicePriorityCode>7</ServicePriorityCode> <WarrantyID>MCG-0101</WarrantyID> <ServiceProvisionLocationTypeCode>2</ServiceProvisionLocationTypeCode> </ServiceTerms> <ServicePointLocation> <LocationID>MC67810</LocationID> </ServicePointLocation> <WarrantyStartReferenceTimePoint> <StartDateTime>2016-03-01T00:00:00Z</StartDateTime> </WarrantyStartReferenceTimePoint> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
PricingTerms are the characteristics used for pricing and valuation of goods and services in the Sales
Order.
Elements | Description |
---|---|
CurrencyCode | Currency for the valuation of the goods and services ordered (document currency). |
PriceDateTime | Price date at which price specifications are determined using a rule for automatic scheduling. |
GrossAmountIndicator | An indicator that specifies whether or not price and/or value is given |
as gross amount (including taxes). |
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <DataOriginTypeCode>4</DataOriginTypeCode> <PricingTerms> <CurrencyCode>EUR</CurrencyCode> <PriceDateTime timeZoneCode="DFT">2011-10-28T12:00:00.0000000Z</PriceDateTime> <GrossAmountIndicator>true</GrossAmountIndicator> </PricingTerms> <Item> <ID>10</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> </Item> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A price and tax calculation is the summary of the determined price and tax components for a business case. A specification of the general procedure for price and tax determination and valuation using
attributes those are characteristic or relevant for the whole object.
Note: PriceAndTaxCalculation cannot be created but can only be modified. So this means that if the consumer wishes to change the ‘Discount’ or ‘Freight’ charge, then the consumer has to create the order first and then make a second web-service request to the update this customer quote with the pricing information that is to be changed.
The two types of freights charges are
TypeCode – 7PR8 – An absolute amount which is maintained at the customer quote document level.
TypeCode – 7PRD – A net-weight depenedent amount which is deteremined automatically on item level (sample xml)
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <ObjectNodeSenderTechnicalID>72</ObjectNodeSenderTechnicalID> <ChangeStateID>20121211081110.4676740</ChangeStateID> <ID>527</ID> <PriceAndTaxCalculation> <MainDiscount actionCode="04"> <Rate> <DecimalValue>25</DecimalValue> </Rate> </MainDiscount> <PriceComponent> <UUID>00163e01-2e13-1ee0-bcff-65cddc6b117f</UUID> <Rate> <DecimalValue>70</DecimalValue> </Rate> </PriceComponent> © SAP AG 2011 35 <PriceComponent> <TypeCode>7PRB</TypeCode> <Rate> <DecimalValue>7</DecimalValue> </Rate> </PriceComponent> </PriceAndTaxCalculation> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A TextCollection is a collection of all textual descriptions which are related to a Customer Quote. Each text can include formatting information.
Elements | Description |
---|---|
TypeCode | Defines the text type and thus main settings for the text. |
10011 Internal Comment | |
10014 Remark for Supplier | |
10024 Customer Information |
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <ID>627</ID> <TextCollection> <Text> <ObjectNodeSenderTechnicalID>9518</ObjectNodeSenderTechnicalID> <TypeCode>10024</TypeCode> <ContentText>This information is for the Customer</ContentText> </Text> </TextCollection> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
An Attachment Folder is the collection of all documents attached to a Customer Quote.
Elements | Description |
---|---|
TypeCode | Coded representation of the document category, such as Folder, File or Link. |
Code Value Description | |
1 Folder | |
2 Document | |
3 Link |
*Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <BuyerID>new_test</BuyerID> <Name languageCode="EN">new_test</Name> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <Item> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> </Item> <AttachmentFolder> <Document> <VisibleIndicator>true</VisibleIndicator> <CategoryCode>2</CategoryCode> <TypeCode>10001</TypeCode> <MIMECode>text/plain</MIMECode> <Name>New Text Document(2).txt</Name> <AlternativeName>Test Document (txt)</AlternativeName> <Description>This is a file attachment</Description> <FileContent ActionCode="01"> <BinaryObject mimeCode="text/plain">VGhpcyBpcyBhIHRlc3QgZG9jdW1lbnQu</BinaryObject> </FileContent> </Document> <Document> <VisibleIndicator>true</VisibleIndicator> <CategoryCode>3</CategoryCode> <TypeCode>10001</TypeCode> <Name>www.testlink.com</Name> <AlternativeName>Test Link</AlternativeName> <Description>This is atest Link</Description> <ExternalLinkWebURI>http://www.testlink.com</ExternalLinkWebURI> <FileContentURI>http://www.testlink.com</FileContentURI> </Document> </AttachmentFolder> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
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.
In the following scenario, we are creating a two customer quote in one request. Then for one customer quote the ProductRecepient (ShipTo) address is modified, which leads to a change in the freight charge. And in the second quote additional items are added to the order along with a the discount level.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <DataOriginTypeCode>4</DataOriginTypeCode> <Item> <ID>10</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> </Item> <Item> <ID>40</ID> <ItemProduct> <ProductInternalID>MCF-0036</ProductInternalID> </ItemProduct> </Item> <RequestedFulfillmentPeriodPeriodTerms> <StartDateTime timeZoneCode="UTC">2011-11-20T00:00:00Z </StartDateTime> </RequestedFulfillmentPeriodPeriodTerms> </CustomerQuote> <CustomerQuote> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <DataOriginTypeCode>4</DataOriginTypeCode> <Item> <ID>10</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> </Item> <Item> <ID>30</ID> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> </ItemProduct> </Item> <RequestedFulfillmentPeriodPeriodTerms> <StartDateTime timeZoneCode="UTC">2011-11-20T00:00:00Z </StartDateTime> </RequestedFulfillmentPeriodPeriodTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response
<nm:CustomerQuoteBundleMaintainConfirmation_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:QSC:/1SAI/TAS25A1C3A40B51EDB4546F:804"> <CustomerQuote> <ChangeStateID>20121211083613.7582190</ChangeStateID> <UUID>00163e02-9074-1ed2-90ed-b94e5423e006</UUID> <ID>532</ID> </CustomerQuote> <CustomerQuote> <ChangeStateID>20121211083613.7582190</ChangeStateID> <UUID>00163e02-9074-1ed2-90ed-b8bd49262004</UUID> <ID>531</ID> </CustomerQuote> <Log> <MaximumLogItemSeverityCode>3</MaximumLogItemSeverityCode> <Item> <TypeID>151(/CL_CDA_DOCIT/)</TypeID> <CategoryCode>ENV.CBM</CategoryCode> <SeverityCode>2</SeverityCode> <Note>Net volume for product missing</Note> </Item> </Log> </nm:CustomerQuoteBundleMaintainConfirmation_sync>
Note: The messages in the Log vary from system to system based on the configuration. In this particular test system, the net volume and gross weight of the products were not maintained hence the warning messages related to this information in passed in the response.
Now at this stage, the consumer decides to add 2 more items, update the shipping address of the first quote and the freight charges are also changed or created for the Quote. To determine if the freight charge is defaulted by the system or its needs to be created new, the consumer has to read the existing Customer Quote and check the PriceAndTaxCalculation node for PriceComponents with freight charge information. This query call is part of A2X QueryCustomerQuoteIn (operation: FindByElements)
<n0:CustomerQuoteByElementsQuery_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuoteSelectionByElements> <SelectionByID> <InclusionExclusionCode>I</InclusionExclusionCode> <IntervalBoundaryTypeCode>1</IntervalBoundaryTypeCode> <LowerBoundaryID>531</LowerBoundaryID> </SelectionByID> </CustomerQuoteSelectionByElements> <ProcessingConditions> <QueryHitsUnlimitedIndicator>true</QueryHitsUnlimitedIndicator> </ProcessingConditions> </n0:CustomerQuoteByElementsQuery_sync>
And from the response, the consumer deducts that there is not price component for "Freight" charge.
So in the next call, the freight charge has to be created.
Meanwhile, the customer has requested the addition of a material item to the second quote along with the existing items.
So in our next request the following is performed:
Quote 531:
2 more items are added
A new shipping address
Freight charge of 47 USD due to change in address and additional items
Quote 532:
An additional material item
Note: In the following request, as the consumer is creating additional items with ItemScheduleLine information, the attribute itemScheduleLineListCompleteTransmissionIndicator at Item node has to be set to true. Please refer to the Child Node – ItemScheduleLine (multiple cardinality) for more details.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote> <ID>531</ID> <ProductRecipientParty partyContactPartyListCompleteTransmissionIndicator="true"> <PartyID>MC6049</PartyID> <Address> <CorrespondenceLanguageCode>EN</CorrespondenceLanguageCode> <Email> <URI>email2.test@testdata.com</URI> <UsageDeniedIndicator>true</UsageDeniedIndicator> </Email> <Telephone> <Number> <AreaID>0518</AreaID> <SubscriberID>482</SubscriberID> <ExtensionID>4812</ExtensionID> <CountryCode>US</CountryCode> </Number> <FormattedNumberDescription>+1 (518) 482-4812</FormattedNumberDescription> <DefaultConventionalPhoneNumberIndicator>true</DefaultConventionalPhoneNumberIndicator> <DefaultMobilePhoneNumberIndicator>true</DefaultMobilePhoneNumberIndicator> <UsageDeniedIndicator>false</UsageDeniedIndicator> <MobilePhoneNumberIndicator>true</MobilePhoneNumberIndicator> <SMSEnabledIndicator>false</SMSEnabledIndicator> </Telephone> <DisplayName> <FormattedName languageCode="EN">Josep King</FormattedName> </DisplayName> <Name> <Name> <FormOfAddressCode>0001</FormOfAddressCode> <FirstLineName>Josep</FirstLineName> <SecondLineName>Steven</SecondLineName> <ThirdLineName>King</ThirdLineName> </Name> </Name> <PostalAddress> <CountryCode>US</CountryCode> <RegionCode>NY</RegionCode> <CountyName>USA</CountyName> <CityName>Albany</CityName> <StreetPostalCode>12205</StreetPostalCode> <StreetPrefixName>M3 Samson Court</StreetPrefixName> <AdditionalStreetPrefixName>Pacific Coast Region</AdditionalStreetPrefixName> <StreetName>Wolf Rd</StreetName> <StreetSuffixName>Atlantis</StreetSuffixName> <CareOfName>Wayne Josep.</CareOfName> <TaxJurisdictionCode>NYAL0181</TaxJurisdictionCode> <TimeZoneCode>EST</TimeZoneCode> </PostalAddress> </Address> </ProductRecipientParty> <Item itemScheduleLineListCompleteTransmissionIndicator="true"> <ID>20</ID> <ItemProduct> <ProductInternalID>MCF-0002</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>28</Quantity> </ItemScheduleLine> </Item> <Item itemScheduleLineListCompleteTransmissionIndicator="true"> <ID>30</ID> <ItemProduct> <ProductInternalID>MCF-0005</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>8</Quantity> </ItemScheduleLine> </Item> <PriceAndTaxCalculation> <PriceComponent actionCode="01"> <TypeCode>7PR8</TypeCode> <Rate> <DecimalValue>47</DecimalValue> </Rate> </PriceComponent> </PriceAndTaxCalculation> </CustomerQuote> <CustomerQuote> <ID>532</ID> <Item itemScheduleLineListCompleteTransmissionIndicator="true"> <ID>30</ID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> </ItemProduct> <ItemScheduleLine> <Quantity>13</Quantity> </ItemScheduleLine> </Item> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response
<nm:CustomerQuoteBundleMaintainConfirmation_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:QSC:/1SAI/TAS25A1C3A40B51EDB4546F:804"> <Log> <MaximumLogItemSeverityCode>3</MaximumLogItemSeverityCode> <Item> <TypeID>153(/CL_CDA_DOCIT/) </TypeID> <CategoryCode>ENV.CBM</CategoryCode> <SeverityCode>2</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>006</ReferenceObjectNodeSenderTechnicalID> <Note>Gross weight for product missing</Note> </Item> <Item> <TypeID>152(/CL_CDA_DOCIT/)</TypeID> <CategoryCode>ENV.CBM</CategoryCode> <SeverityCode>2</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>006</ReferenceObjectNodeSenderTechnicalID> <Note>Net weight for product missing</Note> </Item> <Item> <TypeID>188(/CL_CDA_DOCIT/)</TypeID> <CategoryCode>ENV.CBM</CategoryCode> <SeverityCode>2</SeverityCode> <Note>The sales organization and distribution channel in the document do not match with the product master sales data. Check your entries in the document or the product master.</Note> </Item> </Log> </nm:SalesOrderBundleMaintainConfirmation_sync>
Now we are using the interface to create a Quote for Contract with two items and also add two covered product to this quote.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <BuyerID>MC9785</BuyerID> <DateTime>2016-10-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">Quote for contract 1</Name> <ObjectNodeSenderTechnicalID>1</ObjectNodeSenderTechnicalID> <FollowUpProcessingTypeCustomerContractIndicator>true</FollowUpProcessingTypeCustomerContractIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ObjectNodeSenderTechnicalID>11</ObjectNodeSenderTechnicalID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> <ValidityItemPeriod> <StartDateTime>2016-05-21</StartDateTime> <EndDateTime>2016-05-21</EndDateTime> </ValidityItemPeriod> </Items> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ObjectNodeSenderTechnicalID>12</ObjectNodeSenderTechnicalID> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">15</Quantity> </ItemScheduleLine> <ValidityItemPeriod> <StartDateTime>2016-05-20</StartDateTime> <EndDateTime>2016-05-23</EndDateTime> </ValidityItemPeriod> </Items> <CashDiscountTermsCode>1004</CashDiscountTermsCode> <ValidityPeriodPeriodTerms> <StartDateTime>2016-05-13</StartDateTime> <EndDateTime>2016-05-28</EndDateTime> </ValidityPeriodPeriodTerms> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesTerms> <CustomerContractRenewalAgreementCode>3</CustomerContractRenewalAgreementCode> <CustomerContractCancellationAgreementCode>1</CustomerContractCancellationAgreementCode> </SalesTerms> <MinimumContractValidity> <MinimunValidityDuration>P1D</MinimunValidityDuration> </MinimumContractValidity> <CoveredObject> <CoveredProduct> <ProductCategory>30</ProductCategory> </CoveredProduct> <CoveredProduct> <ProductID>10000100</ProductID> <Description languageCode="EN">Covered Product 01</Description> </CoveredProduct> <CoveredRegisteredProduct> <RegisteredProductID>MCF-0040-01</RegisteredProductID> </CoveredRegisteredProduct> </CoveredObject> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response
<n0:CustomerQuoteBundleMaintainConfirmation_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:ACL:/1SAI/TAE25A1C3A40B51EDB4546F:804"> <CustomerQuote> <ChangeStateID> 20160607015426.2929320</ChangeStateID> <ReferenceObjectNodeSenderTechnicalID>1</ReferenceObjectNodeSenderTechnicalID> <UUID>00163e07-3d66-1ed6-8b8a-57b650442be5</UUID> <ID>6100</ID> </CustomerQuote> <Log/> </n0:CustomerQuoteBundleMaintainConfirmation_sync>
Using the interface to create a service quote.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <BuyerID>MC9785</BuyerID> <DateTime>2016-10-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">Service Quote 1</Name> <ObjectNodeSenderTechnicalID>3</ObjectNodeSenderTechnicalID> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <VendorParty> <PartyID>MC8000</PartyID> </VendorParty> <ServiceExecutionTeamParty> <PartyID>MC45110</PartyID> </ServiceExecutionTeamParty> <ServicePerformerParty> <PartyID>MC2854</PartyID> </ServicePerformerParty> <ProcessorParty> <PartyID>MC2471</PartyID> </ProcessorParty> <ServiceAndSupportTeamParty> <PartyID>MC45320</PartyID> </ServiceAndSupportTeamParty> <ServiceReferenceObject actionCode="01"> <MainIndicator>true</MainIndicator> <ReferenceProductKey> <ProductID>SN28791</ProductID> </ReferenceProductKey> </ServiceReferenceObject> <ServiceReferenceObject actionCode="01"> <MainIndicator>false</MainIndicator> <ReferenceProductKey> <ProductID>SN28792</ProductID> </ReferenceProductKey> </ServiceReferenceObject> <ServiceTerms> <ServicePriorityCode>7</ServicePriorityCode> <WarrantyID>MCG-0101</WarrantyID> <ServiceProvisionLocationTypeCode>2</ServiceProvisionLocationTypeCode> </ServiceTerms> <ServicePointLocation> <LocationID>MC67810</LocationID> </ServicePointLocation> <MainIncidentServiceIssueCategory> <IncidentCategory>C1411</IncidentCategory> <ServiceCategory>C14</ServiceCategory> </MainIncidentServiceIssueCategory> <WarrantyStartReferenceTimePoint> <StartDateTime>2016-03-01T00:00:00Z</StartDateTime> </WarrantyStartReferenceTimePoint> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response
<n0:CustomerQuoteBundleMaintainConfirmation_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:ACL:/1SAI/TAE25A1C3A40B51EDB4546F:804"> <CustomerQuote> <ChangeStateID> 20160607015633.5784480</ChangeStateID> <ReferenceObjectNodeSenderTechnicalID>3</ReferenceObjectNodeSenderTechnicalID> <UUID>00163e07-3d66-1ed6-8b8a-618faec74c0f</UUID> <ID>6101</ID> </CustomerQuote> <Log> <MaximumLogItemSeverityCode>2</MaximumLogItemSeverityCode> <Item> <TypeID>160(/CL_CDA_DOCIT/)</TypeID> <CategoryCode>ENV.CBM</CategoryCode> <SeverityCode>2</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>3</ReferenceObjectNodeSenderTechnicalID> <Note>Marked for internal fulfillment, but Service Performer is external</Note> </Item> <Item> <TypeID>147(/AP_TTE_DO_TAXDOC/)</TypeID> <CategoryCode>ENV.COM</CategoryCode> <SeverityCode>2</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>3</ReferenceObjectNodeSenderTechnicalID> <Note>Jurisdiction code missing in address of Supplier MC8000 (ABM); default state Ohio</Note> </Item> </Log> </n0:CustomerQuoteBundleMaintainConfirmation_sync>
This interface supports extensibility
Example
The following XML tag could be used to create (a) Customer Quote with the extension field value 'EXT...' as 'ABC'.
This extension field would also (return) as part of the response to the query operation.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote> <BuyerID>PSM CRM ABSL Test - Example_01</BuyerID> <DateTime>2006-03-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">PSM CRM ABSL Test - CallCustomerQuoteExample1</Name> <Item> <ID>10</ID> <DateTime>2006-03-28T12:00:00.1234567Z</DateTime> <Product> <ProductKey> <ProductTypeCode>1</ProductTypeCode> <ProductID>MCF-0001</ProductID> </ProductKey> </Product> <FirstRequestedItemScheduleLine> <Quantity unitCode="EA">2</Quantity> </FirstRequestedItemScheduleLine> </Item> <BuyerParty> <PartyKey> <PartyID>MC9785</PartyID> </PartyKey> </BuyerParty> <n1:EXTExt100163E02E6621ED1BCCD562E23AE156C xmlns:n1="http://sap.com/xi/AP/CustomerExtension/BYD/ZZZZZ">Extesnion value</n1:EXTExt100163E02E6621ED1BCCD562E23AE156C> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Response
<n0:CustomerQuoteByElementsQuery_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuoteSelectionByElements> <SelectionByID> <InclusionExclusionCode>I</InclusionExclusionCode> <IntervalBoundaryTypeCode>1</IntervalBoundaryTypeCode> <LowerBoundaryID>[ID created in the above operation]</LowerBoundaryID> </SelectionByID> </CustomerQuoteSelectionByElements> <ProcessingConditions> <QueryHitsMaximumNumberValue>285</QueryHitsMaximumNumberValue> <QueryHitsUnlimitedIndicator>false</QueryHitsUnlimitedIndicator> </ProcessingConditions> </n0:CustomerQuoteByElementsQuery_sync>
The following request xml marks the quote as completed using element StatusCompletedIndicator. In fact the element triggers the business object action NotifyOfSalesOrderCreation which corresponds to the UI action Submit Quote.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="false" actionCode="02"> <ID>51</ID> <StatusCompletedIndicator>true</StatusCompletedIndicator> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
The following request xml reopens a completed quote using element StatusOpenIndicator. In fact the element triggers the business object action NotifyOfSalesOrderDeletion which corresponds to the UI action Change Status - Open.
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="false" actionCode="02"> <ID>51</ID> <StatusOpenIndicator>true</StatusOpenIndicator> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
The following request xml will creates a new quote and submit and sent the quote to the account, as the SubmitIndicator is true.
Note:Approvals is scoped for quotes then on executing the xml with SubmitIndicator set to true, the quote document is sent for Approval and ApprovalStatus set to "In Approval"
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <BuyerID>Quote Release Test</BuyerID> <DateTime>2020-06-09T12:00:00.1234567Z</DateTime> <Name languageCode="EN">Quote Release Test</Name> <SubmitIndicator>true</SubmitIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCF-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">6</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
The following request xml will submit and sent the quote provided in the xml to the account
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote actionCode="02"> <ID>345</ID> <SubmitIndicator>true</SubmitIndicator> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Release | Change Description | Details |
---|---|---|
2005 | Service updated | Update of Item Validity Period of Quote for Contract items has been enabled. |
2002 | Element StatusCompletedIndicator added | New element StatusCompletedIndicator added to request message type node CustomerQuote. |
2002 | Element StatusOpenIndicator added | New element StatusOpenIndicator added to request message type node CustomerQuote. |
2008 | SubmitIndicator element added | Added new element to submit the quote document |
Description | Check sales quotes |
Name | CheckMaintainBundle |
Synchronous | yes |
Release Status | Released |
To check whether one or more Customer Quote can be maintained using imported structured data.
The web service request and response message types of the CheckMaintainBundle operation are the same as those of the MaintainBundle operation. The explanations given can therefore also be applied to the CheckMaintainBundle operation.
Description | Maintain sales quotes |
Name | MaintainBundle |
Synchronous | yes |
Release Status | Released |
To maintain one or more Customer Quotes using imported structured data.
The MaintainBundle operation is to maintain one or more customer quote using imported structured data.
To change a simple consistent Customer Quote, the consumer has to provide root and child node data.
This is the root node for each data being passed in the request. The following are the attributes and elements of this node.
Attributes | Description |
---|---|
itemListCompleteTransmissionIndicator | As mentioned above ListCompleteTransmissionIndicator is available for child nodes with multiple cardinality and Item is one such child node of Customer Quote node. Values can be either true or false. |
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
ID | The identifier for a specific customer quote (mandatory during modification of an existing customer quote). |
BuyerID | External Reference ID |
PostingDate | Posting Date of a customer quote |
Name | „Description‟ for a quote |
UUID | Universally unique identifier (optional) |
DataOriginTypeCode | A coded representation of where the customer specific transaction document data originates. Code Value Description |
1 Manual data entry | |
2 B2B message | |
3 A2A message | |
4 Internet | |
5 E-Mail | |
FulfillmentBlockingReasonCode | A coded representation of the reason for blocking a fulfillment process for a customer quote document. Code Value Description |
01 Credit limit | |
02 Political reason | |
03 Bottleneck product | |
04 Down payment required | |
91 Customer request | |
FollowUpProcessingTypeCustomerContractIndicator | An indicator to indicate this service call is creating a Quote for Contract |
space Not a quote for contract | |
X Create a quote for contract | |
FollowUpProcessingTypeServiceOrderIndicator | An indicator to indicate this service call is creating a Service Quote or not. |
space Not a service quote | |
X Create a service quote | |
CashDiscountTermsCode | A coded representation of an agreement of cash discounts for a payment. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <BuyerID>BUYER_ID</BuyerID> <Name>The Name</Name> <DataOriginTypeCode>1</DataOriginTypeCode> <FulfillmentBlockingReasonCode>01</FulfillmentBlockingReasonCode> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A SalesAndServiceBusinessArea is the business or service specific area within an enterprise that is valid for a Customer Quote, such as, for example, sales organization, service organization, distribution channel, division. These elements are derived from the organizational unit Sales Unit or Service Unit (see Party) responsible for the Customer Quote, and can be overwritten manually.
Attributes | Description |
---|---|
actionCode | Refer „General Rules‟ section for more details. |
Elements | Description |
---|---|
DistributionChannelCode | A distribution channel is a channel via which goods or services reach the customer. Code Value Description |
01 Direct sales | |
02 Indirect sales |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <SalesAndServiceBusinessArea actionCode="02"> <DistributionChannelCode>01</DistributionChannelCode> </SalesAndServiceBusinessArea> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A Party is a natural or legal person, organization, organizational unit or group that is involved in a transaction and a reference to a business partner or one of its specializations (such as Customer, Supplier, Employee, and so on).
Party occurs in the following incomplete and disjoint specializations:
Party | Description |
---|---|
BillToParty | A BillToParty is a party (Customer) to whom the invoice for goods or services is sent. |
AccountParty | An AccountParty is a party (Customer) that purchases a product or service. It occurs in the role of the buyer or ordering party with whom the contractual agreement is concluded. |
PayerParty | A PayerParty is a party (Customer) that pays for a product or a service. |
ProductRecipientParty | A ProductRecipientParty is a party (Customer, Supplier, Company) to whom goods are delivered or services are provided. It fulfills the role of the customer who receives the goods or, in case of returns, the vendor or supplying company. |
SalesPartnerParty | A SalesPartnerParty is a party that initiates and implements business transactions for another company. |
FreightForwarderParty | A Freight ForwarderParty is a party (Business Partner) that supplements their own service by subcontracting transportation and other associated services. |
EmployeeResponsibleParty | A EmployeeResponsibleParty is a party (Employee), that is responsible for the processing of sales or services. |
SellerParty | A SellerParty is a party that sells goods or services. It represents the selling company that has a contractual agreement with the BuyerParty. |
SalesUnitParty | A SalesUnitParty is a party (Sales Unit) that is responsible for the sales of goods and services. |
SalesEmployeeParty | |
VendorParty | A VendorParty is a party that is the supplier of a service. |
ServicePerformerParty | A ServicePerformerParty is a party that is the service performer of a service. |
ServiceExecutionTeamParty | A ServiceExecutionTeamParty is a party that is the service execution team of a service. |
ProcessorParty | A ProcessorParty is a party that is the processor of a service |
ProductRecipientItemParty (on Item child node) | A ProductRecipientItemParty is a party (Customer, Supplier or Company) to whom the item-specific goods are delivered or service are provided. |
VendorItemParty (on Item child node) | A VendorItemParty is a party (Company, Customer or Supplier) who delivers goods or provides services. It performs the role of the delivering enterprise or of the external vendor or, in the case of returns, the customer. |
Bill-toItemParty(on Item child node) | |
BuyerItemParty(on Item child node) | |
Employe ResponsibleItemParty(on Item child node) | |
PayerItemParty(on Item child node) | |
VendorItemParty(on Item child node) | |
SellerItemParty(on Item child node) |
The structure for this node is similar to its parent Party node. Since a Party could have multiple contact parties, there is an additional element to identify the „main‟ contact party.
Elements | Description |
---|---|
MainIndicator | An indicator to identify one of the many contact parties as the „main‟ contact party. |
Details of sample XML:
The system automatically determines the preconfigured contact parties for the account party. If the consumer does not wish this happen and rather accept only the ones passed in the xml message, then the partyContactPartyListCompleteTransmissionIndicator should be set to true as shown below partyContactPartyListCompleteTransmissionIndicator=true
This follows the ListCompleteTransmissionIndicator principle mentioned in the General Rules for Using this Web Service section.
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <ProductRecipientParty partyContactPartyListCompleteTransmissionIndicator="true"> <PartyID>MC6049</PartyID> <Address> <CorrespondenceLanguageCode>EN</CorrespondenceLanguageCode> <Email> <URI>email.test@testdata.com</URI> <DefaultIndicator>true</DefaultIndicator> <UsageDeniedIndicator>false</UsageDeniedIndicator> </Email> <Facsimile> <Number> <AreaID>0518</AreaID> <SubscriberID>482</SubscriberID> <ExtensionID>4801</ExtensionID> <CountryCode>US</CountryCode> </Number> <FormattedNumberDescription>+1 (518) 482-4801</FormattedNumberDescription> <DefaultIndicator>true</DefaultIndicator> </Facsimile> <Telephone> <Number> <AreaID>0518</AreaID> <SubscriberID>482</SubscriberID> <ExtensionID>4811</ExtensionID> <CountryCode>US</CountryCode> </Number> <FormattedNumberDescription>+1 (518) 482-4811</FormattedNumberDescription> <DefaultConventionalPhoneNumberIndicator>false</DefaultConventionalPhoneNumberIndicator> <DefaultMobilePhoneNumberIndicator>false</DefaultMobilePhoneNumberIndicator> <UsageDeniedIndicator>true</UsageDeniedIndicator> <MobilePhoneNumberIndicator>true</MobilePhoneNumberIndicator> <SMSEnabledIndicator>true</SMSEnabledIndicator> </Telephone> <Web> <URI>http://sap.com/anyURI</URI> <DefaultIndicator>true</DefaultIndicator> <UsageDeniedIndicator>true</UsageDeniedIndicator> </Web> <DisplayName> <FormattedName languageCode="EN">Josep King</FormattedName> </DisplayName> <Name> <Name> <FormOfAddressCode>0001</FormOfAddressCode> <FirstLineName>Josep</FirstLineName> <SecondLineName>Steven</SecondLineName> <ThirdLineName>King</ThirdLineName> <FourthLineName>Jr.</FourthLineName> </Name> </Name> <PostalAddress> <CountryCode>US</CountryCode> <RegionCode>NY</RegionCode> <CountyName>USA</CountyName> <CityName>Albany</CityName> <StreetPostalCode>12205</StreetPostalCode> <StreetPrefixName>M3 Samson Court</StreetPrefixName> <AdditionalStreetPrefixName>Pacific Coast Region</AdditionalStreetPrefixName> <StreetName>Wolf Rd</StreetName> <StreetSuffixName>Atlantis</StreetSuffixName> <AdditionalStreetSuffixName>South Pier</AdditionalStreetSuffixName> <CareOfName>Wayne Josep.</CareOfName> <TaxJurisdictionCode>NYAL0181</TaxJurisdictionCode> <TimeZoneCode>EST</TimeZoneCode> </PostalAddress> </Address> <ContactParty actionCode="04"> <ObjectNodeSenderTechnicalID>1621</ObjectNodeSenderTechnicalID> <PartyID>MCP6049</PartyID> <MainIndicator>true</MainIndicator> </ContactParty> </ProductRecipientParty> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
RequestedFulfilmentPeriod is the period in which the delivery of goods or the provision of services is requested.
Attributes | Description |
---|---|
actionCode | Refer „General Rules‟ section for more details. |
Elements | Description |
---|---|
StartDateTime | To set the requested start date time. |
EndDateTime (optional) | To set the requested end date time. If not provided, it is filled by the system based on the start date time. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <RequestedFulfillmentPeriodPeriodTerms actionCode="02"> <StartDateTime timeZoneCode="">1999-05-31T13:20:00Z</StartDateTime> <EndDateTime timeZoneCode="">1999-05-31T13:20:00Z</EndDateTime> </RequestedFulfillmentPeriodPeriodTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
DeliveryTerms are agreements that apply for the delivery of goods and provision of services in the Customer Quote.
Attributes | Description |
---|---|
actionCode | Refer „General Rules‟ section for more details. |
Elements | Description |
---|---|
DeliveryPriorityCode | Coded representation of priority/urgency of delivery |
Code Value Description | |
1 Immediate | |
2 Urgent | |
3 Normal | |
7 Low | |
Incoterms | Incoterms are typical contract formulations for delivery conditions that correspond to the rules defined by the International Chamber of Commerce (ICC). |
PartialDeliveryControlCode | The partial delivery control specifies whether and in which form a customer allows partial deliveries. |
Code value Description | |
1 Multiple Deliveries | |
2 Single on-time delivery | |
3 Single delivery - full quantity | |
4 Single delivery - full quantity of order | |
5 Single on-time delivery of order | |
6 Single on-time delivery of item | |
7 Single delivery - full quantity of item | |
8 Single on-time delivery - full quantity | |
9 Single delivery | |
CompleteDeliveryRequestedIndicator | An indicator that signifies if the complete delivery of all the items in the order is requested or not. |
DeliveryPriorityCode | Coded representation of priority/urgency of delivery |
Code Value Description | |
1 Immediate | |
2 Urgent | |
3 Normal | |
7 Low |
Note: If PartialDeliveryControlCode is set to 1 then CompleteDeliveryRequestedIndicator cannot be set to true and vice versa.
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <DeliveryTerms actionCode="02"> <DeliveryPriorityCode>1</DeliveryPriorityCode> <PartialDeliveryControlCode>1</PartialDeliveryControlCode> </DeliveryTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
PricingTerms are the characteristics used for pricing and valuation of goods and services in the Customer Quote.
Attributes | Description |
---|---|
actionCode | Refer „General Rules‟ section for more details. |
Elements | Description |
---|---|
CurrencyCode | Currency for the valuation of the goods and services ordered (document currency). |
PriceDateTime | Price date at which price specifications are determined using a rule for automatic scheduling. |
GrossAmountIndicator | An indicator that specifies whether or not price and/or value is given as gross amount (including taxes). |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <PricingTerms actionCode="02"> <CurrencyCode>USD</CurrencyCode> <PriceDateTime timeZoneCode="">2006-03-28T12:00:00.1234567Z</PriceDateTime> <GrossAmountIndicator>true</GrossAmountIndicator> </PricingTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
SalesTerms are the agreements and conditions applicable for the sale of goods and services in the Customer Quote.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
CancellationReasonCode | CancellationReasonCode Reason for canceling a customer quote transaction. Can be set by both the buyer and seller. |
Code Value Description | |
01 Delivery too late | |
02 Quality issues | |
03 Too expensive | |
04 Competitor cheaper | |
05 Competitor better quality | |
06 Customer to receive replacement | |
07 Warranty | |
08 Other reason | |
97 Cancellation from inbound delivery | |
98 Customer cancellation by XI message | |
99 Cancellation by system (obsolete) | |
CustomerContractRenewalAgreementCode | A coded representation of a customer contract renewal agreement. |
Code Value Description | |
1 Automatic renewal by one year unless cancelled | |
2 Quote, 8 weeks before end date, without automatic acceptance | |
3 Quote, 8 weeks before end date, with automatic acceptance | |
CustomerContractCancellationAgreementCode | A coded representation of a customer contract cancellation agreement. |
Code Value Description | |
1 Immediately | |
2 1 month before end of quarter | |
3 Two weeks advance notice | |
4 Yearly, four weeks before end of calendar year | |
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <SalesTerms actionCode="02"> <CancellationReasonCode>01</CancellationReasonCode> <CustomerContractRenewalAgreementCode>3</CustomerContractRenewalAgreementCode> <CustomerContractCancellationAgreementCode>1</CustomerContractCancellationAgreementCode> </SalesTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
ServiceTerms are the characteristics used for valuation of the services in the Sales Order.
Elements | Description |
---|---|
WarrantyID | The warranty product's ID |
ServicePriorityCode | A coded representation of the (linear ordered) ranking of urgencies. |
ServiceProvisionLocationTypeCode | A coded representation of the type of a location at which a service will be provided. |
Request
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <Name languageCode="EN">Service Quote 1</Name> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <ServiceTerms> <ServicePriorityCode>7</ServicePriorityCode> <WarrantyID>MCG-0101</WarrantyID> <ServiceProvisionLocationTypeCode>2</ServiceProvisionLocationTypeCode> </ServiceTerms> <ServicePointLocation> <LocationID>MC67810</LocationID> </ServicePointLocation> <WarrantyStartReferenceTimePoint> <StartDateTime>2016-03-01T00:00:00Z</StartDateTime> </WarrantyStartReferenceTimePoint> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
ServiceReferenceObject used for specify affected products to a service quote.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Servicesection for more details. |
Elements | Description |
---|---|
MainIndicator | An indicator to indicate the current product is a main affected product. |
ReferenceProductKey | Reference Product ID |
RegisteredProductKey | Registered Product ID |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <Name languageCode="EN">Service Quote 1</Name> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <ServiceReferenceObject actionCode="01"> <MainIndicator>true</MainIndicator> <ReferenceProductKey> <ProductID>SN28791</ProductID> </ReferenceProductKey> </ServiceReferenceObject> <ServiceReferenceObject actionCode="01"> <MainIndicator>false</MainIndicator> <ReferenceProductKey> <ProductID>SN28792</ProductID> </ReferenceProductKey> </ServiceReferenceObject> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
ServicePointLocation is a node to specify the location information for a service quote.
Elements | Description |
---|---|
LocationID | An identifier for a location. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <ServiceTerms> <ServiceProvisionLocationTypeCode>2</ServiceProvisionLocationTypeCode> </ServiceTerms> <ServicePointLocation> <LocationID>MC67810</LocationID> </ServicePointLocation> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
MinimumContractValidity is a node which used for specify the minimum contract validity duration for a Quote for Contract.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Servicesection for more details. |
Elements | Description |
---|---|
MinimunValidityDuration | A Duration is a period of time of a particular length without a fixed start or end time. This period of time is expressed in years, months, days, hours, minutes, seconds, and fractions of a second. |
The MainIncidentServiceIssueCategory node is used to specify the Service Category and Incident Category for a Service Quote.
Elements | Description |
---|---|
IncidentCategory | ServiceIssueCategoryID is an identifier for an issue category in customer service. |
ServiceCategory | ServiceIssueCategoryID is an identifier for an issue category in customer service. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <CustomerQuote itemListCompleteTransmissionIndicator="true"> <BuyerID>MC9785</BuyerID> <DateTime>2016-10-28T12:00:00.1234567Z</DateTime> <Name languageCode="EN">Service Quote 1</Name> <ObjectNodeSenderTechnicalID>3</ObjectNodeSenderTechnicalID> <FollowUpProcessingTypeServiceOrderIndicator>true</FollowUpProcessingTypeServiceOrderIndicator> <Items itemScheduleLineListCompleteTransmissionIndicator="true"> <ItemProduct> <ProductInternalID>MCC-0001</ProductInternalID> <UnitOfMeasure>EA</UnitOfMeasure> </ItemProduct> <ItemScheduleLine> <Quantity unitCode="EA">5</Quantity> </ItemScheduleLine> </Items> <AccountParty> <PartyID>MC9785</PartyID> </AccountParty> <SalesUnitParty> <PartyID>MC45000</PartyID> </SalesUnitParty> <MainIncidentServiceIssueCategory> <IncidentCategory>C1411</IncidentCategory> <ServiceCategory>C14</ServiceCategory> </MainIncidentServiceIssueCategory> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
The terms and conditions agreed on by business partners for the payment of goods delivered or services provided. These terms and conditions consist of incremental payment periods and the cash discounts that are allowed when payment is made within one of these periods.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Servicesection for more details. |
Elements | Description |
---|---|
Code | A coded representation of the terms of payment. |
PaymentBaselineDate | Baseline date for payment that is used for calculating the payment period dates. |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <CashDiscountTerms actionCode="02"> <Code>1</Code> <PaymentBaselineDate>2011-01-24</PaymentBaselineDate> </CashDiscountTerms> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A price and tax calculation is the summary of the determined price and tax components for a business case. A specification of the general procedure for price and tax determination and valuation using attributes those are characteristic or relevant for the whole object.
Note: PriceAndTaxCalculation cannot be created but can only be modified. So this means that if the consumer wishes to change the Discount or Freight charge, then the consumer has to create the quote first and then make a second web-service request to the update this customer quote with the pricing information that is to be changed. Details on how to create a sample update request is mentioned below.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules section for more details. |
priceComponentListCompleteTransmissionIndicator | Refer to the ListCompleteTransmissionIndicator section for more details |
productTaxDetailsListCompleteTransmissionIndicator | Refer to the ListCompleteTransmissionIndicator section for more details |
withholdingTaxDetailsListCompleteTransmissionIndicator | Refer to the ListCompleteTransmissionIndicator section for more details |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <PriceAndTaxCalculation> <MainDiscount actionCode="04"> <Rate> <DecimalValue>25</DecimalValue> </Rate> </MainDiscount> <PriceComponent> <UUID>00163e01-2e13-1ee0-bcff-65cddc6b117f</UUID> <Rate> <DecimalValue>70</DecimalValue> </Rate> </PriceComponent> <PriceComponent> <TypeCode>7PRB</TypeCode> <Rate> <DecimalValue>7</DecimalValue> </Rate> </PriceComponent> </PriceAndTaxCalculation> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
A TextCollection is a collection of all textual descriptions that are related to a Customer Quote. Each text can include formatting information.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
textListCompleteTransmissionIndicator | Text sub-node is of multiple cardinality. |
A Text is unstructured, readable information that contains additional formatting information within TextCollection. The type of type can be specified via the TypeCode.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
TypeCode | Defines the text type and thus main settings for the text. |
Code Value Description | |
10011 Internal Comment | |
10014 Remark for Supplier | |
10024 Customer Information | |
ContentText | Describes the unstructured data of the text. |
Note: A customer quote can have multiple text of different types but can have only one text of one type.
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <TextCollection actionCode="01"> <Text actionCode="01"> <TypeCode>10011</TypeCode> <CreationDateTime>2006-03-28T12:00:00.1234567Z</CreationDateTime> <ContentText>This is the text</ContentText> </Text> </TextCollection> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
An Attachment Folder is the collection of all documents attached to a Customer Quote
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
UUID | Universally unique identifier of the attachment folder node |
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
A document is an attachment that was assigned to the Attachment Folder and contains unstructured in-formation and additional control and monitoring information.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
VisibleIndicator | Specifies whether a document is visible or not. |
CategoryCode | A coded representation of the document category, such as folder, file or link. |
Code Value Description | |
1 Folder | |
2 Document | |
3 Link | |
TypeCode | Coded representation of the document type. Most general attachments are of type 10001. |
MIMECode | A coded representation of the MIMECode of a document. |
Name | Name of a document that identifies the document within its higher-level folder The Name is the same as the last component of the DocumentPathName. All characters (apart from the separator “/”) are allowed in the name. |
AlternativeName | Language-independent name of a document |
Description | Language-independent description of a document |
ExternalLinkWebURI | Destination URI (if the link is external) |
Sub-Node : (only relevant when the document is an file) FileContent-BinaryContent | Describes the unstructured data in binary form |
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>205</ID> <AttachmentFolder DocumentListCompleteTransmissionIndicator="true" ActionCode="01"> <Document PropertyListCompleteTransmissionIndicator="true" ActionCode="01"> <LinkInternalIndicator>true</LinkInternalIndicator> <VisibleIndicator>true</VisibleIndicator> <CategoryCode>2</CategoryCode> <TypeCode>10001</TypeCode> <MIMECode>text/plain</MIMECode> <Name>DocumentName.txt</Name> <AlternativeName>AltName.txt</AlternativeName> <Description languageCode="EN">Desc foo</Description> <ExternalLinkWebURI>http://sap.com/anyURI</ExternalLinkWebURI> <FileContent ActionCode="01"> <BinaryObject mimeCode="text/plain">AQIDBAUGBwgJAA==</BinaryObject> </FileContent> </Document> </AttachmentFolder> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
Item of a customer-specific business transaction that focuses on delivering goods or providing a service, on the prices and on preparing the invoice. Item is the identifying and administrative item information in a Customer Quote which contains all the data that applies to the item or its subnodes, for example, the product information, the parties involved, the sales/delivery-specific agreements, status and references, and so on.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
itemScheduleLineListCompleteTransmissionIndicator | Sub-node ItemScheduleLine is of multiple cardinality. |
Elements | Description |
---|---|
ID | The identifier for a specific customer quote item (mandatory during modification of an existing item). |
BuyerID | Unique identifier for a customer quote item assigned by the buyer. |
ProcessingTypeCode | Coded representation of item processing of the Customer Transaction Document in the process component. |
PostingDate | The creation time (posting time) of a Customer Transaction Document item from a business perspective. |
Description | Short description of the item. |
FulfilmentPartyCategoryCode | Party category of the fulfilment of a customer quote item. |
Code Value Description | |
1 Internal | |
2 External | |
FinishFulfilmentProcessing | An action call to fulfill the processing of the item. It will be invoked when the value is set to true. |
ItemProduct is the identification, description and classification of the product (material or ServiceProduct) in the item.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
ProductID | An identifier for a product. |
ProductInternalID | Internal identifier of the product |
ProductStandardID | A standardized identifier for a product, and the identification scheme is managed by an agency from the code list DE 3055. schemeAgencyID identifies the agency that manages an identification scheme. The agencies from DE 3055 are used as the default, but the roles defined in DE 3055 cannot be used. The following codes are supported: |
9 (EAN.UCC, International Numbering Association) for the GTIN (Global Trade Item Number), which can have up to 14 characters | |
5 (ISO, International Organization for Standardization) for the 13-character ISBN (International Standard Book Number). | |
63 (NATO, North Atlantic Treaty Organization) for the NSN (NATO Stock Number) which has 13 characters (further information: "http://www.nato.int/structur/AC/135/ncs_brochure/ncs_brochure_e/index.htm" | |
Comment : For ISBN, the code 5 (ISO) is entered for schemeAgencyID along with the schemeID ISO 2108: 1992, which indicates that it is an ISBN. The ISBN scheme is managed by http://isbn-international.org/. Specifying a schemeID is not necessary if only one scheme exists for an agency. Another standardized identification scheme is the pharmaceutical central number. There is no SchemeAgencyID for this in the code list DE 3055. How this will be represented must still be clarified. Letters have to be in uppercase. | |
ProductBuyerID | Unique identifier for the product assigned by the buyer. |
UnitOfMeasure | Unit of measure in which quantities are used for the product in the customer quote. |
ProductRequirementSpecificationKey | To identify a product requirement specification. It describes the collection of requirements for a corresponding product used in the item. It also contains the corresponding specifications for fulfilling these requirements. The product requirement specification must belong to the corresponding product in the item. |
An ItemScheduleLine is an agreement regarding when products of an item are requested or provided and in what amount.
Elements | Description |
---|---|
ID (mandatory during update if itemScheduleLineListCompleteTransmissionIndicator is false) | Unique identifier for an ItemScheduleLine assigned by the seller |
TypeCode (mandatory during update if itemScheduleLineListCompleteTransmissionIndicator is false) | Coded representation of the type of an ItemScheduleLine such as RequestedScheduleLine. |
Code Value Description | |
1 Requested | |
2 Confirmed | |
3 Promised | |
4 Planned | |
5 Fulfilled | |
6 Released | |
7 Not Confirmed | |
8 Simulated | |
Quantity | Quantity with reference to TypeCode |
DateTimePeriod | Time period with reference to TypeCode. This element can be used to provide a requested start and end date time for the item. |
There are two ways to update an ItemScheduleLine. If the attribute itemScheduleLineListCompleteTransmissionIndicator is set as true at Item node, then the scheduleLine information can be very basic (that is, just the Quantity data). On setting this attribute, all existing ItemScheduleLine information are deleted and the ones passed in the requested are created.
If this attribute is not pass or set to false, then it is mandatory to pass the ID and TypeCode elements of the ItemScheduleLine node.
In the following xml, the request is updating the quantity of two products. Item <10> follows the first approach and the Item <20> the second.
Note: If the ItemScheduleLine information is passed for an item during the creation of the order, then the attribute itemScheduleLineListCompleteTransmissionIndicator of the parent node „Item‟ has to be set to true. This itemScheduleLine by default is created for TypeCode 1 (requested). The system always by default creates this node when the consumer does not pass this information in the request. If this information is passed in the request, then by setting the said attribute to true, the when the order is created, the default node created by the system is deleted and replaced with the information passed in the request xml.
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>188</ID> <Item itemScheduleLineListCompleteTransmissionIndicator="true"> <ID>10</ID> <ItemScheduleLine> <Quantity>28</Quantity> </ItemScheduleLine> </Item> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>
ItemDeliveryTerms are item-specific agreements that apply for the delivery of goods and provision of services in the customer quote.
This node follows the same consumption pattern as the sub-node DeliveryTerms of node CustomerQuote.
Attributes | Description |
---|---|
actionCode | Refer to the General Rules for Using this Web Service section for more details. |
Elements | Description |
---|---|
DeliveryPriorityCode | A coded representation of priority/urgency of delivery |
Code Value Description | |
1 Immediate | |
2 Urgent | |
3 Normal | |
4 Low | |
Incoterms | Incoterms are typical contract formulations for delivery conditions that correspond to the rules defined by the International Chamber of Commerce (ICC). |
Incoterms | Incoterms are typical contract formulations for delivery conditions that correspond to the rules defined by the International Chamber of Commerce (ICC). |
PartialDeliveryControlCode | The partial delivery control specifies whether and in which form a customer allows partial deliveries. |
Code value Description | |
1 Multiple Deliveries | |
2 Single on-time delivery | |
3 Single delivery - full quantity | |
4 Single delivery - full quantity of order | |
5 Single on-time delivery of order | |
6 Single on-time delivery of item | |
7 Single delivery - full quantity of item | |
8 Single on-time delivery - full quantity | |
9 Single delivery |
ItemSalesTerms are item-specific agreements and conditions that apply for selling goods and services in the customer quote.
ItemServiceTerms are the item-specific conditions and agreements that apply for the execution of a service.
Elements | Description |
---|---|
ConfirmationRelevanceIndicator | Indicates whether this item is relevant for confirmation or not. |
EmployeeTimeConfirmationRelevanceIndicator | Indicates whether this item is relevant for employee time confirmation. |
ExpenseReportingConfirmationRelevanceIndicator | Indicates whether this item is relevant for confirmation via expense reporting. |
ServiceWorkingConditionsCode | The working conditions under which a service is to be provided. |
ServicePlannedDuration | Planned duration of service. |
ResourceID | Unique identification of the resource providing the service product. |
ProjectTaskID | Identifier of the project task the customer transaction document item is assigned to. The project task represents the task by which the service is executed. |
Ship from item location represents the location from which goods are supplied or a service is provided.
Elements | Description |
---|---|
LocationID | Identifier of the Location. |
A ItemTextCollection is a collection of all textual descriptions which are related to a Cusotmer Quote item. Each text can include formatting information.
This node follows the same structure and consumption pattern as the child-node TextCollection of node CustomerQuote.
An ItemAttachmentFolder is the collection of all documents attached to a Cusotmer Quote item.
This node follows the same structure and consumption pattern as the child-node AttachmentFolder of node Cusotmer Quote.
The MaintainBundle operation is to maintain one or more customer quote using imported structured data.
To change a simple consistent CustomerQuote, the consumer has to provide root and child node data.
Example
Simple Update of the Customer Quote with ID 251 – Add an Attachment:
<n0:CustomerQuoteBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <BasicMessageHeader/> <CustomerQuote actionCode="02"> <ID>251</ID> <AttachmentFolder DocumentListCompleteTransmissionIndicator="true" ActionCode="01"> <Document PropertyListCompleteTransmissionIndicator="true" ActionCode="01"> <LinkInternalIndicator>true</LinkInternalIndicator> <VisibleIndicator>true</VisibleIndicator> <CategoryCode>2</CategoryCode> <TypeCode>10001</TypeCode> <MIMECode>text/plain</MIMECode> <Name>DocumentName.txt</Name> <AlternativeName>AltName.txt</AlternativeName> <Description languageCode="EN">Desc foo</Description> <ExternalLinkWebURI>http://sap.com/anyURI</ExternalLinkWebURI> <FileContent ActionCode="01"> <BinaryObject mimeCode="text/plain">AQIDBAUGBwgJAA==</BinaryObject> </FileContent> </Document> </AttachmentFolder> </CustomerQuote> </n0:CustomerQuoteBundleMaintainRequest_sync>