Ein NetSuite-Connector ist selten das Ziel, sondern das Mittel: Aufträge aus dem Shop sollen ohne Handarbeit im ERP landen, Kontoauszüge sollen sich selbst zuordnen, der Steuerberater soll seine Buchungen pünktlich erhalten. Wer eine Integration mit NetSuite plant, entscheidet damit zugleich über Pflegeaufwand, Fehleranfälligkeit und Abhängigkeiten der nächsten Jahre. Dieser Beitrag ordnet ein, welche Wege es gibt, und zeigt, wie Sie einen Datenfluss so zuschneiden, dass er im deutschen Mittelstand auch prüfungsfest bleibt.
Die Grundlage: die NetSuite-API im Überblick
Unter dem Namen SuiteTalk stellt NetSuite seine Webservices bereit. Für die API von NetSuite gilt heute eine klare Richtung: REST ist der Weg für neue Vorhaben, SOAP läuft aus.
REST-Webservices: der Standardweg
Die REST-Webservices von SuiteTalk bieten laut Oracle-Dokumentation folgende Möglichkeiten:
- Anlegen, Lesen, Ändern und Löschen von Datensätzen (CRUD)
- Zugriff auf Metadaten, damit eine Anwendung die Struktur der Datensätze kennt
- Filtern von Datensatzsammlungen
- Aktionen und Transformationen auf Datensätzen, etwa das Umwandeln eines Datensatzes in einen folgenden Beleg
- asynchrone Verarbeitung
- Ausführen von Datensätzen aus SuiteAnalytics-Arbeitsmappen und von SuiteQL-Abfragen
Wichtig für die Projektplanung: Dafür muss kein eigenes Skript im System bereitgestellt werden, anders als bei den sogenannten RESTlets. Das senkt den Entwicklungsaufwand für Standardfälle. Für Sonderlogik, die im System selbst laufen soll, bleiben RESTlets und Individualentwicklung weiterhin ein Thema, mehr dazu auf der Seite zur Individualentwicklung in NetSuite.
SOAP: auslaufend
Die SOAP-Webservices nutzen ein dokumentenorientiertes XML-Muster mit HTTPS als einzigem Transport, Zugriff über Rollen (darunter eine Rolle „Web Services Only“) sowie synchrone und asynchrone Aufrufe. Entscheidend ist aber der Zeitplan: Das WSDL 2025.2 ist der letzte vorgesehene SOAP-Zugangspunkt, ab Version 2027.1 wird nur noch dieser unterstützt, und nach Version 2028.2 steht SOAP nicht mehr zur Verfügung. Oracle empfiehlt für jede neue Integration REST mit OAuth 2.0.
Was heißt das für Sie in der Praxis?
- Bestehende Anbindungen, die auf SOAP laufen (etwa ältere Eigenentwicklungen oder Altlasten aus früheren Projekten), brauchen einen Migrationsplan.
- Bei jedem Angebot für eine neue Schnittstelle sollten Sie nachfragen, auf welcher API sie aufbaut.
- Bei Fremdanwendungen und Erweiterungen fragen Sie den Hersteller, wie er mit dem Auslaufen umgeht.
Fertige Connectoren und die Erweiterungs-Plattform
Neben der API gibt es einen zweiten Weg: vorgefertigte Erweiterungen. NetSuite bündelt seine Entwicklungsumgebung unter dem Namen SuiteCloud, Erweiterungen von Dritten werden als SuiteApps verbreitet. Hinzu kommen Integrationsplattformen (iPaaS), die Connectoren zwischen vielen Anwendungen bereitstellen und die Abläufe grafisch konfigurieren.
Ein fertiger Baustein bringt Tempo, aber keine Garantie. Prüfen Sie vor der Entscheidung:
- Deckt der Connector Ihren tatsächlichen Prozess ab, oder nur den Normalfall der Demo?
- Welche Richtung hat der Datenfluss, und wer ist bei Konflikten führend?
- Wer pflegt den Baustein bei Updates von NetSuite und von der Gegenseite?
- Wie läuft der Support, und an wen wenden Sie sich bei einem Fehler: an den Anbieter, die Plattform oder den Integrator?
- Welche Lizenzkosten fallen laufend an? Das Angebot im Marktplatz wechselt, daher lohnt eine aktuelle Prüfung. Zur Kostenlogik insgesamt: Preise und Kostentreiber.
Welche Anwendungen typischerweise angebunden werden
Die folgende Übersicht zeigt, welche Kategorien im deutschen Mittelstand am häufigsten vorkommen und worauf es jeweils ankommt.
| Bereich | Typischer Datenfluss | Worauf es in Deutschland ankommt |
|---|---|---|
| Online-Shop und Marktplätze | Bestellungen, Bestände, Preise, Versandstatus | Steuersätze und Lieferländer, Retouren, Zahlungszuordnung |
| Bank und Zahlungsverkehr | Kontoauszüge, Zahlungsläufe, offene Posten | SEPA-Formate, automatische Zuordnung, Freigaberechte |
| Zahlungsdienstleister | Zahlungseingänge, Gebühren, Rückbuchungen | Abstimmung von Bruttobeträgen und Gebühren |
| Steuerberater und DATEV | Buchungsstapel, Belege, Stammdaten | Kontenrahmen, Steuerschlüssel, Abgabetermine der Kanzlei |
| Elektronische Rechnung | Ausgang und Eingang von Rechnungen | XRechnung, ZUGFeRD, Archivierung |
| EDI mit Handel und Lieferanten | Bestellungen, Lieferavis, Rechnungen | Nachrichtenformate der Partner, Prüfung der Stammdaten |
| Bürowerkzeuge | Export nach Excel, Mailversand, Kalender | Zugriffsrechte, Datenschutz |
| BI und Reporting | Kennzahlen, Auswertungen | Aktualität, Datenmodell, Rollen |
| Digitale Signatur | Verträge, Freigaben | Nachweis und Ablage |
| Logistik und Versand | Aufträge, Etiketten, Sendungsstatus | Versanddienstleister, Zollunterlagen |
E-Commerce: mehr als ein Auftragsimport
Wer im Webshop verkauft, erwartet mehr als einen reinen Bestellimport. Bestände müssen in Echtzeit zurückgemeldet werden, Preise und Artikelstammdaten laufen in die Gegenrichtung, Retouren und Gutschriften müssen sauber im ERP erscheinen. Ob ein Connector oder eine Plattform sinnvoll ist, hängt von der Zahl der Kanäle und von der Komplexität Ihrer Preislogik ab. Eine vertiefte Betrachtung für diese Branche finden Sie unter ERP für E-Commerce.
Bank und Zahlungsverkehr
Hier zählt die Automatik: Kontoauszüge laufen ein, werden offenen Posten zugeordnet, Zahlungsvorschläge werden erzeugt und freigegeben. Die Fachlogik gehört in die Finanzbuchhaltung, die Anbindung nur zum Transport. Wie sich das im System darstellt, beschreibt die Seite zur Buchhaltung und Finanzen in NetSuite.
Steuerberater, DATEV und E-Rechnung
In Deutschland hängt am ERP fast immer ein Steuerberater. Er erwartet Buchungsdaten in einem festen Format und zu einem festen Rhythmus. Klären Sie diesen Punkt am Anfang, nicht am Ende: Welche Belege soll er digital erhalten? Wer pflegt Kontenrahmen und Steuerschlüssel? Wie werden Korrekturen zurückgespielt?
Parallel gewinnt die elektronische Rechnung an Bedeutung. Wie Ihr ERP XRechnung und ZUGFeRD erzeugen und empfangen sollte, erklärt der Beitrag zur E-Rechnung im ERP. Für die Schnittstellenplanung gilt: Der Ein- und Ausgang elektronischer Rechnungen ist ein eigener Datenfluss mit eigenen Fehlerfällen, der nicht nebenbei mitläuft.
Einen Datenfluss richtig cadrieren
Die meisten Integrationsprobleme entstehen nicht in der Technik, sondern im Zuschnitt. Bevor jemand eine Zeile konfiguriert, sollte jeder Fluss auf einer Seite beschrieben sein.
Die Fragen, die jede Schnittstelle beantworten muss
- Was fließt? Welche Datensätze und welche Felder werden übertragen, und welche bewusst nicht?
- In welche Richtung? Einseitig oder in beide Richtungen? Bei beidseitigen Flüssen muss festliegen, welches System bei einem Konflikt gewinnt.
- Wann? Sofort bei jedem Ereignis, in festen Intervallen oder per Stapel? Das beeinflusst Last und Aktualität.
- Wer ist führend? Artikelstamm, Kundenstamm und Preise haben je ein führendes System.
- Was passiert bei Fehlern? Wer wird benachrichtigt, wie wird wiederholt, wo liegen die Protokolle?
- Wer pflegt den Fluss? Eine benannte Person auf Ihrer Seite, ein Vertragspartner auf Integratorseite.
Stammdaten vor Schnittstellen
Eine Schnittstelle überträgt auch die Schwächen der Stammdaten. Doppelte Kunden, uneinheitliche Artikelnummern oder falsche Steuerkennzeichen führen dazu, dass Fehler automatisch und in großer Zahl entstehen. Planen Sie die Datenbereinigung deshalb vor dem ersten Test ein, im Rahmen der Einführung von NetSuite oder einer Migration.
Testen mit Ausnahmen
Der Normalfall funktioniert in der Demo immer. Aussagekräftig sind Tests mit Stornos, Teillieferungen, Gutschriften, Sonderzeichen in Adressen, ausländischen Kunden und fehlerhaften Zahlungsreferenzen. Legen Sie vor dem Go-live fest, welche Ausnahmen getestet werden und wer das Ergebnis abnimmt.
GoBD und Datenschutz bei Schnittstellen
Sobald eine Schnittstelle buchungsrelevante Daten bewegt, berührt sie die GoBD. Zu ihr gehören nachvollziehbare Verarbeitung, unveränderbare Belege und eine Dokumentation des Verfahrens. Praktisch bedeutet das:
- Jede Schnittstelle wird in der Verfahrensdokumentation beschrieben: Zweck, Datenfelder, Richtung, Zeitpunkt, Verantwortliche.
- Fehler und Wiederholungen werden protokolliert und bleiben nachvollziehbar.
- Änderungen an einem Fluss werden dokumentiert und freigegeben, nicht still im Hintergrund angepasst.
- Zugriffsrechte der Integrationsbenutzer sind auf das Nötige beschränkt. In SuiteTalk lassen sie sich über Rollen steuern, bis hin zur Rolle „Web Services Only“.
Mehr zu den Anforderungen im Überblick finden Sie im Beitrag zu GoBD im ERP. Beim Datenschutz gilt zusätzlich: Wenn personenbezogene Daten an Plattformen oder Dienstleister wandern, gehören Auftragsverarbeitung und Speicherort in die Prüfung. Ob dabei auch der Betrieb in der Cloud eine Rolle spielt, klärt die Seite zu NetSuite in Deutschland.
Wer betreibt die Integration nach dem Go-live?
Eine Schnittstelle ist kein einmaliges Projekt. Auf beiden Seiten ändert sich Software: NetSuite erscheint in neuen Versionen, Shopsysteme und Banken passen Formate an, Behörden und Steuerberater ändern Anforderungen. Dazu kommt das Auslaufen von SOAP, das bei Altintegrationen ohnehin eine Überarbeitung erzwingt.
Drei Betriebsmodelle begegnen Ihnen in der Praxis:
| Modell | Vorteil | Risiko |
|---|---|---|
| Betrieb durch den Integrator im Supportvertrag | Ein Ansprechpartner, schnelle Reaktion | Abhängigkeit, Kostenlogik klären |
| Betrieb durch den Anbieter einer Plattform | Wartung der Standardbausteine inklusive | Anpassungen bleiben Ihre Aufgabe |
| Betrieb durch die eigene IT | Volle Kontrolle | Wissen hängt an wenigen Personen |
Welches Modell passt, hängt von Ihrer IT-Ausstattung und der Kritikalität des Flusses ab. Wenn der Auftragsimport steht, steht auch der Versand: Dann braucht es eine verbindliche Reaktionszeit. Einzelheiten zum laufenden Betrieb stehen auf der Seite Support und Wartung für NetSuite.
So wählen Sie den passenden Integrator
Schnittstellen sind der Bereich, in dem sich Erfahrung am deutlichsten zeigt. Fragen Sie Integratoren nicht nur nach Referenzen, sondern nach Vorgehen:
- Auf welcher API setzen sie neue Flüsse auf, und wie gehen sie mit SOAP-Altlasten um?
- Wie dokumentieren sie Schnittstellen, sodass sie GoBD-tauglich sind?
- Wer übernimmt Überwachung und Fehlerbehebung nach dem Go-live?
- Welche Erfahrung haben sie mit Ihrem Shopsystem, Ihrer Bank und Ihrem Steuerberater-Setup?
- Wie trennen sie Standard und Individuelles, damit Updates nicht jedes Mal Aufwand erzeugen?
Weitere Kriterien für die Auswahl finden Sie unter den passenden NetSuite-Integrator wählen. Wenn Sie uns Ihre Anforderungen schildern, vermitteln wir kostenlos an Integratoren, die zu Ihrem Vorhaben passen; die Umsetzung verantwortet der Integrator, nicht wir.
Checkliste für Ihr Integrationsvorhaben
- Alle gewünschten Flüsse auflisten und nach Geschäftswert ordnen
- Pro Fluss Richtung, Auslöser, führendes System und Fehlerbehandlung festlegen
- Neue Flüsse auf REST mit OAuth 2.0 auslegen, SOAP-Altbestand erfassen
- Fertige Bausteine und Individuelles bewusst trennen
- Steuerberater früh einbinden und Formate abstimmen
- Verfahrensdokumentation und Rollenkonzept mitplanen
- Betrieb, Überwachung und Zuständigkeiten vertraglich festhalten
- Tests mit Ausnahmen und einer fachlichen Abnahme einplanen
Häufige Fragen
Welche API bietet NetSuite für neue Integrationen?
Für neue Projekte empfiehlt die Oracle-Dokumentation die REST-Webservices von SuiteTalk in Verbindung mit OAuth 2.0. Sie bieten Lese- und Schreibzugriffe auf Datensätze, Metadaten, gefilterte Abfragen und SuiteQL. Die ältere SOAP-Schnittstelle läuft aus und sollte in neuen Vorhaben nicht mehr die Grundlage sein.
Wann lohnt sich ein fertiger NetSuite-Connector, wann eine individuelle Schnittstelle?
Ein fertiger Connector lohnt sich, wenn Ihr Prozess dem Standard der angebundenen Anwendung entspricht, etwa bei einem gängigen Shopsystem oder einer Bank. Sobald Preislogik, Artikelstruktur oder Freigaben stark von Ihrem Alltag abweichen, wird ein angepasster Fluss meist günstiger als ein verbogener Standard. Entscheidend ist, dass vorab klar ist, wer den Connector pflegt, wenn sich eine der beiden Seiten ändert.
Wie hängen NetSuite-Schnittstellen und GoBD zusammen?
Die GoBD verlangen nachvollziehbare, unveränderbare und vollständige Buchungsdaten, auch wenn Daten zwischen Systemen wandern. Für jede Schnittstelle, die buchungsrelevante Daten überträgt, gehören deshalb Fehlerprotokolle, ein Verfahren für Wiederholungen und eine Beschreibung in der Verfahrensdokumentation dazu. Wer nur den Normalfall testet, steht bei der Betriebsprüfung ohne Nachweis für die Ausnahmen da.
Wie binde ich den Steuerberater und DATEV an NetSuite an?
Üblich ist, dass NetSuite Buchungsdaten in einem Format bereitstellt, das Ihr Steuerberater in DATEV übernehmen kann, entweder per Export oder über eine automatisierte Übergabe. Klären Sie mit der Kanzlei, welche Kontenrahmen, Belegbilder und Rhythmen sie erwartet, bevor ein Integrator etwas baut. Der Abgleich der Stammdaten, etwa der Konten und Steuerschlüssel, ist dabei der häufigste Stolperstein.
Wer betreibt und repariert Integrationen nach dem Go-live?
Das muss vertraglich festgelegt sein, sonst entsteht eine Lücke zwischen Anwendung, Plattform und ERP. Sinnvoll ist ein benannter Verantwortlicher auf Ihrer Seite und ein Support-Vertrag mit dem Integrator, der Überwachung, Fehlerbehebung und Anpassungen bei Updates abdeckt. Über unsere kostenlose Vermittlung finden Sie Integratoren, die dieses Betriebsmodell ausdrücklich anbieten.
Quellen
- Oracle NetSuite Help Center – REST Web Services (SuiteTalk)
- Oracle NetSuite Help Center – SOAP Web Services (SuiteTalk)
Die genannten Softwarenamen sind Marken der jeweiligen Hersteller und dienen ausschließlich der Information. Diese Website ist unabhängig und steht in keiner Verbindung zu den Herstellern.