主数据（客户、供应商、物料）OpenApi文档

概述：主数据（客户、供应商、物料）OpenAPI接口说明

建议下载附件保存

适用版本：850版本 861版本

850版本需更新补丁：PT157152

861版本需更新补丁：PTM158682

一、模块：主数据（物料）OpenApi接口

1. 提交物料分类到EAS的接口方法--String importMaterialGroupData(String xmlData)；

接口名称：ImportMaterialGroupFacade-importMaterialGroupData

元数据别名：导入物料分类接口

接口简介：导入物料分类资料，用于第三方系统向EAS同步物料分类信息

接口描述：导入物料分类资料，用于第三方系统向EAS同步物料分类信息，包括新增、修改、启用、停用，目前参数类型为xml格式，请参照调用示例参数编写。

1.1 参数

入参：

参数名称	必录	类型	描述
xmlData	是	String	对应body的参数1 ，参数值是一段xml字符串，入参示例见请求示例

如下是具体的入参 xmlData中元素的含义：

参数名称	必录	类型	描述
bostype	是	String	物料分类实体的 bostype，一般是C79FC042
属性 op	是	String	标识当前操作是新增、修改、启用、停用（0=修改，1=启用（核准），2=停用，3=保存，4=提交）
creator	是	Object	EAS 中的用户编码
createTime		timestamp	创建时间
CU	是	Object	控制单元
number	是	String	物料类别编码
name	是	String	物料类别名称
description		String	物料类别描述
groupStandard	是	Object	基本分类编码
deletedStatus	是	enum	禁用状态
IsSynochronous	是	int	是否同步
parent		object	父分类编码

出参：

参数名称	类型	参数说明
errorCode	int	调用openapi标识，0：成功；1：
errMsg	String	记录调用openapi操作信息
data	String	是一段xml信息，存储业务操作记录，xml信息如下表：

data中的xml字段：

参数名称	参数说明
retstatus	业务返回标示，0：成功；1：失败 3:失败且有重复数据
errorMessage	记录业务操作失败信息

1.2 调用示例

 String ip = "172.17.6.176";
 int port = 8080;
 String userName = "zj003";
 String password = "";
 String dcName = "EAS860NEW";
 String language = "l2";
 String xmlData = "<DataInfo bostype=\"C79FC042\" op=\"4\">
                 <DataHead>
                     <creator>user</creator>
                     <createTime>2012-06-11 09:28:46</createTime>
                     <CU>01</CU>
                     <number>group01</number>
                     <name>物料分类01</name>
                     <description>物料分类01</description>
                     <groupStandard>BaseGroupStandard</groupStandard>
                     <deletedStatus>1</deletedStatus> 
                     <IsSynochronous>1</IsSynochronous> 
                 </DataHead>
             </DataInfo>";
             
 EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port,
   new CommonLogin.Builder(userName, password, dcName, language)
 //.appid("test")
 .build())
 .https(false)//是否https
 .build();
 OpenApiInfo info = new OpenApiInfo();
 info.setApi("ImportMaterialGroupFacade-importMaterialGroupData");
 info.setData(xmlData);
 OpenApi openApi = OpenApiFactory.getService(loginCtx);
 String result = openApi.invoke(info);
 System.out.println("----------result:" + result);

第三方依赖包：

openapi-server.jar

sp-openapi-server.jar

log4j-1.2.15.jar

fastjson-1.2.58.jar

1.3 请求样例

 {
    "api": "ImportMaterialGroupFacade-importMaterialGroupData",
    "data": [
             "<DataInfo bostype=\"C79FC042\" op=\"4\">
                 <DataHead>
                     <creator>user</creator>
                     <createTime>2012-06-11 09:28:46</createTime>
                     <CU>01</CU>
                     <number>group01</number>
                     <name>物料分类01</name>
                     <description>物料分类01</description>
                     <groupStandard>BaseGroupStandard</groupStandard>
                     <deletedStatus>1</deletedStatus> 
                     <IsSynochronous>1</IsSynochronous> 
                 </DataHead>
             </DataInfo>"
    ]
 }

1.4 返回样例

 {
   "errCode": 0,
   "errMsg":" 执行成功",
   "data":{
         "<Result>
     <retstatus>0</retstatus> 
      <errorMessages>
          <errorMessage number=”group01”>
             如：编码重复；
         </errorMessage>
     </errorMessages>
     </Result>"
   }
 }

2. 提交物料到EAS的接口方法--String importMaterialData(String xmlData)；

接口名称：ImportMaterialFacade-importMaterialData

元数据别名：导入物料接口

接口简介：导入物料资料，用于第三方系统向EAS同步物料信息

接口描述：导入物料资料，用于第三方系统向EAS同步物料信息，包括新增、修改、启用、停用，目前参数类型为xml格式，请参照调用示例参数编写。

2.1 参数

入参：

参数名称	必录	类型	描述
xmlData	是	String	对应body的参数1 ，参数值是一段xml字符串，入参示例见请求示例

如下是具体的入参 xmlData中元素的含义：

参数名称	必录	类型	描述
bostype	是	String	物料实体的 bostype，一般是4409E7F0
属性 op	是	String	标识当前操作是新增、修改、启用、停用（0=修改，1=启用（核准），2=停用，3=保存，4=提交）
creator	是	Object	EAS 中的用户编码
createTime		timestamp	创建时间
CU	是	Object	控制单元的编码
number	是	String	物料编码
name	是	String	物料名称
baseUnit	是	Object	基本计量单位编码
status		enum	状态：0=未核准，1=核准，2=禁用（如果需要在提交后直接为核准状态，可以在提交时设置为1）
shortName		String	简称
barCode		String	条形码
helpCode		String	助记码
version		String	版本号
materialGroup	是	Object	物料分类
model		String	型号
pictureNumber		String	工程图号
alias		String	别名
foreignname		String	外文名称
registeredmark		String	注册商标
warrantnumber		String	批准文号
isOutsourcedPart		Boolean	外协件, true=是，false=否
DataEntries	是	Array	其他分类：第一个填写基本分类标准和基本分类

出参：

参数名称	类型	参数说明
errorCode	int	调用openapi标识，0：成功；1：失败
errMsg	String	记录调用openapi操作信息
data	String	是一段xml信息，存储业务操作记录，xml信息如下表：

data中的xml字段：

参数名称	参数说明
retstatus	业务返回标示，0：成功；1：失败 3:失败且有重复数据
errorMessage	记录业务操作失败信息

2.2 调用示例

 String ip = "172.17.6.176";
 int port = 8080;
 String userName = "zj003";
 String password = "";
 String dcName = "EAS860NEW";
 String language = "l2";
 
 EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port,
   new CommonLogin.Builder(userName, password, dcName, language)
 //.appid("test")
     .build())
 .https(false)//是否https
 .build();
 OpenApiInfo info = new OpenApiInfo();
 info.setApi("ImportMaterialFacade-importMaterialData");
 info.setData("示例中的xmlData数据");
 OpenApi openApi = OpenApiFactory.getService(loginCtx);
 String result = openApi.invoke(info);
 System.out.println("----------result:" + result);

第三方依赖包：

openapi-server.jar

sp-openapi-server.jar

log4j-1.2.15.jar

fastjson-1.2.58.jar

2.3 请求样例

 {
    "api": "ImportMaterialFacade-importMaterialData",
    "data": [
             "<DataInfo bostype=\"4409E7F0\" op=\"4\">
                 <DataHead>
                     <creator>user</creator>
                     <createTime>2020-10-29 16:28:46</createTime>
                     <CU>01</CU>
                     <number>feiyang001</number>
                     <name>肥羊接口引入物料</name>
                     <model>SSP-H-667000/750</model>
                     <baseUnit>0001</baseUnit>
                     <status>1</status>
                     <version>0</version>
                     <materialGroup>feiyang01</materialGroup>
                 </DataHead>
                 <DataEntries>
                     <entry>
                         <materialGroupStandard>BaseGroupStandard
                         </materialGroupStandard>
                         <materialGroup>feiyang01</materialGroup>
                     </entry>
                     <entry>
                         <materialGroupStandard>0001</materialGroupStandard>
                         <materialGroup>0001.01</materialGroup>
                     </entry>
                 </DataEntries>
             </DataInfo>"
    ]
 }

2.4 返回样例

 {
   "errCode": 0,
   "errMsg":" 执行成功",
   "data":{
         "<Result>
     <retstatus>0</retstatus> 
      <errorMessages>
          <errorMessage number=”materialNumber01”>
             如：编码重复；
         </errorMessage>
     </errorMessages>
     </Result>"
   }
 }

3. 分配物料到管理单元接口方法--String assignMaterial(String xmlData)；

接口名称：AssignMaterialFacade-assignMaterial

元数据别名：分配物料

接口简介：分配物料到管理单元，用于第三方系统分配物料到其他管理单元，生成分配关联数据

接口描述：分配物料到管理单元，用于第三方系统分配物料到其他管理单元，生成分配关联数据，共有三个必填参数，请参照调用示例参数编写。

3.1 参数

入参：

参数名称	必录	类型	描述
xmlData	是	String	对应body的参数1 ，参数值是一段xml字符串，入参示例见请求样例

如下是具体的入参 xmlData中元素的含义：

参数名称	必录	类型	描述
sourceCU	是	String	源 cu 编码
dataNumber	是	String	物料编码
cuNumber	是	String	需分配的组织编码（目标管理单元编码）

出参：

参数名称	类型	参数说明
errorCode	Int	调用openapi标识，0：成功；1：失败
errMsg	String	记录调用openapi操作信息
data	String	是一段xml信息，存储业务操作记录，xml信息如下表：

data中的xml字段：

参数名称	参数说明
retstatus	业务返回标示，0：成功；1：失败 3:失败且有重复数据
errorMessage	记录业务操作失败信息

3.2 调用示例

 String ip = "172.17.6.176";
 int port = 8080;
 String userName = "zj003";
 String password = "";
 String dcName = "EAS860NEW";
 String language = "l2";
 
 EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port,
   new CommonLogin.Builder(userName, password, dcName, language)
 //.appid("test")
 .build())
 .https(false)//是否https
 .build();
 OpenApiInfo info = new OpenApiInfo();
 info.setApi("AssignMaterialFacade-assignMaterial");
 info.setData("示例中的xmlData数据");
 OpenApi openApi = OpenApiFactory.getService(loginCtx);
 String result = openApi.invoke(info);
 System.out.println("----------result:" + result);

第三方依赖包：

openapi-server.jar

sp-openapi-server.jar

log4j-1.2.15.jar

fastjson-1.2.58.jar

3.3 请求样例

 {
    "api": "AssignMaterialFacade-assignMaterial",
    "data": [
             "<AssignData>
                 <AssignHead>
                     <sourceCU>01</sourceCU>
                     <dataNumber>feiyang001</dataNumber>
                 </AssignHead>
                 <AssignCUS>
                     <AssignCU>
                         <cuNumber>0001</cuNumber>
                     </AssignCU>
                     <AssignCU>
                         <cuNumber>000000</cuNumber>
                     </AssignCU>
                 </AssignCUS>
             </AssignData>"
    ]
 }

3.4 返回样例

 {
   "errCode": 0,
   "errMsg":" 执行成功",
   "data":{
         "<Result>
     <retstatus>0</retstatus> 
      <errorMessages>
          <errorMessage number=”materialNumber01”>
             如：物料不存在
         </errorMessage>
     </errorMessages>
     </Result>"
   }
 }

二、模块：主数据（客户）OpenApi接口

1. 提交客户分类到EAS接口--String importCustomerGroupData(String xmlData)；

接口名称：ImportCustomerGroupFacade-importCustomerGroupData

元数据别名：导入客户分类数据

接口简介：导入客户分类资料，用于第三方系统向EAS同步客户分类信息

接口描述：导入客户分类资料，用于第三方系统向EAS同步客户分类信息，包括新增、修改、启用、停用，目前参数类型为xml格式，请参照调用示例参数编写。

1.1 参数

入参：

参数名称	必录	类型	描述
xmlData	是	String	对应body的参数1 ，参数值是一段xml字符串，入参示例见请求示例

如下是具体的入参 xmlData中元素的含义：

参数名称	必录	类型	描述
bostype	是	String	客户分类实体的 bostype，一般是7A2569A2
属性 op	是	String	标识当前操作是新增、修改、启用、停用（0=修改，1=启用（核准），2=停用，3=保存，4=提交）
creator	是	Object	EAS 中的用户编码
createTime		timestamp	创建时间
CU	是	Object	控制单元
number	是	String	客户类别编码
name		String	客户类别名称
description		String	客户类别描述
groupStandard	是	Object	客户分类标准编码
parent		object	父分类编码
deletedStatus	是	enum	禁用状态

出参：

参数名称	类型	参数说明
errorCode	Int	调用openapi标识，0：成功；1：失败
errMsg	String	记录调用openapi操作信息
data	String	是一段xml信息，存储业务操作记录，xml信息如下表：

data中的xml字段：

参数名称	参数说明
retstatus	业务返回标示，0：成功；1：失败 3:失败且有重复数据
errorMessage	记录业务操作失败信息

1.2 调用示例

 String ip = "172.17.6.176";
 int port = 8080;
 String userName = "zj003";
 String password = "";
 String dcName = "EAS860NEW";
 String language = "l2";
 
 EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port,
   new CommonLogin.Builder(userName, password, dcName, language)
 //.appid("test")
 .build())
 .https(false)//是否https
 .build();
 OpenApiInfo info = new OpenApiInfo();
 info.setApi("ImportCustomerGroupFacade-importCustomerGroupData");
 info.setData("示例中的xmlData数据");
 OpenApi openApi = OpenApiFactory.getService(loginCtx);
 String result = openApi.invoke(info);
 System.out.println("----------result:" + result);

第三方依赖包：

openapi-server.jar

sp-openapi-server.jar

log4j-1.2.15.jar

fastjson-1.2.58.jar

1.3 请求样例

 {
   "api": "ImportCustomerGroupFacade-importCustomerGroupData",
   "data":   [
                 "<DataInfo bostype=\"7A2569A2\" op=\"4\">
                     <DataHead>
                         <creator>user</creator>
                         <createTime>2020-08-13 09:28:46</createTime>
                         <CU>01</CU>
                         <number>feiyang001</number>
                         <name>shawn客户分类</name>
                         <description>肥羊客户分类描述</description>
                         <groupStandard>customerGroupStandard</groupStandard>
                         <deletedStatus>1</deletedStatus>
                     </DataHead>
                 </DataInfo>"
             ]
 }

1.4 返回样例

 {
   "errCode": 0,
   "errMsg":" 执行成功",
   "data":{
         "<Result>
     <retstatus>0</retstatus> 
      <errorMessages>
          <errorMessage number=”group01”>
             如：编码重复；
         </errorMessage>
     </errorMessages>
     </Result>"
   }
 }

2. 提交客户到EAS接口--String importCustomerData(String xmlData)；

接口名称：ImportCustomerFacade-importCustomerData

元数据别名：导入客户数据

接口简介：导入客户资料，用于第三方系统向EAS同步客户信息

接口描述：导入客户资料，用于第三方系统向EAS同步客户信息，包括新增、修改、启用、停用，目前参数类型为xml格式，请参照调用示例参数编写。

2.1 参数

入参：

参数名称	必录	类型	说明
xmlData	是	String	对应body的参数1 ，参数值是一段xml字符串，入参示例见请求样例

如下是具体的入参 xmlData中元素的含义：

参数名称	必填	类型	说明
bostype	是	String	客户实体的 bostype，一般是BF0C040E
属性 op	是	String	标识当前操作是新增、修改、启用、停用（0=修改，1=启用（核准），2=停用，3=保存，4=提交）
creator	是	Object	EAS 中的用户编码
createTime		Timestamp	创建时间
CU	是	Object	控制单元的编码
number	是	String	客户编码
name	是	String	客户名称
browseGroup	是	Object	客户分类
usedStatus		Enum	状态：0=未核准，1=核准，2=禁用（如果需要在提交后直接为核准状态，可以在提交时设置为1）
version		int	版本号
isInternalCompany	是	boolean	是否集团内公司
internalCompany		Object	集团内公司（如果“是否集团内公司”为 1 的时候
taxPayerType		String	纳税人类型
customerKind		String	客户性质
city		String	城市
province		String	省份
bizRegisterNo		String	工商注册号
invoiceType		Enum	发票类型 0=普通发票 1=专用发票 2=电子发票
taxRegisterNo		String	税务登记号，当invoiceType=1时必填
busiExequatur		String	生产经营许可证
busiLicence		String	营业执照
address		String	地址
foreignName		String	外文名称
DataEntries	是	Array	其他分类：第一个填写基本分类标准和基本分类

DataEntries含义：

主数据（客户、供应商、物料）OpenApi文档

一、模块：主数据（物料）OpenApi接口

1. 提交物料分类到EAS的接口方法--String importMaterialGroupData(String xmlData)；

1.1 参数

1.2 调用示例

1.3 请求样例

1.4 返回样例

2. 提交物料到EAS的接口方法--String importMaterialData(String xmlData)；

2.1 参数

2.2 调用示例

2.3 请求样例

2.4 返回样例

3. 分配物料到管理单元接口方法--String assignMaterial(String xmlData)；

3.1 参数

3.2 调用示例

3.3 请求样例

3.4 返回样例

二、模块：主数据（客户）OpenApi接口

1. 提交客户分类到EAS接口--String importCustomerGroupData(String xmlData)；

1.1 参数

1.2 调用示例

1.3 请求样例

1.4 返回样例

2. 提交客户到EAS接口--String importCustomerData(String xmlData)；

2.1 参数

主数据（客户、供应商、物料）OpenApi文档

相关阅读

栏目

最新发布

热门标签