mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 04:27:14 +01:00
13 lines
14 KiB
Plaintext
13 lines
14 KiB
Plaintext
<h1>Netstock Anbindung</h1><strong>Administration</strong> → <strong>Appstore</strong> → <strong>Netstock </strong><br /><br />Die Netstock App erzeugt CSV-Dateien, die für die Übertragung von relevanten Informationen an Netstock dienen. Diese können dann entweder per FTP übertragen oder von einem definiertem Ordner auf dem Server abgeholt werden.Der zugehörige Prozessstarter netstock muss aktiviert werden um die unten beschriebenen Dateien zu erzeugen und zu übertragen.<h2>Einstellungen / Konfiguration</h2><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=netstock&fileid=1" /><br /> <h2>Bereiche zur Konfiguration</h2><h3>1. FTP-Settings</h3>Speicherung der Ausgangs-Dateien über eine FTP-Verbindung.<ul><li><strong>FTP-Server</strong> → Hostname des Servers</li><li><strong>FTP-Benutzer</strong> → Benutzername</li><li><strong>FTP-Passwort</strong> → Passwort</li></ul><h3>2. Lokale Dateien</h3>Speicherung der Ausgangs-Dateien in einem Ordner auf dem Server im Userdata-Verzeichnis.<ul><li><strong>Name des Ordners</strong> → Sstemverzeichnis des Austauschordners für Dateien</li></ul><h3>3. Lagereinstellungen</h3><ul><li><strong>Lager für Intern (Beistellungen)</strong> → Internes Lager für Beistellungen</li><li><strong>Lager für Extern</strong> → Externes Lager</li></ul><h3>4. Freifelder</h3><ul><li><strong>Freifeld für Warengruppe</strong> → Nicht vewendet (Defaultwert: freifeld5)</li><li><strong>Freifeld für den Bestandsindikator (stock.csv)</strong> → Zu verwendendes Freifeld für "Stocking Indicator" - Defaultwert: freifeld6.<br /><span style="color:#e74c3c;"><strong>Hinweis</strong></span>: Das Freifeld 6 Feld wird verwendet wenn keine Alternative eingetragen wurde!</li></ul><h3>5. Informationen</h3>Hier erhalten Sie einen Überblick über die erzeugten Dateien:Die Anwendung erzeugt csv-Dateien für: Lager/Filialen (location.csv), Lieferanten (supplier.csv), Artikelstamm (master.csv), Bestand je Lagerort (stock.csv), Verkauf & Verbrauch (sales.csv), Offene Lieferanten oder Produktionsbestellungen (po.csv) Diese werden entweder per FTP übertragen oder in einen Ablageordner auf dem Server hinterlegt.Die Dateien sind im Folgenden detailliert beschrieben.<h3>6. Monitor</h3>Im Monitor werden die letzten FTP-Übertragungen sichtbar. Hier können fehlerhafte Verbindungsversuche (z.B. durch Änderung von FTP-Zugangsdaten) erkannt werden.<h2>Netstock Dateitypen</h2>Folgende Dateitypen finden in Xentral Anwendung:<ul><li><strong>control.csv</strong> → Informationen über die Datenextraktionen</li><li><strong>master.csv</strong> → Artikelinformationen (Stammdaten)</li><li><strong>group.csv</strong> → Artikelkategorien (Stammdaten)</li><li><strong>bom.csv</strong> → Stücklisten (Stammdaten)</li><li><strong>supplier.csv</strong> → Aktive Lieferanten</li><li><strong>location.csv</strong> → physische Lagerorte (Lager und Filialen)</li><li><strong>stock.csv</strong> → Bestand je Lagerort</li><li><strong>sales.csv</strong> → Rechnungen und Gutschriften jeweils ab dem 1. Tag des Vormonats</li><li><strong>co.csv</strong> → Offene Aufträge</li><li><strong>po.csv</strong> → Offene Bestellungen und Produktionen</li><li><strong>pohist.csv</strong> → Erfüllte Bestellungen und Produktionen</li></ul><h3>Datei: control.csv</h3>Übersicht über die Grundeinstellungen der Netstock-Schnittstelle.<br />Die Datei umfasst immer nur die folgenden vier Zeilen.<br /><br />Beispielinhalt für die CSV Datei:<table border="1" cellpadding="1" cellspacing="1" style="width: 300px;"><thead>
|
|
<tr><th scope="col"><strong>Key</strong></th><th scope="col"><strong>Value</strong></th>
|
|
</tr>
|
|
</thead><tbody>
|
|
<tr><td>INTERFACE_VERSION</td><td>2.0.8</td>
|
|
</tr>
|
|
<tr><td>EXTRACTION_DATE</td><td>2019/07/17</td>
|
|
</tr>
|
|
<tr><td>EXTRACTION_TIME</td><td>12:00:36</td>
|
|
</tr>
|
|
<tr><td>HOST_SYSTEM_VERSION</td><td>19.3</td>
|
|
</tr>
|
|
</tbody></table> <h3>Datei: master.csv</h3>Übersicht über alle Artikel.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → Artikelnummer</li><li><strong>Beschreibung</strong> → Artikelname</li><li><strong>NETSTOCK Unit of Measure</strong> → Artikeleinheit</li><li><strong>Unit Volume</strong> → immer leer</li><li><strong>Unit Weight</strong> → Artikelgewicht</li><li><strong>Superseded Item Code</strong> → immer leer</li><li><strong>Superseded Item Factor</strong> → immer leer</li><li><strong>Not used</strong> → Artikelfeld 'gesperrt'</li><li><strong>Unique Identifier</strong> → Interne ID des Artikels, sichtbar in der URL</li></ul><h3>Datei: group.csv</h3>Umfasst derzeit die Artikelkategorien.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Identifier</strong> → Interne ID</li><li><strong>Value</strong> → (Numerischer) Wert</li><li><strong>Beschreibung → Name der Gruppe</strong></li></ul><h3>Datei: bom.csv</h3>Übersicht über die Stücklisten.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Finished Good Item</strong> → Artikelnummer</li><li><strong>Finished Good Item Location</strong> → Lager-ID</li><li><strong>Raw Material Item</strong> → Artikelnummer</li><li><strong>Raw Material Location</strong> → Lager-ID</li><li><strong>Ratio</strong> → Menge des Ausgangsartikels in der Stückliste</li></ul><h3>Datei: supplier.csv</h3>Übersicht über die Lieferanten.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Supplier</strong> → Lieferantennummer</li><li><strong>Beschreibung</strong> → Name des Lieferanten</li><li><strong>Type</strong> → immer leer</li><li><strong>Lead time</strong> → Durchnittslieferzeit aus den Einkaufspreisen</li></ul><h3>Datei: location.csv</h3>Physische Bestandsorte / Filialen (nicht Lagerpositionen).<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Location Code</strong> → Interne Id des Lagers</li><li><strong>Beschreibung</strong> → Bezeichnung des Lagers</li><li><strong>Active</strong> → immer 1</li><li><strong>Group</strong> → immer leer</li><li><strong>Type</strong> → 'ST' (Laden/Filiale) oder 'CW' (Zentrallager, Projekt-ID = 1) abhängig vom Projekt</li></ul><h3>Datei: stock.csv</h3>Der jetzige Bestand je Lagerort.<br />Es werden alle Lagerplätze berücksichtigt, die zum konfigurierten 'Lager für Intern (Beistellungen)' gehören und solche die als Produktionslager gekennzeichnet sind.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → Artikelnummer</li><li><strong>Location</strong> → Meistens Hauptlager, Konfiguriernbar in der Netstock App</li><li><strong>Date Added</strong> → leer</li><li><strong>Inventory Unit Cost</strong> → berechneter Einkaufspreis → wenn fehlt, dann "0"</li><li><strong>Purchase Unit Cost</strong> → Standard Einkaufspreis 1er Menge, wenn fehlt dann "0"</li><li><strong>Selling Price</strong> → Verkaufspreis für Menge 1, wird erst in zweiten Schritt erzeugt; Fallback? → schaut komisch aus → aber kommt der richtig im Schritt 2?</li><li><strong>Stock On Hand</strong> → Lagerbestand</li><li><strong>Allocated Stock</strong> → immer 0</li><li><strong>Supply Type</strong> → Konstanter Wert 'EX'</li><li><strong>Supply Code</strong> → Lieferantennummer, Standartlieferant kommt entweder aus EK Fallback Artikel</li><li><strong>Vendor Code</strong> → Lieferantennummer, Standartlieferant kommt entweder aus EK Fallback Artikel</li><li><strong>Purchase Unit of Measure</strong> → Artikel Einheit</li><li><strong>Purchase Factor</strong> → bleibt leer</li><li><strong>Purchase Currency Code</strong> → derzeit immer Euro; ggf. Wärung aus kalk. Ek nehmen (PASST, ist IMMER EUR)</li><li><strong>Lead Time</strong> → Standard Lieferzeit aus EK in Tagen, Fallback: wenn nicht angegeben, dann "0"</li><li><strong>Stocking Indicator</strong> → Ist ein konfigurierbares (Frei-)Feld in der Netstock App</li><li><strong>Minimum Stock</strong> → Artikel Mindestlager → wenn leer dann 0</li><li><strong>Minimum Order Qty</strong> → Artikel Mindestbestellmwnge → wenn leer dann 0</li><li><strong>Order Multiple</strong> → Artikel Mindestbestellmwnge → wenn leer dann 0</li><li><strong>Group 1</strong> → Artikelkategorie</li></ul><h3>Datei: sales.csv</h3>Verbrauch- und Verkaufs-Historie.<br />Eingeschränkt auf alle Einträge ab dem Ersten des Vormonats. Beispiel: Aktuelles Datum 15.07. - angezeigt werden Daten ab dem 01.06.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → RE/GS-Position Artikelnummer</li><li><strong>Location</strong> → Übernommen aus den Modul-Einstellungen (Lager für Intern (Beistellungen))</li><li><strong>Customer Code</strong> → Kundenummer von RE/GS; Fallback adresse.kundenummer</li><li><strong>Order Date</strong> → Auftrag Datum; (Auftrag in Gutschrift über die Rechnung gejoint);Fallback RE/GS-Datum</li><li><strong>Invoice/Issue Date</strong> → RE/GS-Datum</li><li><strong>Sales Quantity</strong> → RE/GS-Position Menge</li><li><strong>Cost of Sales</strong> → RE/GS-Position Menge * RE/GS-Position Einkaufspreis</li><li><strong>Sales Value</strong> → RE/GS-Position.umsatz_netto_gesamt; Fallback Preis Menge und Rabatt der Position</li><li><strong>Issues Quantity</strong> → immer leer</li><li><strong>Transaction Type</strong> → 'S' für Rechnung, 'R' für Gutschrift</li></ul><h3>Datei: co.csv</h3>Offene Kundenbestellungen.<br />Enthält alle Lagerartikel oder Artikel die keine Lagerartikel sind aber Kopf-Artikel von 'Just in Time'-Stücklisten.Unterelemente von 'Just in Time'-Artikeln werden ausgeschlossen.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → Artikelnummer</li><li><strong>Location</strong> → Übernommen aus den Modul-Einstellungen (Lager für Intern (Beistellungen))</li><li><strong>Customer Code</strong> → Kundennummer aus AU; Fallback Kundennummer aus Adresse (über Adresse aus AU)</li><li><strong>Order Number</strong> → AU Belegnummer</li><li><strong>Line Number</strong> → Sortierung aus Position</li><li><strong>Order Date</strong> → AU-Datum</li><li><strong>Order Quantity</strong> → AU-Position Menge</li><li><strong>Requested Date</strong> → Lieferdatum aus Position; Fallback Liefersdatum aus AU; Fallback Datum aus AU</li><li><strong>Outstanding Quantity</strong> → AU-Position Menge - AU-Position Geliefert</li></ul><h3>Datei: po.csv</h3>Enthält alle Positionen aller Produktionen deren Belegstatus nicht abgeschlossen, nicht storniert und nicht angelegt ist. Zusätzlich alle Bestellpositionen die nicht geliefert sind und deren Belegstatus nicht angelegt, nicht abgeschlossen und nicht storniert ist.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → Artikelnummer</li><li><strong>Location</strong> → Übernommen aus den Modul-Einstellungen (Lager für Intern (Beistellungen))</li><li><strong>Supplier Code</strong> → Lieferantennummer (bei Bestellungen: Lieferant der Bestellung, bei Produktionen: Standardlieferant des Artikels)</li><li><strong>Order Number</strong> → BE/PROD-Belegnummer</li><li><strong>Line Number</strong> → Sortierung aus Position</li><li><strong>Order Date</strong> → BE/PROD-Datum</li><li><strong>Order Quantity</strong> → Menge aus Position</li><li><strong>Expected Arrival Date</strong> → BE/PROD-Datum + Artikel-Lieferzeit</li><li><strong>Outstanding Quantity</strong> → BE/PROD-Menge aus Position - BE/PROD-Geliefert aus Position</li><li><strong>Order Type</strong> → 'P' für Bestellung, 'M' für Produktion</li><li><strong>Purchase Unit Cost</strong> → Wenn der Artikel ein Produktionsartikel ist dann Preis aus Position, ansonsten Kalkulierter EK</li></ul><h3>Datei: pohist.csv</h3>Enthält alle Positionen aller Produktionen deren Belegstatus abgeschlossen ist.<br />Und alle Bestellungspositionen die geliefert wurden aber auch alle Positonen die nicht geliefert wurden und deren Belegstatus abgeschlossen ist.<br /><br />Spalten der CSV-Datei und Beschreibung:<ul><li><strong>Item Code</strong> → Artikelnummer</li><li><strong>Location</strong> → Übernommen aus den Modul-Einstellungen (Lager für Intern (Beistellungen))</li><li><strong>Supplier Code</strong> → Lieferantennummer (gemappt über Lieferant aus BE oder PROD)</li><li><strong>Order Number</strong> → BE/PROD-Belegnummer</li><li><strong>Line Number</strong> → Sortierung aus Position</li><li><strong>Order Date</strong> → BE/PROD-Datum</li><li><strong>Order Quantity</strong> → Menge aus Position</li><li><strong>Expected Arrival Date</strong> → BE/PROD-Datum + Artikel-Lieferzeit</li><li><strong>Order Urgency</strong> → Dderzeit immer leer; Definiert als entweder ST = Standardbestellung oder EM = Expressbestellung (Bestellung mit deutlich geringerer Lieferzeit)</li><li><strong>Quantity Received</strong> → Das Feld 'Geliefert' aus BE/PROD-Position</li><li><strong>Date of Receipt</strong> → BE/PROD-Lieferdatum</li><li><strong>Purchase Unit Cost</strong> → Kalkulierter EK des Artikels</li></ul> |