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

네이버 커머스

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

개요

항목내용
카테고리국내 비즈니스
연동 필요네이버 커머스 API 연동
지원 리소스주문, 상품, 정산

작업 종류

주문

작업설명
주문 목록 조회조건에 맞는 주문 목록
주문 상세 조회특정 주문의 상세 정보
발송처리택배사/송장 입력 및 발송
배송정보 수정송장 정보 변경

상품

작업설명
상품 목록 조회상품 목록
상품 상세 조회특정 상품 정보
재고 수정재고 수량 업데이트

정산

작업설명
일별 정산 조회기간별 정산 내역

택배사 코드

코드택배사
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시간 이내 발송처리를 권장합니다.