SAP Excise Tax Management Service

36
PUBLIC 2022-08-05 SAP Excise Tax Management Service © 2022 SAP SE or an SAP affiliate company. All rights reserved. THE BEST RUN

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 val­ues 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 pro­vided.

E13 Tax rate currency codes are different for the BOM compo­nents.

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 cre­ated.

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 as­signed to the purchase order.

Yes Yes Yes

Quantity The quantity for which the pricing is calcu­lated. The quantity here should be speci­fied in the base unit of measure.

Yes Yes Yes

BaseUnitOfMeasure The base unit of meas­ure for the material.

Yes Yes Yes

DocumentPostingDate

The posting date for the document.

Yes Yes Yes

DocumentType Specifies whether the document is a sales or­der, 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 de­scribes whether a cus­tomer issue or return is involved for a sales order, and whether a vendor receipt or re­turn delivery is in­volved 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 sce­nario.

No Yes No

StorageLocation The storage location for which the docu­ment is created.

No No Yes

Code List

Interface fields Sales OrderSales Order Cancellation

Purchase Or­der

Purchase Or­der Cancella­tion

Customer In­voice

Customer In­voice Cancella­tion

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 er­rors.

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

Entity Data Model

SAP Excise Tax Management ServiceRead Master Data PUBLIC 19

Service Metadata URI: <exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/$metadata

Resources

Resource Description Path

Warehouse Contains list of all the ware­houses 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 ware­house addresses

<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseAddress

Warehouse License Details Contains list of all the ware­house license details

<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseLicenseDetail

Warehouse Owner Details Contains list of all the ware­house owner details

<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseOwnerDetail

Warehouse Registration Contains list of all the ware­house registration details

<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseRegistrationDetail

Warehouse Registration 1 Contains list of all the ware­house registration 1 details

<exisetax_api_returned_from_service_keys>/odata/v2/ConfigurationData/WarehouseRegistration1Detail

Warehouse Registration 2 Contains list of all the ware­house 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 lan­guage 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 ex­pired.

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 lan­guage 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 ex­pired.

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 un­der "Service Description"

● Service Overview Topic: First para­graph

Main Feature Scope

Provides services for tax calculation, read master data and EMCS integration.

● Central FSD for SAP BTP: Left col­umn ("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 Calcu­lation

Calculate the excise tax for a material based on the configurations and master data maintained in the SAP Excise Tax Management ap­plication (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 In­tegration

Enable read access to the following tables in the SAP Excise Tax Management application: Business Partner Ship To, Business Part­ner 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 De­scription 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 al­lowed)

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