Wir haben immer wieder Anfragen von unseren Kunden, ob wir eine API-Schnittstelle zu anderen Softwareanbietern für Kontolino! haben. Schließlich können Buchungen an sehr vielen Stellen entstehen. Dabei wäre es toll, wenn man diese nicht in Kontolino! nochmals eintippen oder per Datei übertragen müsste.
So haben wir aufmerksam zugehört und uns an ein neues API für Kontolino! umgesetzt.
Mit Hilfe dieser neuen Schnittstelle können Sie ohne Umwege Buchungsdaten wie auch Belege direkt in die Kontolino!-Anwendung übermitteln. Interessant ist das zum Beispiel für Reisekostenbuchungen, Buchungen aus Kassenjournalen, Lohnbuchungen etc.. Diese werden ohne Medienbrüche oder Umwege direkt aus Ihrem Programm online in Kontolino! übertragen.
Eine Beschreibung der Schnittstelle haben wir für Sie auf der Seite apidoc.kontolino.de dokumentiert. Dort finden Sie zum Einen eine genaue Beschreibung aller Daten. Zum Anderen können Sie Ihre programmierte Schnittstelle direkt per Web-Oberfläche testen. So erhalten Sie sofort Feedback, ob die Daten korrekt übermittelt werden konnten.
Zur Zeit gibt es zwei Aufrufe, die Ihnen zur Verfügung stehen und dokumentiert sind. Eine für die Übermittlung von
- Buchungsdaten und
- eine weitere für Belege (PDF-Dateien etc.).
Erläuterung zur Schnittstelle
Wichtig dabei ist, dass die Belegnummer mehrfach in den Buchungssätzen vorhanden sein darf. Den Beleg übermitteln Sie genau einmal mit der gleichen Nummer. Die Vorgehensweise von Kontolino! ist folgende:
Es wird von einem Beleg mit einer Belegnummer ausgegangen. Für jeden Beleg werden unter Umständen verschiedene Buchungssätze erzeugt. Dabei wird der Beleg mit der gleichen Belegnummer für jeden betroffenen Buchungssatz wiederverwendet.
Beispiel gefällig?
Es liegt eine Hotelrechnung incl. Frühstück vor. Diese Rechnung erhält z. B. die Nummer „E-1“ (Eingangsbeleg Nummer 1). Für die Verbuchung des Hotelbelegs sind zwei Buchungssätze notwendig:
- einer für die Übernachtung und
- einer für das Frühstück.
Somit übertragen Sie im ersten Aufruf zwei Buchungssätze mit der Belegnummer „E-1“. Im zweiten Aufruf übermitteln Sie einmalig den Beleg (sprich die Hotelrechnung als Belegnummer „E-1“).
Wie funktioniert die Schnittstelle zu Kontolino!?
Für die Übertragung von Daten haben wir für jeden unserer Kunden einen persönlichen Token in Kontolino! erstellt. Diesen Token muss bei Ihrer Software eingegeben werden können. Mit diesem Token ermöglichen wir, dass die Datenübertragung sicher erfolgt. Zusätzlich ist gewährleistet, dass die Daten zum richtigen Kunden übermittelt werden.
Sie haben Interesse, eine Schnittstelle zu implementieren?
Sie bieten eine Shop-Software, eine Reisekostenabrechnung, ein Lohnabrechnungsprogramm oder eine Faktura an? Dann würden wir uns freuen, wenn Sie Ihre Anwendung an unsere API anbinden. Wir haben die Schnittstelle bewusst sehr einfach gestaltet. So gestaltet sich für Sie eine Integration mit Kontolino! sehr leicht.
Wir freuen uns über Ihre Kontaktaufnahme per Mail an hilfe@kontolino.de. Wir erstellen dann gerne Ihren individuellen API-Key für Ihre Anwendung.
Nun können Sie mit Hilfe unserer Dokumentationsseite Ihre Anbindung erstellen und testen. Klappt alles? Dann sagen Sie uns Bescheid. Danach binden wir Ihre API bei Kontolino! ein.