라자다글로벌쉬핑솔루션
개요 1. LGS IT 시스템을통한 API 셋업가이드 - LGS 시스템셋업개요 - 주문 API 와 API 콜 2. 배송라벨기입내용과규정 3. 참고내용 - 주문프로세스 - 용어정리 : 주문상태별용어정리 - API 참고가이드 2
API 를통한 LGS 주문관리셋업가이드개요 LGS IT 셋업과정에서변경사항이있습니다. 변경사항은, 배송번호는라자다셀러센터를통해자동으로생성되는점입니다. 선택된 3PL 에따라, 자동으로기입되기때문에셀러가직접입력하지않습니다. With 이용중인셋업시스템 With 새로운 LGS 시스템셋업방식 셀러센터에서 - 주문번호 - 그외주문정보직접생성 Seller Center (SC) 셀러 ERP 배송라벨출력 Seller Center (SC) 셀러센터에서 - 주문번호 - 배송번호 - 패키지넘버 - 그외주문정보직접생성 셀러자체시스템에서추출하여배송번호생성 셀러 ERP 배송라벨출력 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 3
API 를통한 LGS 주문관리셋업가이드셀러센터주문관리 APIs LGS 의 API 를통한주문관리프로세스 API 콜 목적 GetMultipleOrderItems SetStatusToReadyToShip GetOrder - 다수의주문번호정보취득 - 상태를 RTS 로셋팅 - 배송번호변수를공란으로남기고배송번호가자동생성되도록셋팅 - 해당주문번호의주문정보를추출 & 취득 1. 주문상태 Ready To Ship 으로변경 & Tracking Numbers ( 배송번호 ) 획득. Use API call setstatustoreadytoship API 콜을사용하여배송번호가자동으로패키지에입력될수있게셋팅. 추가로 TrackingNumber 필드값을생성할필요없음. 2. 주문정보받기. 해당주문건의주문정보를받기위해서는, getmultipleorderitems API 콜사용. 본기능을통해필수주문정보제공 (<TrackingCode> - 배송번호 ; <OrderNumber> - 주문번호 ; <PackageID> - 패키지넘버포함 ) 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 4
API 를통한 LGS 주문관리셋업가이드셀러센터주문관리 APIs 주문 API 주문처리 API 셀러어카운트를통해처리할수있는주요주문관리 API API 콜 사용목적 적용가능한전제주문상태 셀러 이용여부 SetStatusToCanceled - 주문취소 Pending YES SetStatusToReadytoShip - 해당배송사에맞게주문상태 Ready to ship (Ready to be picked) 으로업데이트 SetStatusToShipped - 해당배송사 ( 로컬배송사 ) 에서수취가완료되면 주문상태업데이트 SetStatusToDelivered - 배송사에서고객에게배송완료된이후주문상태 업데이트 SetStatusToDelivered - 배송사에서고객에게성공적으로배송되지않을때 주문상태업데이트 Pending Ready to Ship Shipped Shipped YES NO NO YES GetShipmentProviders - 해당셀러에게발생한반품, 배송실패건이발생할때어떤상태에서도이용가능 YES GetDocument - 전환가능한인보이스혹은배송라벨 64 코드를받을 때 본 API 콜은아래와같은주문상태에서이용가능 : (i) Pending (Invoice only + shipping label). (ii) Ready to Ship ( 인보이스와배송라벨 ). (iii) Shipped ( 인보이스와배송라벨 ) > once picked by 3PL. (iv) Delivered ( 인보이스만가능 ). (v) Failed Delivery ( 인보이스만가능 ). YES GetFailureReasons - SetStatusToCanceled API Call 를위해취소이유 리스트를받을때 - 어떤상태에서도이용가능 (Not Order Specific) YES 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 5
개요 1. LGS IT 시스템을통한 API 셋업가이드 - LGS 시스템셋업개요 - 주문 API 와 API 콜 2. 배송라벨기입내용과규정 3. 참고내용 - 주문프로세스 - 용어정리 : 주문상태별용어정리 - API 참고가이드 6
배송라벨기입내용및규정라벨형식 배송번호고객병 & 국가 셀러정보 상품정보 물류센터주소 배송첫단계이용라벨포맷은모두동일 ( 통합포맷 ) 셀러센터 LGS 코드 : LGS-FM40: 중국, ShenZhen LGS-FM41: 중국, Yiwu LGS-FM42: 중국, 홍콩 LGS-FM43: 한국, 서울 라벨분류코드 : (LZD + 국가명코드 ) LZDMY LZDSG LZDID LZDTH LZDPH LZDVN 배송번호앞부분은 LZD 로시작 배송번호뒷부분은 국가코드 분류코드 패키지넘버 배송라벨추가규정 : 권장 : 10cmx15cm (2:3 비율 ) 바코드 : 128 7
배송라벨기입내용및규정관련가이드파일 본파일은다음내용이포함되어있습니다 : - HTML 가이드 * - 3PL 로고를이미지소스 * HTML 가이드는일반적인이용템플릿만제공하고있습니다. 변수, 변수에맞는해당링크와바코드는개별셀러에맞추어업데이트됩니다. 8
배송라벨기입내용및규정라벨이 LGS 규정에맞게호환되는지여부확인하는방법 LGS 라벨로적합하다고판단하는기준 LGS 쉬핑하기전기억해주세요! 배송라벨이 10x15 보다큰사이즈유지 10x15cm(2:3 비율 ) 바코드는충분한넓이를갖고분리되서는안됩니다. 패키지넘버바코드최소 500px 넓이유지 프린트한라벨이샘플템플릿과일치하는지? (i) 정확한정보, (ii) 필수기재사항, (iii) 10x15 cm 사이즈를맞추고있나요? 라벨에적힌패키지넘버가 LGS 포맷을갖고있는지? 맞는규정 > MPDS-XXXXXXXXX-XXXX 으로기입되었나요? 검증된바코드이용. 특히스캔가능한바코드검증필수 패키지넘버와배송번호는셀러가직접입력한값이아닌, 라자다에서제공한값이어야합니다. 배송라벨에판매자셀러명이기입되어있나요? 라벨에상품가격이기입된경우, 가격이현지화폐단위로기입되어있나요? 가장중요한부분인해당라벨이스캔가능한지테스트 & 승인이완료되었나요? 9
배송라벨기입내용및규정 라벨이 LGS 규정에맞게호환되는지여부확인하는방법 트랙킹넘버 & 바코드 배송정보기입란 : - 고객주소 - 고객연락처 - 배송정보 - 상품상세설명 - 상품가격 패키지넘버 10
개요 1. LGS IT 시스템을통한 API 셋업가이드 - LGS 시스템셋업개요 - 주문 API 와 API 콜 2. 배송라벨기입내용과규정 3. 참고내용 - 주문프로세스 - 용어정리 : 주문상태별용어정리 - API 참고가이드 11
셀러센터인터페이즈 & 시스템처리과정주문처리과정 1 2 3 Pending 탭에서주문생성정보확인 클릭 : ready to ship LGS 코트선택란 클릭 : create package 인보이스넘버기입 4 5 인보이스출력 클릭 : Save invoice ID RTS 탭으로이동 배송라벨출력 12
셀러센터인터페이즈 & 시스템처리과정용어정의 : 주문상태용어정리 주문상태의미 Business Implication 상황 / 예시 A) Pending # 라자다부서를통해주문정보가승인완료되었지만셀러를통해처리되지않은주문 # 본상태의주문건은해당상품의입력재고량에맞게처리됨 B) Cancelled # 주문취소완료 : 셀러혹은라자다고객부서팀처리포함. # 일반적으로본상태는택배발송전에처리됨 # 주문처리가불가능하여불가피하게주문취소를해야할경우 # 판매자의주문처리가규정시간을초과하여해당부서에서주문취소처리할경우 # 배송처리전고객이주문취소요청을한경우 C) Ready to Ship # 해당배송사를통해픽업될재고확보된모든주문건 # 해당상품을포장하여인보이스, 배송라벨을출력하여부착 & 배송하는단계. # 본단계에서선택한배송사에따라배송번호가자동생성됨 # 배송번호가시스템으로자동기입되었다면, 셀러가개별적으로입력할필요없음 # 그렇지않다면셀러는확인규정에맞추어반드시직접업데이트해야함. ( 배송사규정에따라다름 예 ) RegEx validation -> tracking number.) * 한국셀러의경우해당사항없음 D) Shipped # 해당국가로배송이완료된모든주문건 # 실제로해당국가의 LGS 파트너배송사로도착한 패키지에해당 E) Delivered # 고객에게배송이완료된모든주문건 # 본상태는라자다에서직접업데이트함 F) Failed (Delivery Failed) # 고객에게도착하지못하고배송실패되어셀러에게반송되는모든주문건 ( 반송여부는셀러재량 ). # 본상태는라자다에서정확한주문상태확인후직접업데이트함 ( 정확안상태표기 ) # 고객에게재배송시도이후배송사에서셀러에게반송처리. 본택배는셀러에게반송처리되며라자다에서해당배송사를통해업데이트받는대로업데이트 G) Returned # 고객에게반품요청후, 라자다에서반품요청승인된주문건에만해당 # Returned 으로기록되면라자다에서셀러에게해당상품처리와관련하여업데이트 13
참고내용 API 연동 API 가이드 상품등록혹은정보수정시올바른 API 콜을입력할수있도록돕기위해 API 가이드탭을마렸하였습니다. 탭을통해필수입력정보 ( 예. 각카테고리별 API 콜완성본확인 ) 1 1 로그인후본페이지에접속하여아래와같은순서로보시기바랍니다 : 셀러센터에접속하여 Name - API Reference 클릭 2 3 2 3 Product API Examples 탭을통해각하위카테고리별필수입력해야하는값리스트를확인할수있습니다. 본정보는 GetCategoryAttributes API 콜을통해서도확인할수있습니다. 화살표아이콘을클릭하여각카테고리별최소기입혹은완전한 API 콜을확인할수있습니다. 참고 : 본페이지는상품을등록 / 업데이트할때유용하게사용할수있습니다. 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 14
참고내용 API 연동 API Explorer (Front End) 본칼럼에서 28 개의선택가능콜중하나를선택 ( 본탭을통해테스트만가능합니다.) 요청 URL Body. 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 15
참고내용 API 연동 API Explorer API Product Call 예시를추가하기위해, API Explorer 을통해 36 개의이용가능한 API 콜을테스트해볼수있습니다. 테스트를위해셀러센터에로그인하시고아래단계를확인하세요 : 1. 셀러센터접속후셀러명클릭 - API Reference 2. API Explorer 탭클릭. 선택한 API API 콜콜을테스트하기위해서는관련정보를입력해야합니다. 각텍스트의간략한용어정의사용목적입니다. API Host - API 호스트서버입니다. 전형적인포맷은 api.sellercenter.local 입니다. local 은 api 를적용하는해당국가를의미합니다. 예 ) 태국, 필리핀의경우 : api.sellercenter.lazada.co.th, api.sellercenter.lazada.co.ph 등 User ID - 셀러 API Access User 이메일주소입니다. API Key - 셀러 API 엑세스로지정된 API 키입니다. Action - 본탭을통해모두 28개의 API 콜을사용합니다. 콜을선택하면요청 URL 제목이생성됩니다. Request URL - URL 주소를확인하는칼럼입니다. CreateProduct 같은콜은최소한의필수기재값이미리입력되어있습니다. 필요한경우추가로입력할수있씁니다. Execute - Request URL 텍스트필드에기입t Regenerate Signature Update Request URL - 유일한사용자시그니쳐재생성 - 상품정보를변경할경우요청 URL 업데이트. - 페이지하단은응답텍스트필드로 API 콜요청에대한응답을확인할수있습니다. 요청이성공적으로제출되었는지 / 실패했는지보여줍니다. 참고 : 더자세한사항은, https://sellercenter.readme.io/ 페이지 Seller Center 시스템개발가이드를참고하세요. 16
감사합니다!