레퍼런스노드 레퍼런스액션액션국내 비즈니스국내 비즈니스 카카오선물하기
카카오쇼핑 API를 통한 선물하기/톡스토어 상품, 주문, 문의, 카테고리, 브랜드, 선물 발송, 정산을 관리합니다.
| 항목 | 내용 |
|---|
| 카테고리 | 국내 비즈니스 |
| 연동 필요 | 카카오쇼핑 Open API 액세스 토큰 (카카오 디벨로퍼스 앱 등록 + 판매자센터 API 권한 신청) |
| 지원 리소스 | 상품, 주문, 문의, 카테고리, 브랜드, 선물 발송 (for Biz), 정산 |
| 작업 | 설명 |
|---|
| 상품 목록 조회 | 등록된 상품 목록 |
| 상품 상세 조회 | 특정 상품 정보 |
| 상품 등록 | 신규 상품 등록 |
| 상품 수정 | 기존 상품 정보 수정 |
| 판매 상태 변경 | 판매중/판매중지/품절 상태 변경 |
| 상품 이미지 조회 | 상품 이미지 목록 |
| 상품 이미지 수정 | 상품 이미지 업데이트 |
| 작업 | 설명 |
|---|
| 주문 목록 조회 | 조건에 맞는 주문 목록 |
| 주문 상세 조회 | 특정 주문의 상세 정보 |
| 주문 상태 변경 | 주문 상태 업데이트 |
| 주문 확인 처리 | 주문 접수 확인 |
| 송장 입력 | 택배사/송장번호 등록 |
| 송장 수정 | 등록된 송장 정보 수정 |
| 작업 | 설명 |
|---|
| 문의 목록 조회 | 고객 문의 목록 |
| 문의 상세 조회 | 특정 문의 상세 내용 |
| 문의 답변 등록 | 문의에 대한 답변 작성 |
| 작업 | 설명 |
|---|
| 카테고리 목록 조회 | 카테고리 목록 (뎁스 1~3) |
| 카테고리 상세 조회 | 특정 카테고리 정보 |
| 작업 | 설명 |
|---|
| 브랜드 목록 조회 | 등록된 브랜드 목록 |
| 브랜드 상세 조회 | 특정 브랜드 정보 |
| 작업 | 설명 |
|---|
| 선물 보내기 | 수신자에게 선물 발송 |
| 발송 내역 조회 | 선물 발송 이력 |
| 템플릿 목록 조회 | 사용 가능한 선물 템플릿 |
| 작업 | 설명 |
|---|
| 주문단위 정산 조회 | 주문 단위의 정산 내역 (기준일/확정일 기준) |
| 코드 | 택배사 |
|---|
CJ | CJ대한통운 |
POST | 우체국택배 |
HANJIN | 한진택배 |
LOGEN | 로젠택배 |
LOTTE | 롯데택배 |
KD | 경동택배 |
DAESIN | 대신택배 |
ILYANG | 일양로지스 |
CVS | CVS편의점택배 |
DHL | DHL |
FEDEX | FedEx |
UPS | UPS |
| 상태 | 설명 |
|---|
PAYMENT_COMPLETE | 결제완료 |
PREPARING_PRODUCT | 상품준비중 |
DELIVERING | 배송중 |
DELIVERY_COMPLETE | 배송완료 |
PURCHASE_CONFIRM | 구매확정 |
CANCEL | 취소 |
EXCHANGE | 교환 |
RETURN | 반품 |
모든 작업에 판매자 코드가 필수입니다. 카카오쇼핑 판매자센터에서 확인할 수 있습니다.
| 옵션 | 설명 |
|---|
| 기간 유형 | 정산 기준일 또는 정산 확정일 기준 |
| 채널 | 선물하기(1) 또는 톡스토어(101) |
// 상품 조회
{{actions.kakaoGift.products}}
{{actions.kakaoGift.products[0].productId}}
{{actions.kakaoGift.products[0].productName}}
// 주문 조회
{{actions.kakaoGift.orders}}
{{actions.kakaoGift.orders[0].orderId}}
// 선물 발송
{{actions.kakaoGift.success}}
트리거: 데이터모델 행 변경 (VIP 고객 등록)
액션: 카카오선물하기 - 선물 보내기
├── 판매자 코드: "SELLER123"
├── 템플릿 ID: "TMPL001"
├── 수신자 전화번호: {{trigger.row.phone}}
└── 메시지: "VIP 회원 가입을 축하합니다!"
트리거: 일정 (매 30분)
액션 1: 카카오선물하기 - 문의 목록 조회 (미답변)
액션 2: 반복 ({{actions.kakaoGift.inquiries}})
액션 3: 슬랙 메시지
└── 메시지: "미답변 문의: {{loop.current.inquiryType}} - {{loop.current.content}}"
트리거: 일정 (매일 오전 10시)
액션 1: 카카오선물하기 - 주문단위 정산 조회
├── 기간 유형: "정산 기준일"
├── 채널: "선물하기"
├── 시작일: {{$today.minus(1, 'day')}}
└── 종료일: {{$today}}
액션 2: 데이터모델 행 추가
└── 정산 데이터 저장
카카오쇼핑 API는 페이지당 최대 100건까지 조회 가능합니다. 대량 조회 시 페이지네이션을 활용하세요.
API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요. 특히 선물 발송 실패는 고객 경험에 직접 영향을 미치므로 즉시 처리가 필요합니다.
쿠팡 로켓그로스 API를 통한 상품, 주문, 송장/배송, 취소/교환, 재고, 정산, 입고, 반품, 매출 리포트를 관리합니다.
카카오스타일(지그재그, 패션바이카카오, 포스티) API를 통한 주문, 상품, 문의, 리뷰, 스토어 정보, 배송, 정산을 관리합니다.
