> 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/undefined.md).
# 계정·물류센터 등록
## 풀필먼트 계정 연동 흐름
토스쇼핑 셀러와 풀필먼트 계정 간 연결 관리를 위한 API에요. 절차는 다음과 같으니 참고해 주세요
## 풀필먼트 고객사 등록(연결) 요청
> 풀필먼트 계정(고객사)을 토스쇼핑 셀러와 연결합니다.\
> \
> \- 셀러가 토스쇼핑 파트너스에서 발급한 인증 정보로 호출합니다
```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v3/shopping-fep/fulfillment/fulfillment-accounts":{"post":{"tags":["풀필먼트 셀러 연결"],"summary":"풀필먼트 고객사 등록(연결) 요청","description":"풀필먼트 계정(고객사)을 토스쇼핑 셀러와 연결합니다.\n\n- 셀러가 토스쇼핑 파트너스에서 발급한 인증 정보로 호출합니다","operationId":"registerFulfillmentAccount","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":["createdAt","fulfillmentAccountKey","fulfillmentAccountName","updatedAt"],"type":"object","properties":{"fulfillmentAccountKey":{"maxLength":64,"minLength":0,"type":"string","description":"풀필먼트 계정(고객사) 식별값"},"fulfillmentAccountName":{"maxLength":128,"minLength":0,"type":"string","description":"풀필먼트 계정(고객사) 이름"},"createdAt":{"type":"string","description":"풀필먼트 계정(고객사) 등록일시"},"updatedAt":{"type":"string","description":"풀필먼트 계정(고객사) 변경일시"}}}}},"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","INVALID_IP","SERVICE_ERROR","INTERNAL_SERVER_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"required":["success"],"type":"object","properties":{"success":{"type":"boolean","description":"성공 여부"}}}}}}}}}}}}}
```
**요청 예시**
계정 등록 API는 **OAuth2 Bearer Token과 API Key를 모두** 헤더에 담아야 해요.
## 풀필먼트 고객사 등록(연결) 해제
> 풀필먼트 계정(고객사)과 토스쇼핑 셀러 간의 연결을 해제합니다.\
> \
> \- 해제 사유(reason)는 필수입니다
```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v3/shopping-fep/fulfillment/fulfillment-accounts/delete":{"post":{"tags":["풀필먼트 셀러 연결"],"summary":"풀필먼트 고객사 등록(연결) 해제","description":"풀필먼트 계정(고객사)과 토스쇼핑 셀러 간의 연결을 해제합니다.\n\n- 해제 사유(reason)는 필수입니다","operationId":"deleteFulfillmentAccount","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":["fulfillmentAccountKey","reason"],"type":"object","properties":{"fulfillmentAccountKey":{"maxLength":64,"minLength":0,"type":"string","description":"풀필먼트 계정(고객사) 식별값"},"reason":{"maxLength":255,"minLength":0,"type":"string","description":"풀필먼트 계정(고객사) 해제 사유"}}}}},"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","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/undefined.md?ask=&goal=
```
`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.
