USt-IdNr. abfragen
WEBSALE V8s unterstützt die Eingabe einer internationalen europäischen Umsatzsteuer-Identifikationsnummer (USt-IdNr.) und prüft diese auf korrekte Syntax. Die Syntaxprüfung basiert auf den Richtlinien des Bundeszentralamts für Steuern und umfasst die gesamte Europäische Union. Zudem können Sie bestimmen, ob bei der Eingabe einer syntaktisch korrekten USt-IdNr. die deutsche MwSt. für den Käufer entfällt.
Inhalt
IdNr. bei der Rechnungsadresse
2 USt-IdNr. bei der Lieferadresse und Mehrwertsteuerbefreiung
3 USt-IdNr. nur bei Firmenkunden
1 USt-IdNr. bei der Rechnungsadresse
Schritt 1: Definieren des Adressdatenfeldes TaxID in der Shopkonfiguration shop.config
Im Abschnitt <AddressFields-Txt> der Shopkonfiguration shop.config definieren Sie die Felder, die für Ihre Rechnungsadresse verwendet werden sollen. Ein Feld wird dann verwendet, wenn hinter dem "=" ein Wert eingetragen ist. Der Wert hinter dem "=" kann dann auch als Bezeichnung im Shop ausgegeben werden.
Die Umsatzsteueridentifikationsnummer (USt-IdNr.) wird im Produktdatenfeld TaxID abgefragt.
<AddressFields-Txt>
…
TaxID = Umsatzsteueridentifikationsnummer (USt-IdNr.)
…
</ AddressFields-Txt>
Referenz: Abschnitt AddressFields-Txt
Schritt 2: Pflichtfeld
Mithilfe des Abschnittes <InputCheck> der Shopkonfiguration shop.config können Sie die Pflichtfeldprüfung für Ihr Adressdatenfeld TaxID definieren, d. h. um die Bestellung durchzuführen, muss Ihr Kunde eine Umsatzsteueridentifikationsnummer (USt-IdNr.) angeben. Zusätzlich können sie eine Fehlermeldung hinterlegen, die angezeigt wird, wenn vom Kunden keine Umsatzsteueridentifikationsnummer (USt-IdNr.) eingegeben wurde.
Soll die Eingabe einer Umsatzsteueridentifikationsnummer (USt-IdNr.) optional sein, können Sie diesen Schritt überspringen.
<InputCheck>
<ErrorMessages>
EmptyTaxIDError = Bitte füllen Sie das Feld "~FieldName~" aus.
</ErrorMessages>
<+InputCheck>
AddressField = TaxID
AddressType = bill
Type = minlen
Len = 1
ErrorMessageID = EmptyTaxIDError
</+InputCheck>
</InputCheck>
Referenz: Abschnitt InputCheck
Schritt 3: Erlaubte Zeichenanzahl
Im Abschnittes <AdressMaxInputLen> der Shopkonfiguration shop.config legen Sie die maximale Anzahl der Zeichen fest, die in das gewünschte Adressdatenfeld eingegeben werden darf.
<AdressMaxInputLen>
...
TaxID = 15
...
</AdressMaxInputLen>
Referenz: Abschnitt AdressMaxInputLen
Schritt 4: Integration des Eingabefeldes
Die Eingabe einer Rechnungsadresse kann sowohl auf der Rechnungs- und Lieferadressseite im Bestellablauf (ws_address_combined.htm) wie auch auf der Verwaltungsseite der Rechnungsadresse im Kundenkonto (ws_address_manage.htm) erfolgen.
Integrieren Sie das Eingabefeld mit seiner individuellen Fehlermeldung auf beiden Seiten innerhalb der <form>.
<form>
...
{A-TaxID_visible}
<label for="~A-TaxID_input~">~A-TaxID_text~ {A-TaxID_required}*{/A-TaxID_required} </label>
<input type="text" name="~A-TaxID_input~" maxlength="~A-TaxID_max~" value="~A-TaxID~" class="input~A-TaxID_error~">
{A-TaxID_errormessage}~A-TaxID_errormessage~{/A-TaxID_errormessage}
{/A-TaxID_visible}
...
</form>
Referenz: A-<technischer Name>
Referenz: A-<technischer Name>_text
Referenz: A-<technischer Name>_required
Referenz: A-<technischer Name>_input
Referenz: A-<technischer Name>_max
Referenz: A-<technischer Name>_visible
Referenz: A-<technischer Name>_errormessage
Schritt 5: Anzeige der eingegebenen Umsatzsteueridentifikationsnummer
Hat ein Kunde eine Umsatzsteueridentifikationsnummer eingegeben, können Sie diese Eingabe anzeigen lassen.
Sinnvoll ist an dieser Stelle auf jeden Fall die Anzeige auf der Bestellübersichtsseite (ws_place_order.htm) und der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm).
{A-TaxID}
~A-TaxID_text~: ~A-TaxID~
{/A-TaxID}
Referenz: A-<technischer Name>
Referenz: A-<technischer Name>_text
2 USt-IdNr. bei der Lieferadresse & Mehrwertsteuerbefreiung
Für die Lieferadresse steht kein spezielles oder Standard-TaxID-Feld zur Verfügung.
Wenn bei der Lieferadresse die Umsatzsteueridentifikationsnummer abgefragt werden soll, dann muss dafür ein beliebiges Suffix-Feld verwendet und wie folgt definiert werden:
Schritt 1: Definieren des Eingabefeldes in der Shopkonfiguration
Im Abschnitt <DeliveryAddressFields-Txt> der Shopkonfiguration shop.config definieren Sie die Felder, die für Ihre Lieferadresse verwendet werden sollen. Ein Feld wird dann verwendet, wenn hinter dem "=" ein Wert eingetragen ist. Der Wert hinter dem "=" kann dann auch als Bezeichnung im Shop ausgegeben werden.
In unserem Beispiel soll die Umsatzsteueridentifikationsnummer (USt-IdNr.) im Suffix-Feld Suffix45 abgefragt werden.
<DeliveryAddressFields-Txt>
…
Suffix45 = Umsatzsteueridentifikationsnummer (USt-IdNr.)
…
</DeliveryAddressFields-Txt>
Referenz: Abschnitt DeliveryAddressFields-Txt
Schritt 2: Als Pflichtfeld definieren
Mithilfe des Abschnittes <InputCheck> der Shopkonfiguration shop.config können Sie die Pflichtfeldprüfung für das Eingabefeld definieren, d. h. um die Bestellung durchzuführen, muss Ihr Kunde eine Umsatzsteueridentifikationsnummer (USt-IdNr.) angeben. Zusätzlich können sie eine Fehlermeldung hinterlegen, die angezeigt wird, wenn vom Kunden keine Umsatzsteueridentifikationsnummer (USt-IdNr.) eingegeben wurde.
Soll die Eingabe einer Umsatzsteueridentifikationsnummer (USt-IdNr.) optional sein, können Sie diesen Schritt überspringen.
<InputCheck>
<ErrorMessages>
EmptyTaxIDError = Bitte füllen Sie das Feld "~FieldName~" aus.
</ErrorMessages>
<+InputCheck>
AddressField = Suffix45
AddressType = delivery
Type = minlen
Len = 1
ErrorMessageID = EmptyTaxIDError
</+InputCheck>
</InputCheck>
Referenz: Abschnitt InputCheck
Schritt 3: Erlaubte Zeichenanzahl festlegen
Im Abschnittes <AdressMaxInputLen> der Shopkonfiguration shop.config legen Sie die maximale Anzahl der Zeichen fest, die in das gewünschte Adressdatenfeld eingegeben werden darf.
<AdressMaxInputLen>
...
Suffix45 = 15
...
</AdressMaxInputLen>
Referenz: Abschnitt AdressMaxInputLen
Schritt 4: Einstellungen in der Shopkonfiguration shop.config für die Ermittlung der Mehrwertsteuerbefreiung (optional)
Im Abschnitt <VAT> der Shopkonfiguration shop.config legen Sie fest, ob die Ermittlung der Mehrwertsteuerbefreiung abhängig von der USt-IdNr. der Lieferadresse sein soll.
Außerdem hinterlegen Sie das zuvor definierte Suffix-Feld der USt-IdNr.
Beispiel:
<VAT>
...
TaxFree4TaxID-DeliveryDependent = yes
TaxFree4TaxID-DelivAddrTaxIDField = Suffix45
...
</VAT>
Referenz: Abschnitt VAT
Hinweis: |
|
|
Mehr Informationen zur Mehrwertsteuerberechnung im WEBSALE Onlineshop finden Sie unter |
Schritt 5: Integration des Eingabefeldes
Die Eingabe einer Lieferadresse kann sowohl auf der Rechnungs- und Lieferadressseite im Bestellablauf (ws_address_combined.htm) als auch auf der Verwaltungsseite der Lieferadresse im Kundenkonto (ws_delivaddress_manage.htm) erfolgen.
Integrieren Sie das Eingabefeld mit seiner individuellen Fehlermeldung auf beiden Seiten innerhalb der <form>.
<form>
...
{D-Suffix45_visible}
<label for="~D-Suffix45_input~">~D-Suffix45_text~ {D-Suffix45_required}*{/D-Suffix45_required} </label>
<input type="text" name="~D-Suffix45_input~" maxlength="~D-Suffix45_max~" value="~D-Suffix45~" class="input~D-Suffix45_error~">
{D-Suffix45_errormessage}~D-Suffix45_errormessage~{/D-Suffix45_errormessage}
{/D-Suffix45_visible}
...
</form>
Referenz: D-<technischer Name>
Referenz: D-<technischer Name>_text
Referenz: D-<technischer Name>_required
Referenz: D-<technischer Name>_input
Referenz: D-<technischer Name>_max
Referenz: D-<technischer Name>_visible
Referenz: D-<technischer Name>_errormessage
Schritt 6: Anzeige der eingegebenen Umsatzsteueridentifikationsnummer
Hat ein Käufer eine Umsatzsteueridentifikationsnummer eingegeben, können Sie diese Eingabe anzeigen lassen.
Sinnvoll ist die Anzeige auf der Bestellübersichtsseite (ws_place_order.htm) und der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm).
{D-Suffix45}
~D-Suffix45_text~: ~D-Suffix45~
{/D-Suffix45}
Referenz: D-<technischer Name>
Referenz: D-<technischer Name>_text
3 USt-IdNr. nur bei Firmenkunden
Mit WEBSALE V8s haben Sie die Möglichkeit die Umsatzsteueridentifikationsnummer (USt-IdNr.) nur abzufragen, wenn es sich bei Ihrem Kunden um einen Firmenkunden handelt.
Dazu ist es notwendig, dass Sie in Ihrem Shop die Auswahl eines Adresstyps integrieren, z. B. Privatadresse und Geschäftsadresse. Sie haben dann die Möglichkeit individuell für jeden Adresstyp zu definieren, welche Adresseingabefelder abgefragt werden sollen.
Unter Auswahl zwischen Privat- und Geschäftsadresse ist die Eingabe der Umsatzsteueridentifikationsnummer (USt-IdNr.) ausschließlich für Geschäftskunden / Firmenkunden beschrieben. Bitte folgen Sie dieser Integrationsanleitung.
Wegweiser: Auswahl zwischen Privat- und Geschäftskunde
4 Prüfen der Umsatzsteueridentifikationsnummer
Für die Umsatzsteueridentifikationsnummer können Sie eine länderabhängige syntaktische Prüfung vornehmen lassen, d. h. die Eingabe muss eine gültige UmsatzsteuerID sein.
Ist das Eingabefeld der Umsatzsteueridentifikationsnummer ein Teil der Rechnungsadresse, wird das ausgewählte Land der Rechnungsadresse verwendet.
Wurde kein Rechnungs- bzw. Lieferadressland ausgewählt, wird auf eine deutsche UmsatzsteuerID geprüft.
Ist eine Umsatzsteueridentifikationsnummer syntaktisch nicht korrekt, können Sie eine individuelle Fehlermeldung definieren.
<InputCheck>
<ErrorMessages>
WrongTaxID = Diese ~FieldName~ ist leider falsch. Bitte überprüfen Sie die Schreibweise Ihrer ~FieldName~.
</ErrorMessages>
<+InputCheck>
AddressField = TaxID
AddressType = bill
Type = taxid
ErrorMessageID = WrongTaxID
</+InputCheck>
</InputCheck>
Referenz: Abschnitt InputCheck
5 Mehrwertsteuerbefreiung bei Lieferung in das EU-Gemeinschaftsgebiet und Drittländer für Firmenkunden
Optional können Sie bestimmen, ob bei der Eingabe einer syntaktisch korrekten USt-IdNr. die deutsche MwSt. für Ihren Firmenkunden entfällt. Hierzu geben Sie in der Shopkonfiguration shop.config im Abschnitt <VAT> mit dem Parameter TaxIDCountries die Länder an, für die der Erlass gelten soll.