Description | Determine Shipping Sources of Supplies |
Name | ShippingSourceOfSupplyDeterminationIn |
Namespace | http://sap.com/xi/A1S/Global |
Product | SAP Business ByDesign |
Process component | Customer Requirement Processing |
Process component namespace | http://sap.com/xi/AP/SupplyChainControl/Global |
Deployment unit | Supply Chain Control |
Endpoint Activation | By Scoping of Process Component | Operations |
|
Release Status | Released |
Technical documentation on the SAP API Business Hub | Determine Shipping Sources of Supplies |
General web service documentation | A2X Web Services (SOAP) |
An interface to perform shipping source of supply determination
The ShippingSourceOfSupplyDeterminationIn web service can be used within E-commerce scenarios to enhance E-Shops with delivery information like delivery duration. Furthermore it delivers with the sending location and sending supply planning area the needed input data for other web services such as the ProductAvailabilityDeterminationIn which provides inventory and availability information within the sending location.
The web service ShippingSourceOfSupplyDeterminationIn determines the shipping sources of supply (sending location, sending supply planning area, shipping duration and goods issue duration) for a given seller company, the address (country/region/postal code) of the ship-to location and a list of products.
It considers only internal sources of supply that are sources related to locations which belong to the seller company. External sources related to purchasing contracts of suppliers or related to locations which belong to other companies than the seller company are not considered.
This web service has the operation Determine to determine the shipping sources of supply.
The web service determines the source of supply based on the supply chain design master data, that are transportation zones and transportation lanes. Only if transporation zones and transporation lanes connecting these transporation zones with ship-from sites are maintained, the web-service can return sources of supply.
The input for the web service is a list of valid products with or without a product requirement specification. For each valid product a source of supply is returned, if existing. If no source of supply exists, then an empty entry is returned for this product. If a product is not valid then the web service will return an error message.
As ProductTypeCode only the value 1 (= Material) is allowed, because only for materials the source of supply can be determined.
CountryCode (ShipToPhysicalAdress-CountryCode): Valid values for the country code are defined by the country code list ISO 3166-1
Example: the code value for Germany is DE.
You can find general information about Web services, their structure and consumption in the Web Services documentation. Please open the Web Services document in a new window.
The operation has the following main nodes:
<n0:ShippingSourceOfSupplyDeterminationQuery_sync xmlns:n ="http://sap.com/xi/SAPGlobal20/Global"> <ShippingSourceOfSupplyDeterminationQuery> <SellerCompanyInternalID>MC10000</SellerCompanyInternalID> + <Product> + <ShipToPhysicalAddress> </ShippingSourceOfSupplyDeterminationQuery> </n0:ShippingSourceOfSupplyDeterminationQuery_sync>
Description | Determine shipping sources of supply using selection criteria |
Name | Determine |
Synchronous | yes |
Release Status | Released |
To determine the shipping sources of supply (sending location ID, supply planning area ID, goods issue duration and shipping duration) for a given physical address, seller party ID, seller party type code and a list of product details (product ID and product requirement specification ID).
The operation Determine determines a source of supply based on the seller company, the ship-to address and product data. For each source of supply the following data is returned:
The web service returns one source of supply for each given product. If there exist more than one possible source of supply for a product, then the one with the highest priority is returned. If no source of supply exists then only the product without a source of supply is returned.
The SellerCompanyInteralID specifies the selling company that is the company selling the ordered goods. The web service determines the sources of supply of that company. The service does not support inter-company (or cross-company) sales which mean that the sources of supply the service returns always belong to the selling company.
The Product node defines the product with or without product requirement for which the source of supply is determined.
It consists of the following sub nodes:
The ProductInternalID specifies the product for which the source of supply is determined.
The product is mandatory.
The ProductTypeCode has to be set to 1 (= Material) because currently this web service supports only materials.
The ProductRequirementSpecificationID specifies the product requirement specification for the given product. It is an optional field.
The ProductRequirementSpecificationVersionID specifies the version of the product requirement specification.
The ShipToPhysicalAddress contains the address data for the ship-to location that is the location where goods have to be delivered to. The web service uses the ship-to physical address data to determine transportation zones this address belongs to. Based on the determined transporation zones appropriate transportation lanes are determined. The address data can be initial; in that case the service will use the GLOBAL_TZ as transportation zone reflecting the whole world, if it is defined in the system. If it is not defined, the service delivers no source of supply.
The address data consists of the following elements:
The country code defines the country to which the goods are shipped. Valid values of the country code are defined through country code list ISO 3166-1. It is an optional field.
The region code defines the region of the country, like Baden-Wurttemberg for Germany. It is an optional field.
The street postal code defines the postal code of an address within a country. It is an optional field.
The ShippingSourceOfSupplyDeterminationResponse contains the result of the determine operation.
For each valid entry of the input node Product, one entry of this output node is returned. That means for every product / product requirement specification the source of supply is determined.
It consists of the following sub-nodes:
The node Log contains the error messages which occured during the determine operation.
The following is an example XML file of the request to determine the sources of supply for two different products and a ship-to address in New York, United States:
<n0:ShippingSourceOfSupplyDeterminationQuery_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <ShippingSourceOfSupplyDeterminationQuery> <SellerCompanyInternalID>MC10000</SellerCompanyInternalID> <Product> <ProductInternalID schemeID="" schemeAgencyID="">MCF-0001</ProductInternalID> <ProductTypeCode>1</ProductTypeCode> <ProductRequirementSpecificationID schemeID="" /> <ProductRequirementSpecificationVersionID> /> </Product> <Product> <ProductInternalID schemeID="" schemeAgencyID="">MCF-0036</ProductInternalID> <ProductTypeCode>1</ProductTypeCode> <ProductRequirementSpecificationID schemeID="" /> <ProductRequirementSpecificationVersionID> /> </Product> <ShipToPhysicalAddress> <CountryCode>US</CountryCode> <RegionCode listID="" listVersionID="" listAgencyID="" listAgencySchemeID="" listAgencySchemeAgencyID="">NY</RegionCode> <StreetPostalCode>12205</StreetPostalCode> </ShipToPhysicalAddress> </ShippingSourceOfSupplyDeterminationQuery> </n0:ShippingSourceOfSupplyDeterminationQuery_sync>