13. Customer 服务

通过 client.customer() 访问。提供客户(Customer)的 CRUD 及按站点查询功能。

13.1 方法一览

方法	返回类型	HTTP	端点
create(CustomerRequestV5)	CustomerResponseV5 或 null	POST	/api/v5/customer
update(customer_id, CustomerRequestV5)	CustomerResponseV5 或 null	PUT	/api/v5/customer/{id}
delete(customer_id)	boolean	DELETE	/api/v5/customer/{id}
get(customer_id)	CustomerResponseV5 或 null	GET	/api/v5/customer/{id}
list()	List<CustomerResponseV5>	GET	/api/v5/customer
listBySite(site_id)	List<CustomerResponseV5>	GET	/api/v5/customer?site_id=...
exists(customer_id)	boolean	GET	/api/v5/customer/{id}/exists
count()	long	GET	/api/v5/customer/count

13.2 CustomerRequestV5 / CustomerResponseV5

字段	类型	说明
customer_id	String	客户 ID (PK)
customer_name	String	客户名称
site_id	String	所属站点
description	String	说明
manager_name	String	负责人姓名
manager_email	String	负责人邮箱
manager_phone	String	负责人电话
external_system	String	外部系统名称(最多 50 个字符,例如 SAP)— 与 external_id 成对识别。没有系统的 ID 不构成标识
external_id	String	该系统中的客户 ID(最多 100 个字符)。按配对查找: GET /api/v5/customer/by-external/{system}/{external_id}
company_code	String	公司代码
address	String	地址

13.3 使用示例

创建客户

import plantpulse.api.v5.dto.request.CustomerRequestV5;
import plantpulse.api.v5.dto.response.CustomerResponseV5;

CustomerRequestV5 req = new CustomerRequestV5();
req.setCustomer_id("CUST_001");
req.setCustomer_name("삼성전자");
req.setSite_id("SITE_DJ");
req.setExternal_system("ERP");
req.setExternal_id("ERP_C001");
req.setCompany_code("SEC");
req.setAddress("경기도 수원시");
req.setManager_name("홍길동");
req.setManager_email("hong@example.com");
req.setManager_phone("01012345678");

CustomerResponseV5 created = client.customer().create(req);

查询 / 存在性检查

CustomerResponseV5 c = client.customer().get("CUST_001");
boolean exists      = client.customer().exists("CUST_001");
long total          = client.customer().count();

全部 / 按站点列表

import java.util.List;

List<CustomerResponseV5> all     = client.customer().list();
List<CustomerResponseV5> djCusts = client.customer().listBySite("SITE_DJ");

修改 / 删除

CustomerRequestV5 update = new CustomerRequestV5();
update.setCustomer_id("CUST_001");
update.setCustomer_name("삼성전자 DS");
update.setSite_id("SITE_DJ");
// ... 변경할 필드 ...
client.customer().update("CUST_001", update);

client.customer().delete("CUST_001");

13.4 应用场景

场景 — ERP 客户主数据同步

// 1) ERP에서 가져온 고객 데이터
for (ErpCustomer erp : erpData) {
    CustomerRequestV5 req = new CustomerRequestV5();
    req.setCustomer_id("CUST_" + erp.code);
    req.setCustomer_name(erp.name);
    req.setExternal_system("ERP");
    req.setExternal_id(erp.id);
    req.setCompany_code(erp.companyCode);

    if (client.customer().exists("CUST_" + erp.code)) {
        client.customer().update("CUST_" + erp.code, req);
    } else {
        client.customer().create(req);
    }
}

后续步骤

• Employee 服务 — 员工主数据
• Product 服务 — 产品主数据