Vereinsantrag
Handbuch
DeveloperVereinsantrag.online
Handbuch
DeveloperVereinsantrag.online
  1. Arbeiten mit Online-Anträgen
  • Wilkommen zu Vereinsantrag 🎉
  • Registrierung und Vereinsdaten
  • Mitgliedschaften und Abteilungen
  • Formulare konfigurieren und veröffentlichen
  • Formular Design
  • Weitere Felder hinzufügen
  • Datenschutz
  • Einstellungen
  • Arbeiten mit Online-Anträgen
    • Export
    • Anträge korrigieren
    • Antrags-Historie
  • Developer
    • Welcome to the developer portal
    • Get your token
    • Rate-Limiting
    • API-Reference
      • Authentication
        • AuthenticationService
          • /auth/login
          • /auth/refresh
          • /auth/manage/info
          • /auth/manage/info
        • Users
          • Get all users for the current club (Admin only)
          • Create a new user in the current club without password - user receives email invitation (Admin only)
          • Get user by ID within the current club
          • Update user details within the current club
          • Delete a user from the current club (Admin only)
          • Resend password setup email to a user (Admin only)
          • Get available roles (Admin only)
      • Information about your club
        • Club
          • Gets the information of the club.
          • Changes the information of the club.
          • Gets the logo of the club.
          • Changes the logo of the club.
        • Department
          • Retrieves all departments for the current club.
          • Creates a new department.
          • Retrieves a specific department by its ID.
          • Deletes a specific department by its ID.
          • Modifies an existing department.
          • Retrieves the settings for the departments.
          • Updates the settings for the departments.
        • Forms
          • Get Membership Form
          • Modify Membership Form
          • Get Cancellation Form
          • Modify Cancellation Form
          • Get Form Design
          • Updates form Design
        • Membership
          • Retrieves all memberships for the current club.
          • Creates a new membership.
          • Retrieves a specific membership by its ID.
          • Deletes a specific membership by its ID.
          • Modifies an existing membership.
        • CustomField
          • Retrieves all custom fields for the current club.
          • Creates a new custom field.
          • Retrieves a specific custom field by its internal name.
          • Deletes a specific custom field by its internal name.
          • Partially modifies an existing custom field.
        • DataPrivacy
          • Retrieves the data privacy settings for the club.
          • Updates the data privacy settings for the club.
        • Settings
          • Get email template
          • Set email template
          • Reset email template
          • Get system email template
          • Get SMTP settings
          • Set SMTP settings
          • Test SMTP connection
          • Get available placeholders for email template
      • Submits
        • Cancellations
          • Get cancellation by id
          • Delete cancellation
          • Update cancellation submission
          • Create new cancellation
          • Get cancellation PDF
          • Get cancellation CSV
          • Export cancellation as text
          • Confirm cancellation
          • Resends the confirmation email for a cancellation application
          • Retrieves the history for a specific cancellation submission.
        • Changes
          • Create a new change request
          • Get change request by ID
          • Delete change request
          • Update change submission
          • Get change request PDF
          • Get change request CSV
          • Export change request as text
          • Confirm change request
          • Resends the confirmation email for a change membership application
          • Retrieves the history for a specific change submission.
        • Memberships
          • Creates a new membership application
          • Retrieves a membership application
          • Deletes a membership application
          • Update membership application
          • Exports a membership application as PDF
          • Exports a membership application as CSV
          • Exports a membership application as text
          • Exports a membership application as verein.cloud® CSV
          • Confirms a membership application
          • Resends the confirmation email for a membership application
          • Retrieves the history for a specific membership submission.
        • Submits
          • Retrieves all submissions.
          • Accepts a submission.
          • Denies a submission.
          • Starts a PDF export job
          • Downloads exported files as ZIP
          • Returns export job progress
          • Starts a CSV export job
          • Starts a verein.cloud® export job
      • Reporting
        • Dashboard
          • Gets the count of new memberships.
          • Gets the count of new changes.
          • Gets the count of new cancellations.
          • Gets the membership chart data.
  • Schemas
    • BackgroundImageSettings
    • CancellationMode
    • ChangeClubInfo
    • KpiCountResult
    • AccessTokenResponse
    • MembershipCountChartResult
    • BackgroundSettings
    • CancellationPatchDto
    • ChangeCustomFieldSchema
    • CreateUserRequest
    • ChangeMembershipSchema
    • ForgotPasswordRequest
    • CancellationSubmit
    • ClubInfo
    • HttpValidationProblemDetails
    • CancellationSubmitPatchRequest
    • ClubLogo
    • CancellationSubmitResponse
    • InfoRequest
    • DepartmentSchema
    • CustomFieldCategory
    • DepartmentSettingsSchema
    • ConsentMediaType
    • InfoResponse
    • ChangePatchDto
    • CustomFieldSchema
    • File
    • ChangeSubmitPatchRequest
    • LoginRequest
    • ProblemDetails
    • CustomFieldType
    • RefreshRequest
    • FormCancellation
    • ChangesSubmit
    • RegisterRequest
    • CustomDesignSettings
    • FormMembership
    • CustomFieldPatchDto
    • ResendConfirmationEmailRequest
    • DataPrivacySchema
    • MembershipSchema
    • ValidationProblemDetails
    • FamiliySubmit
    • ResetPasswordRequest
    • FamilyMemberPatchDto
    • TwoFactorRequest
    • Gender
    • EMailTemplateType
    • TwoFactorResponse
    • MembershipPatchDto
    • UpdateUserRequest
    • MembershipPatchRequest
    • UserResponse
    • UserRole
    • MembershipSubmit
    • MembershipSubmitResponse
    • GetEmailTemplateResponse
    • PaymentMethod
    • FormDesign
    • SetEmailTemplateRequest
    • StartExportJobRequest
    • SmtpSettingsReadDto
    • SubmitAcceptRequest
    • SubmitDenyRequest
    • SmtpSettingsWriteDto
    • MembershipPriceInterval
    • SubmitHistoryResponse
    • SmtpTestResultDto
    • PatchCustomFieldSchema
    • PlaceholderCategory
    • SubmitHistoryType
    • PlaceholderDataType
    • SubmitResponse
    • PlaceholderDefinition
    • SubmitState
Handbuch
DeveloperVereinsantrag.online
Handbuch
DeveloperVereinsantrag.online
  1. Arbeiten mit Online-Anträgen

Export

Export als PDF #

Der Antrag wird als vollständige PDF-Datei generiert, inklusive aller Eingaben und ggf. Unterschrift.
Export als PDF

Export als CSV #

Die Antragsdaten werden in eine CSV-Datei exportiert, die Sie z. B. in Excel oder eine Vereinssoftware importieren können.
FeldnameBeschreibung
IdEindeutige ID des Antrags (GUID). Jedes Familienmitglied hat eine eigene Zeile mit eigener ID.
FamilyIdID des Hauptantragstellers. Alle Familienmitglieder, die zum Antrag gehören, teilen sich diese ID.
FirstnameVorname der Person.
LastnameNachname der Person.
GenderGeschlecht der Person (z. B. Men, Women).
BirthdayGeburtsdatum im Format JJJJ-MM-DD.
ZipPostleitzahl.
CityWohnort.
StreetStraße.
PhoneTelefonnummer. (Achtung: lange Zahlen evtl. im wissenschaftlichen Format, z. B. +4901234567)
EmailE-Mail-Adresse.
PaymentMethodGewählte Zahlungsmethode (z. B. OnAccount, SEPA).
IbanIBAN, falls SEPA-Zahlung gewählt wurde.
AccountHolderName des Kontoinhabers (falls relevant).
DepartmentNamesAbteilungen, denen beigetreten wird (z. B. Rasenpflege).
MembershipNameName der gewählten Mitgliedschaft (z. B. Passiv, Aktiv).
MembershipPricePerYearBeitrag der Mitgliedschaft pro Jahr (z. B. 12).
DateCreateErstelldatum des Antrags (z. B. 2026-01-07 19:31:25).
CustomField_customField1Benutzerdefiniertes Feld – vom Verein frei konfigurierbar (z. B. "Wunscheintrag 2").

verein.cloud® Export#

Die Funktion verein.cloud® Export ist ab der Silber-Edition verfügbar
Mit dem verein.cloud® Export können Sie eingegangene Mitgliedsanträge direkt in das CSV-Format von verein.cloud® exportieren und so nahtlos in Ihre Vereinsverwaltungssoftware importieren. Dieser Spezial-Export ist optimal auf die Anforderungen von verein.cloud® abgestimmt und spart Ihnen manuelle Arbeit bei der Datenübernahme.
verein.cloud® ist eine cloudbasierte Vereinsverwaltungssoftware, die Ihnen hilft, Mitgliederdaten, Beiträge, Abteilungen und weitere Vereinsangelegenheiten digital zu verwalten.
Voraussetzungen:
Ein aktives Vereinsantrag-Konto mit konfiguriertem Mitgliedsformular
Eingegangene und bestätigte Mitgliedsanträge
Ein verein.cloud®-Account mit Importberechtigung
Wichtig: Der verein.cloud®-Export ist nur für Mitgliedsanträge verfügbar, nicht für Änderungs- oder Kündigungsanträge

Export durchführen#

Schritt 1: Antrag auswählen
Navigieren Sie im Adminbereich zu Anträge und öffnen Sie die Antragsliste. Klicken Sie auf den gewünschten Mitgliedsantrag, um die Detailansicht zu öffnen.
Schritt 2: Export starten
Klicken Sie in der Antragdetailansicht auf das Drei-Punkte-Menü (...) und wählen Sie "Export als verein.cloud® CSV".
Export
Schritt 3: CSV-Datei herunterladen
Die CSV-Datei wird automatisch generiert und zum Download angeboten. Speichern Sie die Datei auf Ihrem Computer.

CSV-Dateiformat#

Die exportierte CSV-Datei folgt dem offiziellen verein.cloud®-Importformat und enthält folgende Spalten:
Persönliche Daten:
SpalteBeschreibungBeispiel
VornameVorname des MitgliedsMax
NachnameNachname des MitgliedsMustermann
GeschlechtGeschlecht (Männlich, Weiblich, Jur. Person oder sächlich)Männlich
GeburtsdatumGeburtsdatum im Format TT.MM.JJJJ15.03.1985
StraßeStraße und HausnummerMusterstraße 123
PLZPostleitzahl12345
OrtWohnortMusterstadt
Telefon_P1Telefonnummer+49 123 456789
E-Mail_P1E-Mail-Adressemax.mustermann@example.com
Vereinsinformationen:
SpalteBeschreibungBeispiel
EintrittsdatumDatum des Vereinsbeitritts im Format TT.MM.JJJJ07.01.2025
StatusMitgliedsstatus (immer "Aktiv" bei Neuanträgen)Aktiv
Zahlungsdaten:
SpalteBeschreibungBeispiel
ZahlungsartZahlungsmethode (Lastschrift oder Überweisung)Lastschrift
KontoinhaberName des KontoinhabersMustermann, Max
IBANIBAN für SEPA-LastschriftDE89370400440532013000
Wichtig: Familienmitglieder haben keine eigenen Zahlungsinformationen – diese Felder bleiben bei ihnen leer.
Abteilungen:
SpalteBeschreibungBeispiel
Abteilung_1Name der ersten AbteilungFußball
Abteilungseintritt_1Eintrittsdatum in die erste Abteilung07.01.2025
Abteilung_2Name der zweiten Abteilung (falls vorhanden)Turnen
Abteilungseintritt_2Eintrittsdatum in die zweite Abteilung07.01.2025
Falls ein Mitglied mehreren Abteilungen beitritt, werden die Spalten entsprechend erweitert (Abteilung_3, Abteilung_4, usw.).
Beiträge:
SpalteBeschreibungBeispiel
Beitragsbezeichnung_1_1Name der Mitgliedschaft / BeitragsartAktiv
Beitragsstart_1_1Startdatum des Beitrags07.01.2025
Familienbeiträge:
SpalteBeschreibungBeispiel
GemeinschaftGemeinsame ID für Familienmitgliedschaften550e8400-e29b-41d4-a716-446655440000
FBZ_1_1Familienbeitragszahler-ID (nur beim Hauptmitglied)1234567890
FBM_1_1Familienbeitragsmitglied-ID (nur bei Familienmitgliedern)1234567890
Hinweis: Die Gemeinschaft-Spalte wird nur bei Familienmitgliedschaften ausgefüllt und verbindet alle zur Familie gehörenden Personen mit derselben ID. Der FBZ (Familienbeitragszahler) kennzeichnet die Person, die den Beitrag zahlt, während FBM (Familienbeitragsmitglied) auf diese Person verweist.
Benutzerdefinierte Felder (Freifelder):
SpalteBeschreibungBeispiel
Freifeldname_1Name des ersten benutzerdefinierten FeldesT-Shirt-Größe
Freifeldwert_1Wert des ersten benutzerdefinierten FeldesL
Freifeldname_2Name des zweiten benutzerdefinierten FeldesMitgliedsnummer
Freifeldwert_2Wert des zweiten benutzerdefinierten Feldes12345
Falls Sie in Ihrem Mitgliedsformular zusätzliche Felder konfiguriert haben, werden diese als Freifelder exportiert.

Import in verein.cloud®#

Schritt 1: In verein.cloud® anmelden
Melden Sie sich in Ihrem verein.cloud®-Account an und navigieren Sie zum Bereich Import/Export.
Antrag annehmen oder ablehnen
Schritt 2: CSV-Datei hochladen
Laden Sie die von Vereinsantrag exportierte CSV-Datei hoch. verein.cloud® erkennt automatisch das richtige Format.
⚠️ Wichtig: Wählen Sie NICHT den "Erweiterten Import" aus. Nutzen Sie ausschließlich den Standard-Import für die von Vereinsantrag exportierte CSV-Datei.
Schritt 3: Feldzuordnung überprüfen
verein.cloud® zeigt Ihnen eine Vorschau der zu importierenden Daten. Überprüfen Sie die Feldzuordnung und passen Sie diese bei Bedarf an.
Schritt 4: Import durchführen
Bestätigen Sie den Import. Die Mitglieder werden nun in verein.cloud® angelegt.
Schritt 5: Daten kontrollieren
Überprüfen Sie nach dem Import stichprobenartig einige Mitglieder, um sicherzustellen, dass alle Daten korrekt übernommen wurden.

Besonderheiten bei Familienmitgliedschaften#

Wenn ein Mitglied mit Familienmitgliedern (z. B. Ehepartner, Kinder) einen Antrag stellt, werden alle Personen als separate Zeilen in der CSV-Datei exportiert:
1.
Hauptmitglied (Antragsteller)
Enthält alle Zahlungsinformationen (IBAN, Zahlungsart, Kontoinhaber)
Wird als Familienbeitragszahler (FBZ) markiert
Hat eine eindeutige Gemeinschaft-ID
2.
Familienmitglieder
Keine Zahlungsinformationen (Felder bleiben leer)
Werden als Familienbeitragsmitglieder (FBM) markiert
Referenzieren den Familienbeitragszahler
Teilen sich die gleiche Gemeinschaft-ID
Beispiel für eine Familienmitgliedschaft:
Vorname,Nachname,Geschlecht,Geburtsdatum,IBAN,Zahlungsart,Gemeinschaft,FBZ_1_1,FBM_1_1
Max,Mustermann,Männlich,15.03.1980,DE89370400440532013000,Lastschrift,550e8400-e29b-41d4-a716-446655440000,1234567890,
Maria,Mustermann,Weiblich,20.05.1982,,,550e8400-e29b-41d4-a716-446655440000,,1234567890
Tim,Mustermann,Männlich,10.08.2010,,,550e8400-e29b-41d4-a716-446655440000,,1234567890
In diesem Beispiel:
Max Mustermann ist der Beitragszahler (FBZ)
Maria und Tim Mustermann sind Familienmitglieder (FBM)
Alle drei teilen sich die Gemeinschafts-ID 550e8400-e29b-41d4-a716-446655440000

Mehrfach-Export#

Um mehrere Anträge als CSV oder PDF zu exportieren, selektieren Sie die gewünschten Anträge über die linke Checkbox und wählen unter "... Aktionen" das gewünschte Exportformat aus.
Mehrfach Export
Sobald der Export abgeschlossen ist, wird Ihnen in Ihrem Browser ein Download-Fenster angeboten.
Download der Export-Datei
Diese Funktion ist für Ihre Datensicherung der Anträge gedacht

Previous
Arbeiten mit Online-Anträgen
Next
Anträge korrigieren
Built with