SuitsDocs
레퍼런스노드 레퍼런스액션액션연동연동

Qoo10

Qoo10 QSM API를 통한 주문, 상품, 재고, 배송, CS를 관리합니다.

개요

항목내용
카테고리연동
연동 필요Qoo10 API Key
지원 리소스주문, 상품, 재고, 배송, 문의/CS, 공통 정보
지원 리전일본, 싱가포르, 인도네시아, 말레이시아, 홍콩

작업 종류

주문

작업설명
주문 목록 조회주문 상태, 기간으로 필터링하여 목록 조회
주문 상세 조회주문번호(PackNo/OrderNo)로 상세 조회
주문 확인 처리주문 확인 완료 처리
주문 취소주문 취소 (사유 입력)
환불 처리환불 처리 (사유 입력)

상품

작업설명
상품 목록 조회상품 상태별 목록 조회
상품 상세 조회판매자 상품코드 또는 Qoo10 상품코드로 조회
상품 등록새 상품 등록 (상품명, 가격, 카테고리, 옵션 등)
상품 수정기존 상품 정보 수정
가격/재고 수정상품 가격 및 재고 수량 변경
판매 상태 변경판매중/판매대기/판매중지/품절 상태 변경

재고

작업설명
재고 조회판매자 상품코드로 재고 조회 (옵션별 가능)
재고 수정재고 수량 변경 (옵션별 가능)

배송

작업설명
송장번호 등록묶음 배송번호에 택배사와 송장번호 등록
송장번호 수정기존 등록된 송장번호 변경
택배사 목록 조회사용 가능한 택배사 목록 조회

문의/CS

작업설명
Q&A 목록 조회고객 문의(Q&A) 목록 조회
Q&A 답변 등록고객 문의에 답변 등록
클레임 목록 조회취소/반품/교환 클레임 목록 조회

공통 정보

작업설명
카테고리 목록 조회Qoo10 카테고리 트리 조회
배송 그룹 조회등록된 배송비 설정 그룹 조회

주요 택배사 코드

코드택배사
CJGLSCJ대한통운
LOTTE롯데택배
HANJIN한진택배
LOGEN로젠택배
EPOST우체국택배
YAMATOYamato (일본)
SAGAWASagawa (일본)
JPPOSTJapan Post
SINGPOSTSingPost (싱가포르)
NINJAVANNinja Van
JNTJ&T Express

활용 예시

주문 자동 확인

트리거: 일정 (매 10분)
액션 1: Qoo10 - 주문 목록 조회 (신규주문)
액션 2: 반복 (신규 주문)
액션 3: Qoo10 - 주문 확인 처리
├── 주문번호: {{loop.current.orderId}}
└── 메모: "자동 확인 처리"

송장 자동 입력

트리거: 웹훅 (물류 시스템 출고 완료)
액션: Qoo10 - 송장번호 등록
├── 묶음 배송번호: {{trigger.body.packNo}}
├── 택배사: CJGLS
└── 송장번호: {{trigger.body.trackingNo}}

고객 문의 알림

트리거: 일정 (매 30분)
액션 1: Qoo10 - Q&A 목록 조회 (미답변)
액션 2: 반복 (미답변 문의)
액션 3: 슬랙 메시지
└── 메시지: "미답변 Qoo10 문의: {{loop.current.question}}"

모범 사례

Qoo10 API Key는 판매자 센터에서 담당 매니저에게 문의하여 발급받을 수 있습니다. 리전(일본, 싱가포르 등)에 따라 API 엔드포인트가 다르므로 리전 설정에 유의하세요.

에러 처리

API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요.