Show TOC

 Find Location by ID and TypeCode and Description Locate this document in the navigation structure

 

This inbound service operation is a service operation that searches for and retrieves locations. As search criteria, you can use location IDs, the type code of the location type, or descriptions. Location types include, for example, production plants, shipping points, or distribution centers.

Technical Data

Entity Type

Service Operation

Software Component Version

SAP SCM BASIS 7.02

Release State

released

Technical Name

LocationSimpleByIDAndTypeCodeAndDescriptionQueryResponse_In

Namespace

http://sap.com/xi/SCMBasis/Foundation/Global

Application Component

SCM-BAS-MD-SOA

Web Service Definition (Back End)

/SCMB/LDM_LOC002QR

Direction

inbound

Mode

synchronous

Idempotency

no

Change/Update Behavior

not applicable

P2P Communication Enabled

true

Business Context and Use

You can use this service operation to facilitate location search in a composite application. For example, if the user of a composite application wants to find a location and only remembers the location ID or parts of the description, the user can enter any string, the wildcard *, or a combination of both, to get the required location.

Features

To test the service operation with a minimum scope, you need to fill the SelectionByLocationInternalID, SelectionByLocationTypeCode , or SelectionByLocationDescription elements with a search string and definition parameters for the search interval.

The service operation uses the schemeAgencyID attribute to identify the back-end system in which the location ID is unique. For more information, see the documentation for the Location business object.

If you work with an SAP Supply Chain Management (SAP SCM) system, consider the following:

  • The service operation can only find those locations that are assigned to the active supply chain model in SAP SCM.

  • If you search for locations using the location type code, use the location type codes as they are defined in the /SAPAPO/C_LOCTYPE domain in the SAP SCM system.

Message Types

  • LocationSimpleByIDAndTypeCodeAndDescriptionQuery_sync

  • LocationSimpleByIDAndTypeCodeAndDescriptionResponse_sync

Notes on SAP Implementation

Master Data

You have assigned locations to the active supply chain model.

Customizing

You have set up Customizing for locations under SCM Basis -> Master Data .

Enhancements

The Business Add-In (BAdI) /SCMB/BIF_LDM_LOC002QR is available for this service operation.

Field Mapping

The elements of the message type correspond to the following back-end system fields in SAP SCM:

  • Query message type:

    • SelectionByLocationInternalID : selection table for /SAPAPO/LOCMAP-LOCNO (/SAPAPO/LOCNO) for internal location IDs and /SAPAPO/LOCMAP-EXT_LOCNO (/SAPAPO/LOC_EXTLOCNO) for external location IDs

    • SelectionByLocationTypeCode : selection table for /SAPAPO/LOCMAP-LOCTYPE (/SAPAPO/C_LOCTYPE)

    • SelectionByLocationDescription : selection table for /SAPAPO/LOCT-DESCR40 (/SAPAPO/LOC_DESCR40)

  • Response message type:

    • InternalID : /SAPAPO/LOCMAP-LOCNO (/SAPAPO/LOCNO) or /SAPAPO/LOCMAP-EXT_LOCNO (/SAPAPO/LOC_EXTLOCNO)

    • TypeCode : /SAPAPO/LOCMAP-LOCTYPE (/SAPAPO/C_LOCTYPE)

    • TypeName : belongs to TypeCode , contains short description for code

    • Description : /SAPAPO/LOCT-DESCR40 (/SAPAPO/LOC_DESCR40)