Der Kundenauftrags-Import wird hauptsächlich verwendet, um externe Shops an Collmex anzubinden. Die Shop-Bestellungen werden dabei als Kundenaufträge importiert und dann in der Collmex-Warenwirtschaft weiter verarbeitet.
Jede Kundenauftrags-Position ist eine Zeile in der CSV-Datei. Alle Positionen eines Auftrags müssen in aufeinander folgenden Zeilen stehen. Die Kopfdaten (z.B. Kunde, Zahlungsbedingung, Versandart usw.) müssen für alle Positionen / Zeilen angegeben werden.
Die Steuern und der Gesamtpreis des Auftrags werden automatisch aus den Positionen errechnet und können nicht übergeben werden.
| Nr | Feld | Typ | Max.Länge | Bemerkung
|
|---|
| 1 | Satzart | C | | Festwert CMXORD-2
|
| 2 | Auftragsnummer | I | 8 | Die Auftragsnummer identifiziert den Auftrag eindeutig. Siehe auch Nummernvergabe.
|
| 3 | Position | I | 8 | Positionsnummer der Auftragsposition. Wenn nicht angegeben, wird die Positionsnummer automatisch fortlaufend vergeben.
|
| 4 | Auftragsart | I | 8 | Reserviert. Bitte leer lassen.
|
| 5 | Firma Nr | I | 8 | Interne Nummer der Firma, wie unter Verwaltung → Firma anzeigen und ändern angezeigt.
|
| 6 | Kunden-Nr | I | 8 | Optional. Falls nicht angegeben, muss für einen neuen Kundenauftrag die Adresse des Kunden (Felder 7 - 28 und 94) belegt sein. Die Kundennummer wird dann über Vornamen, Name, Firma und Mailadresse ermittelt und die in den Stammdaten vorhandene Adresse gemäß der Felder 7 - 28 und 94 geändert. Ist ein Feld nicht bekannt, muss es mit dem Wert (NULL) belegt werden, damit es in Collmex nicht geändert wird. Existiert kein Kunde mit angegebenen Vornamen, Name, Firma und Mailadresse oder ist die Mailadresse leer, wird ein neuer Kunde angelegt und die Adresse übernommen. Als Vorlage dient dabei der Kunde 9999. Ausnahme: Erfolgt der Import über einen API-Benutzer, wird als Vorlage der im API-Benutzer hinterlegte Vorlage-Kunde verwendet (s. Benutzer bearbeiten).
|
| 7 | Kunde-Anrede | C | 10 | Felder 7 - 28 siehe Beschreibung zur Kundennummer.
|
| 8 | Kunde-Titel | C | 10 |
|
| 9 | Kunde-Vorname | C | 40 |
|
| 10 | Kunde-Name | C | 40 |
|
| 11 | Kunde-Firma | C | 80 |
|
| 12 | Kunde-Abteilung | C | 80 |
|
| 13 | Kunde-Strasse | C | 80 |
|
| 14 | Kunde-PLZ | C | 10 |
|
| 15 | Kunde-Ort | C | 20 |
|
| 16 | Kunde-Land | C | 2 | ISO Codes
|
| 17 | Kunde-Telefon | C | 20 |
|
| 18 | Kunde-Telefon2 | C | 20 |
|
| 19 | Kunde-Telefax | C | 20 |
|
| 20 | Kunde-E-Mail | C | 50 |
|
| 21 | Kunde-Kontonummer | C | 20 |
|
| 22 | Kunde-Blz | C | 20 |
|
| 23 | Kunde-Abweichender Kontoinhaber | C | 40 |
|
| 24 | Kunde-IBAN | C | 20 |
|
| 25 | Kunde-BIC | C | 20 |
|
| 26 | Kunde-Bank | C | 20 |
|
| 27 | Kunde-USt.IdNr | C | 20 |
|
| 28 | Kunde-Privatperson | I | 8 |
|
| 29 | Auftragsnummer bei Kunde | C | 50 | Optional.
|
| 30 | Auftragsdatum | D | 8 | Falls nicht angegeben, wird das aktuelle Datum gesetzt.
|
| 31 | Preisdatum | D | 8 | Falls nicht angegeben, wird das Rechnungsdatum gesetzt.
|
| 32 | Zahlungsbedingung | I | 8 | Als Zahl codiert, beginnend mit 0 für 30T ohne Abzug, wie im Programm unter "Einstellungen". Falls nicht angegeben, wird die Zahlungsbedingung vom Kunden übernommen.
|
| 33 | Währung (ISO-Codes) | C | 3 | Falls nicht angegeben, wird die Währung vom Kunnden übernommen.
|
| 34 | Preisgruppe | I | 8 | Interne Nummer der Preisgruppe, wie sie bei der Pflege der Preisgruppe in der ersten Spalte angezeigt wird. Falls nicht angegeben, wird die Preisgruppe vom Kunden übernommen.
|
| 35 | Rabattgruppe | I | 8 | Interne Nummer der Rabattgruppe, wie sie bei der Pflege der Rabattgruppe in der ersten Spalte angezeigt wird. Falls nicht angegeben, wird die Rabattgruppe vom Kunden übernommen.
|
| 36 | Schluss-Rabatt | I | 8 | Schluss-Rabatt in Prozent.
|
| 37 | Rabattgrund | C | 255 | Grund für den Rabatt.
|
| 38 | Bestätigungstext | C | 1024 | Falls (NULL), wird der Text aus den Standard-Textbausteinen ermittelt.
|
| 39 | Schlusstext | C | 1024 | Falls (NULL), wird der Text aus den Standard-Textbausteinen ermittelt.
|
| 40 | Internes Memo | C | 1024 |
|
| 41 | Teilrechnungen erlaubt | I | 8 | 0 = Teilrechnungen nicht erlaubt, 1 = Teilrechnungen erlaubt.
|
| 42 | Teillieferungen erlaubt | I | 8 | 0 = Teillieferungen nicht erlaubt, 1 = Teillieferungen erlaubt.
|
| 43 | Gelöscht | I | 8 | 0 = nicht gelöscht, 1 = gelöscht.
|
| 44 | Status | I | 8 | Nur für Export. 0 = Neu, 10 = Bestätigt, 20 = Teilbezahlt, 25 = Zahlung bestätigt (nur bei Sofortüberweisung), 30 = Bezahlt, 40 = Teilgeliefert, 50 = Geliefert, 60 = Teilabschlag berechnet, 70 = Abschlag berechnet, 80 = Teilabgerechnet, 90 = Abgerechnet, 100 = Erledigt, 1000 = Abgesagt, 1010 = Gelöscht.
|
| 45 | Sprache | I | 8 | 0 = Deutsch, 1 = Englisch.
|
| 46 | Bearbeiter | I | 8 | Mitarbeiternummer des Bearbeiters. Falls nicht angegeben, wird der Bearbeiter automatisch bestimmt.
|
| 47 | Vermittler | I | 8 | Mitarbeiter Nummer des Vermittlers für die Provisionsabrechnung.
|
| 48 | Systemname | C | 20 | Optional. Name des externen Systems. Über das API können Änderungen an Kundenaufträgen für dieses System abgefragt werden.
|
| 49 | Schluss-Rabatt-2 | M | 18 | Schluss-Rabatt als Betrag
|
| 50 | Schluss-Rabatt-2-Grund | C | 20 | Grund für den Rabatt
|
| 51 | Gutschein | C | 12 | Nummer des eingelösten Gutscheins im Format NNN-NNN-NNN
|
| 52 | Abgesagt am | D | 8 |
|
| 53 | Versandart | I | 8 | Interne Nummer der Versandart, wie sie bei der Pflege der Versandart angezeigt wird. Falls nicht angegeben, wird die Versandart automatisch bestimmt über die Versandgruppen der im Auftrag enthaltenen Produkte (nur Collmex pro).
|
| 54 | Versandkosten | M | 18 | Falls nicht angegeben, werden die Versandkosten automatisch über die Versandart bestimmt.
|
| 55 | Nachnahmegebühr | M | 18 | Falls nicht angegeben, wird die Nachnahmegebühr automatisch über die Versandart bestimmt.
|
| 56 | Lieferbedingung | C | 3 | International genormte INCOTERMS. Falls nicht angegeben, wird die Lieferbedingung aus der Versandart übernommen.
|
| 57 | Lieferbedingung Zusatz | C | 40 | Ort der Lieferbedingung
|
| 58 | LieferAdr-Anrede | C | 10 | Felder 58 - 71: Optional. Abweichende Lieferadresse.
|
| 59 | LieferAdr-Titel | C | 10 |
|
| 60 | LieferAdr-Vorname | C | 40 |
|
| 61 | LieferAdr-Name | C | 40 |
|
| 62 | LieferAdr-Firma | C | 80 |
|
| 63 | LieferAdr-Abteilung | C | 80 |
|
| 64 | LieferAdr-Strasse | C | 80 |
|
| 65 | LieferAdr-PLZ | C | 10 |
|
| 66 | LieferAdr-Ort | C | 20 |
|
| 67 | LieferAdr-Land | C | 2 | ISO Codes
|
| 68 | LieferAdr-Telefon | C | 20 |
|
| 69 | LieferAdr-Telefon2 | C | 20 |
|
| 70 | LieferAdr-Telefax | C | 20 |
|
| 71 | LieferAdr-E-Mail | C | 50 |
|
| 72 | Positionstyp | I | 8 | 0 = Normalposition, 1 = Summenposition, 2 = Textposition, 3 = Kostenlos.
|
| 73 | Produktnummer | C | 20 | Falls nicht angegeben, muss die Produktbeschreibung gefüllt sein. Die angegebene Produktnummer muss in Collmex existieren.
|
| 74 | Produktbeschreibung | C | 10.000 | Falls nicht angegeben, wird die Beschreibung aus dem Produkt übernommen.
|
| 75 | Mengeneinheit | C | 3 | Code der Mengeneinheit. Falls nicht angegeben, wird die Mengeneinheit vom Produkt übernommen.
|
| 76 | Menge | N | 18 | Auftragsmenge
|
| 77 | Einzelpreis | M | 18 | Falls nicht angegeben, wird der Preis über das Produkt bestimmt.
|
| 78 | Liefertermin | D | 8 | Optional.
|
| 79 | Preismenge | N | 18 | Falls nicht angegeben, wird die Preismenge über das Produkt bestimmt bzw. auf 1 gesetzt.
|
| 80 | Positionsrabatt | M | 18 | Positionsrabatt in Prozent mit zwei Nachkommastellen.
|
| 81 | Positionswert | M | 18 | Nur für Export. Beim Import wird der Positionswert automatisch aus Preis und Rabatt berechnet.
|
| 82 | Produktart | I | 18 | Wird beim Import nur verwendet, wenn kein Produkt gesetzt ist. 0 = Ware, 1 = Dienstleistung, 2 = Mitgliedsbeitrag (nur Collmex Verein), 3 = Bau/Reinigungs-Dienstleistung
|
| 83 | Steuerklassifikation | I | 8 | Wird beim Import nur verwendet, wenn kein Produkt gesetzt ist. Andernfalls wird die Steuerklassifikation aus dem Produkt ermittelt. 0 = voller Steuersatz, 1 = ermäßigter Steuersatz, 2 = steuerfrei.
|
| 84 | Steuer auch im Ausland | I | 8 | Wird beim Import nur verwendet, wenn kein Produkt gesetzt ist und die Produktart eine Dienstleistung ist. 0 = Sonstige Leistung ist im Inland nicht steuerbar bei Leistungsort im Ausland, 1 = Sonstige Leistung ist im Inland steuerbar auch bei Leistungsort im Ausland.
|
| 85 | Erlösart | I | 8 | Erlösart der Position. Nur für Export. 0 = voller Steuersatz
1 = ermäßigter Steuersatz
2 = steuerfreies Produkt
10 = Export
11 = innergemeinschaftliche Lieferung
12 = Nicht steuerbare Umsätze
13 = Generell steuerbefreit (z.B. Kleinunternehmer)
14 = Leistungsempfänger ist steuerpflichtig |
| 86 | Endgeliefert | I | 8 | Manuelles Endgeliefert-Kennzeichen im Auftragskopf: 0 = nicht endgeliefert, 1 = endgeliefert
|
| 87 | Endabgerechnet | I | 8 | Manuelles Endabgerechnet-Kennzeichen im Auftragskopf: 0 = nicht endabgerechnet, 1 = endabgerechnet
|
| 88 | Umsatz | M | 18 | Nur für Export. Netto-Umsatz der Position
|
| 89 | Kosten | M | 18 | Nur für Export. Produktkosten
|
| 90 | Rohertrag | M | 18 | Nur für Export. Umsatz abzüglich der Kosten
|
| 91 | Marge | M | 18 | Nur für Export. Die Marge der Position in Prozent
|
| 92 | Kosten manuell | M | 18 | Manuell eingegebene Kosten übersteuern die Kosten aus dem Produkt
|
| 93 | Liefersperre | I | 8 | Liefersperren-Kennzeichen im Auftragskopf: 0 = Liefersperre nicht gesetzt, 1 = Liefersperre gesetzt
|
| 94 | Kunde-Keine Mailings | I | 8 | 0 = nicht gesetzt, 1 = keine Mailings (s. Beschreibung Feld 6)
|
| 95 | Gesamtbetrag-Brutto | M | 18 | Nur für Export. Gesamtbetrag inkl. Umsatzsteuer des Kundenauftrags.
|
| 96 | Angebot Nr | I | 8 | Nur für Export. Die Nummer des Angebots, auf das sich der Kundenauftrag bezieht.
|
| 97 | Zahlungsreferenz | C | 80 | Referenz des Zahlungsdienstleisters (z.B. Transaktionsnummer bei Paypal)
|
| 98 | Abw. Empfänger | I | 18 | Die Adressnummer des abweichenden Empfängers.
|
| 99 | Lieferrelevant | I | 18 | Optional. Lieferrelevant-Kennzeichen für die Position. Leer = Standardwert je nach Positionstyp, 0 = nicht lieferrelevant, 1 = lieferrelevant.
|
