# 배송

## 주문 상품 배송정보 변경

> 주문 상품의 배송 회사와 송장번호를 변경합니다.\
> \
> \## 변경 가능 조건\
> \
> 주문 상품 상태가 다음 중 하나인 경우에만 배송정보를 변경할 수 있습니다:\
> \
> \- \*\*PREPARING\_PRODUCT\*\* (상품준비중): 배송정보 등록 시 자동으로 \*\*DELIVERING\*\* (배송중) 상태로 변경됩니다\
> \- \*\*DELIVERING\*\* (배송중): 배송정보만 수정됩니다\
> \
> \## 변경 불가 조건\
> \
> \- 취소 요청이 들어온 주문 상품의 경우 DELIVERING(배송중) 상태로 변경할 수 없습니다\
> \- 위 조건에 해당하지 않으면 API 요청이 실패합니다\
> \
> \## 송장번호 형식\
> \
> \- 기본적으로 숫자로 된 문자열만 입력 가능합니다 (정규식: \`\\\d+\`)\
> \- 일부 택배사(예: 팀프레시)의 경우에만 영문 입력이 가능합니다\
> \- 하이픈(-)은 입력하셔도 자동으로 제거되어 등록됩니다

```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"}},"schemas":{"ChangeOrderProductDeliveryBody":{"required":["deliveryCompany","orderProductId","trackingNumber"],"type":"object","properties":{"orderProductId":{"type":"integer","description":"주문 상품 ID","format":"int64"},"deliveryCompany":{"type":"string","description":"배송 회사 코드 (택배사 정보 조회 API에서 확인 가능)","enum":["CJ대한통운","우체국택배","한덱스","합동택배","한의사랑택배","굿투럭","우리택배","홈픽택배","용마로지스","컬리넥스트마일","큐런택배","지니고","한샘서비스원","LG전자","썬더히어로","핑퐁","GTS로지스","UFO로지스","에이치케이홀딩스","더바오","탱고앤고","ARGO","한진택배","로젠택배","대신택배","CU편의점택배","천일택배","애니트랙","우리한방택배","IK물류","원더스퀵","풀앳홈","두발히어로","오늘의픽업","NDEXKOREA","부릉","팀프레시","발렉스","로지스팟","딜리래빗","HTNS","라스트마일","투데이","자이언트","롯데택배","일양로지스","경동택배","GS25편의점택배","건영택배","SLX택배","농협택배","성훈물류","로지스밸리택배","삼성전자물류","위니아딤채","큐익스프레스","로지스밸리","도도플렉스","1004홈","롯데칠성","엔티엘피스","홈픽","지오피","케이제이티","오늘회러쉬","현대글로비스","위니온로지스","딜리박스","이스트라","hy","CR로지텍","나은물류","지케이글로벌","유피로지스(제주)","반얀로지스틱스","삼다수 가정배송","프리즘코리아","올인닷컴","물류대장(택배)","풀무원샘물","SLO","바로스","레터스","벤더피아","세븐일레븐(착한택배)","물류대장(설치)","BoxN","리터니즈","직접전달"]},"trackingNumber":{"type":"string","description":"송장번호. 하이픈(-)은 자동 제거됩니다\n\n- 직접전달인 경우 검증 생략"},"partnerName":{"type":"string","description":"연동 프로그램명 또는 자사 서비스명"}}}}},"paths":{"/api/v3/shopping-fep/orders/products/delivery":{"put":{"tags":["주문"],"summary":"주문 상품 배송정보 변경","description":"주문 상품의 배송 회사와 송장번호를 변경합니다.\n\n## 변경 가능 조건\n\n주문 상품 상태가 다음 중 하나인 경우에만 배송정보를 변경할 수 있습니다:\n\n- **PREPARING_PRODUCT** (상품준비중): 배송정보 등록 시 자동으로 **DELIVERING** (배송중) 상태로 변경됩니다\n- **DELIVERING** (배송중): 배송정보만 수정됩니다\n\n## 변경 불가 조건\n\n- 취소 요청이 들어온 주문 상품의 경우 DELIVERING(배송중) 상태로 변경할 수 없습니다\n- 위 조건에 해당하지 않으면 API 요청이 실패합니다\n\n## 송장번호 형식\n\n- 기본적으로 숫자로 된 문자열만 입력 가능합니다 (정규식: `\\\\d+`)\n- 일부 택배사(예: 팀프레시)의 경우에만 영문 입력이 가능합니다\n- 하이픈(-)은 입력하셔도 자동으로 제거되어 등록됩니다","operationId":"changeOrderProductDelivery","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeOrderProductDeliveryBody"}}},"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","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"type":"object","description":"성공시 제공, 별도 내용이 없습니다. {}으로 반환"}}}}}}}}}}}
```

## 택배사 정보 조회

> 배송정보 등록 시 사용 가능한 택배사 목록을 조회합니다.\
> \
> \## 사용처\
> \
> \- 주문 상품 배송정보 변경 API의 \`deliveryCompany\` 파라미터에 사용할 택배사 코드를 확인할 수 있습니다\
> \
> \## 지원 택배사\
> \
> CJ대한통운, 우체국택배, 한진택배, 로젠택배, 대신택배, 롯데택배, GS25편의점택배, CU편의점택배 등 대다수의 택배사가 지원됩니다.

```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"}},"schemas":{"FepGetDeliveryCompaniesResponse":{"required":["deliveryCompanies"],"type":"object","properties":{"deliveryCompanies":{"type":"array","description":"택배사 목록. 배송정보 변경 시 deliveryCompany 파라미터로 사용","items":{"type":"string","description":"택배사 목록. 배송정보 변경 시 deliveryCompany 파라미터로 사용"}}}}}},"paths":{"/api/v3/shopping-fep/orders/delivery-companies":{"get":{"tags":["주문"],"summary":"택배사 정보 조회","description":"배송정보 등록 시 사용 가능한 택배사 목록을 조회합니다.\n\n## 사용처\n\n- 주문 상품 배송정보 변경 API의 `deliveryCompany` 파라미터에 사용할 택배사 코드를 확인할 수 있습니다\n\n## 지원 택배사\n\nCJ대한통운, 우체국택배, 한진택배, 로젠택배, 대신택배, 롯데택배, GS25편의점택배, CU편의점택배 등 대다수의 택배사가 지원됩니다.","operationId":"getDeliveryCompanies_1","parameters":[{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"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":["COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/FepGetDeliveryCompaniesResponse"}}}}}}}}}}}
```

## 배송 위치 (배송비 묶음 그룹) 등록

> 가맹점의 배송 그룹을 등록합니다.\
> \
> \## 사용처\
> \- 상품 등록 시 배송비 정책을 묶어서 관리하는 배송 그룹을 등록합니다\
> \- 셀러 어드민 대신 API를 통해 배송 그룹을 등록할 수 있습니다\
> \
> \## 주의사항\
> \- 배송 그룹 이름은 필수이며 빈 값일 수 없습니다\
> \- 대표 배송 그룹(\`isMain = true\`)은 하나만 존재할 수 있습니다\
> \- 등록 후 반환되는 \`id\`는 상품 등록 시 \`deliveryLocationId\`로 사용됩니다

```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"}},"schemas":{"RegisterDeliveryLocationFepRequest":{"required":["isMain","name"],"type":"object","properties":{"name":{"type":"string","description":"배송 그룹 이름 (필수, 최대 100자)"},"isMain":{"type":"boolean","description":"대표 배송 그룹 여부\n\ntrue로 설정 시 기존 대표 배송 그룹이 자동으로 해제됩니다"},"partnerName":{"type":"string","description":"연동 프로그램명 또는 자사 서비스명"}},"description":"배송 그룹 등록 요청"},"RegisterDeliveryLocationFepResponse":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","description":"등록된 배송 그룹 ID","format":"int64"}},"description":"배송 그룹 등록 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/delivery-location":{"post":{"tags":["배송 그룹"],"summary":"배송 위치 (배송비 묶음 그룹) 등록","description":"가맹점의 배송 그룹을 등록합니다.\n\n## 사용처\n- 상품 등록 시 배송비 정책을 묶어서 관리하는 배송 그룹을 등록합니다\n- 셀러 어드민 대신 API를 통해 배송 그룹을 등록할 수 있습니다\n\n## 주의사항\n- 배송 그룹 이름은 필수이며 빈 값일 수 없습니다\n- 대표 배송 그룹(`isMain = true`)은 하나만 존재할 수 있습니다\n- 등록 후 반환되는 `id`는 상품 등록 시 `deliveryLocationId`로 사용됩니다","operationId":"registerDeliveryLocation_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterDeliveryLocationFepRequest"}}},"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","ACQUIRE_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/RegisterDeliveryLocationFepResponse"}}}}}}}}}}}
```

## 배송 위치 (배송비 묶음 그룹) 수정

> 가맹점의 배송 그룹을 수정합니다.\
> \
> \## 사용처\
> \- 이미 등록된 배송 그룹의 정보를 변경할 수 있습니다\
> \- 배송 그룹 이름 변경이나 대표 그룹 설정 변경 시 사용됩니다\
> \
> \## 주의사항\
> \- \`id\`는 배송 위치 등록 API 또는 조회 API에서 반환된 값을 사용해야 합니다\
> \- 배송 그룹 이름은 필수이며 빈 값일 수 없습니다\
> \- 대표 배송 그룹(\`isMain = true\`)은 하나만 존재할 수 있습니다

```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"}},"schemas":{"ChangeDeliveryLocationFepRequest":{"required":["id","isMain","name"],"type":"object","properties":{"id":{"type":"integer","description":"배송 그룹 ID","format":"int64"},"name":{"type":"string","description":"배송 그룹 이름 (필수, 최대 100자)"},"isMain":{"type":"boolean","description":"대표 배송 그룹 여부\n\ntrue로 설정 시 기존 대표 배송 그룹이 자동으로 해제됩니다"},"partnerName":{"type":"string","description":"연동 프로그램명 또는 자사 서비스명"}},"description":"배송 그룹 수정 요청"},"ChangeDeliveryLocationFepResponse":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","description":"수정된 배송 그룹 ID","format":"int64"}},"description":"배송 그룹 수정 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/delivery-location":{"put":{"tags":["배송 그룹"],"summary":"배송 위치 (배송비 묶음 그룹) 수정","description":"가맹점의 배송 그룹을 수정합니다.\n\n## 사용처\n- 이미 등록된 배송 그룹의 정보를 변경할 수 있습니다\n- 배송 그룹 이름 변경이나 대표 그룹 설정 변경 시 사용됩니다\n\n## 주의사항\n- `id`는 배송 위치 등록 API 또는 조회 API에서 반환된 값을 사용해야 합니다\n- 배송 그룹 이름은 필수이며 빈 값일 수 없습니다\n- 대표 배송 그룹(`isMain = true`)은 하나만 존재할 수 있습니다","operationId":"changeDeliveryLocation_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeDeliveryLocationFepRequest"}}},"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","ACQUIRE_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ChangeDeliveryLocationFepResponse"}}}}}}}}}}}
```

## 배송 위치 (배송비 묶음 그룹) 조회

> 가맹점이 설정한 배송 그룹 목록을 조회합니다.\
> \
> \## 사용처\
> \- 상품 등록 시 해당 API를 통해 배송 그룹을 조회한 후, 해당 ID를 \`deliveryLocationId\`로 지정해야 합니다\
> \
> \## 페이지네이션\
> \- \`size\`는 1 \~ 20 사이의 값이어야 합니다\
> \- 첫 페이지 조회 시 \`nextToken\`을 생략합니다\
> \- 다음 페이지 조회 시 응답으로 받은 \`nextToken\` 값을 그대로 전달합니다\
> \- 응답의 \`hasNext\`가 false이면 마지막 페이지입니다\
> \
> \## 배송 그룹 등록 방법\
> \- 셀러 어드민에서 등록 가능\
> \- API를 통해 등록 가능 (배송 위치 등록 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"}},"schemas":{"GetDeliveryLocationFepV2Response":{"required":["hasNext","items","nextToken"],"type":"object","properties":{"items":{"type":"array","description":"배송 그룹 목록","items":{"$ref":"#/components/schemas/GetDeliveryLocationFepResponseItem"}},"nextToken":{"type":"string","description":"다음 페이지를 위한 토큰. 다음 페이지 조회 시 이 값을 그대로 전달"},"hasNext":{"type":"boolean","description":"다음 페이지 존재 여부. false이면 마지막 페이지"}},"description":"배송 그룹 목록 조회 응답 V2 (페이지네이션 지원)"},"GetDeliveryLocationFepResponseItem":{"required":["id","isMain","name"],"type":"object","properties":{"id":{"type":"integer","description":"배송 그룹 ID. 상품 등록 시 deliveryLocationId로 사용","format":"int64"},"name":{"type":"string","description":"배송 그룹 이름"},"isMain":{"type":"boolean","description":"대표 배송 그룹 여부"}},"description":"배송 그룹 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/delivery-location/v2":{"get":{"tags":["배송 그룹"],"summary":"배송 위치 (배송비 묶음 그룹) 조회","description":"가맹점이 설정한 배송 그룹 목록을 조회합니다.\n\n## 사용처\n- 상품 등록 시 해당 API를 통해 배송 그룹을 조회한 후, 해당 ID를 `deliveryLocationId`로 지정해야 합니다\n\n## 페이지네이션\n- `size`는 1 ~ 20 사이의 값이어야 합니다\n- 첫 페이지 조회 시 `nextToken`을 생략합니다\n- 다음 페이지 조회 시 응답으로 받은 `nextToken` 값을 그대로 전달합니다\n- 응답의 `hasNext`가 false이면 마지막 페이지입니다\n\n## 배송 그룹 등록 방법\n- 셀러 어드민에서 등록 가능\n- API를 통해 등록 가능 (배송 위치 등록 API 사용)","operationId":"getDeliveryLocationForFepV2","parameters":[{"name":"nextToken","in":"query","description":"다음 페이지를 위한 토큰 (직전 호출에서 받은 nextToken을 그대로 전달)","required":false,"schema":{"type":"string"}},{"name":"size","in":"query","description":"페이지 사이즈 (1 ~ 20)","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"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","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/GetDeliveryLocationFepV2Response"}}}}}}}}}}}
```

## 교환 반품지 등록

> 가맹점의 교환 반품지를 등록합니다.\
> \
> \## 사용처\
> \- 고객이 교환/반품 신청 시 반송할 주소 정보로 사용됩니다\
> \- 셀러 어드민 대신 API를 통해 교환 반품지를 등록할 수 있습니다\
> \
> \## 주의사항\
> \- 대표 교환 반품지(\`isMain = true\`)는 하나만 존재할 수 있습니다\
> \- 등록 후 반환되는 \`id\`는 교환 반품지 수정 시 사용됩니다

```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"}},"schemas":{"RegisterExchangeRefundLocationFepRequest":{"required":["address","detailAddress","isMain","zipCode"],"type":"object","properties":{"zipCode":{"type":"string","description":"우편번호"},"address":{"type":"string","description":"주소 (필수)"},"detailAddress":{"type":"string","description":"상세 주소"},"isMain":{"type":"boolean","description":"대표 교환 반품지 여부\n\ntrue로 설정 시 기존 대표 교환 반품지가 자동으로 해제됩니다"},"partnerName":{"type":"string","description":"연동 프로그램명 또는 자사 서비스명"}},"description":"교환 반품지 등록 요청"},"RegisterExchangeRefundLocationFepResponse":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","description":"등록된 교환 반품지 ID","format":"int64"}},"description":"교환 반품지 등록 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/exchange-refund-location":{"post":{"tags":["배송 그룹"],"summary":"교환 반품지 등록","description":"가맹점의 교환 반품지를 등록합니다.\n\n## 사용처\n- 고객이 교환/반품 신청 시 반송할 주소 정보로 사용됩니다\n- 셀러 어드민 대신 API를 통해 교환 반품지를 등록할 수 있습니다\n\n## 주의사항\n- 대표 교환 반품지(`isMain = true`)는 하나만 존재할 수 있습니다\n- 등록 후 반환되는 `id`는 교환 반품지 수정 시 사용됩니다","operationId":"registerExchangeRefundLocation_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterExchangeRefundLocationFepRequest"}}},"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","ACQUIRE_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/RegisterExchangeRefundLocationFepResponse"}}}}}}}}}}}
```

## 교환 반품지 수정

> 가맹점의 교환 반품지를 수정합니다.\
> \
> \## 사용처\
> \- 이미 등록된 교환 반품지의 정보를 변경할 수 있습니다\
> \- 교환/반품 주소지 정보 업데이트 시 사용됩니다\
> \
> \## 주의사항\
> \- \`id\`는 교환 반품지 등록 API 또는 조회 API에서 반환된 값을 사용해야 합니다\
> \- 대표 교환 반품지(\`isMain = true\`)는 하나만 존재할 수 있습니다

```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"}},"schemas":{"ChangeExchangeRefundLocationFepRequest":{"required":["address","detailAddress","id","isMain","zipCode"],"type":"object","properties":{"id":{"type":"integer","description":"교환 반품지 ID","format":"int64"},"zipCode":{"type":"string","description":"우편번호"},"address":{"type":"string","description":"주소 (필수)"},"detailAddress":{"type":"string","description":"상세 주소"},"isMain":{"type":"boolean","description":"대표 교환 반품지 여부\n\ntrue로 설정 시 기존 대표 교환 반품지가 자동으로 해제됩니다"},"partnerName":{"type":"string","description":"연동 프로그램명 또는 자사 서비스명"}},"description":"교환 반품지 수정 요청"},"ChangeExchangeRefundLocationFepResponse":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","description":"수정된 교환 반품지 ID","format":"int64"}},"description":"교환 반품지 수정 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/exchange-refund-location":{"put":{"tags":["배송 그룹"],"summary":"교환 반품지 수정","description":"가맹점의 교환 반품지를 수정합니다.\n\n## 사용처\n- 이미 등록된 교환 반품지의 정보를 변경할 수 있습니다\n- 교환/반품 주소지 정보 업데이트 시 사용됩니다\n\n## 주의사항\n- `id`는 교환 반품지 등록 API 또는 조회 API에서 반환된 값을 사용해야 합니다\n- 대표 교환 반품지(`isMain = true`)는 하나만 존재할 수 있습니다","operationId":"changeExchangeRefundLocation_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeExchangeRefundLocationFepRequest"}}},"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","NOT_FOUND","ACQUIRE_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ChangeExchangeRefundLocationFepResponse"}}}}}}}}}}}
```

## 교환 반품지 조회

> 가맹점이 설정한 교환 반품지 목록을 조회합니다.\
> \
> \## 사용처\
> \- 상품 등록 시 교환/반품 배송지 정보로 사용됩니다\
> \- 고객이 교환/반품 신청 시 반송할 주소 정보를 제공합니다\
> \
> \## 페이지네이션\
> \- \`size\`는 1 \~ 20 사이의 값이어야 합니다\
> \- 첫 페이지 조회 시 \`nextToken\`을 생략합니다\
> \- 다음 페이지 조회 시 응답으로 받은 \`nextToken\` 값을 그대로 전달합니다\
> \- 응답의 \`hasNext\`가 false이면 마지막 페이지입니다\
> \
> \## 교환 반품지 등록 방법\
> \- 셀러 어드민에서 등록 가능\
> \- API를 통해 등록 가능 (교환 반품지 등록 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"}},"schemas":{"GetExchangeRefundLocationFepV2Response":{"required":["hasNext","items","nextToken"],"type":"object","properties":{"items":{"type":"array","description":"교환 반품지 목록","items":{"$ref":"#/components/schemas/GetExchangeRefundLocationFepResponseItem"}},"nextToken":{"type":"string","description":"다음 페이지를 위한 토큰. 다음 페이지 조회 시 이 값을 그대로 전달"},"hasNext":{"type":"boolean","description":"다음 페이지 존재 여부. false이면 마지막 페이지"}},"description":"교환 반품지 목록 조회 응답"},"GetExchangeRefundLocationFepResponseItem":{"required":["address","detailAddress","id","isMain","zipCode"],"type":"object","properties":{"id":{"type":"integer","description":"교환 반품지 ID","format":"int64"},"zipCode":{"type":"string","description":"우편번호"},"address":{"type":"string","description":"주소"},"detailAddress":{"type":"string","description":"상세 주소"},"isMain":{"type":"boolean","description":"대표 교환 반품지 여부"}},"description":"교환 반품지 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/group-delivery/exchange-refund-location/v2":{"get":{"tags":["배송 그룹"],"summary":"교환 반품지 조회","description":"가맹점이 설정한 교환 반품지 목록을 조회합니다.\n\n## 사용처\n- 상품 등록 시 교환/반품 배송지 정보로 사용됩니다\n- 고객이 교환/반품 신청 시 반송할 주소 정보를 제공합니다\n\n## 페이지네이션\n- `size`는 1 ~ 20 사이의 값이어야 합니다\n- 첫 페이지 조회 시 `nextToken`을 생략합니다\n- 다음 페이지 조회 시 응답으로 받은 `nextToken` 값을 그대로 전달합니다\n- 응답의 `hasNext`가 false이면 마지막 페이지입니다\n\n## 교환 반품지 등록 방법\n- 셀러 어드민에서 등록 가능\n- API를 통해 등록 가능 (교환 반품지 등록 API 사용)","operationId":"getExchangeRefundLocationForFepV2","parameters":[{"name":"nextToken","in":"query","description":"다음 페이지를 위한 토큰 (직전 호출에서 받은 nextToken을 그대로 전달)","required":false,"schema":{"type":"string"}},{"name":"size","in":"query","description":"페이지 사이즈 (1 ~ 20)","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"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","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/GetExchangeRefundLocationFepV2Response"}}}}}}}}}}}
```

> ### API 연동 중 문의사항이나 개선 제안이 있으신가요?

{% hint style="info" %}
토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 [연동/개발 문의](https://discord.gg/xPz6H9NZ3P)에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://shopping-docs.toss.im/dev/api-2/delivery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.