M3 运输执行接口的 API 概述

本文档描述可用于运输执行接口 (TEI) 的不同 API 交易。

有关 M3 Interface 程序及其交易的详细描述，请参阅 MI 存储库。打开 (MRS001)、MI 交易。打开 (MRS002) 和 MI 交易布局。打开 (MRS003) 中的 API 存储库。

M3 运输执行接口 (TEI) API 概述

本文档中描述的不同 API 交易旨在与运输执行接口 (TEI) 一起使用。通过使用这些交易，可以从 M3 BE 中检索物流和商业信息，并将其发送到 Infor Enterprise Collaborator (IEC)。IEC 然后会创建要发送到外部运输执行系统 (TES) 的输出文件。

可以在每个实现中使本文档中未描述的其他 API 交易。列出的是最常出现在每个实现中的中心交易。

下图描述了实现 TEI 时涉及的最常用 API。

M3 运输执行接口 (TEI) API 概述

下面的列表应提供所涉及的最常用 API 的概述。

  • MYS500MI - TEI 传输接口

    此 API 在 IEC 中用于管理有关 TEI 传输的信息，并将有关 IEC 处理的状态信息发送回 M3 BE 报告。MYS500MI 还包含可以跨多个交货号或发货检索物流信息的交易。当运输执行系统需要将多个交货号组合成联合文档以用于海关申报时，使用此类 API 至关重要。另一种情况是，需要将多个交货合并为一个运费单据。

    MYS500MI 包括以下交易：

    名称 检索和汇总按不同包装 ID 分组的一个交货号的包装信息。
    GetHead 检索按一系列字段筛选的一个交货号的包装列表。
    LstDetail 当 MWS010 字段 240（包装报告方法）等于 0（无包装报告）或 1（简单包装报告）时生成 MFTRNS 明细。
    LstPackGrp

    交易 LstPackGrp 与功能交货。连接包装 (MWS423) 相关联。

    此交易用于检索聚合包装信息。将对一个 TEI 传输标题执行分组。这表示，多个交货号将合并到一个输出回复中。

    关于包装分组，可以根据字段包装或包装类型请求此内容。包装是用于打包货物的特定包装的标识。包装在包装。打开 (MMS050) 中定义。包装类型是用于以合理方式将它们存放在一起的一组包装的标识。包装类型在包装类型。打开 (DRS080) 中定义。一个简单的示例是两个包装，一个是小提货袋，另一个是大提货袋。包装类型将是与尺寸无关的提货袋。这两个 ID 的使用在实现之间不同，因此 API 交易可以用于对两个标识中的任何一个进行分组。

    LstPackGrp 的输出将返回保存在包装级别、交货。连接包装 (MWS423) 中的表 MPTRNS 上的信息，并适用于包装分组。

    不提供关于打包在一组包装中的物料和批次号的信息。这是因为一个包装组可以包含许多物料和/或批号。LstPackGrp 交易仅用于和出站或入站交货号（而不是采购订单）相关的 TEI 传输。
    LstPackages

    交易 LstPackages 与功能交货。连接包装 (MWS423) 相关联。

    此交易用于检索由一个 TEI 传输标题的包装组成的列表。这表示，多个交货号将合并到一个输出回复中。

    列出一系列包装的请求必须针对主要关键字公司 (CONO)、消息方向 (E0IO)、方向 (INOU) 和 TEI 传输 ID (TINR)。除了这些主要关键字之外，还可以对包装级别 (PACO)、包装 (MMS050) 或包装类型 (DRS080) 进行可选筛选。PACO 使用所需级别（000、001 等）或 999（如果不需要筛选）进行填写。PACT 或 PACK 使用要筛选的代码值进行填写。将针对筛选器值检查一个 TRID 的所有包装并检查它们合格还是不合格。

    LstPackages 的输出将返回保存在包装级别、交货。连接包装 (MWS423) 中的表 MPTRNS 上的信息。MPTRNS 的所有相关字段都放在输出中。

    不提供关于打包在包装中的物料和批次号的信息。这是因为一个包装可以包含许多物料和/或批号。

    LstPackages 交易仅用于和出站交货号（而不是采购订单或入站配送单）相关的 TEI 传输。
    LstStatNo

    交易 LstStatNo 与功能包装明细。打开 (MMS473) 相关联。

    此交易用于检索由一个 TEI 传输标题的关税统计号、海关程序和原产国组合组成的列表。这表示，多个交货号将合并到一个输出回复中。

    关税统计号、海关程序和原产国将连接到物料。连接分厂 (MMS003) 中的每个物料/分厂。关税统计号用于根据海关编码对具有相似特性的物料进行分组。海关程序用于描述在出口或进口货物时使用的程序。原产国用于标识最初生产此物料的国家/地区。

    针对公司 (CONO)、消息方向 (E0IO)、方向 (INOU) 和 TEI 传输 ID (TINR) 字段请求 LstStatNo 交易。对于每个交货号，来自 MFTRNS 交货通知。订单行列连结作业 (MMS473) 的包装明细用作构建所述摘要的基础。相应地将对每条包装详细记录进行分析和总结。

    LstStatNo 的输出返回有关总重、净重、体积、金额、货币和包装数的汇总信息。

    输出记录的定价应根据生成 ED 文档/单位文档 (MWS616) 和形式发票 (MWS630) 时的规则确定。根据订单类别，将应用不同的规则。

    LstStatNo 交易仅用于和出站交货号（而不是采购订单或入站配送单）相关的 TEI 传输。
    ChgHead

    交易 ChgHead 与功能 TEI 传输。打开 (MYS500) 相关联。

    此交易用于能够更新表 MTITHE 中的 TEI 传输标题记录。针对公司 (CONO)、消息方向 (E0IO)、方向 (INOU) 和 TEI 传输 ID (TINR) 字段请求更新。要更新的主要字段是 STAT（状态）。应从 IEC 使用状态更新，以指示处理已开始，最初在 IEC 映射中执行。当 IEC 映射已成功结束时，将完成具有“已完成”状态的另一个已更新状态。
  • PPS200MI - 采购订单接口

    此 API 在 IEC 中用于检索与采购订单相关的信息。它与订单标题、订单行、订单行交易、订单地址和订单文本相关联。

    PPS200MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    PPS200MI 包含以下与 TEI 相关的交易：

    名称 描述
    GetHead

    交易 GetHead 与功能采购订单。打开 (PPS200) 相关联。

    此交易用于检索采购订单标题信息。
    GetAddresses

    交易 GetAddresses 与功能采购订单。打开 (PPS200) 相关联。

    此交易用于检索连接到采购订单标题的所有地址。地址信息显示在 (PPS200/G) 中。
    LstLine

    交易 LstLine 与功能采购订单。打开行 (PPS201) 相关联。

    此交易用于检索连接到包含其相关信息的采购订单标题的所有行的列表。
    GetLineTrans

    交易 GetLineTransaction 与功能采购订单。显示行交易 (PPS330) 相关联。

    此交易用于检索一项收货交易。GetLineTrans 用于从采购订单。显示行交易 (PPS330) 中查看的 MPLIND 表中检索信息。返回一项收货交易所需的必需关键字为采购订单号和完整的接收编号。

    输出包含来自 MPLIND 表的信息。
    LstLineTrans

    交易 LstLineTransaction 与功能采购订单。显示行交易 (PPS330) 相关联。

    此交易用于返回与交易 GetLineTrans 相同的输出。唯一的区别是输入字段“接收编号”可用作前缀字段，其中最后三位数字设置为零。这表示针对具有所请求前缀的所有接收编号请求输出。

    除了输入字段中存在差异之外，相同规则适用于 GetLineTrans。
  • MMS200MI - 物料工具箱界面

    此 API 在 IEC 中用于检索物料主数据。

    MMS200MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    MMS200MI 包含以下与 TEI 相关的交易：

    名称 备注
    GetItmBasic 检索在 (MMS001) 中查看的物料相关信息。
    GetItmFac 检索在 (MMS003) 中查看的物料/分厂相关信息。
  • MWS410MI - 交货工具箱接口

    此 API 在 IEC 中用于获取有关特定交货号的信息。首先，通常将检索整体交货和地址信息。其次，可以检索详细级别和聚合级别上的包装信息。

    MWS410MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    MWS410MI 包含以下与 TEI 相关的交易：

    名称 描述
    GetHead

    交易 GetHead 与功能交货。打开工具箱 (MWS410) 相关联。

    此交易用于检索连接到单个交货号的信息。

    GetHead 交易仅用于出站交货号，而不用于采购订单或入站配送单。
    GetPackage

    交易 GetPackage 与功能交货。连接包装 (MWS423) 相关联。

    此交易用于检索一个特定交货号的单个包装。

    允许访问包装记录的主要关键字字段包括公司 (CONO)、交货号 (DLIX) 和包装号 (PANR) 字段。

    GetPackage 交易仅用于出站交货号，而不用于采购订单或入站配送单。
    LstItem

    交易 LstItem 与功能包装明细。打开 (MMS473) 相关联。

    此交易用于检索一个交货号的物料号列表。信息最初根据 MFTRNS 信息按物料号进行聚合。如果需要，可以按物料和客户订单号或物料和客户订单号及批号请求聚合。最后这两个选项是来自发货通知功能的特定要求，并且通常不用在 TEI 方案中。

    LstItem 交易仅用于出站交货号，而不用于采购订单或入站配送单。
    GetAdr

    交易 GetAdr 与功能交货。打开工具箱 (MWS410) 相关联。

    此交易用于检索连接到单个交货号的地址信息。

    GetHead 交易仅用于出站交货号，而不用于采购订单或入站配送单。
  • MWS423MI - 包装接口

    此 API 在 IEC 中用于获取有关特定交货号的包装的信息。当运输执行系统需要汇总包装信息或个别包装信息以生成特定交货的运费单据和包装标签时，使用此 API 至关重要。

    MYS500MI 中存在类似交易，它们执行同一业务逻辑，但是适用于一系列交货号。

    MWS423MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    MWS423MI 包含以下与 TEI 相关的交易：

    名称 描述
    LstPackGrp

    交易 LstPackGrp 与功能交货。连接包装 (MWS423) 相关联。

    此交易用于检索聚合包装信息。对一个交货号进行分组。

    关于包装分组，可以根据字段包装或包装类型请求此内容。包装是用于打包货物的特定包装的标识。包装在包装。打开 (MMS050) 中定义。包装类型是用于以合理方式将它们存放在一起的一组包装的标识。包装类型在包装类型。打开 (DRS080) 中定义。一个简单的示例是两个包装，一个是小提货袋，另一个是大提货袋。包装类型将是与尺寸无关的提货袋。这两个 ID 的使用在实现之间不同，因此 API 交易可以用于对两个标识中的任何一个进行分组。

    LstPackGrp 的输出将返回保存在包装级别、交货。连接包装 (MWS423) 中的表 MPTRNS 上的信息，并适用于包装分组。

    不提供关于打包在一组包装中的物料和批次号的信息。这是因为一个包装组可以包含许多物料和/或批号。

    LstPackGrp 交易仅用于出站或入站交货号，而不用于采购订单。
    LstPackages

    交易 LstPackages 与功能交货。连接包装 (MWS423) 相关联。

    此交易用于检索由一个交货号的包装组成的列表。

    列出一系列包装的请求针对主要关键字公司 (CONO)、方向 (INOU) 和交货号 (DLIX)。除了这些主要关键字之外，还可以对包装级别 (PACO)、包装 (MMS050) 或包装类型 (DRS080) 进行可选筛选。PACO 使用所需级别（000、001 等）或 999（如果不需要筛选）进行填写。PACT 或 PACK 使用要筛选的代码值进行填写。将针对筛选器值检查一个 DLIX 的所有包装并检查它们合格还是不合格。

    LstPackages 的输出将返回保存在包装级别、交货。连接包装 (MWS423) 中的表 MPTRNS 上的信息。MPTRNS 的所有相关字段都放在输出中。

    不提供关于打包在包装中的物料和批次号的信息。这是因为一个包装可以包含许多物料和/或批号。

    LstPackages 交易仅用于出站交货号，而不用于采购订单或入站配送单。
    GenPackDetail

    交易 GenPackDetail 与功能包装明细。打开 (MMS473) 相关联。

    此交易用于为一个交货号生成包装明细数据。包装报告方法（MWS010 字段 240 / SHLV）和 OQSHLV 设置为使用简单包装或无包装（即，值 1 或 0）时，将使用此交易。

    此交易将在 MFTRNS (MMS473) 和 MPTRNS (MWS423) 中创建必要的信息，以便稍后的 API 调用具有必需的 MFTRNS 信息。
  • CRS610MI - 客户界面

    此 API 在 IEC 中用于检索客户相关信息。

    CRS610MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    CRS610MI 包含以下与 TEI 相关的交易：

    名称 备注
    GetBasicData 检索基本客户信息。
    GetFinancialData 检索与财务会计相关的客户信息。
  • CRS045MI - 国家/地区接口

    此 API 在 IEC 中用于检索国家/地区基本数据。

    CRS045MI 包含以下与 TEI 相关的交易：

    名称 备注
    GetBasicData 检索所选国家/地区及其相关信息。
  • CRS175MI - 跨应用程序基本数据接口

    此 API 在 IEC 中用于检索几种类型的基本数据。由于几个基本数据值存储在一个物理表 (CSYTAB) 中，因此该交易将从 CSYTAB 中检索选择性记录。

    CRS175MI 也包含几项其他交易，但不在此处描述这些交易，因为它们通常不存在于 TEI 解决方案中。

    CRS175MI 包含以下与 TEI 相关的交易：

    名称 备注
    LstGeneralCode 根据所选常数值列出系统表 CSYTAB 中的基本数据。
  • MNS100MI - 分部接口

    此交易是模板映射的一部分。

    此 API 在 IEC 中用于检索分部主数据。

    MMS200MI 包含以下与 TEI 相关的交易：

    名称 备注
    GetBasicData 检索 (MNS100) 中显示的一个分部的基本数据。
相关主题