StandardMaterial

The business object Standard Material is a good that is the
subject of business activity. A standard material is traded, used in manufacture, consumed, or produced.

Structure
For data on a material to be stored at the relevant organizational
level, a material is classified according to the organizational units
plant, storage location, warehouse number and storage type, and distribution chain.

Different user departments in a company or enterprise have different
views on a material (for example, Material Requirements Planning (MRP), Purchasing, or Warehouse Management).

Different parameters define how activities such as materials planning or quality inspection are carried out for a material.

A material can have different units of measure. A conversion factor to the base unit of measure is defined for each such unit.

Depending on the unit of measure, a material can have one or more International Article Numbers (EANs) for identification.

A single piece of a material can be distinguished from others by a serial number.

Materials made up of several parts can be described using bills of material (BOMs).

For requirements planning, materials whose requirements have changed are recorded in the planning file.

The different methods by which a material can be produced are determined in a production version.

Subsets of a material that are manufactured in a particular production
run and whose inventory is managed separately from other subsets of the same material are managed as batches.

Integration
The parameters material type and industry sector are used
to classify a material. They define its possible uses.

Materials with the same attributes can be grouped together in material groups.

Comment
In certain cases, a material can also be a service.

Available Methods

• Availability : ATP information [ BAPI_MATERIAL_AVAILABILITY ]
  
• Create : Create/extend material [ BAPI_STANDARDMATERIAL_CREATE ]
  
• Delete : Flag material for deletion [ BAPI_MATERIAL_DELETE ]
  
• Display : Display material [ BAPI_MATERIAL_DISPLAY ]
  
• Edit : Change material [ BAPI_MATERIAL_EDIT ]
  
• ExistenceCheck : Check existence of object [ BAPI_MATERIAL_EXISTENCECHECK ]
  
• GetBatchCertificate : Quality certificate for batch in PDF [ BAPI_MATERIAL_GETBATCHCERT ]
  
• GetBatches : Batches for material [ BAPI_MATERIAL_GETBATCHES ]
  
• GetDetail : Determine details on material [ BAPI_MATERIAL_GET_DETAIL ]
  
• GetInternalNumber : Assign new internal numbers [ BAPI_STDMATERIAL_GETINTNUMBER ]
  
• GetList : List with description [ BAPI_MATERIAL_GETLIST ]
  
• GetProductHierarchy : Read product hierarchy [ BAPI_MATERIAL_GET_PRODUCTHIER ]
  
• SaveData : Create and change material master data [ BAPI_MATERIAL_SAVEDATA ]
  

Availability

Using this function module, you can determine the receipt quantitystill available for a particular material in a certain plant according to ATP logic (MRPII).

The availability check is carried out on transferring the materialnumber, the plant and the input table (WMDVSX). The scope of the check,
that is, which stocks, receipts and issues are to be included in thecheck is defined by the combination of checking group (material master)and cheking rule. In the function module, the system uses the checkingrule defined in Sales & Distribution (A). You can overrule this
checking rule by using an interface or a user-exit (exit_saplw61v_001).A similar procedure is also valid for the plant parameters. Thecustomer number in the user-exit means that the plant selection can becontrolled via the customer. If no plant parameters are given via the
interface, the system uses the parameter 'WRK' saved in the user's fixed values.

The results of the availability check are recorded in the output table(WMDVEX). This table contains dates and available receipt quantities(ATP quantities). The results of the check depends on the following entries:

In the last two cases, the parameter 'DIALOGFLAG' is supplied. This can result in the following:

The system also displays the end of the replenishment lead time (ENDLEADTME).

Create

You can use this method to create or extend a material.

Notes

You can use internal and external number assignment if this is allowedfor the material type to be chosen. With internal number assignment, leave the parameter NewMaterial blank.

The number of the material created is returned in the parameter NewMaterial.

Delete

You can use this method to flag a material for deletion or to cancel the deletion flag.

Display

You can use this method to display a material.

Edit

You can use this method to change a material.

ExistenceCheck

This method checks the existence of a material.

Notes

Messages are returned in the parameter RETURN. The return codes and their meanings are contained in this parameter documentation.

GetBatchCertificate

This method creates a table in MIME format. This table contains aquality certificate for a batch in edited form. Only the format PDF (Adobe Acrobat(TM) Reader) is currently supported.

Besides the batch ID, you need to enter a customer number since the
data in the quality certificate comes from a customer-specific view.

Notes

Messages are returned in the parameter RETURN. The parameter documentation contains the return values and their meanings.

If no certificate can be created, you can use the table parameter MESSAGETABLE to obtain detailed information.

If you do not know the batch you require, you can use the method GetBatches to create a list of batches for a material.

GetBatches

This method is used to create a list of batches for a material. You can restrict this list by specifying input parameters.

For example, you can create a list of the batches whose shelf life expiration date is not yet exceeded.

Notes

Messages are returned in the RETURN parameter.
For the return values and their meanings, see the documentation for theRETURN parameter.

You can combine the parameters EXPIRYDATEFROM and EXPIRYDATETO (or AVAILABLEDATEFROM and AVAILABLEDATETO) as follows:

GetDetail

This method provides a selection of client-specific, plant-specific,and valuation-area-specific or valuation-type-specific detail data for a given material.

The material number is a required parameter. If only the materialnumber is transferred, the method provides only client-specific detail data for the material.

Plant-specific detail data can optionally be output for the material ifthe method has been provided with a plant (PLANT). The output ofvaluation-area-specific or valuation-type-specific detail data for thematerial requires a valuation area (VALUATIONAREA) to be specified.

Notes

For the data to be read successfully, you must be authorized to display material master data.

Messages are returned in the parameter RETURN. For the return valuesand their meanings, see the documentation for this parameter.

GetInternalNumber

This method provides a set (to be determined) of new internally assigned numbers for a material type.

Notes

To use these functions, you require the authorization for the material type.

Internal number assignment must be allowed for this material type. This
requires an internal number range to be assigned to the material type.

If the method ends with an error message, part of the material numbersrequested may already have been assigned. These material numbers are contained in the output parameter MATERIAL_NUMBER.

GetList

For the selection parameters specified, this method supplies a list ofmaterials with material description for the logon language.

Example

Selection of ALL given materials in plant 0001, storage location 0001 or storage location 002:


MATNRSELECTION : 'I', 'CP', '*' , ' '
PLANTSELECTION : 'I', 'EQ', '0001', ' '
STORAGELOCATIONSELECT : 'I', 'EQ', '0001', ' '
'I', 'EQ', '0002', ' '

Selection of all given materials in plant 0001 and whose description begins with 'XY':


MATERIALSHORTDESCSEL : 'I', 'CP', 'XY*' , ' '
PLANTSELECTION : 'I', 'EQ', '0001', ' '

Notes

Messages are returned in the parameter RETURN. The return codes and their meanings are contained in this parameter documentation.

The relationship between the selection parameters follows this schema:

GetProductHierarchy

Implementation of class method getProductHierarchy()

All subordinate nodes and pages are read for a product hierarchy. If the parameter Product hierarchy is not set, all product hierarchies are read.

SaveData

You use this method to create new material master data or to change existing material master data. The data on a material can betransferred for each call.

When creating material master data, you must transfer the materialnumber, the material type, and the industry sector to the method. You must also enter a material description and its language.

When changing material master data, you need enter only the material number.

In the header data, you must select at least one view for which data isto be created. Depending on the view selected, you must maintain otherrequired parameters. If you do not enter values for all of the required parameters, the method is ended with an error message.

The corresponding fields in the tables (such as CLIENTDATA) must firstbe supplied with data by the calling program. An indicator must also beset for each of these fields so that the data is written to thedatabase by the method. This requires the calling program to supply the
corresponding field with the indicator in a checkbox table (for example, CLIENTDATAX). Checkbox tables exist for tables that do notcontain any language-dependent texts (MAKT, MLTX), InternationalArticle Numbers (MEAN), or tax classifications (MLAN). Several data records for a material can be created in these tables.

If a structure contains fields for units of measurement (such asstructure CLIENTDATA, field BASE_UOM), language indicators (such asstructure MATERIALDESCRIPTION, field LANGU), or country indicators(such as structure TAXCLASSIFICATIONS, field DEPCOUNTRY), there is always a field of the same name with the ending _ISO
. This makes it possible to transfer either the internally used SAP code or astandardized ISO code for the units of measurement, language indicators, or country indicators. ISO codes are converted to an SAPcode internally for further processing. The ISO code is used only if
the SAP code is not transferred. If you use ISO codes, there must be aunique assignment of the ISO code to the SAP code in the following activities in Customizing for Global Parameters:

If you want to maintain long texts (basic data texts, internalcomments, purchase order texts, material memos, or sales texts) orcustomer-defined fields for a material, some special conditions have tobe observed. They are described in the documentation for parameters MATERIALLONGTEXT and EXTENSIONIN.