CleverCure
Infos rund um CleverCure
Nachfolgend eine lose Sammlung von teilweise praktischen Schnittstellen zu deinem Kieselstein ERP-System
Einfache Übergabe der im Kieselstein ERP erfassten Telefonnummern, sodass die Telefonanlage dies automatisch einliest. Womit du auf dem Telefon den Namen des Anrufers siehst. Baut natürlich auf den sauber erfassten Telefonnummern auf. Siehe wie Telefonnummern erfassen.
In Kieselstein ERP sind eine Vielzahl von Schnittstellen und Datenanbindungen enthalten, welche auch laufend erweitert werden. Dies beginnt bei Importschnittstellen für Artikel, Stücklisten, Partner, Kunden, Lieferanten und geht bis zu komplexen Anbindungen an verschiedenste weitere vor oder nach-gelagerte Systeme.
Importe
Kassen Importer [Oscar und ADS3000]Linktext
[TrumpfTops]Linktext
Sachkonten Import in der integrierten Finanzbuchhaltung im CSV Format. Musterdaten für Österreich und Deutschland siehe Fibu_DE_Muster.csv. Für Schweiz und Liechtenstein siehe Fibu_CH_Muster.csv
Web-Shop Importe
Shopify Import in den Lieferschein
[WooCommerce](../auftrag/index.htm#WooCommerce Import) in den Auftrag
Exporte
Bitte beachten Sie ergänzend zu den Exporten, dass grundsätzlich jeder Druck aus Kieselstein ERP auch für Exporte, insbesondere im CSV bzw. XLS Format und natürlich im allseits beliebten PDF Format erzeugt werden können. Darüber hinaus gibt es noch weitere spezielle Anbindungen die hier beschrieben sind.
Bidirektionale Schnittstellen
Bidirektionale Schnittstellen bestehen meist aus einer Kombination von Modulen bzw. Vorgehensweisen die erst in Ihrer Gesamtheit den tatsächlichen Nutzen ergeben.
[MES Systeme](#MES Systeme)
[4Vending]Linktext
[CleverCure]Linktext
[ProFirst]Linktext
[EDI Import]Linktext
[EDI Export]Linktext
[Trumpf Boost]Linktext
Nachfolgend eine Beschreibung der derzeit realisierten Schnittstellen zu den verschiedenen Distributoren. Bitte betrachten Sie dies auch als eine Auflistung von Möglichkeiten die bereits bestehen, welche wir, für Ihren bevorzugten Distributor gerne erweitern.
Für Farnell wurde die Abfrage der kundenspezifischen Artikelpreise und des Versandes von Bestellungen realisiert.
Abfrage der Artikellieferantenpreise
Grundsätzliches: Voraussetzungen
Zusatzfunktionsberechtigung WEB_BAUTEIL_ANFRAGE
Parameter ARTIKELWIEDERBESCHAFFUNGSZEIT in Tage
API-Request werden am Server getätigt. Das bedeutet Ihr Kieselstein ERP Server muss eine Verbindung zum Farnellserver aufbauen dürfen.
Gepflegte Daten: Lieferantenartikelnummer und gegebenenfalls Herstellernummer. Hinweis: Als Lieferantenartikelnummer soll auch wirklich diese und nicht z.B. die Herstellernummer angegeben sein.
mind. Java 1.8.0_101 am Server
Einstellung im Lieferanten
Reiter Webabfrage im Lieferanten
Default ist
Auswahl von “Farnell API”
Angabe der Mindestparameter:
Api Key (Registrierung über https://partner.element14.com/member/register)
Abgerufene Region (de.farnell.com)
Für kundenspezifische Preise
Customer ID (Kundennummer bei Farnell)
Secret Key (erhält man nach Anforderung über Farnell)
Abfrage im Artikellieferanten Ist ein selektierter Lieferant im Artikellieferant ein Weblieferant (= hat einen Eintrag im Lieferant, Webabfrage <> LEER) so erscheint im Detail ein neuer Button “Webabfrage” und die Felder “Letzte Webabfrage” und “Bestand”. Mit Klick auf die Weltkugel werden die aktuellen Preise und weitere Daten abgefragt.
Suchparameter 1.) Artikelnummer Lieferant (des Artikellieferanten, der zum Zeitpunkt der Abfrage gültig ist bzgl. des Gültig-Ab Datums) 2.) Herstellerartikelnummer Sobald und nur wenn ein eindeutiges Ergebnis erzielt wird, werden die Daten des Artikellieferanten aktualisiert. Geht der API-Request nicht durch (Service derzeit nicht verfügbar, fehlerhafte Parameter,…) wird auch nicht aktualisiert, es erscheint eine entsprechende Meldung.
Aktualisierung Artikellieferant - Regeln 1.) Maßgebend ist jener Artikellieferant, der zum Zeitpunkt der Abfrage gültig ist bzgl. des Gültig-Ab Datums 2.) Blieb der Einzelpreis unverändert, so werden die Daten dieses Eintrags aktualisiert. Sonst wird ein neuer Eintrag des Artikellieferanten erzeugt mit Gültig-Ab des Abfragezeitpunkts
Aktualisierung Artikellieferant - Daten - Letzte Webabfrage
Um Missverständnisse in der Mengendefinition zu vermeiden raten wir daher von Farnell die (bekannte) Regelung zu verlangen, dass bei unklaren Einheiten Ihre Bestellung auf Halt gesetzt wird, um zu einer Abklärung der Ungenauigkeit von Seiten Farnell abgefordert zu werden.
Aktualisierung Staffelpreise - Regeln 1.) Maßgebend ist jener Eintrag, der für die aktuell geprüfte Menge zum Zeitpunkt der Abfrage gültig ist 2.) Bleibt Menge und Preis unverändert, dann auch der Eintrag 3.) Bleibt Menge bestehen und Preis ändert sich, dann 3a) Gültig Ab < Abfragetag: Bisheriger Eintrag mit Gültig Bis = Abfragetag - 1 und neuer Eintrag mit aktuellem Preis und Gültg Ab = Abfragetag 3b) Gültig Ab = Abfragetag: Bisheriger Eintrag wird mit neuem Preis aktualisiert 4.) Neue Menge führt zu einem neuem Eintrag mit Gültig Ab = Abfragetag 5.) Gibt es eine eingetragene Menge nicht mehr, so wird ihr das Gültig Bis = Abfragetag - 1 gesetzt
Automatikjob Webabfrage Artikellieferant
Um nun nicht jeden Artikel einzeln aktualisieren zu müssen, gibt es den [Automatikjob]Linktext Webabfrage Artikellieferant. Die Definition dafür finden Sie im Modul System, unterer Modulreiter Automatik. Dieser muss aktiviert werden und wird dann zum gewünschten Zeitpunkt einmal täglich, z.B. in der Nacht ausgeführt. Es werden dabei folgende Funktionen durchgeführt:
Protokoll Beispiel: Protokoll der Durchführung des Automatikjobs Webabfrage Artikellieferant.
Für Lieferant ‘Farnell GmbH’: Artikel ‘1000394NXP’: Aktualisiert Artikel ‘1000208YAG’: Aktualisiert Artikel ‘1000795AVX’: KEIN ERGEBNIS Suchparameter: Lieferantenartikelnummer ‘1657939’, Herstellernummer ’null’ Artikel ‘1000422NXP’: MEHRFACHE ERGEBNISSE Suchparameter: Lieferantenartikelnummer ‘1301304’, Herstellernummer ‘74HCT14D’ …
Mögliche Fehlermeldungen
Die Webabfrage für Artikel ‘0815’ wurde vom API-Server nicht zugelassen. Bitte prüfen Sie die Webabfragezugangsdaten im Lieferanten ‘XY’ => Lösung: wahrscheinlich stimmen die Parameter im Weblieferanten nicht.
Die Webabfrage für Artikel ‘0815’ führte zu keinem (od. mehrfachen) Ergebnis. Folgende Suchparameter wurden verwendet: Lieferantenartikelnummer ‘AB’, Herstellernummer ‘CD’ => Lösung: Prüfung der Lieferantenartikel- und Herstellernummer, z.B. ist keine Lieferantenartikelnummer angegebeben oder es wurde darin die Herstellernummer angegeben. Achtung, das sind zwei unterschiedliche Calls gegen den API-Server!
Die Webabfrage für Artikel ‘0815’ enthielt ungültige Parameter. Bitte prüfen Sie die Einstellungen im Lieferanten oder wenden Sie an Ihren Kieselstein ERP Betreuer. Bitte senden Sie uns dazu auch die Protokolldatei.
Die Webabfrage für Artikel ‘0815’ führte zu einer unerwarteten Antwort:
Versenden der Bestellungen im XML Format
Für Farnell steht mit dieser Anbindung auch das Versenden von Bestellungen im XML Format zur Verfügung. D.h. wenn bei einem Lieferanten die API zu Farnell aktiviert ist, so steht beim EMail-Versand der Bestellung neben dem normalen EMail-Versand auch der Versand per XML zur Verfügung. D.h. um die Bestellung im für Farnell lesbaren Format (OpenTrans1.0) zu senden, klicken Sie bitte auf Mit XML senden. Das bedeutet, dass wie bisher die Bestellung als PDF Datei an das EMail angefügt wird und zusätzlich die XML Datei als weitere Anhang dazugegeben wird. Beide Dateien werden auch in der Dokumentenablage dieser Bestellung abgelegt. Es sind dazu folgende Daten erforderlich:
Um die EMail-Adresse der Bestellung entsprechend vorzubesetzen, nutzen Sie bitte die Übersteuerungsmöglichkeit der Ansprechpartnerfunktion. Für die richtige Empfänger-EMail-Adresse stimmen Sie sich bitte mit Ihrem Lieferanten ab. Für dien Test der Funktion sollte eine EMail-Adresse verwendet werden, die auch von Ihrem Lieferanten klar als Test deklariert ist.
Wie oben beschrieben werden bei Preisänderung zur Dokumentation der Preisentwicklung neue Gültig ab Einträge angelegt.
In der Farnell Schnittstelle werden zwei Informationen übergeben. Einerseits der aktuelle Lagerstand und andererseits die Wiederschaffungszeit. Hier ist mit Wiederbeschaffungszeit jene Zeit (in Tagen) gemeint, die Farnell / das Werk benötigt um diesen Artikel wieder zu beschaffen.
Gerade im Handel sind die Übertragung der Artikel an die Kasse(n) und die Übernahme des Tagesprotokolls für die Verbrauchsbuchungen von der Kasse nach Kieselstein ERP vor allem zur Aktualisierung des Lagerstandes wesentlich. Sollten Sie weitere Schnittstellen / Funktionen benötigen, so bitten wir um Ihre Anfrage. Wir unterstützen Sie gerne.
Die Schnittstelle zu Gastrosoft besteht im wesentlichen aus zwei Teilen: a.) Export der Artikel mit Beschreibungen und Verkaufspreisen. Dies wird durch eine spezielle Preisliste aus dem Artikelstamm realisiert, mit der die Daten im XLS Format übergeben werden. b.) CSV-Kassenimport Diesen Import finden Sie im Modul Los, Menü Los -> Import -> CSV-Kassenimport. Auswahl eines Ordners, in dem die zu importierenden CSV-Dateien abgelegt sind. Es werden alle CSV-Dateien darin berücksichtigt.
Folgende Spalten werden benötigt:
Es wird jede Datei nacheinander manuell importiert. Es empfiehlt sich vor dem Import eine Prüfung zu machen. Etwaige Fehler werden im Importfenster aufgelistet. Wenn es eine spezielle Zeile betrifft mit Zeilennummer. Es wird davon ausgegangen, dass es pro Tagesabschluss eine Datei gibt. Es wird für jeden Dateiimport ein neues Los als freie Materialliste angelegt, mit dem Abschlussdatum des ersten Artikels des Imports als Beginn- und Ende-Datum. Im Projektfeld wird der Tagesabschluss textuell erfasst. Kostenstelle (mit definiertem Sachkonto), Fertigungsgruppe, Montageart muss gegeben sein. Es wird davon jeweils die 1. verwendet. Als Loslager wird jenes mit niedriegstem Loslager-Sort verwendet.
Jede Zeile (also jeder Artikel) wird als Lossollmaterial im Los angelegt. Ist der E-Preis eines Artikels negativ, wird das Sollmaterial als Lagerzugang gebucht, d.h. die angegebene Menge wird mit negativem Vorzeichen berücksichtigt. Ist ein Artikel lagerbewirtschaft, muss genügend im Lager verfügbar sein. Ist keine Artikelnummer angegeben, wird jene Artikelnummer für diese Zeile verwendet, die über den Mandantenparameter KASSENIMPORT_LEERE_ARTIKELNUMMER_DEFAULT_ARTIKEL definiert wurde. Im Kommentarfeld des Sollmaterials wird die Rech.-Nr., der G-Preis und die Zahlungsart geschrieben. Zusätzlich wird bei Verwendung des Defaultartikels die PLU und Artikelbezeichnung hinzugefügt.
Ist ein zu importierender Artikel ein Setartikel, so wird nicht der Artikel selbst, sondern seine Positionen als Lossollmaterial importiert. Die Menge in der Setartikelposition wirkt dabei als Faktor zur Menge aus dem CSV. Als Text des Kommentars wird neben der Rech.Nr., G-Preis und Zahlungsart auch angegegeben aus welchem Setartikel dieses Lossollmaterial ein Bestandteil war.
Beginnt die Hauptwarengruppe mit “Pfand” (Groß-/Kleinschreibung nicht relevant), so werden diese Artikel beim Import nicht berücksichtigt.
Mögliche Fehlerfälle sind:
[Siehe bitte]Linktext
[Siehe bitte]Linktext
Manche Anwender sind der Meinung, dass MES Systeme an Kieselstein ERP angebunden werden sollten. Manchmal gibt es auch die Situation dass verschiedene Maschinenhersteller die erforderlichen Kommunikationsdaten nicht bzw. nur gegen Einsatz von sehr viel Geld, herausgeben.
Auch wenn wir der Meinung sind, dass eine direkte Integration der vollständigen Fertigungssteuerung in Kieselstein ERP deutliche Vorteile bringt, die Komplexität und Mühsamkeit der Abstimmung bestätigt dies, so unterstützen wir unsere Kieselstein ERP Anwender selbstverständlich auch in diesen Dingen.
Mit der Hydra-Schnittstelle wurde eine bidirektionale Verbindung zwischen den Losen aus Kieselstein ERP und den (Fertigungs-) Aufträgen von Hydra geschaffen. Bitte beachten Sie bei der Definition Ihrer Kieselstein ERP Daten die zahlreichen Beschränkungen die durch das Hydra System grundsätzlich gegeben sind.
Nachfolgend eine kompakte Beschreibung zur Verbindung mit dem Hydra System. Für weitere Details wenden Sie sich bitte vertrauensvoll an Ihren Kieselstein ERP Betreuer.
Das Hydra-Microservice läuft als eigenständiger HTTP-Server (Host + Port in Mandantenparameter HYDRA_SERVER definieren), idealerweise direkt auf dem Rechner auf dem auch Ihr Hydraserver läuft. Wechselt ein Los in den Status “In Produktion” und entspricht es weiteren Hydra-Kriterien, wird die Ausgabe per HTTP-POST dem Microservice bekanntgegeben. Folgende Kriterien müssen dabei erfüllt werden:
Das Hydra-Microservice holt sich daraufhin selbständig über die Rest-API alle Daten des Loss und wandelt die erhaltenen Daten in die vorgegebene Hydra-Datenstruktur als Hydra-Auftragsdaten um. Diese beinhalten derzeit drei verschiedene Daten-Segmente:
Pro Los erzeugt das Microservice somit eine temporäre Datei mit den zugehörigen Hydra-Auftragsdaten. Hydra nimmt die Daten über eine definierte Zieldatei entgegen, die von beiden Systemen (Hydra, Microservice) erreichbar ist. Ist diese Zieldatei nicht vorhanden (= Hydra hat die letzte eingelesen bzw. übernommen), schreibt das Microservice eine neue und fasst damit alle bis dahin erzeugten temporären Auftragsdaten darin zusammen und stellt sie so Hydra wieder zur Verfügung.
Mit dem Zusatzservice HV-EST, HELIUM V Exchange Synchronisations Tool, können die Daten aus Ihrem Partnerstamm nach Exchange übertragen werden. Im wesentlichen werden hier die Firmen, Ansprechpartner mit deren Adressdaten, sowie Telefonnummern und EMailadressen in einer strukturierten Form in die zentralen Adressdaten des Exchange (LDap-Verzeichnis) importiert. Der Import ist so aufgebaut, dass portionsweise die Adressen vom HELIUM V Exchange Synchronisations Tool vom Kieselstein ERP Server abgeholt und in das Exchange übertragen werden. Da Exchange nur auf Microsoft-Betriebssystemen zur Verfügung steht, ist die HV-EST auch ein Windows-Programm.
Die Gliederung / Erkennung ob eine Partneradresse eine Firma oder ein Ansprechpartner einer Firma ist, erfolgt daran, wenn eine Adresse ein Ansprechpartner einer Firma ist, so wird dies in dieser Struktur im Exchange abgelegt. Ist eine Adresse nicht Mitglied / Ansprechpartner einer anderen Adresse wird dies als reine Firmenadresse betrachtet. Zusätzlich werden die übertragenen Adressen gegenseitig gekennzeichnet, sodass Änderungen in Ihren Kieselstein ERP Adressdaten beim nächsten Lauf im Exchange aktualisiert werden. Da dieser Dienst, wie beschrieben, immer nur Teile überträgt, kann es, je nach Umfang, einige Zeit dauern, bis die Daten synchron sind.
Bitte beachten Sie, dass aufgrund dessen, dass nur Adressdaten übertragen werden, keine wie immer geartete Unterscheidung zwischen den Mandanten gemacht werden kann.
Mit dem Zusatzprogramm HV-OST, HELIUM V Outlook Synchronisations Tool, können die Daten aus Ihrem Partnerstamm über Office365 nach Outlook übertragen werden. Die Einrichtung dieser Funktion setzt administrative Rechte für Ihren Office365 Zugang voraus. Das entsprechende Programm (HV-OST.exe) fordern Sie bitte mit der genauen Einrichtungsbeschreibung bei Ihrem Kieselstein ERP Betreuer an. Die Verbindung zwischen Kieselstein ERP und Ihrem Office365 Adressbuch stellt die im Personal des jeweiligen Benutzers eingerichtete EMail-Adresse dar. Es werden die Kontaktdaten anhand folgender Logik ermittelt: Projekte in denen der Benutzer als Mitarbeiter oder als “wird durchgeführt von” im Detail eingetragen ist. Angebote in denen der Benutzer der Vertreter ist Aufträge in denen der Benutzer als Vertreter oder Auftragsteilnehmer eingetragen ist Rechnungen in denen der Benutzer als Vertreter eingetragen ist. Kunden in denen der Benutzer als Provisionsempfänger oder als Sachbearbeiter eingetragen ist.
Bitte beachten Sie auch den Personal-Parameter Alle Kontakte synchronisieren. Mit diesem werden, entgegen obiger Logik, alle Partner in Ihre Outlook-Kontakte übertragen.
Nachfolgend eine Sammlung von nützlichen / wichtigen Informationen rund um das Thema Webshop.
Zum Thema CleverCure siehe bitte
Mit der Lieferung an Endkunden (B2C Geschäft) im EU Ausland sind je nach Empfänger-Land verschiedene Lieferschwellen verbunden, bei denen Sie gezwungen werden, die Umsatzsteuer mit dem Steuersatz des Empfängerlandes anzugeben und auch die einbehaltene Umsatzsteuer beim jeweiligen Empfängerfinanzamt abzuführen.
Dies betrifft nur die Umsätze mit Endkunden. Für die Umsätze zwischen Unternehmen (B2B) gilt die Regelung der innergemeinschaftlichen Lieferungen.
Das bedeutet wiederum, dass es für Neukunden im Webshop wichtig ist, dass dieser seine UID-Nummer angibt.
Eine Aufstellung der Lieferschwellen finden Sie z.B. im Portal der österreichischen Wirtschaftskammer.
In System - Parameter finden Sie den Parameter “KUNDESONDERKONDITIONEN_WEBSHOP_VERWENDEN”. Wenn Sie diesen Parameter auf 0 stellen, so werden die Kundensonderkonditionen nicht an den Webshop übermittelt. Bei 1 werden die Sonderkonditionen übermittelt.
Infos rund um CleverCure
Einlesen von Shopdaten in den Auftrag
Profirst Anbindung