Functionality
You use this method to replicate batch-specific material units ofmeasure to the target system.
The method includes the following functions:

• Batch-specific units of measure for a material

Change
Create
Delete

• Change alternative units of measure to batch-specific units of measure


• Change batch-specific units of measure to alternative units of measure

Only the attributes relevant for batch-specific units of measure arereplicated with this method. You can find these attributes in thedocumentation on the table parameterBatch-SpecificUnits of Measure.
All other attributes of an alternative unit of measure, such as weightand volume information, must be supplied using material masterfunctions.
The prerequisites for replicating batch-specific material units ofmeasure are:

• The material already exists in the target system


• The material is assigned to a
class ofclass type 'Batch'.

• The class contains at least one characteristic to which a batch-specific
material unit of measure can be assigned. The characteristic must meetcertain format requirements and have theorganizational area'Batch-specific material units of measure'.
Before you execute this method, you must replicate the materialmaster data and the material classification with the classtype 'Batch'.

Notes

Dependencies between parameters and functions
For the functions Change batch-specific units of measure,Create batch-specific units of measure and Change alternativeunits of measure to batch-specific units of measure, it is sufficientto maintain the import tableBatch-SpecificUnits of Measure. The function that is executed for the unit ofmeasure to be maintained depends on whether the unit of measure for thematerial:


• Already exists as a batch-specific unit of measure


• Does not exist yet


• Is only defined as an alternative unit of measure until now

The functions Delete batch-specific units of measure andChange batch-specific units of measure to alternative units ofmeasure are supported in two different ways. With these functions,you must note the dependencies between the following import parameters:

• Complete replication (Complete Replication)


• Batch-specific units of measure (Batch Specific UoMs)


• Special functions (Special Functions)


• Alternative units of measure (Alternative UoMs)

For more information, refer to the documentation on the import parameterCompleteReplication.

Change-relevant attributes
You should note that you must select change-relevant attributes for allimport parameters in the relevant update information
.

Authorizations
To execute this method, you require the following authorizations:
Object description,,Object
,,Fields,,Description,,,,Values
Material master: central data,,M_MATE_MAN
,,ACTVT,,Activity,,,,02
Material master: material,,M_MATE_MAT
,,ACTVT,,Activity,,,,02
,,BEGRU,,Authorization group,,,,for material
Material master: material group,,M_MATE_WGR
,,ACTVT,,Activity,,,,02
,,BEGRU,,Authorization group,,,,for material group
Class types authorization,,C_TCLA_BKA
,,KLART,,Class type,,,,022, 023
Classification authorization,,C_KLAH_BKL
,,ACTVT,,Activity,,,,01
,,BGRKL,,Authorization group,,,,for classification
Maintenance authorization for organizational area characteristics
,,,,C_TCLS_MNT
,,ACTVT,,Activity,,,,023
,,KLART,,Class types,,,,022, 023
,,SICHT,,Organizational view indicator,,,,S

Buffering
This method works with buffering. You cannot execute any other changingmethods on the material processed in this method in the sameLogical Unit of Work (LUW)That means that a databasecommit to update the data is necessary beforehand. For moreinformation, see the transaction model for BAPI development inthe BAPI Programming Guidelines in the SAP Library.

Dependencies on other methods
This method is called by the method Replicate. If you want toreplicate batch-specific material units of measure from an SAP ERPsystem, you should use the method Replicate to trigger thereplication. For more information on this method, refer to themethod documentation.

Messages
INCLUDE BAPI_RET

Further information
For more information, see the SAP Library under:


• CA - Cross Application Components: BAPI

BAPI User Guide
BAPI Programming Guidelines

• LO - Logistics: Logistics - General: Batch Management

Description
In the case of complete replication, all batch-specific units ofmeasure for a source material are replicated in the material in thetarget system.
At the same time, the following happens to the batch-specific units ofmeasure:


• Those that no longer exist in the source material are deleted in the
target material

• Those that are no longer defined as batch-specific units of measure in
the source material but which are still defined there as miscellaneousalternative units of measure are changed to alternative units ofmeasure in the target material
The prerequisite for this procedure is that all batch-specific units ofmeasure in table parameterBatch-SpecificUoMs and all other alternative units of measure in table parameterAlternative UoMs
are passed on to the method.

Value range


• Value 'X' means that the batch-specific units of measure for a material
are completely replicated.
Entries in the table parameter Special Functions (
Special Functions
) are not taken into account.

• Value BLANK means that only the batch-specific units of measure for a
material are deleted in the target system or changed to alternativeunits of measure that are specified in the table parameter Specialfunctions (Special Functions).
Entries in the table parameter Alternative units of measure(Alternative UoM) are not taken into account.

Further_hints
You should not perform a complete replication if you know whichbatch-specific units of measure for a material you want to change ordelete in the target system.

Description
The import parameter contains the material attributes relevant forbatch-specific units of measure.
INCLUDE BAPI_DATAELEMENT

Value range
You must select attributes that are relevant for change in the relevantupdate information (parameter MaterialDataX).

Description
The import parameter contains update informationfor the relevant attributes of the material (import parameterMaterialData).
INCLUDE BAPI_DATAELEMENT

Description
The material number identifies thematerial for whichbatch-specific material units of measure are replicated.

Value range
The field must contain a material number.

Description
Parameter for the long material number
This parameter can be used to transfer long material numbers. Thesenumbers can be up to 40 characters long.
To be able to use this parameter you must activate the switch for thebusiness function LAMA (long material number) in the system.
The business function LAMA is available as a component of the businessfunction set for DIMP.

Value range
None

Default
None

Description
YOu find information on the significance of the logical system fromwhich the message originates in the relevant dataelement documentation.

Description
This table parameter contains the alternative units of measure for amaterial. This parameter is significant only if you perform a completereplication of batch-specific units of measure. For more information,refer to the documentation on import parameterCompleteReplication.
INCLUDE BAPI_DATAELEMENT

Value range
You must maintain the key field Alternative unit of measure (fieldALT_UNIT) or the ISO code for the alternative unit of measure (fieldALT_UNIT_ISO). (The international standard ISO-Code is translatedinto the SAP internal code for the alternative unit of measure.)
You must check if you also need to maintain the numerator (fieldNUMERATOR) and the denominator (field DENOMINATOR) for conversion tothe base unit of measure. These fields are relevant only when youchange a batch-specific unit of measure to an alternative unit ofmeasure. You must flag these values as change-relevant in thecorresponding update information table (tableparameter Alternative UoMX).

Description
The table parameter contains update information onthe alternative units of measure for a material (table parameterAlternative UoMX).
INCLUDE BAPI_DATAELEMENT

Value range
If you maintain the numerator or denominator for converting analternative unit of measure to the base unit of measure, you mustselect the relevant change information.
Then you must maintain the key field Alternative unit of measure (fieldALT_UNIT) or the ISO code for the alternative unit of measure (fieldALT_UNIT_ISO). (The international standard ISO code is translatedto the SAP internal code for the alternative unit of measure.)

Description
The table parameter contains the batch-specific units of measure (fieldBATCHSPECIFICUOM) for a material and their attributes:


• Characteristic (field NAME_CHAR)


• Planned value for converting the proportion or product quantity to the
base quantity (field PLANNEDVALUE)

• Indicator 'Leading batch-specific unit of measure' (field LEADINGUOM)


• Indicator 'Valuation based on the batch-specific unit of measure'
(field VALUEDUOM)

• Sort number (field UOMSORTNUMBER)

INCLUDE BAPI_DATAELEMENT
The numerator and denominator forconversion to base units of measure are calculated from the plannedvalue. The planned value is also stored as thecharacteristic valueassignment in the classification system.

Value range
INCLUDE VBWU_SAVEREPLICA_UOM_TABLE OBJECT DOKU ID TX
You must flag change-relevant attributes in the relevantupdate information table (table parameter BatchSpecific UoMX).

Description
The table parameter contains update information onthe attributes of batch-specific units of measure for a material (tableparameter Batch Specific UoMs).
INCLUDE BAPI_DATAELEMENT

Value range
INCLUDE VBWU_SAVEREPLICA_UOM_TABLE OBJECT DOKU ID TX

Description
INCLUDE BAPI_TABLE

Value range
General processing information
Type,,ID,,Number,,Message
S,,LB,,223,,Processing of batch-specific UoM for mat.
,,,,,,&1 (logical system: &2)
S,,LB,,219,,Processing for material &1 was exited without
,,,,,,changes to the database
S,,LB,,218,,No changes were made for material &1
S,,M3,,801,,Material & changed
W,,LB,,224,,Planned vals for mat. & are inconsistent
,,,,,,--> Subseq. maintenance necessary
Messages about input checks
Type,,ID,,Number,,Message
E,,LB,,209,,Material &1 is already being processed inthe current
,,,,,,transaction
E,,M3,,262,,Enter a material number
E,,LB,,203,,Please enter the editing function for unit of
,,,,,,measure &1
E,,LB,,240,,Value &3 is not permitted for field &1 in
,,,,,,parameter &2
E,,LB,,241,,Please maintain a value for field &1 in
,,,,,,parameter &2
E,,LB,,242,,Import parameter &1 contains more than one
,,,,,,record for UoM &2
E,,LB,,243,,Import parameters &1 and &2 contain one
,,,,,,record for UoM &3
E,,BM,,305,,Unit & is not created in language <(>&<)>
E,,B1,,548,,No unit of measure found for ISO code & in
,,,,,,field &
Messages about authorizations
Type,,ID,,Number,,Message
E,,M3,,849,,No authorization for material
E,,M3,,852,,No authorization for material group <(>&<)>
E,,MM,,301,,You are not authorized to maintain material
,,,,,,master data at client level
Messages about blocks
Type,,ID,,Number,,Message
E,,MC,,600,,System error occurred during lockmanagement
E,,MC,,601,,Object requested is currently locked by
,,,,,,user <(>&<)>
E,,MC,,602,,The requested object is locked by another
,,,,,,transaction
E,,MC,,603,,Lock table overflow
E,,LB,,143,,Batch class & of material & is already
,,,,,,being edited
Messages about checks at material level
Type,,ID,,Number,,Message
E,,LB,,023,,No batch class could be determined for
,,,,,,material &
E,,LB,,098,,The 'batch-specific units of measure
,,,,,,function' is not active
E,,LB,,103,,Please maintain the 'Use of UoM' key for
,,,,,,material &1
E,,LB,,104,,The use of units of measure for material &1
,,,,,,cannot be changed
E,,LB,,112,,Please assign batch class &2 to material &1
E,,LB,,113,,The batch class of material <(>&<)> was
,,,,,,changed from & to &
E,,LB,,116,,Please first maintain the base unit ofmeasure
,,,,,,for material <(>&<)>
E,,LB,,130,,Material & does not need to be handled in
,,,,,,batches
E,,M3,,818,,You have not yet entered a EAN for the
,,,,,,material &
W,,M3,,818,,You have not yet entered a EAN for the
,,,,,,material &
I,,LB,,128,,Material & does not need to be handled in
,,,,,,batches in any plant
I,,LB,,504,,Units of measure used for material &1 are
,,,,,,being changed
I,,LB,,251,,No proportion or product units exist for
,,,,,,material &
Messages about units of measure checks
- Change batch-specific units of measure
Type,,ID,,Number,,Message
E,,LB,,101,,For material & there are no allowed
,,,,,,characteristics for the batch class
E,,LB,,106,,You have already assigned unit of measure
,,,,,,& to characteristic &
E,,LB,,123,,Characteristic & cannot be used for
,,,,,,proportion or product units
E,,LB,,139,,No characteristics of batch class <(>&<)>
,,,,,,fulfill the format requirements
E,,LB,,140,,No characteristic of batch class & has
,,,,,,organizational area '&'
E,,LB,,502,,You need to enter a characteristic in order to
,,,,,,maintain proportion/product units
E,,LB,,145,,You have already marked unit of measure &
,,,,,,as leading unit of measure
E,,LB,,147,,Inventory correction factors at storagelocation
,,,,,,level are maintained for char. &
E,,LB,,095,,You have already marked unit of measure &
,,,,,,as relevant for char. val. ass.
E,,LB,,096,,There is already a valuation price forchar.
,,,,,,& and unit of measure &
E,,LB,,126,,Unit of measurement & is not allowed for
,,,,,,characteristic &
E,,LB,,109,,Planned value & is not allowed for
,,,,,,characteristic &
E,,LB,,129,,Value &1 for characteristic &2 cannot be
,,,,,,stored as numerator/denominator
E,,LB,,135,,Unit of measurement & of char. & is not
,,,,,,possible for proportion/product unit
E,,LB,,136,,Unit of measure & may not be used
,,,,,,as proportion/product unit
E,,LB,,137,,No conversion of UoM & to base UoM <(>&<)>defined
,,,,,,for unit of measurement &
E,,LB,,501,,Please maintain a planned value for
,,,,,,characteristic &1
E,,C4,,001,,Value & is not numeric
E,,C4,,002,,Value & is incompatible with template<(>&<)>
E,,C4,,005,,& does not allow interval values
E,,C4,,006,,& only allows you to enter one value
E,,LB,,107,,The units of measure are not sorted
,,,,,,consecutively
W,,LB,,107,,The units of measure are not sorted
,,,,,,consecutively
E,,LB,,108,,Maintain sort & &
W,,LB,,108,,Maintain sort & &
E,,LB,,125,,Please check conversion of UoM & to baseUoM &
,,,,,,Check for unit of measurement &
W,,LB,,125,,Please check conversion of UoM & to baseUoM <(>&<)>
,,,,,,Check for unit of measurement &
I,,LB,,146,,PLease check the inventory correctionfactors
,,,,,,at storage location level
- Create batch-specific unit of measure
Type,,ID,,Number,,Message
E,,M3,,578,,Specify a unit of measure
E,,LB,,131,,You have already assigned unit of measure
,,,,,, & to characteristic &
E,,LB,,148,,The proportion unit or product unit must be
,,,,,,different to base UoM &1
E,,LB,,161,,Proportion/product unit &1 and base unit
,,,,,,are assigned to dimension &2
E,,LB,,505,,Unit of measure &1 has the subordinate
,,,,,,unit of measure &2
E,,LB,,506,,Unit of measure &1 is superior toalternative
,,,,,,unit &2
E,,LB,,263,,Proportion unit & is assigned to adimension
W,,LB,,263,,Proportion unit & is assigned to adimension
E,,LB,,264,,Product unit & is assigned to a dimension
W,,LB,,264,,Product unit & is assigned to a dimension
W,,LB,,132,,The alternative UoM & already defined is
,,,,,,assigned to characteristic &
- Delete batch-specific units of measure
Type,,ID,,Number,,Message
E,,LB,,096,,There is already a valuation price for
,,,,,,char. & and unit of meas. &
E,,LB,,141,,Proportion or product unit <(>&<)> is being
,,,,,,used in bills of material
E,,LB,,147,,Inventory correction factors at storagelocation
,,,,,,level are maintained for char. &
E,,M3,,837,,The base unit of measure of the
,,,,,,material & cannot be deleted
E,,MM,,019,,The sales unit for the material <(>&<)> may
,,,,,,not be deleted
E,,MM,,021,,The unit & is still used as the issue unit
,,,,,,for material <(>&<)> in plant &
E,,MM,,022,,& is still used as the sales unit for
,,,,,,material & in distr. chain &/&
E,,MM,,023,,& is still used as the production unit
,,,,,,for material & in plant &
E,,MM,,024,,& is still used as the commodity code unit
,,,,,,for material & in plant &
E,,MM,,025,,& is still used as the warehouse mgmt unit
,,,,,,for material & in warehouse &
E,,MM,,026,,The commodity code unit for material<(>&<)>
,,,,,,must not be deleted
E,,MM,,027,,& is used as the delivery unit for material
,,,,,,& in distribution chain &/&
E,,MM,,028,,The order unit for material <(>&<)> must
,,,,,,not be deleted
E,,MM,,029,,The delivery unit for material <(>&<)>
,,,,,,must not be deleted
E,,MM,,269,,The unit of measure & for the material &
,,,,,,must not be deleted
E,,LB,,212,,The alternative UoM &1 of material &2 must
,,,,,,not be deleted
W,,LB,,210,,UoM &1 not defined for material &2
,,,,,,==> Cannot be deleted
W,,LB,,211,,UoM &1 not defined for material &2
,,,,,,==> cannot be changed to altern. UoM
I,,LB,,213,,Unit of measure &1 of material &2 is
,,,,,,already an alternative UoM
- Inconsistencies
Type,,ID,,Number,,Message
E,,LB,,117,,Characteristic & is no longer valid => &
E,,LB,,120,,Planned value & for UoM & is not stored as
,,,,,,char. value for char. &
E,,LB,,121,,Planned val. ( & ) and numer./denom.
,,,,,,convers.( & & ) differ for char. &
E,,LB,,133,,Inconsistent planned value forcharacteristic <(>&<)>
Other possible messages
Other possible messages include:
Type,,ID,,Number,,Message
E,,VK,,663,,Class type & is not active
E,,LB,,124,,An error occured when saving planned values
,,,,,,as characteristic value
E,,LB,,142,,Object table MARM_WS is not defined in the
,,,,,,classification system
A,,MG,,045,,Internal error while updating, inserting,or
,,,,,,deleting from table

Notes
If the table contains error messages (type = 'E') about input checks,the system ends the method without processing batch-specific materialunits of measure.
If the table contains other error messages (type = 'E' or 'A'), thesystem ends the method without changing the database.

Description
The table parameter Special Functions contains the batch-specific unitsof measure for a material that are to be deleted or changed toalternative units of measure in the target system.
This parameter is taken into account only if you do not replicate thebatch-specific units of measure completely. For more information, referto the documentation on import parameterCompleteReplication.
INCLUDE BAPI_DATAELEMENT

Value range
INCLUDE VBWU_SAVEREPLICA_UOM_TABLE OBJECT DOKU ID TX
In addition, you must specify the processing function (field FUNCTION):


• The value '1' means that the batch-specific unit of measure is changed
to an alternative unit of measure.

• The value '2' means that the batch-specific unit of measure is deleted.

If you change batch-specific units of measure to alternative units ofmeasure, you can maintain the numerator (field NUMERATOR) anddenominator (field DENOMINATOR) for conversion to the base unit ofmeasure. Then you must flag these values as change-relevant in therelevant update information table (table parameterSpecial FunctionsX).

Description
The table parameter contains update information onthe special functions (table parameter Special Functions).
INCLUDE BAPI_DATAELEMENT

Value range
If you change a batch-specific unit of measure to an alternative unitof measure and maintain the numerator or denominator for conversion ofthis unit of measure to the base unit of measure, you must select therelevant update information.
INCLUDE VBWU_SAVEREPLICA_UOM_TABLE OBJECT DOKU ID TX