XXSAP项目_开发说明书_物料主数据接口.docxVIP

XXX有限公司

SAPERP项目

开发说明书

物料主数据接口

Date:3

Version:1.0

page2/numpages35delaware.pro

需求确认签字

本文档描述的报表需求须由相关责任人签字确定，以确保原始需求被准确记录。

职位

姓名

签署

日期

变更历史

版本

日期

变更描述

V1.0

2025.03.17

初始创建

DataClassification

Chooseaclassificationofconfidentiality

?

Public

AninformationassetisclassifiedaspubliciftheinformationispurposelyaimedtobedisclosedtothepublicandhasnobusinessimpactforDelawareifthatinformationisdisclosed.

?

InternalUse

AninformationassetisclassifiedasinternaluseifthedisclosureoftheinformationtounauthorizedindividualscouldonlycauselimitedornobusinessimpacttoDelaware.

?

Confidential

AninformationassetisclassifiedconfidentialifthedisclosureoftheinformationtounauthorizedindividualscouldcauseamoderatebusinessimpacttoDelaware.

?

StrictlyConfidential

AninformationassetisclassifiedstrictlyconfidentialifthedisclosureoftheinformationtounauthorizedindividualscouldcauseaseverebusinessimpacttoDelaware.

page3

Contents

TOC\o1-2\h\z\u1 需求概述 4

2 接口逻辑概述 4

3 接口逻辑详细说明 4

3.1 接口字段说明 4

3.2 物料主数据创建逻辑说明 7

3.3 物料主数据修改逻辑说明 7

4 接口异常处理机制 8

4.1 业务类报错 8

4.2 技术类报错 8

5 测试用例与测试结果 8

page9

需求概述

需求部门用户在OA系统中发起物料主数据维护申请流程，用户在OA流程表单中按要求填写相关信息，流程审批完成后通过SAP与OA的接口在SAP中自动生成物料数据。该接口涵盖的物料主数据维护操作包括：创建，修改，标记删除。

接口逻辑概述

该接口包含两部分功能，物料主数据创建和物料主数据修改。其中对物料的修改、标记删除都使用物料主数据修改接口。

数据创建或修改成功或失败，接口都需要返回消息给OA系统。

接口逻辑详细说明

接口字段说明

本接口相关字段与字段逻辑说明如下，SAP中的字段属性参考表MARA，MARC。

字段名称

是否主键

字段

类型

字段

长度

字段描述

字段逻辑

ZOA

X

CHAR

OA流程单号

OA表单号，唯一标识一条OA发出的数据

ZMODE

CHAR

1

操作模式

接口操作模式，OA系统发给SAP，有“C”和“R”两个值。

-C：触发物料主数据创建功能。

-R：触发物料主数据修功能。

MARA-MATNR

X

CHAR

40

物料编号

物料主数据创建成功后，SAP将物料号返回给OA，去除前导零。

MARA-MTART

X

CHAR

4

物料类型

1.SAP提供数据清单给OA，OA中建立主数据表。

2.用户在OA表单中点选填写物料类型。

3.OA接口中传输物料类型代码给SAP。

MTBEZ

CHAR

25

物料类型描述

OA表单字段，接口表结构中不体现

MARC-WERKS

X

CHAR

4

工厂

OA接口会同时传输所有需要扩建工厂、财务视图对应的工厂，SAP中自动创建对应工厂的采购、工厂、存储、会计、成本视图。具体逻辑参见本文档的“物料主数据创建逻辑说明”章节。

NAME1

CHAR

30