Elektronischer Datenaustausch EDI
Werbung
Elektronischer Datenaustausch EDI ( Stand 1.10.2014 ) Inhaltsverzeichnis 1. Allgemeines......................................................................................................................................3 2. Elektronische Rechnungen (PDF)....................................................................................................3 3. Kataloge............................................................................................................................................3 4. Webservices (Echtzeitabfragen).......................................................................................................5 2.2 Verfügbarkeiten/Bestände..........................................................................................................5 2.2 Preise/Rabatte............................................................................................................................6 5. Tagesaktuelle Preise..........................................................................................................................7 6. EDI...................................................................................................................................................7 6.1 Allgemein...................................................................................................................................7 6.2 openTRANS...............................................................................................................................8 6.3 Encoding....................................................................................................................................8 6.4 Übertragung...............................................................................................................................8 1. Allgemeines In diesem Dokument werden die Dienste beschrieben, die von der MICHAELTELECOM AG angeboten werden, um mit unserem Hause Daten elektronisch auszutauschen. Wir bieten an: • Elektronische Rechnungen (PDF) • Kataloge (Artikeldaten und Preise in verschiedenen Formaten) • Webservices für Realtime-Abfragen (Preise, Verfügbarkeit, Rabatte,...) • Preislisten (tagesaktuell) • EDI (Elektronisches Bestellwesen, E-Procurement) 2. Elektronische Rechnungen (PDF) Wenn Sie statt Papierrechnungen elektronische Rechnungen im PDF Format wünschen, so können Sie über folgenden Link Details erfahren. https://michael-telecom.de/kundencenter/einstellungen 3. Kataloge Wünschen Sie Artikeldaten, Preise, Ihre Rabatte und möchten Ihre Auswahl auf bestimmte Produktkategorien einschränken, so benutzen Sie unseren Kataloggenerator unter https://www.michael-telecom.de/kundencenter/kataloggenerator Um einen neuen Katalog zu erstellen klicken Sie bitte auf 'Katalog erstellen'. Geben Sie im Bereich 'Allgemein' einen Namen für Ihren Katalog an und wählen Sie das gewünschte Format (Excel, CSV, Datanorm,...). Das Sortiment der MICHAELTELECOM AG wird fortlaufend erweitert. Wenn Sie einen Haken an die Optionen „neue Kategorien automatisch hinzufügen“ und „neue Hersteller automatisch hinzufügen“ setzen, bleibt Ihr Katalog auf dem neuesten Stand. Details zur Auswahl der Kategorien und Hersteller finden Sie weiter unten. Hier können Sie konfigurieren, welche Artikeldaten Sie wünschen. Wählen Sie im Bereich 'Felder' aus, welche Artikeldaten Sie wünschen. Im Bereich Kategorien wählen Sie Ihre interessanten Produktgruppen aus. Mit einem Klick auf 'Alle' im Kopfbereich werden alle verfügbaren Produktgruppen ausgewählt. Im Kasten Produktgruppe können Sie durch einen Klick auf 'Alle', die Produktgruppen auswählen, die zur ausgwählten Hauptgruppe gehören. Im Bereich Hersteller wählen Sie die gewünschen Hersteller aus. In der Regel klicken Sie dort auf 'Alle'. Zum Abschluss klicken Sie auf 'Speichern' um Ihren persönlichen Katalog zu speichern. Sie gelangen dann zur Übersicht. Mit einem Klick auf können Sie den Katalog downloaden. INFO: Mit einem Rechtsklick auf können Sie die Linkadresse kopieren und den Katalog außerhalb des Portals downloaden OHNE angemeldet zu sein. Dies ist nützlich bei regelmäßigen, automatisierten Downloads. 4. Webservices (Echtzeitabfragen) Derzeit stehen Webservices für die Abfrage folgender Daten zur Verfügung • • • • Lagerbestände Verfügbarkeiten Preisen Rabatten Um die folgenden Webservices zu nutzen, brauchen Sie einen 10-stelligen Schlüssel, diesen finden Sie als Webservice Key im Kundencenter unter: https://michael-telecom.de/kundencenter/einstellungen Dieser Schlüssel wird an die jeweilige URL angehängt. Näheres dazu finden Sie unten in der Beschreibung der neuen Webservices. In den Bespielen unten wird ein ungültiger Schlüssel verwendet. Bitte ersetzen Sie Ihn durch Ihren eigenen. Geben Sie Ihren Schlüssel nicht weiter. 2.2 Verfügbarkeiten/Bestände https://michael-telecom.de/ws/stock Für die Benutzung brauchen Sie den o.g. Schlüssel, diesen fügen Sie mit dem Parameter key an die URL an. Verfügbarkeit aller Artikel: https://michael-telecom.de/ws/stock?key=0a4773ab49 Bitte verwenden Sie für die Abfrage aller Artikel diese Option. Rufen Sie nicht jeden Artikel einzeln auf. Für die Abfrage der Verfügbarkeit (lieferbar oder nicht verfügbar) nur eines Artikels fügen sie den Parameter articleid hinzu, gefolgt von der Artikelnummer: Verfügbarkeit eines Artikels: https://michael-telecom.de/ws/stock?key=0a4773ab49&articleid=17490 Die Daten kommen in einem neuen, übersichtlicheren XML-Format. Wenn Sie das alte Format weiterbenutzen wollen, so fügen Sie den Parameter format=xmlold Verfügbarkeit im alten XML Format: https://michael-telecom.de/ws/stock?key=0a4773ab49&articleid=17490&format=xmlold Sie können die Daten auch, wie gehabt, im CSV Format abrufen. Setzen Sie dafür für den Parameter format den Wert csv. Verfügbarkeit im CSV Format: https://michael-telecom.de/ws/stock?key=0a4773ab49&articleid=17490&format=csv Möchten Sie nicht nur wissen, ob ein Artikel verfügbar ist, sondern wollen Sie einen annähernd realen Lagerbestand abrufen, so setzen Sie den Parameter real. Reale Lagerbestände abfragen: https://michael-telecom.de/ws/stock?key=0a4773ab49&articleid=17490&real=1 2.2 Preise/Rabatte Für Preise und Rabatte benutzen Sie folgenden Basis-Link: https://michael-telecom.de/ws/price Preise aller Artikel: https://michael-telecom.de/ws/price?key=0a4773ab49 Bitte verwenden Sie für die Abfrage aller Artikel möglichst diese Option. Rufen Sie nicht jeden Artikel einzeln auf. Preis eines Artikels: https://michael-telecom.de/ws/price?key=0a4773ab49&articleid=17490 Preis im alten XML Format: https://michael-telecom.de/ws/article?key=0a4773ab49&articleid=17490&format=xmlold Verfügbarkeit im CSV Format: https://michael-telecom.de/ws/stock?key=0a4773ab49&articleid=17490&format=csv 5. Tagesaktuelle Preise Alle tagesaktuellen Preise finden Sie im neuen Kundencenter unter https://michael-telecom.de/kundencenter/preislisten Zum skriptgesteuerten Download der tagesaktuellen Preislisten müssen Sie nicht angemeldet sein. Nutzen Sie den o.g. Schlüssel. Tagesaktuelle Handy Preisliste: https://michael-telecom.de/private?key=0a4773ab49&file=gsm_preis_rabatt.xls Tagesaktuelle Preise: https://michael-telecom.de/private?key=0a4773ab49&file=mtpreise.zip 6. EDI 6.1 Allgemein In diesem Dokument wird der Begriff „EDI“ (EDI, Electronical Data Interchange, Elektronischer Datenaustausch) allgemein für den automatisierten und strukturierten Datenaustausch zwischen Organisationen auf elektronischem Wege verwendet, um eine Abgrenzung zu spezifischen Standards (z.B. EDIFACT) zu schaffen. EDI wird verwendet, um elektronische Geschäftsdokumente zwischen mehreren, meist verschiedenen Systemen zu übertragen. Für weiterführende Informationen siehe Wikipedia. Der Einsatz von EDI spart Zeit und Geld, da viele Bearbeitungsschritte vereinfacht bzw. automatisiert werden (manuelle Dateneingabe, Archivierung von Dokumenten, Übertragung auf dem Postweg, ...). Des weiteren können Kosten für Papier, Büromittel, Porto und Verpackung eingespart werden. Dieser Artikel konzentriert sich auf den Austausch von Geschäftsdokumenten im Bereich des E-Procurement (Elektronisches Beschaffungswesen). Diese Dokumente sind derzeit: • Bestellung • Auftrags-Eingangsbestätigung • Lieferavis • Rechnung (original) Intern arbeitet die MTAG im Rahmen von EDI mit dem freien Standard openTRANS (www.opentrans.de), daher bevorzugen wir diesen Standard auch bei der Kommunikation mit Partnern. Sollten potenzielle Geschäftspartner noch keinen bevorzugten Standard etabliert haben, so stehen wir bei der Implementierung von openTRANS gerne beratend zur Verfügung. Davon abweichend bieten wir nach Absprache auch die Verarbeitung von alternativen Formaten (z.B. CSV) oder auch proprietären Formate, etc. an. Eine mögliche Implementierung erfolgt nach Aufwandsabschätzung. Sprechen Sie uns einfach darauf an. 6.2 openTRANS openTRANS ist ein EDI-Standard basierend auf XML. Derzeit unterstützen wir für eingehende Dokumente ausschließlich openTRANS Version 1.0 und 2.1 Es wird dringend empfohlen, openTRANS Dokumente, die für die MICHAELTELECOM AG erstellt werden, einer XSD Schema Validierung zu unterziehen. Dies bietet einen enormen Nutzen bei der Fehlervermeidung. Die von der MTAG ausgehenden Dokumente liegen in der Version 1.0 vor. Eine sehr detaillierte Dokumentation sämtlicher openTRANS Dokumente, sowie Beispieldokumente finden sie unter www.opentrans.de. Ebenfalls finden Sie dort XML-Schema (XSD) Dateien um selbst eine Validierung von bestehenden Dokumenten vornehmen zu können. Für den Download müssen Sie sich registrieren. 6.3 Encoding Bei der Verarbeitung von openTRANS Dokumenten ünterstützen wir alle gängigen Zeichenkodierungen. Voraussetzung dafür ist allerdings, dass die Beschreibung im XML Dokument (Attribut 'encoding') dem tatsächlichen Characterset im Dokument entspricht. Die Antwortdokumente sind generell in UTF-8 kodiert. Sollte dies bei der Verarbeitung in Ihren Systemen zu Problemen führen, so setzen Sie sich bitte im Vorfeld mit uns in Verbindung. Beispieldokumente erhalten Sie separat im Anhang. 6.4 Übertragung Für den Empfang der von Ihnen gesendeten Dokumente stellen wir einen verschlüsselten Zugang via HTTPS und vorangehender Basic Authentifizierung zur Verfügung. Die URL und die Zugangsdaten werden Ihnen vor der Testphase mitgeteilt. Bei der Übermittlung eines Dokuments (z.B. Bestellung) wird das Dokument (hier openTRANS ORDER) im Body des HTTP Requests (POST) verwendet. Für die Erstellung eines HTTP Requests stehen eine Reihe von Open Source Bibliotheken zur Verfügung (LWP für Perl, Curl für PHP, etc.). Im Gegenzug als Antwort auf von Ihnen erhaltene Daten versenden wir folgende Antwortdkumente an unsere Kunden: • Auftragsbestätigung • Lieferavis • Rechnung Während wir der Einfachheit halber für den Versand von Dokumenten an Ihre System ebenfalls HTTPS bevorzugen, bieten wir zusätzlich auch andere Transportarten an. Diese sind: • Mail • FTP • SCP • weitere auf Anfrage Entsprechende Server sind auf der Kundenseite zur Verfügung zu stellen. Für weitere Informationen über elektronischen Datenaustausch mit der MICHAELTELECOM AG besuchen Sie den Bereich EDI im Kundencenter https://michael-telecom.de/kundencenter/edi Bei Fragen wenden Sie sich bitte an Ihren Ansprechpartner. Ihre MICHAELTELECOM AG
