Inbound Service Manage Price Lists

Description	Manage Price Lists
Name	ManageSalesPriceListIn
Namespace	http://sap.com/xi/A1S/Global
Product	SAP Business ByDesign
Process component	Price Master Data Management
Process component namespace	http://sap.com/xi/AP/FO/PriceAndTax/Global
Deployment unit	Foundation
Endpoint Activation	By Scoping of Process Component
Operations	Read price lists Read price lists with filter

Definition

An interface to manage a sales price list.

Business Context and Use

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

General Rules for Using this Web Service

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>

Info

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.

Use Case

In the following example the user wants to read Base Price List.

Use Case: Example for Request

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>

Info

User pass only <ID> which uniquely identify the Price / Discount List

Use Case: Example for Response


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>

Info

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

Prerequisites

User should know ID of the Price / Discount List, which he gets it from ID returned by service QuerySalesPriceListIn

Constraints and Integrity Conditions

To interpret the response user should know about the Key parameter values which is listed in below section

General Rules for Using this Web Service

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.

More Information

General Information

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

Scenarios

For all possible examples refer to operation Read documentation section 'Additional Description' .

Operation Read price lists

Overview

Public Solution Model

Documentation

Description	Read price lists
Name	Read
Synchronous	yes

Definition

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.

Business Context and Use

This is the only operation available for the web service and is used to read Price / Discount List.

Prerequisites

Refer to generic section PREREQUISITES of service documentation

Integration

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.

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>

Info

Note: Date should follow the format YYYY-MM-DD

Structure

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

Request

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>

Response

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>

Example

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

Info

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>

Note

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.

Operation Read price lists with filter

Overview

Public Solution Model

Documentation

Description	Read price lists with filter
Name	ReadwithFilter
Synchronous	yes

Definition

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.

Business Context and Use

This is the only operation available for the web service and is used to read Price / Discount List.

Prerequisites

Refer to generic section PREREQUISITES of service documentation

Integration

The Sales Price List Read service is used to read Price / Discount List information.

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>

Info

Note: Date should follow the format YYYY-MM-DD

Structure

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

Request

ID – This is the ID of the price list or discount list.

UUID – This is the UUID of the price list or discount list.

LastChangedDateTimeInterval

LowerBoundaryDateTime- This is timestamp for last changed on date and time.

UpperBoundaryDateTime- This is timestamp for last changed on date and time.

LastChangeDate

LowerBoundaryDate-This is last changed date lower boundary.

UpperBoundaryDate-This is last changed date upper boundary.

QueryHitsMaximumNumberValue - This determines the max number of price specification entries in the response.

QueryHitsUnlimitedIndicator - determines all number of price specification entries to the reponse.

LastReturnedObjectID - Takes UUID of price specification for filtering based on pagination.

Example

<SalesPriceList>
  <ID>PRICELIST_DC_PC</ID>
  <SalesPriceSpecificationProcessingConditions>
   <QueryHitsMaximumNumberValue>100</QueryHitsMaximumNumberValue>
   <QueryHitsUnlimitedIndicator>false</QueryHitsUnlimitedIndicator>
   <LastReturnedObjectID></LastReturnedObjectID>
  </SalesPriceSpecificationProcessingConditions>
 </SalesPriceList>
or
<SalesPriceList>
  <ID>PRICELIST_DC_PC</ID>
  <SalesPriceSpecificationFilterAttributes>
   <LastChangedDateTimeInterval>
    <LowerBoundaryDateTime>2022-01-28T12:00:00.1234567Z</LowerBoundaryDateTime>
    <UpperBoundaryDateTime>2022-06-28T12:00:00.1234567Z</UpperBoundaryDateTime>
   </LastChangedDateTimeInterval>
 <LastChangedDate>
    <LowerBoundaryDate>1999-01-24</LowerBoundaryDate>
    <UpperBoundaryDate>1999-01-24</UpperBoundaryDate>
   </LastChangedDate>
  </SalesPriceSpecificationFilterAttributes>
  <SalesPriceSpecificationProcessingConditions>
   <QueryHitsMaximumNumberValue>100</QueryHitsMaximumNumberValue>
   <QueryHitsUnlimitedIndicator>false</QueryHitsUnlimitedIndicator>
   <LastReturnedObjectID></LastReturnedObjectID>
  </SalesPriceSpecificationProcessingConditions>
 </SalesPriceList>

Response

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

	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>

Example

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

Info

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>
        <SalesPriceSpecificationProcessingConditions>
            <ReturnedQueryHitsNumberValue>6</ReturnedQueryHitsNumberValue>
            <MoreHitsAvailableIndicator>true</MoreHitsAvailableIndicator>
            <LastReturnedObjectID>0000000000011ED19BA19C9A3983CF4D</LastReturnedObjectID>
        </SalesPriceSpecificationProcessingConditions>
      </SalesPriceListFindByIDResponseMessage>
    </nm:SalesPriceListFindByIDResponse_sync>
  </soap-env:Body>
</soap-env:Envelope>

Note

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.

Technical documentation on the SAP API Business Hub	Manage Price Lists
General web service documentation	A2X Web Services (SOAP)

Inbound Service Manage Price Lists

Overview

Public Solution Model

Related Resources

Documentation

Definition

Business Context and Use

General Rules for Using this Web Service

Use Case

Use Case: Example for Request

Use Case: Example for Response

Prerequisites

Constraints and Integrity Conditions

General Rules for Using this Web Service

More Information

General Information

Scenarios

Operation Read price lists

Overview

Public Solution Model

Documentation

Definition

Business Context and Use

Prerequisites

Integration

Validity Period

Structure

Request

Response

Example

Note

Operation Read price lists with filter

Overview

Public Solution Model

Documentation

Definition

Business Context and Use

Prerequisites

Integration

Validity Period

Structure

Request

Response

Example

Note