Abrechnungskonten und Firmen
Legt Abrechnungskonten an oder aktualisiert sie, mit Kontakt, Adresse und Bankdaten für die Lastschrift.
- Format
- CSV (Komma oder Semikolon), UTF-8
- Rechte
- Administrator, Kontakte (CRM) schreiben
- Beispieldateien
- AFS_ACCOUNT_konten_technisch.csv (technische Spaltennamen)
AFS_ACCOUNT_konten_anwender.csv (deutsche Spaltennamen)
Kurz gesagt: Ein Abrechnungskonto ist der Zahler, zum Beispiel eine Familie oder eine Firma. Mit dieser Datei übernehmt ihr die Konten inklusive Bankdaten für die Lastschrift.
Wofür ihr das braucht
Jede Person, die bezahlt, gehört zu einem Konto. Die Konten sind die Grundlage für Rechnungen, Lastschriften und Mitgliedschaften. Importiert sie nach den Personen, damit ihr die Personen danach mit den Konten verknüpfen könnt.
Bevor ihr startet
- Rechte: Ihr braucht das Zugriffsrecht Importe und seid Administrator mit Schreibrecht für Kontakte (CRM).
- Reihenfolge: Erst die Personen importieren, dann die Konten, dann die Verknüpfung.
- Sicherung: Zieht vor dem Import einen Export eurer Konten.
Datei vorbereiten
- Dateiname: Der Name muss
AFS_ACCOUNT_enthalten und mit.csvenden, zum BeispielAFS_ACCOUNT_konten.csv. - Kopfzeile: Die erste Zeile enthält die Spaltennamen aus der Tabelle unten.
- Trennzeichen: Komma oder Semikolon, in der ganzen Datei gleich.
- Datum:
01.02.2024oder2024-02-01. - Größe: Ab 4000 Zeilen teilt vynst die Datei in Pakete zu je 1000 Zeilen.
Spalten
| Spalte | Pflicht | Inhalt | Beispiel |
|---|---|---|---|
Kontonummer (COMPANY_IDENTIFIER) |
ja | Nummer des Kontos aus eurem bisherigen Programm. Auch erlaubt: ACCOUNT_IDENTIFIER, Abrechnungskontonummer, Mitgliedsnummer, Mitglieds-Nr., Adressnummer |
K-1001 |
Firmenname (COMPANY_NAME) |
ja, wenn kein Name aus Vor- und Nachname kommt | Name der Firma oder des Kontos. Auch erlaubt: Firma, Firmenname, Abrechnungskontenname, Unternehmensname |
Familie Beispiel |
Vorname (FIRST_NAME) und Nachname (LAST_NAME) |
nur ohne Firmenname | Ohne Firmenname bildet vynst den Kontonamen aus Vor- und Nachname | Anna, Beispiel |
Straße (ADDRESS_STREET) |
nein | Auch erlaubt: Strasse, Straße und Hausnummer |
Musterweg |
Hausnummer (ADDRESS_HOUSE_NUMBER) |
nein | Nur wenn getrennt angegeben. Auch erlaubt: Hausnummer, Hausnr. |
1 |
Adresszusatz (ADDRESS_CO) |
nein | Auch erlaubt: Adresszusatz |
c/o Familie Muster |
PLZ (ADDRESS_ZIP) |
nein | Auch erlaubt: Postleitzahl |
50667 |
Ort (ADDRESS_CITY) |
nein | Auch erlaubt: Stadt, Wohnort |
Köln |
Bundesland (ADDRESS_ADMIN_LEVEL_1) |
nein | Bundesland. Auch erlaubt: Bundesland. |
Nordrhein-Westfalen |
Land (ADDRESS_COUNTRY) |
nein | Auch erlaubt: Land |
Deutschland |
E-Mail (MAIN_EMAIL) |
nein | Auch erlaubt: E-Mail, E-Mail-Adresse |
anna@example.org |
E-Mail 2 (SECONDARY_EMAIL) |
nein | Auch erlaubt: E-Mail 2, E-Mail Familie |
|
Telefon (MAIN_PHONE) |
nein | Auch erlaubt: Telefon, Telefonnummer |
0221 123456 |
Telefon 2 (SECONDARY_PHONE) |
nein | Auch erlaubt: Mobiltelefon, Mobil |
|
Telefon 3 (TERTIARY_PHONE) |
nein | Auch erlaubt: Diensttelefon |
|
Telefax (MAIN_FAX) |
nein | Auch erlaubt: Fax |
|
Website (MAIN_WEBSITE) |
nein | Auch erlaubt: Homepage, Webseite |
www.example.org |
Kontoinhaber (PAYMENT_OWNER) |
nein | Auch erlaubt: Inhaber, Zahler |
Anna Beispiel |
IBAN (PAYMENT_IBAN) |
nein | Bankverbindung für die Lastschrift | DE02120300000000202051 |
BIC (PAYMENT_BIC) |
nein | Auch erlaubt: Swift BIC |
BYLADEM1001 |
Bankname (PAYMENT_INSTITUTION) |
nein | Auch erlaubt: Bankname, Bankbezeichnung, Bankverbindung |
|
Mandatsreferenz (PAYMENT_MANDATE) |
nein | Auch erlaubt: MandatNr, SEPA-Mandatsreferenz |
M-1001 |
Mandatsdatum (PAYMENT_MANDATE_SIGN_DATE) |
nein | Auch erlaubt: Mandatsreferenz gültig ab, SEPA-Mandatsdatum |
01.01.2020 |
Mandat gültig bis (PAYMENT_MANDATE_VALID_UNTIL_DATE) |
nein | Auch erlaubt: Mandatsreferenz gültig bis |
|
SEPA-Lastschrift aktivieren (PAYMENT_SEPA_ACTIVATE) |
nein | ja oder nein. Auch erlaubt: SEPA Einzug aktivieren, Bankverfahren |
ja |
Steuernummer (TAX_NUMBER) |
nein | Auch erlaubt: Steuernummer |
|
USt-IdNr. (VAT_ID) |
nein | Auch erlaubt: USt-IdNr. |
|
Abweichende Kundennummer (MANUAL_COMPANY_NUMBER) |
nein | Auch erlaubt: Abweichende Firmennummer |
|
DATEV-Konto (ACCOUNTING_SOFTWARE_NUMBER) |
nein | Auch erlaubt: DatevKonto, DatevNr |
|
Notiz (NOTE) |
nein | Auch erlaubt: Bemerkung |
|
IMPORT_IDENTIFIER_PREFIX |
nein | Vorsatz für die interne Kennung des Kontos. Standard ist AFS_CSV_. Die interne Kennung ist dann zum Beispiel AFS_CSV_K-1001. |
AFS_CSV_ |
Beispiel:
COMPANY_IDENTIFIER;COMPANY_NAME;IMPORT_IDENTIFIER_PREFIX;ADDRESS_STREET;ADDRESS_HOUSE_NUMBER;ADDRESS_CO;ADDRESS_ZIP;ADDRESS_CITY;ADDRESS_ADMIN_LEVEL_1;ADDRESS_COUNTRY;MAIN_EMAIL;SECONDARY_EMAIL;MAIN_PHONE;SECONDARY_PHONE;TERTIARY_PHONE;MAIN_FAX;MAIN_WEBSITE;PAYMENT_OWNER;PAYMENT_IBAN;PAYMENT_BIC;PAYMENT_INSTITUTION;PAYMENT_MANDATE;PAYMENT_MANDATE_SIGN_DATE;PAYMENT_MANDATE_VALID_UNTIL_DATE;PAYMENT_SEPA_ACTIVATE;TAX_NUMBER;VAT_ID;MANUAL_COMPANY_NUMBER;ACCOUNTING_SOFTWARE_NUMBER;NOTE
K-1001;Familie Hartmann;AFS_CSV_;Musterweg;1;;50667;Köln;Nordrhein-Westfalen;DE;lena.hartmann@example.org;;0221 1000001;;;;;Lena Hartmann;DE02120300000000202051;BYLADEM1001;Beispielbank;M-1001;01.01.2020;;ja;;;;;Beispielkonto Familie Hartmann
K-1003;Anna Beispiel;AFS_CSV_;Gartenweg;4;;50668;Köln;Nordrhein-Westfalen;DE;anna.beispiel@example.org;;0221 1000003;0170 1234567;;;;Anna Beispiel;DE02500105170137075030;INGDDEFFXXX;Beispielbank;M-1003;01.01.2021;;ja;;;;;
Beispieldateien: AFS_ACCOUNT_konten_technisch.csv mit den technischen Spaltennamen, AFS_ACCOUNT_konten_anwender.csv mit den deutschen Spaltennamen.
So geht’s
- Öffnet Einstellungen → Import.
- Klickt auf Hinzufügen und wählt die Datei aus.
- Wartet, bis der Eintrag grün oder rot ist.
- Prüft das Protokoll auf Zeilen mit
Error:. - Verknüpft danach die Personen mit den Konten, siehe Person mit Konto verknüpfen.
Gut zu wissen
- Erneuter Import: Eine bekannte Kontonummer aktualisiert das Konto. Neue Nummern legen neue Konten an.
- Lastschrift: Die Zahlungsart wird auf Lastschrift gesetzt, wenn SEPA-Lastschrift aktivieren auf ja steht und die Lastschriftdaten vollständig sind.
- Bankname: Ist die IBAN in den hinterlegten Bankdaten bekannt, ergänzt vynst den Namen der Bank.
- Mandatsdatum: Ist ein Mandat gültig bis in der Zukunft und fehlt das Mandatsdatum, übernimmt vynst das Anlagedatum des Kontos.
- Leere Zellen: Bei bestehenden Konten kann eine leere Zelle in einer vorhandenen Spalte den bisherigen Wert leeren. Prüft das im Zweifel mit einer Testdatei.
- Vorsicht bei Bankdaten: Eine Bankverbindung ist Teil des Zahlungsweges. Kontrolliert IBAN und Mandat nach dem Import.
Wenn etwas nicht klappt
| Meldung im Protokoll | Bedeutung | Was tun |
|---|---|---|
Error: skipped empty line |
Eine leere Zeile wurde übersprungen. | Nichts tun. |
Error: skipped missing identifier or name |
Kontonummer oder Name fehlt. Die Zeile steht danach als LINE-DATA. |
Angaben ergänzen und nur diese Zeile erneut importieren. |
Info: split into N files |
Die Datei wurde in N Pakete aufgeteilt. | Nichts tun. |
Processed N lines |
So viele Zeilen wurden verarbeitet. | Nichts tun. |
Error: less then one line |
Die Datei enthält keine Datenzeilen. | Datei und Kopfzeile prüfen. |