Material

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

Structure

In order that data relating to the material can be stored at the
relevant organizational level, a material master record is structured
in accordance with the organizational units plant, plant storage area, warehouse complex, and distribution chain.


Different departments of an enterprise have different views of a material (for example, Materials Planning, Purchasing,
Warehouse Management).

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

Different units of measurement can apply to a material. A conversion
factor allowing conversion into the base unit is defined for each such unit.


A material can have one or more international article numbers (EANs)
for identification purposes, depending on the unit of measurement.


An individual piece of a material can be distinguished from others by a serial number.


Materials made up of several constituent parts can be described with the aid of bills of material (BOMs).


Materials for which a change in requirements has occurred are recorded
in the planning file for the purpose of requirements planning.

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 stocked separately from other subsets of the same material are recorded as a batch.

Integration

A material is classified by means of the parameters "material type" and "industry sector", which define its possible uses.


Material groups can be set up, comprising materials with the same attributes.

Comment

In certain cases, a material can also represent a service.

Available Methods

• Availability : ATP information [ BAPI_MATERIAL_AVAILABILITY ]
  
• Create : Create/extend material [ BAPI_STANDARDMATERIAL_CREATE ] (Obsolete in 46A)
  
• 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_MATERIAL_GETINTNUMBER ] (Obsolete in 46A)
  
• GetList : List with description [ BAPI_MATERIAL_GETLIST ]
  
• GetProductHierarchy : Read product hierarchy [ BAPI_MATERIAL_GET_PRODUCTHIER ]
  

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

No document is available

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

In future, this method will no longer be supported for the object type Material (BUS1001). A method of the same name is available in its place in the object type Standard Material (BUS1001006). For retail materials, the corresponding method in object type Retail Material
(BUS1001001) must still be used.

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.