What Is SAP Variant Configuration and Pricing
What Is SAP Variant Configuration and Pricing
This service guide contains all the information required by you to decide on the relevance of the Pricing service
for your application or scenario. It also contains information about how to set up, consume, and run the Pricing
service.
The Pricing service lets your sales teams, customers, and channel partners price your products accurately and
efficiently. Leverage your knowledge of SAP sales pricing to model your pricing rules and use them everywhere.
That allows smooth end-to-end data flow between your cloud applications and your SAP back end. Relevant
pricing data is replicated from SAP ERP or SAP S/4HANA in the SAP Cloud to allow the Pricing service to use
that data independently of the back-end load or availability.
Environment
Contract Type
This service requires a subscription to use it. Not offered via Cloud Platform Enterprise Agreement.
Features
Document pricing Price calculation is based on pricing procedures and supports: Price, discount and
surcharge calculation. Calculation rules. Currency and quantity conversion. Scale
determination with different scale types. Manual overwriting for header and item
conditions.
Stateless pricing Same functionality as for document pricing above, but no manual changes possible for
conditions, only automatic determination. In contrast to document pricing, there is only
one single API that gets all the needed input and does the price calculation.
Condition Use condition technique in your SAP back end to maintain the pricing rules. Condition
technique determination for standard and custom defined condition types.
External Item conditions with data source other than condition technique are considered as
Conditions external conditions. They require input via API from an external data source. Supported
calculation types: Percentage, Fixed Amount, Quantity.
Prices for Pricing via so called variant conditions for simple and multi-level configurable products.
configurable
items
Taxes Simple, condition-based tax calculation like MWST is possible. However, multiple tax
levels, tax exemption licenses (for example for Italy and France) or tax calculation via
external tax engine are not supported.
Pricing APIs Retrieve pricing procedure details, such as dynamic pricing attributes or manual
condition types, that are needed to do the actual pricing calls. Calculate a price via single
call to stateless pricing or via consecutive calls to document and item pricing APIs.
Extensibility A custom web service can be specified that is called by the pricing engine for each
custom routine. The customer is responsible for correctness and potential performance
impact of calls to his web service implementation.
Support Content
Tech
nical
Com Envi Avail
po Capa ron able
nent bility ment Title Description Action Type as of
Pricing Exten Cloud Copy The new service endpoint POST /api/v1/pricing/ Rec New 2021-1
Serv sion Foun API documents/{documentId}/items/{sourceItemId}/ om 0-20
dry
ice Suite - Items copy/{targetItemId} is used to copy an item within a mende
Devel pricing document and trigger repricing. The old source item d
op id and the desired new target item id must be specified. The
ment new target external id can be specified. A list of subitems can
Effi- be provided to copy them with the new target item ids. All
ciency customers should use this feature.
Pricing Exten Cloud Limits Lower and upper limits can be maintained in the back end for Info New 2021-1
Serv sion Foun for condition records and for condition types. Those used not to only 0-20
dry
ice Suite - Man be supported by Pricing service. Now, in both cases, Pricing
Devel ual service only accepts values within the given limits and raises
op Condi a corresponding warning message when the given value had
ment tions to be corrected to be within the allowed range.
Effi-
ciency
Pricing Exten Cloud Rate- High load on one tenant used to slow down other tenants by Re Chang 2021-1
Serv sion Foun limita occupying shared resources. This issue was corrected by bet quired ed 0-20
dry
ice Suite - tion ter handling of the resources and by introducing a rate limita
Devel tion. The maximum number of parallel calls is restricted to
op 250 calls per tenant. HTTP error code 429 is returned when
ment the rate limit is reached. This change of behaviour impacts all
Effi- users.
ciency
See: Development Guide for SAP Variant Configuration and
Pricing Services
Pricing Exten Cloud Input The input validation for the pricing attribute names used to Re Chang 2021-1
Serv sion Foun Valida have a length restriction of maximum 20 characters. Now, quired ed 0-20
dry
ice Suite - tion you can maintain names of up to 47 characters in back end.
Devel for This change of behaviour impacts all users.
op Pricing
ment Attrib
Effi- ute
ciency Name
s
Pricing Exten Cloud Input Input validation used not to reject condition rates like Info Chang 2021-1
Serv sion Foun Valida 999999999999999.00, which led to inactive pricing condi only ed 0-20
dry
ice Suite - tion tions. This issue has been corrected. Now, input validation
Devel for only accepts condition rates with up to 11 digits before the
op Condi decimal point, and condition values with up to 13 digits before
ment tion the decimal point. Both, rates and values, with up to 5 deci
Effi- Rates mal places.
ciency and
Values
Pricing Exten Cloud Hier Pricing service used to generate an exception when a condi Info Chang 2021-1
Serv sion Foun archi tion access used a hierarchical access type in combination only ed 0-20
dry
ice Suite - cal Ac with a multi-value pricing attribute. This issue has been cor
Devel cess rected.
op with
ment Multi-
Effi- value
ciency Pricing
Attrib
utes
Pricing Exten Cloud Input When changing the calculation type of a manual condition to Info Chang 2021-1
Serv sion Foun Valida ‘A’ (percentage) an error message about the wrong condition only ed 0-20
dry
ice Suite - tion unit used to be generated. This issue has been corrected.
Devel for
op Unit
ment Per
Effi- cent
ciency age
Pricing Exten Cloud Proc Now there is an indicator for the condition types of SAP S/ New 2021-
Serv sion Foun ess 4HANA to control the processing of conditions with value 07-28
dry
ice Suite - Condi zero.
Devel tions
If the indicator is not set for the condition type and the
op That
condition value is zero, the condition is not considered in the
ment Are
exclusion logic and the price condition becomes inactive (if
Effi- Equal
not a group condition).
ciency to
Zero If the indicator is set for the condition type and the condition
value is zero, the condition is considered in the exclusion logic
and the price condition remains active.
Pricing Exten Cloud Reject Pricing service used to process pricing procedures that where Chang 2021-
Serv sion Foun Pricing not added to the administration UI for replication. That led to ed 07-28
dry
ice Suite - Proce unexpected results, because of missing condition records,
Devel dures that were difficult to analyze. Pricing service now rejects calls
op That with such pricing procedures.
ment Were
Effi- Not
ciency Repli
cated
Pricing Exten Cloud Copy The new service endpoint POST /api/v1/pricing/ New 2021-
Serv sion Foun Docu 07-28
documents/{documentId}/copy is used to copy a pricing
dry
ice Suite - ment document without repricing. A list can be provided to map old
Devel API and new item ids during copying.
op
See: Development Guide for SAP Variant Configuration and
ment
Pricing Services and API Definition
Effi-
ciency
Pricing Exten Cloud Up Service endpoint PATCH /api/v1/pricing/documents/ Chang 2021-
Serv sion Foun date ed 07-28
{documentId} has been enhanced to not only allowing
dry
ice Suite - Docu changing the document currency, but also exchanging rate
Devel ment date and type
op Heade
See: Development Guide for SAP Variant Configuration and
ment r API
Pricing Services and API Definition
Effi-
ciency
Pricing Exten Cloud Modify The new service endpoint PUT /api/v1/pricing/ New 2021-
Serv sion Foun Item 07-28
documents/{documentId}/items is used to efficiently
dry
ice Suite - Hierar modify item hierarchies with a single API call: there is no need
Devel chy for a caller to keep track of all manual changes to reapply
op API them after modifying an item structure, for example, after
ment product configuration changes.
Effi-
See: Development Guide for SAP Variant Configuration and
ciency
Pricing Services and API Definition
Pricing Exten Cloud Heade Now the platform converts all header keys to lower-case to Chang 2021-
Serv sion Foun r Pa comply with the HTTP/2 standard. This also applies to all ed 04-21
ice Suite - dry rame endpoints of Pricing service.
Devel ter
See: API Definition
op Keys
ment Are
Effi- Con
ciency verted
to
Lower
Case
Pricing Exten Cloud New In addition to the already available stateless pricing API, a New 2021-
Serv sion Foun REST new set of RESTful APIs was introduced for more complex 04-21
ice Suite - dry ful use-cases like quoting pricing. Those APIs, allow incremental
Devel Pricing changes to a price document, e.g. adding items without un
op APIs necessarily re-determining pricing conditions for already ex
ment isting items, and they allow to overwrite manual conditions at
Effi- the document header and item level.
ciency
See: Development Guide for SAP Variant Configuration and
Pricing Services
Pricing Exten Cloud New A set of new APIs was introduced to allow reading the set New 2021-
Serv sion Foun Pricing tings of a pricing procedure and its condition types. This 04-21
ice Suite - dry Cus helps the calling application to display the pricing results and
Devel tomiz to decide which condition can be overwritten manually and in
op ing which way, e.g. at document header or item level.
ment APIs
See: Development Guide for SAP Variant Configuration and
Effi-
Pricing Services
ciency
See: API Definition
Pricing Exten Cloud Exten Certain pricing extensions can now overwrite the statistical New 2021-
Serv sion Foun sion flag and inactive flag of a price condition. They can also over 04-21
ice Suite - dry Con write an item’s subtotals and set an exclusion indicator that
Devel cept – can be read by following custom requirements.
op New
See: Extension Guide for SAP Variant Configuration and Pric
ment Capa
ing
Effi- bilities
ciency
Pricing Exten Cloud State The inactive flag for statistical items used to be W. Boolean Chang 2021-
Serv sion Foun less field statistical is used for that purpose too. Now, we prioritize ed 04-21
ice Suite - dry Pricing other reasons for being inactive different from W. For statisti
Devel API – cal items, you can also see other reasons such as condition
op Return exclusion, subsequent price, etc.
ment More
See: API Definition
Effi- Accu
ciency rate
Inac
tive
Flag
for
Condi
tions
Pricing Exten Cloud State The new item input structure duration was introduced with New 2021-
Serv sion Foun less the fields startDate and endDate to allow the pricing engine to 01-20
ice Suite - dry Pricing calculate the duration factor for calculation types M-Monthly
Devel API – Price, N-Yearly Price, O-Daily Price, and P-Weekly Price. This
op Con factor is applied to the relevant condition rate to calculate the
ment tract condition value for the given duration. The new response field
Effi- Start durationFactor is returned accordingly for relevant condition
ciency and types in pricing results.
End
See: API Pricing Service
Date
Pricing Exten Cloud Exten Custom pricing attributes, that are not part of a condition ta Chang 2021-
Serv sion Foun sion ble, used not to be forwarded to the pricing extension imple ed 01-20
ice Suite - dry Con mentation. This issue has been corrected.
Devel cept – See: Extension Guide for SAP Variant Configuration and Pric
op Cus ing
ment tom-
Effi- Pricing
ciency Attrib
utes
Passe
d to
Exten
sion
Pricing Exten Cloud Cus The customizing cache used not to be cleared after one hour Chang 2021-
Serv sion Foun tomiz like the other cache regions. This issue has been corrected. ed 01-20
ice Suite - dry ing See: Caching in SAP Variant Configuration and Pricing
Devel Cache
op Evic
ment tion
Effi-
ciency
Pricing Exten Cloud State For condition types that were not marked as Variant Chang 2021-
Serv sion Foun less Condition in back-end customizing, Pricing service used to re ed 01-20
ice Suite - dry Pricing turn variant conditions instead of skipping the accesses to
Devel API – condition tables that contain variant condition keys. This is
op Con sue has been corrected.
ment sider
Effi- Var
ciency iant
Condi
tion
Flag
Related Information
Introduction
You can get started with the Pricing service using the standard procedures for SAP Business Technology
Platform Cloud Foundry environment.
Before starting, make sure that you have all required versions of the software you are integrating. For that
please refer to SAP Note 2711932 .
To exchange data between cloud solution SAP Variant Configuration and Pricing and the licensee’s local on-
premise SAP ERP or SAP S/4HANA back end, SAP Variant Configuration and Pricing also comprises the SDI
Data Provisioning Agent, which is part of SAP HANA smart data integration. The SDI Data Provisioning Agent is
an on-premise application that is to be installed and operated locally in the customer’s on-premise landscape.
For data exchange with SAP ERP systems, using a third-party runtime database obtained from SAP, such as
Microsoft SQL Server or Oracle DB, certain restrictions apply according to the applicable on-premise license
agreements for the third-party runtime databases. One such restriction is that the licensee may not access
these databases directly via systems or technologies that have not been licensed specifically for use with such
runtime database. Therefore, the corresponding SDI Data Provisioning Agent Adapters provided with SAP
Variant Configuration and Pricing may not be used to directly access, or replicate data from, such third-party
runtime databases licensed from SAP.
For third-party database licenses not obtained from SAP, please refer to the respective license agreements on
the available options for data exchange via direct database accesses.
For more information about interoperability and maintenance rules for the Data Provisioning Agent, see SAP
Note 2546811
When your organization signs a contract for SAP Business Technology Platform services, an e-mail is sent to
the IT contact person specified in the contract. The e-mail message contains the link to log on to the system,
the SAP Cloud Identity credentials, and the user ID for the specified user. These credentials can also be used
for sites such as the SAP Store , SAP Community , Software Downloads and the SAP Support Portal
for example, to download Data Provisioning Agent.
You will find different information in that e-mail depending on the licensed product.
For example:
You need one tenant of SAP Variant Configuration and Pricing for every back-end client that will be connected.
SAP Business Technology Platform comes with two environments, the Neo environment, and the Cloud
Foundry environment, sometimes also called Multi Environment. SAP Variant Configuration and Pricing is
based on the Cloud Foundry environment. Each contract provides one global account with the entitlements
needed to use SAP Variant Configuration and Pricing. With it you will get entitlements for the Variant
Configuration service, Pricing service and SAP Variant Configuration and Pricing SaaS application for data
replication and administration.
You might want to add further users as members to that global account, or change the global account
description as described in Add Global Account Members
Related Information
To know the steps that you need to follow to enable the Pricing service, please read the Administration Guide
for SAP Variant Configuration and Pricing.
Note
For the license material SAP Variant Configuration and Pricing (8006356) and the service plan default, we
will report at the subaccount level the peak usage of gigabytes runtime memory per month. To view that
data, please open your global account on SAP Business Technology Platform and open the menu Usage
Analytics. In the section Service Usage please choose service SAP Variant Configuration and Pricing. Please
also choose the subaccount and period of interest. Please note: Choosing the subaccount All Subaccounts
lets cloud cockpit aggregate all the subaccounts’ peak usages. This number does not have any meaning. In
cloud cockpit we cannot show you the peak usage per global account.
1.4 Development
To know how to adjust the application to consume the Pricing service please read the Development Guide for
SAP Variant Configuration and Pricing Services, and do the tutorial Create an SAPUI5 Application for SAP
Variant Configuration and Pricing .
For an overview of the extension concept of SAP Variant Configuration and Pricing See the Extension Guide for
SAP Variant Configuration and Pricing
For a detailed overview of supported pricing routines (user exits) see Supported Standard Pricing Exits.
1.5 Administration
Some initial configuration steps may be necessary to enable the service initially. See Initial Setup [page 10]
For all the information about the administration of the service see the Administration Guide for SAP Variant
Configuration and Pricing.
1.6 Security
To know the settings and configurations necessary to operate the Pricing service in a secure manner, please
read the Security Guide for SAP Variant Configuration and Pricing. Please also refer to the security guide for
auditing and logging information.
Please refer to the Administration Guide for information about Monitoring of data replication.
E-mail notifications are supported via the Alert Notification service (separate license needed for that
service).
The following alert types are available:
● SAP HANA smart data integration Data Provisioning Agent status: an alert is sent if your SAP HANA
smart data integration Data Provisioning Agent reports an error. This alert is not sent immediately, but
after a second check is done, some minutes later, to prevent false alerts caused by brief connection issues.
● Replication failure: an alert is sent if there is an error during the replication of a table.
● Get contacted by SAP Support: SAP Support will send you an alert if you need to take an action, e.g., in
case a new SDI Agent version needs to be installed.
Service Availability
To be notified of maintenance events of SAP Variant Configuration and Pricing, visit the Cloud Availability
Center and use the Cloud System Notification Subscriptions .
Please also refer to Cloud Availability Center and Cloud System Notification Subscriptions .
Engine Traces
In case of unexpected results in configuration or pricing, a special logging can be enabled to see how the
corresponding engine calculated those values. See Engine Trace.
Reporting an incident
You can report an incident or error through the SAP Support Portal .
Please open an incident using component LOD-CPS. We recommend including the following information:
This service guide contains all the information required by you to decide on the relevance of the Variant
Configuration service for your application or scenario. It also contains information about how to set up,
consume, and run the Variant Configuration service.
Configure your SAP ERP or SAP S/4HANA products interactively in the cloud.
Build applications to configure your products accurately and efficiently. Use the product modelling
environment in your back end to define the product model and to generate a knowledge base version. A
knowledge base version is a collection of all relevant product model data such as materials, characteristics, and
dependencies for a given validity date. Knowledge base is replicated in the SAP Cloud to allow configuration
service to use that data independently of the back-end load or availability.
Environment
Contract type
This service requires a subscription to use it. Not offered via Cloud Platform Enterprise Agreement.
Features
Simple configuration The user assigns values to characteristics of a product. All the dependencies and
constraints from the configuration model are considered.
Advanced Variant The Variant Configuration service can forward calls to the SAP S/4HANA for advanced
Configuration variant configuration engine in the back end, bypassing the configuration engine of
the service.
Configuration The Variant Configuration service provides persistence for configuration runtime data.
persistence Every change in the configuration during the configuration process is saved in the
database.
Master Data APIs Get a list of knowledge bases header data, e.g. for a given product. Get all master data
details for a given knowledge base id. Get maintained translations in specified
language(s).
APIs optimized for UI Create an initial configuration with default values. Update characteristic values.
consumption Update configuration context (input for reference characteristics). Get details of a
configuration previously created. Delete a configuration.
Configuration APIs Retrieve external configuration with all information from a previously created
for data exchange configuration, to enable the exchange of configuration data with the order fulfillment
functions in the SAP back-end system. Create a new configuration from external
configuration.
Extensibility A custom web service can be specified that is called by the configuration engine for
each variant function (not for pfunctions). The customer is responsible for the
correctness; and potential performance impact of calls to his variant function
implementation.
Support Content
Tech
nical
Com Envi Avail
po Capa ron able
nent bility ment Title Description Action Type as of
Variant Exten Cloud Ad Since S/4HANA on-premise 2021 and S/4HANA Cloud 2108, Rec New 2021-1
Config- sion Foun vance when using SAP S/4HANA for advanced variant configuration om 0-20
dry
uration Suite - d Var (AVC), it is possible to let the Variant Configuration service mende
Devel iant forward the calls to the AVC configuration engine in the back d
op Con end instead of processing the configuration rules with the
ment figura service’s engine. With that, the new AVC syntax and the AVC’s
Effi- tion pre- and post-processing BAdIs are supported. Advanced
ciency knowledge base generation must be used to transfer the
product model to the Variant Configuration service. All cus
tomers should use this feature.
Variant Exten Cloud Up When uploading knowledge bases via the administration UI to Rec New 2021-1
Config- sion Foun load a tenant where data replication is not yet in place, Variant om 0-20
dry
uration Suite - knowl Configuration service cannot map the SAP-internal unit of mende
Devel edge measures found in the knowledge base to ISO codes that are d
op bases usually returned. Therefore, for uploaded knowledge bases,
ment – ISO SAP-internal unit of measures are returned. As that can lead
Effi- code to problems in calling applications, an ISO code mapping per
ciency map uploaded knowledge base is now be provided. All customers
ping should use this feature.
Variant Exten Cloud Cach A knowledge base with variant tables used to be loaded into Re Chang 2021-1
Config- sion Foun ing of the cache even if not all the variant tables were replicated yet. quired ed 0-20
dry
uration Suite - Knowl That led to inconsistent data in the cache, errors, or unex
Devel edge pected configuration results. This issue has been corrected
op Bases for the delta replication. Now, instead of loading a faulty
ment Being knowledge base, the error message The knowledge base <id>
Effi- Repli is locked due to running replication started at <timestamp>
ciency cated UTC is returned. This change of behaviour impacts all users.
Variant Exten Cloud Rate- High load on one tenant used to slow down other tenants by Re Chang 2021-1
Config- sion Foun limita occupying shared resources. This issue was corrected by bet quired ed 0-20
dry
uration Suite - tion ter handling of the resources and by introducing a rate limita
Devel tion. The maximum number of parallel calls is restricted to
op 250 calls per tenant. HTTP error code 429 is returned when
ment the rate limit is reached. This change of behaviour impacts all
Effi- users.
ciency
See: Development Guide for SAP Variant Configuration and
Pricing Services
Variant Exten Cloud Input The length and number of decimal places in the input for nu Re Chang 2021-1
Config- sion Foun Valida meric characteristics are checked against the characteristic quired ed 0-20
dry
uration Suite - tion definition. This used not to happen for string characteristics,
Devel for which led to problems when transferring the configuration re
op String sults to sales documents in the back end. This issue has been
ment Char corrected and input for string characteristics is now also re
Effi- acter jected when it exceeds the defined maximal length. This
ciency istics change of behaviour impacts all users.
Variant Exten Cloud Valida Information, warning, and error messages raised by the con Info An 2021-1
Config- sion Foun tion figuration engine or during the input validation have been re only nounc 0-20
dry
uration Suite - and worked and published in the development guide to allow the ement
Devel Engine service consumers to translate them before showing them to
op Mes end users.
ment sages
See: Development Guide for SAP Variant Configuration and
Effi-
Pricing Services
ciency
Variant Exten Cloud Con Knowledge bases that were uploaded from the file system via New 2021-
Config- sion Foun figura the administration UI to non-productive tenants can now be 07-28
dry
uration Suite - tions used to create configurations.
Devel API –
This allows easy testing or demoing of product models with
op Proc
out having data replication already setup.
ment ess
Effi- Man See: Administration Guide for SAP Variant Configuration and
ciency ually Pricing
Up
loaded
Knowl
edge
Bases
Variant Exten Cloud Con When creating new configurations, knowledge bases that Chang 2021-
Config- sion Foun figura were created via the Solution Modeling Environment were ed 07-28
dry
uration Suite - tions skipped during knowledge base finding or rejected when
Devel API – specified explicitly. Now Solution knowledge bases can only
op Skip be processed by the SAP Solution Sales Configurator.
ment Solu
Effi- tion
ciency Knowl
edge
Bases
Variant Exten Cloud Con In configuration results, some characteristics that had no Chang 2021-
Config- sion Foun figura possible values (unconstrained domain) used to be missing in ed 07-28
dry
uration Suite - tions the product’s characteristicSpecifics list. This issue has been
Devel API – corrected.
op Return
See: API Definition
ment Also
Effi- Char
ciency acter
istics
With
out
Values
Variant Exten Cloud Con The configuration results of the characteristic possibleValues Chang 2021-
Config- sion Foun figura used to return an empty list when: ed 07-28
dry
uration Suite - tions
1. The characteristic’s dynamic value domain was empty,
Devel API –
and no value was set.
op Distin
2. The characteristic’s static value domain was empty, and
ment guish
an arbitrary value was set.
Effi- Empty
ciency Do Now to distinguish those two, in the latter case, an empty
main value with interval type 0 is returned.
and
See: Development Guide for SAP Variant Configuration and
Un
Pricing Services
con
straint
Do
main
Variant Exten Cloud Heade Now the platform converts all header keys to lower-case to Chang 2021-
Config- sion Foun r Pa comply with the HTTP/2 standard. This also applies to all ed 04-21
uration Suite - dry rame endpoints of Variant Configuration service. For example, etag
Devel ter used to be returned in camel case: ETag
op Keys
See: API Definition
ment Are
Effi- Con
ciency verted
to
Lower
Case
Variant Exten Cloud Knowl Details for knowledge bases that were created via the New 2021-
Config- sion Foun edge Solution Modeling Environment, can now be read via the end 04-21
uration Suite - dry Base point GET /api/v2/knowledgebases/{kbId}, using the
Devel API – new characteristic type adt (abstract data type). No details
op Read are returned about which kind of classes or materials can be
ment Solu referenced by an ADT characteristic. Such knowledge bases
Effi- tion can only be processed by the SAP Solution Sales
ciency Knowl Configurator.
edge
See: API Definition
Base
Variant Exten Cloud Knowl There is a new endpoint introduced to read knowledge-base New 2021-
Config- sion Foun edge metrics like number of classes, characteristics, etc. 04-21
uration Suite - dry Base
See: API Definition
Devel API –
op Get
ment Met
Effi- rics
ciency
Variant Exten Cloud Con The PATCH requests used to be rejected if the configuration’s Chang 2021-
Config- sion Foun figura etag in the session was not current after the caller made ed 04-21
uration Suite - dry tions changes to the configuration in a different session. This issue
Devel API – has been corrected by reloading the latest configuration into
op More the current session before processing the changes.
ment Resil
See: API Definition
Effi- ient
ciency Ses
sion
Han
dling
Variant Exten Cloud Con The PATCH requests for characteristics with an empty list of Chang 2021-
Config- sion Foun figura values do not trigger any action in the configuration engine. ed 04-21
uration Suite - dry tions We cannot reject such calls for backwards compatibility. Etag
Devel API – used to be increased even if nothing was changed. This issue
op Ignore has been corrected.
ment Empty
See: API Definition
Effi- List of
ciency Char
acter
istic
Values
in
PATCH
Re
quest
Variant Exten Cloud Con The PATCH requests for single-value characteristics that tried Chang 2021-
Config- sion Foun figura to change multiple values used to be ignored by the configu- ed 04-21
uration Suite - dry tions ration engine. Now such requests are rejected with a valida
Devel API – tion error.
op Reject
See: API Definition
ment Multi
Effi- ple
ciency Values
for a
Single-
Value
Char
acter
istic
Variant Exten Cloud Con When creating a new configuration, productKey and date had New 2021-
Config- sion Foun figura to be provided to allow the configuration engine to determine 01-20
uration Suite - dry tions the appropriate knowledge base version. Now, instead of the
Devel API – date, the knowledge base id can be provided via the new input
op Create parameter kbId to specify exactly which knowledge base ver
ment Con sion shall be used.
Effi- figura
See: API Definition
ciency tion
for
Speci
fied
Knowl
edge
Base
Variant Exten Cloud Exter Variant condition keys and factors have always been returned New 2021-
Config- sion Foun nal via dedicated result structure on the item level. This allows 01-20
uration Suite - dry Con easy mapping to the corresponding input structure of Pricing
Devel figura service. For easy mapping to e.g. the S/4HANA solution
op tions quote inbound API, variant condition factors are now also re
ment API – turned for the values of each price characteristic (those with
Effi- Return reference to SDCOM-VKOND).
ciency Var
See: API Definition
iant
Condi
tion
Fac
tors
for
Price
Char
acter
istic
Values
Variant Exten Cloud Knowl The knowledge base header details now also contain the New 2021-
Config- sion Foun edge fields plant and bomApplication. It is also possible to search 01-20
uration Suite - dry base for knowledge bases via plant.
Devel API –
Note: Plant is only part of the data model in the most recent
op New
back-end releases with implemented BAdI
ment Heade
KBSCHEMA_CURT.
Effi- r
ciency Fields See: API Definition
Plant
and
BomA
pplicat
ion
Variant Exten Cloud Knowl Knowledge base header details now also contain the field New 2021-
Config- sion Foun edge type. The following values are possible: 01-20
uration Suite - dry Base variantConfiguration,
Devel API – advancedVariantConfiguration, and
op New solutionConfiguration. It is also possible to search for
ment Heade knowledge bases via type.
Effi- r Field
See: API Definition
ciency Type
Related Information
Introduction
You can get started with the Variant Configuration service using the standard procedures for the SAP Business
Technology Platform Cloud Foundry environment.
Before starting, make sure that you have all required versions of the software you are integrating. For that
please refer to SAP Note 2711932 .
To exchange data between cloud solution SAP Variant Configuration and Pricing and the licensee’s local on-
premise SAP ERP or SAP S/4HANA back end, SAP Variant Configuration and Pricing also comprises the SDI
Data Provisioning Agent, which is part of SAP HANA smart data integration. The SDI Data Provisioning Agent is
an on-premise application that is to be installed and operated locally in the customer’s on-premise landscape.
For data exchange with SAP ERP systems, using a third-party runtime database obtained from SAP, such as
Microsoft SQL Server or Oracle DB. Certain restrictions apply according to the applicable on-premise license
agreements for the third-party runtime databases. One such restriction is that the licensee may not access
these databases directly via systems or technologies that have not been licensed specifically for use with such
runtime database. Therefore, the corresponding SDI Data Provisioning Agent Adapters provided with SAP
Variant Configuration and Pricing may not be used to directly access, or replicate data from, such third-party
runtime databases licensed from SAP.
For third-party database licenses not obtained from SAP, please refer to the respective license agreements on
the available options for data exchange via direct database accesses.
For more information about interoperability and maintenance rules for the Data Provisioning Agent, see SAP
Note 2546811 .
When your organization signs a contract for SAP Business Technology Platform services, an e-mail is sent to
the IT contact person specified in the contract. The e-mail message contains the link to log on to the system,
the SAP Cloud Identity credentials, and the user ID for the specified user. These credentials can also be used
for sites such as the SAP Store , SAP Community , Software Downloads and the SAP Support Portal
for example, to download Data Provisioning Agent.
You will find different information in that e-mail depending on the licensed product.
For example:
You need one tenant of SAP Variant Configuration and Pricing for every back-end client that will be connected.
SAP Business Technology Platform comes with two environments, the Neo environment, and the Cloud
Foundry environment. SAP Variant Configuration and Pricing is based on the Cloud Foundry environment. Each
contract provides one global account, with the entitlements needed to use SAP Variant Configuration and
Pricing. With it you will get entitlements for the Variant Configuration service, Pricing service and SAP Variant
Configuration and Pricing SaaS application for data replication and administration.
You might want to add further users as members to that global account, or change the global account
description as described in Add Members to Your Global Account.
Related Information
To know the steps that you need to follow to enable the Variant Configuration service, please read the
Administration Guide for SAP Variant Configuration and Pricing.
For the license material SAP Variant Configuration and Pricing (8006356) and the service plan default, we
will report at the subaccount level the peak usage of gigabytes runtime memory per month. To view that
data, please open your global account on SAP Business Technology Platform and open the menu Usage
Analytics. In the section Service Usage please choose service SAP Variant Configuration and Pricing. Please
also choose the subaccount and period of interest. Please note: Choosing the subaccount All Subaccounts
lets cloud cockpit aggregate all the subaccounts’ peak usages. This number does not have any meaning. In
cloud cockpit we cannot show you the peak usage per global account.
2.4 Development
To know the tasks and procedures that are relevant for the application developer when adjusting the
application to consume the Variant Configuration service please read the Development Guide for SAP Variant
Configuration and Pricing Services, and do the tutorial Create an SAPUI5 Application for SAP Variant
Configuration and Pricing .
For an overview of the extension concept of SAP Variant Configuration and Pricing See the Extension Guide for
SAP Variant Configuration and Pricing.
2.5 Administration
Some initial configuration steps may be necessary to enable the service initially. See Initial Setup [page 10].
For all the information about the administration of the service see the Administration Guide for SAP Variant
Configuration and Pricing.
2.6 Security
To know the settings and configurations that are relevant to operating the Variant Configuration service in a
secure manner, please read the Security Guide for SAP Variant Configuration and Pricing. Please also refer to
the security guide for auditing and logging information.
Please refer to the Administration Guide for information about Monitoring of data replication.
E-mail notifications are supported via the Alert Notification service (separate license needed for that
service).
The following alert types are available:
● SAP HANA smart data integration Data Provisioning Agent status: an alert is sent if your SAP HANA
smart data integration Data Provisioning Agent reports an error. This alert is not sent immediately, but
after a second check is done, some minutes later, to prevent false alerts caused by brief connection issues.
● Replication failure: an alert is sent if there is an error during the replication of a table.
● Get contacted by SAP Support: SAP Support will send you an alert if you need to take an action, e.g., in
case a new SDI Agent version needs to be installed.
Service Availability
To be notified of maintenance events of SAP Variant Configuration and Pricing, visit the Cloud Availability
Center and use the Cloud System Notification Subscriptions .
Please also refer to Cloud Availability Center and Cloud System Notification Subscriptions .
Engine Traces
In case of unexpected results in configuration or pricing, a special logging can be enabled to see how the
corresponding engine has calculated those values. See Engine Traces.
Reporting an incident
You can report an incident or error through the SAP Support Portal .
Please open an incident using component LOD-CPS. We recommend including the following information:
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.