AXiDbBhg – Debitoren – Infoniqua Demo

Debitorenobjekt erstellen

GetDebiObj

Parameter

Diese Methode hat keine Parameter.

Returnwert

Gibt als Returnwert einen Pointer auf das Debiobjekt zurück. Wird die Methode mehrmals aufgerufen, werden auch mehrere Objekte erstellt.

Bemerkung

Um die COM-Schnittstelle benützen zu können, muss im VisualBasic die SBSActiveX Library aktiviert werden. Sie wird unter dem Menüpunkt Project – References mit dem Namen „SBSxas X.X.X.X Type Library“ gefunden und aktiviert. X.X.X.X ist die Version der Type Library (z.B. 1.1.9.0)

Alle erstellten Objekte müssen beim Beenden des Programmes dealloziert werden. Die Deallozierung erfolgt umgekehrt als die Allozierung.

Konkret zu den Beispielen:

Set Debitor = Nothing
Set Finanz = Nothing

Beispiel

Beispiel – Automation Schnittstelle:
Dim FinanzSrv, Debitor As Object
Set Finanz = CreateObject("SBSxas.AXFinanz")
Set Debitor = Finanz.GetDebiObj
Beispiel – COM Schnittstelle:
Dim Finanz As AXFinanz
Dim Debitor As AXiDbBhg
Set Finanz = New SBSXASLib.AXFinanz
Set Debitor = Finanz.GetDebiObj

Erläuterungen zur internen Laufnummer bei Debitorenbuchungen

Beschreibung

Im Debitorenobjekt erfolgt der Zugriff auf die Debitorenbuchung oftmals über die interne Laufnummer der Buchung.

Die interne Laufnummer identifiziert die einzelne Debitorenbuchung in der SBS-Datenbank. In der SBS-Datenbank ist die interne Laufnummer im Feld buchung.dklfnbr sowie im Feld debibuchung.lfnbrd gespeichert. In der Dokumentation wird daher auch oft auch die Kurzform „LfNbr“, „lfnbr“, „LfNbrD“, “lfnbrd“, „DKLfNbr“ oder „dklfnbr“ benutzt.

Hinweis: Im Debitorenobjekt wird die Buchung immer über die interne Laufnummer der Debitorenbuchung angesprochen. Diese Laufnummer ist nicht mit der internen Laufnummer der Hauptbuchung zu verwechseln! (àDatenbankfeld buchung.lfnbr, siehe auch das Kapitel Erläuterungen zur internen Laufnummer bei Hauptbuchungen)

Zusatzinformationen

Beschreibung

Zusatzinformationen können hinzugefügt, gelöscht gelesen und modifiziert werden.

Kontaktadressen

Beschreibung

Kontaktadressen können hinzugefügt, gelöscht, gelesen und modifiziert werden.

Debitorenadressen neu schreiben

Beschreibung

Um alle Debitorenstamm-Felder füllen zu können, müssen diverse andere Tabellen vorhanden sein wie z.B. Konditionen-Tabelle, Sprachcode, Country-Code, Währungscode, Mahngruppen und Toleranzen.

Ablauf:

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann die Adresse geschrieben werden.

Das Schreiben einer Debitoren-Adresse erfolgt in 8 verschiedenen Schritten. Die Feldangaben sind in den folgenden Parameterbeschreibungen aufgeführt.

SetCommonInfo2(): zwingend
Mit dieser Methode werden die allgemeinen Informationen abgefüllt.
Eine alternative Methode dazu ist SetCommonInfoAsAdrID2()
SetExtendedInfo8()/SetExtendetInfoDefault8(), bzw
SetExtendedInfo7()/SetExtendedInfoDefault7(), bzw
SetExtendedInfo6()/ SetExtendedInfoDefault6(), bzw
SetExtendedInfo5()/ SetExtendedInfoDefault5(), bzw
SetExtendedInfo4()/ SetExtendedInfoDefault4(), bzw
SetExtendedInfo3()/ SetExtendedInfoDefault3(), bzw
SetExtendedInfo2()/ SetExtendedInfoDefault2(): zwingend
Mit dieser Methode werden die erweiterten Informationen abgefüllt.

SetWebsicherheit1, fakultativ
SetWebsicherheit2, fakultativ
Liefer-, Bestell- und Mahnadresse abfüllen, fakultativ:
SetLieferadresse(): Mit dieser Methode wird die Lieferadresse abgefüllt.
SetBestelladresse(): Mit dieser Methode wird die Bestelladresse abgefüllt
SetMahnadresse(): Mit dieser Methode wird die Mahnadresse abgefüllt.
Hinweis: Individiduelle Adressen können erst nach dem Schreiben einer Debitorenadresse erfasst bzw. zugewiesen werden.
SetZahlungsverbindung3(), bzw
SetZahlungsverbindung2(), bzw
SetZahlungsverbindung(): fakultativ
Mit dieser Methode wird die Zahlungsverbindung abgefüllt.
Individuelle Daten und Zusatzdaten abfüllen, fakultativ:
SetIndividInfoVal(): maximal 12 numerische, individuelle Werte
SetIndividInfoText(): maximal 12 alphanumerische, individuelle Texte
SetZusatzDte(): maximal 6 zusätzliche Daten
SetZusatzText(): maximal 6 zusätzliche Texte, welche über die Methode WriteZusatzText() im AXiAdr Objekt erfasst worden sind. Die ID’s von diesen Texten müssen übergeben werden.
SetKontokorrent(), fakultativ
Mit dieser Methode kann angegeben werden ob es sich bei dieser Adresse um einen Kontokorrent handelt.
WriteDebitor3(), zwingend
Mit dieser Methode wird die Debitorenadresse effektiv geschrieben. In den Schritten 1 bis 7 wurden die einzelnen Felder mit den verschiedenen Werten abgefüllt und mit der Funktion WriteDebitor2 wird die Adresse geschrieben.
GetAdressLaufnr() und GetZahlungsverbLaufnr(), fakultativ
Mit diesen Methoden können die zugeteilten Laufnummer des Adressstammes und Debitorenbank gelesen werden.

SetCommonInfo2

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Integer	Numerisch	Ja	Debitorennummer
2.	Name	String	Alphanumerisch (100)	Ja	Name
3.	Vorname	String	Alphanumerisch (100)	Nein	Vorname
4.	Adresse 1	String	Alphanumerisch (100)	Nein	Adresse 1
5.	Adresse 2	String	Alphanumerisch (100)	Nein	Adresse 2
6.	Adresse 3	String	Alphanumerisch (100)	Nein	Adresse 3
7.	Postfach	String	Alphanumerisch (100)	Nein	Postfach
8.	Country-Code	String	Alphanumerisch (5)	Ja	CH, D, F, I (Autokennzeichen)
9.	PLZ	String	Alphanumerisch (100)	Nein	Postleitzahl
10.	Ort	String	Alphanumerisch (100)	Ja	Ortschaft
11.	Telefon 1	String	Alphanumerisch (40)	Nein	Telefon 1
12.	Telefon 2	String	Alphanumerisch (40)	Nein	Telefon 2
13.	Telefax	String	Alphanumerisch (40)	Nein	Telefax
14.	e-mail	String	Alphanumerisch (40)	Nein	E-Mail Adresse
15.	Region	String	Alphanumerisch (5)	Nein	Region z.B. Kanton Luzern
16.	Währungscode	String	Alphanumerisch (3)	Ja	CHF, EUR, GBP (ISO-Währungscode)
17.	Anrede	String	Alphanumerisch (30)	Nein	Herrn, Frau, Firma etc.
18.	Persönliche Anrede	String	Alphanumerisch (30)	Nein	Persönliche Anrede z.B. Lieber Hans
19.	Ansprechspartner	String	Alphanumerisch (30)	Nein	Externe Referenz des Kontaktstammes Wird eine neue Adresse erfasst oder gibt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters „Ansprechspartner“ für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
20.	Sprachcode	String	Numerisch	Ja	2055 = Deutsche Schweiz, 4108 = Französische Schweiz 2064 = Italienische Schweiz 2057 = Englisch (Grossbritannien)
21.	Text	String	Memotext	Nein	Text
22.	Defaultwährung	String	Alphanumerisch(1)	Nein	Mögliche Werte J oder N, Defaultwert N Beim updaten kann nicht N angegeben werden.
23.	Mobil	String	Alphanumerisch(40)	Nein	Natelnummer

Returnwert

Diese Methode hat keinen Returnwert.

SetCommonInfosAsAdrID2

Beschreibung

Die Methode übernimmt Daten aus dem Adressstamm. Es wird keine neue Adresse angelegt. Die Daten können noch nachträglich durch die nachfolgend aufgerufene Methode SetCommonInfo2() modifiziert werden. Im diesen Fall sind in der Methode SetCommonInfo2() nur diejenigen Parameter aufzuführen, welche modifiziert werden müssen. Falls die Methode SetCommonInfo2() aufgerufen wurde, wird auch der Adressstamm modifiziert.

Hinweis: Diese Methode darf nur mit WriteDebitor aufgerufen werden. Ab Version 2009 wird beim Aufrufen dieser Methode mit UpdateDebitor ein Fehler generiert!
Die Einstellung „Doppelte Debitorenadressen überprüfen“ wird ab Version 2010 überprüft.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Integer	Numerisch	Ja	Debitorennummer
2.	AdressID	Long	Numerisch	Ja	Adressen-Identifikation
3.	Währungscode	String	Alphanumerisch(3)	Ja	CHF, EUR, GBP (ISO-Währungscode)
4.	Text	String	Alphanumerisch(250)	Nein	Text
5.	Defaultwährung	String	Alphanumerisch(1)	Nein	Mögliche Werte J oder N, Defaultwert N

Returnwert

Diese Methode hat keinen Returnwert.

SetExtendedInfo8, SetExtendedInfoDefault8

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Sperren	String	Alphanumerisch(1)	Ja	N=Nein, J=Ja
2.	Kreditlimite	String	Numerisch(17.2)	Nein	Kredit-Limite
3.	Sammelkonto	String	Alphanumerisch(15)	Ja	Sammel-konto
4.	Erlöskonto	String	Alphanumerisch(15)	Ja	Erlös-Konto
5.	Sachbearbeiter-ID	String	Alphanumerisch(5)	Nein	Sachbearbeiter-Identifikation
6.	VerkaeuferID	String	Alphanumerisch(5)	Nein	Verkaeufer-Identifikation
7.	Vorschlag KST	String	Alphanumerisch(15)	Nein	Vorschlag Kostenstelle
8.	ZahlungskonditionenNr	String	Numerisch	Ja	1 bis n (aus SBS-Konditionen-Tabelle)
9.	Toleranznummer	String	Numerisch	Nein	Wird nicht mehr verwendet
10.	Mahngruppe	String	Numerisch	Ja	1 bis n (aus SBS-Mahnguppen-Tabelle) Dialog: Feld „Kundengruppe 3“ aus Debitorenstamm (Seite 5).
11.	MahnSperreBis	String	Datum(4,2,2)	Nein	JJJJMMDD
12.	ABC-Code	String	Alphanumerisch(1)	Nein	ABC-Code
13.	Werbung Ja/Nein	String	Alphanumerisch(1)	Ja	N=Nein, J=Ja
14.	Abteilung	String	Alphanumerisch(15)	Nein	Aus SBS-Abteilungs-Tabelle. Bemerkung: Dialog:Feld „Gebiet“ aus Debitorenstamm
15.	Marktzughg	String	Numerisch	Nein	Defaultwert 1, Gemäss Codetabelle – Einträge „Marktzugehörigkeit“
16.	UmsStID	String	Alphanumerisch(15)	Nein	Umsatzsteuer ID – Defaultwert “NOT_SET” (leer)
17.	MahngebuehrJN	String	Alphanumerisch(1)	Nein	N=Nein, J=Ja Defaultwert “NOT_SET” ’J’
18.	LieferantenNr	String	Alphanumerisch(30)	Nein	Defaultwert “NOT_SET”’ (leer)
19.	Matchcode	String	Alphanumerisch(30)	Nein	Defaultwert “NOT_SET” (leer)
20.	MahnsperrCode	String	Alphanumerisch(5)	Nein	Mahnsperrcode, Defaultwert “NOT_SET” (leer)
21.	Auszahlmode	String	Numerisch	Nein	0 = Keine Auszahlung (Default) 1 = Auszahlung Haben-Saldo über Kreditoren 2 = Auszahlung Haben-Posten über Kreditoren 3 = Auszahlung Zahlung-Posten über Kreditoren 4 = Auszahlung Posten mit Zahlungsverbindung Verfahrenstyp Auszahlung 5=Kontokorrent (Verrechnung) 6=Kontokorrent (Verrechnung/Auszahlung) 7=Kontokorrent – Keine Verrechnung
22.	LetzterZins	String	Datum(4,2,2)	Nein	Default = (leer)
23.	Stammcode	String	Numerisch	Nein	Code, welcher bei jedem Kontakt hinterlegt werden kann. Die Codes können im Admin unter Codes beim Typ „Stammcode“ erfasst werden. 0 = keine Selektion
24.	ITelefon	String	Alphanumerisch(50)	Nein	Internet-Telefonnummer (VoIP)
25.	SMSJN	String	Alphanumerisch(1)	Nein	J/N, Defaultwert J
26.	Internet	String	Alphanumerisch(255)	Nein	URL vom Internet
27.	Statistikcode	String	Alphanumerisch(15)	NEIN	Achtung, die Einstellungen für den Statistikcode werden nicht berücksichtigt.

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Die Methoden SetExtendedInfo2()/SetExdendedInfoDefault2() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 17 Parameter.

Die Methoden SetExtendedInfo3()/SetExdendedInfoDefault3() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 18 Parameter.

Die Methoden SetExtendedInfo4()/SetExdendedInfoDefault4() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 19 Parameter.

Die Methoden SetExtendedInfo5()/SetExdendedInfoDefault5() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 21 Parameter.

Die Methoden SetExtendedInfo6()/SetExdendedInfoDefault6() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 25 Parameter.

Die Methoden SetExtendedInfo7()/SetExdendedInfoDefault6() stehen immer noch zur Verfügung,
benötigen jedoch nur die ersten 26 Parameter.

Mit der Methode SetExtendedInfoDefault5 und höher können die Daten aus Debitor-Vorschlag übernommen werden. Dazu muss bei den nachfolgend genannten Feldern der String DEFAULT übergeben werden.

Dies gilt nur für folgende Felder:
Kreditlimite(2), Sammelkonto(3), Erlöskonto(4), Sachbearbeiter(5), Verkaeufer ID(6), Vorschlag KST(7) , Zahlungskonditionennummer(8), Mahngruppe(10), ABC-Code(12) , Abteilung(14), Marktzughg(15), MahngebuehrJN(17), Auszahlmode(21), LetzterZins(22)

SetWebsicherheit1

Beschreibung

Mit der Methode SetWebsicherheit1 können Webshop Daten gesetzt werden. Diese Felder sind in Finanz nur aktiv wenn der Webshop aktiviert ist.

Hinweis: Ab Version 2010 sollte nur noch SetWebsicherheit2 verwendet werden!

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Passwort	String	Alphanumerisch(30)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
2.	EAnteilNr	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
3.	TeilnehmerID1	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
4.	TeilnehmerID2	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
5.	EBillAccountNr	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)

Returnwert

Diese Methode hat keinen Returnwert.

SetWebsicherheit2

Beschreibung

Mit der Methode SetWebsicherheit2 können Webshop Daten gesetzt werden. Diese Felder sind in Finanz nur aktiv wenn der Webshop aktiviert ist.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Login	String	Alphanumerisch(255)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
2.	Passwort	String	Alphanumerisch(30)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
3.	EAnteilNr	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
4.	TeilnehmerID1	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
5.	TeilnehmerID2	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)
6.	EBillAccountNr	String	Alphanumerisch(35)	Nein	Nur mit Webshop (normalerweise nicht sichtbar in Finanz)

Returnwert

Diese Methode hat keinen Returnwert.

Liefer-, Bestell- und Mahnadresse abfüllen

SetLieferadresse

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Lieferadresse: Anrede	String	Alphanumerisch(30)	Nein	Lieferadresse: Anrede
2.	Lieferadresse: Pers. Anrede	String	Alphanumerisch(50)	Nein	Lieferadresse: Persönliche Anrede
3.	Lieferadresse: Ans. Partner	String	Alphanumerisch(50)	Nein	Ansprechspartner=Default Kontakt Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Wird eine neue Adresse erfasst oder gibt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters „Ansprechspartner“ für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
4.	Lieferadresse_ID	String	Numerisch	Nein	Ist dieser Wert 0, wird die Adressnummer des neuen Debitors verwendet.

Returnwert

Diese Methode hat keinen Returnwert.

SetMahnadresse

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Mahnadresse: Anrede	String	Alphanumerisch (30)	Nein	Mahnadresse: Anrede
2.	Mahnadresse:Pers. Anrede	String	Alphanumerisch (50)	Nein	Mahnadresse. Persönliche Anrede
3.	Mahnadresse :Ans. Partner	String	Alphanumerisch (50)	Nein	Ansprechspartner=Default Kontakt Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Wird eine neue Adresse erfasst oder gibt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters „Ansprechspartner“ für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
4.	Mahnadresse_ID	String	Numerisch	Nein	Ist dieser Wert 0, wird die Adressnummer des neuen Debitors verwendet.

Returnwert

Diese Methode hat keinen Returnwert.

SetBestelladresse

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Bestelladresse: Anrede	String	Alphanumerisch (30)	Nein	Bestelladresse: Anrede
2.	Bestelladresse:Pers. Anrede	String	Alphanumerisch (50)	Nein	Bestelladresse: Persönliche Anrede
3.	Bestelladresse:Ans. Partner	String	Alphanumerisch (50)	Nein	Ansprechspartner=Default Kontakt Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Wird eine neue Adresse erfasst oder gibt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters „Ansprechspartner“ für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
4.	Bestelladresse_ID	String	Numerisch	Nein	Ist dieser Wert 0, wird die Adressnummer des neuen Debitors verwendet.

Returnwert

Diese Methode hat keinen Returnwert.

SetZahlungsverbindung, SetZahlungsverbindung2, SetZahlungsverbindung3

Parameter

Die Methode SetZahlungsverbindung() steht immer noch zur Verfügung, benötigt jedoch nur die ersten 16 Parameter.
Die Methode SetZahlungsverbindung2() steht immer noch zur Verfügung, benötigt jedoch nur die ersten 19 Parameter.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	ZaVerbNr: BankTyp	String	Alphanumerisch (1)	Ja	B=Bank, P=Post, S=ZA, K=Kreditkarte
2.	ZaVerbNr: BankKtonr.	String	Alphanumerisch (30)	Nein	Bankkontonummer
3.	ZaVerbNr: BankName	String	Alphanumerisch (30)	Nein	Bankname
4.	ZaVerbNr: BankAdr. 1	String	Alphanumerisch (30)	Nein	Bank-Adresse 1
5.	ZaVerbNr: BankAdr. 2	String	Alphanumerisch (30)	Nein	Bank-Adresse 2
6.	ZaVerbNr: BankPLZ	String	Alphanumerisch (10)	Nein	Postleitzahl der Bank
7.	ZaVerbNr: BankOrt	String	Alphanumerisch (30)	Nein	Ortschaft der Bank
8.	ZaVerbNr: BankLand	String	Alphanumerisch (5)	Ja	CH, D, F, I (Autokennzeichen)
9.	ZaVerbNr: BankClearing	String	Alphanumerisch (12)	Nein	Clearing-Nummer der Bank
10.	ZaVerbNr: BankAktiv	String	Alphanumerisch (1)	Ja	Bank aktiv: (J)a, (N)ein Beim Neuerfassen eines Debitors wird dieser Wert immer automatisch mit „J“ überschrieben, da die neue Bank automatisch als Vorschlag gesetzt wird.
11.	ZaVerbNr: BankSwift	String	Alphanumerisch (30)	Nein	SWIFT-Nummer der Bank
12.	ZaVerbNr: BankTeilnNr.	String	Numerisch (9)	Nein	Teilnehmernummer
13.	ZaVerbNr: BankPCKonto	String	Alphanumerisch (30)	Nein	Postcheck-Konto der Bank
14.	Bankleitzahl	String	Alphanumerisch (20)	Nein	Defaultwert NOT_SET Wird nicht mehr verwendet
15.	IBAN	String	Alphanumerisch(35)	Nein	Defaultwert NOT_SET
16.	ExtZlgVerbNr	String	Alphanumerisch(30)	Nein	Defaultwert NOT_SET
17.	LSVMode	String	Numerisch	Nein	Defaultwert: NOT_SET(0, NOT_UPD)
18.	ERMAusgangDte	String	Datum(4,2,2)	Nein	Defaultwert: NOT_SET(19000101, NOT_UPD)
19.	ERMEingangDte	String	Datum(4,2,2)	Nein	Defaultwert: NOT_SET(19000101, NOT_UPD)
20.	VordispBankNbr	String	Numerisch	Nein	Laufnummer der vordisponierten, eigenen Zahlungsverbindung. Ist nur zwingend beim Typ (K)reditkarte. Defaultwert NOT_SET bzw. NOT_UPD
21.	VisaArt	String	Alphanumerisch(30)	Nein	Kreditkarten-Art. Defaultwert NOT_SET
22.	VisaVerfall	String	Alphanumerisch(15)	Nein	Kreditkarten-Verfall Defaultwert NOT_SET
23.	VisaCVC	String	Alphanumerisch(15)	Nein	Kreditkartenprüfziffer Defaultwert NOT_SET

Mögliche Werte für LSVMode:

1 = Einzug LSV/Debit direct Schweiz mit Widerspruchmöglichkeit

2 = Einzug LSV/Debit direct Schweiz ohne Widerspruchmöglichkeit

3 = Einzug Überweisungsaufforderung

4 = Auszahlung über Kreditoren

11 = Einzug LSV Deutschland Einzugsermächtigung

12 = Einzug LSV Deutschland Abbuchungsermächtigung

13 = Einzug Überweisungsaufforderung

14 = Auszahlung über Kreditoren

Returnwert

Diese Methode hat keinen Returnwert.

Individuelle Daten und Zusatzdaten abfüllen

SetIndivInfoVal

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	Short	Numerisch	Ja	1 – 12
2.	User Wert	String	Numerisch(17.2)	Nein	Individueller numerischer Wert

Returnwert

Diese Methode hat keinen Returnwert.

SetIndivInfoText

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	Short	Numerisch	Ja	1 – 12
2.	User Text	String	Alphanumerisch(50)	Nein	Individueller alphanumerischer Wert

Returnwert

Diese Methode hat keinen Returnwert.

SetZusatzDte

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	FeldNummer	Short	Numerisch	Ja	1 – 6, repräsentiert Datenfeldnummer auf dem Tab „Individuelle Zusätze“ im Debitorenstamm der Applikation
2.	Datum	String	Datum(4,2,2)	Nein	Individuelles Datum (JJJJMMDD)

Returnwert

Diese Methode hat keinen Returnwert.

SetZusatzText

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BoxNummer	Short	Numerisch	Ja	1 – 6, repräsentiert Nummer des Comboboxes auf dem Tab „Individuelle Zusätze“ im Debitorenstamm der Applikation
2.	ZusatzTextID	String	Alphanumerisch(15)	Ja	ID des Textes, Welche in der Methode WriteZusatzText als HelpID Parameter mitgegeben wurde. Die Boxnummer muss mit dem Parametern AusBox dieser Methode identisch sein.

Returnwert

Diese Methode hat keinen Returnwert.

SetKontokorrent

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

KontokorrentJN

String

Alphanumerisch(1)

Nein

(J/N) Ja/Nein

Wird diese Methode nicht aufgerufen, wird der Defaultwert Nein übernommen.

Returnwert

Diese Methode hat keinen Returnwert.

Reservierter Adressnummerbereich ignorieren

SetCheckReservierterNbrBereich

Beschreibung

Der reservierte Adressnummernbereich wird beim Speichern eines neuen Debitors überprüft. Die Methode muss vor dem Schreiben eines Debitors aufgerufen werden.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	CheckResAdrBereich	String	Alphanumerisch(1)	Ja	Zugelassene Werte: „J“ für überprüfen und „N“ für ignorieren

Returnwert

Die Methode hat keinen Returnwert.

Beispiel

Siehe Adressobjekt

WriteDebitor3

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

duplizieren

Long

Numerisch

0-es wird ein Debitor geschrieben, welchen es bis anhin in keiner Währung gibt (Multicurrency nicht erlaubt)

1-es wird ein Debitor geschrieben, welchen es schon in einer anderen Währung gibt (Multicurrency erlaubt).

EigeneBankID

String

Numerisch

Nein

Bank-ID aus dem Bankenstamm (zugänglich im Adressenobjekt)

Defaultvalue = 0

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Wird die Methode WriteDebitor3(dup) mit dem dup = 0 aufgerufen, so kann sie mit dem Fehler 200 beenden, falls es schon einen Debitoren mit identischen Debitor-Nummer gibt. Auf die Währung wird dabei nicht geachtet. Der Debitor wird nicht gespeichert. Soll dieser Debitor gespeichert werden (denn diesen Debitor mit der mitgegebenen Währung es noch nicht gibt), so muss die Methode WriteDebitor3 mit dem Parameter dup = 1 aufgerufen werden. Es reicht, wenn der Parameter dup gleich 1 gesetzt wird und die Methode noch ein mal aufgerufen wird. Die Set-Methoden (CommonInfo, ExtendedInfo usw.) müssen dabei nicht mehr aufgerufen werden. Falls auch nach dem Aufruf der Methode WriteDebitor3, wobei dup = 1, der Fehler 200 gemeldet wird, bedeutet das, dass es diesen Debitoren in der eingegebenen Währung schon gibt.

Diese Methode kann immer mit dem Parameter dup=1 aufgerufen werden. So ist die Multicurrency erlaubt und es wird nicht getestet, ob es schon einen Debitoren mit der gleichen Nummer gibt.

GetAdressLaufnr

Parameter

Diese Methode hat keine Parameter.

Returnwert

Numerischer Returnwert representiert die Adress-ID des Debitors im Adressstamm

GetZahlungsverbLAufnr

Parameter

Diese Methode hat keine Parameter.

Returnwert

Numerischer Returnwert representiert die Bank-ID der Bank des Debitors

Beispiel

debinr = 55556
DebiName = „Test Debitor D“: Ort = „Altishofen“
WhgID = „EUR“: Sprachcode = 1029: CountryCode = „D“
Call Debi.SetCommonInfo2(debinr, DebiName, Vorname, Adresse1,Adresse2, _
Adresse3, Postfach, CountryCode, PLZ, Ort, Telefon1, Telefon2, _
Telefax, email, Region, WhgID, Anrede, PersAnrede, AnsPartner, _ Sprachcode, Text)
Sammelkonto = 1101
Erloskonto = 3200
ZahlungsKonditionNbr = 1
WerbungJaNein = „N“: Sperren = „N“: ToleranzNbr = 1: Mahngruppe = 1
MahnenJaNein = „J“: Kreditlimite = 1234.55
Call Debi.SetExtendedInfo2(Sperren, Kreditlimite, Sammelkonto, _
Erloskonto, SachbearbeiterID, VerkaeuferID, VorschlagKST, _
ZahlungsKonditionNbr, ToleranzNbr, Mahngruppe, MahnenJaNein, ABCCode, _
WerbungJaNein, abteilung...)
Call Debi.SetLieferadresse(Anrede, PersAnrede, AnsPartner)
Call Debi.SetMahnadresse(Anrede, PersAnrede, AnsPartner)
BankTyp = „B“: BankLand = „A“: BankKontoNr = „KO-1234.1.000-34/2“
BankName = “My Bank”: BankAktiv = “J”
Call Debi.SetZahlungsverbindung(BankTyp, BankKontoNr, BankName, _
BankAdr1, BankAdr2, BankPLZ, BankOrt, BankLand, BankClearingNr, _
BankAktiv, BankSwift, BankTeilnNbr, BankPCKonto)
For n = 1 To 12
   Call Debi.SetIndividInfoText(n, “USerText” + Str(n))
   UserValueN = 6000000.99
   Call Debi.SetIndividInfoVal(n, UserValueN)
Next n
Call Debi.WriteDebitor3(0)
AdrId = Debi.GetAdressLaufnr
Bank = Debi.GetZahlungsverbLaufnr

Debitorenadressen mutieren

UpdateDebitor2

Beschreibung

Das Verfahren ist genau gleich wie wenn eine Adresse neu geschrieben wird. Mit dem Unterschied, dass am Schluss nicht die Funktion WriteDebitor3() sondern UpdateDebitor2() aufgerufen wird. Die Methoden werden in der gleichen Reihenfolge aufgerufen wie bei der Funktion WriteDebitor3().

Die Methode UpdateDebitor2 bietet eine Möglichkeit die Default-Zahlungsverbindung durch den fakultativen Parameter DefaultZahlungsverbindungID zu ändern. Wird auch die Methode SetZahlungsverbindung aufgerufen und im Aufruf der Methode UpdateDebitor2 der Parameter DefaultZahlungsverbindungID mitgegeben, so wird die Bank, welche durch den Parameter DefaultZahlungsverbindungID identifiziert ist, so mutiert, wie es die Parameter der Methode Setzahlungsverbindung angeben und diese Bank wird zu Default-Bank. Falls vorher keine Zahlungsverbindung vorhanden war, wird keine neue angelegt und die Methode UpdateDebitor schlägt fehl. Um eine Zahlungsverbindung nachträglich zu schreiben ist die Methode WriteBank2 im gleichen Objekt bestimmt.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	ZahlungsverbindungID	String	Numerisch	Nein	Dafault-Zahlungsverbindung-ID des Debitors (zugänglich im Debitorenobjekt – Methode ReadZahlungsverb)
2.	EigeneBankID	String	Numerisch	Nein	Bank-ID aus dem Bankenstamm (zugänglich im Adressenobjekt – Methode ReadZahlungsverbindung)

Bemerkung

Hinweis: Felder, welche nicht überschrieben werden sollen, müssen die Konstante NOT_UPD erhalten. (Felder werden nicht verändert). Es werden alle Felder, nicht nur diejenigen in den aufgerufenen Methoden, aktualisiert.à Ausnahme: Währungscode muss immer eingegeben werden. Er darf nicht NOT_UPD sein. Durch Debitornummer und Währungscode wird der eigentliche Debitor bestimmt.

Falls der Defaultwert eines Strings ein Leerstring ist, werden alle Werte, ohne „NOT_UPD“, mit einem leeren String aktualisiert ausser KontokorrentJN wird auf Nein gesetzt. Dadurch werden auch die numerisch dargestellte Werte mit 0 oder 0.0 überschrieben. Deshalb ist es zwingend jede Methode aufzurufen.

Das Bearbeiten der Liefer-, Bestell- und Mahnadressen über die Methoden SetLieferadresse, SetBestelladresse bzw. SetMahnadresse hat beim Updaten des Debitors keine Wirkung mehr. Zum Bearbeiten dieser Adressen sind die Methoden unter Bestell-, Liefer-, Mahnadressen bzw. Individuelle Adressen zu verwenden.

Methoden-Reihenfolge (siehe auch Debitorenadressen neu schreiben):

Returnwert

Diese Methode hat keinen Returnwert.

Bestell-, Liefer- und Mahnadresse

Beschreibung

Bestell, Liefer und Mahnadressen können einem Debitor hinzugefügt, gelesen und gelöscht werden. Da die Parameter der Methoden für das Bearbeiten der Bestell-, Liefer- und Mahnadressen identisch sind, werden sie hier gemeinsam dokumentiert.

Hinweis: Die gleiche Funktionalität kann auch mit den neuen Methoden unter Individuelle Adressen erreicht werden. Die hier beschriebenen Methoden werden nicht weiterentwickelt.

Neue Bestell-, Liefer bzw. Mahnadresse hinzufügen

AddBestelladresse, AddLieferadresse, AddMahnadresse

Beschreibung

Mit diesen Methoden können einem Debitore eine neue Bestell-, Liefer- bzw. Mahnadresse zugewiesen werden.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer
2.	Prioritaet	String	Numerisch	Ja	Priorität
3.	Anrede	String	Alphanumerisch(30)	Nein	Anrede
4.	PersAnrede	String	Alphanumerisch(50)	Nein	Persönliche Anrede
5.	AnsPartner	String	Alphanumerisch(50)	Nein	Ansprechspartner=Default Kontakt Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Wird eine neue Adresse erfasst oder gibt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters „Ansprechspartner“ für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet. Diese Verbindung kann mit dem Schlüsselwort „NOT_SET“ gelöscht werden.
6.	Adressnummer	String	Numerisch	Ja	Bestehende Adressnummer der Bestell-, Liefer- bzw. Mahnadresse.

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Debi.AddBestelladresse(DebitorNr,Prioritaet, Anrede, PersAnrede, AnsPartner, BestelladresseID)

Lesen von Bestell-, Liefer- bzw. Mahnadressen

ReadBestelladressen, ReadLieferadressen, ReadMahnadressen

GetBestelladresse, GetLieferadresse, GetMahnadresse

Beschreibung

Die Bestell-, Liefer- bzw. Mahnadressen werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum Initialisieren der Liste ist die Methode Read-Methode und zum Auslesen die Get-Methode vorhanden.

Parameter

Parameter der Read-Methoden

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer

Returnwert

Die Read-Methoden initialisieren das Lesen und geben keinen Returnwert zurück.

Die Get-Methoden geben als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Adressnummer	Adressnummer
2.	Prioritaet	Priorität
3.	Anrede	Anrede
4.	PersAnrede	Persönliche Anrede
5.	AnsPartner	Externe Referenz des Kontaktstammes
6.	Name	Name der Adresse
7.	Adresse 2	Adressfeld 2 der Adresse
8.	PLZ	Postleitzahl der Adresse
9.	Ort	Ort der Adresse
10.	Telefon1	Telefonfeld 1 der Adresse
11.	KontaktNbr	Interne Laufnummer des Default-Kontakts
12.	Status	Status: 0=Aktiv, 1=Provisorisch, 2=Inaktive
13.	Vorschlag	Ist die Adresse Vorschlag: J,N
14.	ExtReferenz	Externe Referenz des Default-Kontakts
15.	Versandart	Vorschlag Versandart (für elektronischer Mahnbriefversand)

Beispiel

Call Debi.ReadBestelladressen(1000)
lab:
zeile = Debi.GetBestelladresse()
If zeile = “EOF” Then GoTo iyend
GoTo lab
iyend:

Löschen von Bestell-, Liefer- bzw. Mahnadressen

DropBestelladresse, DropLieferadresse, DropMahnadresse

Beschreibung

Mit diesen Methoden können vorhandene Bestell-, Liefer- bzw. Mahnadressen gelöscht werden.

Parameter

Parameter der Drop-Methoden

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer
2.	Adressnummer	String	Numerisch	Ja	Adressennummer

Returnwert

Diese Methoden haben keinen Returnwert.

Beispiel

Call Debi.DropBestelladresse(DebitorNr, BestelladresseID)

Individuelle Adressen

Beschreibung

Individuelle Adressen können hinzugefügt, gelesen und gelöscht werden.

Hinweis: Mit dieser Methode können auch jederzeit Bestell-, Mahn- und Lieferadressen bearbeitet werden Damit können die Methoden der Bestell-, Liefer-, Mahnadressen ersetzt werden. Die restlichen individuellen Adressen (Rechnungsadresse, individuelle Adressen 1 bis 6) können nur bearbeitet werden, wenn die Option „Individuelle Belegdaten“ in SBS aktiviert ist (zur Unterscheidung der Adressen siehe Parameter „Typ“).

Neue individuelle Adresse hinzufügen

AddIndivAdresse2

AddIndivAdresse3

Beschreibung

Die Methode AddIndivAdresse steht immer noch zur Verfügung, benötigen jedoch nur die ersten 9 Parameter.

Mit dieser Methode können neue individuelle Adressen zu einem Debitor hinzugefügt werden.

Für die Methode AddIndivAdresse3 wurde der Pameter «EmailVersand» hinzugefügt.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer
2.	Prioritaet	String	Numerisch	Nein	NOT_SET=1
3.	Anrede	String	Alphanumerisch(30)	Nein	Anrede
4.	PersAnrede	String	Alphanumerisch(50)	Nein	Persönliche Anrede
5.	ExtReferenz	String	Alphanumerisch(50)	Nein	Default Kontakt (ehemals Ansprechspartner) Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Gbt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
6.	AdrNbr	String	Numerisch	Ja	Die zu verwendende Adresse.
7.	Typ	String	Alphanumerisch(1)	Ja	Adresstyp: “1“ bis „6“ =Indidivuelle Adresse 1 bis 6 M=Mahnadresse L=Lieferadresse S=Bestelladresse Z=Rechnungsadresse
8.	isVorschlag	String	Alphanumerisch(1)	Nein	(J)a, (N)ein. NOT_SET=J
9.	Status	String	Numerisch	Nein	1=Aktiv, 2=Provisorisch, 3=Inaktiv NOT_SET=1
10.	Versandart	String	Alphanumerisch(1)	Nein	P=Post, E=E-Mail, F=Telefax NOT_SET=P
11.	EmailVersand	String	Alphanumerisch(255)	Nein

Returnwert

Diese Methoden haben keinen Returnwert.

Bestehende individuelle Adresse modifizieren

UpdateIndivAdresse2

UpdateIndivAdresse3

Beschreibung

Die Methode UpdateIndivAdresse steht immer noch zur Verfügung, benötigen jedoch nur die ersten 9 Parameter.

Mit dieser Methode können die Attribute bestehender individueller Adressen eines Debitors geändert werden. Die Parameter entsprechen exakt der Methode AddIndivAdresse() (siehe Neue individuelle Adresse hinzufügen). Den Parametern können zusätzlich der Wert „NOT_UPD“ mitgegeben werden.

Für die Methode UpdateIndivAdresse3 wurde der Pameter «EmailVersand» hinzugefügt.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer
2.	Prioritaet	String	Numerisch	Nein	NOT_SET=1
3.	Anrede	String	Alphanumerisch(30)	Nein	Anrede
4.	PersAnrede	String	Alphanumerisch(50)	Nein	Persönliche Nummer
5.	ExtReferenz	String	Alphanumerisch(50)	Nein	Default Kontakt (ehemals Ansprechspartner) Mit diesem Parameter kann der Default-Kontakt bestimmt werden. Der Parameter muss dem Feld „Externe Referenz“ des Kontaktstammes entsprechen. Gbt es keinen Kontakt mit der entprechenden Externen Referenz, wird ein neuer Kontakt angelegt. Dabei wird der Inhalt des Parameters für die Felder „Name“ und „Externe Referenz“ des Kontaktstammes verwendet.
6.	AdrNbr	String	Numerisch	Ja	Die zu verwendende Adresse.
7.	Typ	String	Alphanumerisch(1)	Ja	Adresstyp: “1“ bis „6“ =Indidivuelle Adresse 1 bis 6 M=Mahnadresse L=Lieferadresse S=Bestelladresse Z=Rechnungsadresse
8.	isVorschlag	String	Alphanumerisch(1)	Nein	(J)a, (N)ein. NOT_SET=J
9.	Status	String	Numerisch	Nein	1=Aktiv, 2=Provisorisch, 3=Inaktiv NOT_SET=1
10.	Versandart	String	Alphanumerisch(1)	Nein	P=Post, E=E-Mail, F=Telefax NOT_SET=P
11.	EmailVersand	String	Alphanumerisch(255)	Nein

Returnwert

Diese Methode hat keinen Returnwert.

Lesen von individuellen Adressen

ReadIndivAdressen, GetIndivAdressen

Beschreibung

Die individuellen Adressen eines Typs werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum Initialisieren der Liste ist die Methode ReadIndivAdressen und zum Auslesen GetIndivAdresse vorhanden

Parameter

Parameter von ReadIndivAdressen

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

DebitorNr

String

Alphanumerisch

Debitorennummer

Typ

String

Alphanumerisch

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

M=Mahnadresse
L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

Returnwert

ReadIndivAdressen() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetIndivAdresse gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	Adressnummer	Adressnummer
2.	Prioritaet	Priorität
3.	Anrede	Anrede
4.	PersAnrede	Persönliche Anrede
5.	AnsPartner	Externe Referenz des Kontaktstammes
6.	Name	Name der Adresse
7.	Adresse 2	Adressfeld 2 der Adresse
8.	PLZ	Postleitzahl der Adresse
9.	Ort	Ort der Adresse
10.	Telefon1	Telefonfeld 1 der Adresse
11.	KontaktNbr	Interne Laufnummer des Default-Kontakts
12.	Status	Status: 0=Aktiv, 1=Provisorisch, 2=Inaktive
13.	Vorschlag	Ist die Adresse Vorschlag: J,N
14.	ExtReferenz	Externe Referenz des Default-Kontakts
15.	Versandart	Vorschlag Versandart (für elektronischer Mahnbriefversand)

Löschen von individuellen Adressen

DropIndivAdresse

Beschreibung

Mit dieser Methode können individuelle Adressen gelöscht werden.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

DebitorNr

String

Numerisch

Debitorennummer

AdrNbr

String

Numerisch

Adressnummer

Typ

String

Alphanumerisch

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

M=Mahnadresse
L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

Returnwert

Diese Methode hat keinen Returnwert.

Existenz einer individuellen Adresse überprüfen

CheckIndivAdresse

Beschreibung

Mit dieser Methode kann überprüft werden, ob eine individuelle Adresse bereits besteht oder nicht.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

DebitorNr

String

Alphanumerisch

Debitorennummer

Typ

String

Alphanumerisch

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

M=Mahnadresse
L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

AdressNr

String

Numerisch

Adressnummer der individuellen Adresse

Returnwert

CheckIndivAdresse gibt als Returnwert einen BOOL-Wert zurück. Existiert die individuelle Adresse ist dieser Wert WAHR, ansonsten FALSCH.

Default-Adresse und Default-Kontakt holen

GetDefaultAdrLinkNbr, GetDefaultKontaktNbr

Beschreibung

Mit der Methode GetDefaultAdrLinkNbr erhält man die Adressnummer, deren Adresse als Vorschlag gesetzt ist. Mit der Methode GetDefaultKontaktNbr erhält man die interne Kontaktnummer, die bei der angegebenen Adresse als Vorschlag gesetzt ist.

Parameter

Parameter von GetDefaultAdrLinkNbr.

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

DebitorNr

String

Alphanumerisch

Debitorennummer

Typ

String

Alphanumerisch

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

M=Mahnadresse
L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

Parameter von GetDefaultKontaktNbr.

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

DebitorNr

String

Alphanumerisch

Debitorennummer

Typ

String

Alphanumerisch

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

M=Mahnadresse
L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

AdressNr

String

Numerisch

Adressnummer der individuellen Adresse

Returnwert

GetDefaultAdrLinkNbr gibt als numerischen Returnwert die Adressnummer zurück.

GetDefaultKontaktNbr gibt als numerischen Returnwert die Kontaktnummer zurück. Hat die angegebene Adresse keinen Kontakt als Vorschlag definiert, ist der Returnwert 0.

Debitorenbeleg neu schreiben

Beschreibung

Um alle Felder eines Debitoren-Beleges zu füllen, muss der Debitor selber, sowie Angaben in diversen anderen Tabellen vorhanden sein wie z.B. im Konditionen-Tabelle, Konti-Tabelle, Steuer-Tabelle, Sachbearbeiter-Tabelle, Verkaeufer-Tabelle, usw.

Ablauf

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann der Beleg verbucht werden.

Das Verbuchen eines Debitorenbelegs erfolgt in 4 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen. Ist ein von den Konti im gesamten Beleg anlagewirksam, muss unmittelbar vor jedem Aufruf der Methode SetVerteilung die Methode SetAnlageData() mit entsprechenden Parameter aufgerufen werden. Wird die Methode SetAnlageData() nicht aufgerufen, so wird die Methode WriteBuchung mit einem Fehler zurückgewiesen. Falls sich im nachfolgenden Aufruf der Methode SetVerteilung() kein anlagewirksames Konto befindet, muss die Methode SetAnlageData() trotzdem aufgerufen werden. Es wird damit erreicht, dass der Anzahl der Aufrufen der beiden Methoden SetVerteilung() und SetAnlageData() gleich ist. Die Parameter der Methode SetAnlageData können in diesem Fall einen beliebigen Wert haben (z.B. „SKIP“). Verbucht werden nur Daten aus der Aufrufen, welche unmittelbar vor dem Aufruf der Methode SetVerteilung() stehen, wo sich ein anlagewirksames Konto befindet.

Falls es kein anlagewirksames Konto im gesamten Beleg gibt, hat die Methode SetAnlageData() keine Wirkung und muss nicht aufgerufen werden.

SetBuchMode(): fakultativ
Mit dieser Methode wird der Buchungsmode „provisorisch“ oder „definitiv“ eingestellt. Defaultwert ist „provisorisch“.
SetBelegKopf2()/SetBelegKopf3()/SetBelegKopf4()/SetBelegKopf5()/SetBelegKopf6(): zwingend
Mit dieser Methode werden die Beleg-Kopf Informationen abgefüllt.
SetVerteilung(): zwingend
Mit dieser Methode werden die Gegenkontobeträge, Steuer- und KORE-Daten abgefüllt. Jeder Aufruf dieser Methode schreibt einen neuen Gegenkonto-, Steuer- und KORE-Verteilungseintrag. Falls es sich im Beleg anlagewirksame Konti befinden, muss unmittelbar vor dem Aufruf der Methode SetVerteilung die Methode SetAnlageData() aufgerufen werden. Mit SetVerteilung2 kann der Statistikcode pro Belegzeile gesetzt werden.
SetLSVBADBank: fakultativ
Mit dieser Methode kann die LSV-, BAD-Zahlungsverbindung gesetzt werden.
Individuelle Belegdaten abfüllen(): fakultativ
Die Methoden dürfen nur aufgerufen werden, wenn die Option „Individuelle Belegdaten“ in SBS aktiviert ist:
SetIndivBelegAdressen()
SetIndivBelegInfoVal(),
SetIndivBelegInfoText()
SetIndivBelegZusatzDte(),
SetIndivBelegZusatzCombo()
StatCodeBuchung fakultativ
Mit diesem Property kann der Statistikcode gesetzt werden. Es wird bei allen Buchungen (falls mehrere Gegenbuchungen vorhanden sind) der gleiche Statistikcode geschrieben!
WriteBuchung(): zwingend
Mit dieser Methode wird der Beleg und alle Verteilungseinträge effektiv verbucht.

SetBuchMode

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Mode	String	Alphanumerisch(1)	Ja	Zugelassene Werte: P und D

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Diese Einstellung wird durch die Einstellung in Finanz übersteuert! (Hauptjournal, Buchungs-Einstellunge, Definitiv Verbuchen). Ist diese Einstellung gesetzt, wird die Buchung Definitiv geschrieben, auch wenn über die API der BuchMode auf „P“ gesetzt wird.

SetBelegKopf2, SetBelegKopf3, SetBelegKopf4, SetBelegKopf5, SetBelegKopf6

Parameter

Die Methode SetBelegKopf2 besitzt 20 Parameter (die ersten 22 mit Ausnahme von Parameter 19 und 20),
die Methode SetBelegKopf3 die ersten 22 Parameter, die Methode SetBelegKopf4 die ersten 23 Parameter,
die Methode SetBelegKopf5 die ersten 28 Parameter, die Methode SetBelegKopf6 die ersten 29 Parameter.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Belegnummer	Long	Numerisch	Ja	Belegnummer
2.	Valuta	String	Datum(4,2,2)	Ja	JJJJMMDD, Datum für Fibubuchung, (Belegdatum wenn unbekannt)
3.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
4.	Belegtyp	String	Alphanumerisch(1)	Ja	R=Rechnung, G=Gutschrift
5.	Belegdatum	String	Datum(4,2,2)	Ja	JJJJMMDD, Rechnungsdatum
6.	Verfalldatum	String	Datum(4,2,2)	Nein	JJJJMMDD, Rechnungsdatum + Kondition Wird kein Verfalldatum angegeben: - Rechnungen: Das Verfalldatum wird an Hand des Belegdatums und der Kondition berechnet. - Gutschriften: Als Verfalldatum wird das Belegdatum genommen.
7.	Belegtext	String	Alphanumerisch(60)	Nein	Belegtext
8.	Referenz	String	Alphanumerisch(30)	Nein	Frei definierbar
9.	Konditionennummer	Long	Numerisch	Ja	Aus Der Tabelle Kondition
10.	Sachbearbeiter-ID	String	Alphanumerisch(5)	Nein	Aus der Tabelle Sachbearbeiter
11.	Verkaeufer-ID	String	Alphanumerisch(5)	Nein	Aus der Tabelle Verkaeufer
12.	MahnSperreBis	String	Datum(4,2,2)	Nein	JJJJMMDD
13.	Mahnstufe	Short	Numerisch	Ja	0 – 3 (0=noch nie gemahnt, 1=einmal gemahnt etc.) Falls ein Mahncode grösser als 3 ist, wird er automatisch auf 3 gesetzt.
14.	Betrag Brutto BW	String	Numerisch(17,2)	Ja	BW=Belegwährung (Fremd- oder Grundwährung) Alle Nettobeträge und Steuerbeträge der Fibubelege müssen zusammen diesen Betrag ergeben.
15.	Kurs	String	Numerisch(12,6)	Ja	1 bei GW. Für andere Währungen siehe die Tabelle ‘kurs‘. NOT_SET oder „“ (leer): Der Kurs gemäss Valutadatum wird aus der Tabelle kurs verwendet.
16.	Externe Belegnummer	String	Alphanumerisch( 30)	Nein	Externe Belegnummer
17.	SkontoberBetrag	String	Numerisch(17,2)	Nein	Skontoberechtigter Betrag (in Belegwährung)
18.	DebiWhg	String	Alphanumerisch(3)	Ja	Währung des Debitors
19.	Sammelkonto	String	Alphanumerisch(15)	Nein	Dieses Feld wird bei SetBelegKopf2 nicht verwendet.
20.	VerzugszinsJN	StringD	Alphanumerisch(1)	Nein	J=Ja, N=Nein Dieses Feld wird bei SetBelegKopf2 nicht verwendet.
21.	Zusatztext	String	Alphanumerisch(256)	Nein	Zusatztext zum Beleg. Defaultwert „“
22.	EbankKto	String	Numerisch	Nein	Eigene Zahlungsverbindung Defaultwert „0“. Mit dem Wert „DEFAULT“ wird die Bank gemäss Vordispo aus dem Debitorenstamm geholt. Hinweis: Bei einem Kreditkarten-Beleg wird dieser Wert immer mit der Vordisposition des Einzugkontos überschrieben.
23.	IktoDebitor	String	Numerisch	Nein	Interkontodebinbr (Verbandsmanagement). Mit dem Wert „DEFAULT“ wird der Verband gemäss Vorschlag gesetzt. Defaultwert „NOT_SET“.
24.	VisaTransDte	String	DATETIME	Nein	Transaktionsdatum und -zeit eines Kreditkartenbeleges. Zwingendes Format: „YYYYMMDD HH:MM:SS“ oder „YYYYMMDD“. Defaultwert „NOT_SET“
25.	VisaAutoCode	String	Alphanumerisch(20)	Nein	Authorisierungscode eines Kreditkartenbeleges. Defaultwert „NOT_SET“
26.	VisaTransNr	String	Alphanumerisch(50)	Nein	Transaktionsnummer eines Kreditkartenbeleges. Defaultwert „NOT_SET“
27.	MahnAdrNbr	String	Numerisch	Nein	Mahnadresse des Belegs. Mit „DEFAULT“ oder leer wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ oder „0“ weist keine Mahnadresse zu. Defaultwert „DEFAULT“.
28.	MahnKontaktNbr	String	Numerisch	Nein	Interne Kontaktlaufnummer der Mahnadresse. Mit „DEFAULT“ oder leer wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ oder „0“ weist keinen Kontakt zu. Defaultwert „DEFAULT“ Die interne Kontaktlaufnummer kann auch via Externe Referenz geholt werden. Siehe dazu auch Kontaktadressen.
29.	MahnsperrID	String	Alphanumerisch(5)	Nein	Mahnsperrcode Defaultwert „DEFAULT“ (=Übernahme vom Debitorenstamm)
30.	LetztesMahnDte	String	Datum(4,2,2)	Nein	Letztes Mahndatum, bei Neuerfassung üblicherweise „NOT_SET“
31.	BelegArt	String	Alphanumerisch(2)	Nein	Belegarten-Code

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Gegenkonto	String	Alphanumerisch(15)	Nein	Wird kein Erlöskonto angegeben, wird das des Debitors verwendet. Erlöskonto aus der Konto-Tabelle
2.	Fibu Buchungstext	String	Alphanumerisch(60)	Ja	Darf nicht leer sein.
3.	Nettobetrag BW	String	Numerisch(17.2)	Ja	BW=Belegwährung (Fremd- oder Grundwährung)
4.	Steuerfelder	String	Alphanumerisch(n)	Ja	Ausführliche Informationen zum Steuerfelder-Parameter sind unter GetSteuerFeld (Abschnitt Returnwert) zu finden.
5.	KST-Felder	String	Alphanumerisch(n)	Ja	KST1[KstKtr_Trenner KTR1] Feld_Trenner Text Feld_Trenner Betrag GW Rec_Trenner, (0 – n mal) z.B. KST1{-}KTR1{<}Text{<}Betrag{>} oder KST1{<}Text{<}Betrag{>} oder {-}KTR1{<}Text{<}Betrag{>}, siehe die Methode SetDelimiters *) Der Betrag in GW kann mit der Methode CalcBebuBetrag berechnet werden. Wird als GW Betrag der String CALCULATE übergeben, wird der Basisbetrag automatisch berechnet. Siehe dazu das Kapitel API-Allgemein – Gefahren. Wird keine Kostenstelle/-Träger angegeben, wird die Defaultkostenstelle des Debitors verwendet.
6.	PrjExt	String	Alphanumerisch(n)	Nein	[Koart] Feld_Trenner [Projekt] Feld_Trenner [LeistgArt] Feld_Trenner [Menge] Rec_Trenner **) siehe die Methode SetDelimiters (0-n mal, parallel zum Parameter Nr.5) Beispiel:600{<}{<}{<}{>} gibt die Kostenart 600 für die Bebu-Buchung des kostenpflichtigen Gegenkontos an. Der ganze Parameter sollBebuExt kann leer bleiben

*) Angaben in den eckigen Klammern sind fakultativ

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung2

Parameter

Analog SetVerteiung(), zusätzlicher Parameter Nr. 7:

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
7.	StatCode	String	Alphanumerisch(n)	Nein	Statistikcode pro Belegzeile

*) Angaben in den eckigen Klammern sind fakultativ

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Mittels StatCodeBuchung kann der Statistikcode auch gesetzt werden, dieser wird dann aber für alle Belegzeilen gesetzt. Mit SetVerteilung2 kann der Statistikcode pro Belegzeile gesetzt werden.

SetAnlageData

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	AnlageNr	String	Alphanumerisch(15)	Ja	Anlagenummer
2.	Buchungstext	String	Alphanumerisch(60)	Nein	Wird kein Text übergeben, so wird der Buchungstext aus dem Parameter Buchungstext der Methode SetVerteilung übernommen

Returnwert

Diese Methode hat keinen Returnwert.

SetAnlageData3

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	AnlageNr	String	Alphanumerisch(15)	Ja	Anlagenummer
2.	Buchungstext	String	Alphanumerisch(60)	Nein	Wird kein Text übergeben, so wird der Buchungstext aus dem Parameter Buchungstext der Methode SetVerteilung übernommen
3	AnlageNrExt	String	Alphanumerisch(10)	Nein	Anlagenummer extern

Returnwert

Diese Methode hat keinen Returnwert.

SetLSVBADBank

Beschreibung

Mit dieser Methode kann die LSV-, BAD-Zahlungsverbindung gesetzt werden. Wird diese Methode nicht aufgerufen, wird als Defaultwert die Zahlverbindung des Debitors verwendet.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

BankLfNr

String

Numerisch

Wird der Wert 0 übergeben, wird keine Bank gesetzt.

Wird der String DEFAULT übergeben, wird die Defaultbank, -Post des Debitors verwendet.

Returnwert

Diese Methode hat keinen Returnwert.

Individuelle Belegdaten abfüllen

SetIndivBelegAdressen, SetIndivBelegInfoVal, SetIndivBelegInfoText, SetIndivBelegZusatzDte, SetIndivBelegZusatzCombo

Beschreibung

Die Methoden sind fakultativ. Die Methoden dürfen nur aufgerufen werden, wenn die Option „Individuelle Belegdaten“ in Simultan aktiviert ist.

Die Buchungs-Einstellungen aus Simultan Finanz werden beim Buchen über die Schnittstelle sinngemäss übernommen:

Default-Werte werden als Initialwerte geladen (gemäss Einstellungen).
Muss-Feldern muss ein Wert zugewiesen sein (gemäss Einstellungen).

Beim Aufruf der Methoden können auch folgende Werte mitgegeben werden:

„DEFAULT“: Der Defaultwert des Feldes wird benutzt.
„NOT_SET“: Es wird kein Wert gesetzt ( =leer, 0, etc.)
„NOT_UPD“: Ein bereits gesetzter Wert wird nicht überschrieben (z.B. ein bereits geladener Default oder beim Modifizieren eines Beleges)

Für weitere Informationen über die Individuellen Belegdaten ist das Handbuch der SBS Debitorenbuchhaltung zu konsultieren.

Parameter

Parameter von SetIndivBelegAdressen

Hinweis: Es sind nur Adressnummern und Kontakte gültig, die bereits erfasst und im Debitorenstamm zugewiesen worden sind.

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

Typ

String

Alphanumerisch(1)

Adresstyp:
“1“ bis „6“ =Indidivuelle Adresse 1 bis 6

L=Lieferadresse
S=Bestelladresse
Z=Rechnungsadresse

à die Mahnadresse kann nicht über diese Methode zugewiesen werden!

AdrNbr

String

Numerisch

Adressnummer

KontaktLfNbr

String

Numerisch

Nein

Interne Kontaktlaufnummer der Adressnummer.

Default ist „DEFAULT“. NOT_SET oder leer für keinen Kontakt.

Die interne Kontaktlaufnummer kann auch via Externe Referenz geholt werden. Siehe dazu auch Kontaktadressen.

Parameter von SetIndivBelegInfoVal

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	String	Numerisch	Ja	Nummer zwischen 1 und 12. Diesem Feld wird der Wert zugewiesen
2.	Wert	String	Numerisch	Ja	Wert

Parameter von SetIndivBelegInfoText

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	String	Numerisch	Ja	Nummer zwischen 1 und 12. Diesem Feld wird der Text zugewiesen
2.	Text	String	Alphanumerisch(50)	Ja	Text

Parameter von SetIndivBelegZusatzDte

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	String	Numerisch	Ja	Nummer zwischen 1 und 6. Diesem Feld wird das Datum zugewiesen
2.	Datum	String	Datum (4,2,2)	Ja	Format: JJJJMMDD

Parameter von SetIndivBelegZusatzCombo

Hinweis: Es sind nur gültige Combobox-Einträge erlaubt, welche unter SBS Finanz\Stammdaten\Individuelle Zusätze erfasst sind.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Nummer	String	Numerisch	Ja	Nummer zwischen 1 und 6. Diesem Feld wird das Datum zugewiesen
2.	Combo	String	Alphanumerisch(15)	Ja	Combobox-Nummer

Returnwert

Diese Methode hat keinen Returnwert.

WriteBuchung

Parameter

Diese Methode hat keine Parameter.

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

On Error GoTo ErrorHandler
Dim a As Variant
Dim b As Single
Dim Valuta, GutschriftGR, Belegdatum, VerfallDatum, Text, Referenz, SachbID, VerkaeuferID, MahnErlaubnis As String
Dim AktMahnStufe As Single
Dim Betrag, Kurs As Double
Dim BelNbr, DebitorNbr, Kondition As Long
Dim GegenKto As Integer
Dim FibuText, SteuerText, BeBuEintrg, SteuerSatzID As String
Dim NettoBetrag, SteuerBetrag As Double
Dim SteuerFeld As String
 
GutschriftGR = „R“
Betrag = 1000#: Valuta = 19970915: Belegdatum = 19970915
VerfallDatum = „  „: DebitorNbr = 55556: Text = „DEBI D Testbuchung“
MahnErlaubnis = „20001231“: Kurs = 85#: BelNbr = 333333 ‚ 222222
Referenz = „123-223-333“
Call Debi.SetBelegKopf2(BelNbr, Valuta, DebitorNbr, GutschriftGR, Belegdatum, VerfallDatum, Referenz, Kondition, SachbID, VerkaeuferID, MahnErlaubnis, AktMahnStufe, Betrag, Kurs, ExtBelNbr, SkontoBetrag,“EUR“)
 
GegenKto = 3200
FibuText = „DEBI D Bhg Moebel“
NettoBetrag = 1000#
BebuBetrag = Kurs * NettoBetrag / 100#
BeBuEintrg = „PROD{<}BebuText{<}“ + Str(BebuBetrag) + „{>}“
SteuerFeld = „25{<}DEBI D Bhg Export MWST{<}0{>}“
Call Debi.SetVerteilung(GegenKto, FibuText, NettoBetrag, SteuerFeld, BeBuEintrg)
Call Debi.WriteBuchung
 
Wrong:
Exit Sub
 
ErrorHandler:
b = Err.Number And 65535
If b <> 0 Then
Msg = “Error # “ & Str(Err.Number) & “ was generated by “ _
            & Err.Source & Chr(13) & Err.Description _
            & „ Unsere Fehlernummer“ & Str(b)
    MsgBox Msg
End If
Err.Clear

Schreiben eines Debitorbelegs in Fremdwährung:

SetBelegKopf2(„1“, „19990501“, „1009“, „R“, „19990915“, „19990517“, „Text“, „“, „1“, „PHU“, „“, „20001231“, „1“, „900“, „85“, „“, „“, „DM“)
 
SetVerteilung(„3200“, „FibuText“, „800“, „20{<}Steuertext{<}100{>}“, „{-}HANDEL{<}Text{<}680{>}“, „“)

Einstellung der automatischen Belegnummerierung ermitteln oder setzen

IncrBelNbr, IncrBelNbrZ

Beschreibung

IncrBelNbr: „Belegnummer Debitoren automatisch erhöhen“

IncrBelNbrZ: „Belegnummer Debitoren Zahlungen automatisch erhöhen“

Die Variablen können die Werte J oder N enthalten. Der Initialwert und die automatische Belegnummervergabe werden gemäss den Einstellungen der SBS Finanz-Applikation übernommen. Der Wert muss nur einmal gesetzt werden. Bei jedem Schreiben einer Buchung wird der einmal zuvor gesetzte Wert angewendet bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird.

Bei „J“ wird die Belegnummer automatisch erhöht und den Belegen automatisch vergeben. Falls der jeweiligen Methode doch eine Belegnummer mitgegeben wird, wird eine Warnung ausgegeben und die mitgegebene Belegnummer ignoriert. Bei „N“ kann die Belegnummer der jeweiligen Methode manuell übergeben werden.

Beispiel

Variable ermitteln
increm = Debi.IncrBelNbr
incremz = Debi.IncrBelNbrZ
 
Variable setzen
Debi.IncrBelNbr = „N“
Debi.IncrBelNbrZ = „J“

Einstellung der doppelten externen Belegnummerüberprüfung ermitteln oder setzen

CheckDoubleExtBelNbr

Beschreibung

Die Variable CheckDoubleExtBelNbr kann die Werte J, N oder W enthalten. Der Initialwert ist aus der Finanz-Applikation entnommen. Der Wert muss nur einmal gesetzt werden. Bei jedem Schreiben einer Buchung wird der einmal zuvor gesetzte Wert angewendet bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird.

Gesetzer Wert	Ergebnis
J	Eine Fehlermeldung wird generiert
N	Es wird keine Prüfung vorgenommen
W	Eine Warnung wird generiert

Bemerkung

Die externe Belegnummer wird über alle Debitoren geprüft und muss bei J eindeutig sein.

Beispiel

Variable ermitteln
eindeutig = Debi.CheckDoubleExtBelNbr    
 
Variable setzen
Debi.CheckDoubleExtBelNbr = ”N”

Einstellung der doppelten internen Belegnummerüberprüfung ermitteln oder setzen

CheckDoubleIntBelNbr

Beschreibung

Die Variable CheckDoubleIntBelNbr kann die Werte J, N oder W enthalten. Der Initialwert ist aus der Finanz-Applikation übernommen. Der Wert muss nur einmal gesetzt werden. Bei jedem Schreiben einer Buchung wird der einmal zuvor gesetzte Wert angewendet bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird.

Gesetzer Wert	Ergebnis
J	Eine Fehlermeldung wird generiert
N	Es wird keine Prüfung vorgenommen
W	Eine Warnung wird generiert

Bemerkung

Die interne Belegnummer wird über alle Debitoren geprüft und muss bei J eindeutig sein.

Beispiel

Variable ermitteln
eindeutig = Debi.CheckDoubleIntBelNbr
 
Variable setzen
Debi.CheckDoubleIntBelNbr = „N“

Nächste Belegnummer holen

GetNextBelNbr

Beschreibung

Diese Methode reserviert die nächste Belegnummer und versucht bei einem Fehler diese wieder zurückzusetzen.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

BelegTyp

String

Alphanumerisch(1)

Als Parameter sind folgende Werte erlaubt:

R = Rechnung

G = Gutschrift

Z = Zahlung

Returnwert

Als Rückgabewert erhält man die Belegnummer die als nächstes für den angegebenen Typ verwendet wird zurück. Dabei muss IncrBelNbr auf J gesetzt sein, sonst wird eine 0 zurückgegeben.

Beispiel

Belegnummer = Debi.GetNextBelNbr(BelegTyp)

Debitorenstamm lesen

ReadDebiStamm2, GetDStammZeile3

Beschreibung

Debitorenstamm wird ausgelesen.

Parameter

Diese Methoden haben keine Parameter.

Returnwert

GetDStammZeile3 gibt als Returnwert die nächste Zeile des Resultsets zurück. Nachdem die letzte Zeile des Resultsets ausgelesen wurde, wird der Returnwert „EOF“. Die Zeilen sind nach Debitornummer sortiert.

Die einzelnen Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Eine Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Debinbr	Wird von der Methode Debitor lesen nicht ausgegeben
2.	whgid	Wird von der Methode Debitor lesen nicht ausgegeben
3.	name	Name
4.	vorname	Vorname
5.	adresse1	Adresse 1
6.	adresse2	Adresse 2
7.	adresse3	Adresse 3
8.	postfach	Postfach
9.	ccode	Ländercode
10.	plz	Postleitzahl
11.	ort	Ortschaft
12.	telefon1	Telefon 1
13.	telefon2	Telefon 2
14.	telefax	Telefax
15.	email	E-Mail Adresse
16.	region	Region
17.	adrtyp	Adressen-Typ
18.	anrede	Anrede
19.	persanrede	Persönliche Anrede
20.	anspartner	Ansprechspartner
21.	sprcode	Sprachcode
22.	memotext	Memo
23.	sperrcode	Kunde gesperrt (J/N)
24.	kredlimit	Kreditlimite
25.	stid	Steuer ID
26.	umssteuernr	Umsatzsteuer-Nummer
27.	debiskto	Debitoren-Sammelkonto
28.	ktoerlos	Erlös-Konto
29.	defkstnr	Vorschlag Kostenstelle
30.	defkanr	Vorschlag Kostenart
31.	sachbid	Sachbearbeiter-Identifikation
32.	verkid	Verkäufer-ID
33.	kondnbr	Konditionsnummer
34.	tolnbr	Wird nicht mehr verwendet
35.	deflfnbrbank	Default-Bankkonto
36.	EMPTY FIELD	leeres Feld
37.	mahnnbr	Mahnnummer
38.	MahnsperreBis	Datum
39.	abccode	ABC-Code
40.	werbung	für Werbung offen
41.	userwert1	User Wert 1
42.	userwert2	User Wert 2
43.	userwert3	User Wert 3
44.	userwert4	User Wert 4
45.	userwert5	User Wert 5
46.	userwert6	User Wert 6
47.	userwert7	User Wert 7
48.	userwert8	User Wert 8
49.	userwert9	User Wert 9
50.	userwert10	User Wert 10
51.	userwert11	User Wert 11
52.	userwert12	User Wert 12
53.	usertext1	User Text 1
54.	usertext2	User Text 2
55.	usertext3	User Text 3
56.	usertext4	User Text 4
57.	usertext5	User Text 5
58.	usertext6	User Text 6
59.	usertext7	User Text 7
60.	usertext8	User Text 8
61.	usertext9	User Text 9
62.	usertext10	User Text 10
63.	usertext11	User Text 11
64.	usertext12	User Text 12
65.	adrnbr	Adress-Nummer
66.	abtnr	Abteilungs-Nummer
67.	marktzghkeit	Marktzugehörigkeit
68.	isdefwhg	Defaultwährung J/N
69.	inddte1	Zusatz Datum 1
70.	inddte2	Zusatz Datum 2
71.	inddte3	Zusatz Datum 3
72.	inddte4	Zusatz Datum 4
73.	inddte5	Zusatz Datum 5
74.	inddte6	Zusatz Datum 6
75.	indtxt1	Zusatz Text 1
76.	indtxt2	Zusatz Text 2
77.	indtxt3	Zusatz Text 3
78.	indtxt4	Zusatz Text 4
79.	indtxt5	Zusatz Text 5
80.	indtxt6	Zusatz Text 6
81.	IsKontokorrent	Ja/Nein
82.	Mobil	Mobile-Nummer
83.	Mahngebuehren	Ja/Nein
84.	Eigenebank	Eigene Bank
85.	LieferantNr	Lieferantennummer
86.	Matchcode	Matchcode
87.	ExtReferenz	Externe Referenz des Default-Kontakts vom Debitor
88.	MahnsperrID	Mahnsperrcode
89.	AuszahlMode	0 = Keine Auszahlung 1 = Auszahlung Haben-Saldo über Kreditoren 2 = Auszahlung Haben-Posten über Kreditoren 3 = Auszahlung Zahlung-Posten über Kreditoren 4 = Auszahlung Posten mit Zahlungsverbindung Verfahrenstyp Auszahlung 5=Kontokorrent (Verrechnung) 6=Kontokorrent (Verrechnung/Auszahlung) 7=Kontokorrent – Keine Verrechnung
90.	Saldo	Saldo des Debitors in Debitorenwährung à Positiver Saldo = Soll-Saldo, Negativer Saldo=Haben-Saldo
91.	Passwort	Websicherheit (Web-Shop)
92.	EanTeilNr	Websicherheit (Web-Shop)
93.	TeilnehmerId1	Websicherheit (Web-Shop)
94.	TeilnehmerId2	Websicherheit (Web-Shop)
95.	EbillAccountNr	Websicherheit (Web-Shop)
96.	LetzterZins	Datum der letzten Verzinsung
97.	Stammcode	Code, welcher bei jedem Kontakt hinterlegt werden kann.
98.	ITelefon	Internet-Telefonnummer (VoIP)
99.	SMS	J/N, Defaultwert J
100.	Kontaktnbr	Kontoaktlaufnummer
101.	Debinbr	Wird von der Methode Debitor lesen nicht ausgegeben
102.	Internet	URL für Internet
103.	StatCode	Statistikcode

Beispiel

Call Debi.ReadDebiStamm2
For I = 1 To 1000
    line = Debi.GetDStammZeile3()
    If line = “EOF” Then GoTo ex
    Print line
Next I
ex:

Debitoradressen suchen

ReadAdressen, ReadAdressen2

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	NummerVon	String	Numerisch	Nein	Adressnummer von
2.	NummerBis	String	Numerisch	Nein	Adressnummer bis
3.	NameVon	String	Alphanumerisch(100)	Nein	Hier können auch Wildcards analog SBS benutzt werden (siehe auch SBS Finanz Dokumentation)
4.	NameBis	String	Alphanumerisch(100)	Nein	Bedeutungslos, falls beim Von-Feld Wildcards benutzt wurden.
5.	VornameVon	String	Alphanumerisch(100)	Nein	Hier können auch Wildcards analog SBS benutzt werden (siehe auch SBS Finanz Dokumentation)
6.	VornameBis	String	Alphanumerisch(100)	Nein	Bedeutungslos, falls beim Von-Feld Wildcards benutzt wurden.
7.	PLZVon	String	Alphanumerisch(6)	Nein	Postleitzahl von
8.	PLZBis	String	Alphanumerisch(6)	Nein	Postleitzahl bis
9.	OrtVon	String	Alphanumerisch(100)	Nein	Ortschaft von
10.	OrtBis	String	Alphanumerisch(100)	Nein	Ortschaft bis
11.	Land	String	Alphanumerisch(5)	Nein	Land
12.	RegionVon	String	Alphanumerisch(5)	Nein	Region von
13.	RegionBis	String	Alphanumerisch(5)	Nein	Region bis
14.	GruppeVon	String	Alphanumerisch(5)	Nein	Gruppe von
15.	GruppeBis	String	Alphanumerisch(5)	Nein	Gruppe bis
16.	MatchcodeVon	String	Alphanumerisch(30)	Nein	Hier können auch Wildcards analog SBS benutzt werden (siehe auch SBS Finanz Dokumentation)
17.	MatchcodeBis	String	Alphanumerisch(30)	Nein	Bedeutungslos, falls beim Von-Feld Wildcards benutzt wurden.

Returnwert

Als Returnwert wird eine Zeile zurückgegeben. Einzelne Felder der Adresse, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Eine Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Debinbr	Debitorennummer
2.	whgid	Währungs-Identifikation
3.	name	Name
4.	vorname	Vorname
5.	adresse1	Adresse 1
6.	adresse2	Adresse 2
7.	adresse3	Adresse 3
8.	ccode	Landeskürzel
9.	plz	Postleitzahl
10.	ort	Ortschaft
11.	telefon1	Telefon 1
12.	Matchcode	Matchcode
13.	Adrnbr	Adressen-Nummer
14.	allowed	Zahlung erlaubt (J/N)
15.	sperrcode	Adresse gesperrt (J/N)
16.	stammcode	Default 0
17.	postfach	Postfach
18.	mobil	Mobile-Nummer
19.	telefon2	Telefon 2
20.	email	E-Mail Adresse
21.	sprache	Sprache
22.	anrede	Anrede
23.	persanrede	Persönliche Anrede
24.	adresse_id	Adressen-Identifikation
25.	vertrid	Verkäufer

Beispiel

s = Debi.GetAdressZeile()

Interne Laufnummer einer Buchung lesen

GetBuchLaufnr

Returnwert

Gibt als Returnwert die Laufnummer der zuletzt geschriebenen Buchung zurück.

Bemerkung

Die Methode MakeStorno (siehe unter Beleg stornieren) gibt die interne Laufnummer direkt zurück und ist daher nicht über diese Methode abrufbar.

Beispiel

LaufNr = Debi.GetBuchLaufnr

Saldo eines Debitors lesen

GetSaldo, GetSaldo2, GetSaldo3, GetSaldo4

Hinweis: Der Saldo bei nachfolgenden Methoden wird jeweils gerechnet, was je nach Datenbank entsprechend Zeit in Anspruch nehmen kann. Um den auf dem Debitorenstamm redundant geführten Saldo (in Debitorenwährung) zu erhalten, stehen Ihnen die Methoden unter Debitorenstamm lesen bzw. Debitor lesen zur Verfügung.

Parameter

Parameter von GetSaldo

Saldo eines Debitors in Basiswährung auslesen

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
2.	Berechnen	String	String	Nein	Defaultwert J, wird nicht mehr verwendet

Parameter von GetSaldo2

Saldo eines Debitors in einer bestimmten Währung auslesen

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
2.	Debitorenwährung	String	String	Nein	Wenn NOT_SET oder Leer, wird der Saldo aller Währungen in Basiswährung berechnet.

Parameter von GetSaldo3

Verfallener Saldo eines Debitors auslesen

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
2.	Debitorenwährung	String	String	Nein	Wenn NOT_SET oder Leer, wird der Saldo aller Währungen in Basiswährung berechnet.
3.	NurVerfalleneJN	String	String	Nein	Mit „J“ wird nur der Saldo der verfallenen Belege errechnet werden.
4.	VerfallDatum	String	Datum(4,2,2)	Nein	JJJJMMDD Datum zum Berechnen des Saldos der verfallenen Belege. Mit dem String “DEFAULT” wird das aktuelle Systemdatum verwendet.

Parameter von GetSaldo4

Verfallener Saldo eines Debitors auslesen

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
2.	Debitorenwährung	String	String	Nein	Wenn NOT_SET oder Leer, wird der Saldo aller Währungen in Basiswährung berechnet.
3.	NurVerfalleneJN	String	String	Nein	Mit „J“ wird nur der Saldo der verfallenen Belege (Verfalldatum) errechnet. Defaultwert ist „J“
4.	VerfallDatum	String	Datum(4,2,2)	Nein	JJJJMMDD Datum zum Berechnen des Saldos der verfallenen Belege. Mit dem String “DEFAULT” wird das aktuelle Systemdatum verwendet.
5	InkBelAusBelLauf	String	String	Nein	Mit „J“ werden Belege die in einem Belastungslauf enthalten sind miteingerechnet.

Returnwert

GetSaldo gibt Saldo des gegebenen Debitors, berechnet in Basiswährung, zurück.

GetSaldo2 gibt den Saldo eines Debitors in der angegebenen Kontowährung oder Basiswährung zurück.

GetSaldo3 gibt den Saldo eines Debitors in der angegebenen Kontowährung oder Basiswährung zurück.

GetSaldo4 gibt den Saldo eines Debitors in der angegebenen Kontowährung oder Basiswährung zurück.

Beispiel

debisal = Debi.GetSaldo(55556)
debisal = Debi.GetSaldo2(55556, „EUR“)
debisal = Debi.GetSaldo3(55556, „EUR“, „J“, „20070117“)
debisal = Debi.GetSaldo4(55556, „EUR“, „J“, „20100117“, „J“)

Saldo einer Zuordnung lesen

GetZuordnungsSaldo

Beschreibung

Saldo einer Belegzuordnung wird ausgelesen.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DKLaufNbr	Long	Numerisch	Ja	Die interne Beleglaufnummer eines der Belege. Es wird automatisch die zu diesem Beleg gehörende Zuordnung salditert.

Returnwert

GetZuordnungsSaldo gibt ein kleines Resultset zurück (immer einzeilig).
Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Debinbr	Debitoren-Nummer
2.	whgid	Währungs-Identifikation
3.	name	Name

Beispiel

zuordnungssaldo = Debi.GetZuordnungsSaldo(13)

Debitor löschen

DropDebitor2

Beschreibung

Der Debitor, der durch Debitorennummer und die Währung bestimmt wurde, wird gelöscht. Falls der fakultative Parameter Clearflag einen non Zero Wert hat, werden auch alle Banken dieses Debitors gelöscht.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitorennummer	Long	Numerisch	Ja	Debitorennummer
2.	Währung	String	Alphanumerisch(3)	Ja	Währung
3.	Clearflag	Long	Numerisch	Nein	Flag Clearing

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Die Debitorenbanken werden nicht gelöscht.

Beispiel

Call Debi.DropDebitor2(55556,“CHF“)

Zahlung schreiben

Beschreibung

Ablauf

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann die Zahlung verbucht werden.

Das Verbuchen erfolgt in 2 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

SetZahlung(): zwingend
Mit dieser Methode werden die gemeinsame Felder wie ValutaDatum, Betrag usw. abgefüllt.
WriteZahlung(): zwingend
Mit dieser Methode werden die Belege übergeben, welche der Zahlung unterliegen.

SetZahlung / SetZahlung2

SetZahlung, SetZahlung2

Beschreibung

SetZahlung hat 13 Parameter, SetZahlung2 hat 14 Parameter

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BankID	Long	Numerisch	Ja	Zahlungsverbindungsnummer des Mandanten. Kreditkartenacquirer sind nur für Teilzahlungen und Ausgleichsbuchungen erlaubt!
2.	BelegDatum	String	Datum(4,2,2)	Ja	JJJJMMDD
3.	ValutaDatum	String	Datum(4,2,2)	Ja	JJJJMMDD
4.	Waehrung	String	Alphanumerisch(3)	Ja	Handelt es sich bei der BankID um eine Bank in Fremdwährung, muss hier die Währung der Bank verwendet werden
5.	Kurs	String	Numerisch(12,6)	Ja	Kurs
6.	Betrag	String	Numerisch(17,2)	Ja	Wird nicht verwendet
7.	BWBetrag	String	Numerisch(17,2)	Ja	Basiswährung-Betrag Wird nicht verwendet
8.	DebitorNr	Long	Numerisch	Ja	Debitorennummer
9.	Zahlungstotal	String	Numerisch(17,2)	Ja	Belegwährungstotal-Betrag (Brutto) Wird ein anderer Betrag übergeben als der Betrag des Belegs, wird die Differenz als Skonto verwendet.
10.	DebitorWhg	String	Alphanumerisch(3)	Nein	Als Defaultwährung wird die der Bank verwendet. Handelt es sich bei der angegebenen Bank um eine Bank in Basiswährung, muss die Debitorwährung in Basiswährung eingegeben werden.
11.	BelNbr	Long	Numerisch	Nein	Belegnummer der Zahlung.
12.	ZahlungsText	String	Alphanumerisch()	Nein	Belegtext der Zahlung
13.	AbzugsText	String	Alphanumerisch()	Nein	Abzugstext
14.	Extern	String	Alphanumerisch(30)	Nein	Externe Belegnummer

WriteZahlung

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Belegnummerliste	String	Alphanumerisch(n)	Ja	Die einzelnen internen Buchlaufnummern sind durch Feld_Trenner getrennt. Am Ende der Liste befindet sich der letzte Feld_Trenner.

Beispiel

On Error GoTo ErrorHandler
Dim BankID, DebitorNr as Long
Dim Datum, ValutaDatum, Waehrung, Kurs, Betrag, BWBetrag, Zahlungstotal As String
...
Call Debi. SetZahlung(BankID, Datum, ValutaDatum, Waehrung, Kurs, Betrag, BWBetrag, DebitorNr, Zahlungstotal)
 
Call Debi. WriteZahlung („77{<}200{<}345{<}“)
 
Exit Sub
 
ErrorHandler:
b = Err.Number And 65535
If b <> 0 Then
Msg = “Error # “ & Str(Err.Number) & “ was generated by “ _
            & Err.Source & Chr(13) & Err.Description _
            & „ Unsere Fehlernummer“ & Str(b)
    MsgBox Msg
End If
Err.Clear

Debitor lesen

ReadDebitor3

Beschreibung

Debitor-Information wird ausgelesen.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	Long	Numerisch	Ja	Debitornummer
2.	WhgID	String	Alphanumerisch(3)	Ja	Währung

Achtung: Wird als DebitorNr der mit –1 multiplizierte Wert der DebitorNr übergeben, wird die Währung nicht berücksichtigt: Es wird in diesem Fall trotzdem nur ein Tuple als Result-Set zurückgegeben! Diese Anwendung ist daher nur sinnvoll, wenn die Existenz eines Debitors geprüft werden möchte, ohne eine Währung mitgeben zu müssen. Darüber hinaus unterscheidet sich in diesem Fall das Result-Set von der Beschreibung (siehe unten): Als Spalte 1 und 2 wird zusätzlich die Debitorennummer und die Debitorenwährung zurückgegeben.

Returnwert

Als Returnwert wird eine Zeile zurückgegeben. Einzelne Felder des Debitoreniformations, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Das Result-Set der Zeile entspricht jenem von Debitorenstamm lesen mit Ausnahme der ersten beiden Felder (Debitorennummer, Debitorenwährung): Diese werden nicht ausgegeben, wenn die Parameter DebitorNr grösser als 0 ist (siehe auch Hinweis oben).

Beispiel

s = Buch.ReadDebitor(-1000,““)

Debitorenbeleg modifizieren

Beschreibung

Ablauf

Das Modifizieren eines Debitorenbelegs erfolgt in 3 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

Hinweis: Nicht mehr benötigte Methode:
Die Methode PrepareBelegeForUpdate2() muss nicht mehr aufgerufen werden. Die Methode hatte hat keine Funktionalität. Die Dokumentation zu dieser Methode wurde entfernt.

Anlagenwirksame Buchungen:
Ist ein von den Konti im gesamten Beleg anlagewirksam, muss unmittelbar vor jedem Aufruf der Methode SetVerteilung die Methode SetAnlageData() mit entsprechenden Parameter aufgerufen werden. Wird die Methode SetAnlageData() nicht aufgerufen, so wird die Methode WriteBuchung mit einem Fehler zurückgewiesen. Falls sich im nachfolgenden Aufruf der Methode SetVerteilung() kein anlagewirksames Konto befindet, muss die Methode SetAnlageData() trotzdem aufgerufen werden. Es wird damit erreicht, dass der Anzahl der Aufrufen der beiden Methoden SetVerteilung() und SetAnlageData() gleich ist. Die Parameter der Methode SetAnlageData können in diesem Fall einen beliebigen Wert haben (z.B. „SKIP“). Verbucht werden nur Daten aus den Aufrufen, welche unmittelbar vor dem Aufruf der Methode SetVerteilung() stehen, wo sich ein anlagewirksames Konto befindet. Falls es kein anlagewirksames Konto im gesamten Beleg gibt, hat die Methode SetAnlageData() keine Wirkung und muss nicht aufgerufen werden.

SetBelegKopfForUpdate2/ SetBelegKopfForUpdate3()/ SetBelegKopfForUpdate4()/SetBelegKopfForUpdate5(): zwingend
Mit dieser Methode werden die Beleg-Kopf Informationen aktualisiert.

SetVerteilung(): zwingend
Mit dieser Methode werden die Gegenkontobeträge, Steuer- und KORE-Daten aktualisiert. Jeder Aufruf dieser Methode schreibt einen neuen Gegenkonto-, Steuer- und KORE-Verteilungseintrag. Aufruf dieser Methode ist zwingend, auch falls das Modifizieren lediglich die Beleg-Kopf Daten betreffen sollte. Falls es sich im Beleg anlagewirksame Konti befinden, muss unmittelbar vor dem Aufruf der Methode SetVerteilung die Methode SetAnlageData() aufgerufen werden.
SetLSVBADBank: fakultativ
Mit dieser Methode kann die LSV-, BAB-Zahlungsverbindung gesetzt werden.
Individuelle Belegdaten abfüllen: fakultativ
Die Methoden dürfen nur aufgerufen werden, wenn die Option „Individuelle Belegdaten“ in SBS aktiviert ist:
SetIndivBelegAdressen()
SetIndivBelegInfoVal(),
SetIndivBelegInfoText()
SetIndivBelegZusatzDte(),
SetIndivBelegZusatzCombo()
UpdateBuchung(): zwingend
Mit dieser Methode wird der Beleg und alle Verteilungseinträge effektiv verbucht. Eine neue Buchungslaufnummer wird zugeteilt.

SetBelegKopfForUpdate2, SetBelegKopfForUpdate3, SetBelegKopfForUpdate4, SetBelegKopfForUpdate5

Beschreibung

Die Methode SetBelegKopfForUpdate2 besitzt die ersten 20 Parameter, die Methode SetBelegKopfForUpdate3 die ersten 21 Parameter, die Methode SetBelegKopfForUpdate4 die ersten 26 Parameter und die Methode SetBelegKopfForUpdate5 hat 27 Parameter

Parameter-List:

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BuchLaufNr	Long	Numerisch	Ja	Buchungslaufnummer
2.	Belegnummer	String	Numerisch	Ja	Belegnummer
3.	Valuta	String	Datum(4,2,2)	Ja	JJJJMMDD, Datum für Fibubuchung, (Belegdatum wenn unbekannt)
4.	Belegdatum	String	Datum(4,2,2)	Ja	JJJJMMDD, Rechnungsdatum
5.	Verfalldatum	String	Datum(4,2,2)	Nein	JJJJMMDD, Rechnungsdatum + Kondition Wird kein Verfalldatum angegeben: - Rechnungen: Das Verfalldatum wird an Hand des Belegdatums und der Kondition berechnet. - Gutschriften: Als Verfalldatum wird das Belegdatum genommen.
6.	Belegtext	String	Alphanumerisch(60)	Nein	Belegtext
7.	Referenz	String	Alphanumerisch(30)	Nein	Frei definierbar
8.	Konditionennummer	String	Alphanumerisch(8)	Ja	Aus Der Tabelle Kondition
9.	Sachbearbeiter-ID	String	Alphanumerisch(5)	Nein	Aus der Tabelle Sachbearbeiter
10.	Verkaeufer-ID	String	Alphanumerisch(5)	Nein	Aus der Tabelle Verkaeufer
11.	MahnSperreBis	String	Datum(4,2,2)	Nein	JJJJMMDD
12.	Mahnstufe	String	Numerisch	Ja	0 – 3 (0=noch nie gemahnt, 1=einmal gemahnt etc.) Falls ein Mahncode grösser als 3 ist, wird er automatisch auf 3 gesetzt.
13.	Betrag Brutto BW	String	Numerisch(17,2)	Ja	BW=Belegwährung (Fremd- oder Grundwährung) Alle Nettobeträge und Steuerbeträge der Fibubelege müssen zusammen diesen Betrag ergeben.
14.	Kurs	String	Numerisch(12,6)	Ja	1 bei GW. Für andere Währungen siehe die Tabelle ‘kurs‘.
15.	Externe Belegnummer	String	Alphanumerisch( 30 )	Nein	Externe Belegnummer
16.	SkontoberBetrag	String	Numerisch(17,2)	Nein	Skontoberechtigter Betrag (in Belegwährung)
17.	Sammelkonto	String	Alphanumerisch(15)	Nein	Defaultwert ist das Sammelkonto des zu updatenden vorliegenden Belegs
18.	VerzugszinsJN	String	Alphanumerisch(1)	Nein	J=Ja, N=Nein Defaultwert = Nein
19.	Zusatztext	String	Alphanumerisch(256)	Nein	Zusatztext zum Beleg. Defaultwert ’NOT_UPD’
20.	EbankKto	String	Numerisch	Nein	Eigene Zahlungsverbindung Defaultwert „NOT_UPD“
21.	IktoDebitor	String	Numerisch	Nein	Interkontodebinbr (Verbandsmanagement). Mit dem Wert „DEFAULT“ wird der Verband gemäss Vorschlag gesetzt. Defaultwert „NOT_UPD“.
22.	VisaTransDte	String	DATETIME	Nein	Transaktionsdatum und -zeit eines Kreditkartenbeleges. Format Parameter: „YYYYMMDD“ oder auch „YYYYMMDD HH:MM:SS“ Defaultwert „NOT_UPD“
23.	VisaAutoCode	String	Alphanumerisch(20)	Nein	Authorisierungscode eines Kreditkartenbeleges. Defaultwert „NOT_UPD“
24.	VisaTransNr	String	Alphanumerisch(50)	Nein	Transaktionsnummer eines Kreditkartenbeleges. Defaultwert „NOT_UPD“
25.	MahnAdrNbr	String	Numerisch	Nein	Mahnadresse des Belegs. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keine Mahnadresse zu. Defaultwert „NOT_UPD“.
26.	MahnKontaktNbr	String	Numerisch	Nein	Interne Kontaktlaufnummer der Mahnadresse. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keinen Kontakt zu. Defaultwert „NOT_UPD“ Die interne Kontaktlaufnummer kann auch via Externe Referenz geholt werden. Siehe dazu auch Kontaktadressen. Hinweis: Wir die Mahnadresse geändert, hier aber NOT_UPD übergeben, wird automatisch kein Kontakt zugewiesen.
27.	MahnsperrID	String	Alphanumerisch(5)	Nein	Mahnsperrcode Defaultwert „NOT_UPD“
28.	LetztesMahnDte	String	Datum(4,2,2)	Nein	Letztes Mahndatum Defaultwert „NOT_UPD“

SetVerteilung, SetVerteilung2

Beschreibung

Parameter

Parameter 1-6 entsprechen Parameter von SetVerteilung.

Parameter 1-7 entsprechen Parameter von SetVerteilung2.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Gegenkonto	String	Alphanumerisch(15)	Nein	Wird kein Erlöskonto angegeben, wird das des Debitors verwendet. Erlöskonto aus der Konto-Tabelle
2.	Fibu Buchungstext	String	Alphanumerisch(60)	Ja	Fibu Buchungstext
3.	Nettobetrag BW	String	Numerisch(17.2)	Ja	BW=Belegwährung (Fremd- oder Grundwährung)
4.	Steuerfelder	String	Alphanumerisch(n)	Ja	Ausführliche Informationen zum Steuerfelder-Parameter sind unter GetSteuerFeld (Abschnitt Returnwert) zu finden.
5.	KST-Felder	String	Alphanumerisch(n)	Ja	KST1[KstKtr_Trenner KTR1] Feld_Trenner Text Feld_Trenner Betrag GW Rec_Trenner, (0 – n mal) z.B. KST1{-}KTR1{<}Text{<}Betrag{>} oder KST1{<}Text{<}Betrag{>} oder {-}KTR1{<}Text{<}Betrag{>}, siehe die Methode SetDelimiters *) Der Betrag in GW kann mit der Methode CalcBebuBetrag berechnet werden. Wird als GW Betrag der String CALCULATE übergeben, wird der Basisbetrag automatisch berechnet. Siehe dazu das Kapitel API-Allgemein – Gefahren. Wird keine Kostenstelle/-Träger angegeben, wird die Defaultkostenstelle des Debitors verwendet.
6.	PrjExt	String	Alphanumerisch(n)	Nein	[Koart] Feld_Trenner [Projekt] Feld_Trenner [LeistgArt] Feld_Trenner [Menge] Rec_Trenner **) siehe die Methode SetDelimiters (0-n mal, paralell zum Parameter Nr.5) Beispiel:600{<}{<}{<}{>} gibt die Kostenart 600 für die Bebu-Buchung des kostenpflichtigen Gegenkontos an. Der ganze Parameter sollBebuExt kann leer bleiben
7.	StatCode	String	Alphanumerisch(n)	Nein	Statistikcode pro Belegzeile

*) Angaben in den eckigen Klammern sind fakultativ

Bemerkung

Die Felder dürfen den String „NOT_UPD“ nicht erhalten.

Mittels StatCodeBuchung kann der Statistikcode auch gesetzt werden, dieser wird dann aber für alle Belegzeilen gesetzt. Mit SetVerteilung2 kann der Statistikcode pro Belegzeile gesetzt werden.

SetAnlageData

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	AnlageNr	String	Alphanumerisch(15)	Ja	Anlagenummer
2.	Buchungstext	String	Alphanumerisch(60)	Nein	Wird kein Text übergeben, so wird der Buchungstext aus dem Parameter Buchungstext der Methode SetVerteilung übernommen

Bemerkung

Zwingend, falls sich im Beleg anlagewirksame Konti befinden

SetLSVBADBank

Beschreibung

Mit dieser Methode kann die LSV-, BAD-Zahlungsverbindung gesetzt werden. Wird diese Methode nicht aufgerufen, wird als Defaultwert die Zahlverbindung des Debitors verwendet.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BankLfNr	String	Numerisch	Ja	Wird der Wert 0 übergeben, wird keine Bank gesetzt.

Individuelle Belegdaten abfüllen

Beschreibung

Die individuellen Belegdaten werden mit den ursprünglich gespeicherten Daten initialisiert. Die Methoden müssen daher nicht erneut aufgerufen werden, wenn keine Änderungen gewünscht sind.

Für die Beschreibung der Methoden siehe Abschnitt Debitorenbeleg neu schreiben, Individuelle Belegdaten abfüllen.

UpdateBuchung

Parameter

Diese Methode hat keine Parameter.

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

On Error GoTo ErrorHandler
Dim a As Variant
Dim b As Single
Dim Valuta, GutschriftGR, Belegdatum, VerfallDatum, Text, Referenz, SachbID, VerkaeuferID, MahnErlaubnis As String
Dim AktMahnStufe As Single
Dim Betrag, Kurs As Double
Dim BelNbr, DebitorNbr, Kondition As Long
Dim GegenKto As Integer
Dim FibuText, SteuerText, BeBuEintrg, SteuerSatzID As String
Dim NettoBetrag, SteuerBetrag As Double
Dim SteuerFeld As String
 
GutschriftGR = „R“
Betrag = 1000#: Valuta = 19970915: Belegdatum = 19970915
VerfallDatum = „  „: DebitorNbr = 55556: Text = „DEBI D Testbuchung“
MahnErlaubnis = „J“: Kurs = 85#: BelNbr = 333333 ‚ 222222
Referenz = „123-223-333“
VerzugszinsJN = „J“
Call Debi.SetBelegKopfForUpdate2(buchLaufNr, BelNbr, Valuta, Belegdatum, Verfalldatum, Text, Referenz, Kondition, SachbID, VerkaeuferID, MahnErlaubnis, AktMahnStufe, Betrag, kurs,         ExterneBelNr, SkontoberBetrag, Sammelkonto, VerzugszinsJN)
 
GegenKto = 3200
FibuText = „DEBI D Bhg Moebel“
NettoBetrag = 1000#
BebuBetrag = Kurs * NettoBetrag / 100#
BeBuEintrg = „PROD{-}HANDEL{<}BebuText{<}“ + Str(BebuBetrag) + „{>}“
SteuerFeld = „25{<}DEBI D Bhg Export MWST{<}0{>}“
 
Call Debi.SetVerteilung(GegenKto, FibuText, NettoBetrag, SteuerFeld, BeBuEintrg)
Call Debi.UpdateBuchung
 
Wrong:
Exit Sub
 
ErrorHandler:
b = Err.Number And 65535
If b <> 0 Then
Msg = “Error # “ & Str(Err.Number) & “ was generated by “ _
            & Err.Source & Chr(13) & Err.Description _
            & „ Unsere Fehlernummer“ & Str(b)
    MsgBox Msg
End If
Err.Clear
Resume Wrong

Beleg löschen

CheckDeleteBuchungProvOnly

CheckDeleteBuchung, DeleteBuchung

Beschreibung

Einstellung CheckDeleteBuchungProvOnly

Die globale Variale " CheckDeleteBuchungProvOnly" bestimmt, ob nur Buchungen mit dem Status "provisorisch" gelöscht werden dürfen oder ob auch Buchungen mit dem Status "definitiv" gelöscht werden können.

Die Variable kann die Werte (J)a, (N)ein oder (W)arnung enthalten:

(J)a: Es dürfen nur provisorische Buchungen gelöscht werden. Dies ist immer der Initialwert.

(N)ein: Es dürfen nicht nur provisorische Buchungen, sondern auch definitive Buchungen gelöscht werden.

(W)arnung: Es dürfen wie bei (N)ein nicht nur provisorische Buchungen, sondern auch definitive Buchungen gelöscht werden. Die API weist jedoch zusätzlich mit einer Warnung auf die Löschung einer definitiven Buchung hin.

Der Wert muss nur einmal gesetzt werden. Bei jedem Löschen einer Buchung wird der einmal zuvor gesetzte Wert angewendet und bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird.

Hinweis: Diese Einstellung gilt nur für das jeweilige Objekt, d.h. in diesem Fall nur für Debitorenbuchungen.

Methode CheckDeleteBuchung / DeleteBuchung

Die Methode CheckDeleteBuchung ermöglicht die vorgängige Überprüfung, ob die betreffende Buchung durch die API gelöscht werden darf. Falls eine Buchung nicht gelöscht werden kann (z.B. wenn eine definitive Buchung nicht gelöscht werden darf), meldet die API einen Fehler. Die Buchung wird in keinem Fall gelöscht.

Zum wirklichen Löschen der Buchung ist die Methode DeleteBuchung aufzurufen. Der Beleg, der durch Buchungslaufnummer bestimmt wurde, wird gelöscht. Auch hier wird natürlich geprüft, ob die Buchung überhaupt gelöscht werden darf. Falls eine Buchung nicht gelöscht werden kann, meldet die API auch hier einen Fehler.

Parameter

Parameter von CheckDeleteBuchung und DeleteBuchung

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BuchLaufNr	Long	Numerisch	Ja	Interne Buchungslaufnummer Debitoren

Returnwert

Die Methoden CheckDeleteBuchung und DeleteBuchung liefern keinen Returnwert.

Beispiel

Variable ermitteln
onlyprovdel = Debi. CheckDeleteBuchungProvOnly
 
Variable setzen
Debi. CheckDeleteBuchungProvOnly = „N“
 
Debi. CheckDeleteBuchungProvOnly = "N"
Call Debi.CheckDeleteBuchung (156)
Call Debi.DeleteBuchung(156)

Beleg sperren

SetBuchSperre

Beschreibung

Der Beleg, der durch die Buchungslaufnummer bestimmt wurde, wird für die weitere Bearbeitung gesperrt oder freigegeben. Wird ein Beleg gesperrt, kann dieser nicht mehr gelöscht oder mutiert werden.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BuchLaufNr	Long	Numerisch	Ja	Buchungslaufnummer
2.	SperreJN	String	Alphanumerisch(1)	Ja	J/N

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Debi.SetBuchSperre(156,"J")

Beleg stornieren

MakeStorno

Beschreibung

Die Methode MakeStorno storniert den angegebenen Beleg. Als Returnwert erhält man die Buchungslaufnummer des Stornobelegs.

Belege mit dem Status Provisorisch können direkt storniert werden. Der Status des Beleges wird beim Stornieren auf Definitiv gesetzt.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	LfNbr	String	Numerisch	Nein	Interne Laufnummer des Belegs, der Storniert werden soll. Defaultwert: „0“
2.	DebiNbr	String	Numerisch	Nein	Defaultwert:: „ “
3.	Whg	String	Alphanumerisch(3)	Nein	Defaultwert:: „ “
4.	BelNbr	String	Numerisch	Nein	Belegnummer Defaultwert:: „ “
5.	BelBetrag	String	Numerisch(17.2)	Nein	Defaultwert:: „ “
6.	Datum	String	Datum(4,2,2)	Nein	Defaultwert: aktuelles Datum
7.	StornoText	String	Alphanumerisch(60)	Nein	Defaultwert: Stornotext aus den Einstellungen

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Je nachdem welche der Parameter gesetzt wird, ist ein anderes Verhalten Programmiert:

LfNbr wird ein Wert ungleich des Defaultparameters übergeben
Der Beleg welcher durch diese Laufnummer referenziert wird, wird storniert.

StornoLfnbr = DbBhg.MakeStorno(1)

LfNbr wird der Defaultparameter übergeben sowie BelBetrag= Defaultparameter
Es wird versucht die interne Laufnummer des Belegs anhand der DebitorNr, Whg, BelegNr zu ermitteln.

StornoLfnbr = DbBhg.MakeStorno(, DebiNbr, Whg, BelNbr)
StornoLfnbr = DbBhg.MakeStorno(0, DebiNbr, Whg, BelNbr, "")

LfNbr wird der Defaultparameter übergeben sowie BelBetrag ungleich Defaultparameter
Es wird versucht die interne Laufnummer des Belegs anhand der DebitorNr, Whg, BelegNr sowie zusätzlich des Belegbetrags zu ermitteln

StornoLfnbr = DbBhg.MakeStorno(, DebiNbr, Whg, BelNbr, BelBetrag)
StornoLfnbr = DbBhg.MakeStorno(0, DebiNbr, Whg, BelNbr, BelBetrag)

Hinweis: Ein Beleg kann auch vorgängig mit der Methode „DoesBelegExist“ gesucht werden (siehe Belegexistenz überprüfen).

Beispiel

StornoLfnbr = DbBhg.MakeStorno(LfNbr, DebiNbr, Whg, BelNbr, BelBetrag, Datum, StornoText)

Belege lesen

ReadBeleg2, GetBelegZeile2, GetBelegZeile3

Beschreibung

Die Belege werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum Initialisieren der Liste ist die Methode ReadBeleg2/ReadBeleg3 und zum Auslesen GetBelegZeile2 vorhanden.

Parameter

Parameter von ReadBeleg2.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	Long	Numerisch	Ja	Debitorennummer
2.	Periode	String	Alphanumerisch(7)	Nein	Wird keine Periode übergeben, so wird die aktuelle Periode nach dem aktuellen Datum bestimmt.
3.	Whgid	String	Alphanumerisch(3)	Nein	Wird keine Währung übergeben, so werden Belege mit allen Währungen ausgelesen.
4.	Status	String	Alphanumerisch(1)	Nein	Nur Werte ‘B‘, ‘O‘, ‘ ‘ Wird keine Status übergeben, so werden Belege mit allen Status ausgelesen.

Returnwert

ReadBeleg2() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetBelegZeile2(), GetBelegZeile3() gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder des Buchungsatzes, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	lfnbrd	Beleglaufnummer
2.	belnbr	Beleg-ID
3.	beldte	Belegdatum
4.	verfdte	Verfalldatum
5.	status	Status
6.	typ	Belegtyp
7.	MahnsperreBis	Mahnsperrdatum
8.	kondnbr	Kondition
9.	mahnnbr	Mahnung
10.	stufenbr	Mahnstufe
11.	beltext	Belegtext
12.	sachbid	Sachbearbeiter
13.	verkid	Verkaeufer
14.	refnbr	Referenz
15.	ausglnbr	Ausgleichnummer
16.	ausgldte	Ausgleichdatum
17.	lastmhgdte	Datum letzter Mahnung
18.	zlglaufnbr	Zahlungslaufnummer
19.	belnr	Belegnummer
20.	buchbetr	Buchungsbetrag
21.	bvaldate	Valuta
22.	bkurs	Buchungskurs
23.	whgid	Währung
24.	hyparchivnbr	Hyparchivnummer
25.	hypdrucken	Ja, Nein
26.	mawisperre	Ja, Nein
27.	zusatztext	Zusatztext
28.	eigbanklfnbr	Eigene Zahlungsverbindung
29.	MahnAdrNbr	Mahnadresse
30.	MahnKontaktExtRef	Kontaktperson der Mahnadresse (Externe Referenz)
31.	MahnsperrID	Mahnsperrcode
32.	ZuordNbrInt	Interne Buchungslaufnummer der zugeordneten Rechnung. Falls dieser Wert grösser als 0 ist, besteht eine Zuordnung und der Beleg wurde teilverrechnet. Siehe auch Offene Gegenleistungen zuordnen.
33.	DebiNbr	Debitorennummer
34.	steuer	Steuerbetrag in Belegwährung
35.	steuerbas	Steuerbetrag in Basiswährung
36.	netto	Nettobetrag in Belegwährung
37.	nettobas	Nettobetrag in Basiswährung

Beispiel

Call Debi.ReadBeleg2(1000)
 
lab:
   zeile = Debi.GetBelegZeile2
   If zeile = “EOF” Then GoTo iyend
GoTo lab
 
iyend:

Offene Posten auslesen

ReadOP, GetOPZeile

Beschreibung

Die Belege werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum initialisieren der Liste ist die Methode ReadOP und zum auslesen GetOPZeile vorhanden.

Parameter

Parameter von ReadOP.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Mandid	String	Alphanumerisch(2)	Nein	Defaultwert aktueller Mandant
2.	Teqnbr	String	Numerisch	Nein	Wird zur Zeit nicht verwendet (Es werden daher die offenen Belege aller Geschäftsjahre ausgelesen)
3.	DebinbrVon	String	Numerisch	Nein	Debitorennummer von
4.	DebinbrBis	String	Numerisch	Nein	Debitorennummer bis
5.	OffenPer	String	JJJJMMDD	Nein	Wird kein Datum übergeben, werden nur Belege selektiert, deren Status =’O’ ist.
6.	BetragVon	String	Numerisch(17,2)	Nein	Betrag von
7.	BetragBis	String	Numerisch(17,2)	Nein	Betrag bis
8.	SkontoPer	String	JJJJMMDD	Nein	Vermutetes Datum der Zahlung der Offenen Posten. Dient zur Berechnung des Skontos. Default = leer (Der maximal erlaubte Skonto wird berechnet)

Returnwert

ReadOP() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetOPZeile() gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder des Buchungsatzes, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	dklfnbr	Interne Laufnummer
2.	debinbr	Debitorennummer
3.	whgid	Debitorenwährung
4.	valdte	Valutadatum
5.	beldte	Belegdatum
6.	verfdte	Verfalldatum
7.	ausgldte	Ausgleichsdatum (Zahldatum)
8.	intbelnbr	Belegnummer
9.	extbelnbr	Externe Belegnummer
10.	typ	Belegtyp (Rechnung, Gutschrift, etc.)
11.	status	Status des Belegs: O=offen, B=bezahlt
12.	brutto_bw	Bruttobetrag in Belegwährung
13.	steuer_bw	Steuerbetrag in Belegwährung
14.	netto_bw	Nettobetrag in Belegwährung
15.	skonto_bw	Berechneter Skonto gemäss SkontoPer
16.	skontobetrag	Skontoberechtigter Betrag
17.	mhgsperdte	Mahnsperrdatum
18.	kondnbr	Kondition
19.	mahnnbr	Mahnung
20.	stufenbr	Mahnstufe
21.	beltext	Belegtext
22.	sachbid	Sachbearbeiter
23.	verkid	Verkaeufer
24.	refnbr	Referenz
25.	ausglnbr	Ausgleichnummer
26.	lastmhgdte	Datum letzter Mahnung
27.	zlglaufnbr	Zahlungslaufnummer
28.	kursb	Buchungskurs
29.	hyparchivnbr	Hyparchivnummer
30.	hypdrucken	Ja, Nein
31.	mawisperre	Ja, Nein
32.	belnotiz	Zusatztext
33.	eigbanklfnbr	Eigene Zahlungsverbindung
34.	mahnadrnbr	Mahnadresse
35.	extreferenz	Kontaktperson der Mahnadresse (Externe Referenz)
36.	mahnsperrid	Mahnsperrcode
37.	zuordnbrint	Interne Buchungslaufnummer der zugeordneten Rechnung. Falls dieser Wert grösser als 0 ist, besteht eine Zuordnung und der Beleg wurde teilverrechnet. Siehe auch Offene Gegenleistungen zuordnen.
38.	brutto_gw	Bruttobetrag in Basiswährung (Grundwährung)
39.	steuer_gw	Steuerbetrag in Basiswährung (Grundwährung)
40.	netto_gw	Nettobetrag in Basiswährung (Grundwährung)
41.	zuordnbrext	Externe Buchungslaufnummer der zugeordneten Rechnung.

Beleg lesen

GetBeleg

Beschreibung

Der Beleg wird ausgelesen.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	String	Numerisch	Ja	Debitorennummer
2.	BelegLfNbr	String	Numerisch	Ja	Dies ist die Beleglaufnummer und kann beim updaten eines Belegs ändern.

Returnwert

GetBeleg gibt als Returnwert die gefundenen Daten zeilenweise zurück. Einzelne Felder sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen). Eine Zeile beinhaltet die gleichen Felder wie die Methode GetBelegZeile3 (siehe Belege lesen).

Beispiel

Call Debi.GetBeleg(“1000“,“1“)

Debitorenbuchungen komplette Information lesen

ReadDbhgInclKst, ReadDbhgInclKst2, GetDbhgInclKstLine

Beschreibung

Diese Methode liest die Debitorenbuchungen inkl. Verbuchung sowie die dazugehörigen und Kore-Buchungen in einem aus! Debitorenbuchungen werden ausgelesen.

Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum Initialisieren der Liste ist die Methode ReadDbhgInclKst und zum Auslesen GetDbhgInclKstLine vorhanden.

Parameter

Die Methode ReadDbhgInclKst benutzt die ersten 11 Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebiNrVon	Long	Numerisch	Ja	Debitor von
2.	DebiNrBis	Long	Numerisch	Ja	Debitor bis
3.	DatumVon	String	Alphanumerisch JJJJMMDD	Ja	Valuta von Achtung: Es werden unabhängig von dieser Eingabe nur eines Geschäftsjahres (siehe Parameter TeqNbr) ausgegeben. Default: Buchungen des aktuellen Geschäftsjahres.
4.	DatumBis	String	Alphanumerisch JJJJMMDD	Ja	Valuta bis Achtung: Es werden unabhängig von dieser Eingabe nur eines Geschäftsjahres (siehe Parameter TeqNbr) ausgegeben. Default: Buchungen des aktuellen Geschäftsjahres.
5.	UserVon	String	Alphanumerisch	Ja	Benutzer von
6.	UserBis	String	Alphanumerisch	Ja	Benutzer bis
7.	BelNrVon	Long	Numerisch	Ja	Belegnummer von
8.	BelNrBis	Long	Numerisch	Ja	Belegnummer bis
9.	ExtrnNrVon	String	Alphanumerisch	Ja	Externe Belegnummer von
10.	ExtrnNrBis	String	Alphanumerisch	Ja	Externe Belegnummer bis
11.	StatusList	String	Alphanumerisch	Ja	Liste der Stati der gewünschten Buchungen. Maximale Liste ist: O: offen B: bezahlt G: gedruckt L: LSV A: BAD àUm alle Stati zu erhalten, kann statt „O,B,G,L,A“ auch einfach „*“ mitgegeben werden.
12.	BelegArtVon	String	Alphanumerisch(2)	Nein	Belegartcode von
13.	BelegArtBis	String	Alphanumerisch(2)	Nein	Belegartcode bis
14.	TeqNbr	Long	Numerisch	Nein	Interne Nummer des Geschäftsjahres (Tequilanummer). Mit 0 wird das akutelle Geschäftsjahr verwendet.

Returnwert

ReadDbhgInclKst() bzw. ReadDbhgInclKst2() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetDbhgInclKstLine() gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder des Buchungsatzes, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	debinbr	Debinummer
2.	belnr	externe Belegnummer
3.	belegstatus	Belegstatus
4.	belegnbr	Belegnummer
5.	dklfnbr	Laufnummer der Debibuchung
6.	lfnbr	Laufnummer der Fibubuchung
7.	lfnbrb	Laufnummer der KORE-Buchung
8.	banbr	Buchungsart
9.	kstnr	Kostenstelle/Träger
10.	kstnrh	Kostenstelle Haben
11.	kstumlvon	Kostenstelle-Umlage von
12.	kanr	Kostenart
13.	betrag	Kostenbetrag
14.	kstbhgtext	Kosten-Buchungstext
15.	umlstatus	Umlagestatus (direkt umgelegte KORE-Buchungen enthalten hier ein „U“!)
16.	lfnbranl	Anlagelaufnummer
17.	external1	Kostenbuchung external Referenz
18.	valdte	Valuta Fibu
19.	Status	Status Fibu
20.	userid	Benutzer
21.	ktonrs	Konto Soll
22.	ktonrh	Konto Haben
23.	whgidb	Buchungswährung
24.	kursb	Buchungskurs
25.	betrag	Buchungsbetrag
26.	betragk	Buchungsbetrag in Kontowährung
27.	betragbas	Buchungsbetrag in Mandantwährung
28.	bhgtext	Buchungstext
29.	bhgtextgegen	Gegenbuchungstext
30.	sbflag	Not used
31.	erfdte	Erfassungsdatum
32.	bhgtyp	Buchungstyp
33.	sbhgnbr	Not used
34.	isskonto	Not used
35.	external1	Not used
36.	resnum1	Not used
37.	isfremdbhg	Herkunft Flag
38.	eurokurs	Eurokurs
39.	eurobetr	Betrag in Euro
40.	beldte	Belegdatum
41.	verfdte	Verfalldatum
42.	projektnummer	Projekt
43.	leistungsart	Leistungsart
44.	menge	Menge
45.	Typ	Typ
46.	BelegText	Belegtext
47.	BelegArt	Belegartcode
48.	ZuordNbrInt	Interne Buchungslaufnummer der zugeordneten Rechnung. Falls dieser Wert grösser als 0 ist, besteht eine Zuordnung und der Beleg wurde teilverrechnet. Siehe auch Offene Gegenleistungen zuordnen.
49.	mhgsperdte	Mahnsperrdatum
50.	kondnbr	Kondition
51.	mahnnbr	Mahnung
52.	stufenbr	Mahnstufe
53.	beltext	Belegtext
54.	sachbid	Sachbearbeiter
55.	verkid	Verkaeufer
56.	refnbr	Referenz
57.	ausglnbr	Ausgleichnummer
58.	ausgldte	Ausgleichsdatum (Zahldatum)
59.	lastmhgdte	Datum letzter Mahnung
60.	zlglaufnbr	Zahlungslaufnummer
61.	hyparchivnbr	Hyparchivnummer
62.	hypdrucken	Ja, Nein
63.	mawisperre	Ja, Nein
64.	belnotiz	Zusatztext
65.	eigbanklfnbr	Eigene Zahlungsverbindung
66.	mahnadrnbr	Mahnadresse
67.	extreferenz	Kontaktperson der Mahnadresse (Externe Referenz)
68.	mahnsperrid	Mahnsperrcode
69.	steuercode	Steuercode

Hinweis: Struktur des Result-Sets:
Mit den Methoden ReadDbhgInclKst()/ReadDbhgInclKst2() und GetDbhgInclKstLine() werden Debitorenbuchungen inklusive Fibu- und KORE-Verbuchung ausgelesen.

Zur Bearbeitung des Result-Sets sind folgende Laufnummer wichtig:
Feld 5 „dklfnbr“: Laufnummer der Debibuchung
Feld 6 „lfnbr“: Laufnummer der Fibubuchung
Feld 7 „lfnbrb“:Laufnummer der KORE-Buchung
Feld 8 „banbr“ Buchungsart (in Zusammenhang mit Laufnummer der Fibuverbuchung)

Beispiel:
Eine Debitorenrechnung mit zwei Fibu-Verteilungen mit jeweils einer Steuerbuchung (=zwei Steuerbuchungen) sowie jeweils zwei KORE-Verteilungen (=vier KORE-Buchungen):

Debitorenbuchung 1
Fibubuchung 1
KORE-Buchung 1
KORE-Buchung 2
Steuerbuchung 1

Fibubuchung 2
KORE-Buchung 3
KORE-Buchung 4
Steuerbuchung 2

Zeile	DKLfnbr (Debi-Infos)	Lfnbr / Banbr (Fibu-Infos)	Lfnbrb (KORE-Infos)
1	1. Debibuchung	1 / 1 1. Nettobuchung	1. KORE-Buchung
2	1 Wiederholung!!!	1 / 1 Wiederholung: 1. Nettobuchung!!!	2. KORE-Buchung
3	1 Wiederholung!!!	1 / 11 1. Steuerbuchung	---
4	1 Wiederholung!!!	2 / 1 2. Nettobuchung	3. KORE-Buchung
5	1 Wiederholung!!!	2 / 1 Wiederholung: 2. Nettobuchung!!!	4. KORE-Buchung
6	1 Wiederholung!!!	2 / 11 2. Steuerbuchung	---

Hinweis: Eine Buchung ohne Steuerbuchung und ohne KORE-Verteilung (z.B. Debitorenzahlung) gibt nur eine Zeile zurück.

Beispiel

ReadDbhgInclKst(2000,2000,“19990101“,“19991231“,“ „,“ZZZZZZZZZZZZZ“,0,99999999,“ „,“ZZZZZZZZZZZ“,“O,B,G“)

Mit diesem Befehl wird die Auslese allen Belegen des Debitors 2000 gestartet, welche folgende Bedingungen erfüllen:

Datum innerhalb des Jahres 1999, Beleg erstellt von allen Benutzern (Bereich von „ „ bis ZZZZZZZZZZ...)

alle Externe Belegnummer,

Belege in Status O, B und G

lab:
   zeile = Debi.GetDbhgInclKstLine
   If zeile = “EOF” Then GoTo iyend
GoTo lab
 
iyend:

Bezahlte Belege auslesen

ReadZahlungen, ReadZahlungen2, GetZahlungZeile

Beschreibung

Die Belege werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Zum initialisieren der Liste ist die Methode ReadZahlungen und zum Auslesen GetZahlungZeile vorhanden.

Parameter

Parameter von ReadZahlungen/ReadZahlungen2:

Die Methode ReadZahlungen besitzt die ersten 2, ReadZahlungen2 alle 3 Parameter.

Parameter.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DatumVon	String	Alphanumerisch(8)	Ja	Datum von
2.	DatumBis	String	Alphanumerisch(8)	Ja	Datum bis
3.	Zahlnummer	String	Numerisch	Nein	Wird eine Zahlnummer übergeben wird die Datumseinschränkung nicht berücksichtigt!

Returnwert

ReadZahlungen() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetZahlungZeile() gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder des Buchungsatzes, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	lfnbrd	Laufnummer
2.	debinbr	Debitorennummer
3.	belnbr	Belegnummer
4.	beldte	Belegdatum
5.	verfdte	Verfalldatum
6.	status	Status (offen, bezahlt, gedruckt, LSV => O, B,G, L)
7.	typ	Typ (R,G,V,T,Z). Ist immer Z, da mit dieser Methode nur die Zahlungen geholt werden
8.	mhgsperdte	Mahnsperre
9.	kondnbr	Kondition
10.	mahnnbr	Mahngruppe
11.	stufenbr	Mahnstufe
12.	beltext	Belegtext
13.	sachbid	Sachbearbeiter
14.	verkid	Verkaeufer
15.	refnbr	Referenz
16.	ausglnbr	Ausgleichnummer
17.	ausgldte	Ausgleichdatum
18.	lastmhgdte	Datum letzter Mahnung
19.	zlglaufnbr	Zahlungslaufnummer
20.	belnr	Externe Belegnummer
21.	buchbetr	Betrag in Belegwährung
22.	bvaldate	Valutadatum
23.	bkurs	Belegkurs
24.	bwhg	Belegwährung
25.	hyparchivnbr	Hyparchivnummer
26.	hypdrucken	Ja, Nein
27.	mawisperre	Ja, Nein
28.	bezahlter Beleg	Laufnummer des ausgeglichenen Beleges
29.	war eine Verlustbuchung	J/N
30.	eigbanklfnbr	Laufnummer eigene Bank
31.	useridnbr	Benutzer-ID
32.	oldtyp	Typ des ausgeglichenen Beleges

Beispiel

Debi.ReadZahlungen(“20000101“,“20001231“)
 
lab:
   zeile = Debi.GetZahlungZeile
   If zeile = “EOF” Then GoTo iyend
GoTo lab
 
iyend:

Bank schreiben

WriteBank2, WriteBank3, WriteBank4, GetZahlungsverbLaufnr

Beschreibung

Die Methode WriteBank2/3/4 legt eine Debitorenbank an. Die Methode GetZahlungsverbLaufnr holt die zugeteilte Banklaufnummer.

Parameter

Die Methode WriteBank2 besitzt die ersten 18, WriteBank3 die ersten 21 Parameter und WriteBank4 hat 25 Parameter. Siehe nachfolgende Tabelle.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebiiNbr	Long	Numerisch	Ja	Kreditorennummer
2.	WhgID	String	Alphanumerisch(3)	Ja	Währungs-Identifikation
3.	BankTyp	String	Alphanumerisch(1)	Ja	Nur Werte B=Bank, P=Post, S=ZA, E=ESR, I=IPI
4.	BankKontoNr	String	Alphanumerisch(30)	Ja/Nein	Nein falls Banktyp = P Ignoriert falls Banktyp = E
5.	BankName	String	Alphanumerisch(40)	Ja	Bankname
6.	BankAdr1	String	Alphanumerisch(40)	Ja	Bankadresse 1
7.	BankAdr2	String	Alphanumerisch(30)	Ja	Bankadresse 2
8.	BankPLZ	String	Alphanumerisch(10)	Ja	Postleitzahl der Bank
9.	BankOrt	String	Alphanumerisch(30)	Ja	Ortschaft der Bank
10.	BankLand	String	Alphanumerisch(5)	Ja	Land der Bank
11.	BankClearingNr	String	Alphanumerisch(12)	Ja	Clearing-Nummer der Bank
12.	BankAktiv	String	Alphanumerisch(1)	Ja	Ja, Nein
13.	BankSwift	String	Alphanumerisch(30)	Ja	SWIFT-Nummer der Bank
14.	BankPCKonto	String	Alphanumerisch(30)	Ja	Postcheck-Konto der Bank
15.	ESRTeilnNbr	String	Numerisch	Nein	Vordefinierter Wert 0 Bei BankTyp=S wird diese Nummer nicht übernommen
16.	Bankleitzahl	String	Alphanumerisch(20)	Nein	Defaultwert „“
17.	IBAN	String	Alphanumerisch(35)	Nein	Defaultwert „“
18.	ReferenzNr	String	Alphanumerisch(30)	Nein	Defaultwert „“
19.	LSVMode	String	Numerisch	Nein	Siehe unten, Defaultwert „“
20.	ERMAusgangDte	String	Datum(4,2,2)	Nein	JJJJMMTT, Defaultwert NOT_SET
21.	ERMEingangDte	String	Datum(4,2,2)	Nein	JJJJMMTT, Defaultwert NOT_SET
22.	VordispBankNbr	String	Numerisch	Nein	Laufnummer der vordisponierten, eigenen Zahlungsverbindung. Ist nur zwingend beim Typ (K)reditkarte. Defaultwert NOT_UPD
23.	VisaArt	String	Alphanumerisch(30)	Nein	Kreditkarten-Art
24.	VisaVerfall	String	Alphanumerisch(15)	Nein	Kreditkarten-Verfall
25.	VisaCVC	String	Alphanumerisch(15)	Nein	Kreditkartenprüfziffer

Mögliche Werte für LSVMode:

1 = Einzug LSV/Debit direct Schweiz mit Widerspruchmöglichkeit

2 = Einzug LSV/Debit direct Schweiz ohne Widerspruchmöglichkeit

3 = Einzug Überweisungsaufforderung

4 = Auszahlung über Kreditoren

11 = Einzug LSV Deutschland Einzugsermächtigung

12 = Einzug LSV Deutschland Abbuchungsermächtigung

13 = Einzug Überweisungsaufforderung

14 = Auszahlung über Kreditoren

Returnwert

Die Methode GetZahlungsverbLaufnr holt die zugeteilte Banklaufnummer.

Bank modifizieren

UpdateBank, UpdateBank2, UpdateBank3

Beschreibung

Modifiziert Daten einer Debitorenbank.

Parameter-List:

Die Methode UpdateBank besitzt dier ersten 16, die Methode UpdateBank2 die ersten 19 Parameter und die Methode UpdateBank3 hat 23 Parameter. Siehe nachfolgende Tabelle.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BankLfNr	Long	Numerisch	Ja	Banklaufnummer
2.	BankKontoNr	String	Alphanumerisch(30)	Ja	Bankkontonummer
3.	BankName	String	Alphanumerisch(40)	Ja/Nein	Nein falls Banktyp = P
4.	BankAdr1	String	Alphanumerisch(40)	Ja	Bankadresse 1
5.	BankAdr2	String	Alphanumerisch(30)	Ja	Bankadresse 2
6.	BankPLZ	String	Alphanumerisch(10)	Ja	Postleitzahl der Bank
7.	BankOrt	String	Alphanumerisch(30)	Ja	Ortschaft der Bank
8.	BankLand	String	Alphanumerisch(5)	Ja	Land der Bank
9.	BankClearingNr	String	Alphanumerisch(12)	Ja	Clearing-Nummer der Bank
10.	BankAktiv	String	Alphanumerisch(1)	Ja	Ja, Nein
11.	BankSwift	String	Alphanumerisch(30)	Ja	SWIFT-Nummer der Bank
12.	BankPCKonto	String	Alphanumerisch(30)	Ja	Postcheck-Nummer der Bank
13.	ESRTeilnNbr	String	Numerisch	Nein	Vordefinierter Wert NOT_UPD
14.	Bankleitzahl	String	Alphanumerisch(20)	Nein	Defaultwert NOT_UPD Wird nicht mehr verwendet
15.	IBAN	String	Alphanumerisch(35)	Nein	Defaultwert NOT_UPD
16.	ExtZlgVerbNr	String	Alphanumerisch(30)	Nein	Defaultwert NOT_SET
17.	LSVMode	String	Numerisch	Nein	LSV-Modus
18.	ERMAusgangDte	String	Datum(4,2,2)	Nein	JJJJMMDD
19.	ERMEingangDte	String	Datum(4,2,2)	Nein	JJJJMMDD
20.	VordispBankNbr	String	Numerisch	Nein	Laufnummer der vordisponierten, eigenen Zahlungsverbindung. Ist nur zwingend beim Typ (K)reditkarte. Defaultwert NOT_UPD
21.	VisaArt	String	Alphanumerisch(30)	Nein	Kreditkarten-Art. Defaultwert NOT_UPD
22.	VisaVerfall	String	Alphanumerisch(15)	Nein	Kreditkarten-Verfall Defaultwert NOT_UPD
23.	VisaCVC	String	Alphanumerisch(15)	Nein	Kreditkartenprüfziffer Defaultwert NOT_UPD

Mögliche Werte für LSVMode:

1 = Einzug LSV/Debit direct Schweiz mit Widerspruchmöglichkeit

2 = Einzug LSV/Debit direct Schweiz ohne Widerspruchmöglichkeit

3 = Einzug Überweisungsaufforderung

4 = Auszahlung über Kreditoren

11 = Einzug LSV Deutschland Einzugsermächtigung

12 = Einzug LSV Deutschland Abbuchungsermächtigung

13 = Einzug Überweisungsaufforderung

14 = Auszahlung über Kreditoren

Bemerkung

Bemerkung: Wird in den Parametern der Wert NOT_UPD übergeben, so werden diese Parameter nicht modifiziert und behalten ihren ursprünglichen Wert.

Bank löschen

DropBank2

Beschreibung

Die Bank, welche durch BankID bestimmt wird, wird gelöscht.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	BankID	Long	Numerisch	Ja	Bank-Identifikation

Beispiel

Debi.DropBank2(1234)

Zahlungsverbindungen eines Debitors lesen

ReadZahlungsverb, GetZahlungsverbZeile

Beschreibung

Die Zahlungsverbindungen werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebitorNr	Long	Numerisch	Ja	Debitorennummer

Returnwert

Ist der Parameter grösser als 0, wird die Defaultzahlungsverbindung ausgelesen.

Ist der Parameter kleiner als 0, so werden alle Banken des Debitors ausgelesen.

ReadZahlungsverb initialisiert das Lesen und gibt keinen Returnwert zurück.

GetZahlungsverbZeile gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	lfnbr	BankLfNr
2.	dknbr	DebiNbr
3.	whgid	WägrungID (des Debitors)
4.	typ	BankTyp = D
5.	kontonr	BankKontoNr
6.	name	BankName
7.	adresse1	BankAdr1
8.	adresse2	BankAdr2
9.	ccode	BankLand
10.	plz	BankPLZ
11.	ort	BankOrt
12.	clearing	BankClearingNr
13.	isaktiv	BankAktiv = J oder N
14.	swift	BankSwift
15.	kontoart	B für Bank, P für Post, S für ZA
16.	pckonto	BankPCKonto
17.	teilnnbr	ESRTeilnNbr
18.	Bankleitzahl	Wird nicht mehr verwendet
19.	IBAN	International Bank Account Number
20.	ExtZlgVerbNr	Externe Zahlungsverbindungsnummer
21.	lsvmode	LSV-Modus
22.	lsvermausdte	Absendedatum der LSV Belastungsermächtigung
23.	lsvermeindte	Eingangsdatum der LSV Belastungsermächtigung
24.	vordispbanknbr	Vordisponierte, eigene Zahlungsverbindung. (0=Keine Vordisposition).
25.	visaart	Kreditkarten-Art
26.	visaverfall	Kreditkarten-Verfall
27.	visacvc	Kreditkartenprüfungsziffer

Mögliche Werte für LSVMode:

1 = Einzug LSV/Debit direct Schweiz mit Widerspruchmöglichkeit

2 = Einzug LSV/Debit direct Schweiz ohne Widerspruchmöglichkeit

3 = Einzug Überweisungsaufforderung

4 = Auszahlung über Kreditoren

11 = Einzug LSV Deutschland Einzugsermächtigung

12 = Einzug LSV Deutschland Abbuchungsermächtigung

13 = Einzug Überweisungsaufforderung

14 = Auszahlung über Kreditoren

Beispiel

‘Defaultbank lesen
Call Buch. ReadZahlungsverb(1000) 

lab:
   zeile = Buch.GetZahlungsverbZeile
   If zeile = “EOF” Then GoTo iyend
GoTo lab
 
iyend:
 
‘Alle Zahlungsverbindungen eines Debitors lesen
Call Form1.Debi.ReadZahlungsverb(-55555)

Fallsaldo ermitteln

GetDebitorFallSaldo

Beschreibung

Der Saldo eines Falles des gegebenen Debitors wird ermittelt.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebiNr	Long	Numerisch	Ja	Debitorennummer
2.	StichDatum	String	Datum(4,2,2)	Ja	JJJJMMDD
3.	FallNummer	String	Alphanumerisch(39)	Ja	Fallnummer

Returnwert

Saldo des Falles.

Ist die DebiNr nicht 0, so wird der Fallsaldoanteil dieses Debitors berechnet.

Liste der gemahnten Belege holen

ReadMahnungen, ReadMahnungen2, GetMahnListe

Beschreibung

Die Liste der gemahnten Belege wird ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben.

Parameter

Parameter ReadMahnungen und ReadMahnungen2

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Lfnbr	String	Numerisch	Nein	Laufnummer der Mahnung. Wird 0, leer oder NOT_SET übergeben, werden die Belege aller Mahnungen gelesen (analog ReadMahnungen()).

Returnwert

ReadMahnungen()/ReadMahnungen2() initialisiert das Lesen und gibt keinen Returnwert zurück.

GetMahnListe gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Eine Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Lfnbrd	Interne Laufnummer des Beleges.
2.	Debinbr	Debitorennummer
3.	Debiwhg	Debitorenwaehrung
4.	Mhgdte	Mahnlaufdatum (Verfalldatum)
5.	Belnbr	Belegnummer
6.	Beldte	Belegdatum
7.	Verfdte	Verfalldatum
8.	Typ	Belegtyp (R, G, V)
9.	Mahnnbr	Mahngruppe
10.	Stufenbr	Mahnstufe
11.	Beltext	Belegtext
12.	Verftage	Verfalltage (=Verzug: Mahnlaufdatum – Verfalldatum)
13.	Sprcode	Sprachcode des Debitors
14.	Betragbas	Belegbetrag in Basiswährung
15.	Betragk	Belegbetrag in Kontowährung
16.	Saldo	Aktueller OP-Saldo des Debitors.
17.	Belnr	Externe Belegnummer
18.	Basiswhg	Basiwährung
19.	Rechbetrag	Wird nicht mehr benutzt. Ist immer 0.00
20.	Mahnbetrag	Wird nicht mehr benutzt. Ist immer 0.00
21.	Verfallen	Ist der Beleg verfallen (=Verfalltage > 0)
22.	Lfnbr	Mahnlaufnummer
23.	Lfnbrd	Interne Laufnummer des Beleges.
24.	Debinbr	Debitorennummer
25.	Debiwhg	Debitorenwaehrung
26.	Mhgdte	Mahnlaufdatum (Verfalldatum)
27.	Belnbr	Belegnummer

Mahnlauf abschliessen

SetMahnabschluss

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	MandantID	String	Alphanumerisch(2)	Ja	Mandantenidentifikation
2.	lfnbrD	Long	Numerisch	Ja	Laufnummer

Returnwert

Diese Methode liefert keinen Returnwert.

Behandlung duplizierter Belegnummern

EnableDuplBelNr

Beschreibung

Durch die interne Erweiterung der Methode CheckDoubleIntBelNbr wurde diese obsolet, ist aber weiterhin funktionsfähig.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

Allowed

Bool

TRUE-Duplizierte Belegnummer löst eine Warnung aus. Der Beleg wird verbucht.

FALSE-Duplizierte Belegnummer löst einen Fehler aus. Der Beleg wird zurückgewiesen.

Returnwert

Diese Methode liefert keinen Returnwert.

Behandlung duplizierter externer Belegnummern

EnableDuplBelNr

Beschreibung

Durch die interne Erweiterung der Methode CheckDoubleExtBelNbr wurde diese obsolet, ist aber weiterhin funktionsfähig.

Parameter

Nr.

Feldname

Parametertyp

Typ des Wertes

Zwingend

Erklärung

Allowed

Bool

TRUE-Duplizierte Externe Belegnummer löst eine Warnung aus. Der Beleg wird verbucht.

FALSE-Duplizierte Externe Belegnummer löst einen Fehler aus. Der Beleg wird zurückgewiesen.

Returnwert

Diese Methode liefert keinen Returnwert.

Belege verrechnen

Verrechnen

Beschreibung

Diese Methode ist ab V-7.0 nicht mehr verfügbar. Für das korrekte Verrechnen von Belegen ist eine 0.00-Debitorenzahlung auszuführen (siehe Zahlung schreiben).

Vorauszahlungen oder Teilzahlungen verbuchen

Beschreibung

Ablauf:

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann die Vorauszahlung oder Teilzahlung verbucht werden.

Das Verbuchen erfolgt in 2 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

SetZahlung(): zwingend
Mit dieser Methode werden die gemeinsame Felder wie ValutaDatum, Betrag usw. abgefüllt. Für die Parameter dieser Methode siehe Zahlung schreiben.

WriteVorauszahlung()/WriteVorauszahlung2() oder WriteTeilzahlung()/ WriteTeilzahlung2()/WriteTeilzahlung3(): zwingend
Mit dieser Methode wird die Voraus- oder Teilzahlung geschrieben.

WriteVorauszahlung, WriteVorauszahlung2

Parameter

WriteVorauszahlung hat die ersten 4 Parameter, WriteVorauszahlung2 hat 8 Parameter.

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Text	String	Alphanumerisch(60)	Ja	Kreditkartenacquirer
2.	Belegnummer	Long	Numerisch	Ja	Siehe GetNextBelNbr
3.	Sammelkonto	String	Alphanumerisch(15)	Nein	Als Default wird das Sammelkonto des Debitors verwendet.
4.	Steuerfeld	String	Alphanumerisch(n)	Nein	Ausführliche Informationen zum Steuerfelder-Parameter sind unter GetSteuerFeld (Abschnitt Returnwert) zu finden. Ist dieses Feld leer, werden der Defaultsteuercode verwendet und daraus die Steuer berechnet
5.	VerfallDte	String	Datum(4,4,2)	Nein	Verfalldatum. Bei leer oder NOT_SET wird das Belegdatum verwendet. Defaultwert „NOT_SET“
6.	VerkaeuferID	String	Alphanumerisch(5)	Nein	Verkaeufer-ID. Mit dem Wert „DEFAULT“ kann der Vorschlag gemäss Debitorenstamm verwendet werden. Defaultwert „NOT_SET“
7.	MahnAdrNbr	String	Numerisch	Nein	Mahnadresse des Belegs. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keine Mahnadresse zu. Defaultwert „DEFAULT“.
8.	MahnKontaktNbr	String	Numerisch	Nein	Interne Kontaktlaufnummer der Mahnadresse. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keinen Kontakt zu. Defaultwert „DEFAULT“ Die interne Kontaktlaufnummer kann auch via Externe Referenz geholt werden. Siehe dazu auch Kontaktadressen.

Returnwert

Diese Methode hat keinen Returnwert.

SetLaufenberg

Beschreibung

Diese Methode ist ab V-7.0 nicht mehr verfügbar.

WriteTeilzahlung

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	RechnungsNummer	Long	Numerisch	Ja	Laufnummer der Rechnung, der die Teilzahlung zugewiesen werden soll. Dabei wird die Belegnummer, die Externe Belegnummer und der Verkaeufer von der zugewiesenen Rechnung übernommen. Wird 0 übergeben, findet keine Zuweisung statt.
2.	Text	String	Alphanumerisch(60)	Ja	Wird leer übergeben, wird der Text gemäss Einstellungen verwendet.
3.	Sammelkonto	String	Alphanumerisch(15)	Nein	Als Default wird das Sammelkonto des Debitors verwendet.

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Da in dieser Methode die Belegnummer der Teilzahlung nicht als Parameter verfügbar ist (im Gegensatz zur Methode WriteTeilzahlung2), wird als Belegnummer der Teilzahlung der Wert des Parameters BelNbr der Methode SetZahlung verwendet. à siehe auch WriteTeilzahlung2().

WriteTeilzahlung2, WriteTeilzahlung3, WriteTeilzahlung4

Parameter

WriteTeilzahlung2 hat 4 oder 8 Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DKLfnbr	String	Numerisch	Nein	Laufnummer der Rechnung, der die Teilzahlung zugewiesen werden soll. Dabei werden die Belegnummer, die Externe Belegnummer, der Verkaeufer und die Mahnadresse von der zugewiesenen Rechnung übernommen. Wird “NOT_SET“, „0“ oder leer übergeben, findet keine Zuweisung statt.
2.	Text	String	Alphanumerisch(60)	Nein	Als Default wird der Text gemäss Einstellungen verwendet.
3.	Sammelkonto	String	Alphanumerisch(15)	Nein	Als Default wird das Sammelkonto des Debitors verwendet (NOT_SET). Es darf kein Leerstring übergeben werden
4.	BelegNr	String	Numerisch	Nein	Belegnummer der Teilzahlung (nur verwenden wenn automatisches Erhöhen der Belegnummer in den Einstellungen ausgeschaltet ist!). Falls die Teilzahlung einer Rechnung zugewiesen ist, ist der Default=Belegnummer der Rechnung, ansonsten =0. à Hinweis: Die Belegnummer der Methode SetZahlung wird nicht beachtet.
5.	VerfallDte	String	Datum(4,4,2)	Nein	Verfalldatum. Bei leer oder NOT_SET wird das Belegdatum verwendet. Defaultwert „NOT_SET“
6.	VerkaeuferID	String	Alphanumerisch(5)	Nein	Verkaeufer-ID. Mit dem Wert „DEFAULT“ kann der Vorschlag gemäss Debitorenstamm verwendet werden. Wird die TZ einer Rechnung zugewiesen und hat VerkaeuferID keinen Wert, wird die VerkaeuferID der Rechnung übernommen. Defaultwert „NOT_SET“
7.	MahnAdrNbr	String	Numerisch	Nein	Mahnadresse des Belegs. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keine Mahnadresse zu. Wird die TZ einer Rechnung zugewiesen und ist der Wert “DEFAULT“, wird die Mahnadresse der Rechnung übernommen. Defaultwert „DEFAULT“.
8.	MahnKontaktNbr	String	Numerisch	Nein	Interne Kontaktlaufnummer der Mahnadresse. Mit „DEFAULT“ wird der Vorschlag gemäss Debitorenstamm verwendet. „NOT_SET“ weist keinen Kontakt zu. Wird die TZ einer Rechnung zugewiesen und ist der Wert “DEFAULT“, wird der Mahnkontakt der Rechnung übernommen. Defaultwert „DEFAULT“ Die interne Kontaktlaufnummer kann auch via Externe Referenz geholt werden. Siehe dazu auch Kontaktadressen.

Bei der Teilzahlung ist es erlaubt, als Eingangsbankkonto ein Kreditkartenacquirer zu verwenden. Dabei wird die Buchung immer definitiv geschreiben, sowie, falls nötig, eine Kommissionsbuchung geschrieben.

Returnwert

WriteTeilzahlung, WriteTeilzahlung2 und WriteTeilzahlung3 lieferten keinen Returnwert.

WriteTeilzahlung4: Gibt als Returnwert die Laufnummer der zuletzt geschriebenen Buchung zurück.

Verlust verbuchen

Beschreibung

Im Folgenden wird angegeben wie eine Verlustbuchung mit dem ActiveX-Server geschrieben wird.

Ablauf:

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann die Verlustbuchung werden.

Das Verbuchen erfolgt in 4 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

SetZahlung(): zwingend
Mit dieser Methode werden die gemeinsame Felder wie ValutaDatum, Betrag usw. abgefüllt. Für die Parameter dieser Methode siehe Kapitel Zahlung schreiben.

SetVerlustBeleg(): zwingend
Mit dieser Methode werden zusätzliche Informationen übergeben, welche bei SetZahlung fehlen..
SetVerteilung(): zwingend
Mit dieser Methode werden die Gegenkontobeträge, Steuer- und KORE-Daten abgefüllt. Der Aufruf dieser Methode schreibt einen neuen Gegenkonto-, Steuer- und KORE-Verteilungseintrag. Falls es sich im Beleg anlagewirksame Konti befinden, muss unmittelbar vor dem Aufruf der Methode SetVerteilung die Methode SetAnlageData() aufgerufen werden.
WriteVerlust(): zwingend
Diese Methode führt das schreiben einer Verlustbuchung durch.

SetVerlustBeleg

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	RechnungsNummer	String	Numerisch	Ja	Rechnungsnummer
2.	Text	String	Alphanumerisch(60)	Nein	Text
3.	ErfassArtVK	String	Alphanumerisch(1)	Ja	V=Vorerfassung, K=Kontierung

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung

Beschreibung

Mit der Methode SetVerlustBeleg wurde angegeben welcher Beleg als Verlust verbucht werden muss. Im folgenden müssen der Netto – und Steuerbetrag, mit dem Betrag des Belegs übereinstimmen.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Gegenkonto	String	Alphanumerisch(15)	Ja	Erlöskonto aus der Konto-Tabelle
2.	Fibu Buchungstext	String	Alphanumerisch(60)	Ja	Fibu Buchungstext
3.	Nettobetrag BW	String	Numerisch(17.2)	Ja	BW=Belegwährung (Fremd- oder Grundwährung)
4.	Steuerfelder	String	Alphanumerisch(n)	Ja	Ausführliche Informationen zum Steuerfelder-Parameter sind unter GetSteuerFeld (Abschnitt Returnwert) zu finden.
5.	KST-Felder	String	Alphanumerisch(n)	Ja	KST1[KstKtr_Trenner KTR1] Feld_Trenner Text Feld_Trenner Betrag GW Rec_Trenner, (0 – n mal) z.B. KST1{-}KTR1{<}Text{<}Betrag{>} oder KST1{<}Text{<}Betrag{>} oder {-}KTR1{<}Text{<}Betrag{>}, siehe die Methode SetDelimiters *) Der Betrag in GW kann mit der Methode CalcBebuBetrag berechnet werden. Wird als GW Betrag der String CALCULATE übergeben, wird der Basisbetrag automatisch berechnet. Siehe dazu das Kapitel API-Allgemein – Gefahren. Wird keine Kostenstelle/-Träger angegeben, wird die Defaultkostenstelle des Kreditors verwendet.
6.	PrjExt	String	Alphanumerisch(n)	Nein	[Koart] Feld_Trenner [Projekt] Feld_Trenner [LeistgArt] Feld_Trenner [Menge] Rec_Trenner **) siehe die Methode SetDelimiters. Beispiel:600{<}{<}{<}{>} gibt die Kostenart 600 für die Bebu-Buchung des kostenpflichtigen Gegenkontos an. Der ganze Parameter sollBebuExt kann leer bleiben

*) Angaben in den eckigen Klammern sind fakultativ

Returnwert

Diese Methode hat keinen Returnwert.

SetAnlageData

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	AnlageNr	String	Alphanumerisch(15)	Ja	Anlagenummer
2.	Buchungstext	String	Alphanumerisch(60)	Nein	Wird kein Text übergeben, so wird der Buchungstext aus dem Parameter Buchungstext der Methode SetVerteilung übernommen

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Zwingend, falls sich im Beleg anlagewirksame Konti befinden

WriteVerlust

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Debi.SetZahlung(BankID, Datum, ValutaDatum, Waehrung, Kurs, VebitorNr, Zahlungstotal, BelNbr)
Call Debi.SetVerlustBeleg(RechnungsNr, Text, VorerfassungArtJN)
Call Debi.SetVerteilung(GegenKto, FibuText, NettoBetrag, SteuerFeld,BeBuEintrg)
Debi.WriteVerlust

GetSteuerFeld

Beschreibung

Mit diese Methode kann das Feld ‘Steuerfelder‘ der Methode SetVerteilung berechnet werden.

Die Methode entspricht jener im Finanzbuchhaltungs-Objekt: siehe GetSteuerFeld.

KORE-Betrag berechnen

CalcBebuBetrag

Beschreibung

Mit dieser Methode kann der KORE-Betrag in Basiswährung berechnet werden

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Whg	String	Alphanumerisch(3)	Ja	Währung
2.	Kurs	String	Numerisch	Nein	Ist dieses Feld leer, wird der Kurs aus der Tabelle Kurs entnommen
3.	Datum	String	Datum(4,2,2)	Nein	Ist dieses Feld leer, wird das aktuelle Datum verwendet.
4.	Betrag	String	Numerisch	Ja	KORE-Betrag

Returnwert

Als Returnwert erhält man den KORE-Betrag in Basiswährung, der bei der Methode SetVerteilung verwendet werden kann, sowie ob der Kurs verwendet wurde.

CalcBebuBetrag gibt als Returnwert eine Zeile zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Erklärung
1.	Bebubetrag	Buchungsbetrag Betriebsbuchhaltung
2.	Kurs verwendet	Gibt an, ob der übergebene Kurs verwendet wurde

Beispiel

zeile = Debi.CalcBebuBetrag(“EUR“, “1.58“, ““, “100.12“)

Fibutext erstellen

GetFibuText, GetFibuText2

Beschreibung

Mit dieser Methode kann der beim Schreiben zu verwendende Fibutext erstellt werden. Dabei wird der Text anhand der Einstellungen erstellt.

GetFibuText benötigt die nur die ersten 4 Parameter

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Debitor	Long	Alphanumerisch(3)	Ja	Debitor
2.	Whg	String	Alphanumerisch(3)	Ja	Währung
3.	BelegTypRG	String	Alphanumerisch(1)	Nein	Mögliche Werte: R, G R: Rechnung G: Gutschrift Anhand dieser Daten wird der Text aus den Einstellungen gelesen. Wird nur verwendet, wenn es sich beim Parameter 4 um einen leeren String handelt.
4.	Text	String	Alphanumerisch()	Nein	Zu verwendender Text (Siehe Parameter 4)
5.	Externe Belegnummer	String	Alphanumerisch()	Nein	Externe Belegnummer

Returnwert

Als Returnwert erhält man den Fibutext.

Bei den folgenden Beispielen ist der Fibutext wie folgt definiert:

Debitor: <Debitorennummer> Belegtext: <Belegtext> Name: <Name> Ort: <Ort>

Beispiel

Fibutext = Debi.GetFibuText(1000, “CHF“, “R“, ““)

Inhalt von Fibutext:

Debitor: 1000 Belegtext: Rechnung Name: Gubler AG Ort: Oberwil

Fibutext = Debi.GetFibuText(1000, “CHF“, “R“, “Mein Text“)

Inhalt von Fibutext:

Debitor: 1000 Belegtext: Mein Text Name: Gubler AG Ort: Oberwil

Verwendete KORE-Beträge lesen

GetUsedBebuBetrag

Returnwert

Diese Methode gibt als Returnwert die verwendeten KORE-Beträge zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Da es möglich ist auf einen Beleg mehrere Verteilungen zu schreiben, befindet sich am Ende jeweils ein RecDelim.

Die Zeile beinhaltet folgende Felder:

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Whg	String	Alphanumerisch(3)	Ja	Währung
2.	Kurs	String	Numerisch	Nein	Ist dieses Feld leer, wird der Kurs aus der Tabelle Kurs entnommen

Beispiel

zeile = Debi.GetUsedBebuBetrag()

Beipiele mit Zahlen:

Einmal SetVerteilung aufgerufen

Belegwährung = Basiswährung
Nettobetrag = 2000
sollKst/HabenKst (KST-Felder) = “{-}HANDEL{<}Text34{<}999.99{>}PROD{-}{<}Text{<}1000{>}“

Die Methode liefert somit:
2000{>}1999.99{<}

Mehrmals SetVerteilung aufgerufen:
Belegwährung = Basiswährung
Nettobetrag = 2000
sollKst/HabenKst = “{-}HANDEL{<}Text34{<}999.99{>}PROD{-}{<}Text{<}1000{>}“
Nettobetrag = 1000
sollKst/HabenKst = “{-}HANDEL{<}Text34{<}999.99{>}“

Die Methode liefert somit:
2000{>}1999.99{<}1000{>}999.99{<}

Mandanten-Banklaufnummer zu Konto ausgeben

GetBankLfnbr

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Konto	String	Alphanumerisch(15)	Ja	Konto

Returnwert

Diese Methode gibt als Returnwert die verwendete Mandanten-Banklaufnummer des übergebenen Kontos zurück. Sind mehere Banken mit dem gleichen Konto vorhanden, wird ein Fehler erzeugt.

Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	Banklaufnummer	Banklaufnummer

Beispiel

zeile = Debi.GetBankLfnbr(“1000“)

Interne Zahlungsverbindungslaufnummer lesen

GetIntZahlVerbNr

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DebiNbr	String	Numerisch	Ja	Debitornummer
2.	extZahlVerbNr	String	Alphanumerisch(30)	Nein	Externe Zahlunsverbindungslaufnummer

Returnwert

Diese Methode gibt als Returnwert die interne Zahlungsverbindungslaufnummer zur übergebenen externen zurück. Die externe Laufnummer ist pro Debitor eindeutig und kann vom Benutzer definiert werden.

Beispiel

intLfNbr = Debi.GetIntZahlVerbNr(DebitNr, extZahlVerbNr)

Belegexistenz überprüfen (und interne Laufnummer holen)

doesBelegExist, doesBelegExist2, doesBelegExistExtern

Parameter

Parameter von doesBelegExist Parameter 1 - 6

doesBelegExist2 Parameter 1 - 8

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	dknbr	String	Numerisch	Ja	Debitorennummer
2.	whgid	String	Alphanumerisch(3)	Ja	Währung des Debitors
3.	belnbr	String	Numerisch	Ja	Belegnummer
4.	betrag	String	Numerisch	Ja	Buchungsbetrag. Wird betrag mit 0, leer oder NOT_SET übergeben, wird der Belegbetrag nicht geprüft.
5.	typ	String	Alphanumerisch(1)	Ja	Belegtyp. Wird ein Belegtyp übergeben, z.B. (R)echnung, (G)utschrift, (T)eilzahlung, (V)orauszahlung, (Z)ahlung, wird nur innerhalb dieses Belegtyps gesucht. Wird leer oder NOT_SET übergeben, werden alle Belegtypen durchsucht.
6.	status	String	Alphanumerisch(1)	Ja	Belegstatus. Wird ein Belegtyp übergeben, z.B. (O)ffen, (B)ezahlt oder in (L)SV-Zahlung, werden nur Belege mit diesem Status gesucht. Wird leer oder NOT_SET übergeben, werden alle Stati durchsucht.
7.	beldtevon	String	Datum(4,2,2)) YYYYMMTT	Ja	Von-Belegdatum. Wird leer oder NOT_SET übergeben so wird keine Datumseinschränkung gemacht
8.	beldtebis	String	Datum(4,2,2) YYYYMMTT	Ja	Bis-Belegdatum. Wird leer oder NOT_SET übergeben so wird keine Datumseinschränkung gemacht

Parameter von doesBelegExistExtern

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	dknbr	String	Numerisch	Ja	Debitorennummer
2.	whgid	String	Alphanumerisch(3)	Ja	Währung des Debitors
3.	extbelnr	String	Alphanumerisch(30)	Ja	Externe Belegnummer
4.	typ	String	Alphanumerisch(1)	Ja	Belegtyp. Wird ein Belegtyp übergeben, z.B. (R)echnung, (G)utschrift, (T)eilzahlung, (V)orauszahlung, (Z)ahlung, wird nur innerhalb dieses Belegtyps gesucht. Wird leer oder NOT_SET übergeben, werden alle Belegtypen durchsucht.
5.	status	String	Alphanumerisch(1)	Ja	Belegstatus. Wird ein Belegtyp übergeben, z.B. (O)ffen, (B)ezahlt oder in (L)SV-Zahlung, werden nur Belege mit diesem Status gesucht. Wird leer oder NOT_SET übergeben, werden alle Stati durchsucht.

Returnwert

Methode „doesBelegExist“: Suchen über Belegnummer und Betrag (optional)

Diese Methode gibt 0 zurück, falls gemäss den Parametern kein entsprechender Beleg gefunden wird. (Beleg existiert nicht).

Diese Methode gibt die interne Laufnummer des gefundenen Beleges zurück (grösser als 0), falls gemäss den Parametern ein entsprechender Beleg gefunden wird (Beleg existiert).

Achtung: Werden gemäss den getroffenen Selektionen mehrere Belege gefunden, wird die interne Laufnummer des letzten Beleges zurückgegeben.

Methode „doesBelegExistExtern“: Suchen über externe Belegnummer

Hinweis: Diese Methode entspricht grundsätzlich der Methode „doesBelegExist“. Der Unterschied besteht jedoch darin, dass nach einem Beleg mit Hilfe der externen statt der internen Belegnummer gesucht wird. Darüber hinaus musste aus Performance-Gründen auf die optionale Überprüfung des Belegbetrages verzichtet werden.

Diese Methode gibt 0 zurück, falls gemäss den Parametern kein entsprechender Beleg gefunden wird. (Beleg existiert nicht).

Diese Methode gibt die interne Laufnummer des gefunden Beleges zurück (grösser als 0), falls gemäss den Parametern ein entsprechender Beleg gefunden wird (Beleg existiert).

Achtung: Werden gemäss den getroffenen Selektionen mehrere Belege gefunden, wird die interne Laufnummer des letzten Beleges zurückgegeben.

Beispiel

retval = Debi.doesBelegExist(Debinummer, Debiwrg, Belegnummer, Betrag, Belegtyp, Belegstatus)
 
retval = Debi.doesBelegExist2(Debinummer, Debiwrg, Belegnummer, Betrag, Belegtyp, Belegstatus, BelegDatumVon, BelegDatumBis)
 
retval = Debi.doesBelegExistExtern(Debinummer, Debiwrg, ExtBelegnummer, Belegtyp, Belegstatus)

Offene Gegenleistungen zuordnen

AddZuordnung

Beschreibung

Mit dieser Methode können offene Gutschriften, Teil- oder Vorauszahlungen einer Rechnung zugewiesen werden. Änderungen oder gar Aufhebungen von bestehenden Zuordnungen sind nicht erlaubt und können mit FINANZ API nicht durchgeführt werden.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	LfnbrDRE	Numerisch	Numerisch	Ja	Interne Laufnummer der Debitorenrechnung
2.	LfnbrDZB	Numerisch	Numerisch	Ja	Interne Laufnummer des zuzuordnenden Beleges (GU, TZ, VZ)

Returnwert

Diese Methode liefert keinen Returnwert.

Beispiel

retval = Debi.AddZuordnung(10, 26)

Höchste Debitorennummer holen

GetMaxDebiNbr

Parameter

Diese Methode hat keine Parameter.

Returnwert

Die Methode GetMaxDebiNbr () liefert als Rückgabewert die höchste Debitorennummer (Numerisch) der SBS-Datenbank.

Beispiel

MaxDebiNbr = Debi.GetMaxDebiNbr

Einstellung „Nullerbuchung erlauben“ ermitteln oder setzen

EnableNullBuchung

Beschreibung

Die globale Variable „EnableNullBuchungen“ bestimmt, ob bei Debitorenbuchungen einzelne Buchungszeilen mit dem Betrag 0.00 gebucht werden können.

Die Variable kann die Werte (J)a oder (N)ein enthalten. Der Initialwert ist immer „N“. Der Wert muss nur einmal gesetzt werden. Bei jedem Schreiben einer Buchung wird der einmal zuvor gesetzte Wert angewendet und bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird.

Hinweis: Diese Einstellung gilt nur für das jeweilige Objekt, d.h. in diesem Fall nur für Debitorenbuchungen.

In Simultan Finanz können weiterhin keine Nullerbuchungen erstellt werden. Nullerbuchungen, welche durch das Finanz-API erstellt werden sind daher in Simultan Finanz nicht mutierbar. Das Schreiben von Nullerbuchungen erfolgt daher auf eigene Gefahr des Schnittstellenporgrammierers und sollte wenn möglich vermieden werden.

Beispiel

Variable ermitteln
isnullbhg = Debi.EnableNullBuchungen
 
Variable setzen
Debi.EnableNullBuchungen = „J“

Einstellung „Debitorensperre prüfen“ ermitteln oder setzen

CheckDebiSperre

Beschreibung

Bei Operationen auf einen Debitor darf dieser im Debitorenstamm nicht gesperrt sein. Bei gesperrten Debitoren ist beispielsweise das Schreiben von Belegen nicht erlaubt.

Die Variable CheckDebiSperre kann die Werte (J)a oder (N)ein enthalten. Der Initialwert ist immer „J“. Mit dem Wert "N" kann die Prüfung der Debitorensperre verhindert werden. Somit sind Operationen auf gesperrte Debitoren möglich.

Der Wert muss nur einmal gesetzt werden. Der gesetzte Wert der Variable bleibt erhalten, bis ein anderer Wert gesetzt wird oder das Objekt zerstört wird. Diese Einstellung gilt nur für das Debitorenbjekt.

Beispiel

Beispiel:
Variable ermitteln
isnullbhg = Debi.CheckDebiSperre
 
Variable setzen
Debi.CheckDebiSperre = „N“

Timestamp von Debitorenbelegen überprüfen (ab V-2007.1)

Beschreibung

ReadBelegTimeStamp, BelegTimeStampZeile, SetTimeStamp

Belege können mittels diesen Methoden gekennzeichnet werden um in einem nächsten Lauf nur noch die geänderten Belege zu erhalten. Alle Belege die im Finanz mutiert, bezahlt oder gemahnt werden sind im nächsten Lauf enthalten da der Timestamp des Beleges nicht mehr mit dem Timestamp der History übereinstimmt. Mittels der Methode SetTimeStamp() können Belege in der History gespeichert werden und erscheinen beim nächsten ReadBelegTimeStamp() nicht mehr, ausser diese wurden mutiert.

Die geänderten Belege werden ausgelesen. Wird das Ende des Resultsets erreicht, so wird der Returnwert „EOF“ zurückgegeben.

Zum Initialisieren der Liste ist die Methode ReadBelegTimeStamp und zum Auslesen BelegTimeStampZeile vorhanden

Parameter

Parameter von SetTimeStamp

Ein Beleg wird in die History eingetragen

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	Lfnbr		Numerisch	Ja	Laufnummer

Returnwert

ReadBelegTimeStamp () initialisiert das Lesen und gibt als Returnwert die Anzahl Belege zurück.

BelegTimeStampZeile() gibt als Returnwert eine Zeile des Resultsets zurück. Einzelne Felder, wie in der unteren Tabelle beschrieben, sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet folgende Felder.

Nr.	Feldname	Erklärung
1.	LfNbr	Laufnummer aus Debibuchung
2.	BelNbr	Belegnummer
3.	DebiNbr	Debitorennummer
4.	WhgID	Währungsidentifikation

Beispiel

Set Finanz = CreateObject("SBSxas.AXFinanz")
Set FinObj = Finanz.GetFibuObj
Set DebiObj = Finanz.GetDebiObj
 
'login 
Call Finanz.ConnectSBSdbNoPrompt("server", "sbs", "test1", "", "", "")
Call Finanz.OpenMandant("ZZ", "2010/01")
 
dim anzahl
anzahl=DebiObj.ReadBelegTimeStamp()
msgbox(anzahl)
 
dim zeile
 
do
    zeile=DebiObj.BelegTimeStampZeile
    msgbox(zeile)
loop while zeile <> "EOF"
 
'Beleg mit Laufnummer 3 kennzeichnen
dim lfnbr
lfnbr=3
DebiObj.SetTimeStamp(lfnbr)

DMS-Link schreiben

WriteDMSLink

Beschreibung

Diese Methode schreibt die Verlinkung des Beleges mit einem Dokument welches in einem DMS gespeichert ist. Die Methode muss nach dem Schreiben eines Debitorenbeleges (WriteBuchung) aufgerufen werden. Für Zahlungen kann kein Link erfasst werden. Es können nur Rechnungen und Gutschriften verlinkt werden.

Der Debitorenbeleg muss vorhanden sein, falls nicht wird ein Fehler ausgegeben. Die Laufnummer kann mittels GetBuchLaufnr ermittelt werden, falls der Beleg im API geschrieben wurde.

Parameter

Nr.	Feldname	Parametertyp	Typ des Wertes	Zwingend	Erklärung
1.	DMSMandid	String	Alphanumerisch(2)	Nein	Mandanten-Id für Opacc Documents
2.	AlphaId	String	Alphanumerisch(30)	Nein	Alphanumerische ID zum DMS
3.	NumId	Long	Numerisch	Nein	Nummerische ID zum DMS
4.	LaufNummer	Long	Numerisch	Ja	Laufnummer der Debitorentbuchung (lfnbrd)
5	Hyperlink	String	Alphanumerisch(1000)	Nein	URL für Browseraufruf im D3
6	Beschreibung	String	Alphanumerisch(60)	Nein	Beschreibungsfeld

Returnwert

Es gibt keinen Returnwert.