Seitenvergleich

Ü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	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 Abea) 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. 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
Quelle -> Ziel	01:01	Geschaeftsbereich.AbacusGeschaeft sbereich	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
Ziel -> Quelle	01:01	SalesOrderHeader.SalesOrderHeader Fields.OrderNumber	AbacusNummer	AbacusNummer zurueckgeschrieben.
Ziel -> Quelle	Formel	0	ZahlungsStatusValue	Rueckschreiben des OP Status nach erstmaligem Uebertrag.
Ziel -> Quelle	Formel	0	ZahlungsStatusValue	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.

Versionierung

Bezeichnung	Notes
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)
21.08.2024: Basisversion	GeschaeftsBereich.AbacusMandant == Parameters("Mandantennummer") && ?AbacusNummer && BelegStatusValue == 1 && BelegDatum >= CreateDate(2024, 01, 01)

Versionen im Vergleich

Alte Version 4

Neue Version Aktuell

Schlüssel

Beschreibung

Spezifikation Standard-Schnittstelle

Technische Basiskonfiguration

Zuordnungsdefinition

Versionierung