PLAYAUTO for AUCTION C2C - Manual 1.0
(주)플레이오토 솔루션을 사용해 주셔서 대단히 감사합니다.
PLAYAUTO C2C 솔루션은 기업과 기업간의 상품 판매 연동을 위한 최적의 시스템 입니다.
아래의 내용은 귀사의 상품정보를 어떻게 PLAYAUTO 로 송신하고, 또한 PLAYAUTO 에 수집된 주문데이터를
어떻게 귀사의 시스템이 수신할 수 있는지 그 방법을 안내하여 드립니다.
매뉴얼 버전 안내
[ 1.0.0.3 ]
최종 업데이트 : 2006년 06월 07일
- 1.0.0.3 : 2006-06-07 주문 정보 송신시 배송완료 단계 추가 (E3)
- 1.0.0.2 : 2006-05-17 2차 수정
- 1.0.0.1 : 2006-05-15 1차 수정
- 1.0.0.0 : 2006-05-11 김형섭 초기 매뉴얼 제작
일러두기
* PLAYAUTO 에서는 귀사의 시스템과 자료교환을 위해 XML 기술을 사용합니다.
* 때문에 본 매뉴얼을 참조하는 개발자 분께서는 XML을 읽고, 생성할 수 있는 기술이 반드시 필요합니다.
* 그리고 타 웹서버에서 출력되는 XML 데이터를 원하는 시간에 다운로드하여 처리할 수 있는 기술이 필요할 수도 있습니다.
목 차
① 상품 데이터 송신
② 주문 데이터 수신 ← now reading
③ 송장번호 데이터 송신
④ 반품/교환 처리결과 송신
⑤ 문의게시판 수신
⑥ 문의게시판 답변 송신
② 주문 데이터 수신
PLAYAUTO 에서는 옥션에서 수집할 수 있는 데이터는 모두 제공이 가능하며, 여기에 귀사의 원 상품코드도 포함하여 보내드리게 됩니다.
귀사에서는 보내드린 원 상품코드를 이용하여 어떤 상품이 주문되었는지
별도의 매칭 없이 확인이 가능 합니다.
|
| 분류 |
내용 |
|
|
주문 데이터는 어떻게 받나요?
|
1. EXCEL 파일로 전달 (관리자 작업 필요)
- PLAYAUTO SCM 상에서 귀사에서 처리할 수 있는 양식으로 EXCEL 파일을 생성해 드리며,
해당 파일을 다운로드 받아 관리자께서 귀사의 시스템에 업로드 하는 형태로 처리 합니다.
2. PLAYAUTO 표준 XML 사용
- PLAYAUTO 에서 제공하는 표준 XML 형태로 주문을 수신하실 수 있습니다.
예제)
샘플XML 실서비스 확인용(인자 적용됨)
http://auc.playauto.co.kr/export/playauto_order_data.html?sdt=20060101&edt=20060131&uc=luxuryin2&dc=COMMON&ty=A0
샘플XML 확인용(인자 비적용,고정된 데이터)
http://auc.playauto.co.kr/export/playauto_order_data.html?sdt=20060101&edt=20060131&uc=auc_test_sample&dc=COMMON&ty=A0
|
| 파라미터명 |
값종류 |
설명 |
|
| uc |
업체코드 |
발급받으신 PLAYAUTO 업체코드 (고정값) |
|
| dc |
양식코드 |
발급받으신 양식코드 (고정값)
본 값에 COMMON 을 주시면 표준양식 |
|
| sdt |
YYYYmmdd |
검색 시작일 (시작일 00시부터 조회합니다.) |
|
| edt |
YYYYmmdd |
검색 종료일 (종료일 23시 59분 59초 까지 조회합니다.) |
|
| ty |
R1 : 결제완료
R2 : 출력완료
R3 : 취소주문
R4 : 반품요청
R0 : R1~R4 모두
S1 : 배송중
S2 : 품절상품
S3 : 교환발송
S4 : 반품완료
S0 : S1~S4 모두
E1 : 정산완료
E2 : 환불완료
E3 : 배송완료
E0 : E1~E2 모두
A0 : 모두
|
조회하실 데이터 분류 지정
왼쪽의 값 표에서 영문1+숫자1부분만 보내주시면 됩니다.
기본적으로 모든 값 조회를 원하실때는 A0 을 주시면 됩니다.
|
|
주의사항
파라미터명은 모두 소문자로 보내주세요.
GET / POST 상관없습니다.
상기 파라미터는 모두 필수값 입니다. 파라미터 미존재시 에러메세지 표시됩니다.
에러발생시 화면에 (ERR: 에러메세지내용) 과 같이 출력 됩니다.
|
|
3. 귀사에서 원하는 포맷으로 전달
- CSV, EXCEL,. 특별한 구분자를 가진 텍스트파일 형태, XML 등으로 귀사에서 기존에 타 기업 주문자료를 수신하는 구조로 이미 시스템이 갖춰진 경우 그 양식, 그 방법 대로 셋팅 하여 드립니다.
예제)
http://auc.playauto.co.kr/export/playauto_order_data.html?sdt=20050101&edt=20061231&uc=luxuryin2&dc=A001&ty=A0
|
|
|
반영 주기는 얼마나 잡아야 되죠?
|
주문정보는 옥션의 주문 정보를 PLAYAUTO 에서 스크래핑 하는데 수십분의 시간이 필요하기 때문에 최소 1시간 정도의 유격이 있어야 합니다.
|
|
주문을 처리하려면
상품코드가 필요합니다.
|
옥션의 경매코드가 아닌 귀사의 원 상품코드를 같이 보내드립니다.
PLAYAUTO 를 통해 등록되는 모든 상품은 추후 주문, 문의 등의 정보를 드릴 때 귀사의 원 상품코드를 같이 보내드리게 됩니다.
|
|
|
옵션값은 어떻게 받나요 ?
|
옥션은 기본적으로 옵션 정보 처리 부분이 많이 빈약 합니다.
1차적으로는 색상/사이즈 와 같이 2가지 옵션을 조합해서 입력할 수 있게 되어 있으나 이 구조는
사이즈 9가지, 색상 30가지의 입력 제한이 있습니다.
본래 옥션의 시스템은 구매자가 구매시 주문요구사항(배송메시지) 란에 구매하고자 하는 옵션 내용을 수기로 기입하던 시스템이었기 때문에 PLAYAUTO 에서도 옥션에서 넘어오는 주문정보 선택사항을 그대로 드리고 있으며, 상기 색상 9가지, 사이즈 30가지 범위에 포함이 되어 등록된 경우는 고객 선택사항 텍스트를 약간은 가공하여 드릴 수 있습니다.
ex) 선택`66:1|선택`77:1
따라서 귀사의 시스템이 옵션코드 등의 옵션별 단품코드가 별도 생성되어 관리되는 시스템이었다면, 옥션 판매 데이터는 예외로 하시는 처리가 반드시 필요합니다.
|
|
|
취소 / 반품 / 교환 주문은 어떻게 받나요 ?
|
상기의 연동 XML을 호출하실 때 파라미터를 통해 가져가셔야 합니다.
취소주문 요청 예제
예제)
http://auc.playauto.co.kr/export/playauto_order_data.html?sdt=20060101&edt=20060131&uc=luxuryin2&dc=COMMON&ty=R3
위처럼 ty 를 R3 으로 주시면 취소된 주문만 출력 됩니다. 본 자료를 통해 귀사의 시스템의 주문에 취소처리를 해주셔야 합니다. (파라미터는 위의 주문데이터는 어떻게..? 섹션 참고)
반품주문 요청 예제
예제)
http://auc.playauto.co.kr/export/playauto_order_data.html?sdt=20060101&edt=20060131&uc=luxuryin2&dc=COMMON&ty=R4
위처럼 ty 를 R4 으로 주시면 고객이 배송후 반품을 요청한 주문만 출력 됩니다. 본 자료를 통해 귀사의 시스템의 주문에 반풉접수처리를 해주셔야 합니다.
그리고 반품요청의 경우는 반품이 완료되었을때 다시 저희쪽에서 가져갈수 있도록 귀사의 시스템에서 '반품완료' 또는 '교환완료' 상태로 변경을 해주셔야 합니다.
반품완료 및 교환완료 처리 송신에 대한 부분은 [④ 반품/교환 처리결과 송신] 부분을 참고하세요.
|
|
ㄱ. 데이터 보안
귀사의 본 XML URL 접근 서버 IP를 PLAYAUTO 로 알려주셔야 합니다.
허가된 서버에 한해 본 XML 내용을 제공해 드리며, 그 외의 접속에 대해서는 거부합니다.
IP 및 접근서버 내역 알려주실 주소 : beat@playauto.co.kr (주)플레이오토 개발팀장 김형섭
ㄴ. 개발 및 테스트 절차
1. PLAYAUTO 에서 제공한 URL 을 귀사의 개발 언어로 URL 스크래핑 합니다.
2. 받아오신 내용을 파싱하여 귀사의 시스템에 반영 하세요.
알려드립니다:
본 매뉴얼은 PLAYAUTO 기업 버전 사용자에 한해 제공 됩니다.
(주)플레이오토 본사의 허락없이 무단 복제 및 전제를 금하오며, 관련 내용에 대한 문의는 beat@playauto.co.kr (개발팀장) 앞으로 보내주십시오.
감사합니다.
|