Amazon SP-API
Amazon Selling Partner API를 통한 주문, 재고, 상품, 리포트, 정산, 피드, 취소, 반품을 관리합니다.
| 항목 | 내용 |
|---|
| 카테고리 | 연동 |
| 연동 필요 | Amazon SP-API OAuth2 (LWA 자격 증명) |
| 지원 리소스 | 주문, 재고 (FBA), 상품 카탈로그, 리포트, 정산, 피드, 취소, 반품 |
| 마켓플레이스 | 미국, 일본, 유럽, 싱가포르 등 글로벌 마켓플레이스 |
| 작업 | 설명 |
|---|
| 주문 목록 조회 | 상태, 이행 채널(FBA/MFN), 기간으로 필터링하여 조회 |
| 주문 상세 조회 | Amazon 주문 ID로 상세 조회 |
| 주문 아이템 조회 | 특정 주문의 품목 상세 조회 |
| 구매자 정보 조회 | 주문의 구매자 정보 조회 |
| 배송 주소 조회 | 주문의 배송 주소 조회 |
| 배송 확인 | 추적 번호 및 배송사 등록 |
| 작업 | 설명 |
|---|
| FBA 재고 요약 조회 | 마켓플레이스 또는 ASIN별 FBA 재고 현황 조회 |
| 작업 | 설명 |
|---|
| 상품 검색 | 키워드, ASIN, UPC, EAN, ISBN, SKU로 상품 검색 |
| 상품 상세 조회 | ASIN으로 상품 상세 정보 조회 |
| 작업 | 설명 |
|---|
| 리포트 목록 조회 | 리포트 유형 및 처리 상태별 목록 조회 |
| 리포트 요청 생성 | 새 리포트 생성 요청 (데이터 범위 지정) |
| 리포트 상태 조회 | 리포트 처리 상태 확인 |
| 리포트 문서 다운로드 | 완료된 리포트 문서 다운로드 |
| 리포트 취소 | 진행 중인 리포트 요청 취소 |
| 작업 | 설명 |
|---|
| 정산 이벤트 그룹 조회 | 정산 기간별 이벤트 그룹 조회 |
| 정산 이벤트 조회 | 특정 그룹의 정산 이벤트 상세 조회 |
| 주문별 정산 이벤트 조회 | 특정 주문의 정산 내역 조회 |
| 작업 | 설명 |
|---|
| 피드 목록 조회 | 피드 유형 및 처리 상태별 목록 조회 |
| 피드 생성 | 대량 데이터 업데이트용 피드 생성 |
| 피드 상태 조회 | 피드 처리 상태 확인 |
| 피드 문서 생성 | 피드 업로드용 문서 생성 |
| 피드 문서 조회 | 피드 처리 결과 문서 조회 |
| 피드 취소 | 진행 중인 피드 취소 |
| 작업 | 설명 |
|---|
| 취소된 주문 목록 조회 | 취소 상태 주문 목록 조회 |
| 취소 상세 조회 | 취소된 주문의 아이템 상세 (구매자 취소 요청 포함) |
| 이행 주문 취소 (FBA/MCF) | FBA 또는 MCF 이행 주문의 배송 시도 중지 |
| 작업 | 설명 |
|---|
| 반품 사유 코드 조회 | SKU에 대한 반품 사유 코드 목록 조회 |
| 이행 반품 생성 | FBA/MCF 이행 주문에 대한 반품 요청 생성 |
트리거: 일정 (매 15분)
액션 1: Amazon SP-API - 주문 목록 조회
├── 마켓플레이스: US
├── 주문 상태: Unshipped
├── 주문 생성일 (이후): {{$now.minus(15, 'minutes')}}
액션 2: 반복 (신규 주문)
액션 3: 행 생성 (주문 데이터모델)
트리거: 일정 (매일 오전 9시)
액션 1: Amazon SP-API - FBA 재고 요약 조회
├── SKU 목록: "SKU-001, SKU-002, SKU-003"
액션 2: 반복 (재고 부족 품목)
액션 3: 슬랙 메시지
└── 메시지: "FBA 재고 부족: {{loop.current.sellerSku}} ({{loop.current.totalQuantity}}개)"
트리거: 웹훅 (물류 시스템 출고 완료)
액션: Amazon SP-API - 배송 확인
├── 주문 ID: {{trigger.body.amazonOrderId}}
├── 배송 추적 번호: {{trigger.body.trackingNumber}}
└── 배송사 코드: FEDEX
Amazon SP-API는 요청 제한(Throttling)이 있습니다. 대량 처리 시 피드를 활용하고, 주문 조회는 lastUpdatedAfter 필터로 변경분만 가져오는 것이 효율적입니다.
노드 설정에서 대상 마켓플레이스를 선택하세요. 주요 마켓플레이스:
- 미국 (US), 일본 (JP), 영국 (UK), 독일 (DE) 등
- FBA (Fulfillment by Amazon): Amazon이 보관, 배송, 고객 서비스 처리
- MFN (Merchant Fulfilled Network): 판매자가 직접 배송
API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요.
