Meterware, Artikel verkaufen nach Einheit, freier Menge, Länge, Gewicht, lose Ware, Dezimalstelle

Installieren & Konfigurieren

1. Plugin über Plugin-Store installieren
2. Aktivierung des Features pro Artikel durch Auswahl der Checkbox "Einheiten-Artikel" im Stammdaten-Tab des Artikels
3. Im Stammdaten-Tab gibt es unten einen Bereich "Konfiguration Einheiten-Artikel", dort kann der Artikel konfiguriert werden:
   • Bezeichnung - z.B. Länge, Höhe, Volumen. Erscheint überall wo die ausgewählte Maßeinheit angezeigt wird als Bezeichnung.
   • Maßeinheit - z.B. m, kg, t, cm, mm
   • Min. Einheit und Max. Einheit - so kann z.B: festgelegt werden dass nur Waren zwischen 1 und 6 Meter gekauft werden können. DEzimalzahlen sind möglich, z.B. 0,5 bis 4,6 Meter
   • Schrittgröße - definiert die erlaubten Zwischenschritte. Wenn Waren nur in 0,5 Meter-Schritten verkauft werden sollen, kann hier eine Schrittgröße von 0,5 eingetragen werden
   • Standardwert - der Wert, der beim Aufruf der Produktdetailseite als Vorauswahl angezeigt wird. Muss im erlaubten Bereich liegen und zur Schrittgröße passen
   • Grundeinheit - Dieser Wert muss dem Wert des Artikelpreises entsemchen. Wenn z.B: Meterware verkauft wird und der im Artikel hinterlegte Preis sich auf 1 m bezieht, muss hier 1 eingetragen werden
   • Gewichtsberechnung - Bei Aktivierung wird Basisgewicht des Artikels (pflegbar in den Artikel-Stammdaten) zur Berechnung des tatsächlichen Gewichts (abhängig von der Einheit) verwendet. Das Gesamtgewicht kann in der Bestellübersicht eingesehen werden und über das Attribut "sOrder.attributes.neon_unitarticle_totalweight" z.B. in Rechnungen und Bestell-E-Mails ausgelesen werden, zudem steht für das Feld "Eigene Berechnung" in den Versandkosten der Wert ba.neon_unitarticle_weight zur Verfügung, statt d.weight
   • Preise nicht berechnen - Wenn angehakt, wird der Artikelpreis NICHT auf Basis der gewählten Einheit berechnet. Sinnvoll, wenn die Einheit nur als Maßeinheit übertragen werden soll, diese Angabe sich aber nicht auf den Artikelpreis auswirkt.
   • Schritte beginnen bei Mindestwert - Falls angehakt, beginnt die Schrittgröße beim eingestellten Mindestwert. Wenn abgehakt, beginnt die Schrittberechnung bei 0.
   • Grundeinheiten-Anzeige überschreiben - Falls angehakt, werden die Grundeinheitenlabels in Listing-Boxen aus der Einheitenkonfiguration übernommen
   • Grundpreis auf der Artikeldetailseite anzeigen - Wenn aktiv, wird der Grundpreis auf der Artikeldetailseite unterhalb des preises angezeigt
   • Ausgeschlossene Schritte - Um bspw. unrentable Längen nicht zu verkaufen, können Sie hier kommagetrennt Werte eintragen, die nicht gekauft werden können
   • Rabattierte Schritte - Um bestimme Längen zu rabattieren, können Sie hier kommagetrennt Werte eintragen, die rabattiert werden sollen. Den Rabatt tragen Sie bitte in das Feld "Rabatt" ein
   • Rabatt in % - Definieren Sie hier den Rabatt in Prozent für die oben angebenenen Werte. Ohne Prozentzeichen angeben!

Attributübersicht / Übersicht der Einstellungen pro Artikel

Das Plugin erlaubt es, pro Artikel die Einheitenkonfiguration durchzuführen. Falls alle Artikel die gleichen Attribute bekommen sollen oder ein Großteil der Artikel, kann die Konfiguration natürlich auch direkt über die Datenbank erfolgen. Im folgenden Abschnitt sind alle relevanten Attribute aufgelistet (Fett = Pflichtfeld):

• s_articles_attributes.neon_unitarticle_isunitarticle | Kennzeichung, ob Einheitenartikel (in den Artikel-Stammdaten)
• s_articles_attributes.neon_unitarticle_description | Bezeichnung der Einheit, z.B. Länge, Gewicht, etc.
• s_articles_attributes.neon_unitarticle_unit | Maßeinheit: m, cm, l, kg, dm, mm, etc.
• s_articles_attributes.neon_unitarticle_minvalue | kleinste bestellbare Einheit, z.B. 1
• s_articles_attributes.neon_unitarticle_maxvalue | größte bestellbare Einheit, z.B. 100
• s_articles_attributes.neon_unitarticle_stepsize | Definiert die erlaubten Zwischenschritte. Wenn Waren nur in 0,3 Meter-Schritten verkauft werden sollen, kann hier eine Schrittgröße von 0,3 eingetragen werden
• s_articles_attributes.neon_unitarticle_defaultvalue | initial angezeigte Einheit (z.B. 10)
• s_articles_attributes.neon_unitarticle_basepricevalue | Einheitenwert des Artikel-Grundpreises (z.B. 1, wenn der Preis in den Stammdaten sich auf Einheit 1 bezieht)
• s_articles_attributes.neon_unitarticle_isweightcalcactive | mögliche Werte: 1 oder 0; Wenn 1, wird Basisgewicht des Artikels (pflegbar in den Artikel-Stammdaten) zur Berechnung des tatsächlichen Gewichts verwendet. Das Gesamtgewicht kann in der Bestellübersicht eingesehen werden und über das Attribut "sOrder.attributes.neon_unitarticle_totalweight" z.B. in Rechnungen und Bestell-E-Mails ausgelesen werden.
• s_articles_attributes.neon_unitarticle_ispricecalculationdisabled | Mögliche Werte: 1 oder 0; Wenn 1, wird der Artikelpreis NICHT auf Basis der gewählten Einheit berechnet. Sinnvoll, wenn die Einheit nur als Maßeinheit übertragen werden soll, diese Angabe sich aber nicht auf den Artikelpreis auswirkt.
• s_articles_attributes.neon_unitarticle_isstepsizebaseminvalue | Mögliche Werte: 1 oder 0; Wenn 1, beginnt die Schrittgröße beim eingestellten Mindestwert. den Artikelpreis auswirkt.
• s_articles_attributes.neon_unitarticle_overwrite_referenceunit_in_listing_boxes | Mögliche Werte: 1 oder 0; Wenn 1 werden die Grundeinheitenlabels in Listing-Boxen aus der Einheitenkonfiguration übernommen
• s_articles_attributes.neon_unitarticle_showbasepriceondetailpage | Mögliche Werte: 1 oder 0; Wenn 1, wird der Grundpreis auf der Artikeldetailseite unterhalb des preises angezeigt
• s_articles_attributes.neon_unitarticle_discount | z.B. "10" für 10 %, Definieren Sie hier den Rabatt in Prozent für die bei 'neon_unitarticle_discount_values' angebenenen Werte. Ohne Prozentzeichen angeben angezeigt
• s_articles_attributes.neon_unitarticle_discount_values | abattierte Werte, z.B. 100, 200, 300. Mehrere Werte kommagetrennt. Den Rabatt bitte in das Feld "neon_unitarticle_discount" eintragen
• s_articles_attributes.neon_unitarticle_excluded_values | Ausgeschlossenen Werte, z.B. 100, 200, 300. Um bspw. unrentable Längen nicht zu verkaufen, können hier kommagetrennt Werte eintragen, die nicht gekauft werden können
• s_articles_attributes.neon_unitarticle_hide_quantity | Wenn diese Feld ausgewählt ist, kann die verkaufte Einheit vom Lagerbestand abgezogen werden. Bitte beachten: Das Artiklmenge-Auswahlfeld wird in diesem Modus entfernt. Bitte beachten Sie unbedingt die Hinweis zur Konfiguration der Lagerbestandsaktualisierung
• s_articles_attributes.neon_unitarticle_unit_to_stock_factor | z.B. 10, wenn Lagerbestand in dm und Verkauf in Meter; Lagerbestand muss in Shopware immer eine Ganzzahl sein. Daher ist diese Einstellung notwendig. Beispiel: Sie verkaufen in Meter, in 0,5 Meter Schritten. Dann kann Ihr Lagerbestand z.B. in Dezimeter gepflegt werden. Der Faktor wäre dann 10 (1 Meter entspricht 10 dm).
• s_articles_attributes.maxpurchase | Wenn Lagerbestandsabgleich aktiviert ist, bitte Wert 4294967295 eintragen, damit das shopwareinterne Standard-Limit von 100 verkaufbaren Einheiten aufgehoben wird

Einstellungen für alle Attribute übernehmen

Gerne unterstützen wir Sie bei der Erstellung eines Datenbank-Skripts zur Übernahme von Artikelattributen als Massenverarbeitung.

Attributübersicht / Übersicht der Attribute pro Warenkorbposition

• s_order_basket_attributes.neon_unitarticle_length - gewählte Einheit des Kunden, z.B. 100 oder 1,2
  
• s_order_basket_attributes.neon_unitarticle_unit - Einheit, z.B. m oder cm
  
• s_order_basket_attributes.neon_unitarticle_description - Label, z.B. Länge
  
• s_order_basket_attributes.neon_unitarticle_weight - berechnetes Gewicht der Position (Einheit x Anzahl)

Attributübersicht / Übersicht der Attribute pro Bestellposition

• s_order_details_attributes.neon_unitarticle_length - gewählte Einheit des Kunden, z.B. 100 oder 1,2
  
• s_order_details_attributes.neon_unitarticle_unit - Einheit, z.B. m oder cm
  
• s_order_details_attributes.neon_unitarticle_description - Label, z.B. Länge
  
• s_order_details_attributes.neon_unitarticle_weight - berechnetes Gewicht der Position

Lagerbestandsaktualisierung

Die Warenbestandsaktualisierung wird unterstützt. Dazu wird das Mengenfeld ausgeblendet. Wenn Sie die Option zur Lagerbestandsaktualisierung auswählen, wird das Mengenfeld ausgeblendet und die eingegebene Länge/Gewicht, also die Einheit, wird als Stückzahl behandelt. Über einen Faktor kann bestimmt werden, dass der Lagerbestand in einer kleineren Maßeinheit gepflegt wurde. Dadurch wird es möglich, z.B. Artikel in Meter mit Kommastelle zu verkaufen. Dazu muss der Lagerbestand in Dezimetern angegeben werden. Der Faktor für dieses Szenario wäre dann 10.

Wichtige Einstellungen bei der Warenbestandsaktualisierung

1. Bitte tragen Sie beim Artikel > Stammdaten > Maximale Abnahmemenge (Datenbank: s_articles_details.maxpurchase) den Wert 4294967295 ein. Dadurch wird sichergestellt, dass die maximale Abnahme durch den in der Einheiten-Konfiguration eingestellten Wert abgedeckt ist
2. Aktivieren Sie den Abverkauf, wenn Lagerbestand < 0 nicht möglich sein soll
3. Geben Sie den Lagerbestand in der kleinsten Einheit ein, die Sie verkaufen möchten, also z.B. in Dezimeter
4. Geben Sie die preise für die passende Einheit ein - in diesem Beispiel Preis pro Dezimeter - das Plugin rechnet diesen Preis um
5. Falls im Frontend immer der Lagerbestand als maximal möglicher Wert angezeigt werden soll, muss in der Einheiten-Konfiguration bei Max. Einheit (Attribut: s_articles_details.neon_unitarticles_maxvalue) der Wert 4294967295 eingetragen werden

Einheitenangaben in Rechnung, Lieferschein, Gutschrift einfügen

Falls, durch andere Plugins oder Theme-Anpassungen, bedigngt die Einheitenangaben nicht in den PDF-Dokumenten erscheinen, kann die Date documents/index.tpl mit diesem Code erweitert werden. Z.B. Nach dem Artikelname:

{if $position.attributes.neon_unitarticle_length} {$position.attributes.neon_unitarticle_description}: {$position.attributes.neon_unitarticle_length} {$position.attributes.neon_unitarticle_unit}
{/if}

Einheitenangaben in E-Mail Template einfügen

1. Einstellungen > E-Mail Vorlagen
2. Dort das gewünschte Mail-Template auswählen, z.B. sORDER für die Bestellbestätigung
3. Die Code-Ausschnitte unten an gewünschter Stelle einfügen, z.B. nach dem Artikelname (wie unten zu sehen)

für HTML-Mails

suchen nach:

{$details.articlename|wordwrap:80|indent:4}

ersetzen durch:

für Plaintext-Mails

suchen nach:

{$details.articlename|wordwrap:80|indent:4}

ersetzen durch:

für HTML-Mails & Plaintext-E-Mails

suchen nach:

ersetzen durch:

suchen nach:

ersetzen durch:

ab Showpare 5.5: Versandkostenberechnung

1. nach Gewicht

Um die Shopware-Standardberechnung nach Gewicht zu nutzen, muss bei einem Einheiten-Artikel die Checkbox "Gewichtsberechnung" gesetzt sein. Dadurch wird das reale Gewicht einer Bestellposition unter Berücksichtigung der gewählten Einheit berechnet. Um dieses Gewicht nutzen zu können, muss unter Einstellungen > Versandkostenkonfiguration folgender Eintrag ergänzt werden: "SUM(IF(ba.neon_unitarticle_weight IS NULL, d.weight * b.quantity, ba.neon_unitarticle_weight)) AS weight". In ba.neon_unitarticle_weight steht das berechnete Gewicht x der Anzahl des Produkts.

2. nach Einheit

Falls Versandkosten anhand einer gewählten Einheit berechnet werden sollen, kann das über das Feld "Eigene Bedingungen" in den Versandkosten erfolgen. Dort steht der Parameter neonUnitarticlesMaxUnitValue  zur Verfügung. Dieser Parameter beinhaltet die längste/größte Einheit einer Bestellung. Wenn z.B. 3 Stangen gekauft wurden mit 50cm, 100 cm und 200 cm und ab 150 cm soll eine bestimmte Versandkostenregel greifen, sollten folgende Einstellungen vorgenommen werden:

Eigene Bedingung:
neonUnitarticlesMaxUnitValue >= 150
Mehr Informationen zur Versandkostenberechnung sind in der Shopware-Doku zu finden: https://community.shopware.com/Individuelle-Versandkosten-Bedingungen-und-Berechnungen_detail_1933.html

Produktfeed-Anpassungen

Falls der Lagerbestandsabgleich aktiviert wurde, sollte in den Produktfeeds die Preisangabe so eingegebene werden:

{if $sArticle.neon_unitarticle_hide_quantity}
    {($sArticle.price * $sArticle.neon_unitarticle_unit_to_stock_factor)|format:"number"}
{else}
    {$sArticle.price|format:"number"}
{/if}