주소
V5 통합 가이드!
차례
1. 컨트롤 센터 레이아웃
V5 제어 센터에서 보는 것과 주소 엔드포인트를 어떻게 연관시킬 수 있는지에 관해서는 여기서 '고객' 테이블을 살펴보겠습니다. '공급업체' 테이블은 공급업체와 클라이언트가 모두 동일한 '클라이언트' 엔드포인트를 공유하기 때문에 정확히 같은 방식으로 작동합니다.
2. API 링크
이 '주소' 데이터베이스 클래스의 정의에 대해 자세히 알아보려면 다음 링크를 참조하세요.
3. 주소 필드 가이드
3.1. 기본 키
'주소' 엔드포인트를 통해 가져오는 경우 기본 키는 다음과 같습니다.
이름 - 이 주소의 고유한 이름
3.2. 필수 입력 사항
V5에서 유효한 항목을 만드는 데 필요한 다른 필드:
타입 – 주소 유형은 클라이언트와 함께 사용하는 경우 0이어야 하고, 전송을 위한 사이트 주소로 사용하는 경우 1이어야 합니다(modlink).
클라이언트_코드 – 클라이언트 주소를 추가하는 경우 이는 고객/공급업체와 연결되어야 합니다.
3.3. 추가 필드
Line1 - 주소의 첫 번째 줄.
Line2 - 주소의 두 번째 줄.
Line3 - 주소의 세 번째 줄.
City – 주소가 위치한 도시.
주 정부 – 주소가 위치한 주.
국가 – 주소가 위치한 국가.
지퍼 – 주소의 우편번호.
문의하기 – 주소에 대한 연락처 이름.
전화 – 주소와 관련된 전화번호.
이메일 – 주소와 관련된 이메일 주소.
배송 주소(위의 세부 정보를 사용하여 입력한 주소와 다른 경우) 및 비상 리콜 연락처/세부 정보도 여기에 추가할 수 있지만, 여기서는 위의 데이터 포인트만 예시로 사용하겠습니다.
4. 예제 데이터 세트
이 부분에서는 위의 CC 패널에 표시된 고객에게 주소를 추가하려고 합니다. 이 고객은 이전에 'Client' 종점.
5. 방법론
5.1. JSON – 가져오기
'주소' 가져오기 Endpoint/URI –
http://host:port/V5-API/api/integrate/import/address
견본:
'주소' 엔드포인트를 사용하면 다음과 같이 위 추가 사항에 대한 가져오기 파일을 구성할 수 있습니다.
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
이것을 시스템에 게시하면 이 주소가 'CUS01' 고객에게 추가된 것을 볼 수 있습니다.
5.2. CSV – 가져오기
고객/공급업체에 여러 개의 주소가 할당될 수 있으므로 위의 JSON 예제에서 추가한 'CUS01' 고객에 간단히 다른 주소를 추가해 보겠습니다.
CSV 가져오기의 경우 먼저 가져오기에 대한 헤더 파일을 구성해야 합니다.
헤더/열 정의 파일 이름: “주소.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “ \SG 제어 센터\게이트웨이\가져오기\column_defs”
CSV 파일 이름 가져오기: “주소-날짜-시간.csv”
가져올 CSV는 다음 위치에 있어야 합니다. “ \SG 제어 센터\게이트웨이\가져오기”
견본:
헤더 파일:
아래에서 예시 헤더 파일을 볼 수 있습니다. JSON 가져오기에 사용한 것과 동일한 필드를 사용합니다.
이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 가져오기 파일:
그런 다음 헤더에서 정의된 데이터 포인트 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. 이 첫 번째 행은 Control Center에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다. 위의 요구 사항에 따른 가져오기 예는 다음과 같습니다.
이 샘플 가져오기 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
그런 다음 위에 정의한 대로 이 파일을 가져오기 폴더에 넣으면 가져오기가 완료되면 동일한 고객에 대해 이 주소가 추가된 것을 볼 수 있습니다.
