Schnittstellen

• 1: CleverCure
• 2: Blech-Laser-Daten Schnittstellen
• 2.1: BLDS, Parametrierung
• 2.2: Blech-Laser-Daten-Schnittstelle: Einteilung der ERP-Felder für Import/Export
• 2.3: Strukturen in der Datenbank
• 2.4: Log-Modus für Webservice-Export
• 3: Edifact
• 4: Woo Commerce Import
• 5: Profirst Anbindung
• 6: Shopify

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'
...

1 - CleverCure

Eine Sammlung unserer Informationen rund um die EDI Schnittstelle CleverCure

Rest-Einsprungspunkt

Der Einsprungspunkt über das https: Protokoll (achte darauf, dass für den https-Port NUR dein externer Partner freigeschaltet ist) ist:
https://deine_externe_EP-Adresse/kieselstein-restapi/services/rest/api/beta/cc?companycode=nnnnn&token=tttttttttttt

• Companycode siehe
• token siehe

Error 417

Bedeutet, dass (noch) kein Versandweg eingetragen ist. Diesen nachtragen. Dabei darauf achten, dass in der lp_versandwegpartnercc und in der lp_versandwegpartner die gleiche Anzahl an Definitionen gegeben ist. Die jeweilige ID ist der gemeinsame Schlüssel.

select * from lp_versandwegpartnercc select lp_versandwegpartnercc.c_kundennummer, part_partner.c_uid, i_soko_adresstyp, * from lp_versandwegpartner inner join part_partner on lp_versandwegpartner.partner_i_id=part_partner.i_id left outer join lp_versandwegpartnercc on lp_versandwegpartnercc.i_id=lp_versandwegpartner.i_id order by part_partner.c_kbez

• Üblicherweise per Hand die neue ID in der lp_versandwegpartner nachtragen
• Irgendwie spielen da die UID Nummern auch noch mit, zumindest für die Zuordnungen
• Knd Lieferantennummer = Werkskennung
• Verkettung im lp_versandwegpartner
• Es muss die Lieferadresse zugeordnet werden

Auftrag xxx existiert bereits

Diese Fehlermeldung (Error 417) kann leider auch bedeuten, dass ein Auftrag mit dieser Bestellnummer bereits in deinem Kieselstein ERP angelegt ist.

• Im Tomcat-Log findest du dazu “nur”

IP-Adresse - - [14/Sep/2023:16:15:05 +0200] “POST /kieselstein-rest/services/rest/api/beta/cc?companycode=12345&token=20ETMCCMVH13 HTTP/1.1” 417 -
Wichtig ist hier der Zeitpunkt.

• Im server.log findest du dazu:

2023-09-14 16:15:05,665 WARN [com.lp.server.auftrag.ejbfac.WebshopOrderServiceEjb] (default task-3) Der Auftrag ‘JJ/nnnnnnn’ existiert mit der Bestellnummer ‘xxxxxxxx’. Kein weiterer Auftrag angelegt!

Das bedeutet nichts anderes, dass versucht wurde einen Auftrag erneut einzuspielen, obwohl dieser bereits übermittelt wurde.
Info: Die Schnittstelle ist so vereinbart, dass einmal übertragene Aufträge vom CleverCure-Sender nicht mehr geändert werden dürfen.
Warum? Wie willst du denn deine Fertigung steuern, wenn dir der Kunde laufend die Auftragsdaten verändert?

zu klären

Werden versteckte Artikel trotzdem in die AB übernommen, oder kommt deswegen ein Fehler, weil nicht ordentlich unterstützt?

Anbindung Clever Cure

Mit der Anbindung an CleverCure (siehe dazu auch CureComp.com) wurde eine praktische Schnittstelle für einen Teil der Supplychain geschaffen.

Die im Wesentlichen abgebildeten Funktionen sind:

• Übertragen einer Bestellung aus dem Kundensystem in Ihr Kieselstein ERP
• Senden der Auftragsbestätigung aus Ihrem Kieselstein ERP an den Kunden
• Senden eines Lieferavisos

Voraussetzungen: (Konfiguration siehe unten)

• Kieselstein ERP Webservices
• Kieselstein ERP RestAPI Server
• HTTPS Zugang bidirektional, abgesichert durch Zertifikate. Eine entsprechende Parametrierung der Firewall ist erforderlich.
• Parameterdaten wie Kundennummern, Lieferantennummern usw.
• Kunden-Sonderkonditionen zur Pflege der Kundenartikelnummern

Ablauf:

Nach erfolgter Parametrierung und Einrichtung des Systems sieht der Ablauf wie folgt aus:

1. Vom Kundensystem wird eine Bestellung mit Auftrags-, Rechnungs- und Lieferadresse und den inhaltlichen Positionen gesandt. Von der Kieselstein ERP CleverCure Schnittstelle werden diese Daten, soweit sie technisch (Achtung: Nicht inhaltlich) in Ordnung sind, gültig entgegengenommen.

2. Diese Daten werden konvertiert und als Auftragsbestätigung in Ihrem Kieselstein ERP angelegt. Zugleich wird ein E-Mail an den CleverCure E-Mail-Empfänger über den Auftragseingang gesandt. Details zur Datenzuordnung siehe unten.

3. Von Ihnen wird die Auftragsbestätigung geprüft und gegebenenfalls korrigiert. Bitte achten Sie darauf, dass –> Positionensplitt ….

4. Drucken Sie nun die Auftragsbestätigung, zumindest in die Vorschau, aus. Entspricht die AB Ihren Vorstellungen, so

5. senden Sie diese per CleverCure an Ihren Kunden, durch Klick auf den Knopf Auftrag übermitteln in den Auftrags-Kopfdaten. Wurden bereits Daten an Ihren Kunden gesandt, so:

   • wird dies durch einen grünen Hintergrund im Knopf angezeigt und der Zeitpunkt des Versands wird in der Fußzeile angezeigt.
   • sollte die Auftragsbestätigung erneut an den Kunden gesandt werden, so wird nach dem Klick auf den Auftrag übermitteln Knopf die Meldung    angezeigt, welche mit Ja bestätigt werden muss. Bitte beachten Sie, dass damit eine entsprechende Änderung der Auftragsdaten auch bei Ihrem Kunden vorgenommen wird. Info: Neben den üblichen Daten aus Kieselstein ERP wird auch das Ursprungsland, welches im jeweiligen Artikel hinterlegt ist, in der Auftragsbestätigung mit zurückgesandt.

6. Nach erfolgter Beschaffung / Produktion erfolgt die Lieferung der Ware, in der in Kieselstein ERP üblichen Art und Weise, Auftragsbezogener Lieferschein, Sicht Auftrag.

7. Ist die Lieferung fertig zusammengestellt und der Lieferschein ausgedruckt, so senden Sie Ihrem Kunden eine Lieferaviso. Klicken Sie dazu im Lieferschein, Kopfdaten auf Lieferaviso übermitteln . Auch hier gilt, wenn ein Lieferaviso bereits versandt wurde, wird dies durch den grünen Hintergrund im Lieferaviso Knopf angezeigt. Auch das Lieferaviso kann erneut versandt werden.

Zuordnung der Daten zwischen CleverCure und Kieselstein ERP

Infos / Fehlermeldungen beim Auftragsimport:

Werden Unstimmigkeiten zwischen den in Ihrem System hinterlegten Daten und den erhaltenen Daten festgestellt, so werden entsprechende Info: Texteingaben in die Auftragsbestätigung vor der jeweiligen Ident/Handeingabe eingefügt. Prüfen Sie diese Fehler, beseitigen Sie diese im Auftrag und vor allem in der Definition Ihrer Daten. So erhalten Sie sehr rasch ein zu / mit Ihrem Kunden abgestimmtes System.

Ein Beispiel hierfür ist, dass eine Artikelnummer in Kieselstein ERP gefunden wird, aber keine der CC-Bestellung entsprechende Revisionsnummer vorhanden ist. Diese Information wird als Texteingabe in den Auftrag geschrieben. Eine Vorgehensweise dazu wäre, dass Sie nun einen neuen Artikel anlegen mit der aktuellen Revisionsnummer und diesen in der Position im Auftrag abändern.

Wenn eine Position (Ident) über die Sonderkonditionen nicht gefunden wird, so wird nach der Artikelnummer gesucht, wenn auch hier keine Übereinstimmung besteht, so wird eine neue Position mit der Art Handeingabe angelegt, die alle Informationen zur Bestellposition enthält (Bezeichnung, Menge, Mengeneinheit, LINE_ITEM_ID, Mwst-Sätze, gesuchte Artikelnummer).

Wenn keine Preise/Verkaufspreisbasis für einen Artikel hinterlegt sind, wird der Betrag “0.00” für die Auftragsposition verwendet. Zusätzlich gibt es eine Textposition mit der Mitteilung, dass der Preis nicht ermittelt werden konnte und deshalb auf 0 gestellt wurde.

ACHTUNG: Die LINE_ITEM_ID muss in jeder Position des Auftrags als Texteingabe in folgender Form {“lineitemid” : “1”} enthalten sein! Verwenden Sie für die Umwandelung einer Handeingabe in einen Artikel den Menüpunkt Bearbeiten, Handartikel in Artikel umwandeln, so bleibt diese Information erhalten.

Welche Daten werden von der Schnittstelle in der Dokumentenablage des jeweiligen Auftrages abgelegt?

• Import Clevercure XML Import_Clevercure
  Dies sind die Originaldaten, die Kieselstein ERP von CleverCure erhalten hat

• Export Clevercure XML Auftragbestätigung_osa_Clevercure
  Diese Daten wurden als Auftragsbestätigung an CleverCure gesandt

Daten, die zum Export des Lieferavisos abgelegt werden sind:

• Export Clevercure XML Lieferaviso_Clevercure
  Diese Daten wurden als Lieferaviso an CleverCure gesandt

Ergänzende Infos in den Formularen zu CleverCure

• Auftragsbestätigung

  Parameter java.lang.String P_VERSANDWEG_BESTAETIGUNG_TERMIN, der Zeitpunkt (Datum&Uhrzeit) an dem die Bestätigung gesendet wurde als Datum formatiert. Null wenn noch nicht bestätigt Parameter java.lang.Boolean P_VERSANDWEG, “true” wenn für diesen Auftrag ein Versandweg (Clevercure) festgelegt ist, “false” wenn nicht

• Lieferschein

  Parameter java.lang.String P_VERSANDWEG_AVISO_TERMIN, der Zeitpunkt (Datum&Uhrzeit) an dem das Aviso gesendet wurde als Datum formatiert. Null wenn noch nicht avisiert

  Parameter java.lang.Boolean P_VERSANDWEG, “true” wenn für diesen Auftrag ein Versandweg (Clevercure) festgelegt ist, “false” wenn nicht

  Feld java.lang.String F_AUFTRAG_BESTAETIGUNG_TERMIN der Zeitpunkt (Datum&Uhrzeit) an dem die Bestätigung gesendet wurde als Datum formatiert. Null wenn noch nicht bestätigt

  Feld java.lang.BOOLEAN F_AUFTRAG_VERSANDWEG “true” wenn für diesen Auftrag ein Versandweg (Clevercure) festgelegt worden ist, ansonsten “false”

Konfiguration zu Beginn

• Kieselstein ERP Webservices
• Kieselstein ERP RestAPI Server

Sind beide in der Standard-Installation von Kieselstein ERP enthalten.

Siehe Grundeinstellung und Definition RestAPI

Zusätzlich gibt es einen Kieselstein ERP Benutzer, der die Interaktion von Kieselstein ERP und dem RestAPI-Webserver durchführt. Dieser muss auf beiden Seiten definiert werden. 

Im Tomcat passen Sie die Definition restapi.xml nach folgendem Vorbild an:

Weitere Definitionen in Kieselstein ERP

Legen Sie dazu im Modul Benutzer einen neuen Benutzer an und geben Sie ihm eine Benutzerrolle und hinterlegen den Mandanten. Die Benutzerrolle muss die Rechte AUFT_AUFTRAG_CUD, AUFT_AUFTRAG_R,  PART_LIEFERANT_R, PART_PARTNER_R, WW_ARTIKEL_R besitzen. Hinterlegen Sie beim Benutzer je nach Anforderung eine neue Person (Modul Personal Neu) oder eine bestehende. 

Geben Sie im Modul Personal oberer Reiter Daten jene E-Mail Adresse ein, an die eine Nachricht gesendet wird, wenn in Kieselstein ERP ein neuer Auftrag angelegt wurde. Um die Nachricht an mehrere E-Mail Adressen zu verschicken, geben Sie die Adressen mit einem Semikolon (;) getrennt ein.

Im oberen Reiter Detail muss im Feld Ausweis die Identifikationsnummer für das Clevercure-Portal eingegeben werden.

Im Modul Artikel unterer Reiter Grunddaten legen Sie im oberen Reiter Webshop einen neuen Webshop an. Der Name muss ebenso der Definition im restapi.xml entsprechen.

Im Modul System unterer Reiter Sprache, oberer Reiter Einheiten legen Sie die Einheiten PCE (Stück) und KGM (kg) an. Bitte bedenken Sie, falls weitere Übersetzungen der Einheiten aus der Auftragsübermittlung nötig sind, diese hier anzulegen.

HTTPS Zugang bidirektional, abgesichert durch Zertifikate. Eine entsprechende Parametrierung der Firewall ist erforderlich.

Parameterdaten wie Kundennummern, Lieferantennummern usw.

Für die Definition, für welche Kunden Sie die Clevercure-Schnittstelle verwenden, wenden Sie sich dazu derzeit an Ihren Kieselstein ERP Betreuer. 

Für die Definition im Clevercure-Portal, für welchen Kunden Sie eine Auftragsbestätigung/Lieferaviso schicken, geben Sie im Modul Kunde, oberer Reiter Konditionen Ihre eigene Kundennummer im Feld Lieferantennummer ein. 

Kunden-Sonderkonditionen zur Pflege der Kundenartikelnummern

Tragen Sie die Artikelnummern für die Kunden jeweils im Modul Kunde - oberer Reiter Sonderkondition ein. Klicken Sie dazu auf neu, wählen Ihren Artikel aus und geben die kundenspezifische Ident ein. Achtung: Beachten Sie das Feld Gültig ab und tragen hier das gewünschte Datum ein. Zusätzlich definieren Sie im Modul Artikel bei diesem Artikel die Revisions-Nummer.

VMI Artikel

Es kommt immer wieder die Frage, wie ist im Rahmen von CleverCure mit den VMI Artikel (Vendor Managed Inventory) umzugehen. Die Antwort dazu ist eigentlich, es ist dies durch entsprechende Verträge zu regeln. Die Bedeutung von VMI ist im Sinne von CleverCure, dass Artikel quasi sofort, spätestens am nächsten Tag geliefert werden müssen. Da bedingt, dass Sie als Lieferant an Ihren CleverCure Kunden wissen müssen, welche Artikel das sind. Sie müssen auch wissen, welche Menge Sie zu bevorraten haben. Sind diese Artikel, durch Ihren Kunden, definiert so müssen im Kieselstein ERP entsprechende Lagermindeststände dafür hinterlegt werden, damit Sie immer lieferfähig sind. Kommt nun ein neuer/zusätzlicher Artikel, aus dem Sinne des VMI über die Schnittstelle, so bedeutet dies nur, dass dieser Artikel nicht Vertragsbestandteil der VMI Vereinbarung ist. D.h. es hätte Ihnen Ihr Kunde rechtzeitig mitteilen müssen, dass er einen weiteren Artikel in die VMI Logik mit aufnimmt. In diesem Falle muss die weitere Vorgehensweise direkt (telefonisch) mit Ihrem Kunden geklärt werden. Dass Sie natürlich versuchen den Kunden entsprechend rasch zu beliefern, ist für alle Beteiligten sicherlich nachvollziehbar.

2 - Blech-Laser-Daten Schnittstellen

Mit der Funktionalität der Blech-Laser-Daten Schnittstellen (kurz BLDS) steht eine komfortable Anbindung an verschiedene Systeme zur Verfügung.

In gewissen Grenzen kann bei diesen Schnittstellen, dass Austauschformat frei definiert werden.

Aktuell wurden damit die nachfolgend aufgeführten Anbindungen umgesetzt.
Weitere Anbindungen auch mit einer entsprechend breiteren Datenbasis können nach ausführlicher Spezifikation umgesetzt werden.

Damit die BLDS(Blech-Laser-Daten Schnittstelle) funktioniert muss die Zusatzfunktionsberechtigung TRUTOPS_BOOST aktiviert sein.

• Ergänzend siehe dazu auch
• Automatikjob Export-Schnittstellen
• Automatikjob Import-Schnittstellen

Bei der Definition der Datenübergaben wird auch immer von Import und Export gesprochen.
Beachte bitte, dass dies immer aus Sicht deines Kieselstein-Servers zu sehen ist. D.h. wenn du Daten z.B. aus deinen Losen an das andere (MES) System senden möchtest, ist dies aus Sicht der BLDS ein Export. Diese Daten werden dann vom anderen System importiert.

Vorgehensweise für die Definition der Export- und Importfunktionen

Die Definition der Export- bzw. Importfunktionen erfolgt in zwei Schritten:

• a.) Anlegen der Datenstruktur(en) mit eventuellem Werte-Mapping
• b.) Festlegen der Kommunikationsarten und Pfade

Editor

Die BLDS kommt ab der Version Kieselstein ERP Version 1.1.2 auch mit einem Editor, mit dem die Parametrierung durchgeführt werden kann.
Voraussetzung ist, dass die oben genannte Zusatzfunktionsberechtigung (TRUTOPS_BOOST) aktiviert ist. Weiters steht dieser Editor nur für den Admin zur Verfügung.

Der Editor gliedert sich in zwei Bereiche.

• a.) Definition der Datenstrukturen
• b.) Definition der Kommunikationspfade

Du findest diesen im Modul System, unterer Reiter Datenstruktur bzw. BLDS.

Datenstruktur

Um die verschiedensten Daten in der eigentlichen Definition der BLDS(Editor) verwenden zu können, müssen diese definiert werden. Diese werden im Modul System im unteren Modulreiter Datenstruktur definiert.

D.h. hier wird die Zusammenstellung / Übersetzung der ERP-Felder in die Werte(-Strukturen) des Zielsystems definiert.

Festlegen der Quelle / des Bereiches der Daten

Im Reiter Detail muss mit Bereich ausgewählt werden welche Daten verarbeitet werden sollten. Je nach Bereich stehen unterschiedliche ERP-Felder zur Verfügung.
Aktuell gibt es folgende Bereiche:

• ww_artikel
• fert_losarbeitsplan
• fert_lossollmaterial

Wichtig: Mit dem Bereich wird bestimmt welche Daten für den Export zur Verfügung stehen.

Struktur des Datenexportes

Im Reiter Struktur definierst du nun wie deine Daten zusammengestellt werden.
Vom Grundgedanken her wird von einer XML Struktur ausgegangen. D.h. du definierst wie sich der XML-Baum zusammensetzt und welche Felder aus deinen Los- / Artikeldaten in welche Felder der XML Definitionen übertragen werden.
Das könnte z.B. wie folgt aussehen:

Zusätzlich steht noch das Mapping zur Verfügung.

Der technische Aufbau

Siehe bitte

In anderen Worten

Der Trick liegt darin, dass der XML Baum für jedes XML-Feld (jeden XML Wert) in c_list_item_pfad eingetragen wird, wobei immer der gesamte Baum abzubilden ist und jeder weitere Ast(Verzweigung) mit einem / beginnt. Somit kann die gewünschte XML Struktur dargestellt werden.

Blech-Laser-Daten Schnittstelle

Hat man nun die gewünschten Datenstrukturen definiert, so wird im unteren Modulreiter “BLDS” die Art der Datenübertragung definiert.
Mit neu wird eine Neue Definition angelegt und im Reiter Detail definiert.

Bitte beachte, dass nur Datenstrukturen ausgewählt werden können, welche noch keine Export/Import-Definition hinterlegt haben.

Es gibt folgende Auslöser

Auslöser	Bemerkung
Los_Ausgabe
Los_Anlage
SHOP_TIMER	Automatikjob, Export bzw. Import Schnittstellen
REST_CALL	Generieren der Daten auf Anforderung durch einen RestCall. [Siehe???]

Bitte beachte die Filterart. D.h. es wird mit der Filterart entschieden, ob alle Materialartikel aus dem Los übergeben werden, oder ob nur die Artikel übergeben werden, bei denen eine Artikelklasse hinterlegt ist, bei der TOPS angehakt ist.
Solltes du von früheren Installationen kommen, muss eventuell die Filterart angepasst werden.

Leeren des Protokolls

Um die Protokolldatei der BLDS zu leeren, kannst du z.B. folgendes Script verwenden.

delete from lp_sst_lauf 
where extract(day from now() - t_zeitstempel_ende) >62;

Damit werden alle Einträge die älter als 62Tage sind gelöscht.

Verfügbare Anbindungen

Trumpf

Übergabe der Los und Artikeldaten, inkl. der dazugehörenden Zeichnungen an das Lasersystem der Firma Trumpf.

Damit verbunden das Rücklesen der Gestehungspreise der gelaserten / zu lasernden Teile

Die Blech-Laser-Daten Schnittstelle im Client

Aktivierung der BLDS und der Datenstrukturen im Client

Damit im Client die Möglichkeit besteht, die BLDS zu konfigurieren, muss die Zusatzfunktion “TRUTOPS_BOOST” aktiviert werden.
Pro Mandant (mandant_c_nr) muss der Wert “TRUTOPS_BOOST” (zusatzfunktion_c_nr) in der Tabelle ’lp_zusatzfunktionberechtigung’ hinzugefügt werden. Dies erfolgt wie gewohnt direkt in der Datenbank.

Konfigurationsablauf im Client

Damit man eine BLDS erstellen kann, benötigt man zunächst eine Datenstruktur und ein oder mehrere Datenstrukturfelder, die verknüpft werden müssen.

Dazu findet man die jeweiligen Reiter im System die jeweiligen Untermenupunkte.

Optional kann man sich bereits ein Mapping erstellen und ein paar Mappingfelder hinzufügen, um bestimmte Felder aus einem XML-File-Attribut auf einen anderen Wert zu ändern. Dieses Mapping kann dann diesem bestimmten Datenstrukturfeld zugewiesen werden.
Wichtig: Bei der Wahl des c_bereich der Datenstruktur ist darauf zu achten, dass dieser nur für eine BLDS mit dem gleichen Bereich verwendet werden kann.

Bei der Wahl der Datenstrukturfelder unbedingt berücksichtigen, dass bestimmte “erp_feld”-Einträge nur für Import und andere für Export zur Verfügung stehen. Sollte man Werte für den Export verwenden, die nur für den Import unterstützt werden oder umgekehrt, werden diese Felder ignoriert und nicht eingelesen oder ausgelesen. Eine genaue Auflistung befindet sich im Untermenupunkt Einteilung der ERP-Felder für Import/Export.
Sobald eine gültige Datenstruktur und beliebige Datenstrukturfelder verknüpft sind, kann man im Untermenupunkt ‘BLDS’ einen neuen Eintrag erstellen und mit der vorherigen Datenstruktur verknüpfen.

——— Old

Die Generische Schnittstelle und ihre Anwendungsbereiche

Allgemein

Die generische Schnittstelle definiert, wie eine bestimmte Datenstruktur “verwendet” werden kann, um einen Datenaustausch zu gewährleisten. Dies kann sowohl für eine Maschinenanbindung in Form von XML sein als auch zum Austausch bestimmter Daten mit anderen Fremdsystemen.

Beim Import:
Hier wird die verknüpfte Datenstruktur als Vorlage für das Auslesen einer Datei verwendet. In den jeweiligen Datenstrukturfeldern wird definiert, wo der jeweilige Wert z.B. in der XML-Datei zu finden ist (‘c_pfad’) und wohin im Kieselstein ERP der Wert gespeichert werden soll (’erp_feld’).

Beim Export:
Hier wird die verknüpfte Datenstruktur als Vorlage für die Erstellung einer Datei verwendet. In den jeweiligen Datenstrukturfeldern wird definiert, wo alle konfigurierten Werte (’erp_feld’) aus dem Kieselstein ERP in die Datei geschrieben werden müssen (‘c_pfad’). Alle Datenstrukturfelder mit gleichen Elternknoten (‘c_pfad’) werden zusammengefasst und verschachtelt.

Somit können beliebige Daten (nur begrenzt durch die aktuelle Auswahlmöglichkeiten an ERP-Feldern) aus dem Kieselstein ERP und Fixwerte in ausgewählte Datenformate (aktuell verfügbar: nur XML aber weitere Formate modular erweiterbar) als Dateien exportiert oder importiert werden. Spätere Anpassungen für bestimmte Anbindungen können direkt über den Client umgesetzt werden.

Aktuelle Einschränkungen

• Es gibt noch keine Authentifizierungsmöglichkeit bei der REST-Anbindung
• Es gibt beim Export großer Datenmengen noch keinen Paging-Mechanismus. Sollten gewisse Timeouts passieren, kann man diese aktuell nur durch Anpassung der Timeouts im System regulieren.
• Das Logging der generischen Schnittstelle kann aktuell nur direkt aus der Datenbank ausgelesen werden. Einfach in ’lp_sst_lauf’ nach der ‘sst_id’ des gesuchten generischen Schnittstelleneintrags suchen und dann sollte man die bisherigen Durchläufe und deren Status sehen. Sollte hier ein Fehler passiert sein sollte der Status + Fehlermeldung hier ersichtlich sein.

Anzeige des Protokolls

In der Übersicht der generischen Schnittstelle

erhältst du durch Klick auf den Button Auswahlliste Anzeigen, auch eine Übersicht über alle Einträge in der Protokollierung der Kommunikation.

Eventuelle Fehler werden rot hinterlegt angezeigt.

2.1 - BLDS, Parametrierung

Nachfolgend eine Beschreibung, wie man die BLDS parametrieren kann.

Das Ziel ist, die Dateistruktur für den Export (für den Import siehe) entsprechend der Vorgaben des Zielsystems zusammenzustellen.

Idealerweise bekommst du dafür eine Musterdatei welche am Zielsystem eingelesen werden kann.

Hinweis:
Die nachfolgende Beschreibung geht immer anhand einer Filestruktur vor. Egal ob dies dann tatsächlich in einer Datei mündet, oder z.B. per RestAPI an einen Endpunkt gesandt wird.

Die für die Parametrierung erforderlichen Einstellungen findest du im Modul System.
Diese teilen sich in die grundsätzliche Beschreibung der Datenstruktur, siehe unterer Modulreiter Datenstruktur und in die eigentliche BLDS, in der die Abarbeitung definiert wird.

Definition der Datenstruktur

Im Reiter Datenstruktur definierst du den grundsätzlichen Aufbau für die verschiedenen Exportdateien, welche erzeugt werden sollten.
Je Export- bzw. Importdatei muss eine eigene Definition angelegt werden.

Der ItemPfad wird nur für den Import benötigt.

Die Export-Dateien werden auf den unter Quellname in der BLDS angegebenen Basispfad exportiert.

Für eventuelle Daten-Übersetzungen siehe Mapping.

Definition Mapping

Hier ist die Idee, Werte entsprechend zu übersetzen. So können z.B. kryptische Fehlermeldungen in sprechende / Menschen lesbare Texte übersetzt werden.

Beispiel:

Die Verwendung des Mappings muss in der Definition der Datenstruktur unter Mapping angegeben werden, womit der aus dem ERP Feld erhaltene Wert durch das Mapping verändert wird, bzw. beim Import der Wert aus dem externen System in entsprechend Kieselstein ERP konforme Werte übersetzt wird.

Dateistruktur Export

c:\kieselstein\muster\Los@@LOS_CNR@@_@@ZEITSTEMPEL_STR1@@.xml

Dateistruktur Import

Mit der Funktionalität der BLDS steht eine komfortable Anbindung an die verschiedensten Systeme zur Verfügung.

Aktuell wurden damit die nachfolgend aufgeführten Anbindungen umgesetzt.
Weitere Anbindungen auch mit einer entsprechend breiteren Datenbasis können nach ausführlicher Spezifikation umgesetzt werden.

Damit die BLDS (Blech-Laser-Daten-Schnittstelle) funktioniert muss die Zusatzfunktionsberechtigung TRUTOPS_BOOST aktiviert sein.

• Ergänzend siehe dazu auch ( /fertigung/losverwaltung/trumpf_fab/ )
• Automatikjob Export-Schnittstellen
• Automatikjob Import-Schnittstellen

Editor

Die BLDS kommt ab der Version 1.0.27 auch mit einem Editor, mit dem die Parametrierung durchgeführt werden kann.
Voraussetzung ist, dass die oben genannte Zusatzfunktionsberechtigung (TRUTOPS_BOOST) aktiviert ist. Weiters steht dieser Editor nur für den Admin zur Verfügung.

Du findest diesen Editor im Modul System, unterer Reiter BLDS.

Es gibt folgende Auslöser

Datenstruktur

Um die verschiedensten Daten in der eigentlichen Definition der BLDS(Editor) verwenden zu können, müssen diese vorher definiert werden. Dafür kommt mit der Zusatzfunktionsberechtigung im System auch der untere Reiter Datenstruktur. Hier kannst du deine Datenstrukturen (beliebig) zusammenstellen.
D.h. mit

Aufbau

Der Grundgedanke der BLDS ist, dass damit, im Rahmen der vorhandenen Funktionen, die Kommunikation mit einem Fremdsystem sehr flexibel definiert ist.
Daher wurde die Kommunikation in Tabellen abgebildet.

Beispieldaten

lp_daten_struktur

lp_daten_struktur_feld

ERP Felder

To be described

lp_mapping

Die Beschreibung der Werte-Übersetzungen (Mappings).

lp_mapping_wert

lp_sst_parameter

lp_sst_lauf

Dazugehörende Parameter

Beispiel

Ein Beispiel wie alle Material-Nummern eines Loses als Los-Soll-Materialien hinterlegt werden.

Struktur:

INSERT INTO public.lp_daten_struktur(i_id, c_bezeichnung, c_bereich, c_list_item_pfad, c_default_datum_format, c_default_nummer_format, personal_i_id_anlegen, personal_i_id_aendern, t_anlegen, t_aendern) VALUES
(11, 'Los-Materialien', 'fert_lossollmaterial', 'Materialliste/Daten', NULL, NULL, 11, 11, '2025-01-09 12:51:11.581', '2025-01-09 12:51:11.581');

Struktur Felder:

INSERT INTO public.lp_daten_struktur_feld(i_id, struktur_daten_i_id, c_erp_feld, c_fix_wert, c_pfad, c_attribut_name, i_sort, c_format_maske, personal_i_id_anlegen, personal_i_id_aendern, t_anlegen, t_aendern, mapping_i_id) VALUES
(11, 11, 'LOS_ID', NULL, 'Materialliste/Los/Id', NULL, 1, NULL, 11, 11, '2025-01-15 11:53:24.295', '2025-01-15 11:53:24.295', NULL),
(12, 11, 'LOS_CNR', NULL, 'Materialliste/Los/CNr', NULL, 1, NULL, 11, 11, '2025-01-15 11:53:24.301', '2025-01-15 11:53:24.301', NULL),
(13, 11, 'ARTIKEL_CNR', NULL, 'Materialliste/Daten/Material/CNr', NULL, 2, NULL, 11, 11, '2025-01-15 11:53:24.306', '2025-01-15 11:53:24.306', NULL),
(14, 11, 'ARTIKEL_BEZEICHNUNG', NULL, 'Materialliste/Daten/Material/Caption', NULL, 2, NULL, 11, 11, '2025-01-15 11:53:24.306', '2025-01-15 11:53:24.306', NULL);

Ergebnis als XML-Datei:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Materialliste>
<Los\>
<Id\>16</Id>
<CNr>25/0000003</CNr>
</Los\>
<Daten>
<Material>
<Cnr>25711</Cnr>
<Caption\>Artikel Seitenblech 1</Caption\>
</Material>
<Material>

In anderen Worten

Der Trick liegt darin, dass der XML Baum für jedes XML-Feld (jeden XML Wert) in c_list_item_pfad eingetragen wird, wobei immer der gesamte Baum abzubilden ist und jeder weitere Ast(Verzweigung) mit einem / beginnt. Somit kann die gewünschte XMl Struktur dargestellt werden.

Verfügbare Anbindungen

Trumpf

Übergabe der Los und Artikeldaten, inkl. der dazugehörenden Zeichnungen an das Lasersystem der Firma Trumpf.

Damit verbunden das Rücklesen der Gestehungspreise der gelaserten / zu lasernden Teile

Wie bei Null beginnen?

1

Im lp_sst_parameter wird beschrieben welche Daten wohin exportiert werden. D.h. du brauchst zuerst einen gobalen Namen für deinen Export, dieser wird in der lp_daten_struktur angelegt. Hier wird im Bereich auch definiert, was exportiert werden sollte.

2.2 - Blech-Laser-Daten-Schnittstelle: Einteilung der ERP-Felder für Import/Export

ERP-Felder für Import/Export

Diese Felder gliedern sich einerseits in diejenigen die beim Import unterstützt werden und die die beim Export zur Verfügung stehen.

Beim Export werden diese noch in die verschiedenen Funktionsbereiche getrennt.

WICHTIG:
Welche ERP-Felder zur Verfügung stehen, wird auch vom Bereich definiert.
Der Bereich wird durch Anlage einer Datenstruktur-Definition im Reiter Detail definiert.

Für eine detaillierte Beschreibung der Bedeutung jedes einzelnen Feldes siehe bitte

Beim Import berücksichtigte Felder:

• LOSSOLLMATERIAL_ID
• LOS_ID
• LOS_CNR
• LOSSOLLMATERIAL_TRUTOPS_ORDERNO
• ARTIKEL_ID
• LOSSOLLMATERIAL_SORT
• LOSSOLLMATERIAL_TRUTOPS_EXPORT_ENDE
• LOSSOLLMATERIAL_TRUTOPS_EXPORT_FEHLER_CODE
• LOSSOLLMATERIAL_TRUTOPS_EXPORT_FEHLER_TEXT

Für den Export verfügbare Felder

Felder aus dem Bereich ww_artikel

• ZEITSTEMPEL_STR1
• @@IMPORT_ZEITSTEMPEL@@
• @@IMPORT_FILE_NAME@@
• ARTIKEL_ID
• ARTIKEL_CNR
• ARTIKEL_BEZEICHNUNG
• ARTIKEL_KURZ_BEZEICHNUNG
• ARTIKEL_TRUTOPS_NR
• ARTIKEL_MATERIAL_TRUTOPS_INFO
• ARTIKEL_TRUTOPS_METADATEN_PFAD
• ARTIKEL_TRUTOPS_METADATEN_HASH
• ARTIKEL_TRUTOPS_METADATEN_GROESSE
• ARTIKEL_TRUTOPS_METADATEN_ERSTELLT
• ARTIKEL_TRUTOPS_METADATEN_MODIFIZIERT
• ARTIKEL_TRUTOPS_EXPORT_ENDE
• ARTIKEL_TRUTOPS_FEHLER_CODE
• ARTIKEL_TRUTOPS_FEHLER_TEXT
• TRU_TOPS_LOG_MATERIAL_ARTIKEL_KURZBEZEICHNUNG
• TRU_TOPS_LOG_TEIL_GEWICHT
• TRU_TOPS_LOG_BEARBEITUNG_DAUER_MINUTE
• TRU_TOPS_LOG_LASERKOSTE_STUNDE
• TRU_TOPS_LOG_LAGER_ID
• TRU_TOPS_LOG_BREITE_ARTIKEL
• TRU_TOPS_LOG_LAENGE_ARTIKEL
• TRU_TOPS_LOG_HOEHE_ARTIKEL
• TRU_TOPS_LOG_MEHRVERBRAUCH_LASER_IN_MM

Felder aus BEREICH_LOS

Diese Felder stehen sowohl für den Bereich fert_lossollmaterial als auch fert_lossollarbeitsplan zur Verfügung.

• LOS_LOSGROESSE
• LOS_PRODUKTIONSBEGINN
• LOS_PRODUKTIONSENDE
• LOS_FERTIGUNGSGRUPPE
• LOS_MANDANT_CNR
• LOS_STUECKLISTE_ARTIKEL_CNR
• LOS_STUECKLISTE_ARTIKEL_BEZEICHNUNG
• LOS_TRUMPF_FAELLIG_DATUM

fert_lossollmaterial

• LOSSOLLMATERIAL_MENGE
• LOSSOLLMATERIAL_EINHEIT
• LOSSOLLMATERIAL_POSITION
• LOSSOLLMATERIAL_MONTAGEART
• LOSSOLLMATERIAL_ARTIKEL_CNR

fert_losarbeitsplan

• LOSARBEITSPLAN_ARBEITSGANGNUMMER
• LOSARBEITSPLAN_TATIGKEIT_BEZEICHNUNG
• LOSARBEITSPLAN_MASCHINE_IDENTIFIKATIONSNR
• LOSARBEITSPLAN_ARTIKEL_CNR
• LOSARBEITSPLAN_RUESTZEIT
• LOSARBEITSPLAN_STUECKZEIT
• LOSARBEITSPLAN_X_TEXT
• LOSARBEITSPLAN_KOMMENTAR

2.3 - Strukturen in der Datenbank

Der Grundgedanke der Blech-Laser-Daten-Schnittstelle ist, dass damit, im Rahmen der vorhandenen Funktionen, die Kommunikation mit einem Fremdsystem sehr flexibel definiert ist.
Daher wurde die Kommunikation in Tabellen abgebildet.

Strukturen in der Datenbank

Nachfolgend eine ergänzende Beschreibung des Aufbaues der Definition Datenstruktur.

Zusätzlich werden alle erfolgreichen Datenübertragungen protokolliert. Die Beschreibung der Felder findest du unter

Blech-Laser-Daten-Schnittstelle (lp_sst_parameter)

Wichtig: Wenn “Shop Timer” als Auslöser gewählt wird, gibt es im Tab “Automatik” für Export und Import 2 getrennte Parameter (Import Schnittstellen und Export Schnittstellen) um die Intervalle zu setzen.

Logging der Blech-Laser-Daten-Schnittstelle (lp_sst_lauf)

Jedes Mal, wenn ein Schnittstelleneintrag durch einen bestimmten Auslöser (Shop-Timer, Los-Ausgabe oder Rest-Endpunkt) gestartet wird, wird ein Loggingeintrag erstellt.
Am Ende wird ein Endzeitpunkt und der jeweilige Status gesetzt. Im Fehlerfall wird zusätzlich eine Fehlermeldung mitgeloggt.

Datenstruktur (lp_daten_struktur)

Definiert die Struktur der Dateninhalte, einschließlich der Informationen darüber, wie die Daten zu importieren bzw. exportieren sind, im Kontext der Kieselstein-Daten.
Aktuell werden die Datenstrukturen ausschließlich für die Blech-Laser-Daten-Schnittstelle.

Datenstrukturfeld (lp_daten_struktur_feld)

Eine Datenstruktur besteht aus beliebig vielen Datenstrukturfeldern, in denen genau definiert ist, wohin der Wert in der Dateistruktur geschrieben werden muss bzw. wo er in einer importierten Datei ausgelesen werden kann.
Alle Datenstrukturfelder einer Datenstruktur werden je nach Transfertyp (Export oder Import) in eine Datei geschrieben oder aus einer Datei gelesen.

Mapping (lp_mapping)

Die Mapping-Klasse ist eine Containerklasse mit einem sprechenden Namen (c_bezeichnung), zu der beliebig viele Mappingwerte verknüpft werden können. Eine Mapping-Klasse kann auch für mehrere Datenstrukturfelder verwendet werden, was sie besonders flexibel macht.

Mappingwerte (lp_mapping_wert)

Pro Datenstrukturfeld kann eine Mapping-Container-Klasse (1) verknüpft werden. Die eigentlichen Mappingwerte pro Feld sind in den beliebig vielen Mappingwerte-Einträgen zu finden.

Beispiel

Ein Beispiel wie alle Material-Nummern eines Loses als Los-Soll-Materialien hinterlegt werden.

Struktur:

INSERT INTO public.lp_daten_struktur(i_id, c_bezeichnung, c_bereich, c_list_item_pfad, c_default_datum_format, c_default_nummer_format, personal_i_id_anlegen, personal_i_id_aendern, t_anlegen, t_aendern) VALUES
(11, 'Los-Materialien', 'fert_lossollmaterial', 'Materialliste/Daten', NULL, NULL, 11, 11, '2025-01-09 12:51:11.581', '2025-01-09 12:51:11.581');

Struktur Felder:

INSERT INTO public.lp_daten_struktur_feld(i_id, struktur_daten_i_id, c_erp_feld, c_fix_wert, c_pfad, c_attribut_name, i_sort, c_format_maske, personal_i_id_anlegen, personal_i_id_aendern, t_anlegen, t_aendern, mapping_i_id) VALUES
(11, 11, 'LOS_ID', NULL, 'Materialliste/Los/Id', NULL, 1, NULL, 11, 11, '2025-01-15 11:53:24.295', '2025-01-15 11:53:24.295', NULL),
(12, 11, 'LOS_CNR', NULL, 'Materialliste/Los/CNr', NULL, 1, NULL, 11, 11, '2025-01-15 11:53:24.301', '2025-01-15 11:53:24.301', NULL),
(13, 11, 'ARTIKEL_CNR', NULL, 'Materialliste/Daten/Material/CNr', NULL, 2, NULL, 11, 11, '2025-01-15 11:53:24.306', '2025-01-15 11:53:24.306', NULL),
(14, 11, 'ARTIKEL_BEZEICHNUNG', NULL, 'Materialliste/Daten/Material/Caption', NULL, 2, NULL, 11, 11, '2025-01-15 11:53:24.306', '2025-01-15 11:53:24.306', NULL);

Ergebnis als XML-Datei:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Materialliste>
<Los\>
<Id\>16</Id>
<CNr>25/0000003</CNr>
</Los\>
<Daten>
<Material>
<Cnr>25711</Cnr>
<Caption\>Artikel Seitenblech 1</Caption\>
</Material>
<Material>

2.4 - Log-Modus für Webservice-Export

Log-Modus für Webservice-Export

Um nachvollziehen zu können, welche Daten tatsächlich an einen Endpoint übergeben wurden, besteht die Möglichkeit, diese im Log-Modus als Datei auf einem lokalen Serverlaufwerk zu protokollieren. Dies erleichtert die manuelle Prüfung und Analyse der exportierten Inhalte.

Der Log-Modus lässt sich über den Parameter SST_WEBSERVICE_EXPORT_LOGGING jederzeit aktivieren oder deaktivieren.
Zusätzlich kann über den Parameter SST_WEBSERVICE_EXPORT_LOGGING_PATH das Verzeichnis festgelegt werden, in dem die Dateien gespeichert werden. Dabei ist folgendes zu beachten:

• Es muss ein absoluter Pfad angegeben werden.
• Der Pfad muss auf Linux mit einem / und auf Windows mit einem \ enden!
• Beispiel für einen gültigen Pfad:
  • Linux /var/log/webservice/debug/
  • Windows C:\webservice\debug\

Benennung der Dateien

Die gespeicherten Dateien folgen dem folgenden Namensschema: <SSTParameterbezeichnung>_<SSTLaufID>_<SSTLaufStartZeitstempel>.<Dateiformat>

Hinweise zur Funktion

• Diese Funktion ist nur beim Export an einen REST-DISPATCHER oder REST-RECEIVER verfügbar.
• Die Dateien werden nur dann gespeichert, wenn der Export erfolgreich abgeschlossen wurde.
• Im Fehlerfall erfolgt keine Ablage der Exportdaten.

3 - Edifact

Eine Sammlung unserer Informationen rund um die EdiFact Schnittstelle

Für die EdiFact Anbindung sind unter anderem folgende Einstellungen/Vorraussetzungen erforderlich:

• Kieselstein-Benutzer mit Kennwort mit passenden Rechten für die RestApi-Systemrolle
  • diesem Benutzer ein passendes Personal zuordnen und dort als Ausweisnummer den gewünschten Token eintragen (z.B. BEPS-….)
• EDIFACT_USER -> Environment Variable des Wildflyservers mit Benutzernamen dieses Kieselstein Benutzers
• EDIFACT_PASS -> Environment Variable des Wildflyservers mit Kennwort dieses Kieselstein Benutzers
• einen Wildfly Benutzer für die http-Authentifizierung erstellen mit

add-user.sh -a -u '<benutzername>' -p '<passwort>' -g 'submitter'

Bei der Anmeldung auf der Website gibt man die Daten des Wildfly Benutzers zu verwenden von oben ein.

4 - Woo Commerce Import

Im Auftragsmodul steht auch der Shop-Import im WooCommerce Format zur Verfügung. Laut Informationen von Kieselstein ERP eG Mitgliedern kann dieses Datenformat auch von Shopware mit einer kleinen Anpassungsprogrammierung zur Verfügung gestellt werden.

WooCommerce Import

Dieser Import steht im Modul Auftrag, im Menüpunkt Auftrag, Import, WooCommerce CSV zur Verfügung. Die Grundidee ist, dass vom Shop täglich Daten abgeholt werden, z.B. über FTP Import und dann täglich diese Daten eingelesen werden. Da es dabei immer wieder zu erforderlichen Anpassungsarbeiten kommt, sehen wir den manuellen Import als sinnvoller an.

Man findet die Schnittstelle im Modul Auftrag.

Zuordnung der WooCommerce Spaltenname:

Wichtig: Die Spaltenbezeichnungen müssen in Englisch übergeben werden. Bitte übergib die Datei bis auf weiteres ausschließlich mit den englischen Spaltenüberschriften; nur damit werden Anrede, Vorname und Nachname richtig zugeordnet.
Wir gehen davon aus, dass alle Beträge als Nettobeträge übergeben werden.

Zusätzlich haben wir die Logik implementiert, dass der Brutto-Gesamtbetrag = Order Total Amount aus dem Shop exakt dem anhand der Kieselstein ERP Preise errechneten Wert entsprechen muss / sollte. D.h. wenn die Verkaufspreisfindung gleiche Preise ergibt wie die Preise aus dem Shop, so sollten sich die gleichen Summen ergeben.

Hier kommt noch die Herausforderung dazu, dass der Shop ein Brutto rechnendes System ist und Kieselstein ERP netto rechnet. Das bedeutet wiederum, dass es zu geringen Cent-Abweichungen kommen kann.

Diese Differenz wird über eine zusätzliche Position mit dem Rundungsausgleichsartikel ausgeglichen. Beträgt sie mehr als 1,00 €, wird zusätzlich eine Textposition mit dem Hinweis auf die Abweichung eingefügt, damit du den Beleg vor dem Aktivieren prüfen kannst.

Definieren Sie dafür den Parameter RUNDUNGSAUSGLEICH_ARTIKEL mit z.B. RUNDUNG. Der Artikel RUNDUNG selbst muss, nicht lagerbewirtschaftet sein. Der Mehrwertsteuersatz muss mit steuerfrei definiert werden.

“Order Number”,“Order Status”,“Order Date”,“Customer Note”,Title,“First Name (Billing)”,“Last Name (Billing)”,“Company (Billing)”,“Address 1&2 (Billing)”,“City (Billing)”,“State Code (Billing)”,“Postcode (Billing)”,“Country Code (Billing)”,“Email (Billing)”,“Phone (Billing)”,“First Name (Shipping)”,“Last Name (Shipping)”,“Address 1&2 (Shipping)”,“City (Shipping)”,“State Code (Shipping)”,“Postcode (Shipping)”,“Country Code (Shipping)”,“Payment Method Title”,“Cart Discount Amount”,“Order Subtotal Amount”,“Shipping Method Title”,“Order Shipping Amount”,“Order Refund Amount”,“Order Total Amount”,“Order Total Tax Amount”,SKU,“Item #”,“Item Name”,Quantity,“Item Cost”

Rechnungsadresse / Lieferadresse

• Die Rechnungsadresse wird anhand der erhaltenen E-Mailadresse ermittelt. D.h. ist im Kieselstein ERP Kundenstamm die RE-E-Mailadresse bereits vorhanden, so wird diese Adresse als Kunde verwendet. Es erfolgt keine weitere Prüfung mehr.
• Sind in den erhaltenen Shop-Daten die Daten für die Rechnungsadresse und die Lieferadresse gleich, so wird als Lieferadresse, des Auftrags, die Rechnungsadresse verwendet, egal ob die erhaltenen Adressdaten davon abweichend sind.
• Sind in den erhaltenen Shop-Daten die Daten für die Rechnungsadresse und die Lieferadresse ungleich, so wird die Lieferadresse neu angelegt und die Adressart als Lieferadresse gekennzeichnet.

Info:
Die erweiterte Suche bei der Kundenauswahl prüft leider die RE-EMail-Adresse NICHT!

Was der Import anlegt

• Angelegt wird ein freier Auftrag im Status angelegt. Als Vertreter wird der Kieselstein ERP Benutzer eingetragen, der den Import durchführt.
• Der Liefertermin der Kopfdaten ergibt sich aus dem Belegdatum zuzüglich der im Mandantenparameter DEFAULT_LIEFERZEIT_AUFTRAG hinterlegten Tage. Ist der Parameter nicht gepflegt, werden 14 Tage angenommen.
• Die Projektbezeichnung wird mit der Kurzbezeichnung des Artikels der ersten Zeile der Bestellung vorbesetzt.
• Währung, Spediteur und Abbuchungslager kommen aus den Konditionen des ermittelten Kunden.
• Die Positionstermine entsprechen dem Liefertermin der Kopfdaten.
• Eine Position für die Versandkosten wird nur dann angelegt, wenn in Order Shipping Amount ein Betrag ungleich null steht.

Fehlermeldungen

Bitte die angeführte Lieferart definieren. Siehe oben Lieferart bzw. nachfolgend ein Muster wie die Lieferart angelegt werden könnte.

Bitte beachte die Zuordnung des Frachtkostenartikels

Passiert bei der Vergabe der Debitorennummer für neue Kunden.
ACHTUNG: Bitte die automatische Vergabe der Debitorennummer abschalten.

Dies passiert gerne, wenn manuell der Auftrag aus dem Shop angelegt wird und danach der Import gestartet wird. Um diese Situation zu entschärfen, wird vom Import automatisch SHOP- vor die eigentliche Bestellnummer aus dem Shop gestellt.

Parameter

Mit dem Parameter WOOCOMMERCE_PARTNER_ZUSAMMENZIEHEN kann eingerichtet werden, dass Vorname und Nachname beim Import, wenn keine Company gegeben ist, in den PartnerName1 zusammengezogen wird.

Musterdaten

Musterdaten mit genauer Feldzuordnung siehe als LibreOffice Vorlage mit Beschreibung bzw. als CSV

Zusatzinfo

• Die Partnerart ist fix auf Adresse, so wie bei anderen Kunden auch
• Die Kommunikationssprache ist in der Regel die Sprache, in der sich der Kieselstein ERP Benutzer angemeldet hat
• Der Mehrwertsteuersatz kommt aus dem Land, also Inland mit Allgemeine Waren, alle anderen Länder steuerfrei. Für genauere Definition siehe bitte System, Mandant, Vorbelegungen.

5 - Profirst Anbindung

PROfirst Anbindung

Mit der PROfirst Anbindung wird eine Verbindung zwischen dem Konstruktions- und Schachtelprogramm ProFirst und Kieselstein ERP geschaffen. ProFirst wird vor allem in der Blechbearbeitung, wie z.B. Laserschneiden bzw. Plasmaschneiden eingesetzt. Der grundsätzliche Ablauf ist in der Regel folgender (siehe auch):

1. Vom Kunden wird ein neues Teil angefragt. Dieses wird in PROfirst konstruiert und somit der Fertigungs-Artikel in PROfirst mit all seinen Eigenschaften angelegt. Ist der Fertigungs-Artikel fertig konstruiert, müssen die PROfirst-Daten von Kieselstein ERP eingelesen werden. Wählen Sie dafür im Artikelmodul, Pflege, PROfirst Import. Bei diesem Import wird ein direkter Zugriff auf Ihre PROfirst Datenbank gemacht und die Bauteile und deren Bildinformationen ausgelesen.

2. Die Verdrahtung der Felder zwischen PROfirst und Kieselstein ERP ist wie folgt: Es wird dabei auch ein Bild des Artikels aus PROfirst nach Kieselstein ERP mit übernommen. Verdrahtung:

   ProFirst	Kieselstein ERP	Bedeutung
   Artikelnummer	Stücklisten-Artikelnummer	Dies ist die Artikelnummer der Stückliste unter der der Fertigungs-Artikel angelegt wird. Auf die Länge achten, max. 25 Stellen, alphanummerisch
   Material	Stkl-Pos-Artikelnummer	Das Rohmaterial wird in die Stückliste als Materialposition übernommen. Die Abmessungen werden in mm für das umformende Rechteck übergeben. Auf diesen Abmessungen beruhen die Bedarfsberechnungen für das Gesamtmaterial. Die Material-Stärke wird in der Artikelnummer des Materials abgebildet. Das Rohmaterial ist entweder bereits angelegt oder wird beim Import von Kieselstein ERP erzeugt. Der Aufbau der Artikelnummer wird wie folgt errechnet:
   Maschine	Stkl-Arbeitsplan-Position	Erzeugt eine Arbeitsplanposition der Tätigkeit Autogen oder Plasma oder Laser -schneiden unter Angabe der Maschine auf der der Artikel geschnitten werden soll. Rüst- und Stückzeit kommen aus den Feldern …..und werden im Format hh:mm:ss übergeben. Es sind auch Zeiten > 24 Std. möglich. Die dafür erforderlichen Tätigkeiten müssen definiert sein. Die dafür erforderlichen Maschinen müssen ebenfalls definiert sein. Die Arbeitsgangposition wird mit der Materialposition verbunden.
   Bilddatei	Artikelkommentar Fertigungsbild	Es ist im Verzeichnis passend zur Artikelnummer auch eine Bilddatei im xxx (jpg/png) Format abgelegt. Diese wird bei der Stückliste als Artikelkommentar, mit der Markierung bei Fertigung mitdrucken hinterlegt.
   Bauteilname	Artikelnummer
   Kunde	Stückliste Kunde
   Stärke	Teil der Artikelnummer des Materials
   Werkstoff	Teil der Artikelnummer des Materials	Hinterlegen des Werkstoffs beim Material
   Werkstofftyp	Teil der Artikelnummer des Materials	Bezeichnung des Materials
   Form		wird nicht verwendet
   Menge		wird nicht verwendet
   Ändern		wird nicht verwendet
   Fläche (Brutto)	Fläche des Materials	Wird in mm² als Material in die Stücklistenposition eingetragen
   Preis NettoField 1	VK-Preisbasis	Verkaufspreisbasis. Das Datum gültig ab wird mit dem Importdatum vorbesetzt
   Knd.Art.Nr.Field 2	Kurzbezeichnung	Wird üblicherweise als Knd.Art.Nr verwendet und auch bezeichnet
   ZeichnungsNrField 3	Referenznummer	Wird üblicherweise als Zeichnungsnummer verwendet und auch bezeichnet
   AnarbeitungField 4		Fremd-arbeitsgang-artikel (siehe unten)
   KommissionField 5	Zusatzbezeichnung2
   Feld 6	Bauform	Wird üblicherweise als Beschreibung verwendet und auch bezeichnet
   Bearbeitungszeit	Stückzeit	in hh:mm:ss
   Maschine	Maschine	Name (= Inventarnummer) der Maschine auf die die Tätigkeit gebucht werden sollte
   Schneidart	Tätigkeit	Artikelnummer der Tätigkeit des Arbeitsgangs, beginnt mit AZ_ gefolgt von der Schneidart. Muss angelegt sein. Es ist dies die Tätigkeit hinter der dann obige Stückzeit und Maschine hinterlegt werden. Das Material des Arbeitsgangs zeigt auf die Materialposition
   Gewicht (kg)	Artikel-Gewicht	Gewicht im Artikel im Reiter Technik
   Datum	wird nicht genutzt

3. Nun wird gegebenenfalls das entsprechende Angebot in Kieselstein ERP erstellt und an den Kunden übermittelt.

4. Der Kunde bestellt, in Kieselstein ERP wird eine Auftragsbestätigung mit dem Kundenartikel, welches der oben übernommene Fertigungsartikel, der wiederum eine Stückliste ist, erstellt. Natürlich können beliebig viele Positionen im Kundenauftrag erfasst werden.

5. Mit dem internen Bestellvorschlag werden die anzulegenden Lose ermittelt und erzeugt. Nun stehen die zu produzierenden Lose mit deren Arbeitsgängen, in denen wiederum die Maschinen enthalten sind, und den Materialbedarfen in Kieselstein ERP zur Verfügung.

6. Im Modul Los, unterer Reiter offene AGs, oberer Reiter produzieren sind alle angelegten Lose und deren Arbeitsgänge mit Kunde, Los Nr, Material, Maschine und Fortschritt ersichtlich. Anhand dieser Liste, oder auch anhand des Journals, Maschine + Material, kann der Werker / Arbeitsvorbereiter entscheiden, welche Fertigungsaufträge / Arbeitsgänge er als Arbeitsvorrat für die nächste(n) Tafel(n) an PROfirst übergibt. In dieser Liste finden Sie auch die Anzeige der jetzt produzierbaren Lose. Und wenn Sie mehrere Lose markieren, so wird oben die Summe der Stunden und der Materialmenge, was in der Regel die Fläche der Tafel sein wird, angezeigt. So bekommen Sie ein Gefühl dafür, ob diese Lose aus der Tafel / den Tafeln geschnitten werden können.

7. Für die Übergabe markiert man nun die gewünschten Lose der Maus und Klick auf Übergabe an PROfirst. Damit werden Stkl-Artikelnummer, Losgröße, Kunde, … an PROfirst übergeben. Zugleich werden die Lose dadurch mit dem Zusatzstatus in PROfirst versehen. Das Los selbst bleibt im Status angelegt.

8. Nun lesen Sie den Arbeitsvorrat in Ihr PROfirst ein. Bitte achten Sie dabei darauf, dass Ihr PROfirst so eingestellt ist, dass vorhandener Arbeitsvorrat immer ergänzt, also erhöht wird.

9. Nun werden in PROfirst die Bauteile auf die Tafeln geschachtelt.

10. Die geschachtelten Bauteile, mit der Information welche Tafel für welches Los (= Fertigungsauftrag) vorgesehen ist, wird wiederum von PROfirst exportiert.

11. Nun wird der Schachtelplan durch Klick auf …. eingelesen. Beim Einlesen werden die im Schachtelplan enthaltenen Artikel/Bauteile so auf die Lose verteilt, dass immer das älteste Los eines Bauteiles verwendet wird. Sollte nicht die gesamte Losgröße in diesem Schachtelplan / der Tafel verwendet worden sein, so wird auch das Los gesplittet, damit wiederum die Gesamtmenge dieses Artikels erhalten bleibt und auch die Information, dass im PROfirst noch offene Lose für dieses Bauteil gegeben sind. Beim Splitting eines Loses wird der Zusatzstatus, dass dieses Los bereits in PROfirst ist, mitübernommen. Die Information, welchem Schachtelplan das Los zugeordnet ist, wird beim Los hinterlegt. Es kann auch nach den Schachtelplannummern gesucht werden. Wir gehen davon aus, dass der Dateiaufbau des Schachtelplans mit csvnnnnn.csv gegeben ist, wobei nnnnn die Schachtelplannummer ist. Wird eine Schachtelplannummer eingegeben, die nicht vorhanden ist, erhalten Sie einen entsprechenden Hinweis.

12. Beim Einlesen des Schachtelplans erhalten Sie eine Liste der laut Kieselstein ERP lagernden Tafeln dieses Materials. Wählen Sie nun das tatsächlich verwendete Material aus.

13. Da im Schachtelplan auch die Menge definiert ist, die nach dem Schneiden als nutzbare Restmenge übrigbleibt, kann eine Restmengenberechnung durchgeführt werden. D.h. es werden die Los-Sollmengen aller Lose des Schachtelplans der laut Schachtelplan verbrauchten Menge gegenübergestellt und daraus ein Korrekturfaktor ermittelt mit dem die Lossollmengen umgerechnet / korrigiert werden. Damit wird erreicht, dass bei jedem Einlesen eines Schachtelplanes die verbleibende Restmenge einer Tafel zwischen Kieselstein ERP und PROfirst übereinstimmt. Zugleich wird bei diesem Vorgang nach der Korrektur der Sollmengen das gesamte Material der Lose dieses Schachtelplans ausgegeben, vom Lager in die Lose gebucht.

14. Ist die Tafel nun geschnitten, so muss dies ebenfalls in Kieselstein ERP erfasst werden. Klicken Sie dazu auf …. Es erscheint erneut die Abfrage nach dem Schachtelplan. Nun werden alle Lose dieses Schachtelplans mit deren Sollmengen angezeigt. Es kann nun bei jedem Los angegeben werden, ob eventuell Ausschuss zu erfassen ist. Geben Sie die unbrauchbaren Mengen für das jeweilige Los an und klicken Sie dann auf Erledigt/Buchen. Damit werden die angegebenen Lose mit den Losgrößen abzüglich den Ausschussmengen als Ablieferungsbuchung gebucht. Womit die Teile auf Lager sind und z.B. per Lieferschein ausgeliefert werden können.

Anmerkungen:

• Da von PROfirst der Materialbedarf in x & y Abmessungen übergeben wird, sind die Dimensionen für m² und mm² in den Mengeneinheiten entsprechend auf 2 einzustellen.

• Beim Erstellen neuer Bauteile in PROfirst achten Sie bitte darauf, dass die Bestellmenge immer 0,00 bleibt. Anderenfalls würden Sie mehr schachteln / produzieren als Sie aufgrund des offenen Auftragsstandes tatsächlich sollten.

• Sollte ein Kunde einen Auftrag stornieren, so ist neben dem Storno des Loses auch die entsprechende offene Menge des Bauteils zu korrigieren / auf 0,00 zu setzen

Zuordnung der Tafelnummer zur Chargennummer

1. Bei der Buchung des Wareneinganges werden anstelle der Chargennummern, welche in der Regel bei der Anlieferung nicht sichtbar sind, Tafelnummern erfasst. Wichtig ist hier, dass die Tafelnummern bereits jede Tafel vereinzeln, d.h. für jede Tafel ist eine aufsteigende eigene Tafelnummer zu verwenden. Diese werden in der Zubuchung des Wareneinganges durch Klick auf “Tafelnummer” erzeugen generiert und für jede einzelne Tafel hinterlegt. Damit liegen die Tafeln mit diesen Nummern auf Lager. Die Tafelnummer ist der Ersatz für die Chargennummer. Das bedeutet auch, dass Tafeln, die noch nicht in Chargennummern umgewandelt wurden –»> FRAGE: Umwandeln oder Ergänzen, in den Lagerinformationen eindeutig ersichtlich sind.

2. Die Tafelnummer wird in Kieselstein ERP in der Version der Charge abgelegt. Die eigentliche Chargennummer wird mit “noch nicht definiert” vorbesetzt. Die vergebenen Tafelnummern werden durch die Wareneingangsetiketten ausgedruckt und bei den jeweiligen Tafeln durch Aufkleben auf die Tafeln bzw. deren Begleitpapiere identifiziert. (Z.B. ….) Die Tafelnummer ev. in Kombination mit der Artikelnummer, wird auch in Barcodeform auf der Wareneingangsetikette angedruckt.

3. Zuordnung der Chargennummern zu den Tafelnummern. Durch die Entnahme der Tafel, welche einige Tonnen hat, wird deren Chargennummer sichtbar. Der Werker geht nun an das BDE-Terminal, identifiziert sich mit seiner Ausweiskarte, und tippt auf Tafelnummern zuordnen. Nun scannt er die Tafelnummer ein und tippt die Chargennummer, welche er sich vorher auf dem Tafelnummernetikett notiert hat, in das Terminal ein. Die Chargennummern sind durch Ziffern und normale Zeichen (keine Umlaute, keine Sonderzeichen (vor allem wiederum wegen Barcode)) definiert.

4. Aus Gründen der Rückverfolgbarkeit sollte die Zuordnung Tafelnummer <-> Chargennummer immer erhalten bleiben. Damit wird, je nach Menge der verarbeiteten Tafeln, die Anzahl der laufenden Stellen der Tafelnummern definiert. Da pro Tag und Schicht und Maschine ca. eine Tafel verarbeitet wird, ist bei drei Maschinen und Dreischichtigem Betrieb von 3285 Tafeln pro Jahr auszugehen. D.h. die Tafelnummern sind mindestens 6-stellig auszulegen. Wir würden der Einfachheit und klareren Zuordnung halber, die Tafelnummern über alle Artikel ziehen. D.h. egal ob das ein Mittelformat mit 2 mm oder ein 4 x 6 m x 10 cm Blech ist, die eine Tafelnummer kommt nach der anderen.

5. Nachdrucken von Tafel-Etiketten. Diese können im Artikel unter Info, Etikett und Angabe der Chargennummer bzw. Tafelnummer jederzeit nachgedruckt werden.

Parametrierung für PROfirst

Die PROfirst Artikeldaten (Parts) werden als Stücklisten Daten nach Kieselstein ERP importiert. Dazu wird von Kieselstein ERP direkt auf die Tabellen Ihres PROfirst Servers zu gegriffen. Um diesen Zugriff zu ermöglichen, müssen folgende Parameter definiert werden:

Die in PROfirst definierbaren Zusatzfelder werden wie folgt übernommen:

• Field1 … Verkaufspreisbasis des Artikels
• Field2 … Artikel Kurzbezeichnung, welche üblicherweise für PROfirst Anwender mit Kundenartikelnummer bezeichnet ist
• Field3 … Artikel Referenznummer, welche üblicherweise für PROfirst Anwender mit Zeichnungsnummer bezeichnet ist
• Field4 … wird für die Darstellung der Fremdarbeitskosten verwendet. D.h. um diesen Zahlenwert zu übernehmen, muss der PRO_FIRST_FREMDFERTIGUNGSARTIKEL definiert sein. Bitte beachten Sie, dass dessen Mengeneinheit EUR € sein sollte, da ja hier nur Kosten übergeben werden. Diese “Menge” = Kosten werden in die Stückliste als zusätzliche Materialposition übernommen.
• Field5 … Artikel Zusatzbezeichnung2
• Field6 … Artikel Bauform, welche für PROfirst Anwender auch als Beschreibung bezeichnet ist
• Field7 … Artikel Verpackungsart -> dieses Feld wird von der PROfirst Version 9 nicht unterstützt
• Field8 … Wird von PROfirst Version 9 nicht unterstützt / verwendet und daher auch in Kieselstein ERP nicht ausgewertet

Damit die PROfirst Funktionen zur Verfügung stehen, muss zumindest die PRO_FIRST_DBURL definiert sein.

Zusätzlich achten Sie bitte am Profirst Server, dass die TCPIP Verbindungen aktiv / erlaubt sind.

Und dass die entsprechenden Ports im SQL Configuration Manager eingestellt sind:

Testen Sie die Verbindung z.B. durch eine Verbindung mit dem SQL-Manager:

Mögliche Fehlermeldungen

Ungültige Zeichen Grundsätzlich werden bei der Übernahme alle Zeichen auf Großbuchstaben umgesetzt. Sollten trotzdem nicht definierte Zeichen enthalten sein erhalten Sie eine Meldung ähnlich der obigen. Ergänzen Sie in diesem Falle die Definition der erlaubten Zeichen Ihrer Artikelnummer. In obigem Beispiel ist der . Punkt nicht definiert. Der Import wird abgebrochen. Bitte ergänzen Sie die Artikelnummerndefinition oder ändern Sie den Namen in PROfirst

Kunde nicht definiert Generell ist die Definition, dass die Verbindung der Kunden zwischen Kieselstein ERP und PROfirst über die Kunden-Kurzbezeichnung erfolgt. Wird kein Kunde mit der in PROfirst eingetragenen Kurzbezeichnung gefunden, so erscheint obige Fehlermeldung und der Import wird abgebrochen. Siehe unten / Kunden Import / ignorieren

Arbeitszeitartikel nicht definiert Um die Arbeitszeitartikel von PROfirst in die Arbeitspläne von Kieselstein ERP übernehmen zu können, müssen diese definiert sein. Diese werden entsprechend dem Rulecode aus PROfirst übernommen. Diese Artikel müssen als Arbeitszeitartikel in Kieselstein ERP angelegt sein. PROfirst Bauteile, die im PROfirst keine oder fehlerhafte Arbeitszeit-IDs (kein Rulecode oder Rulecode in Ruletabelle nicht vorhanden) werden auf den im Parameter DEFAULT_ARBEITSZEIT Arbeitszeitartikel gesetzt.

Maschine nicht definiert Die bedeutet, dass für die angegebene Maschine (aus PROfirst) keine Maschine in Ihrem Kieselstein ERP mit der entsprechenden Inventarnummer gefunden wurde. D.h. bitte entweder die Maschinendefinition in Ihrem PROfirst richtigstellen (siehe Liste der Bauteile der Maschine) oder die Maschine in Ihrem Kieselstein ERP anlegen (Zeiterfassung, unterer Reiter Maschinen). Bitte beachten Sie, dass die Inventarnummer mit der Maschinenbezeichnung in PROfirst übereinstimmen muss. In Kieselstein ERP ist die Inventarnummer auf 15 Stellen begrenzt.

PROfirst Artikel und Stücklisten Import durchführen

Sind alle beschriebenen Einstellungen getroffen, so wählen Sie im Artikelmodul bitte Pflege, PROfirst Import. Damit wird die jeweilige Anzahl an neuen Datensätzen eingelesen. Bitte beachten Sie, dass wir, so wie es in der Praxis üblich ist, davon ausgehen, dass die Artikel in PROfirst erst abgespeichert werden, wenn diese eindeutig definiert sind. Da der Import parallel von mehreren Mitarbeitern angestoßen werden kann, aber nicht sollte, würden unter Umständen nicht fertig definierte Artikel importiert. Wir haben uns daher dazu entschlossen, dass ein Artikel nur einmal eingelesen wird.

Aus dem Namen des PROfirst Artikels werden die Artikelnummern gebildet. Würde sich daraus eine gleichlautende (doppelte) Artikelnummer ergeben, so werden die letzten Stellen durch _nnn hochgezählt. In die Bezeichnung wird der Originalname eingetragen. Bitte beachten Sie, dass Artikel, deren Namen eine Artikelnummer ergeben würden, die kürzer als die Mindeststellenanzahl, üblicherweise 5, ist, ignoriert werden.

Der Import wird immer so durchgeführt, dass Artikel für Artikel eingelesen und die Stücklisten daraus erzeugt werden. Kommt es nun zu einem Abbruch, wegen eines Fehlers, eine ungültige Definition, so wurden alle Artikel bis zum Auftreten des Fehlers bereits eingelesen und sind bereits in Ihrem Kieselstein ERP vorhanden. D.h. wenn nun der Fehler korrigiert wird, so wird exakt bei dieser Fehlerbedingung wieder fortgesetzt und erneut eine bestimmte Anzahl an Datensätzen eingelesen.

Um die direkte Verknüpfung der Stücklisten zwischen Kieselstein ERP und PROfirst eindeutig darzustellen, wird die PROfirst PART.IDPART in der Stückliste in den Kopfdaten unter Fremdsystemnr. abgelegt. Damit kann programmtechnisch eindeutig auf den richtigen Artikel in PROfirst zurückgegriffen werden. Für den Import wird von der höchsten in Kieselstein ERP hinterlegten Fremdsystemnr. ausgegangen und die danach kommenden Artikel eingelesen.

Wareneingänge nach PROfirst exportieren

Um die im Wareneingang erfassten Tafeln auch an PROfirst zu signalisieren, wurde diese Funktion geschaffen. Sie finden diese ebenfalls im Modul Artikel, Pflege, Export Wareneingang nach PROfirst. Es werden damit alle Wareneingänge seit dem letzten Exportlauf an PROfirst über den Umweg einer CSV Datei übertragen.

Bitte beachten Sie, dass dies ein einmaliger Vorgang ist. Nachträgliche Änderungen an den Warenzugangsbuchungen werden NICHT an PROfirst übergeben. Die Exportdatei wird ebenfalls im definierten PROfirst Exportverzeichnis abgelegt und beginnt mit WE_AB_Datum-Uhrzeit

Um die Daten nach PROfirst zu importieren, starten Sie bitte Ihr PROfirst, wählen dann   CAM, CAM Medium.

Klicken Sie nun unten auf Blechverwaltung

nun wählen Sie Tafeln einlesen.

Geben Sie hier den unter PRO_FIRST_VERZEICHNIS definierten Pfad ein und definieren Sie den Import anhand folgender Spalten:

• Tafelnummer
• Material
• ArtikelnummerMaterial
• Staerke
• Breite
• Tiefe
• Chargennummer
• AnzahlTafeln
• Lieferant
• Dokument
• Preis/Kilo
• Werkstoff

Da üblicherweise nicht nur die verschiedenen Standardformate (Klein, Mittel, Groß) sondern auch Sonderformate verarbeitet werden, kann in der Wareneingangsposition die Breite / Tiefe (in mm) angegeben werden. Dazu muss in den Parametern die Dimension der BS-Pos-Einheit auf 2 gestellt werden.

Export der zu schneidenden Lose / Arbeitsgänge

Verwenden Sie für die Signalisierung der von Ihnen gewünschten zu schneidenden Lose bzw. Arbeitsgänge im Modul Los den unteren Modulreiter offene AGs und dann den oberen Reiter Produzieren.
Hier filtern Sie zuerst nach dem Material, das Sie schneiden möchten, z.B. durch Eingabe der Artikelnummer des Materials.

Sortieren Sie nun die Lose in der Reihenfolge, in der diese gefertigt werden sollten. In der Regel wird das der AG-Beginn sein. Sind hier Spalten OHNE AG-Beginn, so gibt es für diese Lose keine Arbeitsgänge, was bei importierten Stücklisten nicht sein sollte. Siehe oben. Für die Sortierung klicken Sie nun auf die Spaltenüberschrift AG-Beginn. Klicken Sie nun die Lose an, die Sie nach PROfirst zum Schachteln übertragen wollen. Damit Sie ein Gefühl dafür bekommen, ob denn die ausgewählten Lose auf die Tafel geschachtelt werden können, zeigen wir oben die Summe der Abmessungen der Materialien der markierten Lose an. Beachten Sie bitte, dass dies nur die mathematische Addition der in den Stücklisten eingetragenen Flächen ist. Es ist dies in keinem Falle ein wie immer gearteter Schachtelversuch. Nutzen Sie auch die Anzeige heute produzierbar, diese zeigt ob überhaupt ausreichend Material auf Lager ist. Haben Sie nun alle Lose für die Übertragung markiert, so klicken Sie bitte auf nach PROfirst exportieren. Damit werden alle markierten Lose in die CSV Exportdatei exportiert. Der Export wird durch angezeigt. Der Dateiname hat den Aufbau OAG-Datum-Uhrzeit.csv.

Zusätzlich wird das jeweilige Los mit dem Zusatzstatus P1 markiert. Hinterlegen Sie hinter diesem Zusatzstatus ein entsprechendes Symbol und den für Sie passenden Begriff. Damit sehen Sie bereits in der Losübersicht, welche Lose zum Schachteln an PROfirst übergeben wurden. Hinweis: Damit das neue Symbol angezeigt wird, muss der Kieselstein ERP Client neu gestartet werden. Wann diese Daten an PROfirst übergeben wurden, ist je Los im Reiter Zusatzstatus ersichtlich.

Der Datenaufbau sieht z.B. wie folgt aus: KundeKbez,Losnummer,StklArtikelnummerProFirst,OffeneLosmenge,MaterialProFirst,MaterialHoehe,,,, Test,16/0000001,696-419-01-01-05,35,S355,25.0

Importieren Sie diese Daten in PROfirst unter CAM Medium, Fertigungsaufträge Auftrag von PPS ein(lesen).

Bitte beachten Sie, dass dadurch das Los noch immer im Status angelegt ist. D.h. Buchungstechnisch ist das Material noch im Lager. Erst durch die Rückmeldung der Schachtelung wird das Los ausgegeben und damit das Material vom Lager abgebucht.

Einstellung des PROfirst für den Import

Für den Ablauf ist wichtig, dass die Verwaltung der offenen, d.h. der zu schneidenden Mengen in beiden Systemen gleich ist.

wie können Stücklisten aktualisiert werden?

hierfür stehen zwei Varianten zur Verfügung:

• a.) Aktualisieren einer einzelnen Stückliste. Wechseln Sie dazu im Stücklisten Modul auf die gewünschte Stückliste und wählen nun im Menü Bearbeiten, Stückliste aus PROfirst aktualisieren.
• b.) Aktualisieren aller Stücklisten eines Kunden. Wechseln Sie im Kundenmodul auf den gewünschten Kunden und wählen aus dem Menü, Pflege, PROfirst Import. Bitte beachten Sie, dass hier die Begrenzung auf die maximale Anzahl der zu importierenden Artikel NICHT wirkt. D.h. es werden alle Artikel dieses Kunden eingelesen. Es ist dieser Import jedoch auf ein reines Aktualisieren begrenzt. D.h. es werden nur die bereits in Kieselstein ERP eingetragenen Stücklisten aktualisiert. Das Einlesen neuer Artikel muss bitte immer im Artikelmodul, Pflege, PROfirst Import erfolgen (Hintergrund ist die Verwaltung der noch einzulesenden Artikel).

In anderen Worten ist die Bauteilübernahme aus PROfirst wie folgt definiert:

• Kunde pflegt die bestehenden Artikel / Stücklisten ausgehend von PROfirst zu Kieselstein ERP

• Artikel fügt hinzu: Es werden Bauteile die anhand ihrer PROfirst ID noch nicht im Artikel / Stücklistenstamm von Kieselstein ERP sind hinzugefügt = neu angelegt

Wie wird mit Verkaufspreisänderungen umgegangen?

Bei jeder Aktualisierung werden auch die aktuellen Verkaufspreise aus PROfirst übernommen und der Preis gültig ab Datum auf das Importdatum gesetzt. Somit sehen Sie im Artikel unter Info, Verkaufspreisentwicklung, wie sich der Preis im Laufe der Zeit verändert hat.

Können Kunden vom Import ausgenommen werden.

Ja. Wenn über den Import im Artikelmodul die Fehlermeldung Kundenkurzbezeichnung für xyz nicht gefunden, so wählen Sie Kunde für weitere Importe ignorieren. Damit wird der Kunde in die zu ignorieren Liste mit aufgenommen und beim nächsten Importlauf übersprungen. Sollten Sie die Artikel dieses Kunden später trotzdem importieren wollen, so legen Sie bitte den Kunden an bzw. definieren Sie die entsprechende Kundenkurzbezeichnung eines bestehenden Kunden und wählen Sie dann Pflege, PROfirst Import, wie oben beschrieben. Die nun erscheinende Frage beantworten Sie bitte mit Ja.

Einfache Beschreibung des grundsätzlichen Ablaufes

1. Importieren Sie alle benötigten Artikel
2. Legen Sie die Kundenaufträge an
3. erzeugen Sie die entsprechenden Lose, z.B. mit der internen Bestellung
4. Bestellen Sie die nötigen Rohartikel, z.B. Blechtafeln
5. Buchen Sie die Lieferungen im Wareneingang zu.
   Achten Sie darauf, dass die Blechtafeln entsprechend Chargengeführt sind (es muss die Abfrage nach Chargennummern kommen)
6. Exportieren Sie im Modul Los, unterer Reiter offene AGs oberer Reiter Produzieren.
   Beachten Sie die produzierbaren Lose nach Sortierung
7. Schachteln Sie die gewünschten Aufträge im PROfirst
8. Einlesen eines Schachtelplanes in Kieselstein ERP. Damit automatische Zuordnung der Schachtelplannummern zu den Losen.
9. Schneiden der Schachtelpläne
10. Abliefern der Schachtelpläne = Tafel abliefern unter Angabe des eventuellen Ausschusses Dabei Auswahl der tatsächlich verwendeten Tafel

6 - Shopify

Im Lieferscheinmodul steht der Shop-Import im Shopify Format zur Verfügung.

Shopify Import

Dieser Import steht im Modul Lieferschein, im Menüpunkt Lieferschein, Import, Shopify CSV zur Verfügung. Die Grundidee ist, dass vom Shop täglich Daten abgeholt werden, z.B. über FTP Import und dann täglich diese Daten eingelesen werden. Da es dabei immer wieder zu erforderlichen Anpassungsarbeiten kommt, sehen wir den manuellen Import als sinnvoller an.

Zuordnung der Shopify Spaltenname:

Die Definition des Import-Files findet man unter

Bitte beachte die UTF8 Codierung.

Aus der Exportdatei werden die folgenden Spalten gelesen:

Prüflauf und Import

Der Import läuft in zwei Schritten. Nach der Auswahl der Datei erhältst du zunächst eine Liste mit den erkannten Hinweisen und Fehlern. Erst wenn du diese bestätigst, werden die Lieferscheine tatsächlich angelegt. Damit kannst du eine Importdatei gefahrlos prüfen, bevor du sie übernimmst.

Auswahl des Lagers von dem abgebucht werden sollte

Vor der Auswahl der Importdatei, muss angegeben werden, von welchem Lager der Importlauf abbuchen sollte. Das hat den Zweck, wenn du die Ware von verschiedenen (Außen-) Lagern an deine Kunden versendest, kannst du damit sehr elegant definieren von welchem dies eben durchgeführt werden sollte.

Import Datei

Wähle nun die Datei des Imports aus. Es wird dies in der Regel die orders_export.csv sein.

Fehlermeldung Versandkostenartikel nicht definiert

Bedeutet: Um die Versandkosten verrechnen zu können, wird ein Versandkostenartikel, der nicht lagerbewirtschaftet ist, benötigt. Hinterlege ihn im Modul System, unterer Reiter Parameter, im Mandantenparameter VERSANDKOSTENARTIKEL (Kategorie ALLGEMEIN). Ohne diesen Parameter wird der Import gar nicht erst gestartet.

Fehlermeldung Artikel xxxx nicht vorhanden

Bedeutet schlichtweg dass der aus dem Shop erhaltene Artikel in deinem Kieselstein ERP nicht angelegt ist.
Achte darauf, dass beide Artikelstämme synchron sind.

Fehlermeldung Lagerstand nicht ausreichend

INFO:
Bei chargengeführten Artikeln wird immer die älteste Charge zuerst abgebucht. Maßgeblich ist dabei der Zeitpunkt der Einbuchung in das ausgewählte Lager, nicht die Chargennummer.
Idealerweise organisierst du die Ware in deinem Lager so, dass immer nur eine Charge in dem Auslieferlager vorhanden ist. Erst wenn die gesamte Ware verbraucht ist, füllst du dieses nach. Somit ist eindeutig definiert, welche Chargen verwendet werden.