Smartstore Domain Skill

Overview

네이버 스마트스토어 자동화 및 API 연동 지식

Project Location

~/smartstore

Key Concepts

Order States

발주확인대기 → 발주확인 → 발송대기 → 배송중 → 배송완료
                    ↘ 취소/반품/교환

API Endpoints (Commerce API)

• •주문 조회: GET /v1/orders
• •주문 상세: GET /v1/orders/{orderId}
• •발송 처리: POST /v1/orders/{orderId}/ship
• •상품 관리: /v1/products

Authentication

• •Client ID + Secret (Partner Center에서 발급)
• •OAuth 토큰 방식
• •토큰 갱신 필요 (만료 전)

Common Patterns

Order Processing

# 1. 신규 주문 조회
orders = get_new_orders()

# 2. 상태별 처리
for order in orders:
    if order.status == "발주확인대기":
        confirm_order(order)
    elif order.status == "발송대기":
        process_shipping(order)

Error Handling

• •429: Rate limit - 재시도 with backoff
• •401: Token expired - 갱신 후 재시도
• •400: Invalid request - 로그 후 스킵

File Structure

~/smartstore/
├── src/
│   ├── api/          # API 클라이언트
│   ├── services/     # 비즈니스 로직
│   └── models/       # 데이터 모델
├── config/           # 설정 파일
└── tests/

Environment Variables

• •SMARTSTORE_CLIENT_ID
• •SMARTSTORE_CLIENT_SECRET
• •SMARTSTORE_SELLER_ID