Sage 100 Konnektor

Der Sage 100 Konnektor verbindet Syncler mit dem ERP-System Sage 100.
Er ermöglicht die bidirektionale Synchronisation von Stammdaten, Projekten und Belegen über den Sage Application Server.
Zur Nutzung des Konnektors müssen zusätzliche Module auf dem Sage Application Server installiert werden.

Das Setup kann über den Wizard im Frontend oder unter https://www.syncler.com/de/support/artikel.php?p=download heruntergeladen werden. Für neue Versionen wird auch ein neues Setup bereitgestellt.

Installation der Application Server Module

Nutzen Sie das bereitgestellte Setup, um auf dem Application Server die zusätzlichen Module zu installieren.
Während der Installation wird der Dienst des Application Servers neu gestartet, was kurzzeitig zu Einschränkungen für Sage 100 Benutzer führen kann.

Erforderliche Angaben während der Installation

• Adresse des Datenbankservers
• SQL-Login (Benutzername und Passwort) mit ausreichenden Rechten
• Name der Sage 100 Datenbank
• Version der Sage 100

Verfügbare Module

• Synchronisation Stammdaten – für alle Stammdaten, inklusive Artikeldaten
• Belegübertragung – für Belegübertragungen und Aktualisierungen (inkl. Grundlagendaten)
• Synchronisation Projekte – für projektbezogene Daten

Die Zugriffe unterliegen der Sage 100 Berechtigungssteuerung.
Mit der Option „Berechtigungen für diesen Benutzer anlegen“ werden alle Berechtigungen automatisch für den angegebenen SQL-Benutzer aktiviert. Diese können manuell mit dem Sage 100 Administrator angepasst werden.

Bei der Installation wird außerdem die SQL Änderungsnachverfolgung auf den Tabellen und der Datenbank aktiviert und die Vorhaltezeit des Änderungsprotokolls auf 7 Tage gesetzt.
Nach einem Versions-Upgrade von Sage 100 kann eine Neuinstallation der Module erforderlich sein.

Einstellungen des Konnektors

Datenbank

Diese Angaben sind für Datenabfragen erforderlich:

• Datenbankserver
• Datenbankname
• Option: Integrierte Sicherheit verwenden

Kontokorrent Untergruppe für Adressen

Das Schemaobjekt Adressen bildet die Basis für Firmenstammdaten, während Kontokorrent spezifische Kunden- oder Lieferantendaten enthält.
Zur einfacheren Nutzung werden Adressdaten mit einem Kontokorrent-Datensatz angereichert.

• SQL Where Clause: Filterung bestimmter Datensätze (z. B. Aktiv eq '-1')
• SQL Sortierung: definiert den ersten Datensatz bei mehreren Treffern

SQL- und Datei-Brücke

Optional kann die Syncler API für SQL- und Dateizugriffe genutzt werden, falls Syncler die Datenbank nicht direkt erreichen kann.

Weitere Informationen: Die SQL- und Datei-Brücke

Sage 100

Definiert die Zugangsdaten und Mandanteninformationen.

Optionale Dienste

Je nach installierten Modulen sind folgende Endpunkte zu hinterlegen:

• Beleg-Service: https://sage100-server:5493/sdata/ol/SISOLSageCRMBelegServices
• Projekt-Service: https://sage100-server:5493/sdata/ol/SISOLSageCRMProjektResources

Experteneinstellungen

• Application Server Timeout: Anpassung bei langen Abfragen
• Zuordnung von Belegarten an Adressen deaktivieren: Deaktiviert die automatische Anreicherung zur Performance-Steigerung
• Kontoart als Preset verwenden: Steuert die Vorgabe bei leeren Kontonummern
• Maximale Anzahl von Zahlungskonditionen: Begrenzung bei Belegübertragungen
• Mindestversion des Schemaobjekts nicht verwenden: Deaktiviert die standardmäßige Versionsersetzung. Es wird die Version des Syncs verwendet.

Schemaobjekte

Die durch die Module bereitgestellten Schemaobjekte umfassen Stammdaten, Beleginformationen und Projektdaten.
Angereicherte Objekte werden in der Änderungsabfrage nicht berücksichtigt. Hier müssen spezielle Sync-Typen oder zusätzliche Sync eingerichtet werden.

Stammdaten

• artikelbezeichnung
• preislistenartikel: angereichert um preislisten
• preislisten
• artikelstueckliste
• artikelgruppen
• artikelvarianten
• artikel: angereichert um artikelbezeichnung
• ktoabweichendelieferanschriften: angereichert um adressen
• adressenverweise
• adressen: angereichert um kontokorrent, adressenbelegartenkommunikation
• ansprechpartner
• kontokorrent
• bankverbindungend
• bankverbindungenl
• bankverbindungena
• bankverbindungench
• adressenbelegartenemailzuordnung
• grundlagenstaticapadrbelegartenzuordnungtyp
• ansprechpartnerzuordnung
• adressenbelegartenkommunikation
• grundlagensteuercode

Belegübertragung

• createbasisbelegservicerequest
• createbelegposition
• createvkbelegpositionuserfield
• createekbelegpositionuserfield
• createvkbeleguserfield
• createekbeleguserfield
• createbasisbelegserviceresponse
• createbasisvkbeleg: für die Anlage und Aktualisierung von VK-Belegen, geschachteltes Schema mit Positionsliste und benutzerdefinierten Feldern
• createbasisekbeleg: für die Anlage und Aktualisierung von EK-Belegen, geschachteltes Schema mit Positionsliste und benutzerdefinierten Feldern
• vkbelegzahlungskondition
• belegsprache
• beleglieferbedingungen
• belegsteuercode
• belegsteuereuland
• belegversandarten
• artikelpositonstypen
• zahlungskonditionen
• initialbelegartenvk
• initialbelegartenek
• vkbelege: Lesen von Belegen inkl. Änderungserkennung, geschachteltes Schema mit Positionsliste und benutzerdefinierten Feldern
• vkbelegepositionen
• vkvorgaenge
• vkvorgaengepositionen

Projekte

• kostentraeger
• kostenstellen
• kostenstellentraeger
• projekte
• grundlagenstaticprojektschritteberechnungsart
• grundlagenmitarbeitergruppe
• grundlagenmeilensteine
• grundlagenprojektstatus
• grundlagenprojektschritte
• grundlagenprojektgruppe
• grundlagenprojektverantwortlicher
• grundlagennakastatus
• grundlagenstaticprojektschrittestatus
• projektezeiterfassung
• projekteschritte
• projektemitarbeiter
• mitarbeiter

Zusätzliche Schemaobjekte

• FileUpload: Speicherung von Dateien
• KHKSammelmappen: SQL-basierter Zugriff auf Sammelmappen

Preisfindung

Der Konnektor unterstützt die Preisfindung über die Syncler API (GetPricing).
Erforderlich ist eine konfigurierte SQL-Verbindung.

Beispiel-Aufruf

{ "ProductCode": "No", "Quantity": 10, "PricingList": "Name", "ClientNumber": 1, "Account": "Account no" }

Beispiel-Ergebnis

{ "Price": 0.00, "ScaleQuantity": 0.00, "DiscountQuantity": 0.00, "Discount": 0.00, "Message": "" }

Schreiben von Kontokorrenten

Kontokorrente können über das Schemaobjekt „kontokorrent“ oder indirekt über „adressen“ angelegt werden.
Bei Adressen muss dafür ein Quellfeld der Untergruppe "kontokorrent" zugeordnet werden.
Dabei empfiehlt sich die Verwendung von Vorlagen, die den Nummernkreis für neue Kunden- oder Lieferantennummern vorgeben und Standardwerte setzen.
Für die Verwendung von Vorlagen stehen spezielle Synctypen zur Verfügung, wo diese festgelegt werden können.
Die Vorlagen werden für die Anlage eines Kontokorrentes vorbereitet. Aus der Vorlage wird z.B. der Nummernkreis für die neu erzeugte Kunden-/Lieferantennummer entnommen. Dabei wird das erste Zeichen oder die ersten zwei Zeichen beim Einsatz von Presets übernommen. Dies kann im Sync durch die Zuweisung eines individuellen Nummernkreises auf das Feld "Kto" übersteuert werden. Da Vorlagen häufig einen eigenen Nummernkreis nutzen sollte immer über den Sync der gewünschte Nummernkreis festgelegt werden.

Ein erschöpfter Nummernkreis führt zu einer Fehlermeldung.

Weitere Informationen: FAQ Sage 100

Übertragung von Belegen

Das Schemaobjekt für Belege dient der Schreibfunktion.
Nach erfolgreicher Übertragung wird die Beleg-ID im Feld Handle zurückgegeben. Dieses Feld gehört nicht zum Schema, kann aber in Erfolgbedingungen und dem Zurückschreiben genutzt werden.

Zubehörartikel

• Automatische Zubehörartikel werden beim Schreiben hinzugefügt.
• Optionale Zubehörartikel müssen über ForceOptionalZubehoerartikel manuell ergänzt werden.

Angebotsstatus

Die Property VkAngebotsstatus (int) unterstützt folgende Werte:

• 0 = None
• 1 = Neuanlage
• 3 = Abgelehnt
• 4 = Angenommen
• 5 = Erfüllt

Wird keinen Wert für VkAngebotsstatus gesendet, wird automatisch 1 gesetzt.

Preisfindung im Beleg

Bei abweichenden Preisen oder Rabatten muss an der Position das Flag
IstEinzelpreisManuell oder IstRabattManuell gesetzt werden.

Abweichende Liefer-/Rechnungsanschrift

Es können individuelle Adressen pro Beleg angegeben werden.
Fehlende Felder führen zur Nutzung der Standardadresse.

Beleg aktualisieren

Belege können über die ID im Feld EditBelegHandle aktualisiert werden.
Dabei werden die Positionen vollständig neu angelegt.

Positionstypen