Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
  • Übertrag der Belege von PerformX in Abacus Debitorenbuchhaltung

  • Grundlage für den Übertrag von Kundenbelegen an Abacus

  • Es werden keine Rechnungsbelege (PDF) übertragen

  • Details zur Schnittstelle von Abacus

Beschreibung Belege

Quelle

PerformX Belege/Belegarten

Ziel

Abacus Belege/Belegpositionen

Notwendige Abacus-Schnittstelle

AbaConnect Debitorenbuchhaltung

Abacus Schnittstellenversion

debi/document_2024.00

Beschreibung Bedingung für den Übertrag

  1. Abacus Mandant im Geschaeftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung

  2. Das Feld "AbacusNummer” muss leer sein (das ist meistens dieselbe Nummer wie die BelegNummer, diese wird jedoch automatisch beim ersten erfolgreichen Beleg-Uebertrag durch die Schnittstelle abgefuellt. Wenn dieses Feld leer ist, dann ist der Beleg noch nicht in Abacus Debi)

  3. BelegStatusValue == 1 bedeutet "Fixiert". 0 ware "Entwurf" und 2 waere "Verbucht". Es werde nur die Definitiven Belege uebtragen. Nach erfolgreicher Uebertragung wird dieser Status in dieser Zuordnungsdefinition auf "Verbucht" gesetzt.

  4. BelegArt.KurzZeichen != 'ST' bedeutet, dass Stornobelege ausgefiltert werden.

  5. BelegDatum wird wahlweise etwas eingeschraenkt. Dies spielt vorallem eine Rolle wenn die Abacus Anbindung zu einem anderen Zeitpunkt als PerformX stattfindet. Man kann damit entscheiden, dass nur Belege ab einem bestimmten Schnitttag in Frage kommen.

  6. Das BelegDatum ist fueher als das auf dem Geschaeftsbereich eingestellte ‘spaeteste Belegdatum’. Mit dieser Einstellung kann verhindert werden, dass Belege, die in fernerer Zukunft liegen, verfrueht in die Abacus Debi uebertragen werden.

Spezifikation Standard-Schnittstelle

Technische Basiskonfiguration

Beschreibung/Notizen

Übertrag
. Rechnungen und Gutschriften in Abacus Debitorenbuchhaltung

Quellfilterbeschrieb

. Abacus Mandant im Geschäftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung
. UND Das Feld "AbacusNummer muss leer sein (wenn dieses Feld leer ist, dann ist der Beleg noch nicht in Abacus Debi)
. UND BelegStatusValue == 1 bedeutet "Fixiert". 0 bedeutet "Entwurf" und 2 bedeutet "Verbucht". Es werden nur die fixierten Belege übertragen. Nach erfolgreicher Übertragung wird dieser Status in dieser Zuordnungsdefinition auf "Verbucht" gesetzt
. UND BelegDatum wird wahlweise eingeschränkt. Dies spielt vor allem eine Rolle wenn die Abacus Anbindung zu einem anderen Zeitpunkt als PerformX stattfindet. Man kann damit entscheiden, dass nur Belege ab einem bestimmten Schnitttag in Frage kommen
. UND der Debitorenbeleg hat ein Datum kleiner/gleich voreingestelltes Maximaldatum des Geschaeftsbereiches

Allgemeine Funktion dieser Zuordnungsdefinition
. Nachdem ein Beleg in Abacus übertragen wurde, wird der BelegStatusValue auf "Verbucht" gesetzt und die BelegNummer ins Feld AbacusNummer geschrieben
. Die Schnittstelle füllt weitere Synchronisationswerte ein

History
. 11.07.2024: Basisversion

. 31.07.2024: Rev 1 PZ:
Beim Uebertrag der Positionen wurde die Zusammenstellung des Textes angepasst. Neu wird der Artikeltext durch den definierbaren Belegspositionsgruppentext erfaenzt (falls die Position einer Gruppe zugeordnet ist)

. 19.08.2024: Rev 2 PZ:
Die OP Rueckuebertragung bei der Uebertragung dieser 'fixierten' Belege wurde deakiviert, weil diese Funktionalitaet bereits durch PerformX berechnet wird
Aktueller Quellfilter:
GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegDatum >= CreateDate(2024, 01, 01)

. 05.09.24: Rev 3 PZ:
Quellfilteranpassung: Es duerfen nur Belege uebertragen werden, die ein Belegdatum < als das auf dem Geschaeftsbereich voreingestellte spaeteste Belegdatum haben
GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= GeschaeftsBereich.BelegDatumMaximum

.22.10.2024: Rev 4 PZ:
Quellfilteranapassung: Mit Einfuehrung der Storno Uebertragung muessen die Beleg vom Typ Storno herausgefiltert werden (BelegArt.KurzZeichen != 'ST'):
GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegArt.KurzZeichen != 'ST' && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= GeschaeftsBereich.BelegDatumMaximum

Quell Objekt

Beleg

Ziel Objekt

debi/document_2024.00

Synchronisation

Update oder Insert

Verwendeter Index

-

Vergabe Identifikation/Nummer

Mapping

Interne Synchronisationsfelder

Quellfilter

GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegArt.KurzZeichen != 'ST' && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= GeschaeftsBereich.BelegDatumMaximum

Zuordnungsdefinition

Belege

Synchronisationsrichtung

Feldzuordnungsart

Quellfeld

Zielfeld

Beschreibung/Notizen

Quelle -> Ziel

Formel

DebitorAdresse.Nummer

Document.CustomerNumber

Quelle -> Ziel

Formel

Nummer

Document.Number

Quelle -> Ziel

Formel

'CHF'

Document.Currency

Fixer Wert für CHF

Quelle -> Ziel

1:1

Belegart.CodeAbacus

Document.DocumentCode

Quelle -> Ziel

Formel

HinweisKunde

Document.Reference

Quelle -> Ziel

1:1

BelegDatum

Document.GeneralLedgerDate

Fibu-Datum wird analog Debi-Datum gesetzt

Quelle -> Ziel

1:1

TotalInklMwst

Document.Amount

Quelle -> Ziel

1:1

TotalInklMwst

Document.KeyAmount

Quelle -> Ziel

1:1

BelegDatum

Document.AccountReceivableDate

Dispo-Datum wird analog Debi-Datum gesetzt

Quelle -> Ziel

1:1

BelegDatum

Document.DispositionDate

Quelle -> Ziel

Formel

Geschaeftsbereich.AbacusGeschaeftsbereich

Document.Division

Quelle -> Ziel

1:1

Geschaeftsbereich.AbacusMahnbereich

Document.GroupNumber1

Optional: Pro PerformX-Geschäftsbereich die Freie Beleggruppennummer1 auf dem Beleg übertragen (Filterung OP-Listen etc.). Derselbe Wert wird im Mahnbereich verwendet.

Quelle -> Ziel

Formel

DebitorAdresse.ForderungsKonto.Nummer ?? Geschaeftsbereich.AbacusForderungskonto

Document.CollectiveAccount

Optionales Forderungskonto für eine Firma (z.B. für nahestehende Firmen). Wenn das Feld DebitorAdresse.ForderungsKonto.Nummer leer ist, dann wird das Sammelkonto gemäss Geschäftsbereich übertragen (Document.CollectiveAccount)

Quelle -> Ziel

Formel

0

Document.PaymentCentre

Quelle -> Ziel

1:1

Zahlungsweg.CodeAbacus

Document.PaymentOrderProcedure

Quelle -> Ziel

Formel

'QR'

Document.PaymentReferenceLineType

Fix 'QR'

Quelle -> Ziel

Formel

ReferenzNummer

Document.PaymentReferenceLine

Quelle -> Ziel

Formel

false

Document.TaxRecalculation

Quelle -> Ziel

1:1

Geschaeftsbereich.AbacusMahnverfahren

Document.ReminderProcedure

ABACUS führt das Mahnverfahren pro Beleg Debitor. Wenn Belege in PerformX entstehen, werden pro Beleg das im Geschäftsbereich hinterlegte Mahnverfahren und Mahnbereiche übergeben. Mahnverfahren ist 4 stelliger String und Mahnbereich Integer gemäss Einstellungen in ABACUS

Quelle -> Ziel

1:1

Geschaeftsbereich.AbacusMahnbereich

Document.ReminderArea

ABACUS führt den Mahnbereit pro Beleg Debitor. Wenn Belege in PerformX entstehen, werden pro Beleg das im Geschäftsbereich hinterlegte Mahnverfahren und Mahnbereiche übergeben. Mahnverfahren ist 4 stelliger String und Mahnbereich Integer gemäss Einstellungen in ABACUS

Quelle -> Ziel

Unterliste

BelegPositionen

Document.LineItem

Quelle -> Ziel

1:1

Zahlungskondition.CodeAbacus

Document.PaymentTerm.Number

Quelle -> Ziel

Formel

0

Document.PaymentTerm.Type

Quelle -> Ziel

Formel

'true'

Document.PaymentTerm.CopyFromTable

Ziel -> Quelle

1:1

Document.Number

AbacusNummer

Ziel -> Quelle

Formel

2

BelegStatusValue

Belegstatus auf 'verbucht' (Status 2)  setzen nach Erstübertagung Abacus Debi

BelegPositionen

Synchronisationsrichtung

Feldzuordnungsart

Quellfeld

Zielfeld

Beschreibung/Notizen

Quelle -> Ziel

1:1

SortOrderBeleg

Number

Quelle -> Ziel

1:1

PositionsTotalNettoInkl

Amount

Quelle -> Ziel

1:1

PositionsTotalNettoInkl

KeyAmount

Quelle -> Ziel

1:1

Konto.Nummer

CreditAccount

Quelle -> Ziel

1:1

Kostentraeger.Nummer

CreditCostCentre1

Quelle -> Ziel

1:1

Beleg.Geschaeftsbereich.AbacusKostenstelleBereich

CreditCostCentre2

Optional: Zweite Ebene ab Kostenstelle pro Geschäftsbereich

Quelle -> Ziel

1:1

Artikel.Mehrwertsteuer.CodeAbacus

TaxCode

Quelle -> Ziel

Formel

1

TaxMethod

Fix 1 fuer vereinbart

Quelle -> Ziel

Formel

2

TaxIncluded

Fix 2 für inklusive (gemaess Abacus via SST nur inklusive möglich)

Quelle -> Ziel

Formel

MwstBetrag *-1

TaxAmount

Abacus erwartet einen negativen Betrag

Quelle -> Ziel

Formel

MwstBetrag *-1

KeyTaxAmount

Abacus erwartet einen negativen Betrag

Quelle -> Ziel

1:1

Beleg.BelegDatum

TaxDateValidFrom

Quelle -> Ziel

Formel

Artikel + if (!?BelegPositionGruppe, (' - ' + BelegPositionGruppe), null)

Text

Update 31.7.2024 (PZ):
.statt bisher (Artikel + ' - ' + ZusatzBeschreibung) -> neu Artikel + if (!?BelegPositionGruppe, (' - ' + BelegPositionGruppe), null)
.zusaetzlich wurd hinzugefuegt, dass kein Bindestrich uebertragen wird, falls es keine Positionsgruppenzuordnung gibt

Quelle -> Ziel

Formel

Beleg.Geschaeftsbereich.AbacusGeschaeftsbereich

Division

Beschreibung Storno

...

Quelle

...

PerformX Belege/Stornos

...

Ziel

...

Abacus Belege/Interne Gutschrift

...

Notwendige Abacus-Schnittstelle

...

AbaConnect Debitorenbuchhaltung

...

Abacus Schnittstellenversion

...

debi/DocumentInternalCreditNoteAccountsReceivable_2023.00

...

Beschreibung Bedingung für den Übertrag

...

Belege in PerformX koennen storniert werden, solange noch keine Zahlung eingegangen ist. Falls ein Beleg innerhalb von PerformX storniert wird, erfolgt mit der Uebertragung des Stornobelegs eine Interne Gutschrift innerhalb von Abacus.

  1. Abacus Mandant im Geschaeftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung

  2. Das Feld "AbacusNummer” muss leer sein (bei Stornos bleibt dieses Feld leer, da in der Rueckschnittstelle keine Nummer zurueckgeschrieben wird.

  3. BelegStatusValue == 1 bedeutet "Fixiert". 0 ware "Entwurf" und 2 waere "Verbucht". Es werde nur die Definitiven Storno Belege uebtragen. Nach erfolgreicher Uebertragung wird dieser Status in dieser Zuordnungsdefinition auf "Verbucht" gesetzt.

  4. Es muss ein Stornobeleg sein: BelegArt.KurzZeichen == 'ST'

  5. BelegDatum wird wahlweise etwas eingeschraenkt. Dies spielt vorallem eine Rolle wenn die Abacus Anbindung zu einem anderen Zeitpunkt als PerformX stattfindet. Man kann damit entscheiden, dass nur Belege ab einem bestimmten Schnitttag in Frage kommen.

  6. Das BelegDatum ist fueher als das auf dem Geschaeftsbereich eingestellte ‘spaeteste Belegdatum’. Mit dieser Einstellung kann verhindert werden, dass Belege, die in fernerer Zukunft liegen, verfrueht in die Abacus Debi uebertragen werden.

Spezifikation Standard-Schnittstelle

Technische Basiskonfiguration

...

Beschreibung/Notizen

...

Übertrag
. Stornos in Abacus Debitorenbuchhaltung als Interne Verrechnungen

Quellfilterbeschrieb

. Abacus Mandant im Geschäftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung
. UND Das Feld "AbacusNummer muss leer sein (wenn dieses Feld leer ist, dann ist der Beleg noch nicht in Abacus Debi)
. UND BelegArt.KurzZeichen == 'ST' (es muss ein Stornobeleg sein)
. UND BelegStatusValue == 1 bedeutet "Fixiert". 0 bedeutet "Entwurf" und 2 bedeutet "Verbucht". Es werden nur die fixierten Belege übertragen. Nach erfolgreicher Übertragung wird dieser Status in dieser Zuordnungsdefinition auf "Verbucht" gesetzt
. UND BelegDatum wird wahlweise eingeschränkt. Dies spielt vor allem eine Rolle wenn die Abacus Anbindung zu einem anderen Zeitpunkt als PerformX stattfindet. Man kann damit entscheiden, dass nur Belege ab einem bestimmten Schnitttag in Frage kommen
. UND der Debitorenbeleg hat ein Datum kleiner/gleich voreingestelltes Maximaldatum des Geschaeftsbereiches

History
. 22.10.2024: Basisversion

...

Quell Objekt

...

Beleg

...

Ziel Objekt

...

debi/DocumentInternalCreditNoteAccountsReceivable_2023.00

...

Synchronisation

...

Insert

...

Verwendeter Index

...

-

...

Vergabe Identifikation/Nummer

...

Mapping

...

Interne Synchronisationsfelder

...

Quellfilter

...

GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegArt.KurzZeichen == 'ST' && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= GeschaeftsBereich.BelegDatumMaximum

Zuordnungsdefinition

Storno

...

Synchronisationsrichtung

...

Feldzuordnungsart

...

Quellfeld

...

Zielfeld

...

Beschreibung/Notizen

...

Quelle -> Ziel

...

1:1

...

Ursprungsbeleg.Nummer

...

DocumentInternalCreditNote.OriginalDocumentNumber

...

Quelle -> Ziel

...

Formel

...

BelegDatum

...

DocumentInternalCreditNote.Date

...

Ziel -> Quelle

...

Formel

...

2

...

BelegStatusValue

...

Belegstatus auf 'verbucht' (Status 2) setzen nach Erstübertagung Abacus Debi