AXiKrBhg – Kreditoren

Kreditorenobjekt erstellen

GetKrediObj

Parameter

Diese Methode hat keine Parameter.

Returnwert

Gibt als Returnwert einen Pointer auf das Krediobjekt 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 Programms dealloziert werden. Die Deallozierung erfolgt in der umgekehrten Reihenfolge, als die Allozierung.

Konkret zu den obigen Beispielen:

Set Kreditor = Nothing
Set Finanz = Nothing

Beispiel

Beispiel – Automation Schnittstelle:
 
Dim FinanzSrv, Kreditor As Object
 
Set Finanz = CreateObject(“SBSxas.AXFinanz”)
Set Kreditor = Finanz.GetKrediObj
 
Beispiel – COM Schnittstelle:
 
Dim Finanz As AXFinanz
Dim Kreditor As AXiKrBhg
 
Set Finanz = New SBSXASLib.AXFinanz
Set Kreditor = Finanz.GetKrediObj

Erläuterungen zur internen Laufnummer bei Kreditorenbuchungen

Beschreibung

Im Kreditorenobjekt erfolgt der Zugriff auf die Kreditorenbuchung oftmals über die interne Laufnummer der Buchung.

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

Zusatzinformationen

Beschreibung

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

Siehe dazu das Kapitel Adressen-Zusatzinformationen

Kontaktadressen

Beschreibung

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

Siehe dazu das Kapitel Kontaktadressen

Kreditorenadresse neu schreiben

Beschreibung

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

Ablauf:

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

Das Schreiben einer Kreditoren-Adresse erfolgt in 8 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

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

2. 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. Bestell- und Zahladresse abfüllen, fakultativ:
   SetBestelladresse(): Mit dieser Methode wird die Bestelladresse abgefüllt.
   SetZahladresse(): Mit dieser Methode wird die Zahladresse abgefüllt.

4. SetZahlungsverbindung(), fakultativ:
   Mit dieser Methode kann die Zahlungsverbindung abgefüllt werden.
   SetZahlungsverbindungAsID() ist eine alternative Methode, welche einem Kreditor ein schon existierendes Kreditorenbankkonto identisch zuweist (wie z.B. eine Inkassostelle). Beim Modifizieren so eines Kreditorenbankkontos werden gleichzeitig bei allen Kreditoren, wo dieses verwendet ist, die Daten modifiziert. Bankkonti, welche so entstanden sind, befinden sich in einer Gruppe equivalenter Banken.

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

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

7. WriteKreditor3(), zwingend:
   Mit dieser Methode wird die Kreditorenadresse effektiv geschrieben. In den Schritten 1 bis 7 wurden die einzelnen Felder mit den verschiedenen Werten abgefüllt und mit der Funktion WriteKreditor3 wird die Adresse geschrieben.

8. GetAdressLaufnr() und GetZahlungsverbLaufnr(), fakultativ
   Mit diesen Methoden können die zugeteilten Laufnummer des Adressstammes und Kreditorenbank 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.

SetExtendedInfo2, SetExtendedInfo3, SetExtendedInfo4, SetExtendedInfo5, SetExtendedInfo6, SetExtendedInfo7

Parameter

Die Methode SetExtendedIndo2/SetExtendedInfoDefault2 hat 15, SetExtendedIndo3/SetExtendedInfoDefault3 17 Parameter, SetExtendedIndo4/SetExtendedInfoDefault4 18 Parameter, SetExtendedIndo5/SetExtendedInfoDefault5 21, SetExtendedInfo6/SetExtendedInfoDefault6 22 Parameter, SetExtendedInfo7/SetExtendedInfoDefault7 23 Parameter

Mit der Methode SetExtendedInfoDefault2/3/4 können die Daten aus Kreditor-Vorschlag übernommen werden. Dazu muss bei den nachfolgend genannten Feldern der String DEFAULT übergeben werden.

Dies sind die Felder :
Kreditlimite(2), Sammelkonto(4), Vorerfassungskonto(5), Aufwandkonto(6), Sachbearbeiter-ID(7), EinkäuferID(8), Vorschlag KST(9) , Konditionennummer(10), ABC-Code(11), Marktzughg(14), VergAnzeigeAbBelege(15), AbtNr(18)

Returnwert

Diese Methoden haben keinen Returnwert.

Bestell- und Zahladresse abfüllen

SetBestelladresse

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetZahladresse

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

SetZahlungsverbindung

Parameter-List

Returnwert

Diese Methode hat keinen Returnwert.

SetZahlungsverbindungAsID

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Individuelle Daten und Zusatzdaten abfüllen

SetIndividInfoVal()

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 Kreditors überprüft. Die Methode muss vor dem Schreiben eines Kreditors aufgerufen werden.

Parameter

Returnwert

Die Methode hat keinen Returnwert.

Beispiel

Siehe Adressobjekt

WriteKreditor3

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

Wird die Methode WriteKreditor3( dup) mit dem dup = 0 aufgerufen, so kann sie mit dem Fehler 200 beenden, falls es schon einen Kreditoren mit identischen Kreditor-Nummer gibt. Auf die Währung wird dabei nicht geachtet. Der Kreditor wird nicht gespeichert. Soll dieser Kreditor gespeichert werden (denn diesen Kreditor mit der mitgegebenen Währung es noch nicht gibt), so muss die Methode WriteKreditor3 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 WriteKreditor3, wobei dup = 1, der Fehler 200 gemeldet wird, bedeutet das, dass es diesen Kreditoren 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 Kreditor mit der gleichen Nummer gibt.

GetAdressLaufnr

Parameter

Diese Methode hat keinen Parameter.

Returnwert

Numerischer Returnwert representiert die Adress-ID des Debitors im Adressstamm

GetZahlungsverbLaufnr

Parameter

Diese Methode hat keinen Parameter.

Returnwert

Numerischer Returnwert representiert die Bank-ID der Bank des Kreditors.

Kreditorenadresse mutieren

UpdateKreditor2

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Bemerkung

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

Die Methode UpdateKreditor2 bietet eine Möglichkeit die Default-Zahlungsverbindungen durch die fakultativen Parameter ZahlungsverbindungID und EigeneBankID zu ändern. Wird die Methode SetZahlungsverbindung aufgerufen und im Aufruf der Methode UpdateKreditor2 auch der Parameter ZahlungsverbindungID mitgegeben, so wird die Bank, welche durch den Parameter ZahlungsverbindungID identifiziert ist, so mutiert, wie es die Parameter der Methode Setzahlungsverbindung angeben. Die eigene Bank ist im Adress-Objekt mutierbar (Methode UpdateBank). Um eine weitere Zahlungsverbindung nachträglich zu schreiben ist die Methode WriteBank2 im gleichen Objekt bestimmt.

Individuelle Adressen

Beschreibung

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

Die Methoden entsprechen denjenigen im Debitorenobjekt (à siehe Individuelle Adressen), ausser das als Parameter statt die Debitoren- die Kreditorennummer mitgegeben werden muss. Darüber hinaus ist auf der Kreditorenseite nur der Adresstyp „1“ bis „6“ erlaubt (Bestell- und Zahladresse müssen weiterhin über Kreditorenadresse mutieren geändert werden). Die Methoden AddIndivAdresse2 und UpdateIndivAdresse2 stehen im Kreditorenobjekt nicht zur Verfügung. Es sind dafür die älteren Methoden AddIndivAdresse und UpdateIndivAdresse zu verwenden, welche jeweils aus den ersten 9 Parametern der neuen Methoden bestehen.

Kreditorenbeleg neu schreiben

Beschreibung

Um alle Feldes Kreditorenbeleges füllen zu können, muss der Kreditor selber, sowie Angaben in diversen anderen Tabellen vorhanden sein wie z.B. im Konti-Tabelle, Steuer-Tabelle, Sachbearbeiter-Tabelle, usw.

Ablauf:

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, kann der Beleg verbucht werden. 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.

Das Verbuchen eines Kreditorenbelegs erfolgt in 4 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgende Parameterbeschreibung.

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

2. SetBelegKopf2()/SetBelegKopf3()/SetBelegkopf4()/SetBelegkopf5(): 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. 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. SetAnlageData(): zwingend

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. SetQRInfo():
   Mit dieser Methode können die QR-Informationen zum Beleg gespeichert werden

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

Beschreibung

Es sind zwei Methoden vorhanden, wobei bei der Methode SetBelegKopf2 nur Parameter 1 - 20 verwendet werden.

Mit der Methode SetBelegKopf4() kann zusätzlich das Referenzfeld mitgegeben werden.
Mit der Methode SetBelegKopf5() kann zusätzlich das Feld Zusatzinfo mitgegeben werden.

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.

Bemerkung

Zwingend, falls sich im Beleg anlagewirksame Konti befinden.

Individuelle Belegdaten abfüllen

Beschreibung

Die Methoden entsprechen denjenigen im Debitorenobjekt (à siehe Individuelle Belegdaten abfüllen ) ausser, dass nur der Adresstyp „1“ bis „6“ erlaubt ist.

SetQRInfo

Beschreibung

Die Methode setzt die Zusatzinformationen aus dem QR-Beleg

Returnwert

Diese Methode hat keinen Returnwert.

WriteBuchung

Parameter

Diese Methode hat keine Parameter.

Returnwert

Diese Methode hat keinen Returnwert.

Einstellung der automatischen Belegnummerierung ermitteln oder setzen

IncrBelNbr

Beschreibung

Belegnummer Kreditoren 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 = Kredi.IncrBelNbr
 
Variable setzen
Kredi.IncrBelNbr = „N“

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.

Bermekung

Die externe Belegnummer wird pro Kreditor geprüft und muss bei J eindeutig sein.

Beispiel

Variable ermitteln
eindeutig = Kredi.CheckDoubleExtBelNbr    
 
Variable setzen
Kredi.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 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.

Bermekung

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

Beispiel

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

Einstellung für automatische Erzeugung einer ESR-Zahlungsverbindung ermitteln oder setzen

EnableAutoESRZlgVerb

Beschreibung

Diese Einstellung wird beim Kreditorenbeleg neu schreiben benötigt (siehe Parameter TeilnehmerNr der Methode SetBelegKopf2()/SetBelegkopf3() ).

Die Variable EnableAutoESRZlgVerb kann die Werte J oder N enthalten. Der Initialwert ist J. 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.

Beispiel

Variable ermitteln
createautoesrzlgverb = Kredi.EnableAutoESRZlgVerb
 
Variable setzen 
Kredi.EnableAutoESRZlgVerb = „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 = Buch.GetNextBelNbr(BelegTyp)

Kreditorenstamm lesen

ReadKrediStamm2, GetKStammZeile3

Beschreibung

Kreditorenstamm wird ausgelesen.

Parameter

Diese Methoden haben keine Parameter.

Returnwert

ReadKrediStamm2 hat keinen Returnwert.

GetKStammZeile3 gibt als Returnwert die nächste Zeile des Resultsets zurück. Nachdem die letzte Zeile des Resultsets ausgelesen wurde, wird der Returnwert „EOF“.

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

Beispiel

Call Kredi.ReadKrediStamm2
For I = 1 To 1000
    line = Kredi.GetKStammZeile3()
    If line = “EOF” Then GoTo ex
    Print line
Next I
ex:

Kreditoradressen suchen

ReadAdressen, ReadAdressen2, GetAdressZeile

Parameter

Die Methode ReadAdressen hat 15 Parameter, die Methode ReadAdressen2 17 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).

Beispiel

s = Kredi.ReadAdressen(““,““,““,““,““,““,““,““,““,““,““,““,““,““,““)
 
s = Kredi.GetAdressZeile()

Interne Laufnummer einer Buchung lesen

GetBuchLaufnr

Beschreibung

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

Parameter

Diese Methode hat keine Parameter.

Bemerkung

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

Returnwert

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

Beispiel

LaufNr = Kredi.GetBuchLaufnr

Saldo eines Kreditors lesen

GetSaldo, GetSaldo2

Beschreibung

Parameter

Parameter von GetSaldo

Parameter von GetSaldo2

Returnwert

GetSaldo gibt Saldo des gegebenen Kreditors, berechnet in Basiswährung, zurück.
GetSaldo2 gibt den Saldo eines Kreditors in der angegebenen Kontowährung oder Basiswährung zurück.

Beispiel

kredisal = Kredi.GetSaldo(10000)
kredisal = Kredi.GetSaldo2(10000, „EUR“)

Kreditor löschen

DropKreditor2

Beschreibung

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

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.DropKreditor(10002,“EUR“)

Kreditor lesen

ReadKreditor3

Beschreibung

Kreditor-Information wird ausgelesen.

Parameter

Bemerkung

Returnwert

Als Returnwert wird eine Zeile zurückgegeben. Einzelne Felder des Kreditoreniformations sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

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

Beispiel

s = Buch.ReadKreditor3(-10000,““)
s = Buch.ReadKreditor3(10000,“CHF“)

Kreditorenbeleg modifizieren

Beschreibung

Ablauf

Das Modifizieren eines Kreditorenbelegs erfolgt in 4 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen. Ein definitiv verbuchter Beleg kann nicht mehr modifiziert werden.

1. SetBelegKopfForUpdate2()/SetBelegKopfForUpdate3()/SetBelegKopfForUpdate4():  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. UpdateBuchung(): zwingend
   Mit dieser Methode wird der Beleg und alle Verteilungseinträge effektiv verbucht. Eine neue Buchungslaufnummer wird zugeteilt.

SetBelegKopfForUpdate2 / SetBelegKopfForUpdate3 /SetBelegKopfForUpdate4()

Mit SetBelegKopfForUpdate4 kann zusätzlich das Feld Zusatzinfo mitgegeben werden

Parameter-List:

Returnwert

Diese Methode hat keinen Returnwert.

SetVerteilung

Parameter

*) Angaben in den eckigen Klammern sind fakultativ

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

Returnwert

Diese Methode hat keinen Returnwert.

SetAnlageData

Parameter

Bemerkung

Zwingend, falls sich im Beleg anlagewirksame Konti befinden

Returnwert

Diese Methode hat keinen Returnwert.

UpdateBuchung

Parameter

Diese Methode hat keine Parameter.

Returnwert

Diese Methode hat keinen Returnwert.

Beleg löschen

Beschreibung

Die Methoden und Einstellungen zum Löschen eines Kreditorenbeleges entsprechen jener im Debitoren-Objekt. Siehe dazu das Kapitel Beleg löschen im Abschnitt Debitoren.

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

Beispiel

StornoLfnbr = Kredi.MakeStorno(LfNbr, KrediNbr, Whg, BelNbr, BelBetrag, Datum, StornoText)

Anmerkung:

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 = Kredi.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 = Kredi.MakeStorno(, KrediNbr, Whg, BelNbr)
StornoLfnbr = Kredi.MakeStorno(0, KrediNbr, Whg, BelNbr, "")

LfNbr wird der Defaultparameter übergeben sowie BelBetrag ungleich Defaultparameter
Es wird versucht die interne Laufnummer des Belegs anhand der KrediNbr, Whg, BelegNr zu ermitteln. Zusätzlich muss noch der Belegbetrag übereinstimmen.

StornoLfnbr = Kredi.MakeStorno(, KrediNbr, Whg, BelNbr, BelBetrag)
StornoLfnbr = Kredi.MakeStorno(0, KrediNbr, Whg, BelNbr, BelBetrag)

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 wird ReadBeleg2 und zum auslesen GetBelegZeile2 und GetBelegZeile3() verwendet.

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

GetBelegZeile2() liefert 22 und GetBelegZeile3() 26 Parameter

Beispiel

 
Call Kredi.ReadBeleg2(1000)
 
lab:
   zeile = Kredi.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).

Beleg lesen

GetBeleg

Beschreibung

Der Beleg wird ausgelesen.

Parameter

Returnwert

GetBeleg gibt als Returnwert die gefundenen Daten zurück. Einzelne Felder sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Die Zeile beinhaltet die gleichen Felder wie die Methode GetBelegZeile3 (siehe oben).

Beispiel

Call Kredi.GetBeleg(“10000“,“1“)

Kreditorenbuchungen komplette Information lesen

ReadKbhgInclKst, ReadKbhgInclKst2, GetKbhgInclKstLine

Beschreibung

Kreditorenbuchungen werden ausgelesen. Wird das Ende des Resultsets erreicht, wird der Returnwert „EOF“ zurückgegeben. Zum initialisieren der Liste ist die Methode ReadKbhgInclKst und zum auslesen GetKbhgInclKstLine vorhanden.

Parameter

Die Methode ReadKbhgInclKst benutzt die ersten 11 Parameter

Returnwert

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

GetKbhgInclKstLine() 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

ReadKbhgInclKst(20000,20000,"19990101","19991231"," ","ZZZZZZZZZZZZZ",0,99999999," ","ZZZZZZZZZZZ","O")

Mit diesem Befehl wird die Auslese allen Belegen des Kreditors 20000 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.

lab:
   zeile = Debi.GetKbhgInclKstLine
   If zeile = "EOF" Then GoTo iyend
GoTo lab
 
iyend:

Erläuterungen zur Struktur des Result-Sets finden Sie auch in der Methodenbeschreibung im Debitorenobjekt (siehe Debitorenbuchungen komplette Information lesen)

Bank schreiben

WriteBank2, WriteBank3, GetZahlungsverbLaufnr    

Beschreibung

Die Methode WriteBank2 legt eine weitere Kreditorenbank an.

Parameter

WriteBank2 hat 20 Parameter, WriteBank3 21 Parameter.

Returnwert

Die Methode GetZahlungsverbLaufnr holt die zugeteilte Banklaufnummer.

Bank als Kopie einer schon existierenden Bank schreiben

WriteBankAsID, GetZahlungsverbLaufnr    

Beschreibung

Die Methode WriteBankAsID ist eine alternative Methode zur Methode WriteBank2 und sie legt eine weitere Kreditorenbank an.

Die Daten des existierenden Kreditorenbankkontos, welches durch das mitgegebene ID bestimmt ist, werden identisch der neuen Bank zugewiesen (wie z.B. eine Inkassostelle). Siehe auch Gruppe equivalenter Banken.

Parameter

Returnwert

Die Methode GetZahlungsverbLaufnr holt die zugeteilte Banklaufnummer.

Bank modifizieren

UpdateBank, UpdateBank2    

Beschreibung

Modifiziert Daten einer Kreditorenbank.

Parameter

UpdateBank hat 18 Parameter, UpdateBank2 19 Parameter.

Returnwert

Diese Methode hat keinen Returnwert.

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

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Kredi.DropBank2(1234)

Gruppe equivalenter Banken

EQBankAktiv
DropEquivBankGrp

Beschreibung

Beim Kopieren einer bestehenden Kreditorenbank, kann ein Eintrag in die Tabelle „eqbank“ gemacht werden. Das „Original“ und sämtliche „Kopien“ bilden eine Gruppe equivalenter Banken. Beim Modifizieren eines Kreditorenbankkontos werden gleichzeitig bei allen Kreditoren, wo dieses verwendet ist, die Bankdaten modifiziert.

Siehe auch Bank als Kopie einer schon existierenden Bank schreiben (Methode WriteBankAsID) bzw. SetZahlungsverbindungAsID().

Funktion „Gruppe equivalenter Banken“ aktivieren

Ist der Wert der Variable „J“, wird beim Schreiben einer Kreditorenbank über die Methoden WriteBankAsID und SetZahlungsverbindungAsID die Gruppe equivalenter Banken erstellt bzw. nachgeführt.

Die Variable kann die Werte J oder N enthalten. Der Initialwert ist immer „N“. Der Wert muss nur einmal beim Start des ActiveX-Servers 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.

Gruppe equivalenter Banken löschen

Alle Bankkonti, welche sich in einer equivalenter Gruppe mit dem mitgegebenen BankID befinden, werden gelöscht.

Parameter

Parameter von DropEquivBankGrp

Returnwert

Die Methode DropEquivBankGrp hat keinen Returnwert.

Beispiel

Variable ermitteln
eqbank = Kredi.EQBankAktiv
 
Variable setzen
Kredi.EQBankAktiv= „J“

Zahlungsverbindung eines Kreditors lesen

ReadZahlungsverb, GetZahlungsverbZeile

Beschreibung

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

Parameter

Ist der Parameter grösser als 0, wird die Defaultzahlungsverbindung ausgelesen.
Ist der Parameter kleiner als 0, so werden alle Banken des Kreditors ausgelesen.

Returnwert

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.

Beispiel

Call Kredi. ReadZahlungsverb(10000)
 
lab:
   zeile = Kredi.GetZahlungsverbZeile
   If zeile = "EOF" Then GoTo iyend
GoTo lab
 
iyend:

Initialisierung des Auslesens, um alle Banken des Kreditors Nr. 1234 auzulesen.

Call Form1.Kredi.ReadZahlungsverb(-1234)

Belege verrechnen

Verrechnen

Beschreibung

Diese Methode ist ab V-7.0 nicht mehr verfügbar. Das Verrechnen von Belegen ist aber über die Kreditoren-Direktverbuchung möglich (siehe Kreditorbelege über Direktverbuchung zahlen).

Zahlungen, Teilzahlungen schreiben / verbuchen

Beschreibung

Das definitive Verbuchen einer Zahlung oder Teilzahlung erfolgt in zwei Schritten, wobei im ersten Schritt die Zahlungen, Teilzahlung geschriebnen werden und erst im 2 Schritt verbucht werden.

Zahlungen, Teilzahlungen schreiben

Beschreibung

Ablauf

Zuerst werden die verschiedenen Werte den einzelnen Feldern zugewiesen. Wenn alle Zuweisungen erfolgt sind, können die Zahlung oder Teilzahlung verbucht werden.

Das Schreiben erfolgt in 3 verschiedenen Schritten. Für die Felderangaben siehe die nachfolgenden Parameterbeschreibungen.

1. SeBank():zwingend
   Mit dieser Methode werden die Bankdaten abgefüllt.

2. SetZahlung() oder SetTeilzahlung():  zwingend
   Mit dieser Methode werden die Zahlungen oder Teilzahlung gesetzt, die geschrieben werden müssen

3. WriteZahlung(): zwingend
   Mit dieser Methode werden die vorher gesetzten Zahlungen geschrieben.

SetBank

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.SetBank("1","1000", "D", "19990630", "D:\Ausgabeverzeichnis", "Filename","","")

SetZahlung

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.SetZahlung("1{<},"")

SetTeilzahlung

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.SetTeilzahlung("1", "100", "HPB", "27", "2000", "Sammelkonto", "1000", "0000000000000000", "20{<}Steuertext{<}70{>}", "", "")

WriteZahlung, WriteZahung2

Beschreibung

Mit dieser Methode werden die Kreditorzahlungen und Kreditorteilzahlungen geschrieben, die vorher mit den Methoden SetZahlung, WriteZahlung gesetzt wurden.

Parameter

Diese Methoden haben keine Parameter.

Returnwert

Mit WriteZahlung2 erhält man als Returnwert die Zahlungslaufnummer, welche beim schreiben verwendet wurde.

Beispiel

ZlgLfNbr = Kredi.WriteZahlung2()

Zahlung, Teilzahlungen verbuchen

WriteZahlung, WriteZahlung2

Beschreibung

Nun können die geschriebenen Zahlungen, Teilzahlungen verbucht werden. Dies geschieht mit der Methode Verbuchen, wobei die Methode GetZahlungsListe die Zahlungslaufnummern aller geschriebenen Zahlungen, Teilzahlungen liefert.

GetZahlungsListe

Beschreibung

Diese Methode liefert die Zahlungslaufnummern der geschriebenen Belege.

Parameter

Diese Methoden haben keine Parameter.

Returnwert

Einzelne Felder sind durch den FeldDelim getrennt (siehe Kapitel Trennzeichen setzen).

Dabei beinhaltet Line z.B.  1{>}2{>}3{>} oder 1 FeldDelim 2 FeldDelim 3 FeldDelim

Beispiel

Line = Kredi.GetZahlungsListe()

Verbuchen

Beschreibung

Mit dieser Methode werden die Zahlungen, Teilzahlungen verbucht.

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.Verbuchen("1", "19990801", "CHF{<}100{<}3600{<}HANDEL{>} 
                                      EUR{<}100{<}3600{<}HANDEL{>}")

Kreditorenbelege über Direktverbuchung zahlen

SetDZahlung, WriteDZahlung

Beschreibung

Um Kreditorbelege zu zahlen sind die Methoden SetDZahlung und WriteDZahlung vorhanden. Die Methode SetDZahlung initialisiert einen neuen Zahlungslauf.

Parameter

Parameter von SetDZahlung

Parameter von WriteDZahlung

Returnwert

Diese Methode hat keinen Returnwert.

Beispiel

Call Kredi.SetDZahlung(ValDte, BelNbr, ZahlKto, Text, BelDte)
call Kredi.WriteDZahlung(LfNbr, Betrag, Whg, Kurs)
 
Call Kredi.SetDZahlung(ValDte, BelNbr, ZahlKto, Text, BelDte)
call Kredi.WriteDZahlung(LfNbr1{<}LfNbr2{<}, Betrag1{<}Betrag2{<}, Whg, Kurs)

Behandlung duplizierter Belegnummer

EnableDuplBelNr

Beschreibung

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

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

Behandlung duplizierter externer Belegnummer

EnableDuplExtBelNr

Beschreibung

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

Parameter

Returnwert

Diese Methode hat keinen Returnwert.

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

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: