• In Bearbeitung

    • Abacus Abea Belege/Gutschriften

    Owned by Philip Zanon
    Last updated: Sept. 09, 2024
    3 min read

    • Übertrag der Belege und Gutschriften von PerformX in Abacus Abea Auftragsbearbeitung

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

    • Es werden keine Rechnungsbelege (PDF) übertragen

    • Details zur Schnittstelle von Abacus

    Beschreibung

    Quelle

    PerformX Belege/Belegarten

    Ziel

    Abacus Auftraege/Auftragspositionen

    Notwendige Abacus-Schnittstelle

    AbaConnect Auftragsbearbeitung

    Abacus Schnittstellenversion

    orde/ordesalesorder_2023.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 Abea)

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

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

    Spezifikation Standard-Schnittstelle

    Technische Basiskonfiguration

    Beschreibung/Notizen

    Übertrag
    . Rechnungen und Gutschriften in Abacus ABEA

    Quellfilterbeschrieb
    . Abacus Mandant im Geschäftbereich muss gleich sein wie der Wert "Mandantennummer" in den Parameters der Verbindungseinstellung
    . Das Feld "AbacusNummer muss leer sein (wenn dieses Feld leer ist, dann ist der Beleg noch nicht in Abacus Abea)
    . 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
    . 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

    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
    . In ABEA muessen alle Artikel mit den Artikeln in PerfomX uebereinstimmen. Die ABEA Produktenummer ist in PerformX im Feld Kurzzeichen zu fuehren.
    . In ABEA muss der Auftragsnummernkreis eingestellt sein. Die Auftragnummer wird von der ABEA gefuhert und in der Rueck SST ins Feld AbacusNummer zurueckgeschrieben. (ABEA Einstellungen Verkauf->Nummernkreise/Belege->Verkauf Prog 621)

    History
    . 21.08.2024: Basisversion
    GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegDatum >= CreateDate(2024, 01, 01)

    . 09.09.2024: Rev 1 PZ
    . Quellfilter unveraendert
    . Zahlungsweg.CodeAbacus anstelle 'SalesOrderHeader.SalesOrderHeaderFields.PaymentCode' neu 'SalesOrderHeader.SalesOrderHeaderFields.PaymentSlipInternalNumber'
    . Die Auftragsnummer wird immer durch die Abea vergeben, weil es in Abea keine separaten Nummernkreise gibt. Entsprechende Einstellung im Prog 621 noetig (siehe allg. Funkt. oben)
    . Dementsprechend wurde die Zuordnung: Nummer -> SalesOrderHeader.SalesOrderHeaderFields.OrderNumber deaktiviert
    . Die Auftragnummer wird ins PerformX zurueckgeschrieben: (Ziel) SalesOrderHeader.SalesOrderHeaderFields.OrderNumber -> (Quelle) AbacusNummer (wie bisher)

    Basis Mapping

    Beleg

    Synchronisation

    Update oder Insert

    Verwendeter Index

    -

    Vergabe Identifikation/Nummer

     

    Mapping

    Interne Synchronisationsfelder

    Quellfilter

    GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegDatum >= CreateDate(2024, 01, 01)

    Zuordnungsdefinition

    Belege

    Synchronisationsrichtung

    Feldzuordnungsart

    Quellfeld

    Zielfeld

    Beschreibung/Notizen

    Quelle -> Ziel

    01:01

    DebitorAdresse.Nummer

    SalesOrderHeader.SalesOrderHeader Fields.CustomerNumber

     

    Quelle -> Ziel

    Formel

    0

    SalesOrderHeader.SalesOrderHeader Fields.OrderBacklogNumber

     

    Quelle -> Ziel

    Formel

    'CHF'

    SalesOrderHeader.SalesOrderHeader Fields.Currency

    Fixer Wert für CHF

    Quelle -> Ziel

    Formel

    Belegart.CodeAbacus

    SalesOrderHeader.SalesOrderHeader Fields.OrderCode

    Wenn eine Kunde ABEA verwendet, dann muss der korrekte Abacus Code aud der Beleg-Art hinterlegt werden. Standardd  ist 'N' fuer Rechnung und 'G' fuer Gutschrift.

    Abacus Definitonen:

    Auftrag-Art (XML Name ist

    OrderCode)

    Mögliche Werte im Abacus Standard waeren:

    N   Auftrag (normal)

    R   Auftrag (Rückstand)

    G   Gutschrift

    K     Kassenauftrag

    L     Projektauftrag/Projektofferte

    O     Offerte

    P     Projektgutschrift

    S   Standard-Auftrag

    Q   Standard-Offerte

    V   Preview

    Projektauftrag/Shopauftrag

    T   Teilauftrag

    A   Abonnement

    Quelle -> Ziel

    01:01

    BelegDatum

    SalesOrderHeader.SalesOrderHeader Fields.PriceFindingDate

    Datum fuer die Preis- und Rabattfindung

    Quelle -> Ziel

    01:01

    BelegDatum

    SalesOrderHeader.SalesOrderHeader Fields.PurchaseOrderDate

    Abacus Bestell-Datum

    Quelle -> Ziel

    01:01

    BelegDatum

    SalesOrderHeader.SalesOrderHeader Fields.OrderDate

    Abacus Auftragsdatum

    Quelle -> Ziel

    01:01

    BelegDatum

    SalesOrderHeader.SalesOrderHeader Fields.DeliveryDate

    Abacus Auftrag Lieferdatum

    Quelle -> Ziel

    01:01

    TotalInklMwst

    SalesOrderHeader.SalesOrderHeader Fields.InvoiceTotalInvoiced

    WIrd in Abacus Auftrag anhand der ueberstragen Positionen berechnet. Der Uebertrag dieses Betrages aus PerformX kann evl weggelassen werden.

    Quelle -> Ziel

    01:01

    Geschaeftsbereich.AbacusGeschaeft sbereich

    SalesOrderHeader.SalesOrderHeader

    Im Abacus Mandant muessen

    Fields.Division

    Geschaeftbereiche defineirt sein und zudem fuer den Gebrauch in ABEA aktiviert werden.

    Quelle -> Ziel

    01:01

    Zahlungsweg.CodeAbacus

    SalesOrderHeader.SalesOrderHeaderFields.PaymentSlipInternalNumber

    9.9.2024
    Zielfeld: statt SalesOrderHeader.SalesOrderHeaderFields.PaymentCode
    , neu SalesOrderHeader.SalesOrderHeaderFields.PaymentSlipInternalNumber

    Quelle -> Ziel

    01:01

    Geschaeftsbereich.AbacusMahnverfa hren

    SalesOrderHeader.SalesOrderHeader Fields.ReminderProcedure

    Kann evtl. auch weggelassen werden bei ABEA. 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

    01:01

    Geschaeftsbereich.AbacusMahnberei ch

    SalesOrderHeader.SalesOrderHeader Fields.ReminderArea

    Kann evtl. auch weggelassen werden bei ABEA. 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

    01:01

    Zahlungskondition.CodeAbacus

    SalesOrderHeader.SalesOrderHeader Fields.PaymentCode

    Zahlungsziele muessen in PerformX und Abacus in Uebereinstimmung erfasst sein.

    Quelle -> Ziel

    Unterliste

    BelegPositionen

    SalesOrderHeader.Item

     

    Ziel -> Quelle

    01:01

    SalesOrderHeader.SalesOrderHeader Fields.OrderNumber

    AbacusNummer

    Bei erfolgreicher Uebertragung wird die Auftragsnummer ins Feld

    AbacusNummer zurueckgeschrieben.

    Ziel -> Quelle

    Formel

    0

    ZahlungsStatusValue

    Rueckschreiben des OP Status nach erstmaligem Uebertrag.

    Status Offen = 0 ist der Default Wert.

    Ziel -> Quelle

    Formel

    2

    BelegStatusValue

    Belegstatus auf 'verbucht' (Status 2) 

    setzen nach Erstübertagung Abacus

    ABEA

     

    BelegPositionen

    Synchronisationsrichtung

    Feldzuordnungsart

    Quellfeld

    Zielfeld

    Beschreibung/Notizen

    Quelle -> Ziel

    01:01

    Menge

    ItemFields.QuantityOrdered

     

    Quelle -> Ziel

    01:01

    Konto.Nummer

    ItemFields.AccountIncome

     

    Quelle -> Ziel

    01:01

    Menge

    ItemFields.QuantityInvoiced

     

    Quelle -> Ziel

    01:01

    Kostentraeger.Nummer

    ItemFields.CostCentre1Income

     

    Quelle -> Ziel

    Formel

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

    ItemText.ItemTextFields.Text

    Dies ist eine redundante uebertragung. Wenn PerformX Artikel und Abacus Produkte korrekr erstellt sind, wird dieser Text in

    Quelle -> Ziel

    01:01

    Beleg.Geschaeftsbereich.AbacusKost enstelleBereich

    ItemFields.CostCentre2Income

     

    Quelle -> Ziel

    01:01

    SortOrderBeleg

    ItemFields.ItemNumber

     

    Quelle -> Ziel

    01:01

    Artikel.KurzZeichen

    ItemFields.ProductNumber

    Die Produktnummer aus Abacus muss im PerfromX Feld KurzZeichen gespeichert werden. Somit wird bei der Uebergabe des Belegpositionsartikels der entsprechende Artikel aus Abacus eingesetzt. Bedingung ist, dass alle Artikel in PerformX entsprechend der Produkte in Abacus manuell gefuehrt werden.