PORTAL und PPS Knowledge Base

Mitwirkungspflichten: Kleinanzeigen-Modul

Das ist ein aktivierbares Zusatzmodul vom PEIQ PORTAL.

Beschreibung

Vor dem Set-up des Kleinanzeigen-Moduls sind folgenden Informationen in einem Dokument bereitzustellen:

  1. Definition der berechtigten Inserenten

  2. Definition des Modus

  3. Typen für Kleinanzeigen

  4. Kategorien für Kleinanzeigen

  5. Definition der Printprodukte (nicht bei online-only)

  6. Anlieferung des Preismodells

  7. Angaben & Texte im Panel zur Preisinformation

  8. Definition der zustimmungspflichten Dokumente

  9. Auswahl bzgl. Abrechnung / Bezahlung

  10. Angaben bzgl. E-Mail-Benachrichtigung bei Verifikation von Kleinanzeigen

  11. E-Mail-Text bei Auftragsbestätigung

Beispiel

Mitwirkungspflicht

Mitwirkung des Kunden

Mitwirkungspflicht

Mitwirkung des Kunden

Definition der berechtigten Inserenten

nur registrierte, berechtigte Benutzer:innen

Definition des Modus

Online-Only-Modus

Typen für Kleinanzeigen

  • zwei Typen:
    1. Die Gute Tat
    2. Verkaufen, vermieten, suchen

Kategorien für Kleinanzeigen

siehe angeliefertes JSON

Definition der Printprodukte (nicht bei online-only)

-

Anlieferung des Preismodells

Anlieferung des Preismodells pro Typ:

  • Die Gute Tat:

    • kostenlos (Preis pro Zeile/Zeichen: 0€)

  • Verkaufen, vermieten, suchen:

    • Zeilenlänger 1. Zeile: 20 Zeichen

    • Preis für erste Zeile: 3,00 €

    • Standard-Zeilenlänge: 30 Zeichen

    • Standard-Preis pro Zeile: 2,50 €

Definition Preisaufschlag pro Anzahl der Produkte: keinen

Definition Optionen-Block für Print-Ausgabe:

  • Chiffre: 5,00 €

  • Abdruck mit Bild: 3,00 €

Definition Mengenrabatt nach Ausgaben / Erscheinungswoche: keinen

Angaben & Texte im Panel zur Preisinformation

Hinweise zur Anzeigenaufgabe:

Mit diesem Formular können Sie Ihre private Kleinanzeige online aufgeben.

Bitte beachten Sie:
- Mit einem *-Zeichen gekennzeichnete Felder sind Pflichtfelder.

- Der Anzeigenpreis kann aufgrund notwendiger, durch uns hinzugefügte Zeichen, um 2,00 Euro variieren.

Sie können auch ein Bild mit Ihrer Anzeige veröffentlichen. Hierbei sind das Dateiformat .jpg und die maximale Dateigröße von 1 MB zu beachten.

Damit Ihre Kleinanzeige auch den gewünschten Erfolg erzielen kann, vermerken Sie bitte unbedingt Ihre Telefonnummer oder E-Mail-Adresse am Ende des Kleinanzeigentextes.

 

  • Anzeige der Preiszusammensetzung: aktiviert

  • Mehrwertsteuersatz: 19%

Definition der zustimmungspflichten Dokumente

  • AGB: /s/agb

  • Widerrufsbelehrung: /s/widerruf

Auswahl bzgl. Abrechnung / Bezahlung

Manuelle Statusänderung: manuelle Freigabe

Angaben bzgl. E-Mail-Benachrichtigung bei Verifikation von Kleinanzeigen

  • Feature aktivieren

  • E-Mail-Adresse: anzeigen@example.com

E-Mail-Text bei Auftragsbestätigung

Standard-Text übernehmen

 


1. Definition der berechtigten Inserenten

Mitwirkung

Definition, wer Kleinanzeigen inserieren darf:

nur registrierte, berechtigte Benutzer:innen
Benutzer:innen & anonyme Besucher:innen (E-Mail-Adresse erforderlich)

Standard-Werte

Empfohlen: nur registrierte, berechtigte Benutzer:innen


2. Definition des Modus

Das Kleinanzeigen-Modul kann in drei Modi betrieben werden:

  • Online-Only-Modus: Anzeigen werden nur online abgebildet

  • Online mit Print-Option: Anzeigen können optional zur Online-Aufgabe in vordefiniertem/n Printprodukt(en) abgedruckt werden

  • Print- & Online-Modus: Anzeigen müssen neben der Online-Erscheinung in vordefiniertem/n Printprodukt(en) abgedruckt werden

Beispiele

Online-Only-Modus

 

Print- & Online-Modus

 

 

Mitwirkung

Definition des Modus:

Online-Only-Modus
Online mit Print-Option
Print- & Online-Modus

3. Typen für Kleinanzeigen

Es können bis zu zwei Typen im Kleinanzeigenmarkt angelegt werden. Für jedem Typ lassen sich unterschiedliche Preismodelle (siehe unten) sowie Kategorien (siehe nächster Abschnitt definieren).

Beispiele

 

 

 

Mitwirkung

Anlieferung der Typen für Kleinanzeigen

nur 1 Typ (wird im Kleinanzeigenformular ausgeblendet
zwei Typen:
1. [Name Typ1]
2. [Name Typ2]

4. Kategorien für Kleinanzeigen

 

Die Definition der Kategorien ist ein grundlegender Punkt des Modul-Setups. Kategorien im Kleinanzeigenmarkt können in einer beliebigen JSON-Baumstruktur festgelegt werden.

Eine Kategorie kann wie folgt konfiguriert werden:

Category Objekt

name

angezeigter Name einer Kategorie

name_norm

Normalisierter Name. Dieser Wert wird auch zur Darstellung der Kategorie in der URL hergenommen. Dieser Wert muss im ganzen Dokument eindeutig sein.

advert_lifetime

Optional. Default: 30. Legt die Lebenszeit (in Tagen) einer Anzeige mit dieser Kategorie fest. Das expires Datum wird anhand dieses Wertes ermittelt und in der DB gespeichert.

service_fee

Optional. Default: false. Der Aufpreis, der bei der Kostenberechnung addiert wird, wenn eine Anzeige in dieser Kategorie erstellt wird. Der Aufpreis der Kategorie sowie aller Eltern-Kategorien wird addiert.

restricted

Optional. Default: 0. Legt fest, ob die Kategorie nur von Moderatoren oder Benutzern mit spezieller Berechtigung verwendet werden kann.

children

Optional. Eine Liste der Unter-Kategorien. Diese werden anhand der gleichen JSON Objekt-Struktur definiert (per Komma getrennt).

custom_fields

Optional. Eine Liste der Unter-Kategorien. Diese werden anhand der gleichen JSON Objekt-Struktur definiert (per Komma getrennt). Details siehe Tabelle Custom Field Objekt

custom_settings

Optional. Definiert spezielle Einstellungen für diese Kategorie. Details siehe Tabelle Custom Settings Objekt

Custom Field Objekt

name

Der Bezeichner für das Feld, der im Formular angezeigt wird.

type

Der Feld-Typ. Mögliche Werte sind number (Zahlenwert) und choice (Auswahl Liste).

options

Optional. Default: leeres Array. Konfiguration des Feldes.

  • required: Legt fest, ob das Feld ein Pflichtfeld ist.

  • choices: Legt die Auswahlmöglichkeiten beim Feld-Typ choice fest. Es kann entweder eine Value => Description Liste angegeben werden, oder eine automatisch generierte Monats- bzw. Jahresliste definiert werden (month_list | year_list)

  • placeholder: Legt den Platzhaltertext beim Feld-Typ choice fest.

Custom Settings Objekt

detail_fullsize_image

Optional. Legt fest, ob das Anzeigen-Bild in der Darstellung in voller Größe angezeigt werden soll (z.B. auf Detailseite).

hide_price

Optional. Legt fest, ob der Anzeigen-Preis in der Darstellung (Teaser, Detailseite, etc.) versteckt werden soll.

disable_price

Optional. Legt fest, ob die Preis-Felder price und pricemode im Formular deaktiviert werden sollen. Die Anzeige wird dann defaultmäßig auf kostenlos gesetzt. Diese Einstellung wirkt sich auf alle Unter-Kategorien aus, außer man setzt in einer Unter-Kategorie explizit einen anderen Wert.

exclude_types

Optional. Legt fest, für welche Anzeigen-Typen diese Kategorie ausgeschlossen werden soll (steht somit im Formular für den jeweiligen Typ nicht zur Auswahl). Diese Einstellung wirkt sich auf alle Unter-Kategorien aus. Anzeigen-Typen sind z.B. regular und commercial.

Beispiele

[ { "name": "Category 1", "name_norm": "category-1", "advert_lifetime": 30, "service_fee": 0, "restricted": true|false, "children": [], "custom_fields": [ { "name": "Custom Number", "type": "Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType", "options": { "required": true } }, { "name": "Custom Choice", "type": "Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType", "options": { "required": true, "choices": { "Description 1": "value 1", "Description 2": "value 2" }, "placeholder": "Placeholder Text" } }, { "name": "Year Choice", "type": "Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType", "options": { "choices": "year_list", "placeholder": "Choose Year" } }, { "name": "Month Choice", "type": "Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType", "options": { "choices": "month_list", "placeholder": "Choose Month" } }, ], "custom_settings": { "detail_fullsize_image": true, "hide_price": true, "disable_price": true, "exclude_types": [ "commercial" ] } } ]

 

Typ

Kategorie

Preis- aufschlag

Berechtigung erforderlich

Benutzerdefinierte Felder

Pflichtfeld

Eingabemöglichkeiten

Typ

Kategorie

Preis- aufschlag

Berechtigung erforderlich

Benutzerdefinierte Felder

Pflichtfeld

Eingabemöglichkeiten

Die Gute Tat

Zu verschenken

0

nein

-

-

-

  • Bücher

0

nein

-

-

-

  • Kleidung & Schuhe

0

nein

-

-

-

  • Sonstiges

0

nein

-

-

-

Die Gute Tat

Zugelaufen / Zugeflogen

0

nein

Zugelaufen im (Monat)

ja

choice: month_list

Zugelaufen im (Jahr)

ja

choice: year_list

Verkaufen, vermieten, suchen

Flohmarkt

0

nein

-

-

-

  • Bücher

0

nein

-

-

-

  • Kleidung & Schuhe

0

nein

-

-

-

  • Sport & Outdoor

0

nein

Kleidergröße

ja

choice: list

  • XS

  • S

  • M

  • L

  • XL

  • XXL

  • XXXL

  • Kinder & Baby

0

nein

Kleidergröße

ja

number

  • Damen

0

nein

Kleidergröße

ja

choice: list

  • XS

  • S

  • M

  • L

  • XL

  • XXL

  • XXXL

  • Herren

0

nein

Kleidergröße

ja

choice: list

  • XS

  • S

  • M

  • L

  • XL

  • XXL

  • XXXL

  • Unisex

0

nein

Kleidergröße

ja

choice: list

  • XS

  • S

  • M

  • L

  • XL

  • XXL

  • XXXL

  • Schuhe

0

nein

Schuhgröße

-

number

Verkaufen, vermieten, suchen

Immobilien

0

nein

Typ

ja

choice:list

  • Haus

  • Eigentumswohnung

  • Geschäfts- & Gewerberflächen

  • Landwirtschaftliche Flächen

  • Sonstiges

Baujahr

ja

choice: year_list

Quadratmeter

ja

number

Anzahl Zimmer

nein

number

Energieausweis

ja

choice:list

  • Bedarfsausweis

  • Verbrauchsausweis

  • Mieten

0

nein

Die definierten Felder werden auf alle Unter-Kategorien durch vererbt

  • Kaufen

0

nein

Die definierten Felder werden auf alle Unter-Kategorien durch vererbt

  • Vermieten / Verpachten

5

nein

Die definierten Felder werden auf alle Unter-Kategorien durch vererbt

  • Verkaufen

10

nein

Die definierten Felder werden auf alle Unter-Kategorien durch vererbt

Mitwirkung

  • Anlieferung des Kategoriensystems als JSON oder in tabellarischer Form


5. Definition der Printprodukte (nicht bei online-only)

Beispiele

 

 

Mitwirkung

  • Anlieferung der Printprodukte

  • sofern Gruppierung erwünscht: Anlieferung der Printprodukte in gruppierter Form


6. Anlieferung des Preismodells

Die Preisberechnung kann auf Basis folgender Preismodelle erfolgen, die miteinander kombiniert werden können:

  • Preismodell in Bezug auf Zeichenanzahl oder Zeile

  • Preismodell pro Typ (z. B. gewerblich/ privat)

  • Aufpreis für eine bestimmte Kategorie (Angaben sind beim Kategoriensystem zu machen)

  • Pro Ausgabe

Extras:

  • Optionen-Block für Print-Ausgabe mit jeweils hinterlegtem Preis (z. B. Chiffre, Abdruck mit Bild)

  • Mengenrabattsystem (z. B. bei Veröffentlichung in mehreren Ausgaben)

Beispiele

Preismodell pro Zeichenanzahl bzw. Zeile

Beispiel 1 - Preismodell pro Zeichenzahl:

  • Preis pro Zeichen: 0,01 €

Beispiel 2 - Preismodell pro Zeile:

  • Zeilenlänge: 30 Zeichen

  • Preis pro Zeile: 2,50 €

Beispiel 3 - Preismodell pro Zeile, erste Zeile weniger Buchstaben (z. B. wegen Fettdruck):

  • Zeilenlänger 1. Zeile: 20 Zeichen

  • Preis für erste Zeile: 3,00 €

  • Standard-Zeilenlänge: 30 Zeichen

  • Standard-Preis pro Zeile: 2,50 €

Preismodell pro Typ

z. B. Typen: privat / gewerblich.

  • privat: Für private Kunden: 1,10 € pro Zeile inkl. MwSt.

  • gewerblich: Für gewerbliche Kunden: 8,45 € pro Zeile inkl. MwSt.

Preisaufschlag pro Anzahl der Produkte

z. B. 1 Produkt inklusive, 2 Produkte 2 €, jedes weitere Produkt plus 1 €

Preisaufschlag bei ausgewählten Kategorien.

Diese Angaben sind beim Kategoriensystem zu machen.

z. B. 5€ Gebühr für Anzeigen in der Immobilien-Kategorie “Vermieten”, 10€ Gebühr für Anzeigen in der Immobilien-Kategorie “Verkaufen”,

z. B.

  • Chiffre: 5,00 €

  • Abdruck mit Bild: 3,00 €

Mengenrabatt nach Ausgaben / Erscheinungswoche

z. B. 1 Woche kein Rabatt, 2 oder mehr Wochen 25 % Rabatt auf den Gesamtpreis

Mitwirkung

  • Anlieferung des Preismodells (pro Typ)

  • Definition Preisaufschlag pro Anzahl der Produkte

  • Definition Optionen-Block für Print-Ausgabe

  • Definition Mengenrabatt nach Ausgaben / Erscheinungswoche


7. Angaben & Texte im Panel zur Preisinformation

Beispiel

Mitwirkungen

Hinweise zur Anzeigenaufgabe

Die Hinweise zur Anzeigenaufgabe werden in allen Reitern angezeigt und müssen kundenseitig als Text angeliefert werden.

Anzeige der Preiszusammensetzung

aktiviert empfohlen
deaktiviert

Mehrwertsteuersatz

Der Mehrwertsteuersatz wird zu Anzeige des berechneten Mehrwertsteueranteils am Gesamtpreis verwendet und ist kundenseitig anzuliefern.


8. Definition der zustimmungspflichten Dokumente

Beispiel

Mitwirkung

Definition der zustimmungspflichten Dokumente & Anlieferung der Links

Die Dokumente werden kundenseitig über Statische Seiten gepflegt

z. B.

  • AGB: /s/agb

  • Widerrufsbelehrung: /s/widerruf

9. Auswahl bzgl. Abrechnung / Bezahlung

Weitere Informationen finden sich hier:

Bei einer manuelle Statusänderung wird kein Zahlungsworkflow abgebildet! Dieser muss kundenseitig implementiert / umgesetzt werden.

Mitwirkung

Bei Auswahl “Manuelle Statusänderung”

manuelle Freigabe
automatische Freigabe

Bei Auswahl “PayPal-Integration”

  • Erstellung eines Paypal Geschäftskunden Accounts

  • Anlieferung von API Credentials (für Sandbox Account zum Testen und Live-Konto)

    • E-Mail Adresse des Sandbox Accounts

    • Client ID

    • Secret

    • Anliefern einer E-Mail Adresse für Payment-Confirmation


10. Angaben bzgl. E-Mail-Benachrichtigung bei Verifikation von Kleinanzeigen

Weitere Informationen zum Feature finden sich hier:

Mitwirkung

  • Angabe zur Aktivierung des Features

  • sofern Aktivierung: Anlieferung der E-Mail-Adresse, an welche die E-Mail versendet werden soll


11. E-Mail-Text bei Auftragsbestätigung

Sobald der oder die Benutzer:in auf “kostenpflichtig bestellen" klickt, wird per Mail eine Auftragsbestätigung bzw. Eingangsbestätigung gesendet. Der Text ist kundenspezifisch konfigurierbar und wird beim Setup der Kleinanzeigen festgelegt. Neben der Bestätigung zum Eingang der Kleinanzeige werden in der E-Mail auch die Angaben zur Kleinanzeige aufgelistet.

Mitwirkung

  • Anlieferung des E-Mail-Textes bei Auftragsbestätigung

Standard-Text

Betreff: Auftragsbestätigung - Ihre Kleinanzeige Nr. {id} auf {PORTALNAME}

Sehr geehrte/r {Vorname aus Rechnungsadresse} {Nachname aus Rechnungsadresse}, vielen Dank für Ihre Bestellung Ihre Kleinanzeige {Titel der Kleinanzeige} Nr. {id der Kleinanzeige}. Bestelldetails: Kleinanzeige {Titel der Kleinanzeige} Nr.: {id der Kleinanzeige} Veröffentlichung: {Online / Online & Print} Laufzeit: x Wochen Preisinformation {Preiszusammensetzung} {Gesamtpreis} davon Mehrwertsteuer (x Prozent): {Betrag €} Ihre Kleinanzeige {url zur detailseite} Um Ihre Kleinanzeige zu bearbeiten oder zu löschen, melden Sie sich auf {PORTALNAME} an und gehen Sie auf “Meine Kleinanzeigen”.

 


Testing

Es sind eigenständige kundenseitige Tests in den dafür vorbereiteten Umgebungen durchzuführen. Insbesondere zu testen sind:

  • das Preismodell

  • das Kategoriensystem

  • Freigabe- & Bezahlworkflows

Verwandte Seiten