Seminar Sage Intacct – REST-API und Datenintegration

Seminarbeschreibung

Für eine Finanzintegration müssen technische Objekte und fachliche Bedeutung zusammenpassen. Das Seminar übersetzt einen abgegrenzten Geschäftsfall in eine API-Anbindung und berücksichtigt dabei Konten, Dimensionen und Unternehmensbezüge. Die vorhandenen Rechte und unterstützten REST-Objekte bestimmen den konkreten Übungsumfang.

Die REST-API bildet den Schwerpunkt. Bestehende XML-Webservices werden zur Einordnung von Altintegrationen behandelt, ohne identische Authentifizierung oder vollständige Funktionsgleichheit zu unterstellen. Praktische Tests prüfen nicht nur erfolgreiche Aufrufe, sondern auch fehlende Rechte, ungültige Referenzen, Mehrfachausführung und unvollständige Übertragungen.

Seminarziele

• Eine vorbereitete Anwendung sicher mit einem Testunternehmen verbinden.
• Unterstützte REST-Objekte mit fachlich korrekten Beziehungen verarbeiten.
• Eine Integration mit Fehlerbehandlung und überprüfbarer Abstimmung entwickeln.

Zielgruppe

Integrationsentwickler, technische Consultants und IT-Verantwortliche für Finance-Schnittstellen.

Voraussetzungen

Kenntnisse von HTTP, JSON, OAuth und einer Programmiersprache; Verständnis von Buchungsdaten und Dimensionsbezügen.

Seminarinhalte

1. API-Landschaft und Freigaben
2. Authentifizierung
3. Abfragen und Datenbeziehungen
4. Schreibende Verarbeitung
5. Fehler und Wiederanlauf
6. Abnahme und Betrieb

1. API-Landschaft und Freigaben

• REST-API und bestehende XML-Webservices nach Zweck und Zugang unterscheiden.
• Verfügbare Objekte, Abonnements und Anwendungsfreigaben prüfen.
• Unternehmen, Rollen und fachlichen Zielprozess für die Übung festlegen.

2. Authentifizierung

• OAuth-Zugriff mit der vorab registrierten Anwendung erproben.
• Geheimnisse und Tokens außerhalb des Quelltexts verwalten.
• Unternehmenskontext und Zugriffsgrenzen mit gezielten Tests kontrollieren.

3. Abfragen und Datenbeziehungen

• Benötigte Objekte und Felder gezielt abfragen.
• Pagination und Filter gemäß bereitgestellter API-Version verwenden.
• Konten, Dimensionen und externe Schlüssel in einem Mapping dokumentieren.

4. Schreibende Verarbeitung

• Eine vereinbarte, unterstützte Schreiboperation im Testsystem umsetzen.
• Pflichtangaben und Referenzen vor der Übertragung validieren.
• Technische Antworten und fachliche Ablehnungen getrennt protokollieren.

5. Fehler und Wiederanlauf

• Temporäre Fehler und dauerhafte Datenfehler unterscheiden.
• Wiederholung und Dublettenvermeidung über geeignete Kontrolllogik umsetzen.
• Teilabbrüche und fehlende Berechtigungen gezielt simulieren.

6. Abnahme und Betrieb

• Zählwerte und fachliche Summen zwischen Quelle und Ziel abstimmen.
• Überwachung und sichere Betriebsparameter für die Anbindung festlegen.
• Einen erneuten Lauf mit dokumentierten Abnahmekriterien durchführen.

Praxisübungen

Die Bearbeitung erfolgt anhand vorbereiteter Beispieldaten. Die einzelnen Arbeitsschritte werden durchgeführt, kontrolliert und gemeinsam besprochen.

1. Die vorbereitete Anwendung mit dem Testunternehmen verbinden.
2. Einen begrenzten Datenbestand einschließlich Dimensionsbezügen lesen.
3. Eine fachlich validierte Schreiboperation im Testsystem ausführen.
4. Einen Teilabbruch simulieren und die kontrollierte Fortsetzung prüfen.
5. Objektanzahl und fachliche Werte mit den Quelldaten abstimmen.

Schulungsumgebung

Die Schulungsumgebung wird vom Kunden bereitgestellt. Erforderlich sind gültige Nutzungsrechte, die genannten Module und individuelle Zugänge für die praktischen Übungen.

Sage-Intacct-Testunternehmen mit aktivierter REST-API, vorab registrierter Anwendung, passenden Rechten und bereitgestellten Testdaten; geeignete Entwicklungswerkzeuge und unterstützter Integrationsfall.

Versionsstand, verfügbare Funktionen und Übungszugänge werden vor der Durchführung abgestimmt. Die Praxis erfolgt in einer von produktiven Daten und Abläufen getrennten Umgebung.