【SAP PO】SAP PO 接口配置完整教程之二REST服务对接

1、了解服务协议

外部服务，由对接方系统提供。
现在主流的服务形式为Restful接口服务，需要使用JSON 数据格式、UTF8 编码。
这里我们以一个SAP推送采购需求到SRM系统的实际案例来进行举例说明。

1.1、服务通讯协议

（1）接口访问方式
请求数据类型：JSON
请求方式：POST
认证方式：Oauth 2.0
传输协议：https

（2）接口认证方式
在每次主动调用SRM开放平台接口时需要带上AccessToken参数，开放平台会根据此次访问的 AccessToken，校验访问的合法性以及所对应的权限并返回相应的结果。
AccessToken的默认有效期为1小时，调用方可定时更新自己本地缓存的token。
设置AccessToken有两种方式，推荐使用第一种，如下所示：
A：在httpHeaders里面设置AccessToken

HttpHeaders httpHeaders = new HttpHeaders();
httpHeaders.add("Authorization", "Bearer " + accessToken);

B：在调用地址后面带上AccessToken

https://*******/sitf/v1/rest/operation-units/conversion-operation-unit?access_token=5e0b05ef-ea2e-4cd8-8a90-2663498e9d87

获取Access Token
① 简要描述：调用该接口，获取token授权，token将作为其他接口的授权凭证。
② 请求方式：POST
③ 请求URL：/oauth/oauth/token
④ 请求参数示例：

https://*******/oauth/oauth/token?grant_type=client_credentials&client_id=*******&client_secret=******&scope=default

请求参数说明

⑤ 反馈示例
正确返回值

{
   
   
    "access_token": "97eb08ad-8c86-459f-9526-905caebe2958",
    "token_type": "Bearer",
    "expires_in": 2263,
    "scope": "default"
}

错误返回值

{
   
   
    "error": "invalid_grant",
    "error_description": "Bad credentials"
}

反馈参数说明

（3）标准请求结构说明
请求body由两部分组成，一部分是"header"信息(并非httpHeader，每个接口格式固定)，一部分是"body"信息（存放的动态业务数据，每个接口视具体接口字段而定），如下所示

{
   
   
    "header":{
   
   
        "applicationCode":"",
        "applicationGroupCode":"",
        "batchCount":"",
        "batchNum":"",
        "externalSystemCode":"",
        "interfaceCode":"",
        "userName":""
    },
    "body":[
        {
   
   
            "sourceCode":"testFiled",
            "esOuCode":"testFiled",
            "erpCreationDate":"2019-09-16 03:01:50",
            "erpLastUpdateDate":"2019-09-16 03:01:50",
            "enabledFlag":1,
            "esOuId":"testFiled",
            "ouName":"testFiled"
        }
    ]
}

请求参数说明

（4）标准反馈结构说明
​SRM接口的反馈结构是固定的标准格式，分为批次响应结果（本次请求的响应结果）和单据执行结果（传输的具体单据的执行响应结果），如下所示：

{
   
   
    "batchNum":"",
    "executeResult":"PART",
    "responseMessage":"SSS",
    "responseStatus":"SUCCESS",
    "restResponseDtlDTOList":[
        {
   
   
            "documentCode":"SS",
            "documentId":1,
            "responseMessage":"MM",
            "responseStatus":"SUCCESS"
        },
        {
   
   
            "documentCode":"BB",
            "documentId":2,
            "responseMessage":"",
            "responseStatus":"ERROR"
        }
    ]
}

反馈参数说明

restResponseDtlDTOList

1.2、具体接口协议

（1）接口地址：https://gateway.dev.isrm.going-link.com/sitf/v1/rest/forecast/receiver-data
（2）请求报文结构：

{
   
   
    "header": {
   
   
        "applicationCode": "服务方提供",
        "applicationGroupCode":"服务方提供",
        "batchCount":"此批次数据条数",
        "batchNum":"递增且唯一的少于20位的数字，建议时间戳",
        "externalSystemCode":"服务方提供的外部系统CODE",
        "interfaceCode":"服务方提供",
        "userName": "服务方提供"
    },
    "body": [
        {
   
   
            "esFcstHeaderId": "",
            "esFcstNum": "2200001003361000001101421010",
            "lineNum": "1",
            "sourceCode": "SAP",
            "fcstStartDate": "2022-01-01",
            "esItemId": "",
            "esItemCode": "000000100000110