13. Customer-Dienst

Der Zugriff erfolgt über client.customer(). Der Dienst stellt CRUD-Operationen für Kunden (Customer) sowie die Abfrage nach Site bereit.

13.1 Methodenübersicht

Methode	Rückgabetyp	HTTP	Endpunkt
create(CustomerRequestV5)	CustomerResponseV5 oder null	POST	/api/v5/customer
update(customer_id, CustomerRequestV5)	CustomerResponseV5 oder null	PUT	/api/v5/customer/{id}
delete(customer_id)	boolean	DELETE	/api/v5/customer/{id}
get(customer_id)	CustomerResponseV5 oder 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

Feld	Typ	Beschreibung
customer_id	String	Kunden-ID (PK)
customer_name	String	Kundenname
site_id	String	Zugehörige Site
description	String	Beschreibung
manager_name	String	Name des Ansprechpartners
manager_email	String	E-Mail des Ansprechpartners
manager_phone	String	Telefonnummer des Ansprechpartners
external_customer_id	String	Kunden-ID im Fremdsystem (z. B. ERP)
company_code	String	Firmencode
address	String	Adresse

13.3 Anwendungsbeispiele

Kunde anlegen

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

Abfrage / Existenzprüfung

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

Gesamtliste / Liste nach Site

import java.util.List;

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

Ändern / Löschen

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 Einsatzszenarien

Szenario — Abgleich des ERP-Kundenstamms

// 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);
    }
}

Nächste Schritte

• Employee-Dienst — Mitarbeiterstamm
• Product-Dienst — Produktstamm