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

카카오스타일

카카오스타일(지그재그, 패션바이카카오, 포스티) API를 통한 주문, 상품, 문의, 리뷰, 스토어 정보, 배송, 정산을 관리합니다.

개요

항목내용
카테고리국내 비즈니스
연동 필요카카오스타일 파트너센터 API 인증 (접근키 + 비밀키)
지원 리소스주문, 상품, 문의, 리뷰, 스토어 정보, 배송, 정산

카카오스타일은 지그재그, 패션바이카카오, 포스티 등 여러 채널을 하나의 파트너센터에서 통합 관리합니다.


작업 종류

주문

작업설명
주문 목록 조회조건에 맞는 주문 목록
직진배송 주문 조회직진배송(지그재그 자체 물류) 주문 조회
클레임 요청 주문 조회취소/반품/교환 클레임이 접수된 주문
교환 주문 조회교환 요청이 있는 주문
배송준비 상태로 변경선택한 주문 아이템을 배송준비 상태로 변경
송장 입력택배사/송장번호 등록
반품 처리반품 요청 처리
교환 처리교환 요청 처리
주문 취소주문 취소 실행
반품 승인반품 요청 승인
반품 거부반품 요청 거부

상품

작업설명
상품 목록 조회등록된 상품 목록
상품 상세 조회특정 상품 정보
상품 등록신규 상품 등록
상품 수정기존 상품 정보 수정
재고 수정상품 재고 수량 변경
판매 상태 변경판매중/판매중지 전환
상품 리뷰 조회특정 상품의 리뷰 목록
상품 문의 조회특정 상품의 문의 목록

문의

작업설명
문의 목록 조회고객 문의 목록
문의 상세 조회특정 문의 상세 내용
문의 답변 등록문의에 대한 답변 작성

리뷰

작업설명
리뷰 목록 조회리뷰 목록 (상품별 필터 가능)
리뷰 상세 조회특정 리뷰 상세
리뷰 답변 등록리뷰에 대한 답변 작성

스토어 정보

작업설명
스토어 정보 조회스토어 기본 정보
배송지 목록 조회등록된 배송지 목록
배송 템플릿 조회배송 템플릿 정보

배송

작업설명
배송지 목록 조회배송지 목록
배송 템플릿 조회배송 템플릿 정보

정산

작업설명
정산 아이템 조회아이템 단위 정산 내역
스토어별 정산 조회스토어 단위 정산 내역

출력 데이터

// 주문 조회
{{actions.kakaoStyle.orders}}
{{actions.kakaoStyle.orders[0].orderItemIds}}

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

// 리뷰 조회
{{actions.kakaoStyle.reviews}}
{{actions.kakaoStyle.reviews[0].reviewId}}

활용 예시

신규 주문 자동 배송준비 전환

트리거: 일정 (매 10분)
액션 1: 카카오스타일 - 주문 목록 조회 (결제완료)
액션 2: 반복 ({{actions.kakaoStyle.orders}})
액션 3: 카카오스타일 - 배송준비 상태로 변경
└── 주문 아이템 ID: {{loop.current.orderItemId}}

리뷰 모니터링 및 알림

트리거: 일정 (매시간)
액션 1: 카카오스타일 - 리뷰 목록 조회
액션 2: 필터 (평점 <= 2)
액션 3: 슬랙 메시지
└── 메시지: "낮은 평점 리뷰: {{loop.current.productName}} - {{loop.current.content}}"

정산 데이터 수집

트리거: 일정 (매주 월요일)
액션 1: 카카오스타일 - 정산 아이템 조회
├── 시작일: {{$today.minus(7, 'day')}}
└── 종료일: {{$today}}
액션 2: 데이터모델 행 추가
└── 정산 데이터 저장

모범 사례

카카오스타일 API는 페이지당 최대 100건까지 조회 가능합니다. 클레임 주문은 별도 조회 API를 사용하므로 주문 유형에 맞는 작업을 선택하세요.

에러 처리

API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요. 송장 입력 실패는 배송 지연으로 이어질 수 있습니다.