Jan Bittenbinder
Jan Bittenbinder Du sprichst direkt mit mir, und ich setze die Arbeiten selbst um. Webdesign seit 2020.

API-Schnittstellen für Wolfenbüttel

API-Schnittstellen für Betriebe in Wolfenbüttel schreibe ich, damit vorhandene Programme – Kalender, Website, Kundenverwaltung, Warenwirtschaft, Buchhaltung – Daten untereinander austauschen: Die Website kennt dann die freien Termine, die Buchhaltung erfährt von neuen Kunden. Was ist eine API? Das Wort steht für Programmierschnittstelle, also eine definierte Andockstelle: Dort stellt ein Programm anderen gezielt einzelne Daten zur Verfügung und nimmt Daten von ihnen an. Ich bestimme für jedes Feld Ziel und erforderliches Format und richte ein, dass der Abgleich nach Zeitplan oder sofort nach Änderungen läuft. Wichtig zu wissen: Ältere Software lässt sich oft gar nicht sinnvoll anzapfen. Bei deinen Programmen kläre ich das, bevor du ein Angebot erhältst.

Eine Antwort von mir bekommst du werktags innerhalb von 24 Stunden. Für das Erstgespräch planen wir etwa eine Stunde ein. Thema sind deine Programme und die Übergänge zwischen ihnen, an denen bis heute jemand Daten abtippt. Wir sehen uns im Videogespräch oder sprechen am Telefon. Erst kommt die Bestandsaufnahme, dann der Preis – und beides, bevor ich mit der Arbeit anfange.

Nicht verbunden · nicht passend · nicht aktuell

Warum jedes Programm für sich allein arbeitet

Die Warenwirtschaft zählt in Kisten, der Shop in Flaschen – also rechnet jemand jeden Bestand von Hand um, bevor er ihn überträgt. Handgriffe wie dieser an der Nahtstelle zweier Programme gehören in vielen Betrieben zum Tagesgeschäft. Fast immer hat das einen von drei Gründen: Die beiden Programme sind ab Werk nicht verbunden, ihre Felder passen nicht zusammen, oder ihr Abgleich findet bloß ab und an statt. Das gilt für die Glaserei mit Kontaktformular und Terminkalender ebenso wie für Tierarztpraxis, Feinkostgeschäft in der Altstadt, Zulieferer für Großküchentechnik und Onlineshop.

Beispiel: Programme, Felder, Adresse, Datum, Bestände und Zeiten sind erfunden.

1 / 3

Keine Verbindung vom Hersteller

Programme bringen in der Regel nur zu manchen anderen eine fertige Verbindung mit. Fehlt deine Kombination, überträgt jemand Anfragen, Bestellungen und Termine mit der Tastatur.

2 / 3

Ein Feld hier, zwei Felder dort

Die eine Software erwartet Straße und Hausnummer getrennt, die andere liefert sie in einem Feld. Ein Datum wie 19.01.2027 erscheint auf der anderen Seite als 2027-01-19. So scheitert der Import mit einer Fehlermeldung, oder derselbe Kunde wird ein weiteres Mal angelegt.

3 / 3

Abgleich nur ab und zu

Wenn ein Programm nur Exportdateien erzeugt, holt sie häufig erst jemand ins andere, sobald es der Alltag zulässt, mitunter einmal wöchentlich. Bis dahin sind Lagerbestand und Preise online veraltet, und was gerade gebucht wurde, sieht man nur in einem der beiden Kalender.

DATEV · Kalender · CRM · Formate · Website

Eigene Schnittstellen für DATEV, CRM und Online-Kalender

Im Angebot steht, welche dieser Leistungen du brauchst.

  1. DATEV

    Buchungsstapel für die Kanzlei

    Rechnungen, die dein Auftrags- oder Shopprogramm schreibt, erreichen die Buchhaltung, ohne abgetippt zu werden. Für eine Kanzlei, die DATEV nutzt, entsteht daraus ein Buchungsstapel im DATEV-Format zum Einlesen; die Kontierung bleibt Sache der Kanzlei. Die Rechnungsdateien schickt die Verbindung getrennt als Belege, zum Beispiel über DATEV Unternehmen online.

  2. Kalender

    Belegte Zeiten online gesperrt

    Termine aus deiner Onlinebuchung erscheinen im Google- oder Outlook-Kalender. Steht dort schon etwas, ist die Zeit online nicht mehr buchbar. Das senkt das Risiko doppelt vergebener Termine, selbst wenn du Telefontermine weiter von Hand einträgst.

  3. CRM

    Anfragen vom Website-Formular im CRM

    Eine Anfrage über dein Website-Formular erscheint sofort in deinem CRM, samt Name, Nachricht und Herkunftsseite. CRM heißt die Software, die deine Kundenkontakte und Anfragen sammelt. Von Hand überträgt sie keiner mehr.

  4. Formate

    Felder abbilden, Formate übersetzen

    Ich lege beim Programmieren für jedes Feld seinen Platz im Zielprogramm fest und übersetze Formate: Datum, Preise brutto oder netto, Einheiten wie Kiste und Flasche. Viele Programme reichen Daten im JSON-Format weiter, einem einfachen Textformat, das jede Angabe mit dem Namen ihres Feldes kennzeichnet. Eine gemeinsame Kennung wie die Kundennummer verhindert, dass vorhandene Datensätze übersehen werden.

  5. Website

    Kurse, Artikel, Objekte aus dem Fachprogramm

    Kurstermine, Artikel, Immobilien oder Fahrzeuge aus deinem Fachprogramm übernimmt deine Website, eine zweite Eingabe ist unnötig. Ausgebuchtes oder Verkauftes verschwindet mit dem nächsten Lauf. Bei einem neuen Onlineshop ist die Anbindung an die Warenwirtschaft Teil des Shop-Auftrags.

  6. Abgleich

    Nachtlauf oder Sofortmeldung

    Nach Zeitplan heißt meist: einmal in der Nacht. Für sofortige Übertragung setze ich einen Webhook ein, wo das Programm ihn unterstützt: Bei einer Änderung, zum Beispiel einer neuen Bestellung, meldet es sich dann selbst. Mancherorts werden solche Meldungen nach wiederholten Fehlern stillschweigend abgeschaltet, und einzelne kommen nie an. Darum steht vor dem Start fest, wie Fehlendes nachgezogen wird, beispielsweise über den nächtlichen Lauf. Jeder Lauf wird protokolliert.

  7. Alte Software

    Alte Programme, wenig Zugang

    Gerade alte Software bietet häufig keine Schnittstelle oder nur eine, die zu kurz greift. Ich prüfe dann, ob ein Tabellenexport im festen Rhythmus als Grundlage genügt. Rechnet sich keine Anbindung, sage ich es dir offen. Wer das Altprogramm ersetzen will, findet das Passende unter Individualsoftware.

Wie läuft das ab?

Die API-Anbindung entsteht in vier Schritten, getestet vor dem Start

Wir halten Kontakt per Telefon, E-Mail oder WhatsApp, wie es in deinen Tag passt. Ein freigegebenes Arbeitsbeispiel steht dir auf Anfrage offen.

  1. Erstgespräch und Bestands­aufnahme

    Gemeinsam ermitteln wir, welche Angaben heute zwischen Programmen von Hand wandern und wohin sie am Ende gehören. Danach prüfe ich, was die Schnittstelle jedes Programms hergibt und ob ihr Hersteller dafür Gebühren erhebt. Um eines klarzustellen: Diese Leistung gleicht Daten ab. Sollen ganze Arbeitsabläufe mit mehreren Schritten selbst laufen, ist das ein Fall für die Prozessautomatisierung.

  2. Umfang, Richtung, Festpreis

    Du bekommst ein Festpreis-Angebot; möchtest du die Schnittstelle danach betreut haben, nennt es auch den Monatsbetrag. Aufgeführt sind die zu verbindenden Programme, die Richtung, in die Daten gehen, und die Frage, ob nach Zeitplan oder nach jeder Änderung abgeglichen wird. Hast du zugestimmt, lege ich Feldzuordnung und Formate fest. Ob alles sitzt, prüfst du im Testlauf.

  3. Programmieren, testen, nachbessern

    Zum Programmieren und Testen nutze ich ausschließlich Testdaten. Hat das Programm eine Testumgebung – eine Kopie für risikolose Versuche –, teste ich darin. Wenn nicht, lege ich Einträge mit unverwechselbarer Test-Kennung an und lösche sie nach dem Durchlauf wieder. Du kontrollierst die Ergebnisse in deinen eigenen Programmen: Kam der Testkunde etwa mit korrekter Adresse an? Echte Daten gibt es erst, wenn kein Punkt des Testlaufs mehr offen ist.

  4. Start mit Begleitung

    In den ersten Echtläufen bleibe ich am Ball und prüfe Protokolle und Ergebnisse. Eine kurze Dokumentation zeigt dir, welches Feld wohin geht. Fehlermeldungen landen in meinem Postfach. Anschließend wählst du, ob die Verbindung weiter von mir betreut wird.

Wie lange dauert das?Mit Testdaten beginnen, mit Echtdaten weitermachen

Zeitbedarf bis zur ersten echten Übertragung

Hauptsächlich bestimmt die Zahl der Programme und Felder, wie lange es dauert. Auf Wunsch schreiben wir in einem Zeitplan auf, was wann ungefähr fertig sein soll; eine feste Dauer garantiere ich nicht. Wie zügig es vorangeht, richtet sich nach dir. Hast du es eilig, sprechen wir öfter miteinander, und ich mache Zwischenergebnisse sichtbar.

  1. Zu AnfangErstgespräch und Bestands­aufnahme
  2. Im AnschlussUmfang, Richtung, Festpreis
  3. Dannprogrammieren und testen
  4. DanachStart mit Begleitung
  5. Auf DauerAbgleich ohne Handarbeit
Ein typischer Verlauf.

Ältere Software im Verbund oder eine nötige Datenbereinigung vorab ziehen das meist in die Länge.

Wer die Fehlermeldung bekommt

Läuft ein Abgleich schief, geht die Meldung an mich, dein Team bleibt außen vor. Aus dem Protokoll lese ich ab, wo das Problem steckt – oft in einem einzelnen Datensatz oder beim Zugang.

Fehlerfreie Abgleiche sind nicht garantiert.

Was kostet das?Betreuung optional, nur dann monatlich

API-Schnittstellen Wolfenbüttel: Festpreis, Monatsbetrag, Extras

Die Programmierung bezahlst du einmal zum Festpreis. Wünschst du danach Betreuung, kommt dafür ein fester Monatsbetrag hinzu – sonst nicht.

ProgrammierungFestpreis

Den Monatsbetrag bindet keine Mindestlaufzeit. Kündige ihn formlos, dann endet er mit dem laufenden Monat.

Betreuung, wenn du willstdanach fester Monatsbetrag dazu

Inbegriffen: von der Zuordnung bis zur Doku

Inbegriffen sind die Zuordnung aller Felder, die Programmierung, ein Testlauf, eine kurze Dokumentation und meine Begleitung, wenn die Verbindung startet.

Für Erstgespräch, Bestandsaufnahme und Angebot berechne ich nichts, und verpflichtet bist du zu nichts.

Schnittstelle und Quelltext sind nach der Übergabe deins, unabhängig von einer Betreuung.

Geht ein Fehler auf meine Arbeit zurück, behebe ich ihn ohne neuen Preis.

Erhebt der Hersteller Gebühren für den Schnittstellenzugang, beispielsweise für ein Zusatzmodul, weist das Angebot sie im Voraus aus. Die Zahlung leistest du direkt an den Hersteller.

Extras mit eigenem Preis

Steht vor dem ersten Abgleich Aufräumarbeit an – Kunden, die doppelt existieren, Artikelnummern ohne einheitliches Muster –, bekommt sie im Angebot einen eigenen Preis. Dasselbe gilt für Anpassungen an eine geänderte Schnittstelle des Herstellers, wenn keine Betreuung vereinbart ist.

Was den Aufwand beeinflusst

  • Anzahl der zu verbindenden Programme
  • Wie viele Datensätze mit wie vielen Feldern zu übertragen sind
  • Einseitiger oder wechselseitiger Datenfluss samt Vorrangregel
  • Sofortabgleich bei jeder Änderung: gewünscht oder nicht
  • Wie gut der Hersteller die Schnittstellen dokumentiert hat
  • Menge der vorhandenen Daten, die bereinigt werden muss

Ist die Bestandsaufnahme gemacht, liegt der Festpreis fest. Auch wenn die Schnittstellenentwicklung mehr Stunden kostet als gedacht, bleibt es dabei. Möchtest du zusätzliche Programme oder Felder, oder änderst du Vereinbartes im Kern, erfährst du vorher, was das kostet.

Für die Betreuung, Anpassungen nach Updates eingeschlossen, kalkuliere ich je nach Umfang einen eigenen Betrag. Fehlt dir ein eigener Server, übernehme ich das Hosting; alternativ buchst du es bei einem Anbieter deiner Wahl.

Ein guter Abgleich erspart deinem Team das Übertragen

Was sich zählen lässt

  • Datensätze je Abgleich und die Uhrzeit, zu der er lief
  • Abgleiche ohne Erfolg, ihre Ursache und die Zeitspanne bis zur Behebung
  • Die Ersparnis an Arbeitszeit kannst nur du einschätzen

Wenn Zahlen in die Irre führen

  • Viele Datensätze bei vertauschten Feldern
  • Ein scheinbar fehlerfreier Abgleich, der dennoch Dubletten erzeugt, weil jedes System seine Kundennummern unabhängig vergibt
  • Sofortiger Abgleich, obwohl einer am Tag ausreicht
  • Gelieferte Daten, die im Betrieb niemand braucht

Ob im Team wirklich weniger abgetippt wird, hängt auch daran, dass niemand an den verbundenen Programmen vorbeiarbeitet. Eine private Liste, auf Papier oder als Tabelle, erreicht die Schnittstelle nie.

Mitarbeit: Zugänge einrichten, Sonderfälle nennen, Testergebnisse prüfen

Einmal, gleich am Anfang, richtest du die Zugänge ein. Danach zählen vor allem zwei Dinge: was du über eure Abläufe weißt und wie du den Testlauf prüfst.

  1. Zugänge mit engen Grenzen

    Einladung oder Zugangsdaten: Die Wahl liegt bei dir. Mich zu entfernen oder das Passwort zu ändern, ist dir jederzeit möglich; trennbare Konten führst du unter deinem Namen. Ich gebe jeder Verbindung nur die Rechte, die sie wirklich braucht, etwa Daten abrufen statt löschen.

  2. Eure Abläufe und Ausnahmen

    Du schilderst mir, wer welche Angaben wo erfasst und welches Programm bei abweichenden Daten maßgeblich ist, etwa das CRM, sobald es um Adressen geht. Sammelrechnungen und andere Ausnahmen kennt nur ihr; sie bekommen im Testlauf einen eigenen Prüfschritt.

  3. Datenschutz bei der Übertragung

    Unter Verarbeitung fasst Art. 4 DSGVO auch, Kunden- und Mitarbeiterdaten zu übermitteln oder abzugleichen. Die Verbindung überträgt nur das, was wir beim Testlauf vereinbart haben. Ist ein Vertrag zur Auftragsverarbeitung vorgeschrieben oder willst du einen, setzen wir ihn auf. Eine Rechtsberatung leiste ich damit nicht.

  4. Abstimmung und IT-Partner

    Den Takt unserer Abstimmung legst du fest, ebenso, was du vorher sehen willst, zum Beispiel Anpassungen nach Updates. Hat ein IT-Dienstleister deine Programme oder Server in der Pflege, sitzt er bei Änderungen mit am Tisch.

Erstgespräch, Bestandsaufnahme und Angebot.
Alles kostenlos und unverbindlich.