API-Überblick zu M3 Transportation Execution Interface

M3 TEI – API-Überblick

Die verschiedenen in diesem Dokument beschriebenen API-Transaktionen sind für die gemeinsame Verwendung mit dem Transportation Execution Interface (TEI) vorgesehen. Durch die Verwendung dieser Transaktionen können Sie Logistik- und Geschäftsinformationen von M3 BE abrufen und diese an Infor Enterprise Collaborator senden (IEC). IEC erstellt dann eine Ausgabedatei, die an ein externes Transportausführungssystem (Transportation Execution System, TES) gesendet wird.

Bei jeder Implementierung können auch andere API-Transaktionen verwendet werden, die nicht in diesem Dokument beschrieben sind. Die aufgeführten Transaktionen sind die zentralen, in jeder Implementierung am häufigsten genutzten Transaktionen.

In der folgenden Abbildung werden die gängigsten APIs, die bei der Implementierung von TEI zum Einsatz kommen, dargestellt.

Die unten stehende Liste liefert eine Übersicht über die am häufigsten am Prozess beteiligten APIs.

• MYS500MI – TEI-Transferschnittstelle

  Die API wird über IEC zur Verwaltung von TEI-Transferinformationen und zur Rücksendung von Statusinformationen zur IEC-Verarbeitung an die M3 BE-Berichterstellung verwendet. MYS500MI beinhaltet außerdem Transaktionen, mit denen Logistikinformationen von verschiedenen Lieferungsnummern oder Sendungen übernommen werden können. Die Verwendung dieser API ist wichtig, wenn Transportausführungssysteme mehrere Lieferungsnummern in einem gemeinsamen Dokument zusammenfassen müssen – zum Beispiel für die Zolldeklaration. Auch wenn mehrere Lieferungen in einem Frachtdokument zusammengefasst werden, kommt die API zum Einsatz.

  MYS500MI umfasst die folgenden Transaktionen:

  Name	Abrufen und Zusammenfassen von Packstückinformationen für eine Lieferungsnummer, die anhand verschiedener Verpackungs-IDs unterteilt sind
  GetHead	Abrufen einer anhand verschiedener Felder gefilterten Liste von Packstücken für eine Lieferungsnummer
  LstDetail	Generierung von MFTRNS-Details, wenn das MWS010-Feld 240 (Packrückmeldemethode) gleich 0 (keine Paketrückmeldung) oder 1 (einfache Packrückmeldung) ist
  LstPackGrp	Die Transaktion LstPackGrp sorgt für die Verknüpfung der Funktion "Lieferung. Packstücke verbinden" (MWS423). Der Zweck der Transaktion ist das Abrufen zusammengefasster Packstückinformationen. Die Gruppierung wird für einen TEI-Transferkopf vorgenommen. Das bedeutet, dass mehrere Lieferungsnummern in einer Ausgabeantwort zusammengefasst werden. Hinsichtlich der Packstückgruppierung kann dies basierend auf den Feldern "Verpackung" oder "Verpackungstyp" erfolgen. "Verpackung" ist die ID einer bestimmten Verpackung, in bzw. mit der Waren verpackt werden. "Verpackung" ist definiert in "Verpackung. Öffnen" (MMS050). "Verpackungstyp" ist die ID für eine Gruppe von Verpackungen, die für einen logischen Zusammenhalt sorgen. "Verpackungstyp" ist definiert in "Verpackungstyp. Öffnen" (DRS080). Ein einfaches Beispiel wären zwei Verpackungen, ein kleiner Aufbewahrungsbehälter und ein zweiter großer Aufbewahrungsbehälter. Der Verpackungstyp wäre dann unabhängig von der Größe Aufbewahrungsbehälter. Diese zwei IDs können in verschiedenen Implementierungen unterschiedlich genutzt werden. Die API-Transaktion kann für die Gruppierung nach einer der zwei IDs verwendet werden. Der Output von LstPackGrp gibt Information wieder, die auf der Packstückstufe, Tabelle "MPTRNS", geführt und in "Lieferung. Packstücke verbinden" (MWS423) dargestellt werden, und sich für die Verpackungsgruppierung eignen. Es werden keine Informationen in Bezug auf die Chargennummern oder Artikel bereitgestellt, die in eine Gruppe von Packstücken gepackt werden. Das liegt daran, dass eine Packstückgruppe viele Artikel und/oder Chargennummern enthalten kann. Die Transaktion "LstPackGrp" wird nur für TEI-Transfers verwendet, die mit ausgehenden oder eingehenden Lieferungsnummern und nicht mit Einkaufsaufträgen in Verbindung stehen.
  LstPackages	Die Transaktion LstPackages sorgt für die Verknüpfung der Funktion "Lieferung. Packstücke verbinden" (MWS423). Der Zweck der Transaktion ist das Abrufen einer Liste, die aus den Packstücken für einen TEI-Transferkopf besteht. Das bedeutet, dass mehrere Lieferungsnummern in einer Ausgabeantwort zusammengefasst werden. Die Anforderung zur Auflistung einer Serie an Packstücken muss für die Hauptschlüssel "Firma" (CONO), Sendungsrichtung (E0IO), Richtung (INOU) und TEI-Transfer-ID (TINR) ausgeführt werden. Zusätzlich zu diesen Hauptschlüsseln ist die optionale Filterung nach Packstückstufe (PACO), Verpackung (MMS050) oder Verpackungstyp (DRS080) möglich. PACO wird entweder mit der gewünschten Stufe (000, 001 usw.) oder mit 999 ausgefüllt, wenn keine Filterung notwendig ist. PACT oder PACK wird mit dem Codewert ausgefüllt, nach dem Sie filtern möchten. Alle Packstücke für eine TRID, werden mit den Filterwerten abgeglichen und qualifiziert/ignoriert. Der Output von LstPackages gibt Informationen wieder, die auf der Packstückstufe, Tabelle "MPTRNS", geführt und in "Lieferung. Packstücke verbinden" (MWS423) dargestellt werden. Alle relevanten Felder aus "MPTRNS" werden in den Output übertragen. Es werden keine Informationen in Bezug auf die Chargennummern oder Artikel bereitgestellt, die in ein Packstück gepackt werden. Das liegt daran, dass ein Packstück viele Artikel und/oder Chargennummern enthalten kann. Die Transaktion "LstPackages" wird nur für TEI-Transfers verwendet, die mit ausgehenden Lieferungsnummern und nicht mit Einkaufsaufträgen oder eingehenden Verteilaufträgen in Verbindung stehen.
  LstStatNo	Die Transaktion LstStatNo sorgt für die Verknüpfung der Funktion "Packstückdetail. Öffnen" (MMS473). Der Zweck der Transaktion ist das Abrufen einer Liste, die aus den Kombinationen aus Zollstatistiknummer, Zollverfahren und Ursprungsland für einen TEI-Transferkopf besteht. Das bedeutet, dass mehrere Lieferungsnummern in einer Ausgabeantwort zusammengefasst werden. Zollstatistiknummer, Zollverfahren und Ursprungsland werden in "Artikel. Standort verbinden" (MMS003) mit jedem Artikel/Standort verknüpft. Die Zollstatistiknummer dient der Gruppierung von Artikeln mit ähnlichen Eigenschaften gemäß dem Zollkodex. Mit dem Zollverfahren wird das Verfahren beim Export oder Import von Waren beschrieben. Das Ursprungsland gibt das Land an, in dem der Artikel ursprünglich hergestellt wurde. Die Transaktion "LstStatNo" wird für die Felder "Firma" (CONO), Meldungsrichtung (E0IO), Richtung (INOU) und TEI-Transfer-ID (TINR) angefordert. Bei jeder Lieferungsnummer werden Packstückdetails von MFTRNS "Packstückdetail. Öffnen" (MMS473) als Grundlage für die Erstellung einer Zusammenfassung (wie oben beschrieben) verwendet. Jeder Packstück-Detaildatensatz wird entsprechend analysiert und zusammengefasst. Der Output von LstStatNo gibt zusammengefasste Informationen zum Bruttogewicht, Nettogewicht, Volumen, zur Menge, zur Währung und zur Anzahl an Packstücken an. Die Preisfindung der Ausgabedatensätze sollte gemäß den gleichen Regeln wie bei der Erstellung eines ED-Dokuments/Einheitsdokuments (MWS616) und einer Proformarechnung (MWS630) erfolgen. Abhängig von der Auftragskategorie gelten unterschiedliche Regeln. Die Transaktion "LstStatNo" wird nur für TEI-Transfers verwendet, die mit ausgehenden Lieferungsnummern und nicht mit Einkaufsaufträgen oder eingehenden Verteilaufträgen in Verbindung stehen.
  ChgHead	Die Transaktion ChgHead sorgt für die Verknüpfung der Funktion "TEI-Transfer. Öffnen" (MYS500). Der Zweck der Transaktion ist es, das Aktualisieren eines TEI-Transferkopf-Datensatzes in der Tabelle "MTITHE" zu ermöglichen. Die Aktualisierung wird für die Felder "Firma" (CONO), Meldungsrichtung (E0IO), Richtung (INOU) und TEI-Transfer-ID (TINR) angefordert. Das wichtigste zu aktualisierende Feld ist STAT (Status). Der Status muss über IEC aktualisiert werden, sodass angezeigt wird, dass die Verarbeitung, die zunächst beim IEC-Mapping erfolgt ist, gestartet wurde. Eine weitere Statusaktualisierung wird beim Status "Beendet" vorgenommen, wenn die IEC-Zuordnung erfolgreich abgeschlossen wurde.

• PPS200MI – Einkaufsauftragsschnittstelle

  Die API wird über IEC verwendet, um die mit diesem Einkaufsauftrag verbundenen Informationen abzurufen. Sie verknüpft den Auftragskopf, die Auftragspositionen, die Auftragspositionstransaktionen, die Auftragsadressen und die Auftragstexte.

  PPS200MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  PPS200MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Beschreibung
  GetHead	Die Transaktion GetHead sorgt für die Verknüpfung der Funktion "Einkaufsauftrag. Öffnen" (PPS200). Der Zweck der Transaktion ist das Abrufen EA-Kopfinformationen.
  GetAddresses	Die Transaktion GetAddresses sorgt für die Verknüpfung der Funktion "Einkaufsauftrag. Öffnen" (PPS200). Der Zweck der Transaktion ist das Abrufen aller mit einem EA-Auftragskopf verbundenen Adressen. Die Adressinformationen werden in (PPS200/G) dargestellt.
  LstLine	Die Transaktion LstLine sorgt für die Verknüpfung der Funktion "Einkaufsauftrag. Positionen öffnen" (PPS201). Der Zweck der Transaktion ist das Abrufen aller mit einem EA-Auftragskopf verbundenen Positionen samt zugehörigen Informationen.
  GetLineTrans	Die Transaktion GetLineTransaction sorgt für die Verknüpfung der Funktion "Einkaufsauftrag. Transaktionen anzeigen" (PPS330). Der Zweck der Transaktion ist das Abrufen einer einzelnen Wareneingangstransaktion. "GetLineTrans" wird zum Abrufen von Informationen aus der Tabelle "MPLIND" verwendet, die in "Einkaufsauftrag. Transaktionen anzeigen" (PPS330) angezeigt wird. Die erforderlichen Schlüssel für die Wiedergabe einer einzelnen Wareneingangstransaktion sind die EA-Nummer und eine vollständige Eingangsnummer. Der Output umfasst Informationen aus der Tabelle "MPLIND".
  LstLineTrans	Die Transaktion LstLineTransaction sorgt für die Verknüpfung der Funktion "Einkaufsauftrag. Transaktionen anzeigen" (PPS330). Der Zweck der Transaktion ist die Wiedergabe des gleichen Output wie mit der Transaktion "GetLineTrans". Der Unterschied besteht darin, dass das Input-Feld „Wareneingangsnummer" als Präfix-Feld verwendet werden kann, in dem die letzten drei Stellen auf null gesetzt werden. Für alle Wareneingangsnummern mit dem entsprechenden Präfix wird ein Output angefordert. Abgesehen von dem Unterschied hinsichtlich der Input-Felder gelten die gleichen Regeln wie für "GetLineTrans".

• MMS200MI – Artikel-Toolbox-Schnittstelle

  Die API wird über IEC verwendet, um Artikelstammdaten abzurufen.

  MMS200MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  MMS200MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Kommentar
  GetItmBasic	Rufen Sie artikelbezogene Informationen ab, die in (MMS001) angezeigt werden.
  GetItmFac	Rufen Sie artikel-/standortbezogene Informationen ab, die in MMS003) angezeigt werden.

• MWS410MI – Lieferungs-Toolbox-Schnittstelle

  Die API wird über IEC verwendet, um die Informationen zu einer bestimmten Lieferungsnummer abzurufen. Zuerst werden die allgemeinen Lieferungs- und Adressinformationen übernommen. Dann können sowohl Packstückinformationen auf der Detail- als auch auf der Zusammenfassungsstufe übernommen werden.

  MWS410MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  MWS410MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Beschreibung
  GetHead	Die Transaktion GetHead sorgt für die Verknüpfung der Funktion "Lieferung. Toolbox öffnen" (MWS410). Der Zweck der Transaktion ist das Abrufen von Informationen zu einer einzelnen Lieferungsnummer. Die Transaktion "GetHead" wird nur für ausgehende Lieferungsnummern und nicht für Einkaufsaufträge oder eingehende Verteilaufträge verwendet.
  GetPackage	Die Transaktion GetPackage sorgt für die Verknüpfung der Funktion "Lieferung. Packstücke verbinden" (MWS423). Der Zweck der Transaktion ist das Abrufen eines einzelnen Packstücks für eine spezielle Lieferungsnummer. Die wichtigsten Schlüsselfelder, die den Zugriff auf einen Packstückdatensatz ermöglichen, sind die Felder "Firma" (CONO), "Lieferungsnummer" (DLIX) und "Packstücknummer" (PANR). Die Transaktion "GetPackage" wird nur für ausgehende Lieferungsnummern und nicht für Aufträge oder eingehende Verteilaufträge verwendet.
  LstItem	Die Transaktion LstItem sorgt für die Verknüpfung der Funktion "Packstückdetail. Öffnen" (MMS473). Der Zweck der Transaktion ist das Abrufen einer Liste an Artikelnummern für eine spezielle Lieferungsnummer. Die Informationen werden basierend auf MFTRNS-Informationen zuerst pro Artikelnummer zusammengefasst. Falls erforderlich, kann die Zusammenfassung pro Artikel und Kundenauftragsnummer oder Artikel, Kundenauftragsnummer und Chargennummer erfolgen. Die zwei letzten Optionen sind spezielle Anforderungen der Versandavisfunktion und werden in einem TEI-Szenario in der Regel nicht verwendet. Die Transaktion "LstItem" wird nur für ausgehende Lieferungsnummern und nicht für Einkaufsaufträge oder eingehende Verteilaufträge verwendet.
  GetAdr	Die Transaktion GetAdr sorgt für die Verknüpfung der Funktion "Lieferung. Toolbox öffnen" (MWS410). Der Zweck der Transaktion ist das Abrufen von Adressinformationen zu einer einzelnen Lieferungsnummer. Die Transaktion "GetHead" wird nur für ausgehende Lieferungsnummern und nicht für Einkaufsaufträge oder eingehende Verteilaufträge verwendet.

• MWS423MI - Packstückschnittstelle

  Die API wird über IEC verwendet, um die Informationen zu Packstücken einer bestimmten Lieferungsnummer abzurufen. Die Verwendung dieser API ist wichtig, wenn Transportausführungssysteme zusammengefasste oder einzelne Packstückinformationen benötigen, um Frachtdokumente und Packstücketiketten für eine bestimmte Lieferung zu erstellen.

  In MYS500MI gibt es ähnliche Transaktionen, hinter denen die gleiche Geschäftslogik steht, jedoch für mehrere Lieferungsnummern.

  MWS423MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  MWS423MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Beschreibung
  LstPackGrp	Die Transaktion LstPackGrp sorgt für die Verknüpfung der Funktion "Lieferung. Packstücke verbinden" (MWS423). Der Zweck der Transaktion ist das Abrufen zusammengefasster Packstückinformationen. Die Gruppierung wird für eine Lieferungsnummer durchgeführt. Hinsichtlich der Packstückgruppierung kann dies basierend auf den Feldern "Verpackung" oder "Verpackungstyp" erfolgen. "Verpackung" ist die ID einer bestimmten Verpackung, in bzw. mit der Waren verpackt werden. "Verpackung" ist definiert in "Verpackung. Öffnen" (MMS050). "Verpackungstyp" ist die ID für eine Gruppe von Verpackungen, die für einen logischen Zusammenhalt sorgen. "Verpackungstyp" ist definiert in "Verpackungstyp. Öffnen" (DRS080). Ein einfaches Beispiel wären zwei Verpackungen, ein kleiner Aufbewahrungsbehälter und ein zweiter großer Aufbewahrungsbehälter. Der Verpackungstyp wäre dann unabhängig von der Größe Aufbewahrungsbehälter. Diese zwei IDs können in verschiedenen Implementierungen unterschiedlich genutzt werden. Die API-Transaktion kann für die Gruppierung nach einer der zwei IDs verwendet werden. Der Output von LstPackGrp gibt Information wieder, die auf der Packstückstufe, Tabelle "MPTRNS", geführt und in "Lieferung. Packstücke verbinden" (MWS423) dargestellt werden, und sich für die Verpackungsgruppierung eignen. Es werden keine Informationen in Bezug auf die Chargennummern oder Artikel bereitgestellt, die in eine Gruppe von Packstücken gepackt werden. Das liegt daran, dass eine Packstückgruppe viele Artikel und/oder Chargennummern enthalten kann. Die Transaktion "LstPackGrp" wird nur ausgehende oder eingehende Lieferungsnummern und nicht für Einkaufsaufträge verwendet.
  LstPackages	Die Transaktion LstPackages sorgt für die Verknüpfung der Funktion "Lieferung. Packstücke verbinden" (MWS423). Der Zweck der Transaktion ist das Abrufen einer Liste, die aus den Packstücken für eine Lieferungsnummer besteht. Die Anforderung zur Auflistung einer Serie an Packstücken erfolgt für die Hauptschlüssel "Firma" (CONO), Richtung (INOU) und Lieferungsnummer (DLIX). Zusätzlich zu diesen Hauptschlüsseln ist die optionale Filterung nach Packstückstufe (PACO), Verpackung (MMS050) oder Verpackungstyp (DRS080) möglich. PACO wird entweder mit der gewünschten Stufe (000, 001 usw.) oder mit 999 ausgefüllt, wenn keine Filterung notwendig ist. PACT oder PACK wird mit dem Codewert ausgefüllt, nach dem Sie filtern möchten. Alle Packstücke für eine DLIX werden mit den Filterwerten abgeglichen und qualifiziert/ignoriert. Der Output von LstPackages gibt Informationen wieder, die auf der Packstückstufe, Tabelle "MPTRNS", geführt und in "Lieferung. Packstücke verbinden" (MWS423) dargestellt werden. Alle relevanten Felder aus "MPTRNS" werden in den Output übertragen. Es werden keine Informationen in Bezug auf die Chargennummern oder Artikel bereitgestellt, die in ein Packstück gepackt werden. Das liegt daran, dass ein Packstück viele Artikel und/oder Chargennummern enthalten kann. Die Transaktion "LstPackages" wird nur für ausgehende Lieferungsnummern und nicht für Aufträge oder eingehende Verteilaufträge verwendet.
  GenPackDetail	Die Transaktion GenPackDetail sorgt für die Verknüpfung der Funktion "Packstückdetail. Öffnen" (MMS473). Der Zweck der Transaktion ist das Generieren von Packstückdetaildaten für eine Lieferungsnummer. Die Transaktion wird verwendet, wenn die Packrückmeldungsmethode (MWS010-Feld 240/SHLV) und OQSHLV auf "Einfacher Packvorgang" oder "Kein Packvorgang", Wert "1" oder "0", gesetzt sind. Die Transaktion erstellt die erforderlichen Informationen in MFTRNS (MMS473) und MPTRNS (MWS423), sodass API-Aufrufe später über die obligatorischen MFTRNS-Informationen verfügen.

• CRS610MI - Kundenschnittstelle

  Die API wird über IEC verwendet, um die kundenbezogenen Informationen abzurufen.

  CRS610MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  CRS610MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Kommentar
  GetBasicData	Abrufen von grundlegenden Kundeninformationen
  GetFinancialData	Abrufen von Kundeninformationen in Zusammenhang mit der Finanzbuchhaltung

• CRS045MI - Länderschnittstelle

  Die API wird über IEC verwendet, um die grundlegenden Länderdaten abzurufen.

  CRS045MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Kommentar
  GetBasicData	Abrufen eines ausgewählten Landes und den zugehörigen Informationen

• CRS175MI - anwendungsübergreifende Grunddatenschnittstelle

  Die API wird über IEC verwendet, um die verschiedenen Typen von Grunddaten abzurufen. Da verschiedene Grunddatenwerte in einer physischen Tabelle gespeichert werden, (CSYTAB) werden mit dieser Transaktion ausgewählte Datensätze aus CSYTAB abgerufen.

  CRS175MI umfasst außerdem noch einige weitere Transaktionen. Diese werden hier jedoch nicht beschrieben, da sie in einer TEI-Lösung in der Regel nicht vorhanden sind.

  CRS175MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Kommentar
  LstGeneralCode	Auflisten von Grunddaten aus der Systemtabelle "CSYTAB", basierend auf einem ausgewählten Konstantenwert

• MNS100MI - Divisionsschnittstelle

  Diese Transaktion ist Teil der Vorlagenzuordnung.

  Die API wird über IEC verwendet, um die Divisionsstammdaten abzurufen.

  MMS200MI umfasst die folgenden Transaktionen, die mit TEI in Verbindung stehen:

  Name	Kommentar
  GetBasicData	Abrufen von Grunddaten für eine in (MNS100) dargestellte Division