도착보장(풀필먼트) 연동 가이드

도착보장 연동 개요 & 전체 플로우

연동 모델: 누가 누구를 호출하나요?

도착보장 연동은 Pull(폴링) 과 Push 두 가지 방향이 섞여 있어요. 각 API가 어느 방향인지 먼저 이해하면 전체 구조가 한눈에 들어와요.

구분	방향	주체	설명
주문 수집	Pull	풀필먼트 → 토스쇼핑	풀필먼트 주기적으로 신규 주문을 폴링해요
취소 요청/완료 수집	Pull	풀필먼트 → 토스쇼핑	풀필먼트가 취소 요청·완료 건을 폴링해요
SKU 동기화	Push	풀필먼트 → 토스쇼핑	풀필먼트가 SKU 정보를 토스쇼핑으로 보내요
재고 동기화	Push	풀필먼트 → 토스쇼핑	풀필먼트가 재고 절대값을 토스쇼핑으로 보내요
배송 상태 갱신	Push	풀필먼트 → 토스쇼핑	풀필먼트가 배송 단계 변경을 토스쇼핑으로 보내요
취소 승인/거절	Push	풀필먼트 → 토스쇼핑	풀필먼트가 취소 검토 결과를 토스쇼핑으로 보내요
CAPA 마감 등록/해제	Push	풀필먼트 → 토스쇼핑	풀필먼트가 물류센터 마감 여부를 토스쇼핑으로 보내요
계정 등록/해제	Push	풀필먼트 → 토스쇼핑	풀필먼트가 셀러-계정 매핑을 토스쇼핑으로 보내요
일단위 전체 FEED	Push(SFTP)	풀필먼트 → 토스쇼핑	풀필먼트가 SFTP에 merchant/product/stock 전체 파일을 올려요

단계별 연동 흐름

연동은 아래 순서로 진행해요. 각 단계는 이 문서의 해당 섹션에서 자세히 다뤄요.

1. 계정 연동 — 셀러와 풀필먼트 계정을 연결해요. (계정·물류센터 등록)
2. SKU/재고 초기화 — SFTP로 일단위 전체 FEED를 올린 뒤, 변경분은 API로 증분 동기화해요. (상품-SKU 연결 & 재고 동기화)
3. 주문 처리 — 신규 주문을 폴링하고, 배송 단계를 Push해요. (주문 수집(폴링) 및 출고·배송상태)
4. 취소 처리 — 취소 요청을 폴링하고, 승인/거절 결과를 Push해요. (취소·반품·교환 처리)
5. CAPA 관리 — 물류센터 처리 용량 초과 시 도착보장 마감을 등록해요. (CAPA(도착보장 가능일) 관리)