Use Case for Download of Bonus Buy Promotions to SAP POS

Description
A bonus buy defines the set of item(s) for which a discount type can be granted
when certain requirements are met. Fixed price, fixed discount, percentage
discount or free goods discount are possible for bonus buy conditions.
This use case describes the transfer of bonus buy definitions from the ERP
system to the SAP (GM) POS system using the POS integration content.
The following is a subset of the bonus buy scenarios currently supported for
this content:

Buy
Buy
Buy
Buy
Buy
Buy
Buy
Buy

y number of z items, get one w item for free (lowest price)

y number of z items, get x percent off an additional w item
y number of z items, get x percent off purchase
y number of z items, get x amount off an additional w item
y number of z items, get x amount off purchase
y number of z items, get one w item at fixed price
y number of z items for fixed price
one z item, get a free gift

Where the z item can be a single article or an article grouping. The w item can
be a single article or an article grouping or identical to the z item. This depends
on the bonus buy definition. In older versions of SAP (GM) POS,
the inclusion/exclusion functionality does not exist. In this case, the set of z and
w items are identical. Also, the retail price of the z items must be greater than
or equal to the retail price of w items in order for the discount of the bonus buy
to be applied.
Note that:

bonus buys in the ERP system are referred to as mix matches in the POS
system.
inclusion/exclusion is available in SAP (GM) POS version 2.1 or higher.

Flow
Main Flow

1. If the retailer deletes one or more bonus buy(s), refer to Use Case:
Deletion of Bonus Buy Promotions.
2. The retailer creates and/or modifies one or several bonus buys for a set
of items for a specific store or group of stores in the ERP system using
the transactions VBK1and VBK2, respectively.
Note that the bonus buys must be defined as described in the
Configuration Guide in order for the integration to work as designed.
3. The retailer performs a download of the bonus buy data in the ERP
system to one or more stores with transaction WPMA. The bonus buys
are transferred through the ERP Bonus Buy Conditions IDoc.
4. Once the ERP system generates the Bonus Buy Conditions IDoc, the XI
system processes the bonus buy information through a two-step
mapping.
5. When the conversion is complete in the XI system, the generated input
files are transferred to the SAP (GM) POS system, where the mix match
and inclusion/exclusion data is stored in the POS database.
6. If a cashier at a given store tries to scan (or enter) the bar code
number(s) of one or more articles that have been assigned to a mix
match and the prerequisites are met, the mix match description and
discount are displayed at the register.

Format of ERP Bonus Buy Conditions IDoc

The IDoc WPDBBY01 is used for the download of bonus buy promotions.
The following table provides a description of the common elements in the IDoc
for each type of bonus buy scenario:
IDoc elements
DOCNUM
E1WPBB01 segment
FILIALE
BBY_NR
POINT
AENDKENNZ
E1WPBB02 segment

MAT_EAN

Description
This field specifies the document number of the IDoc.
Each segment represents a bonus buy condition.
Store for which the bonus buy is applicable.
The bonus buy number.
Specifies the condition target type for the bonus buy
(i.e. article, article grouping, total sale, all prerequisites)
Specifies the action performed on the bonus buy
information.
Each segment defines the items that can receive the
discount once the bonus buy conditions are reached.
Note that this information is required when using
the inclusion/exclusion functionality available in SAP
(GM) POS 2.0.
The international article number (EAN/UPC) for the
"Get" article. Note that the bonus buy is referenced
through the EAN of an article.

E1WPBB04 segment
MAT_EAN

E1WPBB05 segment
START_DATE
END_DATE
BBY_TYPE
E1WPBB06 segment
CALC_RULE
SHORT_TEXT
LANGUAGE_ISO

Each segment defines the items that can be purchased

for the bonus buy to be applied.
The international article number (EAN/UPC) for the
"Buy" article. Note that the bonus buy is referenced
through the EAN of an article.
Each segment represents the terms of the
discount/condition for the bonus buy.
Date when the bonus buy starts.
Date when the bonus buy ends.
Specifies the type of discount or condition.
This segment defines the conditions and pricing terms
for the discount.
Specifies the calculation type for determining free
goods quantity.
Description of the bonus buy.
Identifies the language used for requested and provided
descriptions.

Sample: Buy 2 of Item 2050000029202 Get One Free (lowest price)

< WPDBBY01>
<DOCNUM>000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BB1FREE</BBY_NR>
<CATEG>M</CATEG>
<POINT>M</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB02 SEGMENT="1">
<MAT_NR>000000000000000159</MAT_NR>
<MAT_EAN>2050000029202</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MAT</PRQ_TYPE>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000000159</MAT_NR>
<MAT_EAN>2050000029202</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB04</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>N</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<FG_MIN_QUAN>2.000</FG_MIN_QUAN>
<FG_QUAN>3.000</FG_QUAN>

<FG_ADD_QUAN>1.000</FG_ADD_QUAN>
<CALC_RULE>001</CALC_RULE>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 2 get 1 free</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
FG_MIN_QUAN
FG_QUAN
FG_ADD_QUAN
POINT of E1WPBB01
segment

Description
Indicates the minimum number of items to purchase.
Total number of items to be purchased in the bonus buy.
Indicates the number of free items granted.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'M' indicates article.

Sample: Buy 2 of item 2050000029332, get 50 percent off additional

item 2050000029333
< WPDBBY01>
<DOCNUM>000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BB2P50</BBY_NR>
<CATEG>M</CATEG>
<POINT>M</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB02 SEGMENT="1">
<MAT_NR>MTL00006</MAT_NR>
<MAT_EAN>2050000029333</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MAT</PRQ_TYPE>
<E1WPBB04 SEGMENT="1">
<MAT_NR>MTL00005</MAT_NR>
<MAT_EAN>2050000029332</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB03</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>%</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<KOND_SIGN>-</KOND_SIGN>
<KOND_PER>50.000</KOND_PER>
<FG_MIN_QUAN>2.000</FG_MIN_QUAN>

<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 2 Get 50% of 3rd</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_PER
FG_MIN_QUAN
POINT of E1WPBB01
segment

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the percentage amount for the discount.
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'M' indicates article.

Sample: Buy 2 items, get 50 percent off purchase

< WPDBBY01>
<DOCNUM>0000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BB2PT50</BBY_NR>
<CATEG>M</CATEG>
<POINT>R or P</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB03 SEGMENT="1">
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000317016</MAT_NR>
<MAT_EAN>2050000015458</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000317050</MAT_NR>
<MAT_EAN>2050000016479</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB03</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>%</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<KOND_SIGN>-</KOND_SIGN>
<KOND_PER>50.000</KOND_PER>
<FG_MIN_QUAN>2.000</FG_MIN_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>

<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 2 Get 50% of total</SHORT_TEXT>
Note that in this case, the following combinations are possible to grant the
discount:
1. Buy 2 of item 2050000015458
2. Buy 2 of item 2050000016479
3. Buy 1 of item 2050000015458 and buy 1 of item 2050000016479
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_PER
FG_MIN_QUAN
POINT of E1WPBB01
segment

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the percentage amount for the discount.
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'R' indicates total sale.

Sample: Buy 3 items, get 5 dollars off of item 2050000013837

< WPDBBY01>
<DOCNUM>0000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000002101</FILIALE>
<BBY_NR>BB3A5</BBY_NR>
<CATEG>M</CATEG>
<POINT>M</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB02 SEGMENT="1">
<MAT_NR>000000000000611063</MAT_NR>
<MAT_EAN>2050000013837</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000611062</MAT_NR>
<MAT_EAN>2050000013836</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB02</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>R</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<SCALE_TYPE>B</SCALE_TYPE>

<KOND_SIGN>-</KOND_SIGN>
<KOND_VAL>5</KOND_VAL>
<KOND_CURCY>USD</KOND_CURCY>
<KOND_CURCY_ISO>USD</KOND_CURCY_ISO>
<FG_MIN_QUAN>3.000</FG_MIN_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 3 Get 5$ 4th</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_VAL
FG_MIN_QUAN
POINT of E1WPBB01
segment
KOND_CURCY_ISO

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the actual amount in a particular currency for
the discount.
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'M' indicates article.
Specifies the currency key for the amount in the case of
absolute markdowns.

Sample: Buy 3 of item 2050000005657, get 10 dollars off purchase

< WPDBBY01>
<DOCNUM>000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BB3AT10</BBY_NR>
<CATEG>M</CATEG>
<POINT>R or P</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MAT</PRQ_TYPE>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000311231</MAT_NR>
<MAT_EAN>2050000005657</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB02</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>R</BBY_TYPE>
<E1WPBB06 SEGMENT="1">

<SCALE_TYPE>B</SCALE_TYPE>
<KOND_SIGN>-</KOND_SIGN>
<KOND_VAL>10</KOND_VAL>
<KOND_CURCY>USD</KOND_CURCY>
<KOND_CURCY_ISO>USD</KOND_CURCY_ISO>
<FG_MIN_QUAN>3.000</FG_MIN_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 3 Get 10$ Off</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_VAL
FG_MIN_QUAN
POINT of E1WPBB01
segment
KOND_CURCY_ISO

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the actual amount in a particular currency for
the discount.
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'R' indicates total sale.
Specifies the currency key for the amount in the case of
absolute markdowns.

Sample: Buy 2 items, Get 1 of item 2050000013837 for 5 dollars

< WPDBBY01>
<DOCNUM>0000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BBPRICE</BBY_NR>
<CATEG>M</CATEG>
<POINT>G</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB02 SEGMENT="1">
<MAT_NR>000000000000611063</MAT_NR>
<MAT_EAN>2050000013837</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MGP</PRQ_TYPE>
<GRPG_NR>GROUP01</GRPG_NR>
<E1WPBB04 SEGMENT="1">
<MAT_QUAN>2.000</MAT_QUAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000611062</MAT_NR>

<MAT_EAN>2050000013836</MAT_EAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000610733</MAT_NR>
<MAT_EAN>2050000010750</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB01</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>P</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<SCALE_TYPE>C</SCALE_TYPE>
<KOND_SIGN>-</KOND_SIGN>
<KOND_VAL>5.00</KOND_VAL>
<KOND_CURCY>USD</KOND_CURCY>
<KOND_CURCY_ISO>USD</KOND_CURCY_ISO>
<FG_MIN_QUAN>2.000</FG_MIN_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 2 Get 1 at $5</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_VAL
FG_MIN_QUAN
POINT of E1WPBB01
segment
KOND_CURCY_ISO

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the actual amount in a particular currency for
the item(s).
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'G' indicates article
grouping..
Specifies the currency key for the price amount.

Sample: Buy 3 items for 10 dollars

< WPDBBY01>
<DOCNUM>0000000000255141</DOCNUM>
<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BBTOTPRICE</BBY_NR>
<CATEG>M</CATEG>
<POINT>R or P</POINT>
<AENDKENNZ>MODI</AENDKENNZ>

<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MGP</PRQ_TYPE>
<GRPG_NR>GROUP01</GRPG_NR>
<E1WPBB04 SEGMENT="1">
<MAT_QUAN>2.000</MAT_QUAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000611066</MAT_NR>
<MAT_EAN>2050000013840</MAT_EAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000610740</MAT_NR>
<MAT_EAN>2050000010760</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB01</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>P</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<SCALE_TYPE>C</SCALE_TYPE>
<KOND_SIGN>-</KOND_SIGN>
<KOND_VAL>10.00</KOND_VAL>
<KOND_CURCY>USD</KOND_CURCY>
<KOND_CURCY_ISO>USD</KOND_CURCY_ISO>
<FG_MIN_QUAN>3.000</FG_MIN_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 3 for $10</SHORT_TEXT>
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
KOND_SIGN
KOND_VAL
FG_MIN_QUAN
POINT of E1WPBB01
segment
KOND_CURCY_ISO

Description
Indicates if there is a negative or positive adjustment to
the price.
Specifies the actual price in a particular currency for the
item(s).
Indicates the minimum number of items to purchase.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'R' indicates total purchase.
Specifies the currency key for the price amount.

Sample: Buy one item, Get a free gift

< WPDBBY01>
<DOCNUM>0000000000255141</DOCNUM>

<E1WPBB01 SEGMENT="1">
<FILIALE>0000009901</FILIALE>
<BBY_NR>BBGIFT</BBY_NR>
<CATEG>M</CATEG>
<POINT>G</POINT>
<AENDKENNZ>MODI</AENDKENNZ>
<E1WPBB02 SEGMENT="1">
<MAT_NR>000000000000315212</MAT_NR>
<MAT_EAN>2050000006402</MAT_EAN>
<E1WPBB02 SEGMENT="1">
<MAT_NR>000000000000315222</MAT_NR>
<MAT_EAN>2050000006433</MAT_EAN>
<E1WPBB03 SEGMENT="1">
<PRQ_TYPE>MGP</PRQ_TYPE>
<GRPG_NR>BBGRP01</GRPG_NR>
<E1WPBB04 SEGMENT="1">
<MAT_QUAN>1.000</MAT_QUAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000315211</MAT_NR>
<MAT_EAN>2050000006401</MAT_EAN>
<E1WPBB04 SEGMENT="1">
<MAT_NR>000000000000315221</MAT_NR>
<MAT_EAN>2050000006432</MAT_EAN>
<E1WPBB05 SEGMENT="1">
<COND_TYPE>BB04</COND_TYPE>
<START_DATE>20070419</START_DATE>
<END_DATE>99991231</END_DATE>
<BBY_TYPE>N</BBY_TYPE>
<E1WPBB06 SEGMENT="1">
<SCALE_TYPE>C</SCALE_TYPE>
<FG_MIN_QUAN>1.000</FG_MIN_QUAN>
<FG_QUAN>2.000</FG_QUAN>
<FG_ADD_QUAN>1.000</FG_ADD_QUAN>
<E1WPBB07 SEGMENT="1">
<LANGUAGE>E</LANGUAGE>
<LANGUAGE_ISO>EN</LANGUAGE_ISO>
<SHORT_TEXT>Buy 1 Get 1 Free Gift</SHORT_TEXT>
Note that in this case, the purchase of item 2050000006401 or
2050000006432 grants the discount. This case is similar to "Buy 1 get 1 free".
The fields of segment E1WPBB06 for the above scenario are described below:
IDoc elements
FG_MIN_QUAN

Description
Indicates the minimum number of items to purchase.

FG_QUAN
FG_ADD_QUAN
POINT of E1WPBB01
segment

Total number of items to be purchased in the bonus buy.

Indicates the number of free items granted.
Specifies the condition target type for the bonus buy.
For this scenario, the value 'G' indicates article
grouping.