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

네이버 커머스

스마트스토어 주문, 상품, 정산을 관리합니다.

개요

항목내용
카테고리국내 비즈니스
연동 필요네이버 커머스 API 연동
지원 리소스주문, 상품, 클레임, 고객 문의, 상품 문의, 정산, 카테고리, 판매자 정보, 채널

작업 종류

주문

작업설명
변경 주문 목록 조회상태별 변경된 주문 ID 조회 (권장)
조건형 주문 상세 조회상세 정보를 직접 반환하는 목록 조회
주문 상세 조회특정 주문의 상세 정보
주문 목록 조회 (검색)조건 기반 주문 검색
발주확인 처리발주 확인
발송처리택배사/송장 입력 및 발송
발송 지연 처리발송 지연 사유 등록
배송정보 수정송장 정보 변경
구매확정 요청구매확정 요청
판매자 취소 요청판매자 취소
판매자 반품 요청판매자 반품

상품

작업설명
상품 목록 조회원상품 목록
상품 상세 조회원상품 상세 정보
채널 상품 목록 조회채널별 상품 목록
채널 상품 상세 조회채널별 상품 상세
재고 수량 수정재고 수량 업데이트
상품 판매 상태 수정판매중/판매중지 변경
상품 전시 상태 수정전시함/전시안함 변경

클레임 (취소/반품/교환)

작업설명
취소 요청 목록 조회취소 요청 목록
취소 승인/거부취소 요청 처리
반품 요청 목록 조회반품 요청 목록
반품 승인/수거완료/거부/보류반품 요청 처리
교환 요청 목록 조회교환 요청 목록
교환 수거완료/재배송/거부/보류교환 요청 처리

고객 문의

작업설명
고객 문의 목록 조회주문 기반 1:1 문의 목록
고객 문의 답변 등록문의에 답변
고객 문의 답변 수정기존 답변 수정

상품 문의

작업설명
상품 문의 목록 조회상품 Q&A 목록
상품 문의 답변 등록/수정문의에 답변
답변 템플릿 목록 조회답변 템플릿

정산

작업설명
일별 정산 조회기간별 정산 내역
정산 상세 조회정산 상세 정보
정산 예정 조회정산 예정 내역

기타 리소스

리소스작업
카테고리전체 조회, 상세 조회
판매자 정보계정 정보 조회, 스토어 정보 조회, 주소록 조회
채널채널 목록 조회

택배사 코드

코드택배사
CJGLSCJ대한통운
LOTTE롯데택배
HANJIN한진택배
LOGEN로젠택배
EPOST우체국택배
KDEXP경동택배
DAESIN대신택배

설정 옵션

발송처리

옵션설명필수
상품주문번호네이버 상품주문번호
택배사택배사 코드
송장번호운송장 번호

출력 데이터

// 주문 조회
{{actions.naverCommerce.orders}}
{{actions.naverCommerce.orders[0].productOrderId}}
{{actions.naverCommerce.orders[0].ordererId}}

// 발송처리
{{actions.naverCommerce.success}}

활용 예시

발송처리

트리거: 물류 시스템 웹훅 (송장 생성)
액션: 네이버 커머스 - 발송처리
├── 상품주문번호: {{trigger.body.productOrderId}}
├── 택배사: "CJGLS"
└── 송장번호: {{trigger.body.invoiceNumber}}

신규 주문 동기화

트리거: 일정 (매 30분)
액션 1: 네이버 커머스 - 주문 조회
├── 상태: "결제완료"
└── 기간: 최근 1시간
액션 2: 반복 ({{actions.naverCommerce.orders}})
액션 3: 행 생성 (주문 데이터모델)
├── 주문번호: {{loop.current.orderId}}
├── 상품주문번호: {{loop.current.productOrderId}}
├── 상품명: {{loop.current.productName}}
└── 수량: {{loop.current.quantity}}

일일 정산 리포트

트리거: 일정 (매일 오전 10시)
액션 1: 네이버 커머스 - 정산 조회 (어제)
액션 2: 슬랙 메시지
└── 메시지: |
    📊 어제 스마트스토어 정산
    • 매출: {{actions.naverCommerce.settlement.totalSales}}원
    • 수수료: {{actions.naverCommerce.settlement.fee}}원
    • 정산금: {{actions.naverCommerce.settlement.settlement}}원

모범 사례

주문 상태 흐름

결제완료 → 상품준비중 → 배송중 → 배송완료 → 구매확정

API 제한

네이버 커머스 API는 요청 제한이 있습니다. 대량 처리 시 주의하세요.

송장 입력 타이밍

결제완료 후 48시간 이내 발송처리를 권장합니다.