Schnittstelle SBS Rewe plus Export Offene Posten

Transkript

1 Inhalt 1. Einleitung 2 2. Ausgabe 2 3. Dateiablage 4 4. Dateiaufbau 4 5. Anmeldedialog und OPExport.ini 8 Dokument: Schnittstelle Export Offene Posten.doc Seite: 1 von 9

2 1. Einleitung Die Übergabe der Offenen Posten und des Kunden bzw. Lieferantenstamms an externe Anwendungen erfolgt mittels dem EXE-Moduls OPExport.exe, das mit Commandline- Parametern aufzurufen ist. Alternativ können die Commandline-Parameter auch über die Zwischenablage übergeben werden. Dieses EXE-Modul wird den Herstellern von Fremdsoftware zur Verfügung gestellt. Es verwendet ein DLL-Modul (srvopexport.dll) das aus Kompatibilitätsgründen mit der SBS Rewe plus ausgeliefert wird. Wird das Programm gestartet, öffnet sich für das EXE-Programm folgendes Symbol in der Systray-Leiste, gleichzeitig wird der TL (ACCESS oder SQL) von SBS Rewe plus gestartet (wenn das Programm nicht aktiv ist). Bei der Ausgabe der Offenen Posten werden immer die aktuellst möglichen berücksichtigt. Eine stichtags-bezogene Ausgabe ist nicht vorgesehen. Die Ausgabe des Kunden- bzw. Lieferantenstamms erfolgt immer vollständig. 2. Ausgabe Folgende Commandline-Parameter stehen zur Verfügung: Art der Ausgabe: /OPAUSGABE /KUNDEN /LIEFERANTEN für die allgemein verwendbare Ausgabe der aktuellen Offenen Posten für die Ausgabe des Kundenstamms (nur i.v.m. /OPAUSGABE) für die Ausgabe des Lieferantenstamms (nur i.v.m. /OPAUSGABE) Auswahl der Daten: /M{Mandanten-Nummer} um den auszugebenden Mandanten zu bestimmen /K{Kanzlei-Nummer} um die Kanzlei-Daten auszugeben /KUNDENOP /LIEFERANTENOP um nur Offene Posten der Kunden auszugeben um nur Offene Posten der Lieferanten auszugeben /NURRECHNUNG /NURZAHLUNG um nur Rechnungen auszugeben um nur Zahlungen auszugeben /NURNEUE /WIEDERHOLEN:tt.mm.jjjj um nur noch nicht exportierte Offene Posten auszugeben um den Export vom tt.mm.jjjj zu wiederholen /NURAUSGEGLICHENE um nur die ausgeglichenen OP s auszugeben /TEXTERKENNUNGSKZ:N um mit Texterkennungskennzeichen auszugeben Option: Dokument: Schnittstelle Export Offene Posten.doc Seite: 2 von 9

3 /NOWINDOW um das standardgemäß erscheinende Fenster mit dem Fortschrittsbalken zu unterdrücken Das Programm beendet sich nach der erfolgreichen Ausgabe selbst. Die erzeugte Datei heißt wie folgt: Offene_Posten_{Mandanten-Nr.}.csv bzw. Offene_Posten_Kanzlei_{Kanzlei-Nr.}.csv Kundenstamm_{Mandanten-Nr.}.csv bzw. Kundenstamm_Kanzlei_{Kanzlei-Nr.}.csv Lieferantenstamm_{Mandanten-Nr.}.csv bzw. Lieferantenstamm_Kanzlei_{Kanzlei-Nr.}.csv Hinweis: Feldtrennkennzeichen ist das {Semikolon}. Dokument: Schnittstelle Export Offene Posten.doc Seite: 3 von 9

4 3. Dateiablage Die Dateien werden in das für die SBS Rewe plus definierte Verzeichnis für CSV-Exporte (siehe SRP.INI) ausgegeben. Der Datenbank-Zugriff erfolgt auf die gleiche Weise wie bei der SBS Rewe plus. 4. Dateiaufbau Aufbau der Offene_Posten_{Mandanten-Nr.}.csv bzw. Offene_Posten_Kanzlei_{Kanzlei- Nr.}.csv Name Bedeutung S_Konto Konto-Nr. S_Opnr OP-Nr. S_Datum Rechnungs-/Zahlungsdatum S_Art R = Rechnung, Z = Zahlung S_Beleg Beleg-Nr. S_Text Buchungstext S_Betrag Rechnungs- / Zahlungsbetrag S_Betrag_WKZ Währungskennzeichen des Rechnungs- / Zahlungsbetrag S_Stsa Steuersatz S_Mahn Mahnstufe S_Fall Fälligkeitsdatum S_Madat Mahndatum S_Gegen Gegenkonto S_Kst1 Kostenstelle Kostenkreis 1 S_Kst2 Kostenstelle Kostenkreis 2 S_Kst3 Kostenstelle Kostenkreis 3 S_Sk_Proz1 Skonto Prozentsatz 1 S_Sk_Tage1 Skontotage 1 S_Sk_Proz2 Skonto Prozentsatz 2 S_Sk_Tage2 Skontotage 2 S_A_sk_Betrag Abweichender skontierfähiger Betrag S_Idnr EG-Ust-ID-Nummer S_Stsg Steuerschlüssel Gegenkonto S_Stsk Steuerschlüssel Konto S_Waehrung Währungsbetrag S_Waehrung_WKZ Währungskennzeichen des Währungsbetrag S_Sperr_kz OP-Sperrkennzeichen S_Storno Ja=Stornobuchung, Nein=keine Stornobuchung S_Buchungsjahr Buchungsjahr (Kalenderjahr 4stellig) S_Buchungsmonat Buchungsmonat (Kalendermonat , Dokument: Schnittstelle Export Offene Posten.doc Seite: 4 von 9

5 13=Abschlussbuchung) S_Valuta Valutadatum S_Faellig Fälligkeitstage S_Erfassungsdatum Erfassungsdatum /-Uhrzeit S_OP_ID Eindeutige ID des OP s S_Nr_Ausgleich Ausgleichs-Nr. S_Monat_Ausgleich Monat des OP-Ausgleichs S_Jahr_Ausgleich Jahr des OP-Ausgleichs S_Personengruppe Personengruppe des Kunden oder Lieferanten; existieren mehrere Personengruppen so werden diese durch getrennt S_SkontoBetrag Skontobetrag bei Zahlungen mit Skontoabzug. Bei Rechnungen oder Zahlungen ohne Skonto wird 0 ausgegeben. Dokument: Schnittstelle Export Offene Posten.doc Seite: 5 von 9

6 Aufbau der Kundenstamm_{Mandanten-Nr.}.csv bzw. Kundenstamm_Kanzlei_{Kanzlei- Nr.}.csv Name Bedeutung S_Kunden-Nr. Kunden-Nummer S_LeDat letzten Änderung S_Bezeichnung Kundenbezeichnung S_Adressanrede Adressanrede S_Briefanrede Briefanrede S_Haus_Strasse Hausanschrift Strasse S_Haus_Plz Hausanschrift Postleitzahl S_Haus_Ort Hausanschrift Ort S_Haus_Land Hausanschrift Land S_Post_Strasse Postanschrift Strasse S_Post_Plz Postanschrift Postleitzahl S_Post_Ort Postanschrift Ort S_Post_Land Postanschrift Land S_Telefon Telefon-Nummer (Hauptnummer oder 1. vorkommende Telefonnummer) S_Telefax Telefax-Nummer (Hauptnummer oder 1. vorkommende Telefaxnummer) S_Bank_Name Bankname (des bevorzugten Bankkontos oder des 1. S_Bank_KtoNr Kontonummer (des bevorzugten Bankkontos oder des 1. S_Bank_BLZ Bankleitzahl (des bevorzugten Bankkontos oder des 1. S_Textschluessel Textschlüssel (des bevorzugten Bankkontos oder des 1. S_Zahlart Zahlungsart ( Variabel, Lastschrift oder DTA ) S_Zahlziel Tage Zahlungsziel S_Sk_Tage_1 Skontotage 1 S_Sk_Satz_1 Skontosatz 1 S_Sk_Tage_2 Skontotage 2 S_Sk_Satz_2 Skontosatz 2 S_UStIdNr Umsatzsteuer-Identifikations-Nummer S_Vorzug Vorzugswährung ( DEM oder EUR ) S_Sperre_ZAVE Sperre für Zahlungsverkehr S_Sperre_Mahn Sperre für Mahnwesen S_Kreditlimit Kreditlimit S_Personengruppe Personengruppe des Kunden; existiert der Kunde in mehreren Personengruppen, werden diese durch getrennt Dokument: Schnittstelle Export Offene Posten.doc Seite: 6 von 9

7 Aufbau der Lieferantenstamm_{Mandanten-Nr.}.csv bzw. Lieferantenstamm_Kanzlei_{Kanzlei-Nr.}.csv Name Bedeutung S_Lieferanten-Nr. Lieferanten-Nummer S_LeDat letzten Änderung S_Bezeichnung Lieferantenbezeichnung S_Adressanrede Adressanrede S_Briefanrede Briefanrede S_Haus_Strasse Hausanschrift Strasse S_Haus_Plz Hausanschrift Postleitzahl S_Haus_Ort Hausanschrift Ort S_Haus_Land Hausanschrift Land S_Post_Strasse Postanschrift Strasse S_Post_Plz Postanschrift Postleitzahl S_Post_Ort Postanschrift Ort S_Post_Land Postanschrift Land S_Telefon Telefon-Nummer (Hauptnummer oder 1. vorkommende Telefonnummer) S_Telefax Telefax-Nummer (Hauptnummer oder 1. vorkommende Telefaxnummer) S_Bank_Name Bankname (des bevorzugten Bankkontos oder des 1. S_Bank_KtoNr Kontonummer (des bevorzugten Bankkontos oder des 1. S_Bank_BLZ Bankleitzahl (des bevorzugten Bankkontos oder des 1. S_Textschluessel Textschlüssel (des bevorzugten Bankkontos oder des 1. S_Zahlart Zahlungsart ( Variabel, Scheck, Überweisung oder DTA ) S_Zahlziel Tage Zahlungsziel S_Sk_Tage_1 Skontotage 1 S_Sk_Satz_1 Skontosatz 1 S_Sk_Tage_2 Skontotage 2 S_Sk_Satz_2 Skontosatz 2 S_UStIdNr Umsatzsteuer-Identifikations-Nummer S_Vorzug Vorzugswährung ( DEM oder EUR ) S_Sperre_ZaVe Sperre für Zahlungsverkehr S_Personengruppe Personengruppe des Lieferanten; existiert der Lieferant in mehreren Personengruppen, werden diese durch getrennt Dokument: Schnittstelle Export Offene Posten.doc Seite: 7 von 9

8 5. Anmeldedialog und OPExport.ini Das externe Tool zur Ausgabe der Offenen Posten an Fremdsysteme (OPExport.exe) verfügt über einen Anmeldedialog (siehe Abbildung 1). Dieser sieht genauso aus wie der Dialog zur Anmeldung an der SBS Rewe plus. Innerhalb der SBS Rewe plus muss der Benutzer das entsprechende Benutzerzugriffsrecht auf das Sachgebiet OP-Buchhaltung der (Mandanten-/Kanzlei-) Akte haben. Da dieses Tool bereits in einige Fremdprogramme integriert ist, wurden zwei Wege geschaffen, das Programm auch ohne Anmeldedialog zu starten, ohne jedoch den Datenschutz aus dem Auge zu verlieren. Wird das Tool OPExport.exe mit den Parametern /Login:{Nummer des Anwenders} und /Pwd:{Passwort des Anwenders} gestartet, wird der Anmeldedialog unterdrückt, sofern die übergebenen Werte stimmig waren. Die zweite Variante sieht vor, diese beiden o.g. Angaben in eine Ini-Datei zu hinterlegen. Diese Ini-Datei heißt OPExport.ini und muss im Windows-Verzeichnis liegen. Der Inhalt der OPExport.ini -Datei muss wie folgt sein: [Anmeldung] Login={Nummer des Mitarbeiters} Pwd={Passwort} {...} = hier werden die Werte der SBS Rewe plus eingetragen. Welche Nummer der jeweilige Mitarbeiter in der SBS Rewe plus hat, kann in der Mitarbeiterliste über die Zentralakte geprüft werden. Bsp.: [Anmeldung] Login=1 PWD=MeinPasswort Auch im Falle der Anwendung der OPExport.ini wird der Anmeldedialog nicht angezeigt, wenn die in der Ini-Datei hinterlegten Angaben stimmig sind. Dokument: Schnittstelle Export Offene Posten.doc Seite: 8 von 9

9 Abb. 1: Anmeldedialog der OPExport.exe Dokument: Schnittstelle Export Offene Posten.doc Seite: 9 von 9