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

API-Schnittstellen für Buxtehude

Für Buxtehuder Betriebe verbinde ich per API-Schnittstelle die Programme, die ohnehin laufen: Website, Kundenverwaltung, Kalender, Warenwirtschaft, Buchhaltung. Auf Deutsch heißt API Programmierschnittstelle; darüber lässt ein Programm andere gezielt an ausgewählte Daten heran und nimmt umgekehrt Daten von ihnen an. Für jedes Feld lege ich fest, wohin es gehört und in welchem Format das Ziel es erwartet, damit aus „K-1045“ im einen Programm kein zweiter Kunde „1045“ im anderen wird. Abgeglichen wird zu festen Zeiten oder sofort bei einer Änderung. Eine Grenze: Viele ältere Programme lassen keine brauchbaren Daten nach außen. Wie es um deine steht, weißt du, bevor ein Angebot kommt.

Deine Anfrage beantworte ich an jedem Werktag innerhalb von 24 Stunden. Im Erstgespräch, Richtwert eine Stunde, sammeln wir, mit welchen Programmen dein Team arbeitet und wo Daten heute per Hand von einem ins andere wandern. Das läuft per Video oder Telefon. Einen Preis nenne ich dir, sobald die Bestandsaufnahme steht – und immer, bevor die Arbeit beginnt.

Lücke ab Werk · Formatbruch · Wochenexport

Drei Stellen, an denen Programme aneinander scheitern

Zwischen zwei Programmen sitzt in vielen Betrieben ein Mensch, der Daten überträgt. Meist steckt einer von drei Gründen dahinter: Eine fertige Verbindung existiert nicht, die Datenfelder sind verschieden gebaut, oder abgeglichen wird nur gelegentlich. Betroffen sind Elektriker, deren Website-Formular und Kalender nichts voneinander wissen, genauso wie Zahnarztpraxen, Zulieferer der Luftfahrt, Logistikbetriebe im Gewerbegebiet Ovelgönne und Onlineshops.

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

1 / 3

Ab Werk nicht vorgesehen

Ein Programm kann sich ab Werk mit einer Handvoll anderer verständigen, mit dem Rest nicht. Ist deine Kombination nicht unter dieser Handvoll, kommen Anfragen, Bestellungen und Termine eben per Tastatur hinüber.

2 / 3

Gleiche Daten, anderer Aufbau

Das Auftragsprogramm kennt nur ein Adressfeld, die Kundenverwaltung trennt Straße und Hausnummer. Beim Datum wird aus 14.01.2027 drüben 2027-01-14. Folge: Beim Einlesen hagelt es Fehlermeldungen, oder im Zielprogramm taucht ein Kunde ein zweites Mal auf.

3 / 3

Die Exportdatei wartet auf Zeit

Manche Software rückt Daten nur als Exportdatei heraus. Ins nächste Programm kommt sie, wenn jemand Zeit hat, oft nur einmal die Woche. Bis dahin stimmen online weder Lagerzahlen noch Preise, und was gerade gebucht wurde, kennt der zweite Kalender nicht.

Formate · DATEV · CRM · Kalender · Website

Schnittstellen program­mieren lassen, die CRM, Kalender und DATEV mit Daten versorgen

Was davon dein Betrieb tatsächlich braucht, legt das Angebot fest.

  1. Formate

    Jedes Feld an seinen Platz

    Beim Programmieren lege ich fest, welches Feld aus dem einen Programm in welches Feld des anderen gehört. Formate rechne ich dabei um: Datumsangaben, Preise mit und ohne Mehrwertsteuer, Einheiten wie Meter oder Stück. Häufig kommen die Daten als JSON an, einem Austauschformat aus reinem Text, das jeder Angabe ihren Feldnamen voranstellt. Woran ein schon angelegter Eintrag zu erkennen ist, legt eine Kennung fest, die beide Programme führen, meist die Kundennummer.

  2. DATEV

    Steuerbüro mit DATEV beliefern

    Was dein Auftrags- oder Shopprogramm an Rechnungen schreibt, kommt ohne neues Eintippen im Buchhaltungsprogramm an. Für ein Steuerbüro, das mit DATEV arbeitet, wird daraus ein Buchungsstapel im DATEV-Format, den die Kanzlei einlesen kann; welche Buchungskonten gelten, legt sie fest. Die Rechnungen als Dateien reisen auf einem eigenen Weg als Belege mit, beispielsweise über DATEV Unternehmen online.

  3. Abgleich

    Uhrzeit oder Ereignis als Startsignal

    Nach Plan startet der Abgleich etwa einmal pro Nacht. Muss eine Änderung sofort drüben sein, kommt ein Webhook ins Spiel, sofern das Programm so etwas anbietet: Das Programm meldet sich dann von sich aus, etwa wenn eine Bestellung hereinkommt. Nach wiederholten Fehlern schalten manche Programme diese Benachrichtigung stillschweigend ab, und auch sonst kann mal eine fehlen. Wie solche Lücken geschlossen werden, etwa durch den Nachtlauf, legen wir vorher fest. Von jedem Lauf bleibt ein Protokoll.

  4. CRM

    Website-Formular mit Ziel CRM

    Eine Anfrage über dein Website-Formular steht danach mit Name, Nachricht und Herkunftsseite im CRM, also in der Software, die deine Kunden und Anfragen sammelt. Herkunftsseite heißt: die Seite, auf der das Formular abgeschickt wurde. Niemand muss mehr etwas abschreiben.

  5. Kalender

    Buchbare Zeiten passend zum Kalender

    Was Kunden online buchen, trägt die Verbindung in deinen Google- oder Outlook-Kalender ein; Zeiten, die dort schon vergeben sind, fallen aus der Onlinebuchung heraus. So kommen sich Termine seltener in die Quere, auch wenn du telefonisch vereinbarte weiter selbst einträgst.

  6. Website

    Was im Fachprogramm steht, steht auch online

    Pflegst du Artikel, Fahrzeuge, Immobilien oder Kurstermine in einem Fachprogramm, zeigt die Website denselben Stand, ohne zweite Eingabe. Was verkauft ist, ist nach dem folgenden Lauf auch online weg. Geht es um einen neuen Onlineshop, steckt die Anbindung der Warenwirtschaft schon in dieser Leistung.

  7. Alte Software

    Ältere Programme mit dünnem Zugang

    Älteren Programmen fehlt eine Schnittstelle häufig, und wenn es eine gibt, ist sie oft mager. In dem Fall teste ich, ob ein regelmäßiger Tabellenexport als Datenquelle taugt. Lohnt sich keine Anbindung, hörst du das von mir ohne Umschweife; wer das alte Programm ersetzen will, ist bei der Individualsoftware richtig.

Wie läuft das ab?

API-Anbindung program­mieren lassen und mit Probedaten absichern

Für Rückfragen nimm, was dir liegt: Telefon, E-Mail oder WhatsApp. Auf Anfrage bekommst du ein freigegebenes Arbeitsbeispiel zu sehen.

  1. Erstgespräch und Bestands­aufnahme

    Wir sammeln die Stellen, an denen Daten heute abgetippt oder kopiert werden, und klären, welches Programm sie am Ende braucht. Danach nehme ich mir jedes Programm einzeln vor: Was gibt die Schnittstelle her, und verlangt der Hersteller Geld für ihre Nutzung? Mein Thema hier ist der Abgleich zwischen Programmen; ganze Arbeitsabläufe, die von selbst laufen sollen, gehören zur Prozessautomatisierung.

  2. Umfang und Festpreis

    Drei Dinge hält das Angebot fest: die beteiligten Programme, die Flussrichtung der Daten und den Auslöser des Abgleichs, also Zeitplan oder Änderung. Dazu kommt der Festpreis und, falls du mich danach weiter betreuen lassen willst, ein Monatsbetrag. Hast du zugestimmt, ordne ich Feld um Feld Ziel und Format zu; ob alles sitzt, prüfst du im Testlauf.

  3. Bauen und mit Testdaten prüfen

    Zuerst bekommt die fertig programmierte Verbindung nur Testdaten zu sehen. Manche Programme bieten dafür eine Testumgebung, eine Kopie, die man nach Belieben ausprobieren darf; die nutze ich dann. Wo es keine gibt, lege ich Einträge an, die eindeutig nach Test aussehen, und räume sie anschließend wieder ab. Du schaust dir das Ergebnis in deinen Programmen an, zum Beispiel: Ist beim Testkunden die Adresse richtig angekommen? Auf Echtdaten stelle ich erst um, wenn der Testlauf in allen Punkten gepasst hat.

  4. Start und erste Abgleiche

    Wenn die echten Daten zum ersten Mal laufen, bin ich dabei und lese Protokolle und Ergebnisse mit. Eine knappe Feldübersicht dokumentiert, was wohin wandert. Geht etwas schief, landet die Fehlermeldung in meinem Postfach. Ob es danach mit Betreuung weitergeht, bestimmst du.

Wie lange dauert das?Probedaten zuerst, Echtdaten danach

Wie bald die erste Verbindung läuft

Am stärksten hängt die Dauer daran, wie viele Programme und Felder beteiligt sind. Ein Zeitplan mit ungefähren Daten ist möglich; eine feste Dauer sage ich nicht zu. Hast du es eilig, gibt es regelmäßige Absprachen und unterwegs Zwischenergebnisse; ansonsten richtet sich das Tempo nach deinem Bedarf.

  1. ZuerstGespräch, Bestands­aufnahme
  2. DanachFestpreis-Angebot
  3. DannBauen und testen
  4. AnschließendEchtstart begleiten
  5. DauerhaftAbgleich im Alltag
Ein typischer Verlauf.

Mit Altsoftware oder Daten, die zuerst aufgeräumt werden wollen, wird es meistens länger.

Wenn ein Abgleich hakt

Die Fehlermeldung eines abgebrochenen Laufs landet bei mir, deine Leute bleiben damit unbehelligt. Das Protokoll verrät mir, woran es lag: an einem einzelnen Datensatz zum Beispiel oder an einem Zugang.

Abgleiche ohne jeden Fehler kann ich nicht garantieren.

Was kostet das?Festpreis fürs Programmieren, Monatsbetrag allein bei Betreuung

API-Schnittstellen Buxtehude: Kosten, Festpreis und was extra ist

Die Programmierung kostet einen Festpreis. Bleibt die Schnittstelle danach in meiner Betreuung, zahlst du dafür einen festen Monatsbetrag.

ProgrammierungFestpreis

Eine Mindestlaufzeit hat der Monatsbetrag nicht; du beendest ihn mit einer formlosen Nachricht zum Schluss des laufenden Monats.

Betreuung, wenn du willstdanach fester Monatsbetrag dazu

Was der Festpreis abdeckt

Feldzuordnung, Programmierung und Testlauf sind drin, dazu eine kurze Dokumentation, und beim Start bin ich mit dabei.

Schnittstelle und Quelltext sind ab der Übergabe deine, ob du nun eine Betreuung buchst oder nicht.

Fehler aus meiner Arbeit korrigiere ich, ohne dir dafür einen neuen Preis zu nennen.

Ohne Kosten und ohne Bindung: Erstgespräch, Bestandsaufnahme, Angebot.

Kostet der Schnittstellenzugang beim Hersteller extra, etwa in Form eines Zusatzmoduls, siehst du den Betrag schon im Angebot. Du begleichst ihn unmittelbar beim Hersteller.

Extra: Daten aufräumen, Hersteller-Änderungen

Manchmal muss vor dem ersten Abgleich aufgeräumt werden: doppelt vorhandene Kunden etwa oder Artikelnummern, die mal so, mal so geschrieben sind. Dafür nennt das Angebot einen eigenen Preis. Ebenso bei einer Hersteller-Schnittstelle, die sich ändert, solange du ohne Betreuung arbeitest.

Was den Aufwand größer oder kleiner macht

  • Anzahl der Programme, die zusammenkommen
  • Wie viele Datensätze und Felder übertragen werden
  • Einbahnstraße oder beide Richtungen, und welches Programm im Konfliktfall gewinnt
  • Ob schon jede einzelne Änderung einen Abgleich auslösen soll
  • Wie ausführlich die Schnittstellen dokumentiert sind
  • Wie viel am Datenbestand vorher zu bereinigen ist

Sobald die Bestandsaufnahme abgeschlossen ist, steht der Festpreis, und daran ändert auch eine Entwicklung nichts, die aufwendiger wird als gedacht. Mehr kostet es, falls du zusätzliche Programme oder Felder willst oder wir Abgestimmtes von Grund auf umwerfen; diese Kosten erfährst du vorher.

Für die Betreuung, in der auch Anpassungen nach Updates stecken, setze ich je nach Umfang einen eigenen Betrag an. Fehlt ein eigener Server, betreibe ich das Hosting für dich, alternativ buchst du es selbst.

Woran sich zeigt, dass die Handarbeit zwischen den Programmen endet

Was das Protokoll belegt

  • Datensätze je Lauf und der Zeitpunkt, an dem er startete
  • Gescheiterte Läufe samt Ursache und wie lange es bis zur Lösung dauerte
  • Wie viele Stunden das deinem Team erspart, weißt nur du

Zahlen, die täuschen können

  • Viele übertragene Datensätze, bei denen aber Felder vertauscht sind
  • Ein scheinbar fehlerfreier Abgleich, der Dubletten erzeugt, weil beide Programme ihre eigenen Kundennummern verteilen
  • Sofortabgleich rund um die Uhr, wo ein täglicher Lauf genügt
  • Übertragene Daten, mit denen am Ende keiner arbeitet

Ob am Ende weniger getippt wird, hängt auch daran, dass das ganze Team in den verbundenen Programmen arbeitet. Zettel am Bildschirm und private Tabellen sieht keine Schnittstelle.

Einmal Zugänge, danach dein Wissen und dein Blick auf den Testlauf

Die Zugänge richten wir einmal am Anfang ein. Was danach von dir kommt, ist Ablaufwissen und dein prüfender Blick im Testlauf.

  1. Zugang zu deinen Programmen

    Zugang bekomme ich per Einladung oder mit deinen Zugangsdaten. Mich wieder zu entfernen oder das Passwort zu ändern, geht jederzeit; trennbare Konten laufen auf deinen Namen. Jede Verbindung erhält so wenig Rechte wie möglich, zum Beispiel darf sie Daten abrufen, aber nicht entfernen.

  2. Eure Abläufe und ihre Ausnahmen

    Du erklärst mir, wer bei euch welche Daten wo erfasst und welches Programm im Zweifel gilt, bei Adressen zum Beispiel das CRM. Sonderfälle wie Sammelrechnungen kennt nur dein Betrieb; die spielen wir im Testlauf gezielt durch.

  3. Datenschutz bei der Übertragung

    Auch Übermitteln und Abgleichen gelten nach Art. 4 DSGVO als Verarbeitung, bei Kundendaten wie bei Daten deiner Mitarbeiter. Übertragen wird ausschließlich, was wir im Testlauf gemeinsam festgelegt haben. Einen Vertrag zur Auftragsverarbeitung unterschreiben wir, sobald er vorgeschrieben ist oder du ihn möchtest. Als Rechtsberatung ist das nicht gemeint.

  4. Abstimmung, auch mit deiner IT

    Wie eng wir uns abstimmen, legst du fest; zum Beispiel, ob du Anpassungen nach einem Update erst ansehen willst. Hat ein IT-Dienstleister deine Programme oder den Server in Obhut, stimme ich mich mit ihm ab.

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