네이버지식쇼핑 EP (Engine Page) 제작및연동가이드 ( 제휴사제공용 ) 본문서는지식쇼핑제휴사의원활한 EP 제작및연동을위해제공되는문서입니다본문서는배포및수정이허용되지않습니다
목차 1. EP (Engine Page) 설명 2. EP (Engine Page) 양식 3. 각필드별상세설명 4. 개선된필드및규칙 5. 주의사항 6. EP (Engine Page) 예시 7. FAQ
1 EP (Engine Page) 설명
1.1 EP (Engine Page) 구성및역할 < 지식쇼핑 EP 구성 > 지식쇼핑 EP 전체 EP 요약 EP < 지식쇼핑 EP 역할 > 구분전체 EP 요약 EP 대상카테고리 모든카테고리 모든카테고리 대상상품 서비스중인모든상품 서비스중인모든상품 업데이트주기 01 시 ( 일 1 회 ) 09~21 시 ( 매시각정각, 일 13 회 ) 역할 싞규상품등록 상품정보업데이트 품젃상품서비스중지 품젃복구상품서비스재개 가격, 상품명업데이트 품젃상품서비스중지 품젃복구상품서비스재개 특이사항 싞규 EP 는사용하지않음
1.2 EP (Engine Page) 생성방법 <EP 종류별생성방법 > 구분전체 EP 요약 EP 생성대상상품정보 서비스중인모든상품 생성대상필드 모든상품정보필드 5 개의필수필드로만생성 - <<<begin>>> - <<<mapid>>> - <<<pname>>> - <<<price>>> - <<<ftend>>> <EP 공통생성방법 > EP URL 준수 - EP 가이드에맞게생성하싞 EP 는반드시지식쇼핑과약속된 EP URL 에 txt 파일로생성해주셔야하며, 이파일은 http 로접근가능해야합니다 - ex) 젂체 EP : http://www.naver.com/ep/all.txt, 요약 EP : http://www.naver.com/ep/brief.txt EP 생성시각준수 - EP 는반드시각 EP 수싞시각이젂에생성완료되어야합니다 - 각 EP 수싞시각이후에생성완료될경우, 해당타임 EP 수싞 / 처리는스킵되며다음타임 EP 로수싞 / 처리짂행됩니다 각필드와필드사이라인구분처리 - 각필드와필드사이는라인구분처리되어야합니다 - 라인구분처리는엔터로구분하시는것이아닌, \n 으로구분처리되어야합니다 필드 Status 별생성방법 - 필수필드 : 반드시생성해주셔야하는필드입니다해당필드가 null 이거나에러인경우해당필드가포함된상품자체가에러처리됩니다 - 옵션필드 : 상품의부가적인정보를생성해주시는필드입니다해당필드가없으실경우생략가능합니다 필드별 Type, Size, 규칙준수 - 각필드별 Type, Size 및규칙을반드시준수해야합니다 - 준수하지않을경우, 해당필드는에러처리됩니다
2 EP (Engine Page) 양식
2.1 전체 EP (Engine Page) 양식 필드명 status 필드설명 <<<begin>>> 필수 상품의시작 <<<mapid>>> 필수 상품 ID <<<pname>>> 필수 상품명 <<<price>>> 필수 상품가격 <<<pgurl>>> 필수 상품 URL <<<igurl>>> 필수 이미지 URL <<<cate1>>> 필수 업체카테고리명 ( 대분류 ) <<<cate2>>> 옵션 업체카테고리명 ( 중분류 ) <<<cate3>>> 옵션 업체카테고리명 ( 소분류 ) <<<cate4>>> 옵션 업체카테고리명 ( 세분류 ) <<<caid1>>> 옵션 업체카테고리 ID ( 대분류 ) <<<caid2>>> 옵션 업체카테고리 ID ( 중분류 ) <<<caid3>>> 옵션 업체카테고리 ID ( 소분류 ) <<<caid4>>> 옵션 업체카테고리 ID ( 세분류 ) <<<model>>> 옵션 모델명 <<<brand>>> 옵션 브랜드 <<<maker>>> 옵션 제조사 <<<origi>>> 옵션 원산지 <<<pdate>>> 옵션 출시일 <<<deliv>>> 필수 배송료 <<<event>>> 옵션 이벤트 <<<coupo>>> 옵션 쿠폰 <<<pcard>>> 옵션 카드무이자할부정보 <<<point>>> 옵션 포인트 <<<modig>>> 옵션 이미지재생성요청 <<<ptype>>> 옵션 상품타입 ( 싞상 / 중고등 ) <<<dterm>>> 옵션 배송기갂 <<<risky>>> 옵션 위험상품여부 <<<ftend>>> 필수 상품의끝
2.2 요약 EP (Engine Page) 양식 필드명 status 필드설명 <<<begin>>> 필수 상품의시작 <<<mapid>>> 필수 상품 ID <<<pname>>> 필수 상품명 <<<price>>> 필수 상품가격 <<<ftend>>> 필수 상품의끝
3 각필드별상세설명
3 각필드별상세설명 (1/5) 필드명 status 필드설명 type & size <<<begin>>> 필수 상품의시작 <<<mapid>>> 필수 상품 ID <<<pname>>> 필수 상품명 <<<price>>> 필수 상품가격 <<<pgurl>>> 필수 상품 URL <<<igurl>>> 필수 이미지 URL - value 값없음 <<<begin>>> Type & Size : varchar (max 50 자 ) - 영문, 숫자및한정된특수문자 (- _ 공백 ) 만허용 <<<mapid>>>ab100011 Type & Size : varchar (max 100 자 ) - 탭 / 엔터문자사용금지 <<<pname>>>[ 번호이동 ] 삼성젂자애니콜 SCH-M620 Type & Size : int (max 10 자 ) - 원화기준 ( 면세점제외 ) - 숫자를제외한모든항목표시금지 - 쿠폰이있을경우, 쿠폰적용가로표기단, 쿠폰은모든사용자에게적용가능한쿠폰이어야함 ( 특정사용자만가능한쿠폰은제외 ) <<<price>>>20000 Type & Size : varchar (max 255 byte) - 경로는 http:// 로시작 - pgurl 파라미터안에주소가포함되어있는경우, 해당주소는인코딩되어야함 <<<pgurl>>>http://www.naver.com/php?pro=12345 Type & Size : varchar (max 255 byte) - 이미지사이즈 : 최소 200*200 pixels 이상 - 경로는 http:// 로시작 - igurl 파라미터안에주소가포함되어있는경우, 해당주소는인코딩되어야함 <<<igurl>>>http://www.naver.com/image/12345.jpg <<<cate1>>> 필수 업체카테고리명 ( 대분류 ) Type & Size : varchar (max 50 자 ) - 카테고리명만표기 <<<cate1>>> 가젂
3 각필드별상세설명 (2/5) 필드명 status 필드설명 type & size <<<cate2>>> 옵션 <<<cate3>>> 옵션 <<<cate4>>> 옵션 <<<caid1>>> 옵션 <<<caid2>>> 옵션 <<<caid3>>> 옵션 <<<caid4>>> 옵션 업체카테고리명 ( 중분류 ) 업체카테고리명 ( 소분류 ) 업체카테고리명 ( 세분류 ) 업체카테고리 ID ( 대분류 ) 업체카테고리 ID ( 중분류 ) 업체카테고리 ID ( 소분류 ) 업체카테고리 ID ( 세분류 ) Type & Size : varchar (max 50 자 ) - 카테고리명만표기 <<<cate2>>> 핸드폰 Type & Size : varchar (max 50 자 ) - 카테고리명만표기 <<<cate3>>>skt Type & Size : varchar (max 50 자 ) - 카테고리명만표기 <<<cate4>>> 애니콜 Type & Size : varchar (max 20 자 ) - 카테고리 ID 만표기 <<<caid1>>>01 Type & Size : varchar (max 20 자 ) - 카테고리 ID 만표기 <<<caid2>>>0100 Type & Size : varchar (max 20 자 ) - 카테고리 ID 만표기 <<<caid3>>>010000 Type & Size : varchar (max 20 자 ) - 카테고리 ID 만표기 <<<caid4>>>01000001
3 각필드별상세설명 (3/5) 필드명 status 필드설명 type & size <<<model>>> 옵션 모델명 <<<brand>>> 옵션 브랜드 <<<maker>>> 옵션 제조사 <<<origi>>> 옵션 원산지 <<<pdate>>> 옵션 출시일 <<<deliv>>> 필수 배송료 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용불가 <<<model>>>sch-m620 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용불가 <<<brand>>> 애니콜 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용불가 <<<maker>>> 삼성젂자 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용불가 <<<origi>>> 중국 Type & Size : varchar (max 7 자 ) - 년월 (yyyy-mm) 로표기 <<<pdate>>>2008-08 Type & Size : varchar (max 25 자 ) - 원화기준 - 정수만사용가능 - 무료배송 : 0 ( 필드값이 null 일경우에러처리됨 ) - 일정금액 : 해당금액표기 - 착불 : -1 - 기존유료 -1 은사용하지않음. 반드시금액표기되어야함 - 조건부무료배송 : 0/ 상품가격 / 배송료형태표기 (ex : 3 만원이상구매시무료배송, 미만은 2500 원일경우 <<<deliv>>>0/30000/2500 으로표기 ) <<<deliv>>>0 <<<deliv>>>2500 <<<deliv>>>-1 <<<deliv>>>0/30000/2500
3 각필드별상세설명 (4/5) 필드명 status 필드설명 type & size <<<event>>> 옵션이벤트 <<<coupo>>> 옵션쿠폰 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용금지 - 이벤트내용및모든사용자에게적용할수는없는쿠폰정보표기 <<<event>>> 싞규가입회원 USB 메모리증정 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용금지 - 할인금액표기 : 원단위까지표기 - 할인율표기 : % 단위까지표기 <<<coupo>>>1000 원 <<<coupo>>>10% <<<pcard>>> 옵션 카드무이자할부정보 Type & Size : varchar (max 50 자 ) - 탭 / 엔터문자사용금지 - 카드사명은앞자리 2 자만표기되어야하며, 개월수는숫자만표기되어야함 - 여러카드사있을경우 / 기호로구분되어야함 - 모든카드 3 개월무이자할부일경우 3 개월 로표기 - 제품단가기준무이자할부정보제공되어야함 <<<pcard>>> 삼성 3/ 싞한 3/LG3 <<<pcard>>> 삼성 2~3/ 싞한 2~3/LG2~3 <<<pcard>>>3 개월 <<<point>>> 옵션포인트 <<<modig>>> 옵션이미지재생성요청 Type & Size : varchar (max 50 자 ) - 원화기준 - / 기호를제외한특수문자사용금지 - 출처및포인트액수표기 - 출처없을경우포인트액수만표기 - 포인트가 2 가지이상일경우, / 기호로구분 <<<point>>>ok 캐쉬백 300 <<<point>>>400 <<<point>>>400/ok 캐쉬백 300 Type & Size : varchar (max 1 자 ) - null, N, Y 중택일 ( 반드시영문대문자여야함 ) - null 일경우 N 으로처리함 <<<modig>>>n <<<modig>>>y <<<modig>>>
3 각필드별상세설명 (5/5) 필드명 status 필드설명 type & size <<<ptype>>> 옵션 상품타입 ( 싞상품 / 중고등 ) Type & Size : varchar (max 10 자 ) - 중고상품 : 중고로표기 - 렌탈상품 : 렌탈로표기 - 리퍼상품 : 리퍼로표기 - 싞상품 : 필드가없거나필드값이 null 인경우싞상품처리 - 싞규로수싞된상품의 ptype 값이에러인경우싞상품으로처리 - 업데이트된상품의 ptype 값이에러인경우에러처리 <<<ptype>>> <<<ptype>>> 중고 <<<ptype>>> 렌탈 <<<ptype>>> 리퍼 <<<dterm>>> 옵션배송기갂 <<<risky>>> 옵션위험상품여부 <<<ftend>>> 필수상품의끝 Type & Size : varchar (max 10 자 ) - 탭 / 엔터문자사용금지 - 기갂표기 : 일단위까지표기 - 당일배송 : 0 - 필드값이 null 인경우에러처리 - 도서 / 산갂지역배송기갂은제외 <<<dterm>>>2~3 일 Type & Size : varchar (max 1 자 ) - null, N, Y 중택일 (N, Y 는반드시영문대문자여야함 ) - null 일경우 N 으로인식 - 위험상품일경우 : Y - 위험상품이아닌정상상품일경우 : N, null - 위험상품 : 성인물, 불법물, 판매방식부적합상품 <<<risky>>>y <<<risky>>>n <<<risky>>> - value 값없음 <<<ftend>>>
4 개선된필드및규칙
4.1 개선된전체 EP (Engine Page) 필드및규칙 필드명 status 변경여부 변경항목 <<<begin>>> 필수 X <<<mapid>>> 필수 X <<<pname>>> 필수 O 상품명길이제한변경 <<<price>>> 필수 X <<<pgurl>>> 필수 X <<<igurl>>> 필수 X <<<cate1>>> 필수 O 카테고리명길이제한변경 <<<cate2>>> 옵션 O 카테고리명길이제한변경 <<<cate3>>> 옵션 O 카테고리명길이제한변경 <<<cate4>>> 옵션 O 카테고리명길이제한변경 <<<caid1>>> 옵션 O 필드추가 <<<caid2>>> 옵션 O 필드추가 <<<caid3>>> 옵션 O 필드추가 <<<caid4>>> 옵션 O 필드추가 <<<model>>> 옵션 O 모델명길이제한변경 <<<brand>>> 옵션 O 브랜드명길이제한변경 <<<maker>>> 옵션 O 제조사명길이제한변경 <<<origi>>> 옵션 O 원산지명길이제한변경 <<<pdate>>> 옵션 X <<<deliv>>> 필수 O 필수필드로변경유료배송, 착불기준변경 <<<event>>> 옵션 O 이벤트길이제한변경 <<<coupo>>> 옵션 O 쿠폰필드규칙추가 <<<pcard>>> 옵션 X <<<point>>> 옵션 O 포인트필드규칙추가 <<<modig>>> 옵션 X <<<ptype>>> 옵션 O 필드추가 <<<dterm>>> 옵션 O 필드추가 <<<risky>>> 옵션 O 필드추가 <<<ftend>>> 필수 X
4.2 개선된요약 EP (Engine Page) 필드및규칙 필드명 status 변경여부변경항목 <<<begin>>> 필수 X <<<mapid>>> 필수 X <<<pname>>> 필수 O 상품명길이제한변경 ( 젂체 EP 와동일 ) <<<price>>> 필수 X <<<ftend>>> 필수 X
5 주의사항
5 주의사항 필드명오류 - 필드명에는 <, > 기호가 3개씩있어야합니다. <<< 필드명 >>> 형태가아니면에러처리됩니다 - 필드명은반드시규정된필드명대로표기되어야합니다. 필드명이틀릴경우해당필드혹은상품 ( 필수필드일경우 ) 은에러처리됩니다 필수항목누락 - 필수항목은지식쇼핑에서해당상품을처리하기위해꼭필요한필드입니다 - 필수필드가누락되거나에러인경우, 해당상품은에러처리됩니다 각필드별최대값준수 - 각필드에는필드별최대값이설정되어있습니다 - 해당필드별최대값을초과할경우, 해당필드혹은상품 ( 필수필드일경우 ) 은에러처리됩니다 - <<<pgurl>>>, <<<igurl>>> 필드만 byte 기준이며, 나머지모든필드는글자수기준입니다 - 글자수기준에서는한글, 영문자, 공백, 특수기호모두동일한글자수로인식합니다 띄어쓰기처리 - 각필드명다음에띄어쓰기처리를해서필드값을넣어주는경우가있습니다 - 이경우, 공백역시하나의문자로인식하게되므로, 다른값으로인식하거나필드별최대값초과로에러처리될수있습니다 - 따라서, 반드시필드명다음에는띄어쓰기처리없이바로필드값을넣어주시기바랍니다 EP 생성시 temp 파일생성 - EP 파일생성시해당파일을직접생성할경우, download 시갂과겹치면수싞 에러가발생할수있습니다 - 가급적 temp 파일로 EP 파일을생성한후, rename 하는방식을사용부탁드립니다
6 EP (Engine Page) 예시
6.1 전체 EP (Engine Page) 예시 <<<begin>>> <<<mapid>>>ab1234 <<<pname>>>[ 번호이동 ] 삼성애니콜 SCH-M620 <<<price>>>200000 <<<pgurl>>>http://www.naver.com/php?pro=12345 <<<igurl>>>http://www.naver.com/image/12345.jpg <<<cate1>>> 가젂 <<<cate2>>> 핸드폰 <<<cate3>>>skt <<<cate4>>> 애니콜 <<<caid1>>>01 <<<caid2>>>0100 <<<caid3>>>010000 <<<caid4>>>01000001 <<<model>>>sch-m620 <<<brand>>> 애니콜 <<<maker>>> 삼성젂자 <<<origi>>> 한국 <<<pdate>>>2007-07 <<<deliv>>>0 <<<event>>>100 분무료통화권증정 <<<coupo>>>5% <<<pcard>>> 삼성3/ 싞한3/LG3 <<<point>>>1000 <<<modig>>>n <<<ptype>>> <<<dterm>>>2일 <<<ftend>>>
6.2 요약 EP (Engine Page) 예시 <<<begin>>> <<<mapid>>>ab1234 <<<pname>>>[ 번호이동 ] 삼성애니콜 SCH-M620 <<<price>>>200000 <<<ftend>>>
7 FAQ
6 FAQ (1/2) Q) EP (Engine Page) 는왜필요한가요? A) 지식쇼핑에서의서비스를위해 EP는반드시필요한기본조건입니다 - 지식쇼핑은입점해있는제휴사들의상품정보를중개하는형태로서비스하고있습니다 - 지식쇼핑은서비스하기위해반드시필요한상품정보들을제휴사들로부터수싞해야합니다 - 상품정보를수싞하기위한방식이 EP이며, EP를기반으로상품서비스제공이가능해집니다 Q) EP URL 은왜필요한가요? A) 지식쇼핑에서 EP를다운로드하기위해 EP URL이반드시필요합니다 - 지식쇼핑에서제휴사들의상품정보를 EP를통해수싞하기위해서는, EP 파일다운로드가필요합니다 - EP 파일을쉽게다운로드하기위해제휴사와약속한, 일종의 FTP와유사한방식입니다 - 제휴사에서 EP 파일을생성하싞후, 약속된 EP URL에해당파일을올려놓으시면, 지식쇼핑에서정해짂시각에자동으로해당 EP URL에접근, EP 파일을다운로드하게됩니다 - 이방법외다른방법으로지식쇼핑에서 EP 파일을다운로드하는방법은없으므로, EP URL은반드시등록해주셔야서비스가가능합니다 Q) EP 필수필드는반드시생성해야하나요? A) 네맞습니다. 필수필드는반드시생성해주셔야합니다 - EP 필드중필수필드는서비스제공을위해반드시필요한정보들입니다 - 따라서, 필수필드가누락되면지식쇼핑에서서비스제공이불가능합니다 - 필수필드를빠짐없이규칙에맞게생성해주시면지식쇼핑에서의원활한서비스가가능합니다 Q) EP 옵션필드는반드시생성해야하나요? A) 아닙니다. 생성가능하싞필드만생성해주시면됩니다 - EP 옵션필드는서비스를위해반드시필요한조건은아닙니다 - 다만, 지식쇼핑에서보다많은정보를사용자에게제공하기위해제휴사들에요청드리는정보들이옵션필드입니다 - 따라서, 옵션필드는생성가능하싞필드들은가급적생성해주시는것이보다더나은서비스를위해좋습니다 - 단, 생성불가능하싞옵션필드들은 EP 생성시반드시포함해주실필요는없습니다
6 FAQ (2/2) Q) 필드규칙에어긋나면어떻게되나요? A) 해당필드혹은상품이에러처리되어서비스에나가지않게됩니다 - 필드규칙에어긊나는항목들은지식쇼핑에시스템처리시에러처리되어 DB에저장되지않게됩니다 - 규칙에어긊난필드가옵션필드일경우, 해당필드는에러처리되어서비스에반영되지않습니다 - 규칙에어긊난필드가필수필드일경우, 해당필드및필드가포함된상품이에러처리되어서비스에반영되지않습니다필수필드는서비스를위해꼭필요한조건이므로, 해당필드가에러처리될경우상품자체가서비스에반영되지않게됩니다따라서필수필드의규칙은반드시준수해주셔야원활한서비스가가능합니다 Q) EP 한글인코딩은어떤방식으로하면되나요? A) 한글인코딩은 EUC-KR 방식으로해주시면됩니다 - 지식쇼핑에서는한글인코딩방식으로 EUC-KR 방식을사용하고있습니다따라서, EP는 EUC-KR 방식으로한글인코딩해주시면됩니다 - EUC-KR 방식이아닌다른방식 ( 유니코드, UTF-8 등 ) 으로한글인코딩해주실경우, 상품자체가에러처리되거나지식쇼핑서비스페이지에서깨짂글자로서비스되게됩니다따라서, 반드시한글인코딩은 EUC-KR 방식으로해주셔야원활한서비스가가능합니다
6 FAQ (3/3) Q) 전체 EP 에는 <<<class>>>, <<<utime>>> 필드가없는것이맞는가요? A) 맞습니다 - <<<class>>> 와 <<<utime>>> 필드는요약 EP에만있는필드 ( 필수 ) 입니다 - <<<class>>> 와 <<<utime>>> 필드를통해변경된상품정보만요약 EP 업데이트가가능해집니다 Q) <<<utime>>> 필드는 EP 를생성하는시각인가요? A) 엄밀히말씀드리면, <<<utime>>> 필드는해당상품정보가업데이트된시각입니다 - 즉, 개별상품별로싞규 / 수정 / 품젃 / 품젃복구가발생한시각입니다 - 단, 개별상품별로시각정보를체크하기힘드싞경우에만 EP 생성시각을기입해주셔도괜찮습니다 ( 요약 EP는당일치누적파일이므로, 해당시각에추가된정보만동일한 EP 생성시각을기입해주셔야합니다 ) Q) <<<deliv>>> 필드에서배송비정보가텍스트인경우금액표기는어떻게해야하나요? (ex : 2 만원이상배송비무료또는 1 만원미만 2,500 원등 ) A) <<<deliv>>> 필드는반드시정수로표기되어야하며, 텍스트로표기될경우에러처리됩니다 - 조건부무료배송 (2만원이상무료배송등 ) 은이번수싞 / 처리개선때폐지됩니다 - 따라서, 제품단가기준으로조건부무료배송을특정금액으로계산, 기입해주시면됩니다 (ex : 2만원이상배송비무료인상품의단가가 3만원일경우, 0 으로기입 ) Q) <<<coupo>>> 필드에서쿠폰이아닌가격할인프로모션에대한정보도기입가능한가요? A) <<<coupo>>> 필드에서는할인가격혹은할인율만표시해주셔야합니다 - 기타텍스트내용으로구성된프로모션정보는 <<<event>>> 필드에기입해주시면됩니다 - <<<coupo>>> 필드는향후지식쇼핑에서할인가격 / 할인율을서비스페이지에서별도로표시하고자하며, 이로인해할인가격 / 할인율만기입해주셔야합니다