# Artikelankauf | Ankauf von Kundenware mit eigenem Verkaufskorb und Formelpreis

> Ankauf ohne E-Mail-Pingpong: Deine Kunden verkaufen dir Artikel über einen eigenen Verkaufskorb, zum Formel- oder Festpreis, mit Eigentumserklärung im Checkout.

Quelle: https://www.bui-hinsche.com/plugins/artikelankauf
Anbieter: BuI Hinsche GmbH, Zeitz (Shopware Extension Partner)

- System: Shopware 6
- Verfügbarkeit: bald im Shopware Community Store, noch kein Preis
- Kompatibel mit: Shopware 6.7.11 und neuer
- Handbuch: https://www.bui-hinsche.com/dokumentation/artikelankauf
- Demo-Shop: https://sw6plugindemo.bui-demo.com

## Funktionen

- Ankaufspreis auf der Produktseite, im Listing und in Produkt-Slidern
- Preis per Formel aus Netto-Verkaufspreis (x), Einheiten (b) und Währungsfaktor (y)
- Prozentualer und absoluter Aufschlag, Mindest- und Höchstpreis je Ankauf-Regel
- Rundungsregeln nach Preisgrenzen, nur für ausgewählte Kundengruppen
- Festpreis-Ankauf über den erweiterten Preis der Ankauf-Regel, ganz ohne Formel
- Neue Option „Artikelankauf“ für die Positionstyp-Bedingung im Rule Builder
- Eigener Verkaufskorb mit Rückfrage beim Wechsel zwischen Einkauf und Verkauf
- Maximaler Bestand und maximale Ankaufmenge pro Warenkorb je Artikel
- „Nur Ankauf“ blendet bei reinen Ankaufartikeln den normalen Kaufbereich aus
- „Verkauf anfragen“ öffnet das Kontaktformular mit Artikelname, Produktnummer und Menge im Betreff
- Pflicht-Eigentumserklärung im Checkout, auf dem Server geprüft
- Lieferadresse automatisch aus der Standard-Lieferadresse eines festgelegten Kunden
- Ankauf-Bestellungen tragen das Zusatzfeld „Ankaufstatus“
- Kategorie-Einstellungen per Klick auf alle Artikel der Kategorie übernehmen
- Schalter pro Verkaufskanal, Texte auf Deutsch, Englisch und Niederländisch

## Auf einen Blick

- Ankaufpreise rechnen sich per Formel, kein Nachrechnen von Hand
- Eigener Verkaufskorb, Kaufen und Verkaufen mischen sich nie
- Du kaufst nur bis zum Höchstbestand, dein Lager läuft nicht über
- Ohne Eigentumserklärung keine Verkaufsanfrage, serverseitig geprüft
- Pro Verkaufskanal schaltbar, Ankauf nur dort, wo du ihn willst

Kennst du das? Ein Kunde will dir zwanzig Silbermünzen verkaufen. Er schreibt eine E-Mail, du rechnest einen Preis aus, schickst ein Angebot, er fragt nach der Adresse, du schickst sie hinterher. Bis der Ankauf steht, vergehen Tage und ein halber Posteingang.

### Das Problem
In vielen Shops läuft der Ankauf neben dem Shop her: per E-Mail, Telefon oder Kontaktformular. Du rechnest jeden Preis von Hand, schickst jede Lieferadresse einzeln raus und notierst Zusagen irgendwo. Ankauf per Postfach ist kein Prozess, sondern Handarbeit. Dein Kunde sieht vorher nicht, was er für seine Ware bekommt, also fragt er oft gar nicht erst.

### Die Lösung
Das Plugin holt den Ankauf in deinen Shop. Am Artikel steht der aktuelle Ankaufspreis, darunter der Button „Artikel jetzt verkaufen“. Der Kunde legt seine Ware in einen eigenen Verkaufskorb, bestätigt im Checkout die Eigentumserklärung und stellt die Verkaufsanfrage. Bei dir kommt eine ganz normale Shopware-Bestellung an, als Ankauf gekennzeichnet.

### Was du davon hast
**Preise, die sich selbst rechnen.** Pro Artikel hinterlegst du eine Formel, zum Beispiel x * 0.6 für 60 Prozent deines Netto-Verkaufspreises. Aufschläge, Mindest- und Höchstpreis und Rundungsregeln greifen automatisch, und wenn sich dein Verkaufspreis ändert, zieht der Ankaufpreis mit.

**Festpreis, wenn du keine Formel brauchst.** Schalte am Artikel „Berechnung aktiv“ aus und trag den Ankaufpreis in den erweiterten Preis der Ankauf-Regel ein. Mehr ist nicht zu tun.

**Kein Durcheinander zwischen Kaufen und Verkaufen.** Angebotene Ware landet im Verkaufskorb, nie zusammen mit Einkäufen. Bevor der Warenkorb die Richtung wechselt, fragt der Shop nach, damit niemand ungewollt seine Auswahl verliert.

**Du kaufst nur, was du brauchst.** Mit „Maximaler Bestand“ endet der Ankauf, sobald dein Lager voll ist. „Maximale Ankaufmenge pro Warenkorb“ begrenzt, wie viel ein Kunde auf einmal anbieten kann.

**Jeder Ankauf mit Eigentumserklärung.** Ohne Häkchen bei der Eigentumserklärung geht keine Verkaufsanfrage raus. Das Plugin prüft das auf dem Server, nicht nur im Browser, und setzt als Lieferadresse automatisch die Adresse, die du hinterlegt hast.

**Ankauf auf Anfrage für Einzelstücke.** Wo erst der Zustand den Preis bestimmt, zeigst du statt eines Preises den Button „Jetzt Verkauf anfragen“. Dein Kontaktformular öffnet sich, im Betreff stehen schon Artikelname, Produktnummer und Menge.

### So arbeitet das Plugin
- Im Rule Builder legst du eine Regel an, die auf den Positionstyp „Artikelankauf“ prüft. Diese Ankauf-Regel trägt in den erweiterten Preisen deines Artikels den Ankaufpreis oder die Formel samt Aufschlägen und Mindest- und Höchstpreis.
- Am Artikel steuert das Zusatzfeld-Set „Artikelankauf“ den Rest: „Berechnung aktiv“, „Anzahl an Einheiten“, „Maximaler Bestand“, „Maximale Ankaufmenge pro Warenkorb“, „Nur Ankauf“ und „Verkauf anfragen“.
- In der Formel steht x für den Netto-Verkaufspreis des Artikels, b für die Anzahl an Einheiten und y für den Währungsfaktor.
- Die Storefront zeigt den Ankaufspreis auf der Produktseite, im Listing und in Produkt-Slidern.
- Der Button „Einstellungen auf Artikel übernehmen“ in den Zusatzfeldern einer Kategorie überträgt „Berechnung aktiv“ und „Nur Ankauf“ auf alle Artikel dieser Kategorie.
- In der Plugin-Konfiguration schaltest du den Ankauf je Verkaufskanal ein und legst Rundungsregeln, die Kundengruppen mit Rundung und die Kundennummer für die Ankauf-Lieferadresse fest.

### Typische Einsatzszenarien
**Edelmetallhandel.** Du verkaufst Silbermünzen und kaufst sie zurück. Die Formel x * 0.9 setzt den Ankauf auf 90 Prozent des Netto-Verkaufspreises, die Rundung macht glatte 50-Cent-Beträge daraus, und bei 200 Stück im Lager ist Schluss. Dein Kunde schickt die Münzen per DHL an dein Lager, denn die Lieferadresse setzt das Plugin aus deiner Konfiguration.

**Gebrauchte Technik.** Ein Shop für generalüberholte Smartphones kauft Altgeräte an. Jedes Modell bekommt einen festen Ankaufpreis über die Ankauf-Regel, und „Nur Ankauf“ blendet bei reinen Ankaufartikeln den normalen Kaufbereich aus.

**Sammlerstücke.** Bei Uhren, Kameras oder Antiquitäten entscheidet der Zustand. „Verkauf anfragen“ schickt dir die Anfrage über dein Kontaktformular, mit Artikelname, Produktnummer und Menge im Betreff. Den Preis nennst du nach der Begutachtung.

**Ankauf nur für Endkunden.** Im Endkunden-Verkaufskanal läuft der Ankauf, im Händlerkanal bleibt er aus. Dafür reicht der Schalter in der Plugin-Konfiguration.

### Technische Fakten für deine IT
- Shopware ab 6.7.11, PHP ab 8.2.
- Keine eigenen Datenbanktabellen, die Shopware-Originaltabellen bleiben unverändert. Alle Werte liegen in Zusatzfeldern an Produkt, erweitertem Preis, Kategorie und Bestellung sowie in der Plugin-Konfiguration. Ankauf-Bestellungen tragen das Zusatzfeld „Ankaufstatus“.
- Das Plugin sendet keine Daten an externe Server. Für die Formelauswertung installiert Shopware bei Installation und Update per Composer die Bibliothek denissimon/formula-parser (MIT-Lizenz). Dafür braucht dein Server in diesem Moment Composer und Internetzugang.
- DSGVO: Ankäufe sind normale Shopware-Bestellungen. Das Plugin legt keine zusätzlichen personenbezogenen Daten an. Die Eigentumserklärung prüft es vor dem Absenden, als eigenes Feld gespeichert wird sie nicht.
- Performance: Die Ankaufpreise lädt die Storefront per Ajax nach, im Listing mit einer Anfrage für alle Artikel der Seite. So bleiben sie trotz HTTP-Cache aktuell.
- Headless: Die Store-API-Route POST /store-api/swp-purchase-articles/price liefert Ankaufpreis, Verfügbarkeit und Mengengrenzen, etwa für Composable Frontends. Die Storefront nutzt dieselbe Route.
- Der Konsolenbefehl swp:purchase-articles:update-prices schreibt die berechneten Ankaufpreise in Paketen zu 250 Artikeln in die erweiterten Preise, etwa für Auswertungen. Den Cronjob dafür richtest du selbst ein.
- Rechte: Die Übernahme der Kategorie-Einstellungen verlangt Bearbeitungsrechte für Kategorien und Produkte.
- Deinstallation: Behältst du die Plugin-Daten nicht, entfernt das Plugin seine Zusatzfeld-Sets. Die Ankauf-Regel und die erweiterten Preise legst du selbst an, sie bleiben stehen, bis du sie löschst.

### Hinweise
Du richtest den Ankauf dort ein, wo du in Shopware ohnehin arbeitest: in den Zusatzfeldern am Artikel, im Rule Builder und in der Plugin-Konfiguration. Für die erste Formel nimmst du dir am besten etwas Zeit und probierst sie an einem Artikel aus, bevor du das ganze Sortiment umstellst.

## Häufige Fragen

### Brauche ich ein weiteres Plugin für die Ankaufpreise?
Nein. Die Formel rechnet mit deinem Netto-Verkaufspreis, den Einheiten und dem Währungsfaktor.

### Kann ich einen festen Ankaufpreis statt einer Formel nutzen?
Ja. Schalte am Artikel „Berechnung aktiv“ aus und trag den Preis in den erweiterten Preis der Ankauf-Regel ein. Formel, Aufschläge, Mindest- und Höchstpreis und Rundung greifen dann nicht.

### Kann ein Kunde in einem Warenkorb gleichzeitig kaufen und verkaufen?
Nein, ein Warenkorb ist entweder Einkauf oder Verkauf, so bleiben beide sauber getrennt. Legt der Kunde etwas aus der anderen Richtung hinein, fragt der Shop vorher, ob die bisherigen Positionen entfernt werden sollen.

### Zahlt das Plugin den Ankaufbetrag an meinen Kunden aus?
Nein, Wareneingang, Prüfung und Auszahlung, etwa per Überweisung, organisierst du selbst. Das Plugin liefert dir dafür die Verkaufsanfrage als Bestellung mit Ankaufpreisen.

### Funktioniert das mit meinem Theme?
In der Regel ja. Das Plugin erweitert die Standard-Blöcke der Shopware-Storefront für Kaufbereich, Produktkarte, Warenkorb und Checkout. Ersetzt dein Theme genau diese Bereiche komplett, kann dort eine Anpassung nötig sein. Teste das vor dem Livegang.

### Kann ich den Ankauf nur in einem Verkaufskanal anbieten?
Ja. In der Plugin-Konfiguration schaltest du „Plugin für diesen Verkaufskanal aktivieren“ je Kanal ein oder aus. Rundungsregeln und Ankauf-Lieferadresse stellst du ebenfalls pro Kanal ein.

### Funktioniert der Ankauf auch headless über die Store API?
Ja. Die Store-API-Route POST /store-api/swp-purchase-articles/price liefert Ankaufpreis, Verfügbarkeit und Mengengrenzen für bis zu 100 Artikel je Anfrage, der Verkaufskorb läuft über die normale Warenkorb-Route der Store API. Die Anzeige im Headless-Frontend baust du mit diesen Daten selbst.

### Macht das Plugin meine Kategorieseiten langsamer?
Die Seite selbst nicht, sie bleibt im HTTP-Cache. Die Ankaufpreise lädt das Plugin danach mit einer zusätzlichen Anfrage pro Listing-Seite nach und rechnet sie dabei live. Bei vielen Artikeln pro Seite dauert diese Anfrage entsprechend länger.

### Sendet das Plugin Daten an externe Dienste?
Nein. Alle Einstellungen und Ankäufe bleiben in deiner Shopware-Datenbank. Nur bei Installation und Update lädt Shopware per Composer die Formel-Bibliothek nach.

### Was passiert bei der Deinstallation mit meinen Daten?
Behältst du die Plugin-Daten, bleibt alles erhalten. Sonst entfernt das Plugin seine Zusatzfeld-Sets, deine Ankauf-Regel, die erweiterten Preise und die Bestellungen bleiben bestehen.
