SuitsDocs
레퍼런스노드 레퍼런스액션액션국내 비즈니스국내 비즈니스

쿠팡 로켓그로스

쿠팡 로켓그로스 API를 통한 상품, 주문, 송장/배송, 취소/교환, 재고, 정산, 입고, 반품, 매출 리포트를 관리합니다.

개요

항목내용
카테고리국내 비즈니스
연동 필요쿠팡 로켓그로스 API 인증 (Wing 플랫폼에서 API Key 발급)
지원 리소스상품, 주문, 송장/배송, 취소/교환, 재고, 정산, 입고, 반품, 매출 리포트

작업 종류

상품

작업설명
상품 목록 조회등록된 상품 목록 조회
상품 상세 조회특정 상품의 상세 정보
상품 등록신규 상품 등록
상품 수정기존 상품 정보 수정
상품 삭제상품 삭제
상품 상태 변경판매중/품절/판매중지 상태 변경
상품 옵션 조회상품의 옵션(variants) 조회

주문

작업설명
주문 목록 조회조건에 맞는 주문 목록
주문 상세 조회특정 주문의 상세 정보
주문 수 조회조건에 맞는 주문 건수
주문 품목 조회특정 주문의 품목 정보

송장/배송

작업설명
송장 업로드 (발송처리)택배사/송장번호 등록 및 발송 처리
송장 수정등록된 송장 정보 수정
배송 상태 변경 이력 조회배송 상태 변경 이력 확인
배송완료 처리배송 완료 처리

취소/교환

작업설명
반품/취소 요청 목록 조회반품/취소 요청 목록
주문 취소 처리주문 취소 실행
교환 요청 목록 조회교환 요청 목록
교환 거부교환 요청 거부
교환 송장 업로드교환 재배송 송장 등록

재고

작업설명
재고 목록 조회재고 목록
재고 상세 조회특정 상품의 재고 정보
상품별 재고/가격/상태 조회아이템 단위의 재고, 가격, 상태 조회

정산

작업설명
정산 목록 조회정산 내역 목록
정산 상세 조회특정 정산 정보
정산 상세 내역정산 항목별 상세 내역

입고

작업설명
입고 목록 조회입고 내역 목록
입고 상세 조회특정 입고 정보
입고 요청 생성신규 입고 요청
입고 취소입고 요청 취소

반품

작업설명
반품 목록 조회반품 내역 목록
반품 상세 조회특정 반품 정보
반품 승인반품 요청 승인
반품 거부반품 요청 거부

매출 리포트

작업설명
매출 내역 조회기간별 매출 내역
상품별 판매 통계상품 단위 판매 통계

택배사 코드

코드택배사
CJGLSCJ대한통운
HANJIN한진택배
LOTTE롯데택배
LOGEN로젠택배
EPOST우체국택배
KDEXP경동택배
DAESIN대신택배
ILYANG일양로지스
KUNYOUNG건영택배
CHUNIL천일택배
HDEXP합동택배
CVSNETCVS편의점택배
GTXGTX로지스
ETC기타

주문 상태

상태설명
ACCEPT접수
INSTRUCT출고지시
DEPARTURE출고
DELIVERING배송중
FINAL_DELIVERY배송완료
CANCELED취소

출력 데이터

// 상품 조회
{{actions.coupangRocketGrowth.products}}
{{actions.coupangRocketGrowth.products[0].productId}}

// 주문 조회
{{actions.coupangRocketGrowth.orders}}
{{actions.coupangRocketGrowth.orders[0].orderId}}

// 송장 업로드
{{actions.coupangRocketGrowth.success}}

활용 예시

송장 자동 업로드

트리거: 물류 시스템 웹훅 (송장 생성)
액션: 쿠팡 로켓그로스 - 송장 업로드
├── 배송박스 ID: {{trigger.body.shipmentBoxId}}
├── 주문 ID: {{trigger.body.orderId}}
├── 택배사: "CJGLS"
└── 송장번호: {{trigger.body.invoiceNumber}}

재고 부족 알림

트리거: 일정 (매시간)
액션 1: 쿠팡 로켓그로스 - 재고 목록 조회
액션 2: 필터 (재고 < 10)
액션 3: 슬랙 메시지
└── 메시지: "쿠팡 로켓그로스 재고 부족: {{loop.current.productName}}"

정산 데이터 수집

트리거: 일정 (매일 오전 10시)
액션 1: 쿠팡 로켓그로스 - 정산 목록 조회
├── 시작일: {{$today.minus(1, 'day')}}
└── 종료일: {{$today}}
액션 2: 데이터모델 행 추가
└── 정산 데이터 저장

모범 사례

쿠팡 로켓그로스 API는 페이지당 최대 500건까지 조회 가능합니다. 대량 데이터 처리 시 페이지네이션을 활용하세요.

에러 처리

API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요. 특히 송장 업로드 실패는 배송 지연으로 이어질 수 있으므로 즉시 처리가 필요합니다.