Menu

Kontor Link

Application-Programming-Interface (API)

shakehands Kontor Link ist das universale Application-Programming-Interface (API) für definierte Zugriffsmethoden von eigener Middleware für den Datenaustausch mit und von shakehands Kontor.

     Mit shakehands Kontor Link bindest du die shakehands Kontor-Datenbank an einen eigenen Webshop, an ein eigenes CRM-Tool, an eigene Warenwirtschaftssysteme oder an eine andere Datenbank an. Drittapplikationen tauschen darüber Daten aus. 

    Automatisiere zum Beispiel das Verarbeiten von Bestellungen oder den automatischen Abgleich von Adressdaten oder der Offenen Posten oder exportiere die Lagerbestände an eine externe Logistikapplikation für Dritte. Rechne die Leistungen aus mobilen Apps ab. Denkbar sind auch Anbindungen für die erweiterte Ausgabe an betriebswirtschaftliche Analyse-Tools oder an mobile Apps für Smartphones und vieles mehr.

    Tausche über die Schnittstelle alle möglichen Daten automatisch aus und integriere andere Drittlösungen. 

    shakehands Kontor Link ermöglicht dir als Entwickler:in oder Betreiber:in einer externen Dritt-Software den direkten Zugriff auf die shakehands Kontor-Daten, deren Listen und Funktionen.

     Der Zugriff erfolgt über die Kommunikation von shakehands Kontor Link mit dem von shakehands Kontor verwendeten Datenbankserver cubeSQL. shakehands Kontor Link erlaubt das Abfragen von Daten, das Filtern von bestimmten Informationen, das Ändern von bestehenden Datensätzen und das Anlegen und Schreiben von neuen Datensätzen. 

   shakehands Kontor Link verwendet zur Sicherung der Datenbankkonsistenz immer die Geschäftslogik – Business Rules – von shakehands Kontor. 

    Welche Bereiche in der shakehands Kontor Datenbank über shakehands Kontor Link erreichbar sind, ist vordefiniert und wird in der Dokumentation beschrieben. Der Zugriff auf shakehannds Kontor Link erfolgt über das Übertragungsprotokoll HTTPS.


Eigene Middleware entwickeln

Entwickle mit shakehands Kontor Link deine eigenen Anwendungen.

Hier einige Beispiele:

    Du hast einen Webshop und möchtest Artikel und Adressen mit dem Artikelstamm und den Bestandsmengen in shakehands Kontor abgleichen. Diese Aufgabe kann via API erledigt werden. 

    Oder du möchtest die Bestellungen des eigenen Webshops digital an shakehands Kontor übergeben, um dort diese Daten für eine neue Bestellung oder als neue Rechnung einzutragen. Dabei soll die Adresse abgeglichen oder neu erstellt werden, zudem alle Positionen der Rechnung und ein Beleg mit QR-Rechnung erstellt werden.

   Oder du hast ein eigenes Analyse-System für die Überwachung von Projekten und möchtest Daten aus der shakehands Kontor-Buchhaltung auslesen, um damit eigene erweiterte Liquiditätspläne oder Budgets in deinem System zu überwachen. 

    Oder du erfasst in einer mobilen Leistungserfassungs-App auf dem  Smartphone oder Tablet deine Abrechnungen und Leistungen von Kunden und möchtest diese Daten als Positionen in die monatlichen Rechnungsbelege in shakehands Kontor übertragen lassen. 

    Oder du hast eine eigene CRM-Lösung und möchtest die Basisdaten der Adressen, Bankdaten und weiteren Adressinformationen mit shakehands Kontor synchronisieren, um hier die Rechnung zu erstellen.

    Dies sind mögliche Lösungen, die unsere Kunden mit der shakehands Kontor Link API umgesetzt haben. So sind viele weitere, neue Anwendungen denkbar und  lässt sich auf diese Weise ins Rechnungswesen integrieren.    


Lieferumfang

shakehands Kontor Link ist eine Schnittstelle zur Kommunikation mit einer von Ihnen zu entwickelnden Software, einer neuen Middleware, die das JSON-Protokoll nutzt. 

shakehands Kontor Link umfasst:

  • einen konfigurierten Server zur Kommunikation mit der eigenen Middleware
  • einen Test-Client zur Darstellung der Funktionen und Kommunikation mit der Datenbank
  • Code-Beispiele einer Web-App für Datenabruf und Datenänderung 
  • eine integrierte Dokumentation der Methoden, Klassen und Eigenschaften und Funktionen
  • eine allgemeine Online-Dokumentation «shakehands Kontor Link»
  • PHP- und C++-Bibliotheken mit Methoden


Voraussetzungen zum Entwickeln

Folgende notwendige Voraussetzungen müssen erfüllt sein für das Programmieren der Schnittstelle und der Middleware:

Du brauchst:

  • eine aktive shakehands Kontor-Lizenz
  • eine shakehands Kontor-Datenbank, die auf dem cubeSQL-Server läuft
  • einen cubeSQL-Server mit aktiver Lizenz
  • eine Drittdatenbank, die mit shakehands Kontor Link und der zu entwickelnden Middleware zusammenarbeitet


   Zu beachten ist, dass shakehands Kontor Applikation und shakehands Kontor Link die gleiche Versionierung (Datenbankschema) aufweisen müssen und der cubeSQL-Server für die Applikationsversion freigegeben ist. 

    Du brauchst eine eigene Entwicklerin oder einen eigenen Entwickler, die oder der die Middleware programmiert, wenn du selber diese Voraussetzung nicht mitbringst. Oder du beauftragst eine Partnerin oder einen Partner mit dem Programmierauftrag, um eine persönliche Schnittstelle für dein Projekt zu realisieren. 


Werkzeug

shakehands Kontor Link ist keine Endanwendung, die mit wenigen Klicks installiert ist und von dem Enduser oder der Enduserin sofort in Betrieb genommen werden kann. Beachte: Du erhälst von ShakeHands Software Ltd keine fertige Kommunikationslösung. 

    Die konkrete Implementierung einer Schnittstelle zwischen den Applikationen bleibt dir vorbehalten rsp. muss in einem Projekt beauftragt und programmiert werden. Die Funktionalität von shakehands Kontor Link kann nicht erweitert werden. Wünsche und Anregungen werden von uns entgegengenommen, intern diskutiert und eventuell in zukünftige Versionen integriert.

    Für die Zeit der Entwicklung erhälst du oder deine Entwicklungspartnerin auf Anfrage eine kostenlose Developer-Lizenz.


Das Lizenzmodell

    shakehands Kontor Link ist als Client-/Server-Applikation für shakehands Kunden einer gekauften Lizenz frei lizenzierbar.    

     shakehands Kontor Link ist kostenlos. Du benötigst zum Einsatz der Software eine persönliche Lizenznummer. Dies für die Entwicklerversion und dann später für die produktive Version. 

     Bestelle deine Lizenzen im shakehands-shop. Registriere bitte die Lizenz. Für den späteren produktiven Einsatz brauchst du eine gültige und registrierte shakehands Kontor-Ausführung.

    Für die Entwicklung der Middleware und während der Entwicklungszeit erhälst du eine kostenlose Entwicklerlizenz: eine Developer-Lizenz. Bestelle diese ebenfalls im shop. Entwicklerlizenzen sind zeitlich auf 90 Tage begrenzt. Für eine Verlängerung über diese Zeit hinweg wende dich an unseren Support. Bei einer Bestellung stellen wir einige Fragen zum Entwicklungsprojekt, damit wir allfällige andere Kundenanfragen auf laufende Projekte hinweisen können. Wir kommunizieren diese an unseren Kundenstamm oder unterhalten eine Anfrageliste für weitere oder ähnliche Projekte. Damit können sich unsere shakehands-Commons sich austauschen.

    Supportleistungen, die über die produktbezogenen Fehlerbehebungen hinausgehen, z. B. für Analyse, Beratungen, Consulting oder Services für die Middleware-Programmierung oder für Schulungen, verrechnen wir zu den aktuellen Servicetarifen. Eine Einführungsschulung ist möglich. 

Entwickle deine eigene shakehands-App!


API kostenlose ErweiterungBestellen

Update Informationen

Funktionen (Release 22.1, unterstützt shakehands Kontor 22.1, 22.2 und 22.3 sowie 22.4)

  • [Allgemein] Änderung DB/API Schema auf Version 108
  • [Allgemein] Änderungen zur Verbesserungen der Stabilität
  • [Verkauf] Neuer Parameter Ansprechpartner_ID in verkaufbelegTemplate
  • [Verkauf] Parameter ER_BestellNr entfällt, genutzt wird vorhandener Parameter Referenz
  • [Einkauf] Neuer Parameter Ansprechpartner_ID in einkaufbelegTemplate
  • [Vorgaben] Neuer Parameter Standard in VerkaufpreislisteListItem 
  • [Vorgaben] Neuer Parameter Standard in EinkaufpreislisteListItem 
  • [Adressen] Neuer Parameter LeitwegID (XRechnung) in adresseTemplate, adresseList
  • [Verkauf] Implementierung Variablen eRechnung in Beleg- und Positionsitems
  • [Verkauf] Verbesserungen zur Kompatiblität bei Erfassung und Ausgabe von eRechnungen
  • [Verkauf] Korrektur Übernahme Lieferart und Zahlungsbedingungen in verkaufbelegTemplate
  • [Artikel und Leistungen] Parameter InPreisliste (für Auswertungen) wird nicht übernommen - beseitigt

Funktionen (Release 22.0, unterstützt shakehands Kontor 22.0)

  • [Allgemein] DB/API Schema bleibt auf Version 106
  • [Allgemein] Änderungen zur Verbesserungen der Stabilität
  • [Allgemein] PDF-Ausgabe über xojo-engine entfällt, PDF-Ausgabe einzig über DynaPDF-Engine
  • [Adressen] Neuer Parameter Belegausgabe, ERechnungProfil in adresseAdd
  • [Adressen] Neuer Parameter Belegausgabe, ERechnungProfil in adresseList
  • [Adressen] Parameter UseOldPDF in adresseSepaMandatPrintPDF entfernt, Standardausgabe immer über DynaPDF-Engine
  • [Verkaufsbelege] Neuer Parameter Belegausgabe in verkaufbelegGet
  • [Verkaufsbelege] Keine negativen Artikel-Einzelpreise in Belegen mehr erlaubt
  • [Verkaufsbelege] Unterstützung E-Rechnung in verkaufbelegPrintPDF
  • [Verkaufsbelege] Parameter UseOldPDF in verkaufbelegPrintPDF entfernt, Standardausgabe immer über DynaPDF-Engine
  • [Einkaufsbelege] Parameter UseOldPDF in einkaufbelegPrintPDF entfernt, Standardausgabe immer über DynaPDF-Engine
  • [Einkaufsbelege] Keine negativen Artikel-Einzelpreise in Belegen mehr erlaubt

Funktionen (Release 21.4, unterstützt shakehands Kontor 21.4)

  • [Allgemein] DB/API Schema bleibt auf Version 104
  • [Allgemein] Änderungen zur Verbesserung der Stabilität
  • [Ausgabe] PDF-Ausgabe über Xojo-Engine veraltet, entfällt ab Version 22.0.0, PDF-Ausgabe dann nur noch über DynaPDF-Engine
  • [Adressen] Parameter UseOldPDF in adresseSepaMandatPrintPDF veraltet, entfällt ab Version 22.0.0, Standardausgabe dann nur noch über DynaPDF-Engine
  • [Verkaufsbelege] Parameter UseOldPDF in verkaufbelegPrintPDF veraltet, entfällt ab Version 22.0.0, Standardausgabe dann nur noch über DynaPDF-Engine
  • [Einkaufsbelege] Parameter UseOldPDF in einkaufbelegPrintPDF veraltet, entfällt ab Version 22.0.0, Standardausgabe dann nur noch über DynaPDF-Engine

Funktionen (Release 21.2, unterstützt shakehands Kontor 21.2 und 21.3)

  • [Allgemein] DB/API Schema bleibt auf Version 103
  • [Allgemein] Änderungen zur Verbesserung der Stabilität

Funktionen (Release 21.0, unterstützt shakehands Kontor 21.0)

  • [Allgemein] DB/API Schema bleibt auf Version 101
  • [Allgemein] Änderungen zur Verbesserung der Stabilität
  • [Verkaufsbelege] Filteroption Schlussrechnung hinzugefügt 

Fehlerkorrekturen

  • [Adressen] Fehler bei Aktualisierung Addressnummer in adresseModify - korrigiert
  • [Artikel und Leistungen] Fehler Ausgabe Nachkommastellen Preise EK/VK -- beseitigt
  • [Debitoren] Fehler in debitorenZahlungCreate bei Benutzung OSS-Steuergebiet in Einnahme-Überschussrechnung - korrigiert 

Funktionen (Release 20.4, unterstützt shakehands Kontor 20.4)

  • [Allgemein] DB/API Schema bleibt auf Version 100
  • [Allgemein] Änderungen zur Verbesserung der Stabilität

Fehlerkorrekturen

  • [Adressen] Fehlende Erzeugung von Debi/Kredi-Konten bei Statusänderung - korrigiert
  • [Verkauf] Der Zahlungstext eines bestehenden Belegs ändert sich beim Drucken - behoben
  • [Einkauf]  Der Zahlungstext eines bestehenden Belegs ändert sich beim Drucken - behoben

Funktionen (Release 20.3, intern unterstützt shakehands Kontor 20.3)

Aktualisierungen/Verbesserungen/Änderungen

  • [Adressen] adresseSepaMandatPrintPDF, Unterstütztung DynaPDF
  • [Verkauf] verkaufbelegPrintPDF, Unterstütztung DynaPDF
  • [Einkauf] einkaufbelegPrintPDF, Unterstütztung DynaPDF

Fehlerkorrekturen

  • [Einkauf] einkaufbelegWeiterleitung, Positionsbezeichnungen lassen sich aktualisieren

Funktionen (Release 20.1 unterstützt shakehands Kontor 20.1)

  • [Allgemein] DB/API Schema bleibt auf Version 99
  • [Allgemein] Änderungen zur Verbesserung der Stabilität
  • [Einkauf] Neue Parameter um VorbelegBestellNr, VorbelegBestell_ID in Belegpositionen
  • [Debitoren] Unterstützung Parameter Text in DebitorenRechnungPositionAddItem beim Anlegen von Debitorenrechnungen mit mehreren Positionen
  • [Kreditoren] Unterstützung Parameter Text in KreditorenRechnungPositionAddItem beim Anlegen von Kreditorenechnungen mit mehreren Positionen
  • [Attachement] Filter um DatumVonParent, DatumBisParent erweitert.

Funktionen (Release 20.0 unterstützt shakehands Kontor 20.1)

  • [Allgemein] Änderung DB/API Schema auf Version 99
  • [Verkauf] Unterstützung Ansprechpartner in Verkaufsbelegen
  • [Einkauf] Unterstützung Ansprechpartner in Einkaufsbelegen
  • [Aktivität] Unterstützung Aktivität implementiert

Funktionen (Release 19.3 unterstützt shakehands Kontor 19.3.1)

  • [Client-/Server-Betrieb] Unterstützung für cubeSQL 5.9

Funktionen (Release 19.2 unterstützt shakehands Kontor 19.3. und 19.2)

  • [Allgemein] Änderung DB/API Schema auf Version 98

Funktionen (Release 19.1 unterstützt shakehands Kontor 19.1.)

  • [Allgemein] Änderung DB/API Schema auf Version 97
  • [Adressen] Adressen mit Steuergebiet EU-Ausland können nicht angelegt werden - korrigiert

Funktionen (Release 19.0 unterstützt shakehands Kontor 19.0. intern)

  • [Verkauf] Neue Funktion verkaufbelegModify zur Änderung bestimmter Parameter in (noch nicht weitergeleiteten) Belegen
  • [Verkauf] Unterstützung Parameter VersandURL in VerkaufbelegAddItem, VerkaufbelegItem
  • [Einkauf] Neue Funktion einkaufbelegModify zur Änderung bestimmter Parameter in (noch nicht weitergeleiteten) Belegen
  • [Einkauf] Unterstützung Parameter VersandURL in EinkaufbelegAddItem, EinkaufbelegItem
  • [Artikel und Leistungen] Erweiterung Filterparameter um aktuelle Bestandsdaten
  • [Lager] Erweiterung Filterparameter um aktuelle Bestandsdaten

Funktionen (Release 18.5 unterstützt shakehands Kontor 18.5.)

  • [Allgemein] Änderung DB/API Schema auf Version 95
  • [Allgemein] Verbesserung Darstellung/Benutzbarkeit der JSON-Referenz
  • [Artikel und Leistungen] Neuer Kontoparameter EKontoAnzEUOSS in warengruppeAdd, warengruppeGet

Funktionen (Release 18.4 unterstützt shakehands Kontor 18.4.)

  • [Allgemein] Änderung DB/API Schema auf Version 94
  • [Allgemein] Farbfehler bei PDF-Erzeugung - behoben
  • [Artikel & Leistungen] Unterstützung Bildformate BMP,PNG,JPG in artikelBildGet
  • [Verkaufsbelege] Filterparameter VorbelegStatus ersetzt MitVorbelege (MitVorbelege entfällt ab 19.0)
  • [Verkaufsbelege] Filterparameter FolgebelegStatus ersetzt MitFolgebelege (MitFolgebelege entfällt ab 19.0)
  • [Verkaufsbelege] Unterstützung Feld AUF_QRIBAN in Druckformularen
  • [Verkaufsbelege] Fehler Beschreibung und Preis werden nicht automatisch aus Stammartikeln übernommen - beseitigt
  • [Einkaufsbelege] Filterparameter VorbelegStatus ersetzt MitVorbelege (MitVorbelege entfällt ab 19.0)
  • [Einkaufsbelege] Filterparameter FolgebelegStatus ersetzt MitFolgebelege (MitFolgebelege entfällt ab 19.0)
  • [Einkaufsbelege] Fehler Beschreibung und Preis werden nicht automatisch aus Stammartikeln übernommen - beseitigt
  • [Buchungen] Automatische Erzeugung Belegnummer (bei nichtgesetztem Parameter BelegNr) in buchungAdd
  • [Debitoren] Automatische Erzeugung Belegnummer (bei nichtgesetztem Parameter BelegNr) in debitorenRechnungAdd
  • [Kreditoren] Automatische Erzeugung Belegnummer (bei nichtgesetztem Parameter BelegNr) in kreditorenRechnungAdd

Funktionen (Release 18.1 unterstützt shakehands Kontor 18.1.)

  • [Firmen] Datentyp FirmaItem neue Ausgabe von IBAN und BIC, dafür entfallen alte Kontonummer und BLZ
  • [Adressen] Unterstützung von RA-Strasse, RA-StrasseNr in Adresslist
  • [Verkaufsbelege] Neuer Parameter optional SepaBankeinzugin VerkaufsbelegItem und VerkaufsBelegAddItem

Funktionen (Release 17.2 unterstützt shakehands Kontor 17.2.)

  • [Allgemein] Ausgabe von User-Rechten

Funktionen (Release 17.0 unterstützt shakehands Kontor 17.0.)

  • [Verkauf] Neuer Parameter BearbeiterAngeben in Verkaufsbelegen
  • [Einkauf] Neuer Parameter BearbeiterAngeben in Einkaufsbelegen
  • [Debitoren] Neuer Parameter Entwurf in Debitorenrechnungen
  • [Kreditoren] Neuer Parameter Entwurf in Kreditorenrechnungen
  • [Attachement] Neuer Parameter Bezeichnung hinzugefügt

Funktionen (Release 16.3 unterstützt shakehands Kontor 16.3.0)

  • [Sonstiges] Apple macOS Catalina Freigabe

Funktionen (Release 16.2 unterstützt shakehands Kontor 16.2.1)

  • [Verkauf] Unterstützung Bankkonto in Auftrag
  • [Adressen] Unterstützung Ansprechpartner Kontaktrolle
  • [Offene Posten] Parameter Zahlungsart in debitorenZahlungCreate und kreditorenZahlungCreate wird nicht ausgewertet - behoben

Funktionen (Release 16.0 unterstützt shakehands Kontor 16.0.1)

  • [Artikel] artikelModify zur Artikelbearbeitung - integriert
  • [Adressen, Artikel und Leistungen] Neuer Suchparameter matchcode in Adressefilter und  Artikelfilter
  • [Verkauf] Neuer Input-Parameter und neue Suchparameter
  • [EInkauf] Neue Suchparameter
  • [Buchungen] Neue Funktion buchungAddAttachment
  • [Debitoren und Kreditoren] Neuer Parameter Projekt_ID

Funktionen (Release 15.0 unterstützt shakehands Kontor 15.1.0, 15.2.0, 15.3.0)

  • [Filter] neue Optionen in Artikel, Offene Posten, Buchungen - integriert
  • [Artikel] neue Parameter GesamtRabattGesperrt, OnlineShopArtikel- integriert 
  • [Adressen] Bankdaten setzen, modifizieren - integriert

Release Notes

Update bestellen

Systemanforderungen

Apple Macintosh

  • INTEL- oder ARM-basierter Mac
  • Bildschirm mit 1280 x 800 Pixel
  • Freier Festplattenspeicher > 1 GB
  • Apple macOS 10.14 (Mojave), macOS 10.15 (Catalina), macOS 11.x (Big Sur), macOS 12.x (Monterey), macOS 13.x (Ventura), macOS (Sonoma), macOS 15.x (Sequoia)
  • 64-Bit Betriebsystem
  • Fonts Helvetica, Arial

Eigene Middleware, cubeSQL Server, shakehands Kontor

Microsoft Windows

  • (x86)-kompatibler Prozessor
  • Bildschirm mit 1280 x 800 Pixel
  • Freier Festplattenspeicher > 1 GB
  • Microsoft Windows 10, Microsoft Windows 11
  • 64-Bit Betriebssystem
  • Font Arial

Eigene Middleware, cubeSQL Server, shakehands Kontor 

Preise inkl. MwSt.