Im Rahmen der kanadischen Implementierung können Informationen zu Steuern und Steuerbeträgen auf unterschiedliche Arten an das RetailForce System übermittelt werden.

• Information innerhalb jeder Position
• Information in einer Steuerposition

Information innerhalb jeder Position

Hierbei handelt es sich um das reguläre Vorgehen, Standard für alle Länder.

Es werden Werte für die Eigenschaften

• "VatIdentification",
• "VatPercent" + "VatPercent2", sowie
• "TaxValue" + "TaxValue2"

für jede Position übermittelt.

Automatische Berechnungen der Werte

Wie in anderen Ländern, kann auch in Kanada die Funktion zur automatischen Berechnung von einzelnen Werten ("AutomaticVatCalculation") verwendet werden.

Berechnung Bruttobetrag

Für Kanada empfehlen wir hierfür "GrossValueCalculation", also die automatische Berechnung der Werte:

• "GrossValue" (Betrag inkl. Steuern)
• "TaxValue" + "TaxValue2"

auf Basis des Nettobetrages (Betrag ohne Steuern).

Um diese funktion zu verwenden, muss das Property "AutomaticVatCalculation" mit Wert "GrossValueCalculation" gesetzt werden.

Auf der einzelnen Position wird lediglich der Nettobetrag, sowie die anzuwendenden Steuersätze ("VatIdentification", "VatPercent", "VatPercent2") angegeben:

...
    "AutomaticVatCalculation": "GrossValueCalculation",
    "Positions": [
        {
            ...
            "VatIdentification": 1,
            "VatPercent": 5,
            "VatPercent2": 9.975,
            "NetValue": 100.00,
            ...
        }
    ]

Berechnung Nettobetrag

Wenn Sie den Nettobetrag, ausgehend vom Bruttobetrag berechnen lassen wollen, verwenden Sie "NetValueCalculation".

In diesem Fall müssen Sie anstatt "NetValue", die Eigenschaften "GrossValue" in jeder Position angeben. Der Nettobetrag sowie die Steuerbeträge werden automatische vom Bruttobetrag aus berechnet.

Information in einer Steuerposition

Alternativ zu Angabe von Beträgen und Steuersätzen innerhalb sämtlicher Positionen können auch Steuerpositionen - "TaxPositions" - mit den entsprechenden Belegsummen im Payload übergeben werden.

In "TaxPositions" werden die einzelnen Steuerbeträge für das gesamte Dokument aufsummiert.

In Kanada können auf diese Weise "TaxPositions" Objekte für die beiden Standardsteuersätze sowie Nullsteuer angegeben werden.

Beispiel:

"taxPositions": [
    {
        "vatIdentification": 1,
        "vatLabel": "GST and PST rates province Quebec",
        "vatPercent1": 5,
        "vatPercent2": 9.975,
        "vatAmount": 0.44,
        "vatAmount2": 0.87,
        "netAmount": 8.70,
        "grossAmount": 10.01
    },
    {
        "vatIdentification": 4,
        "vatLabel": "No Tax/other Tax 0%",
        "vatPercent1": 0,
        "vatPercent2": 0,
        "vatAmount": 0.0,
        "vatAmount2": 0.0,
        "netAmount": 10.00,
        "grossAmount": 10.00
    }
],

Um diese Funktion nutzen zu können, geben Sie

• auf den einzelnen Positionen entweder den Nettobetrag ("NetValue") oder den Bruttobetrag ("GrossValue") sowie
• entsprechend "GrossValueCalculation" oder "NetValueCalculation" als Wert der Property "AutomaticVatCalculation" an.