# 배송

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

> 주문 상품의 배송 회사와 송장번호를 변경합니다.\
> \
> \## 변경 가능 조건\
> \
> 주문 상품 상태가 다음 중 하나인 경우에만 배송정보를 변경할 수 있습니다:\
> \
> \- \*\*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 %}