forumNeues Thema

Uns wurde eine "API-Integration" angekündigt – wie läuft das ab und was müssen wir liefern?

NNuri N***TeilnehmerCommunity-Mitglied
Beigetreten
Nov. 2023
Nachricht
4
#1

In unserem Online-Shop gehen täglich im Schnitt 60-70 Bestellungen ein. Bislang hat ein Mitarbeiter jeden Abend Rechnungen und Bestandsveränderungen manuell in unsere Buchhaltungssoftware eingepflegt. Damit Bestellungen Debitorenkonten und Bestände künftig automatisch synchronisiert werden haben wir ein externes Entwicklerteam beauftragt. Kostenpunkt: 45.000 TL bei einer veranschlagten Umsetzungszeit von 3 Wochen.

Im ersten Meeting hieß es: "Stellen Sie uns einfach die API-Endpunkte der Gegenseite und die Testumgebung bereit, den Rest übernehmen wir." Wir sind allerdings kein Tech-Unternehmen. Als wir unseren Buchhaltungsanbieter kontaktierten verlangte dieser für das API-Lizenz-Upgrade zusätzliche 12.000 TL, schickte uns einen Link zur Dokumentation und war damit aus dem Schneider.

Welche Schritte durchläuft so ein API-Integrationsprozess in der Praxis? Welche Berechtigungen Konten und Daten müssen wir als Betrieb beisteuern damit das Ganze nicht ins Stocken gerät? Und wie realistisch sind die angesetzten 3 Wochen wirklich?

RRecep T***Neues Mitglied
Funktion
Außendienstmitarbeiter
Branche
Logistik
Organisationsform
Unternehmen innerhalb eines Konzerns
Beigetreten
Aug. 2026
Nachricht
39

Doki · Backup-Einrichtung · 2023

Nützlichste Antwort#2

Kurze Antwort: Eine API-Integration sorgt dafür, dass Ihr Webshop und Ihre Buchhaltungssoftware nach fest definierten Regeln automatisiert Daten austauschen. Damit es vorangeht, müssen Sie beim Buchhaltungsanbieter die API-Lizenz freischalten lassen, die Entwicklerdokumentation an Ihr Programmierteam weiterleiten und eine Sandbox-Testumgebung bereitstellen, damit nicht an Echtdaten herumgeschraubt wird.

Der Prozess gliedert sich klassischerweise in vier Phasen. Phase eins ist das Data Mapping: Hier werden die Shop-Felder (Kundenname, Steuernummer, Artikelnummer, MwSt.-Satz, Versandkosten) eins zu eins den entsprechenden Feldern in der Buchhaltungssoftware zugeordnet. In Phase zwei folgen die Entwicklung und das Anbinden an die Sandbox-Umgebung; die Entwickler erzeugen Testbestellungen und prüfen, ob die Übertragung ins Buchhaltungssystem sauber klappt.

In Phase drei werden Fehlerszenarien durchgespielt. Was passiert etwa bei Bestellungen ohne TC-Identifikationsnummer? Wie werden Rabattgutscheine auf der Rechnung abgebildet? Wie verbucht das System Stornierungen und Retouren? In Phase vier werden schließlich die Produktiv-API-Keys hinterlegt, das System geht mit echten Bestellungen live und wird in den ersten Tagen engmaschig überwacht.

Von Ihrer Seite werden im Wesentlichen drei Dinge gebraucht: 1) API-Keys und Entwicklerdokumentation vom Buchhaltungsanbieter, 2) Zugriff auf eine Testdatenbank, 3) eine schriftliche Freigabe Ihrer Geschäftslogik (Rechnungszeitpunkt, Bestandsführungslogik, Rabattregeln). Wenn die Buchhaltungsseite technisch vollständige Unterlagen liefert, sind 3 Wochen absolut machbar. Zieht sich der Support des Buchhaltungsanbieters jedoch hin, kann es auch schnell mal 5 Wochen dauern.

UUfuk S***Teilnehmer
Funktion
Finanzbuchhaltung
Branche
Landwirtschaft
Organisationsform
Genossenschaft
Beigetreten
Juni 2022
Nachricht
74

Doki · Incident-Response-Support · 2025

#3

Die größte Stolperfalle sind abweichende Artikelnummern. Wenn die SKUs im Webshop nicht haargenau mit den Artikelnummern in der Buchhaltung übereinstimmen, fliegt Ihnen die Integration am ersten Tag um die Ohren. Gleichen Sie am besten vorab selbst in einer Excel-Tabelle ab, ob wirklich jeder Webshop-Code eine exakte Entsprechung im Buchhaltungssystem hat, bevor die Entwickler loslegen.

CCanTeilnehmer
Funktion
SEO-Spezialist
Beigetreten
März 2024
Nachricht
172
#4

Klärt unbedingt schriftlich, ob die Schnittstelle unidirektional oder bidirektional laufen soll. Sollen nur Bestellungen vom Shop in die Buchhaltung fließen oder sollen geänderte Lagerbestände und Preise aus der Buchhaltung auch wieder in den Shop zurückgespielt werden? Bei bidirektionalen Schnittstellen kommen API-Rate-Limits und Konfliktmanagement ins Spiel, was den Entwicklungsaufwand spürbar in die Länge zieht.

KKader U***Teilnehmer
Funktion
Verkäufer im Einzelhandel
Branche
Medien und Verlagswesen
Organisationsform
Familienunternehmen
Beigetreten
Juni 2024
Nachricht
86
#5

Wir haben letztes Jahr eine ganz ähnliche Anbindung umgesetzt. Allein das Einholen der API-Lizenz und der Testschlüssel vom Buchhaltungsanbieter hat uns glatt 9 Tage gekostet. Die Entwickler waren nach 12 Tagen mit dem Coden fertig, aber weil Versandkosten und Rabattzeilen in der Buchhaltung quergeschossen haben, zog sich die Testphase um weitere 8 Tage. Unterm Strich waren wir nach 29 Tagen live.

OOrhan T***TeilnehmerCommunity-Mitglied
Beigetreten
März 2024
Nachricht
242
#6

Eure To-do-Liste sollte folgendermaßen aussehen: 1) Fordert beim Buchhaltungsanbieter die Testumgebung (Sandbox) samt Dokumentation an. 2) Stimmt mit eurem Steuerberater ab, wie Stornos, Retouren und Teillieferungen verbucht werden sollen, und haltet diese Regeln schriftlich fest. 3) Lasst vor dem Go-live mindestens 15 verschiedene Testszenarien als Proberechnung durchlaufen.

YYaseminTeilnehmer
Funktion
KMU-Inhaber
Beigetreten
Juli 2024
Nachricht
98
#7

Ist eure Buchhaltungssoftware cloudbasiert oder läuft die lokal bei euch im Büro auf dem Server? Falls sie auf einem Rechner im Büro läuft, braucht ihr eine statische IP und müsst Ports auf dem Server freigeben. Das kann einerseits Sicherheitslücken aufreißen und andererseits steht die Integration still, sobald das Büro-Internet mal weg ist; habt ihr das schon besprochen?

TTaner E***Teilnehmer
Funktion
Einkaufsleiter
Branche
leder
Organisationsform
neu gegründetes Startup
Beigetreten
Juni 2023
Nachricht
132
#8

unser buchhalter hatte anfangs fehler bei den rechnungen von ausländischen kunden ohne tc kimlik nummer produziert. falls ihr bestellungen aus dem ausland bekommt oder firmenrechnungen ausstellt, klärt am besten jetzt schon, wie diese felder gemappt werden, sonst bleiben die bestellungen nachher im system hängen.

Edit: Ich habe oben etwas falsch geschrieben, entschuldigung.

SSinemExperte
Funktion
Projektmanager
Beigetreten
Okt. 2023
Nachricht
176
#9

Packen Sie das Entwicklerteam und den technischen Support Ihrer Buchhaltungssoftware in einen gemeinsamen E-Mail-Verteiler oder Kommunikationskanal. Sie müssen die ganzen Fachbegriffe nicht verstehen und auch nicht das Sprachrohr zwischen beiden sein. Lassen Sie die Parameter und Endpunkte direkt die Techniker unter sich ausmachen.

VVahide K***Teilnehmer
Funktion
Grafikdesigner
Branche
energie
Organisationsform
Unternehmen mit 120 Mitarbeitern
Beigetreten
Nov. 2023
Nachricht
411
#10

Bei unserer ersten Integration wollten wir keine 12.000 TL für eine Testumgebung zahlen und haben direkt auf der Live-Datenbank getestet. Als der Entwickler eine Testrechnung erstellt hat gingen echte e-arşiv-Rechnungen und SMS-Benachrichtigungen an echte Kunden raus. An dem Tag haben wir schmerzhaft gelernt, dass das Geld für eine Testumgebung eigentlich die günstigste Versicherung überhaupt ist.

OOnur M***Experte
Funktion
Buchhalter
Branche
kunststoff
Organisationsform
mittelständisches Unternehmen
Beigetreten
Mai 2023
Nachricht
7
#11

Gespeichert.

HHüseyin S***VeteranCommunity-Mitglied
Beigetreten
Juli 2022
Nachricht
175
#12

Die obige Antwort bringt es auf den Punkt. Entscheidend ist nicht die Zahl, sondern worauf sie sich bezieht.

Überstürzte Entscheidungen sind oft solche, die man sechs Monate später korrigieren muss. Wenn es jemand anders macht, würde mich das auch interessieren.

İİbrahim Y***TeilnehmerCommunity-Mitglied
Beigetreten
Dez. 2024
Nachricht
182
#13

Da verstehe ich etwas nicht ganz. Wenn im Vertrag nicht steht, wem der Code gehört, habt ihr bei der Trennung keine Verhandlungsmacht mehr.

Wenn es jemand anders macht, würde mich das auch interessieren.

HHilal B***Veteran
Funktion
Grafikdesigner
Branche
Elektro- und Elektronikindustrie
Organisationsform
Regionalhändler
Beigetreten
Dez. 2023
Nachricht
17
#14

Ich schreibe mal meine Erfahrung auf. Zugangsdaten sollten auf den Firmennamen laufen, nicht auf persönliche Konten.

Nur als Notiz, könnte nützlich sein.

İİbrahim Y***TeilnehmerCommunity-Mitglied
Beigetreten
Feb. 2026
Nachricht
3
#15

ich stimme zu.

EElifTeilnehmer
Funktion
Inhaber einer Café-Kette
Organisationsform
Produktionsunternehmen mit 40 Mitarbeitern
Beigetreten
Aug. 2024
Nachricht
63

Doki · Incident-Response-Support · 2024

#16

Nichts vergessen: Das günstigste Angebot ist oft das am wenigsten durchdachte.

An deiner Stelle würde ich so vorgehen.

HHavva K***TeilnehmerCommunity-Mitglied
Beigetreten
Juli 2024
Nachricht
111
#17

Der billige Weg stellt sich oft im Nachhinein als teuer heraus. Zugangsdaten sollten auf den Firmennamen laufen, nicht auf persönliche Konten.

Bei uns war der größte Zeitfresser die Unklarheit darüber, wer entscheidet. Schreibt mir, wenn ihr Fragen habt, ich antworte so gut ich kann.

MMehmet A***Experte
Funktion
Softwareentwickler
Branche
Bildung
Organisationsform
Unternehmen mit 300 Mitarbeitern
Beigetreten
Juli 2022
Nachricht
2
#18

Ich möchte kurz warnen. Jeder nicht schriftlich festgehaltene Punkt ist einer, an den sich beide Parteien später unterschiedlich erinnern.

An deiner Stelle würde ich so vorgehen.

KKübra G***Experte
Funktion
IT-Leiter
Branche
Sport & Fitness
Organisationsform
Firma mit 20 Mitarbeitern
Beigetreten
Nov. 2025
Nachricht
10
#19

Das habe ich auch erlebt. Ein wöchentlicher schriftlicher Fortschrittsbericht ist viel nützlicher als ständiges Nachfragen nach dem Status.

Beginnt mit einem kleinen Test, bindet nicht gleich alles fest. Viel Erfolg.

OOsman K***TeilnehmerCommunity-Mitglied
Beigetreten
März 2024
Nachricht
117
#20

Danke fürs Schreiben, das ist genau richtig. Überstürzte Entscheidungen sind oft solche, die man sechs Monate später korrigieren muss.

Scheut euch nicht zu fragen, wer nicht fragt, zahlt am Ende mehr. Das war's, entschuldige, wenn ich zu lang war.

Antwort schreiben