Functionality
This method selects in SAP Retail all the data suitable for the externalspace management program. The necessary import parameters areCustomersite, and SiteLayoutModule. A key date for pricedetermination or listing check Pricedate (optional) can also beentered, and an indicator for whether a listing check List_Checkis required can also be selected.
First, the additional header data is read for the selection data, suchas the path for the planogram file belonging to the layout module. Allheader data is checked for consistency, and the space management profilefor the selected customer is read.
The materials assigned to the layout module are then selected. Thesystem also checks whether the materials are valid for the listingperiod or sales period. Master data, prices, and movement data are thenread for the individual materials. The master data and movement data arewritten to table Items, while the header data is stored instructure Head_Data. The following data can be transferred to thespace management program:

• Master data:

Material number, material short text, unit of measure, EAN/UPC, materialcategory, material group, material dimensions, sort sequence in shelf,shelf section, facing, vendor, manufacturer, generic material, purchaseprice, sales price and various supplementary data.

• Movement data:

Stock, sales figures, business volume figures

• Header data:

Customer, site, space management profile, purchasing organization, salesorganization, distribution channel, layout, layout module, layout area,document number of the assigned document, path for the layout document,period for selection of movement data, key date for price determinationor listing check, reference customer, date of last space management run.
In addition, all materials placed in shelves more than once are flagged,i.e. materials assigned to several layout modules within a layout. Thenumber of placings is also defined.

Notes
As mentioned above, the system checks for consistency and dependencybetween the two mandatory parameters. The validity of the entriesReference customer and Layout module are checked, and error messages areissued where appropriate. In addition, dependencies between referencecustomer and layout, and layout module and layout are checked.
INCLUDE BAPI_RET
In Customizing for the space managementprofile, you define the selection periods for the movement data, theinfo structures used (together with the relevant fields for stock, salesand business volume), the selection variable (month/day) for the infostructures and the function module relevant to data exports. To preventdata being read unnecessarily, and to improve performance, you can setwhether prices, quantities, and sales/business volumes are read, andtherefore exported. You use Transaction MCHD to createand maintain selection variants, or call the transaction fromCustomizing under Maintain selectionvariants. In addition you can use TransactionCheck space management profile to checkthe consistency and completeness of the space management profile.
If materials are placed in shelves more than once, note that themovement data is always valid for the whole plant, and not forindividual layout modules.
During the listing check, the system checks whether the material islisted and/or can be sold. The check period for the listing checktherefore covers the listing period and the sales period.
After the data has been selected, the method has a customer exit whichcan be used to prepare the selected data prior to the transport, and toselect additional data.
The article length in SAP Retail corresponds to the article depth in theSMP.
The length of the document path is not to exceed 140 characters.

Further information
For more information, see the documentation underSpace Management in the SAPLibrary.

Description
This structure contains all the relevant header data relevant forexport to a space management program.
INCLUDE BAPI_DATAELEMENT

MEANING&
INCLUDE BAPI_TABLE

RANGE&
If errors occur, the following messages are issued:
Messages for input checks:
TypeCode 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 incomplete
E WB 808 Layout module &1 is not assigned to customer &2
E WB 810 Customer & is not assigned to a layout
Messages for authorization :
TypeCode Number Message
Messages for internal errors:
TypeCode Number Message
E WB 005 No materials are assigned to the selected layout module
E WB 811 No data exists for selection variant &1 in infostructure
2
E WB 813 No materials listed or on sale
E WB 819 Error during dynamic reading of info structure &1
E WB 820 Space management profile &1 does not exist
E WB 821 Description for space management profile does not exist
in language &2
E WB 822 Selection variant &1 for space management does not
exist
E WB 823 No fields in selection variant &1
E WB 824 Field &1 is not included as a return value in selection
variant &2
E WB 825 Field name for neither business volume quantity or
business volume value are maintained
E WB 829 Field &1 is not included as a selection field in
selection variant &2
E WB 838 No space management profile is assigned to customer &1

Description
Customer to which the layout module is assigned via the assignment tothe layout. This customer may be different to the reference customerfor the layout module. A reference customer, whose material data isrepresentative of all customers who use the layout module, can beassigned to each layout module.

Value range
If you enter a customer that does not exist, the system issues themessage Customer does not exist. In addition, thecustomer data is checked for completeness, and if it is not complete,the message Data for customer is incomplete. Thesystem also checks whether the customer entered is a referencecustomer, and if it is not, the system issues message Customer is not a reference customer.

Description
Grouping of materials for assortment management. The materials areassigned to the layout module in integrated material maintenance.
Transaction MASS can also be used to carry out massassignment of materials to a layout module. The layout module containsall the materials that can be placed in the planogram of the externalspace management program.
INCLUDE BAPI_KEYFIELD

Value range
The system checks the layout to customer assignment against the layoutmodule to layout assignment, and if the entries are incorrect, thesystem issues the message Layout module is notassigned to customer .

Description
This indicator checks whether the listing check is switched on for thematerials in the layout module.

Value range


• Value 'blank': Listing check is not executed


• Value 'X': Listing check is executed

Default
Default value is 'blank'.

MEANING&
The key date for price determination is the date for which purchaseprices, sales prices, and movement data is calculated. The key date isalso specified for the listing check. In the listing check, the systemchecks whether the date entered falls within the listing period and/orthe sales period for the material.

Value range
If invalid data is entered, the system issues the message Enter thedate in the form __.__.____.

Default
The default value is the system date.

Description
This table contains all the articles assigned to the layout module. Avariety of master data and movement data is transferred for eacharticle. For each material, a large amount of master data and movement
data is transferred. Entries are required for the material number,dimensions, unit of measure and EAN/UPC.
INCLUDE BAPI_DATAELEMENT