Eigener USt-Handler #

Diese Seite ist für Entwickler, deren Umsatzsteuerregeln sich nicht mit USt-Regeln nach Land und Produktkategorie ausdrücken lassen. Der Shop fragt einen USt-Handler nach dem Prozentsatz jedes Produkts mit dynamischer Umsatzsteuer; Sie können Ihren eigenen Handler schreiben und alles andere behalten.

Inhalt #

1. Wann Sie einen brauchen
2. Der Vertrag
3. Ihn registrieren
4. Auf dem Standard-Handler aufbauen
5. Testen

Wann Sie einen brauchen #

Die Steuerregeln selbst sind Sache Ihres Steuerberaters; der Handler setzt nur um, was Sie entscheiden.

Der Vertrag #

eZVATManager::getVAT( $object, $country ) (kernel/classes/ezvatmanager.php) lädt den Handler und ruft auf:

function getVatPercent( $object, $country )

Geben Sie den Prozentsatz als Zahl zurück. Die Rückgabe von null kennzeichnet die Umsatzsteuer als unbekannt. Der Handler wird nur für Produkte gefragt, deren Preis den dynamischen USt-Typ verwendet; Produkte mit einem festen USt-Typ behalten diesen.

Ihn registrieren #

# extension/mystore_shop/settings/shop.ini.append.php
[VATSettings]
Handler=mystore
ExtensionDirectories[]=mystore_shop
RequireUserCountry=false

Die Klasse mystoreVATHandler gehört in extension/mystore_shop/vathandlers/mystorevathandler.php. Setzen Sie RequireUserCountry=false nur, wenn Ihr Handler das Land nicht braucht; der mitgelieferte Kommentar sagt das ebenfalls (shop.ini durchgegangen).

Auf dem Standard-Handler aufbauen #

Wenn Sie eZDefaultVATHandler (kernel/classes/vathandlers/ezdefaultvathandler.php) erweitern, bleibt die regelbasierte Entscheidung erhalten, und Sie können zuerst eine Ausnahme behandeln:

class mystoreVATHandler extends eZDefaultVATHandler
{
    function getVatPercent( $object, $country )
    {
        if ( $this->isBusinessCustomerWithValidNumber() )
        {
            return 0;
        }
        return parent::getVatPercent( $object, $country );
    }
}

isBusinessCustomerWithValidNumber() schreiben Sie selbst; woher die USt-IdNr. kommt (ein Kontofeld, das Kassenformular Ihres Shop-Konto-Handlers), ist Ihr Entwurf. Der RAD-Handler-Assistent hat ein Rezept für USt-Handler, das dieses Gerüst schreibt (Pfad für Entwickler).

Testen #

• To do: Unit-Tests von getVatPercent() für jeden Fall, den Sie umsetzen.
• To do: Eine Testbestellung je Fall; Bestätigungsseite, Bestellung und Mail stimmen überein.
• To do: Unbekanntes Land: Das Ergebnis ist das, was Sie beabsichtigen, keine versehentliche 0.
• To do: Das Shop-Dashboard zeigt keine unerwartete Warnung zu 0 Prozent.

Verwandte Seiten #

• Den Shop erweitern
• USt-Regeln und USt-Typen
• Checkliste zur Umsatzsteuer
• Freie Dokumentation: diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.