# 변경이력

<details>

<summary>🔄 착불배송/희망일 배송 추가 <mark style="color:$danger;">- 2026.04.20 적용 (</mark><a href="2026.04.04"><mark style="color:$danger;">변경내용 보기</mark></a><mark style="color:$danger;">)</mark><br><strong>POST</strong> /api/v3/shopping-fep/products/v2<br><strong>PUT</strong> /api/v3/shopping-fep/products/{productId}/v2<br><strong>GET</strong> /api/v3/shopping-fep/products/{productId}/v</summary>

</details>

<details>

<summary>🔄 카테고리 별 옵션 제약 조건 변경(식품), 변경 내역 첨부파일 참고 - <mark style="color:$danger;">2026-03-26</mark></summary>

{% file src="<https://1893239884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jZ0MNZGU289cgosea36%2Fuploads%2F2XZcTD2YSR6wrNlUpftH%2F0326_%E1%84%90%E1%85%A9%E1%84%89%E1%85%B3%E1%84%89%E1%85%AD%E1%84%91%E1%85%B5%E1%86%BC_%E1%84%80%E1%85%AE%E1%84%86%E1%85%A2%E1%84%8B%E1%85%A9%E1%86%B8%E1%84%89%E1%85%A7%E1%86%AB_%E1%84%89%E1%85%B5%E1%86%A8%E1%84%91%E1%85%AE%E1%86%B7.csv?alt=media&token=4484c5bd-aee4-4665-a86c-ddfed8c162fc>" %}

</details>

<details>

<summary>🔄 <strong>상품 등록/수정 API 배송 정책 변경</strong> <mark style="color:$danger;">- 2026.03.03 적용</mark> <a href="2026.03.03-phase-1"><mark style="color:$danger;">(변경내용 보기)</mark></a><br><strong>POST</strong> /api/v3/shopping-fep/products/v2<br><strong>PUT</strong> /api/v3/shopping-fep/products/{productId}/v2</summary>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>상품 품절 처리 API 제거</strong> - <mark style="color:$danger;">2025-01-13 제거 예정</mark><br>POST api/v3/products/stocks/sold-out<br>POST ap/v3/products/stocks/stock-up</summary>

[상품 옵션 정상 재고 수량 변경 API](https://shopping-docs.toss.im/dev/api-2/product#put-api-v3-shopping-fep-product-items-productitemid-stocks-normal-stock-remaining-count) 를 활용하여 품절 관리가 가능해질 예정입니다. 재고 수량을 0으로 설정하면 품절 상태가 되고, 재고 수량이 0인 상품에 대해 1 이상의 수로 설정하면 품절 상태가 취소됩니다.

<sub>- 등록: 2025-12-23 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f195">🆕</span> <strong>상품 구매 개수 제한 API 추가</strong><br><a data-mention href="../../api-2/product#post-api-v3-shopping-fep-purchase-limits">#post-api-v3-shopping-fep-purchase-limits</a><br><a data-mention href="../../api-2/product#get-api-v3-shopping-fep-purchase-limits-product-ids-productid">#get-api-v3-shopping-fep-purchase-limits-product-ids-productid</a><br><a data-mention href="../../api-2/product#delete-api-v3-shopping-fep-purchase-limits">#delete-api-v3-shopping-fep-purchase-limits</a></summary>

특정 기간동안 1인당 구매 가능한 최대 수량을 제한할 수 있습니다.

<sub>- 등록: 2025-11-25 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>주문 단건 조회</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>GET /api/v3/shopping-fep/orders/{orderId}</summary>

기존 API의 성능을 개선하기 위해 신규 API인 주문 상품 단건 조회 API로 대체되었으며, 이에따라 지원 종료될 예정입니다.

대체 : [#get-api-v3-shopping-fep-orders-products-orderproductid](https://shopping-docs.toss.im/dev/api-2/order#get-api-v3-shopping-fep-orders-products-orderproductid "mention")

<sub>- 등록: 2025-11-26 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>주문 내역 조회 v1</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>GET /api/v3/shopping-fep/orders</summary>

기존 API의 성능을 개선하기 위해 신규 API인 주문 내역 조회 v2 API로 대체되었으며, 이에따라 지원 종료될 예정입니다.

대체 : [#get-api-v3-shopping-fep-orders-v2](https://shopping-docs.toss.im/dev/api-2/order#get-api-v3-shopping-fep-orders-v2 "mention")

<sub>- 등록: 2025-11-24 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>배송 위치 (배송비 묶음 그룹) 조회 v1</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>GET /api/v3/shopping-fep/merchants/group-delivery/delivery-location</summary>

기존 API의 성능을 개선하기 위해 신규 API인 배송 위치 (배송비 묶음 그룹) 조회 v2 API로 대체되었으며, 이에따라 지원 종료될 예정입니다.

대체 : [#get-api-v3-shopping-fep-merchants-group-delivery-delivery-location-v2](https://shopping-docs.toss.im/dev/api-2/delivery#get-api-v3-shopping-fep-merchants-group-delivery-delivery-location-v2 "mention")

<sub>- 등록: 2025-11-24 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>교환 반품지 조회 v1</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>GET /api/v3/shopping-fep/merchants/group-delivery/exchange-refund-location</summary>

기존 API의 성능을 개선하기 위해 신규 API인 교환 반품지 조회 v2 API로 대체되었으며, 이에따라 지원 종료될 예정입니다.

대체 : [#get-api-v3-shopping-fep-merchants-group-delivery-exchange-refund-location-v2](https://shopping-docs.toss.im/dev/api-2/delivery#get-api-v3-shopping-fep-merchants-group-delivery-exchange-refund-location-v2 "mention")

<sub>- 등록: 2025-11-24 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>상품 변경 v1</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>PUT /api/v3/shopping-fep/products</summary>

상품 v1에 대한 지원을 종료하면서 상품 변경 v1 API에 대한 지원을 종료합니다.

대체 : [#put-api-v3-shopping-fep-products-productid-v2](https://shopping-docs.toss.im/dev/api-2/product#put-api-v3-shopping-fep-products-productid-v2 "mention")

<sub>- 등록: 2025-11-24 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>상품 조회 v1</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>GET /api/v3/shopping-fep/products/{productId}</summary>

상품 v1에 대한 지원을 종료하면서 상품 조회 v1 API에 대한 지원을 종료합니다.

대체 : [#get-api-v3-shopping-fep-products-productid-v2](https://shopping-docs.toss.im/dev/api-2/product#get-api-v3-shopping-fep-products-productid-v2 "mention")

<sub>- 등록: 2025-11-24 -</sub>

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>검수 요청하기</strong> API - <mark style="color:$danger;">2025-12-15 제거 예정</mark><br>POST /api/v3/shopping-fep/products/inspection/request</summary>

현재 별도로 검수 요청할 필요 없이 상품 등록, 수정시 자동으로 검수요청이 되게 됩니다. 따라서 해당 API가 제거될 예정입니다.&#x20;

대체 : 없음 (호출하지 않아도 됩니다)

<sub>- 등록: 2025-11-21 -</sub>

</details>