> For the complete documentation index, see [llms.txt](https://shopping-docs.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shopping-docs.toss.im/connect/fulfillment/undefined-3.md).

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

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

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

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

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

#### 단계별 연동 흐름

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://shopping-docs.toss.im/connect/fulfillment/undefined-3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.