로그인이 필요합니다.
클라우드 서비스 보급·확산 사업 공급기업 선정! 이용료 최대 80% 지원

개발가이드(ver2.0)

고객사 개요

고객사는 물류사가 거래하는 회사를 의미합니다.
사방넷 풀필먼트 시스템은 모두 고객사 기준으로 관리되므로, 물류사는 고객사별로 각각 계정을 관리해야 합니다.
고객사를 등록하면 해당 계정은 고객사 마스터계정이되며, 고객사가 추가적으로 계정이 필요한 경우엔 사방넷 풀필먼트 > 관리 > 고객사 추가계정에서 계정을 추가합니다.
해당 페이지는 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.

사방넷 풀필먼트 매뉴얼: 고객사 관리 바로가기 ▶

지원 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. 추가 계정

email 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) 담당자명
email 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) 담당자명
email 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"
            }
        ]
    }
}
Top