물류센터 CAPA 마감

물류센터 CAPA 마감

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

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

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

센터 CAPA 마감 여부 조회

get

특정 물류센터의 지정일 CAPA(당일 처리 가능 물량) 마감 여부를 조회합니다.

• 마감(closed=true) 시 해당 물류센터를 통한 도착보장 판정이 중단됩니다

Query parameters

fulfillmentCenterKeystringRequired

물류센터 식별자 (최대 128자)

datestring · dateRequired

조회 기준 일자 (YYYY-MM-DD)

Header parameters

X-Toss-Shopping-Connect-Api-KeystringRequired

토스쇼핑에서 발급한 연동 API Key

X-Toss-Shopping-Connect-Tx-IdstringRequired

요청별 고유 거래 식별값 (ASCII, 최대 64 byte)

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get/api/v3/shopping-fep/fulfillment/center-capacity-closures

GET /api/v3/shopping-fep/fulfillment/center-capacity-closures?fulfillmentCenterKey=text&date=2026-01-01 HTTP/1.1
Host: shopping-fep.toss.im
X-Toss-Shopping-Connect-Api-Key: text
X-Toss-Shopping-Connect-Tx-Id: text
Accept: */*

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "fulfillmentCenterKey": "text",
    "date": "2026-01-01",
    "closed": true
  }
}

센터 CAPA 마감 등록

post

특정 물류센터를 지정일 CAPA 마감 상태로 등록합니다.

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

Header parameters

X-Toss-Shopping-Connect-Api-KeystringRequired

토스쇼핑에서 발급한 연동 API Key

X-Toss-Shopping-Connect-Tx-IdstringRequired

요청별 고유 거래 식별값 (ASCII, 최대 64 byte)

Body

fulfillmentCenterKeystring · max: 128Required

물류센터 식별자

Example: YI01

datestring · dateRequired

마감 일자 (YYYY-MM-DD). 과거 또는 오늘+7일 이후는 거절

Example: 2026-06-09

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

post/api/v3/shopping-fep/fulfillment/center-capacity-closures

POST /api/v3/shopping-fep/fulfillment/center-capacity-closures HTTP/1.1
Host: shopping-fep.toss.im
X-Toss-Shopping-Connect-Api-Key: text
X-Toss-Shopping-Connect-Tx-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "fulfillmentCenterKey": "YI01",
  "date": "2026-06-09"
}

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "success": true
  }
}

센터 CAPA 마감 해제

delete

특정 물류센터의 지정일 CAPA 마감 상태를 해제합니다.

• (물류센터, 일자) 자연키로 해제하며, 이미 해제 상태(또는 마감 없음)여도 성공 응답합니다 (멱등)

Query parameters

fulfillmentCenterKeystringRequired

물류센터 식별자 (최대 128자)

datestring · dateRequired

해제 기준 일자 (YYYY-MM-DD)

Header parameters

X-Toss-Shopping-Connect-Api-KeystringRequired

토스쇼핑에서 발급한 연동 API Key

X-Toss-Shopping-Connect-Tx-IdstringRequired

요청별 고유 거래 식별값 (ASCII, 최대 64 byte)

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

delete/api/v3/shopping-fep/fulfillment/center-capacity-closures

DELETE /api/v3/shopping-fep/fulfillment/center-capacity-closures?fulfillmentCenterKey=text&date=2026-01-01 HTTP/1.1
Host: shopping-fep.toss.im
X-Toss-Shopping-Connect-Api-Key: text
X-Toss-Shopping-Connect-Tx-Id: text
Accept: */*

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "success": true
  }
}