> 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-api/capa.md).

# 물류센터 CAPA 마감

## 물류센터 CAPA 마감

물류센터 처리 용량이 초과되면 해당 일자의 도착보장 판정을 멈추기 위해 **CAPA 마감**을 등록해요. 마감 등록/해제는 풀필먼트가 토스쇼핑에 요청해요.

{% hint style="info" %}
물류센터별 CAPA 마감 등록과 해제만 가능해요. 센터별 일일 처리 가능 수량을 설정하는 기능은 현재 제공하지 않아요. 

물류센터 처리 불가 시 해당 일자의 CAPA 마감을 등록하는 방식으로 운영해주세요.
{% endhint %}

## 센터 CAPA 마감 여부 조회

> 특정 물류센터의 지정일 CAPA(당일 처리 가능 물량) 마감 여부를 조회합니다.\
> \
> \- 마감(closed=true) 시 해당 물류센터를 통한 도착보장 판정이 중단됩니다

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[],"paths":{"/api/v3/shopping-fep/fulfillment/center-capacity-closures":{"get":{"tags":["풀필먼트 센터 CAPA 마감"],"summary":"센터 CAPA 마감 여부 조회","description":"특정 물류센터의 지정일 CAPA(당일 처리 가능 물량) 마감 여부를 조회합니다.\n\n- 마감(closed=true) 시 해당 물류센터를 통한 도착보장 판정이 중단됩니다","operationId":"getClosure","parameters":[{"name":"fulfillmentCenterKey","in":"query","description":"물류센터 식별자 (최대 128자)","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","description":"조회 기준 일자 (YYYY-MM-DD)","required":true,"schema":{"type":"string","format":"date"}},{"name":"X-Toss-Shopping-Connect-Api-Key","in":"header","description":"토스쇼핑에서 발급한 연동 API Key","required":true,"schema":{"type":"string"}},{"name":"X-Toss-Shopping-Connect-Tx-Id","in":"header","description":"요청별 고유 거래 식별값 (ASCII, 최대 64 byte)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","INVALID_IP","SERVICE_ERROR","INTERNAL_SERVER_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"required":["closed","date","fulfillmentCenterKey"],"type":"object","properties":{"fulfillmentCenterKey":{"type":"string","description":"물류센터 식별자"},"date":{"type":"string","description":"기준 일자 (YYYY-MM-DD)","format":"date"},"closed":{"type":"boolean","description":"CAPA 마감 여부 (true = 마감, 도착보장 중단)"}}}}}}}}}}}}}
```

## 센터 CAPA 마감 등록

> 특정 물류센터를 지정일 CAPA 마감 상태로 등록합니다.\
> \
> \- (물류센터, 일자) 자연키 기반 멱등 등록입니다. 이미 마감 상태면 추가 변경 없이 성공 응답합니다\
> \
> \- 마감 일자는 오늘 \~ 오늘+7일 범위만 허용하며, 범위 밖이면 거절됩니다\
> \
> \- 마감 상태는 해당 일자가 지나면 자동 만료됩니다

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[],"paths":{"/api/v3/shopping-fep/fulfillment/center-capacity-closures":{"post":{"tags":["풀필먼트 센터 CAPA 마감"],"summary":"센터 CAPA 마감 등록","description":"특정 물류센터를 지정일 CAPA 마감 상태로 등록합니다.\n\n- (물류센터, 일자) 자연키 기반 멱등 등록입니다. 이미 마감 상태면 추가 변경 없이 성공 응답합니다\n\n- 마감 일자는 오늘 ~ 오늘+7일 범위만 허용하며, 범위 밖이면 거절됩니다\n\n- 마감 상태는 해당 일자가 지나면 자동 만료됩니다","operationId":"registerClosure","parameters":[{"name":"X-Toss-Shopping-Connect-Api-Key","in":"header","description":"토스쇼핑에서 발급한 연동 API Key","required":true,"schema":{"type":"string"}},{"name":"X-Toss-Shopping-Connect-Tx-Id","in":"header","description":"요청별 고유 거래 식별값 (ASCII, 최대 64 byte)","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["date","fulfillmentCenterKey"],"type":"object","properties":{"fulfillmentCenterKey":{"maxLength":128,"minLength":0,"type":"string","description":"물류센터 식별자"},"date":{"type":"string","description":"마감 일자 (YYYY-MM-DD). 과거 또는 오늘+7일 이후는 거절","format":"date"}}}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","BAD_REQUEST","INVALID_IP","SERVICE_ERROR","INTERNAL_SERVER_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"required":["success"],"type":"object","properties":{"success":{"type":"boolean","description":"성공 여부"}}}}}}}}}}}}}
```

## 센터 CAPA 마감 해제

> 특정 물류센터의 지정일 CAPA 마감 상태를 해제합니다.\
> \
> \- (물류센터, 일자) 자연키로 해제하며, 이미 해제 상태(또는 마감 없음)여도 성공 응답합니다 (멱등)

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[],"paths":{"/api/v3/shopping-fep/fulfillment/center-capacity-closures":{"delete":{"tags":["풀필먼트 센터 CAPA 마감"],"summary":"센터 CAPA 마감 해제","description":"특정 물류센터의 지정일 CAPA 마감 상태를 해제합니다.\n\n- (물류센터, 일자) 자연키로 해제하며, 이미 해제 상태(또는 마감 없음)여도 성공 응답합니다 (멱등)","operationId":"deleteClosure","parameters":[{"name":"fulfillmentCenterKey","in":"query","description":"물류센터 식별자 (최대 128자)","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","description":"해제 기준 일자 (YYYY-MM-DD)","required":true,"schema":{"type":"string","format":"date"}},{"name":"X-Toss-Shopping-Connect-Api-Key","in":"header","description":"토스쇼핑에서 발급한 연동 API Key","required":true,"schema":{"type":"string"}},{"name":"X-Toss-Shopping-Connect-Tx-Id","in":"header","description":"요청별 고유 거래 식별값 (ASCII, 최대 64 byte)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","INVALID_IP","SERVICE_ERROR","INTERNAL_SERVER_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"required":["success"],"type":"object","properties":{"success":{"type":"boolean","description":"성공 여부"}}}}}}}}}}}}}
```


---

# 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-api/capa.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.