SAP Excise Tax Management Service
-
Upload
khangminh22 -
Category
Documents
-
view
0 -
download
0
Transcript of SAP Excise Tax Management Service
PUBLIC2022-08-05
SAP Excise Tax Management Service
© 2
022
SAP
SE o
r an
SAP affi
liate
com
pany
. All r
ight
s re
serv
ed.
THE BEST RUN
Content
1 What is the Excise Tax Management Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
2 Initial Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42.1 Enabling the SAP Excise Tax Management Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Tax Calculation Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73.1 Error Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.2 Specific Handling for the Bill of Material. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.3 Tax Calculation Service: Inputs and Output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.4 Read Configuration Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4 Read Master Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.1 Metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.2 Warehouse Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Warehouse Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Warehouse Metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5 EMCS Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255.1 Error Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6 Transport Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7 Extend. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277.1 Stock Ledger OData API Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Stock Ledger OData Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Stock Ledger Metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2 PUBLICSAP Excise Tax Management Service
Content
1 What is the Excise Tax Management Service
Perform tasks such as tax calculation, read master data and EMCS integration.
SAP Excise Tax Management Service is a reusable service that provides different service plans which allows you to perform tasks such as excise tax calculation and read access to business partner and material master data.
Environment
This service runs in the Cloud Foundry environment.
Features
Tax Calculation Calculate the excise tax for a material based on the configurations and master data maintained in the SAP Excise Tax Management application (service plan taxcalculation).
Read Master Data Provide read-only access to the following tables: Business Partner Ship To, Business Partner Vendor, Material Master Company, and Material Master Plant (service plan readmasterdata).
EMCS Integration Enable read access to the following tables in the SAP Excise Tax Management application: Business Partner Ship To, Business Partner Vendor, Material Master Company, and Material Master Plant (service plan emcsintegration).
Extend Read, extend, and update excise tax data (service plan extend).
SAP Excise Tax Management ServiceWhat is the Excise Tax Management Service PUBLIC 3
2 Initial Setup
2.1 Enabling the SAP Excise Tax Management Service
To enable excise tax-related services for various integration scenarios, create an instance of the SAP Excise Tax Management Service and create service keys for it. These tasks are performed in the SAP Business Technology Platform cockpit.
Prerequisites
You are entitled to use the SAP Excise Tax Management Service in your subaccount.
● Navigate to Entitlements Subaccount Assignments and select your subaccount from the drop-down list. Select Go.
● If there are no entries maintained for Service SAP Excise Tax Management Service, choose Configure Entitlements Add Service Plans . From the pop-up choose SAP Excise Tax Management Service.
● Select the service plan taxcalculation and choose Add 1 Service Plan.● Save your changes.
Following is a screenshot of the entitlement screen on SAP Business Technology Platform Cockpit.
For more information, see Configure Entitlements and Quotas for Subaccounts.
You have enabled Cloud Foundry by navigating within the SAP Business Technology Platform Cockpit to the overview section of your subaccount. If an organization is displayed in the Cloud Foundry section, you can skip
4 PUBLICSAP Excise Tax Management Service
Initial Setup
this step. If no Cloud Foundry details are displayed, choose the Enable Cloud Foundry button. In the following pop-up, a name for the Cloud Foundry Organization is proposed. Choose Create without changing the proposed name.
Context
SAP Excise Tax Management Service is a reusable service that provides different service plans which allows you to perform tasks such as excise tax calculation and read access to business partner and material master data.
The SAP Excise Tax Management Service provides the following plans:
● taxcalculation: The service plan is for excise tax calculation.● readmasterdata: The service plan offers read access to business partner and material master data.● emcsintegration: The service plan offers read access to business partner and material master data.● transportdata: The service plan provides access to the SAP Cloud Transport Management service to
perform data import.● extend: The service plan lets you read, extend, and update excise tax data.
Procedure
1. Creating a service instance
To use the SAP Excise Tax Management Service APIs of SAP Excise Tax Management, you need to create an instance of the SAP Excise Tax Management Service:
a. In the subaccount in which you are entitled to use the SAP Excise Tax Management Service, choose Spaces in the navigation area.
b. Choose the New Space button and enter an arbitrary name for the space to be created. Retain the selected checkboxes and choose Save. If you do not have a space yet, create one as described in the here: Create Spaces. Open the newly created space in which you want to create a service instance.
c. Choose the menu entry Services Service Marketplace for your space in the SAP Business Technology Platform Cockpit. All available services are displayed here. Click on the Excise-Tax-Service tile. From the left navigation pane, choose Instances New Instance . Choose Next on the pop-up without changing the default selection. Enter an arbitrary instance name. Choose Finish to create the service instance. Detailed instructions to create a service instance is described here: Create Service Instances Using the Cockpit.
NoteYou can skip the steps that are marked as optional in the chapter Create Service Instances Using the Cockpit.
2. Creating Service Keys
To generate the credentials needed to communicate directly with the service instance, you now need to create service keys.
SAP Excise Tax Management ServiceInitial Setup PUBLIC 5
a. Click on the service instance which has been created in the previous step. Choose Service Keys from the left hand navigation pane. Choose Create Service Key. On the pop-up, enter an arbitrary name for the service key and choose Save. Detailed instructions to create the service keys are described here: Create Service Keys Using the Cockpit.
NoteYou can ignore the JSON area when creating the service keys.
After you have created the service keys, you can see the parameters of the keys.
Sample Code
{ "endpoints": { "excisetax_api": }, "sap.cloud.service": "uaa": { "uaadomain": "tenantmode": "sburl": "clientid": "verificationkey": "apiurl": "xsappname": "identityzone": "identityzoneid": "clientsecret": "tenantid": "url": }}
They contain the URL, the clientid, and the clientsecret (all found in the uaa parameter section) that you need to create a token to access the service APIs using OAuth authentication.
The service keys also contain the URL that you use to call the APIs of the service. It is the first excisetax_api parameter, above the uaa parameter section.
3. Creating a JSON Web Token
You must create a JSON Web Token (JWT) to access and use the SAP Excise Tax Management Service APIs. For this, use the credentials from the service key that you created in the previous step and a REST API client tool of your choice (for example, Postman) to create a JWT.
Create a JWT using a POST call to the UAA URL from your service key. The URL has to be adapted to match the following pattern: <url_returned_from_service_keys>/oauth/token. You need to define the following message body in the POST call:
Key Value
client_id <clientid_returned_from_service_keys>client_secret <clientsecret_returned_from_service_keys>grant_type client_credentials
The bearer token for API access is included in the response body.
6 PUBLICSAP Excise Tax Management Service
Initial Setup
3 Tax Calculation Service
The SAP Excise Tax Management Service, service plan taxcalculation can be used to calculate the excise tax for a material based on the configurations and master data maintained in the SAP Excise Tax Management application. This service can be consumed in SAP S/4 HANA during creation of a sales order, purchase order or customer invoice, where the excise tax for a material is shown in the pricing conditions. If the material is not excisable, 0 is returned as the excise tax value.
NoteThe tax returned by the SAP Excise Tax Management Service during sales order and purchase order creation is a statistical tax only. This is because some details, such as the storage location are available for the customer invoice but not for document creation. The actual excise tax calculated during customer invoicing or billing is the official tax billed to the customer.
Once you have set up the service as described in Enabling the SAP Excise Tax Management Service [page 4] (service plan taxcalculation), the URL is generated.
To use the functionality, attach the following to the generated URL :
<exisetax_api_returned_from_service_keys>/odata/v2/TaxCalculationService/ExciseTaxCalculation?CompanyCode=’’&Plant=’’&MaterialNumber=’’&BaseUnitOfMeasure=’’&Quantity=0m&DocumentPostingDate=’’ &IssueOrReceipt=’’&IsReversal=’’&DocumentType=’’&BusinessPartnerNo=’’&StorageLocation=’’&SupplyingPlant=’’
NoteThe <exisetax_api_returned_from_service_keys> is the URL maintained in the field <excisetax_api> for the service key created for the service instance.
3.1 Error Scenarios
The tax calculation service also returns a set of error codes that are business-relevant. These error codes might be due to missing configurations, input validations or technical exceptions.
The list of error codes with the corresponding error description is shown below:
Error Scenarios
Error Code Error Description
E01 BusinessPartnerNo is a mandatory field.
E02 StorageLocation is a mandatory field.
SAP Excise Tax Management ServiceTax Calculation Service PUBLIC 7
Error Code Error Description
E03 DocumentType is a mandatory field and can have only values PO or SO or ICV.
E04 IsReversal is a mandatory field and can be either true or false.
E05 IssueorReceipt is a mandatory field and can have only values I or R.
E06 BaseUnitOfMeasure is a mandatory field.
E07 Quantity is a mandatory field.
E08 MaterialNumber is a mandatory field.
E09 Plant is a mandatory field.
E10 CompanyCode is a mandatory field.
E11 DocumentPostingDate is a mandatory field.
E12 Business Process cannot be determined from the IssueOrReceipt and DocumentType parameters provided.
E13 Tax rate currency codes are different for the BOM components.
E14 The DocumentPostingDate entered is invalid. Enter a value in format yyyy-mm-ddThh:mm:ss.
04 Conversion of quantity to liters is not possible
19 No conversion to settlement unit stored.
49 Settlement unit cannot be converted to tax unit
50 Determination of value unknown for the tax type
51 Tax rate was not found
58 Bill of material configuration not maintained.
59 One or more component(s) of the multipack is available in the rejected document list.
60 Master data of the business partner is not available. Please try to synchronise master data.
NoteThese error codes must be handled on the consumption side.
3.2 Specific Handling for the Bill of Material
In the bill of material, the tax calculated for the header material represents the total for all sub items. If the tax calculation contains an error, see Error Scenarios [page 7] for more information.
8 PUBLICSAP Excise Tax Management Service
Tax Calculation Service
3.3 Tax Calculation Service: Inputs and Output
The following section describes the required input, what is output by the service and indicates the use case for which they are relevant.
Interface Input for the Request
Interface fields Description Sales Order Purchase Order Customer Invoice
MaterialNumber The material for which the document is created.
Yes Yes Yes
CompanyCode The company code for which the document is created.
Yes Yes Yes
Plant The plant for which the document is created.
Yes Yes Yes
BusinessPartnerNo The business partner number for which the document is created. The sales order and customer invoice are assigned the customer number. The supplier number should be assigned to the purchase order.
Yes Yes Yes
Quantity The quantity for which the pricing is calculated. The quantity here should be specified in the base unit of measure.
Yes Yes Yes
BaseUnitOfMeasure The base unit of measure for the material.
Yes Yes Yes
DocumentPostingDate
The posting date for the document.
Yes Yes Yes
DocumentType Specifies whether the document is a sales order, a purchase order or a customer invoice.
Yes Yes Yes
SAP Excise Tax Management ServiceTax Calculation Service PUBLIC 9
Interface fields Description Sales Order Purchase Order Customer Invoice
IssueOrReceipt The business process involved here. It describes whether a customer issue or return is involved for a sales order, and whether a vendor receipt or return delivery is involved for a purchase order.
Yes Yes Yes
IsReversal The business process is a cancellation or a standard scenario.
Yes Yes Yes
SupplyingPlant The supplying plant for a stock transfer scenario.
No Yes No
StorageLocation The storage location for which the document is created.
No No Yes
Code List
Interface fields Sales OrderSales Order Cancellation
Purchase Order
Purchase Order Cancellation
Customer Invoice
Customer Invoice Cancellation
DocumentType SO SO PO PO CIV CIV
IsReversal FALSE TRUE FALSE TRUE FALSE TRUE
IssueOrReceipt
I/R I/R I/R I/R I/R I/R
Outputs
Interface fields Description
TaxValue The excise tax value for the material and business process. Based on the isDutySuspended indicator, tax value is official tax if indicator is false, statistical tax if value is true.
CurrencyCode The currency associated with the customer’s country.
ErrorCode The code associated with any business, technical or input errors.
IsDutySuspended Indicates whether the item is duty paid or duty suspended.
10 PUBLICSAP Excise Tax Management Service
Tax Calculation Service
Interface fields Description
ErrorDescription The description associated with the error codes.
3.4 Read Configuration Data
The Excise Tax Calculation Service, service plan taxcalculation, can be used by partners and customers to access the configuration data for tax rates.
The service is exposed via the odataV2 protocol. Therefore, all the odataV2 protocol operations are supported by it.
The URL needed to access this resource is:
<excisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/TaxRates
The metadata for the entire service is shown below:
Sample Code
<EntityType Name="TaxRates"> <Key> <PropertyRef Name="validFrom"/> <PropertyRef Name="id"/> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="countryCode"/> <PropertyRef Name="baseQuantityUnitOfMeasure"/> </Key> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> <Property Name="id" Type="Edm.Guid" Nullable="false"/> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="countryCode" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="baseQuantityUnitOfMeasure" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="internalBaseQuantityUoM" Type="Edm.String" MaxLength="3"/> <Property Name="alcoholicStrengthFrom" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="degreePlatoFrom" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="alcoholicStrengthTo" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="degreePlatoTo" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxTypeDependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="taxTypeIndependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="partnerType" Type="Edm.String" MaxLength="10"/> <Property Name="orderType" Type="Edm.String" MaxLength="4"/> <Property Name="vendorOrCreditorAccountNumber" Type="Edm.String" MaxLength="10"/>
SAP Excise Tax Management ServiceTax Calculation Service PUBLIC 11
<Property Name="taxTypeCategory" Type="Edm.String" MaxLength="4"/> <Property Name="taxTypeRegion" Type="Edm.String" MaxLength="3"/> <Property Name="taxTypeCity" Type="Edm.String" MaxLength="25"/> <Property Name="taxRate" Type="Edm.Decimal" Precision="13" Scale="7"/> <Property Name="currencyCode" Type="Edm.String" MaxLength="4"/> <Property Name="taxAmountMethod" Type="Edm.String" MaxLength="3"/> <Property Name="isRoundAlcoStrength" Type="Edm.Boolean"/> <Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/> <Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/> </EntityType>
12 PUBLICSAP Excise Tax Management Service
Tax Calculation Service
4 Read Master Data
The Excise Tax Calculation Service, service plan readmasterdata, can be used by partners and customers to access business partner and material master data.
More specifically, anyone who subscribes to this plan can access the following tables on the SAP BTP:
● Business Partner Ship To
<exisetax_api_returned_from_service_keys>/odata/v2/MasterData/BusinessPartnerShipTo
● Business Partner Vendor
<exisetax_api_returned_from_service_keys>/odata/v2/MasterData/BusinessPartnerVendor
● Material Master Company Code
<exisetax_api_returned_from_service_keys>/odata/v2/MasterData/MaterialMasterCompany
● Material Master Plant
<exisetax_api_returned_from_service_keys>/odata/v2/MasterData/MaterialMasterPlant
They have read-only access to the data, and all other operations, such as create, update, delete are disabled.
The above tables are exposed as an oData service, meaning that all read Odata operations are available, such as $count, $filter, $top, etc.
NoteThe <exisetax_api_returned_from_service_keys> is the URL maintained in the field <excisetax_api> for the service key created for the service instance.
For more information, see Enabling the SAP Excise Tax Management Service [page 4].
4.1 Metadata
Metadata for the entire service is shown below:
Sample Code
<EntityType Name="BusinessPartnerShipTo"> <Key> <PropertyRef Name="validFrom"/> <PropertyRef Name="bpNumber"/> <PropertyRef Name="taxTypeID"/> <PropertyRef Name="warehouseRegistration"/>
SAP Excise Tax Management ServiceRead Master Data PUBLIC 13
<PropertyRef Name="companyCode"/> </Key> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> <Property Name="bpNumber" Type="Edm.String" Nullable="false" MaxLength="10"/> <Property Name="taxTypeID" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="companyCode" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="externalTaxTypeWarehouseNo" Type="Edm.String" MaxLength="15"/> <Property Name="externalExciseTaxNumber" Type="Edm.String" MaxLength="15"/> <Property Name="legalDocumentMovementSetting" Type="Edm.String" MaxLength="1"/> <Property Name="warehouseOwnerNo" Type="Edm.String" MaxLength="15"/> <Property Name="registeredConsignee" Type="Edm.String" MaxLength="15"/> <Property Name="countryOfDestination" Type="Edm.String" MaxLength="3"/> <Property Name="country" Type="Edm.String" MaxLength="3"/> <Property Name="isDeliveryToThirdCountry" Type="Edm.Boolean"/> <Property Name="guarantor" Type="Edm.String" MaxLength="10"/> <Property Name="taxAgent" Type="Edm.String" MaxLength="10"/> <Property Name="taxTypeSpecialPartnerType" Type="Edm.String" MaxLength="10"/> <Property Name="vendorOrShipToCountry" Type="Edm.String" MaxLength="3"/> <Property Name="averageTransferTimeInDays" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxedOrUntaxedGoodsPermissionType" Type="Edm.String" MaxLength="1"/> <Property Name="taxTypeDependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="taxTypeIndependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="isEUButOutsideTaxTerritory" Type="Edm.Boolean"/> <Property Name="euCountryIndicator1" Type="Edm.String" MaxLength="3"/> <Property Name="euCountryIndicator2" Type="Edm.String" MaxLength="3"/> <Property Name="emcsSeedFileETProductCode1" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode2" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode3" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode4" Type="Edm.String" MaxLength="4"/> <Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/> <Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/> </EntityType> <EntityType Name="BusinessPartnerVendor"> <Key> <PropertyRef Name="validFrom"/> <PropertyRef Name="bpNumber"/> <PropertyRef Name="taxTypeID"/> <PropertyRef Name="warehouseRegistration"/> <PropertyRef Name="companyCode"/>
14 PUBLICSAP Excise Tax Management Service
Read Master Data
</Key> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> <Property Name="bpNumber" Type="Edm.String" Nullable="false" MaxLength="10"/> <Property Name="taxTypeID" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="companyCode" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="externalTaxTypeWarehouseNo" Type="Edm.String" MaxLength="15"/> <Property Name="externalExciseTaxNumber" Type="Edm.String" MaxLength="15"/> <Property Name="legalDocumentMovementSetting" Type="Edm.String" MaxLength="1"/> <Property Name="warehouseOwnerNo" Type="Edm.String" MaxLength="15"/> <Property Name="registeredConsignee" Type="Edm.String" MaxLength="15"/> <Property Name="countryOfDestination" Type="Edm.String" MaxLength="3"/> <Property Name="country" Type="Edm.String" MaxLength="3"/> <Property Name="isDeliveryToThirdCountry" Type="Edm.Boolean"/> <Property Name="guarantor" Type="Edm.String" MaxLength="10"/> <Property Name="taxAgent" Type="Edm.String" MaxLength="10"/> <Property Name="taxTypeSpecialPartnerType" Type="Edm.String" MaxLength="10"/> <Property Name="vendorOrShipToCountry" Type="Edm.String" MaxLength="3"/> <Property Name="averageTransferTimeInDays" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxedOrUntaxedGoodsPermissionType" Type="Edm.String" MaxLength="1"/> <Property Name="taxTypeDependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="taxTypeIndependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="isEUButOutsideTaxTerritory" Type="Edm.Boolean"/> <Property Name="euCountryIndicator1" Type="Edm.String" MaxLength="3"/> <Property Name="euCountryIndicator2" Type="Edm.String" MaxLength="3"/> <Property Name="emcsSeedFileETProductCode1" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode2" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode3" Type="Edm.String" MaxLength="4"/> <Property Name="emcsSeedFileETProductCode4" Type="Edm.String" MaxLength="4"/> <Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/> <Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/> </EntityType> <EntityType Name="MaterialMasterCompany"> <Key> <PropertyRef Name="validFrom"/> <PropertyRef Name="materialNumber"/> <PropertyRef Name="companyCode"/> </Key> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/>
SAP Excise Tax Management ServiceRead Master Data PUBLIC 15
<Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> <Property Name="materialNumber" Type="Edm.String" Nullable="false" MaxLength="40"/> <Property Name="companyCode" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="description" Type="Edm.String" MaxLength="128"/> <Property Name="alcoholicStrength" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="degreePlato" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxTypeID" Type="Edm.String" MaxLength="3"/> <Property Name="isMaterialTaxed" Type="Edm.Boolean"/> <Property Name="taxWarehouseManufacturingPlant" Type="Edm.String" MaxLength="15"/> <Property Name="taxNumberforWarehouse" Type="Edm.String" MaxLength="15"/> <Property Name="breweryNumberOfManufacturingPlant" Type="Edm.String" MaxLength="20"/> <Property Name="taxTypeProcurementIndicator" Type="Edm.String" MaxLength="1"/> <Property Name="isProducedAbroad" Type="Edm.Boolean"/> <Property Name="taxTypeSpecificProportionQuantity" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="isSpiritsOrDistillates" Type="Edm.Boolean"/> <Property Name="isNonFilledGoods" Type="Edm.Boolean"/> <Property Name="volumeCubicLiters" Type="Edm.Decimal" Precision="20" Scale="5"/> <Property Name="baseUnitOfMeasureCubicLiters" Type="Edm.String" MaxLength="3"/> <Property Name="unitOfMeasureCalculateContainerContents" Type="Edm.String" MaxLength="3"/> <Property Name="isAlternativeConversion" Type="Edm.Boolean"/> <Property Name="additionalChargeMatInEDMatMaster" Type="Edm.String" MaxLength="2"/> <Property Name="supplement1" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="isMaterialMasterPlantMaintained" Type="Edm.Boolean"/> <Property Name="emcsExciseTaxProductCode" Type="Edm.String" MaxLength="4"/> <Property Name="emcsWineGrowingZone" Type="Edm.String" MaxLength="2"/> <Property Name="emcsCategoryOfWineProduct" Type="Edm.String" MaxLength="1"/> <Property Name="emcsWineThirdCountryOrigin" Type="Edm.String" MaxLength="2"/> <Property Name="emcsWineOtherInformation" Type="Edm.String" MaxLength="60"/> <Property Name="emcsWineTreatmentOfProduct" Type="Edm.String" MaxLength="20"/> <Property Name="emcsDensity" Type="Edm.Decimal" Precision="9" Scale="5"/> <Property Name="emcsAddtionalAlcoholicStrength" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="emcsAddtionalDegreePlato" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxTypeIndependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="taxTypeDependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/> <Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/> </EntityType> <EntityType Name="MaterialMasterPlant">
16 PUBLICSAP Excise Tax Management Service
Read Master Data
<Key> <PropertyRef Name="validFrom"/> <PropertyRef Name="materialNumber"/> <PropertyRef Name="plant"/> </Key> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> <Property Name="materialNumber" Type="Edm.String" Nullable="false" MaxLength="40"/> <Property Name="plant" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="taxTypeID" Type="Edm.String" MaxLength="3"/> <Property Name="deviatingAlcoStrength" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="deviatingDegreePlato" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="productionShrinkageRate" Type="Edm.Decimal" Precision="7" Scale="5"/> <Property Name="fillingShrinkageRate" Type="Edm.Decimal" Precision="7" Scale="5"/> <Property Name="retrogradeShrinkageRate" Type="Edm.Decimal" Precision="7" Scale="5"/> <Property Name="emcsExciseTaxProductCode" Type="Edm.String" MaxLength="4"/> <Property Name="emcsWineGrowingZone" Type="Edm.String" MaxLength="2"/> <Property Name="emcsCategoryOfWineProduct" Type="Edm.String" MaxLength="1"/> <Property Name="emcsWineThirdCountryOrigin" Type="Edm.String" MaxLength="2"/> <Property Name="emcsWineOtherInformation" Type="Edm.String" MaxLength="60"/> <Property Name="emcsWineTreatmentOfProduct" Type="Edm.String" MaxLength="20"/> <Property Name="emcsDensity" Type="Edm.Decimal" Precision="9" Scale="5"/> <Property Name="emcsAddtionalAlcoholicStrength" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="emcsAddtionalDegreePlato" Type="Edm.Decimal" Precision="5" Scale="2"/> <Property Name="taxTypeIndependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="taxTypeDependentMatGroup" Type="Edm.String" MaxLength="6"/> <Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/> <Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/> </EntityType>
SAP Excise Tax Management ServiceRead Master Data PUBLIC 17
4.2 Warehouse Details
Warehouse is an excise relevant object and hence all its data is maintained under SAP Excise Tax Management in SAP BTP. This data can only be accessed through the SAP Excise Tax Management UI.
Overview
NoteThere’s a requirement for consuming warehouse data in SAP S/4HANA, hence there’s a need of an OData service through which this data can be consumed.
● During the business process in SAP S/4HANA, the system reads all the warehouse information available on SAP BTP and persists them in SAP S/4HANA. This is required if SAP BTP is down.
● During the business process in SAP S/4HANA, the system contains the plant and storage location information, and it fetches address details for the warehouse to which the plant/storage location has been assigned.
OData Version: 2.0
Root URI:<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/Warehouse
Permissions: readmasterdata
18 PUBLICSAP Excise Tax Management Service
Read Master Data
Service Metadata URI: <exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/$metadata
Resources
Resource Description Path
Warehouse Contains list of all the warehouses maintained
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/Warehouse
Warehouse Assignment Contains list of the plants and storage location assignments to warehouses
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseAssignment
Warehouse Address Details Contains list of all the warehouse addresses
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseAddress
Warehouse License Details Contains list of all the warehouse license details
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseLicenseDetail
Warehouse Owner Details Contains list of all the warehouse owner details
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseOwnerDetail
Warehouse Registration Contains list of all the warehouse registration details
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseRegistrationDetail
Warehouse Registration 1 Contains list of all the warehouse registration 1 details
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseRegistration1Detail
Warehouse Registration 2 Contains list of all the warehouse registration 2 details
<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseRegistration2Detail
4.2.1 Warehouse Resource
Resource information for warehouse details OData service.
Resource Path:<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/Warehouse
Permissions: readmasterdata
20 PUBLICSAP Excise Tax Management Service
Read Master Data
Operations
CRUD Operations
HTTP Method Operation URI
GET GET <exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/Warehouse
Common Headers
Common Request Headers
Header Required Description
sap-language Yes The language in which response is expected for language-dependent fields. This should be equal to the required language code like sap-language=de.
Common Status and Error Codes
Code Reason
200 The requested data has been returned in the response.
401/403 Authentication/Authorization error, either the token passed in request is incorrect or has expired.
500 Internal server error due to an incorrect permission on one or more files or folders..
Related Information
Warehouse Details [page 18]
4.2.2 Warehouse Metadata
Metadata for Warehouse Details API service.
Sample Code
<EntityType Name="Warehouse"> <Key><PropertyRef Name="taxTypeId"/><PropertyRef Name="warehouseRegistration"/><PropertyRef Name="validFrom"/></Key><Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/>
SAP Excise Tax Management ServiceRead Master Data PUBLIC 21
<Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/><Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/><Property Name="description" Type="Edm.String" MaxLength="128"/><Property Name="companyCode" Type="Edm.String" MaxLength="4"/><Property Name="createdAt" Type="Edm.DateTimeOffset" Precision="7"/><Property Name="modifiedAt" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/><Property Name="warehouseOwnerNo" Type="Edm.String" MaxLength="15"/><Property Name="warehouseLicenseNo" Type="Edm.String" MaxLength="15"/><Property Name="warehouseRegistrationNo" Type="Edm.String" MaxLength="16"/><Property Name="warehouseRegistration1No" Type="Edm.String" MaxLength="16"/><Property Name="warehouseRegistration2No" Type="Edm.String" MaxLength="16"/><NavigationProperty Name="to_WarehouseAddress" Relationship="ConfigurationData.Warehouse_to_WarehouseAddress" FromRole="Warehouse" ToRole="WarehouseAddress"/><NavigationProperty Name="to_WarehouseOwnerDetail" Relationship="ConfigurationData.Warehouse_to_WarehouseOwnerDetail" FromRole="Warehouse" ToRole="WarehouseOwnerDetail"/><NavigationProperty Name="to_WarehouseLicenseDetail" Relationship="ConfigurationData.Warehouse_to_WarehouseLicenseDetail" FromRole="Warehouse" ToRole="WarehouseLicenseDetail"/><NavigationProperty Name="to_WarehouseRegistrationDetail" Relationship="ConfigurationData.Warehouse_to_WarehouseRegistrationDetail" FromRole="Warehouse" ToRole="WarehouseRegistrationDetail"/><NavigationProperty Name="to_WarehouseRegistration1Detail" Relationship="ConfigurationData.Warehouse_to_WarehouseRegistration1Detail" FromRole="Warehouse" ToRole="WarehouseRegistration1Detail"/><NavigationProperty Name="to_WarehouseRegistration2Detail" Relationship="ConfigurationData.Warehouse_to_WarehouseRegistration2Detail" FromRole="Warehouse" ToRole="WarehouseRegistration2Detail"/><NavigationProperty Name="to_WarehouseAssignment" Relationship="ConfigurationData.Warehouse_to_WarehouseAssignment" FromRole="Warehouse" ToRole="WarehouseAssignment"/></EntityType> <EntityType Name="WarehouseAddress"> <Key> <PropertyRef Name="id"/> </Key> <Property Name="id" Type="Edm.Guid" Nullable="false"/> <Property Name="taxTypeId" Type="Edm.String" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" MaxLength="15"/> <Property Name="addressNo" Type="Edm.Guid"/> <Property Name="isDeleted" Type="Edm.Boolean"/> <Property Name="addressType" Type="Edm.String" MaxLength="128"/> <Property Name="title" Type="Edm.String" MaxLength="30"/> <Property Name="name1" Type="Edm.String" MaxLength="40"/> <Property Name="name2" Type="Edm.String" MaxLength="40"/> <Property Name="searchTerm1" Type="Edm.String" MaxLength="20"/> <Property Name="searchTerm2" Type="Edm.String" MaxLength="20"/> <Property Name="street" Type="Edm.String" MaxLength="64"/> <Property Name="houseNo" Type="Edm.String" MaxLength="10"/> <Property Name="addressPostalCode" Type="Edm.String" MaxLength="15"/> <Property Name="city" Type="Edm.String" MaxLength="40"/> <Property Name="countryCode" Type="Edm.String" MaxLength="3"/> <Property Name="region" Type="Edm.String" MaxLength="3"/> <Property Name="timeZone" Type="Edm.String" MaxLength="6"/> <Property Name="poBox" Type="Edm.String" MaxLength="15"/> <Property Name="poBoxPostalCode" Type="Edm.String" MaxLength="15"/> <Property Name="companyPostalCode" Type="Edm.String" MaxLength="15"/> <Property Name="defaultCommunicationMethod" Type="Edm.String" MaxLength="3"/> <Property Name="addressLine1" Type="Edm.String" MaxLength="40"/> <Property Name="addressLine2" Type="Edm.String" MaxLength="40"/> <Property Name="addressDescription" Type="Edm.String" MaxLength="128"/> <Property Name="phoneNo" Type="Edm.String" MaxLength="30"/> <Property Name="faxNo" Type="Edm.String" MaxLength="30"/>
22 PUBLICSAP Excise Tax Management Service
Read Master Data
<Property Name="mobileNo" Type="Edm.String" MaxLength="30"/> <Property Name="emailId" Type="Edm.String" MaxLength="241"/> </EntityType> <EntityType Name="WarehouseAddressType"> <Key> <PropertyRef Name="addressType"/> </Key> <Property Name="addressType" Type="Edm.String" Nullable="false" MaxLength="1"/> <Property Name="description" Type="Edm.String" MaxLength="128"/> <NavigationProperty Name="texts" Relationship="ConfigurationData.WarehouseAddressType_texts_1" FromRole="WarehouseAddressType" ToRole="WarehouseAddressType_texts"/> <NavigationProperty Name="localized" Relationship="ConfigurationData.WarehouseAddressType_localized" FromRole="WarehouseAddressType" ToRole="WarehouseAddressType_texts"/> </EntityType> <EntityType Name="WarehouseAddressType_texts"> <Key> <PropertyRef Name="locale"/> <PropertyRef Name="addressType"/> </Key> <Property Name="locale" Type="Edm.String" Nullable="false" MaxLength="14"/> <Property Name="addressType" Type="Edm.String" Nullable="false" MaxLength="1"/> <Property Name="description" Type="Edm.String" MaxLength="128"/> </EntityType> <EntityType Name="WarehouseAssignment"> <Key> <PropertyRef Name="plant"/> <PropertyRef Name="storageLocation"/> <PropertyRef Name="taxTypeId"/> </Key> <Property Name="plant" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="storageLocation" Type="Edm.String" Nullable="false" MaxLength="4"/> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" MaxLength="15"/> <Property Name="plantWarehouseNo" Type="Edm.String" MaxLength="15"/> </EntityType> <EntityType Name="WarehouseLicenseDetail"> <Key> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="warehouseLicenseNo"/> <PropertyRef Name="validFrom"/> </Key> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseLicenseNo" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> </EntityType> <EntityType Name="WarehouseOwnerDetail"> <Key> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="warehouseRegistration"/> <PropertyRef Name="validFrom"/> </Key> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="warehouseOwnerNo" Type="Edm.String" MaxLength="15"/>
SAP Excise Tax Management ServiceRead Master Data PUBLIC 23
<Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> </EntityType> <EntityType Name="WarehouseRegistration1Detail"> <Key> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="warehouseRegistration"/> <PropertyRef Name="validFrom"/> </Key> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="warehouseRegistration1No" Type="Edm.String" MaxLength="16"/> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> </EntityType> <EntityType Name="WarehouseRegistration2Detail"> <Key> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="warehouseRegistration"/> <PropertyRef Name="validFrom"/> </Key> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="warehouseRegistration2No" Type="Edm.String" MaxLength="16"/> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> </EntityType> <EntityType Name="WarehouseRegistrationDetail"> <Key> <PropertyRef Name="taxTypeId"/> <PropertyRef Name="warehouseRegistration"/> <PropertyRef Name="validFrom"/> </Key> <Property Name="taxTypeId" Type="Edm.String" Nullable="false" MaxLength="3"/> <Property Name="warehouseRegistration" Type="Edm.String" Nullable="false" MaxLength="15"/> <Property Name="warehouseRegistrationNo" Type="Edm.String" MaxLength="16"/> <Property Name="validFrom" Type="Edm.DateTime" Nullable="false" sap:display-format="Date"/> <Property Name="validTo" Type="Edm.DateTime" sap:display-format="Date"/> </EntityType>
24 PUBLICSAP Excise Tax Management Service
Read Master Data
5 EMCS Integration
Customers and partners can use the EMCS integration (emcsintegration) plan to get read-only access to the following tables:
● Business Partner Ship To● Business Partner Vendor● Material Master Company Code● Material Master Plant
For more details about these tables, please see the Read Master Data [page 13] plan.
5.1 Error Scenarios
The service endpoint is a standard odataV2 endpoint. This means that all standard errors and endpoints that are supported by odata apply here.
SAP Excise Tax Management ServiceEMCS Integration PUBLIC 25
6 Transport Data
The Excise Tax Calculation Service, service plan transportdata, allows SAP Cloud Transport Management to integrate with the Excise Tax Calculation Service to perform data import.
NoteThe <exisetax_api_returned_from_service_keys> is the URL maintained in the field <excisetax_api> for the service key created for the service instance.
For more information, see Enabling the SAP Excise Tax Management Service [page 4].
26 PUBLICSAP Excise Tax Management Service
Transport Data
7 Extend
This service plans allows you to read, extend, and update excise tax related products.
7.1 Stock Ledger OData API Service
Stock Ledger is an excise relevant object and hence all its data is maintained under SAP Excise Tax Management in SAP BTP. This data can only be accessed through the SAP Excise Tax Management UI.
Overview
There’s a requirement for consuming stock ledger data in SAP S/4HANA, hence there’s a need of an OData service through which this data can be consumed. Stock Ledger OData API supports custom fields.
OData Version: 2.0
Root URI:<excisetaxdata_api_returned_from_service_keys>/odata/v2/ExciseTaxData/ExciseTaxDocument
Permissions: Credentials from service instance of the Extend plan
SAP Excise Tax Management ServiceExtend PUBLIC 27
Entity Data Model
Service Metadata URI: <excisetaxdata_api_returned_from_service_keys>/odata/v2/ExciseTaxData/$metadata
Resources
Resource Description Path
ExciseTaxDocument Contains list of all the stock ledger documents
<excisetaxdata_api_returned_from_service_keys>/odata/v2/ExciseTaxData/ExciseTaxDocument
28 PUBLICSAP Excise Tax Management Service
Extend
7.1.1 Stock Ledger OData Resources
Resource information for stock ledger details OData service.
Operations
CRUD Operations
HTTP Method Operation URI
GET [Link to the operation topic] <excisetaxdata_api_returned_from_service_keys>/odata/v2/ExciseTaxData/ExciseTaxDocument
Common Headers
Common Request Headers
Header Required Description
sap-language Yes The language in which response is expected for language-dependent fields. This should be equal to the required language code like sap-language=de.
Common Status and Error Codes
Code Reason
200 The requested data has been returned in the response
401/403 Authentication/Authorization error, either the token passed in request is incorrect or has expired.
500 Internal server error due to an incorrect permission on one or more files or folders.
Related Information
Stock Ledger OData API Service [page 27]
SAP Excise Tax Management ServiceExtend PUBLIC 29
7.1.2 Stock Ledger Metadata
Metadata for Stock Ledger API service.
Sample Code
<EntityType Name="ExciseTaxDocument"> <Key><PropertyRef Name="taxTypeId"/><PropertyRef Name="materialDocumentYear"/><PropertyRef Name="materialDocument"/><PropertyRef Name="materialDocumentItem"/><PropertyRef Name="materialDocumentSubItem"/></Key><Property Name="taxTypeId" Type="Edm.String" MaxLength="3" Nullable="false"/><Property Name="plant" Type="Edm.String" MaxLength="4"/><Property Name="storageLocation" Type="Edm.String" MaxLength="4"/><Property Name="unitOfMeasure" Type="Edm.String" MaxLength="3"/><Property Name="movementType" Type="Edm.String" MaxLength="3"/><Property Name="stockLedgerGroup" Type="Edm.String" MaxLength="5"/><Property Name="stockLedgerDivision" Type="Edm.String" MaxLength="2"/><Property Name="stockLedgerSubdivision" Type="Edm.String" MaxLength="2"/><Property Name="commodityCode" Type="Edm.String" MaxLength="30"/><Property Name="debitCreditIndicator" Type="Edm.String" MaxLength="1"/><Property Name="materialDocumentYear" Type="Edm.Int32" Nullable="false"/><Property Name="materialDocument" Type="Edm.String" MaxLength="10" Nullable="false"/><Property Name="materialDocumentItem" Type="Edm.Int32" Nullable="false"/><Property Name="materialDocumentSubItem" Type="Edm.Int32" Nullable="false"/><Property Name="materialNumber" Type="Edm.String" MaxLength="40"/><Property Name="materialDescription" Type="Edm.String" MaxLength="128"/><Property Name="lastModificationDateTimeStamp" Type="Edm.DateTimeOffset" Precision="7" ConcurrencyMode="Fixed"/><Property Name="postingDate" Type="Edm.DateTime" sap:display-format="Date"/><Property Name="movementReason" Type="Edm.String" MaxLength="4"/><Property Name="quantityInBaseUnit" Type="Edm.Decimal" Scale="5" Precision="20"/><Property Name="settlementQuantityInExciseTax" Type="Edm.Decimal" Scale="5" Precision="20"/><Property Name="settlementUnit" Type="Edm.String" MaxLength="3"/><Property Name="batch" Type="Edm.String" MaxLength="10"/><Property Name="alcoholicStrength" Type="Edm.Decimal" Scale="2" Precision="5"/><Property Name="isManualDocument" Type="Edm.Boolean"/><Property Name="stockLedgerGroupDescription" Type="Edm.String" MaxLength="128"/><Property Name="stockLedger" Type="Edm.String" MaxLength="1"/><Property Name="stockLedgerDescription" Type="Edm.String" MaxLength="128"/><Property Name="stockLedgerDivisionDescription" Type="Edm.String" MaxLength="128"/><Property Name="stockLedgerSubdivisionDescription" Type="Edm.String" MaxLength="256"/><Property Name="isNonFilledGoods" Type="Edm.Boolean"/><Property Name="materialType" Type="Edm.String" MaxLength="10"/></EntityType>
NoteThe application doesn't translate manually created stock ledger descriptions for the Stock Ledger Group application. It displays the user-created description by default for all language-specific requests.
30 PUBLICSAP Excise Tax Management Service
Extend
8 REFCONT: Data sheet for SAP Excise Tax Service
General Information
Entry Column Where Used
Long Name Approved by Brand Voice
SAP Excise Tax Management Service
● Marketplace: Link under "Technical components" on product page
● Marketplace: Title of technical component page
Short Name Approved by Brand Voice
Excise Tax Management Service
● Cockpit: Tile name● Cockpit: Title of service overview
page● Service Overview Topic: Title
Short Description
Perform tasks such as tax calculation, read master data and EMCS integration.
● Marketplace: Technical component page
● Cockpit: Tile text● Service Overview Topic: Short de
scription
Long Description
SAP Excise Tax Management Service is a reusable service that provides different service plans which allows you to perform tasks such as excise tax calculation and read access to business partner and material master data.
● Marketplace: Technical component page under "More Information" page
● Cockpit: Service overview page under "Service Description"
● Service Overview Topic: First paragraph
Main Feature Scope
Provides services for tax calculation, read master data and EMCS integration.
● Central FSD for SAP BTP: Left column ("Feature")
SAP Excise Tax Management ServiceREFCONT: Data sheet for SAP Excise Tax Service PUBLIC 31
Entry Column Where Used
Feature Details: Titles and Descriptions
Tax Calculation
Calculate the excise tax for a material based on the configurations and master data maintained in the SAP Excise Tax Management application (service plan taxcalculation).
Read Master Data
Provide read-only access to the following tables: Business Partner Ship To, Business Partner Vendor, Material Master Company, and Material Master Plant (service plan readmasterdata).
EMCS Integration
Enable read access to the following tables in the SAP Excise Tax Management application: Business Partner Ship To, Business Partner Vendor, Material Master Company, and Material Master Plant (service plan emcsintegration).
Extend Read, extend, and update excise tax data (service plan extend).
● Marketplace: Technical component page
● Service Overview Topic: Features● Central FSD for SAP BTP: Right
column ("Description")
Resources (Link List)
Entry Column Guidelines and Explanations
Product Page on SAP Help Portal
Help Portal Product Page
Service Overview topic in service guide
What is Excise Tax Service
Service-specific Feature Scope Description in PDF format
Feature Scope Description
What's New topic in service guide
What's New
Initial Setup topic in service guide
Initial Setup
API documentation in service guide
Other Documentation
●
32 PUBLICSAP Excise Tax Management Service
REFCONT: Data sheet for SAP Excise Tax Service
Entry Column Guidelines and Explanations
Onboarding Documentation
Onboarding
Onboarding Tutorial
Tutorial
●
Learning Content
●
Community Content
●
Support Content
●
SAP Excise Tax Management ServiceREFCONT: Data sheet for SAP Excise Tax Service PUBLIC 33
Media
Entry Column Guidelines and Explanations
Images
●
Integration Within Logistics Chain
●
Seamless Integration
●
Tax Relevant Business Transactions
●
Typical Excise Tax Challenges
Videos (only YouTube videos are allowed)
●
34 PUBLICSAP Excise Tax Management Service
REFCONT: Data sheet for SAP Excise Tax Service
Important Disclaimers and Legal Information
HyperlinksSome links are classified by an icon and/or a mouseover text. These links provide additional information.About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.
Videos Hosted on External PlatformsSome videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the control or responsibility of SAP.
Beta and Other Experimental FeaturesExperimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the experimental features in a live operating environment or with data that has not been sufficiently backed up.The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.
Example CodeAny software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free LanguageSAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities, genders, and abilities.
SAP Excise Tax Management ServiceImportant Disclaimers and Legal Information PUBLIC 35
www.sap.com/contactsap
© 2022 SAP SE or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.
Please see https://www.sap.com/about/legal/trademark.html for additional trademark information and notices.
THE BEST RUN