SAP B1 Service Layer - 如何通过REST API为Business Partner创建新联系人

以下为SAP Business One环境下的标准实现步骤，直接按流程操作即可：

1. 前置校验 #

• 确认目标业务伙伴的CardCode真实有效，已存在于系统中
• 确认当前调用账号拥有Business Partners对象的编辑权限
• 提前获取有效Service Layer会话令牌，放入请求头Cookie字段：B1SESSION={你的会话令牌}; ROUTEID={对应路由ID}

2. 接口基础信息 #

• 请求方法：POST
• 请求端点：/b1s/v1/ContactEmployees
• 请求头必填参数：Content-Type: application/json

3. 标准JSON请求体示例 #

{
    "CardCode": "C00012", // 替换为目标业务伙伴的实际CardCode
    "Name": "张三",
    "FirstName": "三",
    "LastName": "张",
    "Position": "采购经理",
    "E_Mail": "zhangsan@example.com",
    "Phone1": "13xxxxxxxxx",
    "MobilePhone": "13xxxxxxxxx",
    "Fax": "021-xxxxxxx",
    "Remarks": "负责华东区域采购对接",
    "Active": "tYES"
}

如果需要填充自定义字段，直接在JSON中追加U_开头的自定义字段名即可，例如"U_Department": "采购部"。

4. 响应说明 #

调用成功后会返回201状态码，响应体包含新创建联系人的ContactEmployeeCode，后续可通过该编码对联系人进行修改、查询操作。

常见注意事项 #

• CardCode为必填字段，必须和已存在的业务伙伴编码完全匹配，大小写敏感
• 同一业务伙伴下需要创建多个联系人的，重复调用该接口传入相同CardCode和不同联系人信息即可
• 若需要关联职位、地址等扩展信息，可在创建完成后调用PATCH /b1s/v1/ContactEmployees({ContactEmployeeCode})接口追加对应字段

内容的提问来源于stack exchange，提问作者Patrick