SAP-MM-到货信息反馈接口_电信行业-CSDN博客

本文链接：https://blog.csdn.net/qq_32198063/article/details/142857123

1. 务背景

将开发的接口的整体业务背景进行概要说明,可以用图进行描。

为实现采购辅助系统与SAP ERP系统的采购订单收货情况的同步，采购订单所有行项目交货完成时，SAP ERP系统将采购订单编号、最终收货日期、行项目、收货数量、交货完成标识等参数，通过PI 传递给采购辅助系统。

图 1 采购辅助系统与SAP ERP系统的到货信息反馈接口

到货信息反馈接口

SAP ERP系统待采购订单所有行项目都交货完成时，将采购订单各行的收货数量及整个订单的最后一次收货时间及各行的交货完成标识传递给采购辅助系统，采购辅助系统接收到SAP ERP系统传送的信息后，将接收结果反馈给SAP ERP系统。

1. 接口清单

以清单方式与对方系统之间的所有接口，各专业系统按业务提供接口服务，接口服务中包含该业务所有的Operation，接口同步异步分开分装，如财务辅助物资接口：SI_CF_Material_Syn、SI_CF_Material_ASyn。

所有的Operation标识都以OP_ 开始（参考java规范）。

SAP ERP系统向采购辅助系统发起的接口

接口标识	Operation	接口中文名	接口描述
SI_CF_Material_Syn	OP_MaterialAccept	到货信息反馈	到货信息反馈

1. 1. 到货信息反馈接口

各接口详细说明

（例）

SAP ERP系统待采购订单所有行项目交货完成时，将采购订单各行的收货情况及收货完成标识反馈给采购辅助系统，采购辅助系统接收到信息后，将接收结果反馈给SAP ERP系统。

物资类型信息包括的基本信息有：采购订单编号、行项目号、交货完成标识、收货数量、最终收货日期。

说明：

只有当采购订单所有行项目的交货完成标识勾选上时，才触发此反馈接口。
最终收货日期仅取最后一次收货的时间，不需要取每行的收货时间。
当收货信息有冲销或变更时，需要及时反馈给采购辅助系统进行更新。
1. 1. 1. 接口说明（必须，业务顾问填写）

源系统（必填）：SAP ERP系统（服务调用端）

目标系统（必填）：采购辅助系统（服务提供端）

采购辅助系统当所有行项目交货完成时，触发此接口，反馈信息包括采购订单编号、最终交货时间、行项目号、收货数量、交货完成标识。当收货信息有变更时，需要及时反馈给采购辅助系统进行更新，如：物料凭证冲销、不再进行收货等。

1. 1. 1. 接口方式（必须，技术顾问填写）

该接口的技术实现方式为PI；

接口调用方式为异步；

1. 1. 1. 触发条件（必须，业务顾问填写）
SAP ERP系统采购订单所有行项目交货完成；
SAP ERP系统采购订单行项目收货情况发生变更（收货数量、交货完成标识等改变）；
1. 1. 1. 技术信息（必须，业务、技术顾问共同填写）

注：

字段技术信息以集中MSS系统中的字段为准，涉及ERP系统接口的字段以ERP为准。
业务数据有嵌套的情况下，需标明嵌套层级。

示例：

<?xml version="1.0" encoding="UTF-8"?>

<!—业务消息ID 非空-->

<MSGID> TMSFZ_VENDOR_20100602101010_ABCDE </MSGID>

<!—PI消息ID 业务端不填写-->

<PMSGID>ADF234AFASDFWR234ARFAFADFADF3ARF</PMSGID>

<!—发送时间非空、前8位表示日期后6位表示时间-->

<!—调用省份。-->

<S_PROVINCE></ S_PROVINCE>

<!—调用系统（调用端）。-->

<S_SYSTEM>ERP系统</ S_SYSTEM >

<!—接口名称。-->

<!—目标省份。-->

<T_PROVINCE >ERP系统</ T_ PROVINCE >

<!—目标系统（服务提供方）。-->

<T_SYSTEM >ERP系统</ T_SYSTEM >

<!—重试次数。-->

</BaseInfo>

< POSID>1000</ POSID>

< POST1>1000</ POST1>

</Message>

A:输入信息及输出信息：

到货信息反馈接口

字段名称	字段技术名称	类型	长度	描述	是否可选	特殊需求
头信息数据（固定）：
业务消息ID	MSGID	STRING	50	调用业务系统产生的MSGID，消息的唯一标识	必须	确定命名规则保证消息ID唯一（必须要）规范：系统名称+接口名称简写+日期时间+5位随机数。例：CPMIS_SENDCONTRACT2SRM_20131028141618_C84Xa
PI消息ID	PMSGID	STRING	39	PI系统产生的MSGID，PI系统查询使用	由PI填写	例：79BE6D823F9811E3ABF30000064C521D
调用时间	SENDTIME	STRING	14	消息发送的时间	必须	发送时间。请输入14位数值。例如：2013年10月10日12点30分30秒，输入格式为‘20131010123030’
调用省份	S_PROVINCE	STRING	5	发送消息的省份		集团
调用系统	S_SYSTEM	STRING	20	发送（调用方）系统简称		集中MSS-SAP 开发：D1E,D2E,D3E 测试：Q1E,Q2E,Q3E 生产：P1E,P2E,P3E
调用接口	SERVICENAME	STRING	100	接口名称
接收省份	T_PROVINCE	STRING	20	目标省份简称		广东：09000000 或江苏：04000000
目接收系统	T_SYSTEM	STRING	20	目标系统（服务提供方）简称		采购-采购辅助 CG-CGFZ
重发次数	RETRY	STRING	2	重发次数	第一次发送不填，如有重发必须填写	1
业务数据（一级）：
订单编号	EBELN	CHAR	10		是
最终收货时间	BUDAT	DATS	8		是
行项目信息
行项目号	BUZEI	NUMC	5		是
实收数量	ZQUAN	QUAN	13		是
交货完成标识	ELIKZ	CHAR	1		否

B：通过PI反馈项

字段名称	字段技术名称	类型	长度	描述	是否可选		特殊需求
头信息数据（固定）：
业务消息ID	MSGID	STRING	50	调用业务系统产生的MSGID，消息的唯一标识	必须		确定命名规则保证消息ID唯一（必须要）规范：系统名称+接口名称简写+日期时间+5位随机数。例：CPMIS_SENDCONTRACT2SRM_20131028141618_C84Xa
PI消息ID	PMSGID	STRING	39	PI系统产生的MSGID，PI系统查询使用	由PI填写		例：79BE6D823F9811E3ABF30000064C521D
调用时间	SENDTIME	STRING	14	消息发送的时间	必须		发送时间。请输入14位数值。例如：2013年10月10日12点30分30秒，输入格式为‘20131010123030’
发起反馈的省份	S_PROVINCE	STRING	5	发送反馈消息的省份			广东：09000000 或江苏：04000000
发起反馈的系统	S_SYSTEM	STRING	20	发送反馈消息的系统简称			采购-采购辅助 CG-CGFZ
调用接口	SERVICENAME	STRING	100	接口名称
接收反馈的省份	T_PROVINCE	STRING	20	接收反馈省份简称			集团
接收反馈的系统	T_SYSTEM	STRING	20	接收反馈系统简称			集中MSS-SAP 开发：D1E,D2E,D3E 测试：Q1E,Q2E,Q3E 生产：P1E,P2E,P3E
重发次数	RETRY	STRING	2	重发次数	第一次发送不填，如有重发必须填写		1
业务数据（一级，多行）：
采购订单编号	EBELN	CHAR	10			是	订单编号
处理状态	TYPE	CHAR	1	消息类型: S 成功,E 错误,W 警告,I 信息,A 中断		必须
消息文本	MESSAGE	CHAR	220	消息文本		可选	处理状态
业务数据（二级，多行）：
行项目标识	ITMNO	NUMC	3	行项目标识		必须	如有其他字段可标识行项目唯一性，可替换该字段
处理状态	TYPE	CHAR	1	消息类型: S 成功,E 错误,W 警告,I 信息,A 中断		必须
消息文本	MESSAGE	CHAR	220	消息文本		可选	消息文本