Description | Manage Price Lists |
Name | ManageSalesPriceListIn |
Namespace | http://sap.com/xi/A1S/Global |
Process Component Description | Price Master Data Management |
Process Component Name | PriceMasterDataManagement |
Process Component Namespace | http://sap.com/xi/AP/FO/PriceAndTax/Global |
Deployment Unit Description | Foundation |
Endpoint Activation | By Scoping of Process Component | Operations |
Release Status | Released |
An interface to manage a sales price list.
The web service interface, 'Manage Sales Price List In' enables you to connect external applications to your SAP Business ByDesign system and to read details of sales price / discount by 'ID' / 'UUID' (internal representation of ID).
The web service interface offers the operation Read.
For more information about Pricing, see Help Center documentation in the Business ByDesign application: SAP Business ByDesign -> Business Areas -> Customer Relationship Management -> Service -> Field Service and Repair -> Service Confirmations View -> Business Background -> Pricing in Customer Relationship Management
This web-service is used to read price lists and discount lists. The input is the ID returned by QuerySalesPriceListIn.
The request structure is as follows:
<glob:SalesPriceListFindByIDQuery_sync> <SalesPriceList> <UUID></UUID> <ID></ID> </SalesPriceList> </glob:SalesPriceListFindByIDQuery_sync>
User can pass <UUID> as parameter to search Price / Discount List , but its used only for internal purpose, which is 16 digit alpha numberic unique identifier. |
In the following example the user wants to read Base Price List.
Price List with ID 'AKRON BASE PRICES' is read by service <n0:SalesPriceListFindByIDQuery_sync xmlns:n0="http://sap.com/xi/A1S/Global"> <SalesPriceList> <!-- Identifier of Price / Discount List --> <ID>AKRON BASE PRICES</ID> </SalesPriceList> </n0:SalesPriceListFindByIDQuery_sync>
User pass only <ID> which uniquely identify the Price / Discount List |
Returns Price of Product 'MCF-0001' with price 100 USD and 'MCD-0001' with price 200 USD - <nm:SalesPriceListFindByIDResponse_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:QSC:/1SAI/TAEA50F1F2292541DBF7E85:804"> - <SalesPriceListFindByIDResponseMessage> <!-- Unique identifier of Price List --> <ID>AKRON BASE PRICES</ID> <!-- Price List release status code ,for details refer to Global Data Type 'ReleaseStatusCode' --> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released</ReleaseStatusName> <!-- Price List Approval Status Code ,for details refer to Global Data Type 'ApprovalStatusCode' Price List created by Sales representative need to be approved by Sales manager , Approval required or not can be configured in Business configuration during system setup--> <ApprovalStatusCode>2</ApprovalStatusCode> <ApprovalStatusName>Approval not Necessary</ApprovalStatusName> <!-- TypeCode defines the behavior of service , Example 7PL0 for Price List , For more details refer to Global Data Type SalesPriceListTypeCode documentation --> <TypeCode listID="2">7PL0</TypeCode> <TypeName languageCode="EN">Price List</TypeName> <!-- Currency of the List , for details refer to Global Data Type 'CurrencyCode' --> <CurrencyCode>USD</CurrencyCode> <CurrencyName languageCode="EN">US Dollar</CurrencyName> <!-- Validity period , for details refer to Global Data Type 'TimePointPeriod' documentation --> - <ValidityPeriod> <IntervalBoundaryTypeCode /> - <StartTimePoint> <!-- specifies 'Equal to' comparison , for details refer to Global Data Type 'IntervalBoundaryTypeCode' documentation --> <TypeCode>1</TypeCode> <!-- specify start date in YYYY-MM-DD format --> <Date>2007-01-01</Date> </StartTimePoint> - <EndTimePoint> <!-- specifies 'Equal to' comparison , for details refer to Global Data Type 'IntervalBoundaryTypeCode' documentation --> <TypeCode>1</TypeCode> <!-- specify end date in YYYY-MM-DD format --> <Date>9999-12-31</Date> </EndTimePoint> </ValidityPeriod> <!-- Descirption of Price List in logon languae --> <Description languageCode="EN">Price List Akron Products</Description> <!-- Price details of an 'Item 1'--> - <PriceSpecification> <!-- TypeCode defines the behavior of service , Example 7PR1 for List Price, for more details refer to Global Data Type PriceSpecificationElementTypeCode --> <PriceSpecificationElementTypeCode listID="2">7PR1</PriceSpecificationElementTypeCode> <PriceSpecificationElementTypeName languageCode="EN">List Price</PriceSpecificationElementTypeName> <!-- tag exist due to technical and future usage, for more details refer to Global Data Type 'PriceSpecificationElementCategoryCode' --> <PriceSpecificationElementCategoryCode>1</PriceSpecificationElementCategoryCode> <PriceSpecificationElementCategoryName languageCode="EN">Price</PriceSpecificationElementCategoryName> <!-- tag exist due to technical and future usage --> <PriceSpecificationElementPurposeCode>1000</PriceSpecificationElementPurposeCode> <PriceSpecificationElementPurposeName languageCode="EN">General</PriceSpecificationElementPurposeName> <!-- Price specification is consistent or not , Usecase for using consistency status code => User has modified Price specification and saved it with inconsistency and want to filter the only consistent specificaiton , for details refer to Global Data Type 'ConsistencyStatusCode' --> <ConsistencyStatusCode>3</ConsistencyStatusCode> <ConsistencyStatusName languageCode="EN">Consistent</ConsistencyStatusName> <!-- Price specification release status code ,for details refer to Global Data Type 'ReleaseStatusCode' --> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released</ReleaseStatusName> <!-- Base Quantity for which price is maintained --> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <!-- Base Quantity Type for which price is maintained --> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeCodeName languageCode="EN">ea</BaseQuantityTypeCodeName> <!-- Price for given Product of Base quantity --> <Amount currencyCode="USD">100.0</Amount> <!-- PropertyValuation tag used to display the 'Key' and 'Value' combinations , In this case Product 'MCF-0001' for which price is maintained--> - <PropertyValuation> <!-- 'PropertyReference -> PropertyID' display the 'Key' name --> - <PriceSpecificationElementPropertyValuation> <!-- Always will be true ,indicates it's mandatory key --> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <!-- 'PropertyReference -> PropertyID' display the 'Key' name ( Produce ID ) --> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <!-- 'PropertyValue' display the 'Value' for the key , It can also be blank ,indicate that no value used for this 'Key' --> - <PriceSpecificationElementPropertyValue> <ID>MCF-0001</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Rent</Description> </PropertyValuation> <!-- Same as above tag <PropertyValuation> documentation --> <PropertyValuation> - <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <!-- Product type code specify its a Materia / Service .... , for more details refer to Global Data Type 'ProductTypeCode' --> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID_TYPE_CODE</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> - <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_ID_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> </PropertyValuation> <!-- Same as above tag <PropertyValuation> documentation --> - <PropertyValuation> - <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <!-- Product type code specify its a ID is the key .... , for more details refer to Global Data Type 'ProductIdentifierTypeCode' --> <PriceSpecificationElementPropertyID>CND_PRODUCT_TYPE_CODE</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> - <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_TYPE_CODE">2</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> </PropertyValuation> </PriceSpecification> <!-- Price details of an 'Item 2' , Same documentation as 'Item 1'--> - <PriceSpecification> <PriceSpecificationElementTypeCode listID="2">7PR1</PriceSpecificationElementTypeCode> <PriceSpecificationElementTypeName languageCode="EN">List Price</PriceSpecificationElementTypeName> <PriceSpecificationElementCategoryCode>1</PriceSpecificationElementCategoryCode> <PriceSpecificationElementCategoryName languageCode="EN">Price</PriceSpecificationElementCategoryName> <PriceSpecificationElementPurposeCode>1000</PriceSpecificationElementPurposeCode> <PriceSpecificationElementPurposeName languageCode="EN">General</PriceSpecificationElementPurposeName> <ConsistencyStatusCode>3</ConsistencyStatusCode> <ConsistencyStatusName languageCode="EN">Consistent</ConsistencyStatusName> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released</ReleaseStatusName> <BaseQuantity unitCode="HUR">1.0</BaseQuantity> <BaseQuantityTypeCode>TIME</BaseQuantityTypeCode> <BaseQuantityTypeCodeName languageCode="EN">h</BaseQuantityTypeCodeName> <Amount currencyCode="USD">200.0</Amount> - <PropertyValuation> - <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> - <PriceSpecificationElementPropertyValue> <ID>MCD-0001</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Senior Consultancy</Description> </PropertyValuation> - <PropertyValuation> - <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID_TYPE_CODE</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> - <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_ID_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Senior Consultancy</Description> </PropertyValuation> - <PropertyValuation> - <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> - <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_TYPE_CODE</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> - <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_TYPE_CODE">2</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Senior Consultancy</Description> </PropertyValuation> </PriceSpecification> </SalesPriceListFindByIDResponseMessage> </nm:SalesPriceListFindByIDResponse_sync>
When the user gets a response, the Key and Value pairs are returned, which uniquely determine the Item along with Header data like ID,Price,Quantity... Note: Possible values for tags <ConsistencyStatusCode>,<ReleaseStatusCode> can be found in the operation Read example section of the documentation |
User should know ID of the Price / Discount List, which he gets it from ID returned by service QuerySalesPriceListIn
To interpret the response user should know about the Key parameter values which is listed in below section
In the response, the following Key Parameters will be used to indicate the value of sales organization, distribution channel, and so on.
Parameters | Description | Data Type |
---|---|---|
CND_SALES_ORG_ID | Sales organisation | Identifier |
DISTR_CHANNEL | Distribution channel | Code |
CND_BUYER_ID | Customer | Identifier |
CND_PRODUCT_ID | Product | Identifier |
CND_PRODUCT_ID_TYPE_CODE | Type of product ID. 1 means internal ID. It has to be used with CND_PRODUCT_ID. | Code |
CND_PRODUCT_TYPE_CODE | Type of product. It has to be used with CND_PRODUCT_ID. For code values see table below | Code |
CDA_CUST_GROUP | Customer group | Code |
CND_PRD_CAT_ID | Product category | Identifier |
CND_PRD_CAT_HIER_ID | Product category hierarchy. This has to be used with product category | Identifier |
Valid Product TypeCodes values, for more detail refer to the Global Data Type ProductTypeCode documentation
Product type code value | Description |
---|---|
1 | Material |
2 | Service |
3 | Individual Material |
4 | Warranty |
6 | Entitlement Product |
For example, if the price list has been maintained for a sales organization whose ID is MC42100, then the response will contain the following:
<PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_SALES_ORG_ID</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <ID>MC42100</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Region North & East Coast US</Description> </PropertyValuation>
The PriceSpecificationElementPropertyID contains the name of the attribute (for example, CND_BUYER_ID) whose value is being returned in the response.
PriceSpecificationElementPropertyValue contains the value.
The Description element returns the description of the sales organization.
Depending on whether the parameter is an ID or a CODE you get the value within a <ID></ID> or <Code></Code>.
So if the response includes the distribution channel then the XML would look as follows:
<PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>false</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>DISTR_CHANNEL</PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2</PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <Code listID="DISTR_CHANNEL">01</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Direct sales</Description> </PropertyValuation>
The Description element returns the description of the distribution channel.
You can find general information about Web services, their structure and consumption in the Web Services documentation.
For all possible examples refer to operation Read documentation section 'Additional Description' .
Description | Read price lists |
Name | Read |
Synchronous | yes |
Release Status | Released |
To read the sales price list.
This is the only operation of the web-service and is used to read both price lists and discount lists.
This is the only operation available for the web service and is used to read Price / Discount List.
For more information about Pricing, see Help Center documentation in the Business ByDesign application: SAP Business ByDesign -> Business Areas -> Customer Relationship Management -> Service -> Field Service and Repair -> Service Confirmations View -> Business Background -> Pricing in Customer Relationship Management
Refer to generic section PREREQUISITES of service documentation
The Sales Price List Read service is used to read Price / Discount List information.
In the generic section of service documentation, sub section 'BUSINESS_CONTEXT -> Use case' example is 'In the following example the user wants to read Base Price List' and in this section the example is enhanced to search with Validity period.
You can search within a particular period. TypeCode=1 means date. The sample XML shows a search for the period Jan 1, 2001 to December 31, 9999.
<ValidityPeriod> <IntervalBoundaryTypeCode>1</IntervalBoundaryTypeCode> <StartTimePoint> <TypeCode>1</TypeCode> <Date>2001–01–01</Date> </StartTimePoint> <EndTimePoint> <TypeCode>1</TypeCode> <Date>9999–12–31</Date> </EndTimePoint> </ValidityPeriod>
Note: Date should follow the format YYYY-MM-DD |
Mandatory fields to be passed to Service request is ID
Extensibility is not supported by Service operation
Wild card(*) search is support by Service operation
ID – This is the ID of the price list or discount list.
UUID – This is the UUID of the price list or discount list.
Example
<SalesPriceList> <ID>PRICELIST_DC_PC</ID> </SalesPriceList>
This includes the header level data and item level data (that is, the price of each item) of the price list or discount list.
Header level data has the following elements:
ID – This is the ID of the price list or discount list.
ReleaseStatusCode - This indicates whether the price list has been released or not and is relevant for price calculation.
Code List | Description |
---|---|
1 | Not Released |
2 | Partially Released |
3 | Released |
5 | Release Canceled |
ApprovalStatusCode – This indicates whether the price list has been approved or not.
Code List | Description |
---|---|
1 | Not Started |
2 | Approval not Necessary |
3 | In Approval |
4 | Approved |
6 | In Revision |
PropertyValuation - Their usage has already been described in a previous section.
Type Code - The different type codes are as follows
Tyoe Code | Description |
---|---|
7PL0 | Base Price List, Distribution Chain Price List, Customer Specific Price List |
7PL1 | Overall Customer Discount |
7PL2 | Customer Specific Discount Products |
7PL3 | Overall Customer Group Discount |
7PL4 | Customer Specific Discount Product Category |
In the price list data is maintained at header level (for example, customer, sales unit, and so on) and also at item level (for example, product). There are different condition types at header and footer level and the following combinations are possible and can be seen in the price list response. The item level condition type code is in the attribute PriceSpecification-PriceSpecificationElementTypeCode.
Header Type | Header Property Valuations | Item Type (PriceSpecificationElementTypeCode) | Item Property Valuations | |
---|---|---|---|---|
Overall Customer Discount | 7PL1 | n.a. | 7PR6 | CND_BUYER_ID |
Overall Customer Group Discount | 7PL3 | n.a. | 7PR6 | CDA_CUST_GROUP |
Customer Specific Discount Products | 7PL2 | CND_BUYER_ID | 7PR6 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Customer Specific Discount Product Category | 7PL4 | CND_BUYER_ID | 7PR6 | CND_PRD_CAT_HIER_ID, CND_PRD_CAT_ID |
Base Price List | 7PL0 | n.a. | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Base Price List by Product Category | 7PL0 | CND_PRD_CAT_HIER_ID, CND_PRD_CAT_ID | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Distribution Chain Price List | 7PL0 | CND_SALES_ORG_ID, DISTR_CHANNEL | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Distribution Chain Price List by Product Category | 7PL0 | CND_SALES_ORG_ID, DISTR_CHANNEL, CND_PRD_CAT_HIER_ID, CND_PRD_CAT_ID | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Customer Group Specific Price List | 7PL0 | CND_SLSORG_GUID, DISTR_CHANNEL, CDA_CUST_GROUP | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
Customer Specific Price List | 7PL0 | CND_BUYER_ID | 7PR1 | CND_PRODUCT_ID, CND_PRODUCT_ID_TYPE_CODE, CND_PRODUCT_TYPE_CODE |
The important fields in this section are:
ConsistencyStatusCode and ConsistencyStatusName – indicates whether the item is consistent or not.
ReleaseStatusCode and ReleaseStatusName - indicates whether the item is released or not.
BaseQuantity, BaseQuantityTypeCode, BaseQuantityTypeCodeName and Amount – The following XML from the response of a price list tells you that 1 unit costs 100 USD.
<BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeCodeName languageCode="EN">ea</BaseQuantityTypeCodeName> <Amount currencyCode="USD">100.0</Amount>
Percent – The following from the response of a discount list tells you that discount is 5 %.
<Percent>-5.0</Percent>
ScaleExistsIndicator – If set to “true” then the price list has scales.
ScaleLine – The different values in the scale.
Example - for up to 10 items the price is 100 USD per piece, for 11 items or more the price is 90 USD per piece. The XML in the response would be as follows:
<ScaleLine> <FirstDimensionScaleAxisStep> <ScaleAxisBaseCode>1</ScaleAxisBaseCode> <ScaleAxisBaseName languageCode="EN">Quantity</ScaleAxisBaseName> <ScaleAxisStepIntervalBoundaryTypeCode>1</ScaleAxisStepIntervalBoundaryTypeCode> <ScaleAxisStepIntervalBoundaryTypeName languageCode="EN">Basescale</ScaleAxisStepIntervalBoundaryTypeName> <Quantity unitCode="EA">0.0</Quantity> <QuantityTypeCode>EA</QuantityTypeCode> <QuantityTypeName languageCode="EN">ea</QuantityTypeName> </FirstDimensionScaleAxisStep> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeName languageCode="EN">ea</BaseQuantityTypeName> <Amount currencyCode="USD">100.0</Amount> </ScaleLine> <ScaleLine> <FirstDimensionScaleAxisStep> <ScaleAxisBaseCode>1</ScaleAxisBaseCode> <ScaleAxisBaseName languageCode="EN">Quantity</ScaleAxisBaseName> <ScaleAxisStepIntervalBoundaryTypeCode>1</ScaleAxisStepIntervalBoundaryTypeCode> <ScaleAxisStepIntervalBoundaryTypeName languageCode="EN">Basescale</ScaleAxisStepIntervalBoundaryTypeName> <Quantity unitCode="EA">11.0</Quantity> <QuantityTypeCode>EA</QuantityTypeCode> <QuantityTypeName languageCode="EN">ea</QuantityTypeName> </FirstDimensionScaleAxisStep> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeName languageCode="EN">ea</BaseQuantityTypeName> <Amount currencyCode="USD">90.0</Amount> </ScaleLine>
Let us suppose that you’ve maintained a price list with the following data in it:
Header
Type = Price List, Header level type code = 7PLO
Account = MC9785 - Silverstar Wholesale Corp (It’s a customer specific price list)
Currency = USD
Release status = 3 (Released)
Approval Status = 4 (Approved)
Item
It has 2 items –
Item Level type code = 7PR1
Product = MCF-0001 (AHT Combi 75)
Release status = 3 (Released)
Price = 99 USD for each piece
Has Scales = false
Item Level type code = 7PR1
Product = MCF-0002 (AHT Combi 100)
Release status = 3 (Released)
Price = 100 USD for each piece
Has Scales = true
Scale Price = for 0-10 pieces its 100 USD / each. For 11-21 pieces it’s 90 USD/each. 22 pieces or more it’s 80 USD/each.
The response XML will be as follows
for explanation about Request and Response tags refer to Generic section service documentation |
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Header /> <soap-env:Body> <nm:SalesPriceListFindByIDResponse_sync xmlns:nm="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:QKQ:/1SAI/TAEA50F1F2292541DBF7E85:803"> <SalesPriceListFindByIDResponseMessage> <ID>SCALEPRICETEST</ID> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released </ReleaseStatusName> <ApprovalStatusCode>4</ApprovalStatusCode> <ApprovalStatusName>Approved</ApprovalStatusName> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_BUYER_ID </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <ID>MC9785</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">Silverstar Wholesale Corp</Description> </PropertyValuation> <TypeCode listID="2">7PL0</TypeCode> <TypeName languageCode="EN">Price List</TypeName> <CurrencyCode>USD</CurrencyCode> <CurrencyName languageCode="EN">US Dollar</CurrencyName> <ValidityPeriod> <IntervalBoundaryTypeCode></IntervalBoundaryTypeCode> <StartTimePoint> <TypeCode>1</TypeCode> <Date>2011-08-29</Date> </StartTimePoint> <EndTimePoint> <TypeCode>1</TypeCode> <Date>2012-12-31</Date> </EndTimePoint> </ValidityPeriod> <Description languageCode="EN">Test scales in Price </Description> <PriceSpecification> <PriceSpecificationElementTypeCode listID="2">7PR1</PriceSpecificationElementTypeCode> <PriceSpecificationElementTypeName languageCode="EN">List Price </PriceSpecificationElementTypeName> <PriceSpecificationElementCategoryCode>1 </PriceSpecificationElementCategoryCode> <PriceSpecificationElementCategoryName languageCode="EN">Price</PriceSpecificationElementCategoryName> <PriceSpecificationElementPurposeCode>1000 </PriceSpecificationElementPurposeCode> <PriceSpecificationElementPurposeName languageCode="EN">General</PriceSpecificationElementPurposeName> <ConsistencyStatusCode>3</ConsistencyStatusCode> <ConsistencyStatusName languageCode="EN">Consistent </ConsistencyStatusName> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released </ReleaseStatusName> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeCodeName languageCode="EN">ea</BaseQuantityTypeCodeName> <Amount currencyCode="USD">99.0</Amount> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <ID>MCF-0001</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 75 </Description> </PropertyValuation> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID_TYPE_CODE </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_ID_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 75 </Description> </PropertyValuation> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_TYPE_CODE </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 75 </Description> </PropertyValuation> </PriceSpecification> <PriceSpecification> <PriceSpecificationElementTypeCode listID="2">7PR1</PriceSpecificationElementTypeCode> <PriceSpecificationElementTypeName languageCode="EN">List Price </PriceSpecificationElementTypeName> <PriceSpecificationElementCategoryCode>1 </PriceSpecificationElementCategoryCode> <PriceSpecificationElementCategoryName languageCode="EN">Price</PriceSpecificationElementCategoryName> <PriceSpecificationElementPurposeCode>1000 </PriceSpecificationElementPurposeCode> <PriceSpecificationElementPurposeName languageCode="EN">General</PriceSpecificationElementPurposeName> <ConsistencyStatusCode>3</ConsistencyStatusCode> <ConsistencyStatusName languageCode="EN">Consistent </ConsistencyStatusName> <ReleaseStatusCode>3</ReleaseStatusCode> <ReleaseStatusName languageCode="EN">Released </ReleaseStatusName> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeCodeName languageCode="EN">ea</BaseQuantityTypeCodeName> <Amount currencyCode="USD">100.0</Amount> <ScaleExistsIndicator>true</ScaleExistsIndicator> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <ID>MCF-0002</ID> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 100 </Description> </PropertyValuation> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_ID_TYPE_CODE </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_ID_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 100 </Description> </PropertyValuation> <PropertyValuation> <PriceSpecificationElementPropertyValuation> <IdentifyingIndicator>true</IdentifyingIndicator> <PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyID>CND_PRODUCT_TYPE_CODE </PriceSpecificationElementPropertyID> <PriceSpecificationElementPropertyDefinitionClassCode>2 </PriceSpecificationElementPropertyDefinitionClassCode> </PriceSpecificationElementPropertyReference> <PriceSpecificationElementPropertyValue> <Code listID="CND_PRODUCT_TYPE_CODE">1</Code> </PriceSpecificationElementPropertyValue> </PriceSpecificationElementPropertyValuation> <Description languageCode="EN">AHT COMBI 100 </Description> </PropertyValuation> <ScaleLine> <FirstDimensionScaleAxisStep> <ScaleAxisBaseCode>1</ScaleAxisBaseCode> <ScaleAxisBaseName languageCode="EN">Quantity </ScaleAxisBaseName> <ScaleAxisStepIntervalBoundaryTypeCode>1 </ScaleAxisStepIntervalBoundaryTypeCode> <ScaleAxisStepIntervalBoundaryTypeName languageCode="EN">Basescale </ScaleAxisStepIntervalBoundaryTypeName> <Quantity unitCode="EA">0.0</Quantity> <QuantityTypeCode>EA</QuantityTypeCode> <QuantityTypeName languageCode="EN">ea </QuantityTypeName> </FirstDimensionScaleAxisStep> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeName languageCode="EN">ea </BaseQuantityTypeName> <Amount currencyCode="USD">100.0</Amount> </ScaleLine> <ScaleLine> <FirstDimensionScaleAxisStep> <ScaleAxisBaseCode>1</ScaleAxisBaseCode> <ScaleAxisBaseName languageCode="EN">Quantity </ScaleAxisBaseName> <ScaleAxisStepIntervalBoundaryTypeCode>1 </ScaleAxisStepIntervalBoundaryTypeCode> <ScaleAxisStepIntervalBoundaryTypeName languageCode="EN">Basescale </ScaleAxisStepIntervalBoundaryTypeName> <Quantity unitCode="EA">11.0</Quantity> <QuantityTypeCode>EA</QuantityTypeCode> <QuantityTypeName languageCode="EN">ea </QuantityTypeName> </FirstDimensionScaleAxisStep> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeName languageCode="EN">ea </BaseQuantityTypeName> <Amount currencyCode="USD">90.0</Amount> </ScaleLine> <ScaleLine> <FirstDimensionScaleAxisStep> <ScaleAxisBaseCode>1</ScaleAxisBaseCode> <ScaleAxisBaseName languageCode="EN">Quantity </ScaleAxisBaseName> <ScaleAxisStepIntervalBoundaryTypeCode>1 </ScaleAxisStepIntervalBoundaryTypeCode> <ScaleAxisStepIntervalBoundaryTypeName languageCode="EN">Basescale </ScaleAxisStepIntervalBoundaryTypeName> <Quantity unitCode="EA">22.0</Quantity> <QuantityTypeCode>EA</QuantityTypeCode> <QuantityTypeName languageCode="EN">ea </QuantityTypeName> </FirstDimensionScaleAxisStep> <BaseQuantity unitCode="EA">1.0</BaseQuantity> <BaseQuantityTypeCode>EA</BaseQuantityTypeCode> <BaseQuantityTypeName languageCode="EN">ea </BaseQuantityTypeName> <Amount currencyCode="USD">80.0</Amount> </ScaleLine> </PriceSpecification> </SalesPriceListFindByIDResponseMessage> </nm:SalesPriceListFindByIDResponse_sync> </soap-env:Body> </soap-env:Envelope>
The operation Read of inbound service interface Manage Sales Price List In reads the busines object Sales Price List.
This is the only operation of the web-service and is used to read both price lists and discount lists.