Übertrag der Belege und Stornos von PerformX in Abacus Debitorenbuchhaltung
Grundlage für den Übertrag von Kundenbelegen und Stornos an Abacus
Es werden keine Rechnungsbelege (PDF) übertragen
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
...
Abacus Mandant im Geschaeftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung
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)
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.
BelegArt.KurzZeichen != 'ST' bedeutet, dass Stornobelege ausgefiltert werden.
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.
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
...
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
...
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.
|
Spezifikation Standard-Schnittstelle
Technische Basiskonfiguration
Beschreibung/Notizen | Übertrag Quellfilterbeschrieb . Abacus Mandant im Geschäftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung History |
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 |
...