Fonction SAP BAPI_PRODCAT_GETITEM - Read Individual Product Catalog Item

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
AREA BAPILAYA-AREA N 10 Layout Area Number
CATALOG BAPIADMID-PRODCAT C 10 Product Catalog
ITEM BAPILAYIT-ITEM N 10 Identifier for Layout Area Item
VARIANT BAPIADMVID-VARIANT C 3 Variant
WITHCHILDREN BAPILAYHLP-XFELD C 1 SPACE X Flag for Reading Lower-Level Items
WITHPRICES BAPILAYHLP-XFELD C 1 SPACE X Flag for Reading Prices
WITH_KZKFG BAPILAYHLP-XFELD C 1 SPACE X Indicator for Reading Material Configuration Indicator

Paramètre Reférence Type Long. Description
ITEMDETAIL BAPILAYIT u 182 Layout Area Item
ITEMPRICE BAPIADMIP u 51 Price of Layout Area Item
RETURN BAPIRETURN1 u 470 Return Value

Paramètre Reférence Long. Facultatif Description
CHILDRENDETAILS BAPILAYIT 182 X Lower-Level Layout Area Items
CHILDRENPRICES BAPIADMIP 51 X Prices from Lower-Level Layout Area Items
CHILDRENTEXTS BAPILAYTX 153 X Texts from Lower-Level Layout Area Items
ITEMTEXTS BAPILAYTX 153 Text for Layout Area Item

Functionality
The method provides an item with lower-level items for a productcatalog.

Notes
The variant (parameter VARIANT) defines the language in which the textsin ITEMTEXTS and CHILDRENTEXTS are returned, and with which currencythe prices in ITEMPRICE and CHILDRENPRICES are returned.
If the WITHCHILDREN parameter is set ('X'), the table CHILDRENDETAILSis filled with all lower-level items for the item specified by CATALOG,AREA and ITEM. The item itself is returned in ITEM_DETAIL.
If the WITHPRICES parameter is set ('X'), the structure ITEMPRICE isfilled, and the table CHILDRENPRICES is also filled if WITHCHILDREN isalso set.
The GetPrices method can be used to determine the prices separately.
Messages are returned in the RETURN parameter. The return valued andtheir meanings can be found in the parameter documentation for this.

Description
This structure contains the returned layout area item that wasspecified by CATALOG, AREA and ITEM.
It consists of the following fields:

  • LAYOUT:,,,,Layout of the catalog

  • AREA:,,,,Layout area

  • ITEM

  • MATERIAL

  • UNIT:,,,,Unit of measure

  • SORTNR

  • MATTYPE

  • PARENT

  • UNIT_ISO:,,Unit of measure in ISO format

    • Further function modules can provide additional information onmaterials with special material category characteristics:
    For sales sets, (MATTYPE='10') function module'BAPI_MATERIAL_GETCOMPONENTS' provides all BOM materials and thequantities of these materials in the BOM.
    For variants of a generic material, (MATTYPE='02') function module'BAPI_MATERIAL_GETCHARMERCHHIER' provides characteristics andcharacteristic values.

    Description
    This structure contains the returned price for the layout area itemsspecified by CATALOG, AREA and ITEM. It consists of the followingfields:

    • LAYOUT:,,,,Layout of the product catalog

    • AREA:,,,,Layout area

    • ITEM

    • CURRNCY:,,,,Currency of the price transferred in CONDVAL

    • CONDVAL:,,,,Price for layout area item

    • PRICE_NOT_FOUND

    • CURRNCY_ISO:,,Currency in ISO format of the price transferred in
      • CONDVAL

      Description
      Return values for fields

      Value range
      TYPE = "E" CODE = "W+401" Unknown error
      TYPE = "E" CODE = "W+402" Product catalog does not exist
      TYPE = "E" CODE = "W+403" Variant does not exist
      TYPE = "E" CODE = "W+404" Layout does not exist
      TYPE = "E" CODE = "W+408" Layout area does not exist
      TYPE = "E" CODE = "W+409" Error during price determination
      TYPE = "E" CODE = "W+411" Item does not exist
      TYPE = "E" CODE = "W+544" No authorization to read catalog
      TYPE = "E" CODE = "W+254" No authorization to read layout area
      TYPE = "W" CODE = "W+412" Incorrect parameter: WITHCHILDREN = 'X',
      but CHILDRENDETAILS missing
      TYPE = "W" CODE = "W+413" Incorrect parameter: WITHCHILDREN = 'X',
      but CHILDRENTEXTS missing
      TYPE = "W" CODE = "W+414" Incorrect parameter: WITHPRICES = 'X', but
      CHILDRENPRICES missing
      TYPE = "I" CODE = "W+415" Language key & has no ISO code
      TYPE = "I" CODE = "W+416" Currency key & has no ISO code
      TYPE = "I" CODE = "W+417" Unit of measure & has no ISO code

      Description
      Number of the layout area.

      Description
      For further information, see the data elementdocumentation.

      Description
      For further information see the data elementdocumentation

      Description
      For further information, see the data elementdocumentation

      Description
      If set ('X'), all lower-level items for an item returned in ITEMDETAILare entered in the table CHILDRENDETAILS.

      Description
      If set ('X'), prices for the layout items are transferred to structureITEMPRICE and table CHILDRENPRICES.
      This table contains the returned lower-level layout area items for thelayout area item specified by CATALOG, AREA and ITEM.
      It consists of the following fields:

      • LAYOUT:,,,,Layout of the catalog

      • AREA:,,,,Layout area

      • ITEM

      • MATERIAL

      • UNIT:,,,,Unit of measure

      • SORTNR

      • MATTYPE

      • PARENT

      • UNIT_ISO:,,Unit of measure in ISO format

        • The entries are sorted according to the components AREA and ITEM.
        If the materials are to appear in the same sequence as they wereentered in the "Maintain" transaction, the items within the layout areamust be arranged according to the SORTNR once the method has beencalled.
        For the special material category 'Variant of a generic material'(MATTYPE='02'), additional information such as characteristics andcharacteristic values, can be read using function module'BAPI_MATERIAL_GETCHARMERCHHIER'.

        Description
        This table contains the returned prices for the lower-level layout areaitems for the layout item specified by CATALOG, AREA and ITEM.
        It consists of the following fields:

        • LAYOUT:,,,,Layout of the product catalog

        • AREA:,,,,Layout area

        • ITEM

        • CURRNCY:,,,,Currency of the price transferred in CONDVAL

        • CONDVAL:,,,,Price for layout area item

        • PRICE_NOT_FOUND

        • CURRNCY_ISO:,,Currency in ISO format of the price transferred in
          • CONDVAL
          The records are sorted according to the components AREA, ITEM andCURRNCY.

          Description
          In this table, short texts for the lower-level items for the itemspecified by CATALOG, AREA and ITEM are returned.
          It has the following components:

          • LAYOUT:,,Layout of the product catalog

          • AREA:,,Layout area

          • ITEM

          • LANGU:,,Language in which the texts in NAME and TITLE appear

          • NAME:,,Material short text from R/3

          • TITLE:,,Heading from product catalog maintenance

          • LANGU_ISO:,,Language in ISO format in which the texts in NAME and TITLE
            • appear
            The returned records are sorted according to the components AREA, ITEMand LANGU.

            Description
            In this structure, the short text for the item specified by CATALOG,AREA and ITEM is returned.
            It consists of the following componenets:

            • LAYOUT:,,,,Layout of the product catalog

            • AREA:,,,,Layout area

            • ITEM

            • LANGU:,,,,Language in which the texts in NAME and TITLE appear

            • NAME:,,,,Material short text from R/3

            • TITLE:,,,,Heading from product catalog maintenance

            • LANGU_ISO:,,Language in ISO format in which the texts in NAME and TITLE
              • appear
              The returned records are sorted according to the components AREA, ITEMand LANGU.