Ü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
...
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
...
Storno
...
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
...
Document.Currency
Fixer Wert für CHF
Quelle |
1:1
...
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
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
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äftsbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung |
Geschaeftsbereichs 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 |
Versionierung
Bezeichnung | Notes |
22.10.2024: Basisversion | GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegArt.KurzZeichen == 'ST' && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= GeschaeftsBereich.BelegDatumMaximum |