mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 04:27:14 +01:00
1 line
31 KiB
Plaintext
1 line
31 KiB
Plaintext
<p><span style="font-size:28px;"><strong>Übertragungen (EDI / XML / CSV / PDF)</strong></span><br />Das Übertragen-Modul ist ein generisches Modul zum Austausch von Bewegungsdaten. Dabei werden ausgehende* Daten von Xentral zum Zielsystem geschickt oder zum Abruf bereitgestellt. Eingehende* Daten werden abgeholt, eingelesen und weiterverarbeitet.<br />* Die Richtung dieser Beschreibung bezieht sich auf die Perspektive von Xentral, also des ERPs.</p><br /><span style="font-size:16px;"><strong>Richtungen</strong></span><ul><li><strong>Ausgehend</strong> → Ausgehende Daten werden z.B. im FTP-Verzechnis abgespeichert um von dort abgeholt zu werden</li><li><strong>Eingehend</strong> → Eingehende Daten werden von außen in den Ordner kopiert und regelmäßig durch Xentral eingelesen und interpretiert bzw. z.B. zu Aufträgen umgewandelt</li></ul><h1><br />Features</h1>Im der Standardversion des Moduls stehen bereits vielfältige Möglichkeiten zur Anbindung z.B. an Versand- oder Fulfillment-Dienstleister zur Verfügung. Dabei werden typischerweise Aufträge an den Fulfiller gesendet und Versandinformationen zu Xentral zurückgespielt. Das System kann aber auch z.B. zur Übertragung von Lagerbestandsdaten (Lagerzahlen), zur Artikelübertragung oder zur Bereitstellung von Dokumenten wie Aufträgen, Lieferscheinen oder Rechnungen als PDF verwenden.<br /><br />Die folgenden <strong>technischen Übertragungsarten</strong> (Typ) stehen im Standard zur Verfügung:<ul><li>FTP</li><li>FTPS (Benutzername und Passwort, keine Zertifikate)</li><li>SFTP</li><li>E-Mail</li><li>Lokale Speicherung auf Server</li><li>API</li></ul>Folgende <strong>Übertragungsformate</strong> stehen im Standard zur Verfügung:<ul><li>XML</li><li>PDF</li><li>XML mit integriertem PDF (Base64-encodiert)</li><li>XML und PDF in separaten Dateien</li><li>CSV (Comma Separated Values, vereinfachtes Excel-Fomat)</li><li>API</li></ul>Mit Hilfe zusätzlicher <strong>Transfer-Module</strong> lassen sich weitere Schnittstellen und Übertragungsformate konfigurieren:<ul><li>AmazonMfn (Amazon MFN - Merchant Fulfillment Network)</li><li>AmazonVendor (Amazon Vendoren)</li><li>App4Sales (Offline Auftragserfassung für Aussendienst-Mitarbeiter)</li><li>Brickfox (Portal zur Anbindung multipler Dienste)</li><li>DS (DS Logistics)</li><li>EDI (Electronic Data Interchange)</li><li>EDI (Sport 2000)</li><li>GobNavConnect (Microsoft Navision in Kooperation mit GOB)</li><li>Netstock</li><li>OpenTrans (XML-Format)</li><li>Pixi (Descartes Pixi WMS)</li><li>Smarty (Template-Generator für beliebige Textformate)</li></ul><h1 id="list"><br />Monitor</h1><p>Der Monitor listet alle erfolgreichen und fehlerhaften Übertragungen des Moduls als filter- und durchsuchbare Liste. Dabei kann in der Filterung nach Fehlern oder nach Nachrichtenarten (z.B. Lagerbestand, Tracking, Artikel, Auftrag, Bestellung) unterschieden werden. Außerdem ist über die Liste der Account und damit die Gegenstelle filterbar.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3442" style="width: 1200px; height: 391px;" /></p><h1 id="freigabe"><br />Warte auf Freigabe</h1><p>Sofern Daten per Konfiguration in zwei Schritten bearbeitet werden sollen, z.B. weil in der Einführungsphase einer Schnittstelle diese auf <strong>Manuelle Freigabe erforderlich</strong> gesetzt wurde, erscheinen die zu übertragenden Nachrichten in diesem Tab und können hier freigegeben werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3443" style="width: 1200px; height: 233px;" /></p><h1 id="accounts"><br />Accounts</h1>Unter diesem Reiter sind alle angelegten Accounts aufgelistet.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3447" style="width: 1200px; height: 444px;" /><h2>Einrichtung</h2>Auf Basis eines API-Accounts (siehe unten) können beliebig viele Accounts für die Übertragung mit einem Gegenüber definiert werden. In vielen Fällen kann es sinnvoll sein, die Übertragungen auf mehrere Acccounts zu verteilen, z.B. um diese besser testen und monitoren zu können, aber auch wenn verschiedene Intervalle zu verwenden sind.<br />Ein Account kann dabei aus- und eingehende Nachrichten konfigurieren. In komplexeren Umgebungen kann es sinnvoll sein, diesen in zwei oder mehr Accounts aufzuteilen.<p><span style="font-size:16px;"><strong>API-Account</strong></span></p><p>Vor der Einrichtung eines oder mehrerer Accounts ist eine API anzulegen. Auch wenn diese in vielen Fällen keine URL oder Zugangsdaten für das Transfermodul benötigt, ist diese notwendig, um die Gegenstelle zu definieren. Es ist ratsam pro Gegenstelle mindestens einen API-Account anzulegen und in Bezug auf Nachrichtenart und -richtung nur einmal zu verwenden.<br /><br />Die Verwaltung der API-Accounts ist nicht Teil des Transfer-Moduls und kann im Bereich <strong>Administration</strong> → <strong>API-Account</strong> vorgenommen werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=2558" style="width: 1283px; height: 716px;" /><br /><br /><br />Hier wird zunächst ein neuer API-Account angelegt oder ein bestehender editert.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=2557" style="width: 1282px; height: 716px;" /><br /><br />Am Beispiel des XML-Accounts wird ersichtlich, das dieser bei der Verwendung für das Modul Übertragungen im Grunde nur anlegt und aktiviert werden muss, weitere Einstellungen sind im Regelfall nicht notwendig.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=2559" style="width: 1262px; height: 716px;" /><br /> </p><h2>Neuer Account anlegen</h2>Über den Button "+Neu" kann eine neue Übertragung angelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3444" style="width: 1200px; height: 758px;" /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3446" style="width: 1200px; height: 693px;" /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3445" style="width: 1200px; height: 630px;" /><br /><br /><span style="font-size:16px;"><strong>Einstellungen</strong></span><ul><li><strong>aktiv </strong>→ Auswahl, wenn die Übertragung genutzt wird. Bei Nichtauswahl, wird diese deaktiviert</li><li><strong>Bezeichnung </strong>→ Name der Übertragung, welche frei vergeben werden kann</li></ul><span style="font-size:16px;"><strong>Kommunikation</strong></span><ul><li><strong>API </strong>→ Auswahl eines API-Accounts</li><li><strong>Übertragungsfomat</strong> → Das Übertragungsformat bezeichnet das Format des Dateiinhaltes. In den meisten Fällen handelt es sich dabei um Textdateien die strukturierte Daten (wie CSV oder XML) enthalten, um auch auf der Gegenseite einfach ausgelesen und interpretiert werden zu können. Im Zweifel und bei vorhandener Flexibilität auf der Gegenseite sind in xentral immer die Standardformate zu wählen: (<strong>XML</strong> (<strong>Xentral-Standardformat</strong>), PDF (nicht strukturierte Daten z.B. zu Sicherungszwecken oder für Belegbasierte Weiterverarbeitung), XML mit integriertem PDF (Base64-encodiert), XML und PDF in separaten Dateien, <strong>CSV</strong> (<strong>Xentral-Standardformat</strong>, Comma Separated Values, vereinfachtes Excel-Fomat), API. Mit Hilfe zusätzlicher <strong>Transfer-Module</strong> lassen sich weitere Schnittstellen und Übertragungsformate konfigurieren: AmazonMfn (Amazon MFN Merchant Fulfillment Network), AmazonVendor (Amazon Vendoren), App4Sales (Offline Auftragserfassung für Aussendienst-Mitarbeiter), Brickfox (Portal zur Anbindung multipler Dienste), DS (DS Logistics), EDI (Electronic Data Interchange), EDI (Sport 2000), Gob NavConnect, Netstock, OpenTrans (XML-Format), Pixi (Descartes Pixi WMS), Smarty (Template-Generator für beliebige Textformate). Die Beschreibung der Formate und weitergehende Hinweise finden sich in den jeweiligen Modulen. Bitte zunächt das Übertragungsformat eines Accounts umstellen und dann im Modul die Hilfeseite aufrufen.</li><li><strong>Typ</strong> → Die folgenden <strong>technischen Übertragungsarten</strong> (Typ) stehen im Standard zur Verfügung: FTP, FTPS (Benutzername und Passwort, keine Zertifikate), SFTP, E-Mail, Lokale Speicherung auf Server, API</li><li><strong>Codierung</strong> (Senden) → Auswahl in welcher Codierung die Übertragung gesendet werden soll (UTF-8, ISO-8859-1, ISO-8859-15, Windows-1252, CP1256)</li><li><strong>Server</strong> → Angabe des Servers wo die Übertragung hingehen soll</li><li><strong>Port</strong> → Port am Empfängerserver der angesprochen wird</li><li><strong>SSL</strong> → Angabe, ob die Übertragung mit SSL verschlüsselt werden soll</li><li><strong>Username</strong> → der User der in xentral eingeloggt, wird durch xentral vorausgefüllt. Dieser lässt sich allerdings händisch ändern</li><li><strong>Passwort</strong> → Passwort in xentral des entsprechenden Users</li><li><strong>OAuth Client ID →</strong> Client-ID vom Dienst, bei dem die API eingerichtet ist</li><li><strong>OAuth Client Secret → </strong>Client Secret vom Dienst, bei dem die API eingerichtet ist</li><li><strong>OAuth URL → </strong>URL zu der die Berechtigung der Nutzung der Daten vom Dienst zurück an xentral geschickt werden soll</li><li><strong>Speicherort (Ausgang) →</strong> Ausgang der Belege von xentral (Optional wenn xentral von Fullfilment-Dienstleistern genutzt wird Ausgabe der "Sonstigen Aktionen" Lagerzahlen und Trackingnummern für Slave-xentral bzw. ERP von Kunden)</li><li><strong>Dateiname Prefix → </strong>Alle Dateinamen mit diesem Prefix werden ignoriert</li><li><strong>Antwort-Speicherort (Eingang) → </strong>Eingang für Aufträge, Lager, Tracking, Artikel etc.</li><li><strong>Antwort-Dateiname Prefix → </strong>Alle Antwort-Dateiennamen mit diesem Prefix werden ignoriert</li><li><strong>Löschen von Server nach Download → </strong>Diese Dateien werden nach dem Download vom Server gelöscht</li></ul><span style="font-size:16px;"><strong>Belege versenden</strong></span><ul><li><strong>Belegart → </strong>Verfügbare Belege für die Übertragung sind: Auftrag, Rechnung, Gutschrift, Angebot, Lieferschein, Bestellung, Retoure, Verbindlichkeit, Wareneingang QS-Report. Alternativ (z.B. wenn nur die Übertragung von lagerbestanswerten gewünscht ist kann "keine Belege" gewählt werden.</li><li><strong>Belegstatus → </strong>Angabe ob der Status angelegt, freigegeben, versendet oder abgeschlossen ist</li><li><strong>Projekt → </strong>zuordnung der Übertragung zu einem Projekt</li><li><strong>Adresse → </strong>Adresse zu der der Beleg gesendet werden soll</li><li><strong>Gruppe → </strong>Angabe zu welcher Gruppe die Adresse gehört</li><li><strong>Manuelle Freigabe erforderlich → </strong>Angabe, dass Belege zuerst manuel freigegeben werden</li><li><strong>Start ab ID → </strong>RechnungsID auswählen, ab der die Übertragung beginnen soll</li><li><strong>Start ab Datum → </strong>Datum ab dem die Übertragung starten soll</li><li><strong>Labels → </strong>Auswahl von selbstdefinierten Labels, die der Übertragung zugeordnet werden. In der Übersicht kann dann nach diesen Labels gefiltert werden, wobei zu beachten ist, dass wenn mehrere Labels vergeben werden, beim Filtern auch nach allen gefiltert werden muss, damit dies in der Übersicht erscheint.</li><li><strong>Briefpapier im XML → </strong>Auswahl, dass das Briefpapier Base64encodiert in XML gespeichert wird</li><li><strong>Maximale gleichzeitige Übertragungen → </strong>Anzahl der Belege, die der Prozessstarter gleichzeitig überträgt</li><li><strong>Jeder Beleg in einer eigenen XML → </strong>Auswahl, dass jeder Beleg in einer eigenen XML gespeichert wird</li><li><b>XML-Zusatz </b><strong>→ </strong>Angabe des XML-Zusatzes</li><li><strong>Tracking Mail → </strong>Angabe, dass eine Tracking-Mail versendet wird</li><li><strong>Rechnung Mail → </strong>Angabe, dass die Rechnungs E-Mail automatisch versendet wird, wenn die Trackingnummer vom Fulfiller zurückgemeldet wird. Bei mehreren Trackingnummern erfolgt der Versand der Rechnungs E-Mail nur einmal. Die Voraussetzungen hierfür sind, dass der Haken im Übertragungen Modul für "Rechnung Mail" gesetzt ist, die Rechnung mit den Kunden E-Mail Adressen und Kundennamen bereits vorhanden ist und dass der Rechnungsbetrag größer als 0 ist</li><li><strong>Rechnung anlegen → </strong>Auswahl, dass wenn der Lieferschien bzw. die Trackingnummer zurückgemeldet wird und die passende Rechnung noch fehlt, wird automatisch eine Rechnung angelegt</li><li><strong>Datei im Anhang übertragen → </strong>Auswahl, dass die Datei im Anhang übertragen wird</li><li><strong>Anhang übertragen als → </strong>Auswahl wie der Anhang übertragen werden soll (als eigene Datei oder Base64-Codiert im Beleg)</li></ul><span style="font-size:16px;"><strong>Belege empfangen</strong></span><ul><li><strong>Aufträge/ Angebote empfangen → </strong>Angabe, dass Aufträge bzw. Angebote empfangen werden sollen</li><li><strong>Kundennummer aus Fremdsystem übernehmen → </strong>Angabe, dass die Kundennummer aus dem Fremdsystem übernommen werden soll</li><li><strong>Bestellungen empfangen → </strong>Angabe, dass Bestellungen empfangen werden sollen</li><li><strong>Produktion statt Bestellung anlegen → </strong>Angabe, dass eine Produktion anstatt eine Bestellung angelegt werden soll</li><li><strong>Eigene Adresse → </strong>Auswahl der eigenen Adresse. Diese muss zuvor unter Stammdaten <strong>→ </strong>Adressen angelegt worden sein</li><li><strong>Lagerzahlen empfangen → </strong>Auswahl, dass die Lagerzahlen empfangen werden sollen</li><li><strong>Lagerplatz in Dateieingang ignorieren → </strong>Angabe, dass der Lagerplatz im Dateieingang ignoriert werden soll</li><li><strong>Lager → </strong>Lagerplatz für Rückmeldungen ohne Lagerplatzangabe</li><li><strong>Tracking empfangen → </strong>Angabe, dass ein Tracking empfangen werden soll</li><li><strong>Automatische Rückmeldung → </strong>Unabhängig von Lieferscheinen und Trackingnummern wird nach X Tagen spätestens ein Auftrag final abgeschlossen und eventuell an Shops und Marktplätze zurückgemeldet. Es werden nur Aufträge beachtet, die max. vor 14 Tagen per Übertragungenmodul versendet wurden</li><li><strong>Artikel empfangen Nicht gefundene Artikel → </strong>Angabe, dass wenn Artikel empfangen aber diese nicht gefunden werden, im Übertragen Monitor ein Fehler angezeigt wird</li><li><strong>Lieferantennummer auch durchsuchen → </strong>Angabe, dass Lieferantennummern ebenfalls durchsucht werden sollen</li><li><strong>Bestellung immer auf Leiferant buchen → </strong>Angabe, dass eine Bestellung immer auf den Lieferanten gebucht wird</li></ul><strong><span style="font-size:16px;">Artikel anlegen</span></strong><ul><li><strong>Fehlende Artikel anlegen</strong> → Angabe, dass fehlende Artikel aus Auftragspositionen automatisch angelegt werden sollen</li><li><strong>Fehlende Artikel als Lagerartikel markieren → </strong>Angabe, dass fehlende Artikel als Lagerartikel markiert werden sollen</li></ul><strong><span style="font-size:16px;">Artikel empfangen</span></strong><ul><li><strong>Artikel empfangen (neue Artikel)</strong> → Angabe, dass Artikeldaten beim empfangen beachten werden</li><li><strong>Artikel updaten</strong> → Angabe, dass bei Abweichungen von Artikeldaten zu den Stammdaten die abweichenden Informationen überschrieben werden sollen</li></ul><strong><span style="font-size:16px;">Lagerzahlen</span></strong><ul><li><strong>Lagerzahlen von xentral zu Fremdsystem</strong> → Angabe, dass die Lagerzahlen von xentral zum Fremdsystem übergeben werden sollen</li><li><strong>Lager</strong> → Auswahl des Lagers</li><li><strong>Lagerplatz</strong> → Auswahl des Lagerplatzes</li><li><strong>"Verkaufbare" Menge senden</strong> → Angabe, dass die verkaufbare (vorhandene - reservierte Menge) Menge gesendet werden soll</li><li><strong>Übertragung um </strong>→ Angabe der Uhrzeit, wann die Übertragung stattfinden soll</li></ul><strong><span style="font-size:16px;">Verkaufsreport</span></strong><ul><li><strong>Verkaufsreport senden</strong> → Angabe, dass ein Verkaufsreport gesendet werden soll</li><li><strong>Zeitbereich</strong> → Auswahl, ob der Verkaufsreport täglich, wöchentlich oder monatlich gesendet werden soll</li></ul><strong><span style="font-size:16px;">sonstige Aktionen</span></strong><ul><li><strong>Tracking von xentral zu Fremdsystem</strong> → Angabe, dass ein Tracking von xentral zum Fremdsystem stattfinden soll</li><li><strong>Artikel übertragen</strong> → Mit diesem Button können Artikel auf das Fremdsystem übertragen werden</li><li><strong>automatisch neue Artikel übertrage</strong> → Angabe, dass neue Artikel automatisch auf das Fremdsystem übertragen werden</li></ul><strong><strong></strong></strong><h2>Events</h2>In diesem Tab kann "ArtikelCreate" und "ArtikelEdit" ausgewählt werden, dies bewirkt, dass<h2><br /><br />Nicht freigegeben</h2>In diesem Tab liegt eine Auflistung aller zu übertragenden Dateien, die manuell freigegeben werden müssen. Dies funktioniert, indem die entsprechenden Übertragungen ausgewählt und dann über den Button "freigeben" freigegeben werden.<h2><br /><br />Zu Übertragen</h2>In diesem Tab können die Belege, die übertragen werden sollen, ausgewählt und anschließend mit dem Button "Auftrag zum Übertragen hinzufügen" in die Liste hinzugefügt werden. Bei der nächsten Übertragung werden diese Belege hinzugefügt und wandern in den Tab "Übertragen". Die Abarbeitung der hier gesammelten Dokumente erfolgt via Prozessstarter und ist pro Durchlauf auf eine Anzahl limitiert (Limitierung bei den Einstellungen zur Schnittstelle). Belege können über den Button "Requests löschen" wieder aus der Liste entfert werden.<h2><br /><br />Übertragen</h2>In diesem Tab liegt eine Auflistung aller Belege, die bereits übertragen wurden. Der Liste kann u. a. das Datum und die Uhrzeit der Übertragung entnommen werden. Die Dateien können auf dem Server gelöscht werden. Die Übertragungshistorie wird zusätzlich abgespeichert und protokolliert.<h2><br /><br />Dateien</h2>In diesem Tab befinden sich die übertragenen XML Dateien. Auch wenn die Dateien auf dem Server gelöscht werden, wird die Historie hier angezeigt.<br /><br /> <h2><br />Tracking</h2>Wurde unter dem Tab "Details" die Trackingoption ausgewählt, erscheinen hier alle Trackingdaten aufgelistet. Es werden also alle zurückgemeldeten Trackingnummern angezeigt. Übertragene Dokumente ohne Tracking Nummern können im Tab "Übertragen" eingesehen werden.<br /> <h2><br />Lagerzahlen</h2>Wurde unter dem Tab "Details" die Lagerzahlenoption ausgewählt, erscheinen hier alle zurückgemeldeten Lagerzahlen aufgelistet.<br /> <h2><br />Fehler</h2>Wurde unter dem Tab "Details" die Option "Artikel empfangen Nicht gefundene Artikel" ausgewählt, so erscheinen alle Fehler aufgelistet in dem Tab "Fehler". Dies entspricht also einem Fehlerprotokoll aller nicht verarbeiteten Daten. Kann eine Tracking Nummer nicht dem passenden Dokument zugeordnet werden, so wird hier im Fehlerprotokoll ein Eintrag erzeugt. Gibt es zu einem Dokument nach wie vor keine Tracking Nummer, so kann im Fehlerprotokoll nachgeprüft werden, ob es hier evtl. eine falsche Rückmeldung gab. Gibt es keine Einträge, so wurde die Trackingnummer auch nicht zurück gemeldet.<br /> <h2><br />Verkaufsreport</h2>Wurde unter dem Tab "Details" die Option " Verkaufsreport senden" ausgewählt, erscheinen alle erstellten Verkaufsreports aufgelistet in dem Tab "Verkaufsreport".<br /> <h2> </h2><h1>Beispielhafte Anwendungsfälle</h1><h2>Anwendungsfall: Anbindung an Fulfillment-Dienstleister</h2> Die Anbindung an einen Fulfillment Dienstleister ermöglicht u.a. die Übertragung von XML-Strukturen oder CSV-Dateien an einen Fulfiller und im Anschluss daran das Einlesen der vom Fulfiller zurückgemeldeten Daten wie z.B. Trackingnummern, Lagerbestände, Mindesthaltbarkeitsdaten etc. Die Schnittstelle ermöglicht ebenso ein Einlesen von neuen Kundenaufträgen z.B. aus einer externen Software/Auftragsplattform (z.B. EBISS).<br />Generell ist es möglich Daten als Datei auf einem Server abzulegen. Diese Daten werden dann vom Fulfiller abgeholt und weiterverarbeitet. Der Fulfiller meldet im Anschluss z.B. 1x täglich (nachts) die Trackingnummern, aktualisierte Lagerbestände und z.B. auch MHDs an den Server zurück. Diese Daten werden über einen Cronjob von Xentral eingelesen und im System aktualisiert. Eine Rückmeldung an Shops zur Bestandsaktualisierung oder der Trackingnummer an den Shop, als gleichzeitigen Trigger für eine Rechnungs-E-Mail, sind parallel möglich.<br /><br />Die Weiterverarbeitung der Daten und das Ablegen der Rückmeldungs-Datei für Xentral mit den notwendigen Feldern wird meist durch den Fulfiller definiert und erstellt.<br />Im folgenden Ablaufschema ist die Interaktion zwischen Xentral, einem Onlineshop / Marktplatz und einem Versanddienstleister / Fulfiller im Grundsatz dargestellt.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=1" /><h2>Anwendungsfall: Anbindung einer externen Plattform</h2>Die Schnittstelle ermöglicht ebenso ein Einlesen von neuen Kundenaufträgen z.B. aus einer externen Software/Auftragsplattform (z.B. e.biss oder App4Sales).<br />Dabei werden benötigte Stammdaten (Arttikel oder Kundennamen) in beiden Systemen synchronisiert. Die Auftragserfassung kann z.B. auch offline erfolgen.<h2><br />Dokumente aus Xentral übertragen (Ausgang)</h2>Einstellungen der ausgehenden XML oder CSV Daten.<br />Um die Übertragung einer XML- oder CSV Datei von Xentral nach außen zu ermöglichen, muss zuerst unter Admin → Einstellungen → Prozessstarter der Cronjob "api_uebertragungen" angelegt und aktiviert werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3448" style="width: 1200px; height: 678px;" /><br /><br />Im nächsten Schritt muss ein API_Account angelegt werden. Dazu ist unter Einstellungen → API Account über "+NEU" ein neuer Account anzulegen, der wie folgt auszufgefüllt werden kann (wichtig hierbei ist, dass der Haken bei aktiv gesetzt ist): <br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3449" style="width: 1200px; height: 403px;" /><br /><br />Im nächsten Schritt kann im Appstore unter Übertragungen (EDI/XML/CSV/PDF) eine neue Übertragung eingerichtet werden. Im folgenden Beispiel soll eine XML-Übertragung für Rechnungen via Email angelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3451" style="width: 1200px; height: 711px;" /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3450" style="width: 1200px; height: 695px;" /><br /><br />Unter API kann der eingerichtete Account hinterlegt werden. Unter XML-Zusatz kann die ausgehende XML-Datei um kundenspezifische Zusatzspezifikationen erweitert werden. Unter "Start ab ID" kann die RechnungsID gewählt werden, ab der die Übertragung beginnen soll. Um zu testen, ob die Übertragung erfolgreich eingerichtet wurde, kann der Prozessstarter und die Übertragung aktiviert sowie die letzte Rechnungs-ID und den dazugehörigen Status eingetragen und abgespeichert werden. Nach Ablauf des eingestellten Intervalls sollte eine Email mit der XML-Datei zugestellt werden.<h2><br /><br />Anbindung an einen Fulfillment Dienstleister</h2>Es wird ein Online-Shop betrieben, der bereits an Xentral angebunden ist. Nun soll der gesamten Versandprozess über einen Fulfillment-Dienstleister abgewickelt werden. Der Dienstleister erhält von Xentral die Informationen des Lieferscheins und meldet eine Trackingnummer und den Lagerabzug zurück. Um diese Rückmeldung zu erhalten, muss eine Übertragung eingerichtet werden. Es gibt vier Möglichkeiten die Daten an den Dienstleister zu schicken:<ul><li>FTP</li><li>FTPS (nur mit Benutzername + Passwort, nicht bei der Nutzung von Zertifikaten)</li><li>E-Mail</li><li>Lokales Verzeichnis auf Server von Xentral</li></ul><br />Zudem gibt es die folgenden Übertragungsformate, die im DropDown ausgewählt werden können:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3452" style="width: 1200px; height: 654px;" /><br /><br />Die Daten können über das Modul neben einer XML-Datei auch als CSV-Datei übertragen werden.<br /><br />Unter „+Neu“ kann nun eine Übertragung zum Fulfillment Dienstleister angelegt werden. Dort kann auch die Art bzw. der Typ der Übertragung und das Datenformat festgelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3454" style="width: 1200px; height: 759px;" /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3453" style="width: 1200px; height: 660px;" /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3455" style="width: 1200px; height: 668px;" /><br /><br />Im Bereich Kommunikation kann dann der FTP-Account mit den Ein- und Ausgangsordnern hinterlegt und entschieden werden, ob die von der zurückmeldenden Stelle abgelegten Dateien (bspw. Tracking) nach dem Download vom Server gelöscht werden sollen. Im Bereich Belege Versenden können alle Einstellungen für ausgehende Dateien vorgenommen werden. Im Ausgang muss die Belegart, der Status und/oder eine BelegID oder ein Datum angegeben werden, ab dem die Übertragung stattfinden soll. Zudem kann festlegt werden, welche Email-Benachrichtigungen an die Adresse versendet werden sollen.<br /><br />Sollen Dateien mit an den Fulfillment-Dienstleister übertragen werden (PDF-Datei vom Lieferschein bzw. weitere Anhänge) muss zudem folgende Option aktiviert sein: "Datei Anhang übertragen" (Reiter Accounts).<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3456" style="width: 1200px; height: 178px;" /><br /><br />Im Bereich "Belege empfangen" kann festgelegt werden, welche Belege vom System empfangen werden sollen. Zudem ist es in diesem Bereich auch möglich Lagerzahlen von Fremdsystemen zu empfangen und diese auf ein bestimmtes Lager in Xentral zu mappen. Außerdem kann hier das Empfangen von Tracking-Nachrichten als Antwort auf den übermittelten Lieferschein und von Artikel aus Fremdsystemen aktiviert werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3457" style="width: 1200px; height: 348px;" /><br /><br />Im Bereich Lagerzahlen kann die Übertragung der Lagerzahlen zu einem Fremdsystem konfiguriert werden. Wenn hier kein Lager oder Regal ausgewählt wurde, kann der komplette Bestand des Systems an das Fremdsystem übertragen werden. Sollte eine Angabe bei Lager oder Lagerplatz vorhanden sein, wird die Übertragung dementsprechend eingeschränkt. Außerdem können verschiedene Zeitpunkte definiert werden, an denen die Übertragung stattfinden soll.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=uebertragungen&fileid=3458" style="width: 1200px; height: 408px;" /><br /><br />Hinweis: Der API Account für das Feld "API" wird unter Administration → Einstellungen → API Account angelegt.<br /><br />Um die Rückmeldung des Fulfillment-Dienstleisters vom FTP-Server abzuholen, muss über Admin → Einstellungen → Prozessstarter ein neuer Cronjob angelegt werden. Dieser holt die zurückgemeldeten Lieferungen in einem definierten Zeitintervall ab und spielt diese in Xentral ein. Nähere Informationen zur Einrichtung des Cronjobs befindet sich <a href="http://helpdesk.wawision.de/doku.php?id=entwickler:prozessstarter#prozessstarteruebertragungs_modul_fulfillment">hier</a>.<br />Werden die Lieferungen erfolgreich zurückgemeldet, so füllt sich die Liste der Übertragungen.<br /><br /><br /> |