CSV-Format

Sesam Rechnungswesen Produkt Version Datei Datum

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG

Sesam Rechnungswesen 2008 CSVFormat.pdf 21.09.2007

CSV Format

Inhaltsverzeichnis Inhaltsverzeichnis Einleitung CSV-Format Datenarten Die wichtigsten Datenarten im CSV-Format Adressen Defaults Beispiel Personenkonto Defaults Beispiel Offene Posten Defaults Beispiel Buchungen Beispiel Verweis auf Steuerbuchungen und Kostenstellenbuchungen

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 2 von 7

2 3 3 3 4 4 4 4 4 4 4 4 4 4 4 5 5 5 5 5 6 6 6 6 6

CSV Format

Einleitung Das Rechnungswesen von SAGE SESAM (REWE) bietet die Möglichkeit zum Austausch einer grossen Fülle von Daten. IM CSV-Format können Adressen, Personenkonti, Offene Posten, Buchungen, Buchungstexte, der Kontenplan, die Konten und Fremdwährungen im- oder exportiert werden. Beim Exportieren über die SAGE SESAM Administration werden alle Sätze einer Datenart im CSV-Format in ein File geschrieben (siehe auch Handbuch Kapitel 'Daten exportieren'). Beim Importieren über das BeamNT werden die Sätze zu den bestehenden hinzugefügt, oder die Bestehenden werden geändert.

CSV-Format CSV ist die Abkürzung für 'Comma Separated Format', welches ursprünglich von Tabellen-Kalkulationen (TK) stammt. In diesem Format gelten drei Grundregeln: 1. Jede Zeile in der TK stellt eine Zeile im CSV dar (neue Zeile: CR-LF). 2. Die einzelnen Zellen der TK werden im CSV durch Kommata getrennt. 3. Alle Werte (auch Zahlen) werden als ASCII-Strings ausgegeben. Weil mit BeamNT keine Tabellen, sondern Datensätze eingelesen werden, gelten hier etwas andere Regeln: 1. Die erste Zeile beschreibt die Namen der einzelnen Felder. (Bsp: Nr,Bezeichnung,Konto) 2. Die zweite bis letzte Zeile enthält die Datensätze. Jede Zeile entspricht einem Datensatz. (Bsp: 1,Text1,1050 2,Text2,1052 3,Text3,1053) 3. Die einzelnen Felder werden mit Kommata getrennt 4. Leere Felder enthalten nichts, ausser Komma als Trennzeichen (Bsp: 1,,1050) => Feld 2 ist leer 5. Enthält ein Feld Kommata, so muss dieses Feld in Gänsefüsschen (") geklammert werden. Man kann auch Felder die kein Kommata enthalten in Gänsefüsschen klammern. BeamNT klammert Zeichenketten immer in Gänsefüsschen. (Bsp: 1,"Text enthält ein Komma (,)","1050") 6. Enthält ein Feld ein Gänsefüsschen (") als Zeichen, so muss es verdoppelt werden. (Bsp: 1,Dieser Text enthält nur ein Gänsefüsschen (""),1050) => aus Feld 2 wird 'Dieser Text enthält nur ein Gänsefüsschen (")'

Datenarten Es können alle Datenarten, die im Dokument TAFFormat.doc beschrieben sind, ebenfalls im CSV-Format ins Rechnungswesen importiert werden. Nachfolgend sind die wichtigsten Datenarten mit Beispielen aufgeführt. Für die detaillierte Feldbeschreibung (Feldkürzel) mit Bedeutung ist das Dokument TAFFormat.doc beizuziehen. Wichtig: Pro Datenart muss eine eigene Datei erstellt werden.

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 3 von 7

CSV Format

Die wichtigsten Datenarten im CSV-Format Adressen AdrId,Sort,Corp... Bezeichnung AdrId

Wertebereich STRING[13]

Bedeutung Eindeutige Identifikation der Adresse.

Defaultwert

Es sind alle übrigen Tag's vom TAF-Format erlaubt (siehe TAFFormat.doc Kapitel Adr). Defaults Für die Tag's Lang, Ccode und Code werden die Defaultwerte der BeamNT-Vorgaben genommen. Beispiel Kreiert oder ändert die Adresse 30 von Muster AG. AdrId,Corp,Line1,Road,ACode,City,TelB 30,“Muster AG“,“Herr Muster“,“Strasse 7“,6340,Baar,“041 769 68 68“

Personenkonto PkKey,AdrId,AccId,Gacc… Bezeichnung PkKey

Wertebereich LONG

Bedeutung Eindeutige Identifikation des Personenkontos.

Defaultwert

Es sind alle übrigen Tag's vom TAF-Format erlaubt (siehe TAFFormat.doc Kapitel PK). Defaults Für die Tag's AccId, ZabId, BnkNr, Payit, Code und WrnLk werden die Defaultwerte der BeamNT-Vorgaben genommen. Folgende Tag's werden von der Adresse übernommen, falls diese nicht übergeben werden: Personenkonto Adresse Bezeichnung CallN Line1 Zusatz 1 CallT TelB Telefonnummer Geschäft Code Code Selber definierbarer Code Text Corp Firma/Name Das Feld Code wird nur dann von der Adresse übernommen, wenn es in den BeamNT-Vorgaben nicht definiert ist. Beispiel Kreiert oder ändert das Personenkonto 30 für Adresse-Nr 30. PkKey,AdrId,AccId,GAcc,Code,Limit Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 4 von 7

CSV Format

30,30,1050,6000,123,20000

Offene Posten OpId,PkKey,Text,DateO,TaxId,ZabId… Bezeichnung OpId PkKey

Wertebereich STRING LONG

Bedeutung Eindeutige Identifikation des Offenen Postens Identifikation des dazugehörenden Personenkontos.

Defaultwert

Es sind alle übrigen Tag's vom TAF-Format erlaubt (siehe TAFFormat.doc Kapitel OP). Defaults Für die Tag's ZabId, BnkNr, Payit, Code und WrnLk werden die Defaultwerte der BeamNT-Vorgaben genommen werden. Folgende Tag's werden vom PK übernommen, falls diese nicht übergeben werden und in den Defaultwerten der BeamNT-Vorgaben leer sind. OP BnkId BnkAc BnkNr ZabId Payit

Personenkonto BnkId BnkAc BnkNr ZabId Payit

Bezeichnung Bankverbindung Bank-/ Postkonto Interne Bank Zahlungsbedingung Zahlungsart

Das Feld Code wird nur dann vom Personenkonto übernommen, wenn es in den BeamNT-Vorgaben nicht definiert ist. Beispiel Kreiert oder ändert den Offenen Posten OP8000 für das Personenkonto 30. OpId,PkKey,Text,DateO,TaxId,ZabId OP8000,30,“OP im CSV-Format“,18.03.2000,USt75,30T

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 5 von 7

CSV Format

Buchungen Bezeichnung BlgNr

Wertebereich LONG

Bedeutung Beleg-Nummer

Defaultwert

Belege können nur erstellt und nicht geändert werden! Falls die Beleg-Nummer schon belegt ist, so wird der Fehler 1322 ausgegeben Es sind alle übrigen Tag's vom TAF-Format erlaubt (siehe TAFFormat.doc Kapitel Blg und Bk). Beispiel Kreiert den Beleg 82 zum Offenen Posten OP8000 mit den einzelnen Buchungszeilen.

BlgNr,Date,AccId,Orig,Type,CAcc,TaxId,TIdx,ValNt,ValTx,Text,PkKey,OpId,Flags 82,18.03.00,1050,1,0,div,,0,2000,0,Sammelbuchung,30,OP8000,1 82,18.03.00,3000,1,1,1050,USt75,3,1116.28,83.72,Sammelbuchung Schliessanlagen,,,0 82,18.03.00,2016,1,1,1050,,0,83.72,1116.28,“7.5% von 1'116.28“,,,0 82,18.03.00,3060,1,1,1050,USt75,5,465.12,34.88,Sammelbuchung Kundenarbeit,,,0 82,18.03.00,2016,1,1,1050,,0,34.88,465.12,“7.5% von 465.12“,,,0 82,18.03.00,3062,1,1,1050,USt75,7,279.07,20.93,Sammelbuchung Beratung,,,0 82,18.03.00,2016,1,1,1050,,0,20.93,279.07,“7.5% von 279.07“,,,0 Beschreibung:

die 1. Datenzeile enthält die Entstehungsbuchung mit Flags=1, der Verknüpfung zum entsprechenden Offenen Posten und Personenkonto und dem Totalbetrag des Belegs. Die 2.-n. Datenzeilen enthalten die einzelnen Buchungssätze.

Verweis auf Steuerbuchungen und Kostenstellenbuchungen Alle Buchungen innerhalb eines Beleges werden nummeriert. Die Nummerierung beginnt mit 1 und wird pro Buchung um 1 erhöht. Gehört zu einer Buchung eine Steuer- oder Kostenstellenbuchung, so wird dies im Feld TIdx (für Steuerbuchung) oder CIdx (für Kostenstellenbuchung) angezeigt. Die Nummer (N) die dort steht, ist die Nummer der Steueroder Kostenstellenbuchung. Ist die Nummer (N) die Zahl Null, so existiert zu dieser Buchung keine Steuer- oder Kostenstellenbuchung. Zu einer Buchung können selbstverständlich auch eine Steuer- und eine Kostenstellenbuchung gehören. Oberes Beispiel mit zusätzlicher Kostenstellenbuchung (letzte Zeile): BlgNr,Date,AccId,Orig,Type,BType,CAcc,TaxId,TIdx,CIdx,ValNt,ValTx,Text,PkKey,OpId,Flags 82,18.03.00,1050,1,0,,div,,0,,2000,0,Sammelbuchung,30,OP8000,1 82,18.03.00,3000,1,1,,1050,USt75,3,,1116.28,83.72,Sammelbuchung Schliessanlagen,,,0 82,18.03.00,2016,1,1,2,1050,,0,,83.72,1116.28,“7.5% von 1'116.28“,,,0 82,18.03.00,3060,1,1,,1050,USt75,5,,465.12,34.88,Sammelbuchung Kundenarbeit,,,0 82,18.03.00,2016,1,1,2,1050,,0,,34.88,465.12,“7.5% von 465.12“,,,0 82,18.03.00,3062,1,1,,1050,USt75,7,8,279.07,20.93,Sammelbuchung Beratung,,,0 82,18.03.00,2016,1,1,2,1050,,0,,20.93,279.07,“7.5% von 279.07“,,,0 82,18.03.00,9001,1,1,1,3062,,0,,279.07,,Kostenstellenbuchung,,,0 Feldumsetzung Version 4.0 auf Version 4.7x/5.0

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 6 von 7

CSV Format

4.0 Blg Datum Kto Grp GKto SId SIdx KIdx BTyp MTyp Code Netto Steuer FW-Betrag Tx1 Tx2 PkKey OpId Flag S/H -

4.7 BlgNr Date AccId Grp CAcc TaxId TIdx CIdx BType MType Code ValNt ValTx ValFW Text Text2 PkKey OpId Flags Type Orig

Im Taf-Dokument unter Kapitel Blg Blg und Bk (identisch) Bk Blg Bk Bk Bk Bk Bk Blg Bk Bk Bk Bk Bk Bk Bk Bk Bk Bk Blg

Anmerkungen: Flags Hilfsflag. Besteht aus der Summe von einem oder mehreren der folgenden Angaben: 1=Entstehungsbuchung zum angegebenen OP. 16=Transitorische Buchung. 32=Exitbuchung, Rückkehrbuchung zur Transitorischen Buchung. 0=alle übrigen Buchungen. Type Buchungsart (0=Debitoren-/Sollbuchung, 1=Kreditoren-/Habenbuchung) Orig Ursprung des Belegs (0=Finanzbuchhaltung, 1=Debitor, 2=Kreditor)

Info-Line: 0848 868 848 [email protected] www.sageschweiz.ch © 09/2007 – Sage Schweiz AG Seite 7 von 7