Functionality
This method selects all the data that can be used by external spacemanagement programs (SMP) in SAP Retail.
The following data can be transferred to the SMP:

• Master data:

Material number, material short text, unit of measure, EAN/UPC, materialcategory, material group, material dimensions, shelf sequence, shelfsection, horizontal facing, vertical facing (=front), vendor,manufacturer, generic material, purchase price, and sales price withvarious additional data.

• Movement data:

Stock, business volume figures, sales figures, optimum and maximum shelfquantity and presentation quantity.

• Header data:

Customer, plant, space management profile, purchasing organization,sales organization, distribution channel, layout, layout module, layoutarea, layout module version with additional data, layout module variant,document number for the assigned document, path for the layout document,time period for selecting movement data, key date for pricedetermination or listing check, reference customer and date of the lastspace management run.
Import parameters that are necessary include the layout moduleSiteLayoutModule, a date for the price determination, theselection of movement data, the listing check, and possibly theselection of the valid version of a layout module Pricedate, anda layout module version.
Using the Stores and Storegroups tables, you can definefor which plants or plant groupings movement data or prices are to bechosen.
In the Controls import structure, you can define control data fordata selection.
The following control data is available:

• An indicator for whether a listing check is to be run or not


• An indicator for whether a check is to be run on the layout module to
layout and plant

• An indicator for whether the material movement data is to be read from
all plants to which the chosen layout module is assigned

• An indicator for whether a plant has been chosen


• The space management profile for controlling the export of data for
individual plants

• A mapping variant. The mapping variants are defined in the customer exit
for this method. You can therefore access different mapping variants foreach call. For example, one mapping variant can determine the averagevalue of the movement data and another mapping variant can cumulatethis.

• A layout module variant


• A layout module version


• And an indicator for whether the version is to be determined using the
selection date.
This method first defines additional header data for the selection data,for example, the path for the planogram file that belongs to the layoutmodule version in question. Various checks are executed which areseparate from the control data settings. The materials assigned to thelayout module are chosen separately from the control data. Materialmaster data, prices and movement data for the individual materials areread from the master data tables. The master data and movement data iswritten into the Items table while the header data is preparedfor the export in the Head_Data structure.
Furthermore, all materials which have multiple placements are flaggedaccordingly. Multiple placement means that a material is assigned tomore than one layout module for a particular customer. The total numberof placements is also stated. A material can be placed in variousshelves in a plant. A popular example of this is batteries which areoften placed in various shelves in the toy department, the householdgoods department, and in the POS area.
In addition, the idea of assigning materials to layout module versionsenables the multiple placement of a material on a shelf. This means amaterial can be placed on the lowest shelf with double facing as well asbeing on the top shelf with single facing.
You must also take into account that if a plant is chosen and a layoutmodule variant was assigned to this plant, then the materials from thelayout module variant are read along with the materials from the layoutmodule version.
A layout module variant maps the regional or local specifications forgrouping materials together into a layout module. This means that alayout module variant contains the material variances (the delta) forthe layout module. The result of this is that both the inclusion ofmaterials (additional materials for the layout module that are placed inthe plant for which this layout module variant is assigned) and theexclusion of materials (materials that are assigned to the layoutmodules, although they are not placed in this plant) are included in theconcept of the layout module variant.
In this context, you must take into consideration that both placementsare read by the SAP R/3 System which means that the placement of amaterial in the layout module version is canceled by its exclusion inthe corresponding layout module variant. In the former case, thematerials that are read from the layout module variant have to be addedto the materials from the layout module version.
For example, the normal shelf for dairy products may contain dairyproducts from the south. A plant in the north, however, wants to placelocal dairy products in the shelf instead of southern produce. By doingthis, the layut module version will not be altered, but a layout modulevariant for the dairy produce shelf is assigned to this plant. And thisis done by flagging the southern dairy produce with an exclusionindicator and the dairy products that are required have no exclusionindicator.

Notes
Consistency checks are always carried out for layout modules, and forthe space management profile (if applicable), and additional checksdependent on the control parameters may also be carried out.
INCLUDE BAPI_RET
To avoid unnecessary reading of data and to improve performance, you candefine whether prices, quantities, and sales/business volumes are readand therefore exported.
Customizing settings for the spacemanagement profile
Selection period for the movement data, the info structures that wereused including the relevant fields for stock, business volume,determination of the function module relevant for data export and(optional) the function module to be used for data transfer to SAPRetail Store.
For creating and maintaining variants, you use transactionMCHD or call the Customizing transactionCreate/maintain selection variants.
In addition, you can check the space management profiles for consistencyand completeness using the transaction Checkspace management profiles.
For materials with multiple placements, note that the movement data isalways valid for the whole plant and not for the individual layoutmodule. If more than one plant is chosen, these fields are not filledbecause the total number of placements for a material can differ fromplant to plant.
The listing check ascertains whether a material is listed and/or can besold. The time period for the listing check therefore covers the listingperiod and the sales period.
If a space management profile has not been defined in the control data,the reference plant profile is automatically used for the layout module.
The layout check ascertains whether the layout module you entered isassigned to the plants, and whether the plants even have a layout.
If the indicator has been set so that no plant is to be selected, onlythe material master data and no movement data is read.
If both plants and plant groupings are found when you call the method,and the indicator for reading all the plants has been set, the indicatortakes priority. This means that the material movement data is read forall the plants to which the selected layout module has been assigned.
If one or more plant groupings are chosen, the plants in this groupingare prepared for export in the Stores table.
An error message is generated if no valid entries are found when youselect plants from plant groupings.
The value of the reference stores is used to find an average price whenyou choose prices and movement data from several plants in the standardsystem while the stocks, business volume and sales volume arecumulated.The header data is related to the reference plant for thelayout module in this case.
After data is selected, the method uses a customer exit to prepare andselect any additional data before you export the data.
Material length in SAP Retail corresponds to material depth in the spacemanagement program.
The length of the document path must not exceed 140 characters.
GLOSSARY:
Here is a glossary of short definitions for all the important terms:
Planogram:
Graphical representation of a shelf in a space management program.
Layout:
The spatial arrangement of goods on offer in a store or department. Alayout consists of layout modules and can be assigned to one or morestores.
Layout area:
A layout can be divided into layout areas, and a layout area correspondsto exactly one layout module in the layout.
Layout module:
Grouping of materials that are to be presented together in a store inthe same area. A layout module can correspond graphically to one or moreshelves. Different layout module versions may be available for onelayout module and these versions are valid for a certain period of time.Different materials can be assigned to the versions. Deviations on thevalid version can be mapped using layout module variants for individualstores.
Layout module version:
Characteristic of a laoyut module. The layout module version allocatesmaterials to a layout module for a certain period of time, and by doing,enables the planning for the layout modules. There is at least oneversion for every layout module. Only one version can ever be valid atany one time.
Layout module variant:
Marginal deviations in the currently valid version can be determinedusing layout module variants for individual stores. Additional materialscan be included in the variant for the currently valid version. Therecould also be materials missing in the version. The currently validversion is also described as the basic variant. Layout module variantsalways relate to a basic variant and, from a technical point of view,contain only the delta, which is the deviation on this basic variant.

Further information
For more information, see the SAP Library under Logistics -> SAP Retail.

Description
This structure contains all header data relevant for exporting datainto the space management program.
INCLUDE BAPI_DATAELEMENT

Description
INCLUDE BAPI_TABLE

Value range
If an error occurrs, you will receive the following error messages:
Messages for input checks:
Type,, Code,, Number,, Message
E,, WB,, 024,, Customer &1 does not exist
E,, WB,, 121,, Layout module &1 does not exist
E,, WB,, 801,, Data for customer &1 is not complete
E,, WB,, 808,, Layout module &1 is not assigned to customer &2
E,, WB,, 810,, No layout is assigned to customer &
E,, WB,, 837,, No reference customer is assigned to layoutmodule &1
E,, WB,, 857,, Do not choose all customers or no customers atthe one time
Messages for internal error situations:
Type,, Code,, Number,, Message
E,, WB,, 005,, No materials have been assigned to the layoutmodules that you have chosen
E,, WB,, 797,, Field &1, field 2 and field &3 are not selection fields
E,, WB,, 811,, No data exists for selection variant &1 in infostructure &2
E,, WB,, 813,, No materials are listed or on sale
E,, WB,, 819,, Error when dynamically reading info structure &1
E,, WB,, 820,, Space management profile &1 does not exist
E,, WB,, 822,, Selection variant &1 for space management does notexist
E,, WB,, 823,, No fields in selection variant &1
E,, WB,, 824,, Field &1 is not contained in selection variant2 as a return code
E,, WB,, 825,, No field name has been created for salesquantity or sales value
E,, WB,, 829,, Selection variant &2 does not contain field &1as a selection field
E,, WB,, 836,, Neither field &1 nor field &2 is a selection field inselection variant &3
E,, WB,, 838,, No space management profile has been assigned tocustomer &1
E,, WB,, 841,, No valid plants were chosen
E,, WB,, 873,, Function module &1 does not exist

Description
This structure contains the control data required for selectingmaterial data from SAP Retail and sending it to the space managementprogram. For further information, see the function moduledocumentation.
INCLUDE BAPI_DATAELEMENT

Description
Grouping of materials for assortment management. Materials are assignedto the layout module in integrated material maintenance. In addition,you can process a mass assignment of materials to a layout module usingTransaction MASS. The layout module contains all theplaceable materials contained in the planogram for the external spacemanagement program.
INCLUDE BAPI_KEYFIELD

Value range
The agreements for layout module to customer and layout module tolayout assignments are checked and incorrect entries are caught usingthe message Layout module is not assigned tocustomer .

MEANING&
The key date for pricing defines the date on which purchase prices,sales prices, and transaction data is defined. The key date is alsodefined for the listing check. In the listing check, the system checksif the date entered is found in the listing period and/or in the salesperiod for a material. The key date is also used for selecting thelayout module version.

Value range
Entering invalid dates results in the following message appearing:Enter dates in form __.__.____.

Default
The system date is the default value.

Description
This structure is used as an additional method of selecting andexporting header data and item data.


• To prepare additional header data for export, you must create
additional fields in structure BAPI_TE_HEAD_DATA and then fillthe table accordingly with reference to the structure. The onlyrequired entry field for the structure is the layout module.

• To prepare additional item data for export, you must create your
additional fields in structure BAPI_TE_ITEMS and then fill thetable accordingly with reference to the structure. Required parametersfor the structure are the material and unit of measure.
This table supplies the method customer exit.
INCLUDE BAPI_DATAELEMENT

Description
This table contains all the materials assigned to the layout module.Numerous master data and movement data is transferred for eachmaterial. Required parameters are material number, dimensions, unit ofmeasurement and EAN/UPC.
INCLUDE BAPI_DATAELEMENT

Description
This table contains all plants for which movement data is to beselected from SAP Retail.
INCLUDE BAPI_DATAELEMENT

Notes
If one or more plant groupings are to be selected for reading thematerial movement data, the plants for all groupings are to be preparedin this table as information for the external space management program.

Description
This table contains all plant groupings for which movement data is tobe selected from SAP Retail.
INCLUDE BAPI_DATAELEMENT