Zollgebühren DDP / DAP: vollständige Anleitung

Überblick und Voraussetzungen

Das Modul Zollgebühren DDP / DAP richtet sich an Shops mit Sitz in der Europäischen Union, die außerhalb der EU versenden. Sobald die Lieferadresse außerhalb des EU-Zollgebiets liegt, erscheint im Versandschritt des Checkouts ein Block: Der Kunde bezahlt Zölle und Einfuhrumsatzsteuer mit seiner Bestellung (DDP) oder bei der Zustellung an den Versanddienstleister (DAP). Die Sätze können pro Land, pro Kategorie oder pro Produkt variieren, jeder Versanddienstleister kann seine Vorlageprovision hinzufügen, und eine Schätzung wird bereits auf der Produktseite angezeigt.

• Ein einziges Paket für PrestaShop 1.7.0 bis 9.x.
• PHP 5.4 bis 8.4, je nach Anforderung Ihrer PrestaShop-Version.
• Themes Classic und Hummingbird sowie davon abgeleitete Themes.
• Multishop und mehrere Währungen: Die Gebühren werden in der Währung des Warenkorbs berechnet.
• Mitgelieferte Übersetzungen: Französisch, Englisch, Spanisch, Deutsch, Italienisch, Portugiesisch, Niederländisch, Polnisch.
• Keine Overrides des Kerns: ausschließlich native Hooks.

Installation und Update

1. Laden Sie das Archiv dfcustomsduty.zip aus Ihrem Kundenkonto herunter.
2. Öffnen Sie im Back-Office Module > Modul-Manager.
3. Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
4. Klicken Sie auf Konfigurieren.

Bei der Installation registriert das Modul seine Hooks, legt seine Tabellen an und erstellt ein verborgenes virtuelles Produkt „Zollgebühren & Einfuhrabgaben (DDP)“, steuerfrei, mit Bild und auch ohne Lagerbestand bestellbar. Dieses Produkt erscheint nicht im Katalog und seine Produktseite leitet auf die 404-Seite weiter: Es dient ausschließlich als Abrechnungsposition bei DDP.

Update von Version 1.3.0

Laden Sie das neue Archiv hoch und starten Sie das Update. Das Skript setzt den Bestand des Gebührenprodukts auf eine Million Einheiten: Bei einem Bestand von 0 wechselte jede DDP-Bestellung automatisch in einen Status wegen fehlenden Lagerbestands, und bei einer Statusänderung wurde die Gebührenposition als nicht vorrätig gemeldet. Danach wird der Bestand bei jeder DDP-Bestellung aufgefüllt. Ihre Einstellungen, Sätze, Regeln und Bestellungen bleiben erhalten, die berechneten Beträge ändern sich nicht.

Update von Version 1.2

Laden Sie das neue Archiv hoch und starten Sie das Update. Das Skript legt die Tabelle der Produktregeln an, ergänzt die Bestellungen um den Betrag der Vorlageprovision und registriert den Hook der Produktseite. Ihre Einstellungen, Sätze und Bestellungen bleiben erhalten, und die berechneten Beträge ändern sich nicht, solange Sie weder Regeln noch Vorlageprovisionen hinzufügen.

Update von Version 1.1

Laden Sie das neue Archiv über die alte Version hoch und starten Sie das Update im Modul-Manager. Das Update-Skript fügt die neuen Spalten hinzu, registriert die neuen Hooks und versieht das Gebührenprodukt mit einem Bild. Ihre Sätze und die Bestellhistorie bleiben erhalten:

• der bisherige Satz pro Land wird zum Zollsatz;
• die Einfuhrumsatzsteuer bleibt bei 0, solange Sie sie nicht eintragen, sodass die bisher berechneten Beträge unverändert bleiben;
• eine Länder-Freigrenze von 0, die bisher „globale Freigrenze“ bedeutete, wird zu einem leeren Feld, das die Standard-Freigrenze übernimmt.

Die Konfigurationsseite

Oben auf der Seite zeigt ein Banner den Status des Moduls und vier Kennzahlen der letzten 30 Tage: Nicht-EU-Bestellungen, DDP-Anteil, per DDP eingenommene Abgaben, bei der Zahlung bestätigte DAP-Bestellungen. Direkt darunter listet das Statusbanner auf, was das Modul am Funktionieren hindert oder Ihre Aufmerksamkeit erfordert: kein Satz konfiguriert, Gebührenprodukt deaktiviert (Schaltfläche Reparieren), DDP-pflichtige Länder ohne Gebühren, nicht DDP-fähige Versanddienstleister, die diese Länder beliefern, Regeln für ein gelöschtes Produkt oder eine gelöschte Kategorie, fehlende Geolokalisierungsdatenbank. Die Konfiguration ist anschließend auf fünf Registerkarten verteilt: Einstellungen, Ländersätze, Produktregeln, Simulator, Hilfe.

Einstellungen

Ablauf im Checkout

• Modul aktivieren: globaler Schalter.
• Im Checkout vorausgewählter Modus: DDP (empfohlen, reduziert abgelehnte Pakete) oder DAP.
• Berechnungsdetails anzeigen: Der Kunde kann die Aufschlüsselung nach Zoll, Einfuhrumsatzsteuer und Gebühren aufklappen.
• DAP-Zustimmung bei der Zahlung einholen: fügt im Zahlungsschritt ein Pflicht-Kontrollkästchen hinzu, wenn der Kunde DAP gewählt hat (siehe unten).
• Hinweis im Warenkorb anzeigen: informiert den Kunden bereits im Warenkorb, dass bei einer Lieferung außerhalb der EU Gebühren anfallen.

Standardberechnung

Diese Werte gelten für alle Ziele außerhalb der EU, sofern sie nicht pro Land überschrieben werden.

• Zollsatz (%): durchschnittlicher Zollsatz für Ihre Produkte.
• Einfuhrumsatzsteuer / Einfuhrsteuer (%): wird auf den Zollwert zuzüglich Zoll erhoben.
• Bearbeitungspauschale: fester Betrag in der Standardwährung des Shops, ohne Steuern.
• Freigrenze (De-minimis): Unterhalb dieses Bestellwerts fallen keine Gebühren an. 0 = keine Freigrenze.
• Versandkosten in die Berechnungsbasis einbeziehen: Der Zollwert (CIF) schließt in der Regel den Transport ein.

Ziele und Versanddienstleister

• Länder des EU-Zollgebiets (ISO-Codes): standardmäßig die 27 Mitgliedstaaten plus Monaco. Jede Lieferung in ein anderes Land wird als Nicht-EU-Lieferung behandelt.
• Länder mit DDP-Pflicht (ISO-Codes): Ziele, für die der Kunde DAP nicht wählen kann. Standardwert: US. Leer lassen, um die Funktion zu deaktivieren.
• DDP-fähige Versanddienstleister: Wählen Sie die Versanddienstleister aus, die verzollt liefern können. Ist nichts ausgewählt, gelten alle Versanddienstleister als kompatibel.

Schätzung auf der Produktseite

• Schätzung auf der Produktseite anzeigen: Block unter dem Warenkorb-Button (siehe Auf der Produktseite).
• Geolokalisierung verwenden: Hat der Besucher weder eine Adresse noch eine gespeicherte Auswahl, wird das Land aus seiner IP-Adresse ermittelt: Header CF-IPCountry, wenn der Shop über Cloudflare läuft, sonst die GeoLite2-Datenbank von PrestaShop.
• Länderauswahl anbieten: Der Besucher wählt sein Lieferland. Ohne Länderauswahl erscheint der Block nur, wenn das Land bekannt ist und außerhalb der EU liegt.

Vorlageprovisionen der Versanddienstleister

Unter den Einstellungen listet eine Tabelle Ihre Versanddienstleister mit drei Feldern auf: fester Betrag, Prozentsatz der Zölle und Abgaben, Mindestbetrag. Siehe Vorlageprovisionen der Versanddienstleister.

Berechnungsformel

Die Gebühren werden netto in der Währung des Warenkorbs berechnet:

Zollwert            = Produkte netto (ohne Gebührenposition)
                    + Versand netto      (wenn die Option aktiv ist)

für jede Warenkorbzeile (Satz der Zeile, siehe Produktregeln):
Zoll                = Zeilenwert × Zollsatz
Einfuhrumsatzsteuer = (Zeilenwert + Zoll) × Steuersatz

Vorlageprovision    = max(Mindestbetrag, fest + % × (Zoll + Einfuhrumsatzsteuer))
Gesamt              = Zoll + Einfuhrumsatzsteuer + Bearbeitungspauschale + Vorlageprovision

Die Freigrenze wird zuerst geprüft, und zwar anhand des gesamten Zollwerts: Liegt er unter der geltenden Freigrenze, werden keine Gebühren berechnet. Der Versand wird anteilig nach ihrem Wert auf die Zeilen verteilt. Die Vorlageprovision fällt nur an, wenn Zölle oder Abgaben geschuldet sind. Pauschalgebühren, Vorlageprovisionen und Freigrenzen werden in der Standardwährung erfasst und in die Währung des Warenkorbs umgerechnet.

Ländersätze

Die Registerkarte Ländersätze überschreibt die Berechnung Ziel für Ziel. Das Formular enthält: Zielland, Zollsatz (%), Einfuhrumsatzsteuer (%), Pauschalgebühr, Freigrenze und die Option DDP für dieses Land erzwingen.

Ein leer gelassenes Feld übernimmt den Wert der Standardberechnung. Geben Sie für die Freigrenze 0 ein, wenn für dieses Land keine Freigrenze gelten soll.

Die Satztabelle zeigt für jedes Land die eigenen Werte oder den Vermerk „Standard“, den Status der DDP-Pflicht (Option des Landes oder globale Liste), den Gebührenbetrag für 100 Einheiten Ihrer Währung sowie die Schaltflächen Bearbeiten und Löschen.

Voreinstellungen zur Einfuhrumsatzsteuer

Unter der Tabelle übernehmen die Voreinstellungen mit einem Klick die Normalsätze der Einfuhrumsatzsteuer bzw. GST für 21 Länder: Vereinigtes Königreich, Schweiz, Liechtenstein, Norwegen, Island, Andorra, Serbien, Türkei, Israel, Vereinigte Arabische Emirate, Saudi-Arabien, Vereinigte Staaten, Kanada, Mexiko, Australien, Neuseeland, Japan, Südkorea, Singapur, China, Südafrika. Geändert wird nur die Einfuhrumsatzsteuer: Ihre Zollsätze, Gebühren, Freigrenzen und DDP-Pflichten bleiben unverändert. Länder ohne eingetragene Einfuhrumsatzsteuer sind standardmäßig ausgewählt.

Regeln pro Kategorie und pro Produkt

Die Registerkarte Produktregeln legt einen eigenen Zoll- und / oder Einfuhrumsatzsteuersatz für eine Kategorie oder ein Produkt fest. Typisches Beispiel: Ihre Artikel, die bei Lieferung in die USA vom Zoll befreit sind, oder eine Kategorie, deren HS-Code einen anderen Satz als Ihr Durchschnitt hat.

1. Wählen Sie Eine Kategorie (die Regel gilt auch für ihre Unterkategorien) oder Ein Produkt (Suche nach Name, Referenz oder ID).
2. Wählen Sie das Ziel: ein Land oder Alle Nicht-EU-Ziele.
3. Geben Sie den Zoll- und / oder Steuersatz ein. 0 befreit; ein leeres Feld behält den Satz der nächsten Ebene. Die Schaltfläche Vom Zoll befreien (0 %) füllt das Zollfeld aus.
4. Klicken Sie auf Regel speichern.

Für jede Warenkorbzeile wird jeder Satz in dieser Reihenfolge gesucht, und der erste definierte Satz gilt:

1. Produktregel für das Lieferland;
2. Produktregel, alle Nicht-EU-Ziele;
3. Kategorieregel für das Lieferland (spezifischste Kategorie zuerst);
4. Kategorieregel, alle Nicht-EU-Ziele;
5. Satz des Landes, dann Standardsatz.

DDP-fähige Versanddienstleister

Nicht alle Versanddienstleister bieten einen DDP-Service an. Sobald Sie Ihre kompatiblen Versanddienstleister angegeben haben:

• bei einem nicht kompatiblen Versanddienstleister bietet der Block nur DAP an und nennt die Versanddienstleister, mit denen die Abgaben bei der Bestellung bezahlt werden können;
• für ein Land mit DDP-Pflicht werden nicht kompatible Versanddienstleister im Checkout deaktiviert und der Kunde wird auf einen kompatiblen Versanddienstleister umgestellt;
• beliefert kein kompatibler Versanddienstleister das Ziel, wird die Schaltfläche Weiter mit einer Meldung gesperrt, und das Statusbanner weist Sie darauf hin.

Vorlageprovisionen der Versanddienstleister

DHL, FedEx, UPS und die meisten Expressdienste berechnen eine Gebühr für die Vorlage von Zöllen und Abgaben: einen festen Betrag, einen Prozentsatz der vorgelegten Beträge oder beides mit einem Mindestbetrag. Tragen Sie diese Werte pro Versanddienstleister unter Einstellungen > Vorlageprovisionen der Versanddienstleister ein.

• Die Provision wird für den vom Kunden gewählten Versanddienstleister in die Berechnung aufgenommen, bei DDP (Sie geben sie weiter) ebenso wie in der DAP-Schätzung (der Versanddienstleister fordert sie vom Kunden).
• Sie fällt nur an, wenn Zölle oder Abgaben geschuldet sind: Eine vollständig befreite Bestellung löst sie nicht aus.
• Sie erscheint in einer eigenen Zeile in den Berechnungsdetails, in der Bestellung und im Kundenkonto: „Vorlageprovision des Versanddienstleisters“.

DDP für bestimmte Länder erzwingen

Für ein Land gilt die DDP-Pflicht, wenn es in der globalen Liste steht oder wenn sein Ländersatz die entsprechende Option trägt. Die USA stehen standardmäßig in der Liste: Dort werden auf alle Sendungen Abgaben erhoben, unabhängig vom Wert. Für diese Ziele zeigt der Block nur DDP an, gekennzeichnet mit „Für dieses Ziel verpflichtend“, zusammen mit einer Erklärung für den Kunden.

Simulator

Die Registerkarte Simulator berechnet die Gebühren für ein Land, ein Produkt (optional), einen Produktbetrag, einen Versandbetrag und einen Versanddienstleister. Sie zeigt genau die Aufschlüsselung, die der Kunde sehen wird, gibt an, ob für dieses Land DDP verpflichtend ist, und nennt die Herkunft jedes Satzes (Produktregel, Kategorieregel, Wert des Landes oder Standardwert). Außerdem weist sie auf Fälle hin, in denen der Block nicht angezeigt würde: Bestellung unter der Freigrenze oder kein Satz konfiguriert.

Kundenerlebnis

Auf der Produktseite

Unter dem Warenkorb-Button zeigt ein Block das Ziel und die geschätzten Zölle und Abgaben für den Artikel, mit den angewendeten Sätzen (einschließlich Produktregeln). Die Schätzung betrifft nur den Artikel: Versand, Bearbeitungsgebühren und Vorlageprovision sind nicht enthalten, worauf der Block hinweist. Sie wird beim Wechsel der Variante aktualisiert.

Das Land wird in dieser Reihenfolge ermittelt:

1. vom Besucher in der Länderauswahl gewähltes Land (in seinem Browser gespeichert);
2. Lieferadresse des Warenkorbs;
3. erste Adresse des angemeldeten Kunden;
4. Geolokalisierung, wenn die Option aktiv ist: Cloudflare-Header, dann GeoLite2-Datenbank.

Bei einem EU-Land oder einem unbekannten Land beschränkt sich der Block auf den Link „Lieferung außerhalb der Europäischen Union? Schätzen Sie die Zollgebühren“, der die Länderauswahl öffnet. Liegt der Artikel allein unter der Freigrenze, weist der Block darauf hin und nennt die Schätzung für höhere Beträge. Bei einem befreiten Artikel wird angezeigt, dass keine Zölle oder Abgaben anfallen.

Im Warenkorb

Ist die Adresse des Kunden bereits bekannt und liegt sie außerhalb der EU, kündigt ein Hinweis die geschätzten Gebühren an. Bei einem Ziel mit DDP-Pflicht gibt er an, dass die Gebühren im Schritt Versand hinzugefügt werden. Bei DDP ist die Position „Zollgebühren“ im Warenkorb mit einem Bild versehen und gesperrt: keine änderbare Menge, kein Entfernen, kein Link zu einer Produktseite.

Im Versandschritt

Der Block erscheint zwischen der Liste der Versanddienstleister und dem Bestellkommentar, vor der Schaltfläche Weiter. Der Kunde sieht:

• Jetzt mit meiner Bestellung bezahlen (DDP), mit dem Betrag: Die Gebühren werden der Bestellung hinzugefügt, bei der Zustellung ist nichts zu zahlen;
• Bei Zustellung bezahlen (DAP), mit der Schätzung: Der Versanddienstleister erhebt Zölle, Steuern und etwaige Bearbeitungsgebühren;
• Berechnung im Detail ansehen: Zollwert, Zoll, Einfuhrumsatzsteuer, Bearbeitungsgebühren, Vorlageprovision des Versanddienstleisters.

Beim Wechsel der Option wird die Seite nicht neu geladen: Die Bestellübersicht wird sofort aktualisiert. Der Block aktualisiert sich auch, wenn der Kunde den Versanddienstleister wechselt.

DAP-Zustimmung im Zahlungsschritt

Ist die Option aktiv und hat der Kunde DAP gewählt, erscheint zusammen mit den AGB ein Pflicht-Kontrollkästchen: Der Kunde bestätigt, dass die Abgaben (mit der Schätzung) und etwaige Gebühren des Versanddienstleisters bei der Zustellung von ihm erhoben werden. Das Datum der Zustimmung wird gespeichert und auf der Bestellseite angezeigt. Sie wird aufgehoben, wenn der Kunde den Modus wechselt oder sich der geschätzte Betrag ändert.

Bestellung, Rechnung und Lieferschein

Bei der Bestätigung speichert das Modul den Modus, den Betrag, die Aufschlüsselung nach Zoll / Steuer / Bearbeitungsgebühren / Vorlageprovision, das Land, den Versanddienstleister und bei DAP das Datum der Zustimmung.

• Bestellseite im Back-Office: Badge DDP oder DAP, Betrag, Aufschlüsselung, Ziel, Versanddienstleister, Datum der DAP-Zustimmung und eine Warnung, wenn eine DDP-Bestellung mit einem nicht als kompatibel hinterlegten Versanddienstleister versendet wird.
• Kundenkonto: Übersicht, was bezahlt wurde oder noch zu zahlen ist, mit Aufschlüsselung.
• PDF-Rechnung: Incoterm-Vermerk DDP (Abgaben bei der Bestellung bezahlt) oder DAP (Abgaben trägt der Empfänger, mit der mitgeteilten Schätzung).
• PDF-Lieferschein: Anweisung „VERSAND UNTER DDP“ oder „VERSAND UNTER DAP“ für den Kommissionierer, mit dem Ziel.

Übersetzungen

Alle Texte (Checkout, Warenkorb, Kundenkonto, Back-Office, PDF) werden auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Portugiesisch, Niederländisch und Polnisch mitgeliefert. Sie können jeden Text unter International > Übersetzungen > Übersetzungen installierter Module anpassen.

FAQ und Fehlerbehebung

Der Auswahlblock wird nicht angezeigt

Prüfen Sie zuerst das Statusbanner. Prüfen Sie anschließend, ob die Lieferadresse außerhalb des konfigurierten EU-Gebiets liegt, ob ein Satz einen Betrag über 0 ergibt und ob die Bestellung die Freigrenze überschreitet. Der Simulator zeigt Ihnen, was der Kunde für ein bestimmtes Land und einen bestimmten Betrag sehen wird.

Die Schätzung erscheint nicht auf der Produktseite

Prüfen Sie, ob die Option in den Einstellungen aktiv ist und mindestens ein Satz konfiguriert ist. Ohne Länderauswahl erscheint der Block nur, wenn das Land des Besuchers bekannt ist und außerhalb der EU liegt. Ein stark angepasstes Theme muss auf der Produktseite den Hook displayProductAdditionalInfo aufrufen, wie Classic und Hummingbird.

Ein befreites Produkt wird weiterhin belastet

Prüfen Sie die Prioritätsreihenfolge: Eine Produktregel hat Vorrang vor einer Kategorieregel, und eine Regel für das Land hat Vorrang vor einer Regel „alle Ziele“. Der Simulator zeigt mit ausgewähltem Produkt die Herkunft jedes Satzes.

Gilt ein Gutschein auch für die Gebühren?

PrestaShop behandelt die Gebührenposition wie ein Produkt: Ein prozentualer Gutschein auf die gesamte Bestellung reduziert auch die Gebühren, und die Position zählt zum Mindestbestellwert. Der in der Bestellung gespeicherte Betrag ist der tatsächlich eingenommene Nettobetrag.

Ändert der kostenlose Versand ab einem Bestellwert die Berechnung?

Wenn die Gebührenposition den Schwellenwert für kostenlosen Versand überschreiten lässt, wird der Transport weiterhin im Zollwert berücksichtigt (letzte bekannte Kosten für diesen Versanddienstleister), damit die Gebühren stabil bleiben.

Der Betrag scheint bei mehreren Währungen falsch zu sein

Pauschalgebühren und Freigrenzen werden in der Standardwährung erfasst und dann anhand Ihrer Wechselkurse umgerechnet. Prüfen Sie, ob diese Kurse aktuell sind.

Muss ich bei DDP anders versenden?

Ja: Wählen Sie bei Ihrem Versanddienstleister oder Spediteur einen DDP-Service. Der Lieferschein erinnert den Kommissionierer daran. Das Modul übernimmt das Einziehen der Beträge und die Information, nicht die Zollanmeldung.

Was passiert bei der Deinstallation?

Bei der Deinstallation werden die Hooks, die Konfiguration, die Tabellen des Moduls und das Gebührenprodukt entfernt. Es bleiben keine Restdaten in der Datenbank.