13. Customer Service

Accessed via client.customer(). Provides customer CRUD operations and site-based lookup.

13.1 Method List

Method	Return Type	HTTP	Endpoint
create(CustomerRequestV5)	CustomerResponseV5 or null	POST	/api/v5/customer
update(customer_id, CustomerRequestV5)	CustomerResponseV5 or null	PUT	/api/v5/customer/{id}
delete(customer_id)	boolean	DELETE	/api/v5/customer/{id}
get(customer_id)	CustomerResponseV5 or 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

Field	Type	Description
customer_id	String	Customer ID (PK)
customer_name	String	Customer name
site_id	String	Owning site
description	String	Description
manager_name	String	Contact name
manager_email	String	Contact email
manager_phone	String	Contact phone number
external_customer_id	String	Customer ID in external system (ERP, etc.)
company_code	String	Company code
address	String	Address

13.3 Usage Examples

Creating a Customer

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_customer_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);

Lookup / Existence Check

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

Full List / List by Site

import java.util.List;

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

Update / Delete

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 Use Case Scenarios

Scenario — Synchronizing the ERP Customer Master

// 1) ERP에서 가져온 고객 데이터
for (ErpCustomer erp : erpData) {
    CustomerRequestV5 req = new CustomerRequestV5();
    req.setCustomer_id("CUST_" + erp.code);
    req.setCustomer_name(erp.name);
    req.setExternal_customer_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);
    }
}

Next Steps

• Employee Service — Employee master
• Product Service — Product master