고객사 개요
고객사는 물류사가 거래하는 회사를 의미합니다.
사방넷 풀필먼트 시스템은 모두 고객사 기준으로 관리되므로, 물류사는 고객사별로 각각 계정을 관리해야 합니다.
고객사를 등록하면 해당 계정은 고객사 마스터계정이되며, 고객사가 추가적으로 계정이 필요한 경우엔 사방넷 풀필먼트 > 관리 > 고객사 추가계정에서 계정을 추가합니다.
해당 페이지는 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.
사방넷 풀필먼트 매뉴얼: 고객사 관리 바로가기 ▶
사방넷 풀필먼트 시스템은 모두 고객사 기준으로 관리되므로, 물류사는 고객사별로 각각 계정을 관리해야 합니다.
고객사를 등록하면 해당 계정은 고객사 마스터계정이되며, 고객사가 추가적으로 계정이 필요한 경우엔 사방넷 풀필먼트 > 관리 > 고객사 추가계정에서 계정을 추가합니다.
해당 페이지는 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.
사방넷 풀필먼트 매뉴얼: 고객사 관리 바로가기 ▶
지원 method
고객사 기본 Object 구조
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID |
partner_code | string(4) | 고객사코드 |
id | string(20) | 고객사 로그인 ID 필수, unique 체크 |
name | string(100) | 회사명 필수 |
biz_num | string(20) | 사업자번호 필수 |
ceo | string(30) | 대표자 |
manager | string(30) | 담당자명 |
member_type | string(1) | 추가계정 구분 P.고객사 마스터계정, A. 추가 계정 |
string(100) | 이메일 | |
jongmok | string(100) | 종목 |
uptae | string(100) | 업태 |
tel | string(20) | 전화 |
hp | string(20) | 휴대폰 |
fax | string(20) | 팩스 |
zipcode | string(10) | 주소 우편번호 |
address1 | string(150) | 주소1 |
address2 | string(150) | 주소2 |
memo | string(150) | 특이사항 |
default_shipping_name | string(100) | 발송자명 |
default_shipping_tel | string(20) | CS전화번호 |
default_shipping_zipcode | string(10) | 발송지 우편번호 |
default_shipping_address1 | string(150) | 발송지 주소1 |
default_shipping_address2 | string(150) | 발송지 주소2 |
use_fg | string(1) | 활성화 여부 필수, Y.활성화, N.비활성화 |
고객사 등록
Request URI | /v2/member/partner |
---|---|
Method | POST |
권한 | 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
id | string(20) | 고객사 로그인 ID 필수, unique 체크 |
name | string(100) | 회사명 필수 |
biz_num | string(20) | 사업자번호 필수 |
ceo | string(30) | 대표자 |
manager | string(30) | 담당자명 |
string(100) | 이메일 | |
jongmok | string(100) | 종목 |
uptae | string(100) | 업태 |
tel | string(20) | 전화 |
hp | string(20) | 휴대폰 |
fax | string(20) | 팩스 |
zipcode | string(10) | 주소 우편번호 |
address1 | string(150) | 주소1 |
address2 | string(150) | 주소2 |
memo | string(150) | 특이사항 |
default_shipping_name | string(100) | 발송자명 |
default_shipping_tel | string(20) | CS전화번호 |
default_shipping_zipcode | string(10) | 발송지 우편번호 |
default_shipping_address1 | string(150) | 발송지 주소1 |
default_shipping_address2 | string(150) | 발송지 주소2 |
use_fg | string(1) | 활성화 여부 필수, Y.활성화, N.비활성화 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | member_id | integer | 고객사 ID |
partner_code | string(4) | 고객사코드 |
Request Sample
{
"id": "test_id",
"name": "주식회사 테스트",
"biz_num": "123-45-6789",
"ceo": "홍길순",
"manager": "홍길동",
"email": "my@email.com",
"jongmok": "",
"uptae": "",
"tel": "01-1234-1234",
"hp": "010-1234-1234",
"fax": "1234-1234",
"zipcode": "",
"address1": "",
"address2": "",
"memo": "",
"default_shipping_name": "",
"default_shipping_tel": "",
"default_shipping_zipcode": "",
"default_shipping_address1": "",
"default_shipping_address2": "",
"use_fg": "Y"
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"member_id": 7,
"partner_code": "T002"
}
}
고객사 수정
Request URI | /v2/member/partner/{member_id} |
---|---|
Method | PUT |
권한 | 물류사 |
비고 | 수정시는 모든 필드가 아닌 수정 대상 데이터필드만 입력 모든 필드가아닌 수정 대상 데이터 필드만 입력 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
name | string(100) | 회사명 필수 |
biz_num | string(20) | 사업자번호 필수 |
ceo | string(30) | 대표자 |
manager | string(30) | 담당자명 |
string(100) | 이메일 | |
jongmok | string(100) | 종목 |
uptae | string(100) | 업태 |
tel | string(20) | 전화 |
hp | string(20) | 휴대폰 |
fax | string(20) | 팩스 |
zipcode | string(10) | 주소 우편번호 |
address1 | string(150) | 주소1 |
address2 | string(150) | 주소2 |
memo | string(150) | 특이사항 |
default_shipping_name | string(100) | 발송자명 |
default_shipping_tel | string(20) | CS전화번호 |
default_shipping_zipcode | string(10) | 발송지 우편번호 |
default_shipping_address1 | string(150) | 발송지 주소1 |
default_shipping_address2 | string(150) | 발송지 주소2 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
Request Sample
{
"name": "주식회사 테스트",
"biz_num": "123-45-6789",
"ceo": "홍길순",
"manager": "홍길동",
"email": "my@email.com",
"jongmok": "",
"uptae": "",
"tel": "01-1234-1234",
"hp": "010-1234-1234",
"fax": "1234-1234",
"zipcode": "",
"address1": "",
"address2": "",
"memo": "",
"default_shipping_name": "",
"default_shipping_tel": "",
"default_shipping_zipcode": "",
"default_shipping_address1": "",
"default_shipping_address2": ""
}
Response Sample
{
"code": "9999",
"message": "ok"
}
고객사 조회(단일)
Request URI | /v2/member/partner/{member_id} |
---|---|
Method | GET |
권한 | 물류사 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
response | dataObject | 고객사 기본 Object 구성 ▶ |
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"member_id": "7",
"partner_code": "T002",
"id": "test_id",
"name": "주식회사 테스트",
"biz_num": "123-45-6789",
"ceo": "홍길순",
"manager": "홍길동",
"member_type": "P",
"email": "my@email.com",
"jongmok": "",
"uptae": "",
"tel": "01-1234-1234",
"hp": "010-1234-1234",
"fax": "1234-1234",
"zipcode": "",
"address1": "",
"address2": "",
"memo": "",
"default_shipping_name": "",
"default_shipping_tel": "",
"default_shipping_zipcode": "",
"default_shipping_address1": "",
"default_shipping_address2": "",
"use_fg": "Y"
}
}
고객사 조회(벌크)
Request URI | /v2/member/partners |
---|---|
Method | GET |
권한 | 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_ids | array | 고객사 ID 배열 |
use_fg | string(1) | 활성화 여부 ( Y, N ) |
page | integer | 페이지번호 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | total_count | integer | 전체 갯수 |
total_page | integer | 전체 페이지수 | |
current_page | integer | 현재 페이지 번호 | |
data_list 처리 데이터 리스트 |
dataList | 고객사 기본 Object 구조 ▶ |
Request Sample
/v2/member/partners?member_ids=2&member_ids=3&member_ids=4&use_fg=Y
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"total_count": 3,
"total_page": 1,
"current_page": 1,
"data_list": [
{
"member_id": "2",
"partner_code": "N001",
"id": "daou",
"name": "본사",
"member_type": "P",
"biz_num": "1234567890",
"ceo": "홍길동",
"manager": "담당자명",
"email": "contact@daou.co.kr",
"jongmok": "wms",
"uptae": "",
"tel": "1234-5678",
"hp": "1234-5678",
"fax": "",
"zipcode": "07807",
"address1": "서울시 서초구 효령로 190 비선빌딩 6층",
"address2": "12층 1207호",
"memo": "다우기술입니다",
"default_shipping_name": "다우기술",
"default_shipping_tel": "1234-5678",
"default_shipping_zipcode": "07807",
"default_shipping_address1": "서울시 서초구 효령로 190 비선빌딩",
"default_shipping_address2": "6층",
"use_fg": "Y"
},
{
"member_id": "3",
"partner_code": "F001",
"id": "fdgdfdsgf",
"name": "회사명",
"member_type": "P",
"biz_num": "132132132",
"ceo": "대표자",
"manager": "담당자명",
"email": "",
"jongmok": "",
"uptae": "",
"tel": "",
"hp": "",
"fax": "",
"zipcode": "",
"address1": "",
"address2": "",
"memo": "",
"default_shipping_name": "",
"default_shipping_tel": "",
"default_shipping_zipcode": "12345",
"default_shipping_address1": "경기 김포시 김포한강9로75번",
"default_shipping_address2": "701",
"use_fg": "Y"
}
]
}
}