AXiDbBhg – Debitoren

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.

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.

1. SetCommonInfo2():  zwingend
   Mit dieser Methode werden die allgemeinen Informationen abgefüllt.
   Eine alternative Methode dazu ist SetCommonInfoAsAdrID2()

2. 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.

3. SetWebsicherheit1, fakultativ

4. SetWebsicherheit2, fakultativ

5. 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.

6. SetZahlungsverbindung3(), bzw
   SetZahlungsverbindung2(), bzw
   SetZahlungsverbindung(): fakultativ
   Mit dieser Methode wird die Zahlungsverbindung abgefüllt.

7. 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.

8. SetKontokorrent(), fakultativ
   Mit dieser Methode kann angegeben werden ob es sich bei dieser Adresse um einen Kontokorrent handelt.

9. 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.

10. GetAdressLaufnr() und GetZahlungsverbLaufnr(), fakultativ
    Mit diesen Methoden können die zugeteilten Laufnummer des Adressstammes und Debitorenbank gelesen werden.

SetCommonInfo2

Parameter

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.

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetExtendedInfo8, SetExtendedInfoDefault8

Parameter

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.

Parameter

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

Returnwert

Diese Methode hat keinen Returnwert.

Liefer-, Bestell- und Mahnadresse abfüllen

SetLieferadresse

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetMahnadresse

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetBestelladresse

Parameter

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.

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

Returnwert

Diese Methode hat keinen Returnwert.

SetIndivInfoText

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetZusatzDte

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetZusatzText

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetKontokorrent

Parameter

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

Returnwert

Die Methode hat keinen Returnwert.

Beispiel

Siehe Adressobjekt

WriteDebitor3

Parameter

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

Bemerkung

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.

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

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

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:

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

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.

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

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

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

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.

Löschen von individuellen Adressen

DropIndivAdresse

Beschreibung

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

Parameter

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

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.

Parameter von GetDefaultKontaktNbr.

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.

1. SetBuchMode():  fakultativ
   Mit dieser Methode wird der Buchungsmode „provisorisch“ oder „definitiv“ eingestellt. Defaultwert ist „provisorisch“.

2. SetBelegKopf2()/SetBelegKopf3()/SetBelegKopf4()/SetBelegKopf5()/SetBelegKopf6(): zwingend
   Mit dieser Methode werden die Beleg-Kopf Informationen abgefüllt.

3. 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.

4. SetLSVBADBank: fakultativ
   Mit dieser Methode kann die LSV-, BAD-Zahlungsverbindung gesetzt werden.

5. 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()

6. StatCodeBuchung fakultativ
   Mit diesem Property kann der Statistikcode gesetzt werden. Es wird bei allen Buchungen (falls mehrere Gegenbuchungen vorhanden sind) der gleiche Statistikcode geschrieben!

7. WriteBuchung(): zwingend
   Mit dieser Methode wird der Beleg und alle Verteilungseinträge effektiv verbucht.

SetBuchMode

Parameter

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.

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung

Parameter

*) Angaben in den eckigen Klammern sind fakultativ

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung2

Parameter

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

*) 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

Returnwert

Diese Methode hat keinen Returnwert.

SetAnlageData3

Parameter

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

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

Parameter von SetIndivBelegInfoVal

Parameter von SetIndivBelegInfoText

Parameter von SetIndivBelegZusatzDte

Parameter von SetIndivBelegZusatzCombo

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.

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.

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

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).

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

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:

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

Parameter

Parameter von GetSaldo

Saldo eines Debitors in Basiswährung auslesen

Parameter von GetSaldo2

Saldo eines Debitors in einer bestimmten Währung auslesen

Parameter von GetSaldo3

Verfallener Saldo eines Debitors auslesen

Parameter von GetSaldo4

Verfallener Saldo eines Debitors auslesen

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

Returnwert

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

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

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.

1. SetZahlung(): zwingend
   Mit dieser Methode werden die gemeinsame Felder wie ValutaDatum, Betrag usw. abgefüllt.

2. 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

WriteZahlung

Parameter

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

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.

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

2. 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.

3. SetLSVBADBank: fakultativ
   Mit dieser Methode kann die LSV-, BAB-Zahlungsverbindung gesetzt werden.

4. 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()

5. 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

SetVerteilung, SetVerteilung2

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

Parameter 1-6 entsprechen Parameter von SetVerteilung.

Parameter 1-7 entsprechen Parameter von SetVerteilung2.

*) 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

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

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.

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

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

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

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)

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.

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).

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.

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).