Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
Einführung

Introduction

appero quote bietet Ihnen verschiedene Möglichkeiten, die Mehrwertsteuer Ihres Angebots auszuweisen, als Prozentwert an der einzelnen Angebotsposition oder als ausgewiesene Beträge in den Elementen Mehrwertsteuer oder Bruttosumme. Doch zunächst gilt es, den korrekten Steuersatz je Angebotsposition zu bestimmen. Hierzu bietet appero quote verschiedene Möglichkeiten je nach Komplexität Ihrer Konfiguration.

Bestimmung des korrekten Steuersatzes

Globaler einheitlicher Steuersatz

Die einfachste Möglichkeit, den Steuersatz für Ihre Angebote zu bestimmen ist über die gleichnamige Einstellung (“Mehrwertsteuersatz”, Name des Setup-Textes “standardvat”) im Abschnitt Funktionalität. Über diesen Parameter können Sie den Standard Steuersatz Ihres Unternehmens definieren. Dieser Steuersatz greift immer dann, wenn an der Opportunity bzw. dem Account kein Steuersatz hinterlegt ist und auch keine aktiven Steuerregeln im Angebot greifen.

Steuersatz je Account oder Opportunity

Neben dem Standardsteuersatz, z.B. 19% in Deutschland, kann es sein, dass Sie bei internationalen Geschäften weitere Steuersätze benötigen, z.B. für einen Partner in Österreich einen MwSt-Satz von 20%. Sie haben zwei Möglichkeiten, dies zu definieren - über den Account oder über die Opportunity:

Objekt

Feldname

offers you different ways to display the VAT of your quote, as a percentage value at the individual Quote Line Item or as displayed amounts in the VAT or Gross Total items. But first you need to determine the correct tax rate for each Quote Line Item. For this, appero quote offers various options depending on the complexity of your configuration.

Determination of the correct tax rate

Global uniform tax rate

The easiest way to define the tax rate for your quotes is through the Setting > Functionality ("Standard VAT", name of the setup text "standardvat"). This parameter allows you to define the default tax rate for your company. This tax rate will always apply if no tax rate is defined for the opportunity or account and no active tax rules apply to the quote.

Tax rate per Account or Opportunity

In addition to the standard tax rate, e.g. 19% in Germany, you may need additional tax rates for international business, e.g. a VAT rate of 20% for a partner in Austria. You have two ways to define this - via the Account or via the Opportunity:

Object

Fieldname

Label

Account

sf42_quotefx__SF42_Tax__c

MwSt.

VAT (Standard)

Opportunity

sf42_quotefx__SF42_Tax_Opp__c

MwSt.

Die Priorisierung ist folgende:
Sofern ein eigener Steuersatz an der Opportunity vorliegt, wird der Steuersatz am Account ignoriert. Sofern ein Steuersatz am Account vorliegt, wird der globale Steuersatz in den Einstellungen ignoriert.

Steuersatz über Regelwerk

Die bisherigen Optionen erlauben nur einen einheitlichen Steuersatz je Angebot. Es gibt jedoch Fälle, in denen das nicht ausreichend ist, z.B. wenn Sie Produkte zum normalen und ermäßigten Steuersatz gleichzeitig anbieten möchten.

Hier bietet die Systematik aus den drei Objekten Steuerschlüssel, Steuersatz, und Steuerregel größtmögliche Flexibilität:

Objekt

API-Name

Erklärung

Steuerschlüssel

VAT

The prioritization is as follows:
If there is an own tax rate at the opportunity, the tax rate at the account will be ignored. If there is a tax rate on the account, the global tax rate in the settings will be ignored.

Tax rate via rulebook

The previous options only allow a single tax rate per quote. However, there are cases where this is not sufficient, e.g. if you want to offer products at the normal and reduced tax rate at the same time.

Here, the system of three objects - Tax Key, Tax Rate, and Tax Rule - offers the greatest possible flexibility:

Object

API-Name

Explanation

Tax Key

sf42_quotefx__SF42_TaxKey__c

Der Steuerschlüssel ist ein Kennzeichen, dass Sie am Account über das gleichnamige Lookup-Feld

The Tax Key is an indicator that you store on the account using the lookup field of the same name, sf42_quotefx__SF42_TaxKey__c

hinterlegen

.

Steuersatz

Tax Rate

sf42_quotefx__SF42_TaxRate__c

Im Steuersatz legen Sie den Prozentwert fest, zu dem die MwSt. berechnet werden soll.

SteuerregelFeld

In the Tax Rate you specify the percentage value at which the VAT is to be calculated.

Tax Rule

sf42_quotefx__SF42_TaxRule__c

Hier können Sie definieren, für welches Produkt bzw. welche Produktgruppe in Kombination mit einem bestimmten Steuerschlüssel ein bestimmter MwSt.-Satz ermittelt werden soll.

An der Steuerregel fließen Steuerschlüssel und -Satz zusammen:

Image Removed

Here you can define for which product or product group in combination with a certain Tax Key a certain VAT rate should be determined.

The Tax Key and Tax Rate merge at the Tax Rule:

Image Added

Field

API-Name

Funktion

Function

Image Removed
Image Added

Name

Tax Rule Name

der Steuerregel

Image Removed
Image Added

sf42_quotefx__SF42_ProductGroup__c

Nachschlagen

Lookup(

Produktgruppe)

Auf diese Produktgruppe bezieht sich die Regel. Hierbei wird nur die primäre Produktgruppe eines Produkts berücksichtigt, die sekundäre wird ignoriert.

Image Removed

Product Group)

The rule refers to this product group. Here, only the primary product group of a product is considered, the secondary one is ignored.

Image Added

sf42_quotefx__SF42_ProductGroup2__c

Lookup(Product Group)

The Secondary Product Group refers to the secondary product group of a product.

Note

Primary and secondary product group can be used individually or in combination on one rule.

Image Added

sf42_quotefx__SF42_Product__c

Nachschlagen

Lookup(

ProduktImage Removed

Product)

Alternativ zur Produktgruppe, kann sich eine Steuerregel auch auf ein einzelnes Produkt beziehen

As an alternative to the product group, a tax rule can also refer to a single product

Image Added

sf42_quotefx__SF42_Tax__c

Gibt den Steuerwert in % aus dem zugehörigen Steuersatz wieder

Image Removed

Returns the tax value in % from the associated tax rate

Image Added

sf42_quotefx__SF42_TaxRate__c

Master-Detail(

Steuersatz

Tax Rate)

Relation

zum Objekt SteuersatzImage Removed

to the object Tax Rate

Image Added

sf42_quotefx__SF42_TaxKey__c

Master-Detail(

Steuerschlüssel

Tax key)

Relation

zum Objekt Steuerschlüssel

Zu einem Steuerschlüssel können beliebig viele verschiedene Steuerregeln hinterlegt sein. Produkte und Produktgruppen können verschiedenen Regeln und somit wiederum Steuersätzen zugeordnet sein. Alles fließt am Account zusammen, über dessen dort hinterlegten Steuerschlüssel die zugehörigen Regeln abgefragt werden.

Verhalten im Angebotseditor bei Unklarheiten:

  • Unvollständig konfigurierte Steuerregeln werden im Angebotseditor mit Steuerwert 0% ausgegeben.

  • Bei doppelten Regeln wird nach dem Zufallsprinzip die zuerst gefundene verwendet.

  • Bei konkurrierenden Regeln auf Produkt und auf Produktgruppe gilt: Die Regel für das Produkt wird verwendet.

  • Globale Regeln ohne Produkt(gruppen)-Zuordnung werden ignoriert.

Note

Beide Methoden - Steuersatz über Regeln und Steuersatz aus Opportunity/Account/Setup - können gleichzeitig in einem Angebot verwendet werden, da der Steuersatz jeweils pro Angebotsposition ermittelt wird.

Die Priorisierung bei der Abfrage der Mehrwertsteuer im Angebotsprozess ist folgende:
Sofern zu einer Angebotsposition eine gültige Regel gefunden wird, wird diese zur Ermittlung der MwSt. herangezogen. Wenn keine Regel gefunden wird, wird auf den MwSt.-Satz an der Opportunity zurückgegriffen, falls an dieser Stelle nichts hinterlegt ist, greift der MwSt-Satz am Account. Erst, wenn für eine Position keine dieser Optionen nicht gegeben ist, wird auf den Setup-Parameter standardvat zurückgegriffen.

Die Mehrwertsteuer im Angebotseditor

Im appero quote Lightning Editor stehen Ihnen grundsätzlich drei verschiedene Möglichkeiten zur Verfügung, die Steuer auszuweisen:

Image Removed

Angebotselement

Bezeichnung

Funktion

Beispiel

Image Removed

Spalte MwSt.

Die MwSt. Spalte blendet den Steuersatz in % an der Angebotsposition ein.

Image Removed

Image Removed

Angebotselement ‘MwSt.’

Das Angebotselement Mehrwertsteuer gibt die im Angebot enthaltene MwSt. als Betrag aus, unterteilt nach den beteiligten Steuersätzen.

Image Removed

Image RemovedImage Removed

Angebotselemente ‘Gruppensumme brutto’ und ‘Summe brutto’

Über die Bruttosummenelemente können Sie die Gesamtbruttosummen Ihres Angebots ausweisen, d.h. Nettosumme plus MwSt.-Betrag.

Der ermittelte Betrag bezieht sich immer auf das gesamte Angebot, unabhängig von der Positionierung im Angebot.

Über die Filterung nach Produktsummen können Sie das Angebot weiter eingrenzen.

Image RemovedImage Removed

Die Mehrwertsteuer am Opportunity-Produkt

Bitte beachten Sie, dass wenn Sie Ihre Produkte initial an der Opportunity erstellen und anschließend in den Angebotseditor übernehmen, die Mehrwertsteuer und zugehörige Summenelemente nicht korrekt berechnet werden können. (Im Falle von Setup-Text CopyOppItemsNull = false, da hier keine Neuberechnung der Produkte angestossen wird.)

NoteMöchten Sie diesen Weg nutzen, legen Sie bitte einen einfachen Prozess am Opportunity-Produkt an, der den Wert des Standardfeldes ‘Verkaufspreis’ - UnitPrice auf die appero quote-Felder ‘Einkaufspreis Partner’

to the Tax Key object

Any number of different Tax Rules can be stored for a Tax Key. Products and product groups can be assigned to different rules and thus to different Tax Rates. Everything flows together at the account, via whose tax key stored there the associated rules are queried.

Behavior in the Quote Editor in case of ambiguity:

  • Incompletely configured tax rules are output in the quote editor with tax value 0%.

  • In case of duplicate rules, the first one found is used randomly.

  • In case of competing rules on product and on product group, the rule for the product is used.

  • In case of competing rules on product groups, the most precise rule is used, i.e. two matching product groups trumps one matching product group, primary trumps secondary product group.

  • If both product and product group are stored in a rule, the product group is ignored.

  • Global rules without product (group) assignment are ignored.

Note

Both methods - tax rate via rules and tax rate from Opportunity/Account/Setup - can be used simultaneously in a quote, as the tax rate is determined per Quote Line Item in each case.

Prioritization of VAT query in quoting process is as follows:
If a valid rule is found for a Quote Line Item, it is used to determine VAT. If no rule is found, the VAT rate at the opportunity is used. If no rule is found, the VAT rate at the account is used. Only if none of these options is not given for an item, the setup parameter standardvat will be used.

The value added tax in the quote editor

In appero quote Lightning Editor, you basically have three different ways to display the tax:

Image Added

Quote Item

Description

Function

Example

Image Added

Column “Tax”

The VAT. column displays the tax rate in % on the Quote Line Item.

Image Added
Image Added

Quote Item “VAT”

The VAT quote item outputs the VAT included in the quote as an amount, subdivided by the tax rates involved.

Image Added

Image Added

Quote Item “Group Total Gross” and “Total Gross”

The Total Gross items allow you to display the total gross amount of your quote, i.e. the net amount plus the VAT amount.

The calculated amount always refers to the entire quote, regardless of the positioning in the quote.

By filtering by product totals, you can further narrow down the quote.

Image Added

Editability of the tax rate in the quote

By default, the tax rate is not editable by the user. Using the new changeTax parameter, you can make the VAT column in the quote editable. The adjusted values are then applied simultaneously to the calculation of the gross totals and the total tax amount. A possible use case is international use in a country whose tax rates cannot be mapped according to uniform rules.

Note

If required, create a setup text of type parameter named "changeTax" and enter the value "true" in the field sf42_quotefx__SF42_QuoSetup_Longtext__c. The setting will then apply globally in your Salesforce instance for each quote.

The value added tax on the opportunity product

Please note that if you create your products initially on the opportunity and then copy them to the quote editor, the VAT and related sum items cannot be calculated correctly. (In case of setup text CopyOppItemsNull = false, because here no recalculation of the products is triggered).

Note

If you would like to use this way, please create a simple process on the opportunity product that writes the value of the default 'Sales Price' - UnitPrice field to the appero quote fields 'Buy Price Partner' -sf42_quotefx__SF42_Buy_Price_Partner__c und ‘Einkaufspreis Distributor’ and 'Buy Price Distributor' - sf42_quotefx__SF42_Buy_Price_Dist__c schreibt.

Diese beiden Werte sind als niedrigste Einzelpreise notwendig, um den Steuerbetrag korrekt zu ermitteln. MwSt- und Summenelemente werden dann im Angebot wieder korrekt berechnet.

Warning

Diese Lösung ist nur geeignet, wenn Sie keinen mehrstufigen Vertriebsprozess haben, in dem Sie auf den Verkaufspreis weitere Rabatte vergeben ('Sonderrabatt Partner' und ‘Sonderrabatt Distributor’). In diesem Falle unterscheidet sich der Verkaufspreis vom Einkaufspreis Partner/Distributor und beides darf nicht gleichgesetzt werden.

These two values are necessary as the lowest unit prices to correctly calculate the tax amount. VAT and sum items are then calculated correctly again in the quote.

Warning

This solution is suitable only if you do not have a multi-level sales process in which you give further discounts on the sales price ("Special Discount Partner" and "Special Discount Distributor"). In this case, the sales price is different from the buy price partner/distributor and the two must not be equated.