- 25 Oct 2024
- 40 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Kunden Export/Import (csv)
- Aktualisiert am 25 Oct 2024
- 40 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Wichtiger Hinweis
Diese Schnittstelle ist standardisiert und kann jederzeit um zusätzliche Felder erweitert werden. Neue Felder werden stets am Ende der bestehenden Struktur hinzugefügt, um die Kompatibilität zu gewährleisten.
Für den Kundenstammimport sind die angeführten Feldnamen entscheidend. Diese müssen als Überschrift der Spalten angegeben werden. Als Trennzeichen muss das Semikolon (";") verwendet werden. Überall, wo in der untenstehenden Tabelle in der Spalte "Anmerkung" ein bestimmtes xPro angegeben ist, muss z. B. der betreffende Kundentyp ZUERST im xPro "CusTyp" angelegt werden. Erst dann kann in der CSV-Datei darauf verwiesen werden.
Die CSV-Datei sollte mit der Codepage ANSI bzw. Windows-1252 erstellt werden.
Wenn der Kundentyp "Händler A" den "xPro-Schlüssel" "A1" im xPro "CusTyp" trägt, dann muss in der CSV-Datei der xPro-Schlüssel "A1" (NICHT die Bezeichnung "Händler A") in der Spalte "CusTyp" mitgegeben werden!
Feldname | Datentyp | Format | Anmerkung | Beschreibung | Pflicht |
Char | X(8) bzw. X(32) | 32stellige Kundennummern erfordern die Lizenz „Erweiterter Adresscode“ | Kundennummer | Ja | |
Char | X(32) | xPro Code AdrSex Nicht vorhandene Einträge werden mit der nächsten freien ID angelegt. | Anrede | Nein | |
Char | X(20) |
| Titel | Nein | |
Char | X(40) |
| Nachname | Ja | |
Char | X(40) |
| Vorname | Nein | |
Char | X(40) | Dieses Feld wird für Firmenbezeichnungen verwendet. | Zusatz | Nein | |
Char | X(40) |
| Strasse | Nein | |
Char | X(32) | xPro Code AdrLnd Wenn ein Länderkennzeichen in der Postleitzahl vorhanden ist (A-XXXX), wird im Kundenstamm mit diesem Länderkennzeichen das Feld "Land" gefüllt, und die Postleitzahl in das Feld "PLZ" eingetragen. Falls die Postleitzahl für das Land im xPro AdrPcd noch nicht existiert, dann wird ein neuer Datensatz angelegt, wobei als Beschreibung der Ort aus dem importierten Datensatz verwendet wird. | Land | Ja | |
Char | X(10) | Wenn ein Länderkennzeichen in der Postleitzahl vorhanden ist (A-XXXX), wird im Kundenstamm mit diesem Länderkennzeichen das Feld "Land" gefüllt, und die Postleitzahl in das Feld "PLZ" eingetragen. Falls die Postleitzahl für das Land im xPro AdrPcd noch nicht existiert, dann wird ein neuer Datensatz angelegt, wobei als Beschreibung der Ort aus dem importierten Datensatz verwendet wird. | PLZ | Ja | |
Char | X(40) |
| Ort | Ja | |
Char | X(40) |
| Telefon | Nein | |
Char | X(8) | xPro Code SlsRep Nicht vorhandene Einträge werden mit dem Vertreter als ID angelegt. Hinter der Bezeichnung des Vertreters wird in diesem Fall „importiert“ hinzugefügt. | Vertreter | Nein | |
Char | X(40) |
| Fax | Nein | |
Char | X(8) | xPro Code CusGrp Nicht vorhandene Einträge werden mit der Kundengruppe als ID und Bezeichnung angelegt. | Kundengruppe | Nein | |
Char | X(8) | xPro Code CusTyp Nicht vorhandene Einträge werden mit dem Kundentyp als ID angelegt. Hinter der Bezeichnung des Kundentyps wird in diesem Fall „importiert“ hinzugefügt. | Kundentyp | Nein | |
Char | X(8) | xPro Code CusBra Nicht vorhandene Einträge werden mit der Kundenbranche als ID angelegt. Hinter der Bezeichnung der Kundenbranche wird in diesem Fall „importiert“ hinzugefügt. | Kundenbranche | Nein | |
Char | X(8) | xPro Code BnsGrp Nicht vorhandene Einträge werden mit der Bonusgruppe als ID angelegt. Hinter der Bezeichnung der Bonusgruppe wird in diesem Fall „importiert“ hinzugefügt. | Bonusgruppe | Nein | |
| Nein |
|
|
|
|
Char | X(8) | xPro Code PayCnd Nicht vorhandene Einträge werden mit den Zahlungskonditionen als ID angelegt. Hinter der Bezeichnung der Zahlungskonditionen wird in diesem Fall „importiert“ hinzugefügt und die Skonto- und Nettofelder nicht gefüllt. | Zahlungskonditionen | Nein | |
Char | X(8) | xPro Code DlvCnd Nicht vorhandene Einträge werden mit den Lieferkonditionen als ID angelegt. Hinter der Bezeichnung der Lieferkonditionen wird in diesem Fall „importiert“ hinzugefügt. | Lieferkonditionen | Nein | |
Char | X(8) | xPro Code PkgCnd Nicht vorhandene Einträge werden mit den Verpackungskonditionen als ID angelegt. Hinter der Bezeichnung der Verpackungskonditionen wird in diesem Fall „importiert“ hinzugefügt. | Verpackungskonditionen | Nein | |
Char | X(8) | xPro Code ShpCnd Nicht vorhandene Einträge werden mit den Versandkonditionen als ID angelegt. Hinter der Bezeichnung der Versandkonditionen wird in diesem Fall „importiert“ hinzugefügt. | Versandkonditionen | Nein | |
Char | Max. 32000 Zeichen | Angabe der Rabatthöhe in %, wird als Basisrabatt mit diesem Prozentsatz angelegt |-getrennte Rabatt-Liste | Rabatt | Nein | |
Int | 99999999 | In diesem Feld muss eine Kundennummer eingegeben werden. Dieses Feld kann erst belegt werden, wenn dieser Kunde bereits angelegt ist. Ist die Kundennummer noch nicht vorhanden, wird das Feld nicht gefüllt. | Fakturenempfaenger | Nein | |
Int | 99999999 |
| Verband | Nein | |
Int | 99999999 |
| Abnehmer | Nein | |
Int | 99999999 | Als Eintrag muss eine Niederlassungsnummer in diesem Feld eingegeben werden. Diese Niederlassungsnummer muss im Adresssystem unter Niederlassung angelegt werden. Wenn die Niederlassungsnummer nicht vorhanden ist, wird das Feld nicht gefüllt. | Niederlassung | Nein | |
Char | X(8) | xPro Code EvdRsp Nicht vorhandene Einträge werden mit dem Sachbearbeiternamen (getrimmt auf 8 Zeichen) als ID angelegt. Hinter der Bezeichnung des Sachbearbeiters wird in diesem Fall „importiert“ hinzugefügt. | Sachbearbeiter | Nein | |
Char | max. 3 Zeichen | XPro Code SupFac Nicht vorhandene Einträge werden mit dem Lieferwerknamen (getrimmt auf 3 Zeichen) als ID angelegt. Hinter der Bezeichnung des Lieferwerks wird in diesem Fall „importiert“ hinzugefügt. | Lieferwerk | Nein | |
Char | X(40) |
| Adressbeschreibung 1 | Nein | |
Char | X(40) |
| Adressbeschreibung 2 | Nein | |
Char | X(2) | Falls das importierte TaxLnd im xPro TaxLnd noch nicht enthalten ist, wird nicht automatisch ein neuer xPro Eintrag erstellt. | Umsatzsteuerland | Nein | |
Char | X(12) | 12-stellig | Umsatzsteuernummer | Nein | |
Char | X(40) |
| Telefon 2 | Nein | |
Char | X(50) |
| Nein | ||
Char | X(1) | blank - aktiv „D“ - inaktiv | Kunde aktiv/inaktiv | Nein | |
Char | X(25) |
| Lieferantennummer | Nein | |
Char | X(40) |
| Gesellsch.-Nr | Nein | |
Char | X(40) |
| GLN/ILN | Nein | |
Char | X(150) | Wenn diese Spalte gefüllt ist, muss die Checkbox „Kurzname im Änderungsdienst neu generieren“ aus [Systeme] [Stammdaten] [Adreß-Definitionen] Button [Adressformat] angehakt sein. Wenn diese Spalte NICHT gefüllt ist, dann wird der Kurzname entsprechend der aktuellen Einstellungen gefüllt. | Kurzname | Nein | |
Char | Max. 32000 Zeichen | |-getrennte Liste von Rabattcodes | Liste mit Rabattcodes | Nein | |
Logical | yes/no | |-getrennte Liste von 0 und 1 | Ist Rabattcode aktiv | Nein | |
Char | X(8) |
| Fakturenart | Nein | |
Int | 99 | 1 = Deutsch | Sprache | Nein | |
Char | X(40) |
| Formulare | Nein | |
Char | X(40) |
| Vorspanntext | Nein | |
Char | X(40) |
| Nachspanntext | Nein | |
Char | X(40) |
| Verteilungsart | Nein | |
Char | X(40) |
| Bestätigungsempfänger | Nein | |
Logical | yes/no |
| Niederlassung änderbar | Nein | |
Char | X(16) |
| Kunden-Rabattgruppe | Nein | |
Char | X(3) |
| Kundenwährung | Nein | |
Logical | yes/no |
| EDV-Projekt | Nein | |
Int | 9 |
| Kundenart | Nein | |
Char | X(40) | ‼️ Ab Version 55.10. nicht mehr enthalten | Lieferschein-Formular | Nein | |
Char | X(40) | ‼️ Ab Version 55.10. nicht mehr enthalten | Gutschrift-Formular | Nein | |
Char | X(40) |
| Telefon 3 /Mobiltelefon | Nein | |
Char | max. 256 Zeichen |
| Memotext | Nein | |
Logical | yes/no | 0 = nicht archiviert | Archivieren | Nein | |
Char | x(40) |
|
| Nein | |
Char | x(9) |
|
| Nein | |
Char | x(10) |
|
| Nein | |
Char | x(128) |
|
| Nein | |
CustomerArchived | Logical | true/false | Kunden archivieren erweitern | Kunden archivieren | Nein |
RecommenderGUID | Char | X40 | GUID des Kunden, welcher Empfehlungsgeber für diesen Kunden ist | GUID des Kunden | Nein |
RecommenderAdrCde | Char | X32 | Adresscode des Kunden, welcher Empfehlungsgeber für diesen Kunden ist | Adresscode des Kunden | Nein |
RecommendationDate | Date | tt.mm.jjjj | Datum "Empfehlung am" | Datum "Empfehlung am" | Nein |
Optional gibt es die Möglichkeit im Kopfbereich des Importfiles drei Parameter für den Import zu hinterlegen:
ReplaceSelective=TRUE|ProtectDiscounts=TRUE|OverwriteAll=TRUE
Oder:
ReplaceSelective=TRUE
ProtectDiscounts=TRUE
OverwriteAll=TRUE
Der Parameter „ReplaceSelective=TRUE“ bewirkt, dass nur im Importfile enthaltene und gefüllte Felder beim Import in moveIT ISS+ überschrieben werden. Um hinterlegte Rabatte nicht zu überschreiben, muss zwingend der Parameter "ProtectDiscounts=TRUE" mitangegeben werden! Der dritte Parameter „OverwriteAll=TRUE“ bewirkt, dass die Abfragen beim Ändern eines bestehenden Kunden nicht mehr bestätigt werden müssen.