Versionen im Vergleich

Version Alte Version 8 Neue Version Aktuell
Änderungen wurden vorgenommen von

Philip Zanon

Kevin Haussener

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

  • Ü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

  • 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

Standard-Bedingung für den Übertrag

Abacus Mandant im Geschaeftbereich muss gleich sein wie der Wert

  • Es werden nur Belege übertragen, wo der auf dem Geschäftsbereich hinterlegte “Abacus Mandant” der "Mandantennummer"

in den Parameters der Verbindungseinstellung

  • der Connector-Ausführung entspricht

  • Das Feld "

AbacusNummer

  • AbacusNummer” muss leer sein (das ist meistens dieselbe Nummer wie die

BelegNummer

  • Beleg-Nummer, diese wird jedoch automatisch beim ersten erfolgreichen Beleg-

Uebertrag

  • Übertrag durch die Schnittstelle

abgefuellt

  • abgefüllt. 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

  • Nur Belge im Status “Fixiert” [1]. Nach erfolgreicher

Uebertragung

  • Übertragung wird dieser Status in dieser Zuordnungsdefinition auf "Verbucht" gesetzt

.

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

    • Kein Übertrag von Storno-Belegen

    • Debitorenbeleg mit einem Belegdatum ab 1.1.2024 → wird kundenspezifisch konfiguriert

    • Das Belegdatum ist kleiner/gleich als das auf dem Geschäftsbereich eingestellte höchste zulässige Belegdatum

    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

    Basis Mapping

    Beleg

    Quell Objekt

    Beleg

    Ziel Objekt

    debi/document_2024.00

    Synchronisation

    Update oder Insert

    Verwendeter Index

    -

    Vergabe Identifikation/Nummer

    Nummer des Belegs aus PerformX

    Mapping

    Interne Synchronisationsfelder

    Technischer Quellfilter

    GeschaeftsBereich

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

    GeschaeftsBereich

    Geschäftsbereich.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

    Geschäftsbereich.

    AbacusGeschaeftsbereich

    AbacusGeschäftsbereich

    Document.Division

    Quelle -> Ziel

    1:1

    Geschaeftsbereich

    Geschäftsbereich.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

    Geschäftsbereich.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

    Geschäftsbereich.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

    Geschäftsbereich.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

    Kostenträger.Nummer

    CreditCostCentre1

    Quelle -> Ziel

    1:1

    Beleg.

    Geschaeftsbereich

    Geschäftsbereich.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

    für die “vereinbarte Variante”

    Quelle -> Ziel

    Formel

    2

    TaxIncluded

    Fix 2 für

    inklusive (gemaess Abacus via SST nur inklusive möglich

    “inklusive MWST” (fixe Vorgabe von Abacus-Schnittstelle)

    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

    Quelle -> Ziel

    Formel

    Beleg.Geschäftsbereich.AbacusGeschäftsbereich

    Division

    Versionierung

    Bezeichnung

    Notes

    22.10.2024: Rev 4 PZ

    Quellfilteranapassung: Mit Einführung der Storno Übertragung müssen die Beleg vom Typ Storno herausgefiltert werden (BelegArt.KurzZeichen != 'ST'):
    Geschäftsbereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegArt.KurzZeichen != 'ST' && BelegDatum >= CreateDate(2024, 01, 01) && BelegDatum <= Geschäftsbereich.BelegDatumMaximum

    05.09.2024: Rev3 PZ

    Quellfilteranpassung: Zusatzliche Einschränkung: Es dürfenfen nur Adressen übertragen werden, die Belege haben mit Belegdatum < als das auf dem Geschäftsbereich voreingestellte späteste Belegdatum haben

    (Status == true) && (Debitorbelege.Geschäftsbereich.AbacusMandant == Parameters("MandantenNummer") && Debitorbelege.BelegDatum >= CreateDate(2024, 01, 01)) && Debitorbelege.BelegDatum <= Debitorbelege.Geschäftsbereich.BelegDatumMaximum && Debitorbelege.BelegStatusValue != 0 && (?ConnectorMapping.ErfolgreicheSynchronisation || VerändertAm > ConnectorMapping.ErfolgreicheSynchronisation)<

    31.07.2024: Rev 2 PZ

    Der Übertrag der Bemerkung wurde im Standard deaktiviert
    Quellfilter: (Status == true) && (Debitorbelege.Geschäftsbereich.AbacusMandant == Parameters("MandantenNummer") && Debitorbelege.BelegDatum >= CreateDate(2024, 01, 01)) && Debitorbelege.BelegStatusValue != 0 && (?ConnectorMapping.ErfolgreicheSynchronisation || VerändertAm > ConnectorMapping.ErfolgreicheSynchronisation)

    16.07.2024: Rev 1 PZ

    (neu werden Adressen zu Belegen ausgefiltert, die den Status Entwurf haben)
    (Status == true) && (Debitorbelege.Geschäftsbereich.AbacusMandant == Parameters("MandantenNummer") && Debitorbelege.BelegDatum >= CreateDate(2024, 01, 01)) && Debitorbelege.BelegStatusValue != 0 && (?ConnectorMapping.ErfolgreicheSynchronisation || VerändertAm > ConnectorMapping.ErfolgreicheSynchronisation)

    11.07.2024: Basisversion

    (Status == true) && (Debitorbelege.Geschäftsbereich.AbacusMandant == Parameters("MandantenNummer") && Debitorbelege.BelegDatum >= CreateDate(2024, 01, 01)) && (?ConnectorMapping.ErfolgreicheSynchronisation || VerändertAm > ConnectorMapping.ErfolgreicheSynchronisation)