AC-15210: Web Tools API에서 새로운 RESTful USPS API로 USPS 통합 마이그레이션
AC-15210 패치는 Adobe Commerce의 기존 미국 우편 서비스(USPS) 웹 도구 API 통합을 새로 도입된 USPS REST API로 전환합니다. 이 패치는 Quality Patches Tool (QPT) 1.1.70이 설치된 경우에 사용할 수 있습니다. 패치 ID는 AC-15210입니다.
영향을 받는 제품 및 버전
Adobe Commerce 버전에 대한 패치가 만들어졌습니다.
- Adobe Commerce 및 Magento Open Source(모든 배포 방법) 2.4.6-p3 - 2.4.8
magento/quality-patches 패키지를 최신 버전으로 업데이트하고 Quality Patches Tool에서 호환성을 확인합니다. 패치 검색 페이지. 패치 ID를 검색 키워드로 사용하여 패치를 찾습니다.문제
Adobe Commerce은 현재 Web Tools API를 사용하여 USPS 배송 기능과 통합하고 있습니다.
USPS는 2026년 1월 25일에 기존 Web Tools API를 폐기할 예정입니다. 이러한 API는 현재 주소 위생, 패키지 추적, 배송 증명, 픽업 예약, 세관 양식, 요금 확인, 서비스 표준, 우편 시설 정보 및 택배 보관함 위치와 같은 서비스를 지원합니다.
Adobe Commerce 버전 2.4.6, 2.4.7 및 2.4.8은 즉시 사용 가능한 배송 통합을 위해 USPS Web Tools API를 사용합니다. 사용 중지 날짜 이후, 이러한 통합은 새로운 USPS REST API로 마이그레이션되지 않는 한 작동하지 않습니다.
솔루션
2026년 1월 이후에도 USPS 통합을 계속 사용하려면 버전 2.4.6, 2.4.7 및 2.4.8의 Adobe Commerce 고객이 AC-15210 패치를 설치해야 합니다.
패치 적용
개별 패치를 적용하려면 배포 방법에 따라 다음 링크를 사용합니다.
- Adobe Commerce 또는 Magento Open Source 온-프레미스: Quality Patches Tool 가이드의 > 사용량Quality Patches Tool
- 클라우드 인프라의 Adobe Commerce: Commerce on Cloud Infrastructure 안내서의 업그레이드 및 패치 > 패치 적용.
패치를 적용한 후 Commerce USPS Shipping Carrier 구성을 업데이트하여 새 USPS API와 통합합니다. 지침은 스토어 및 구매 경험 안내서의 USPS 웹 도구 사용 중단 항목을 참조하십시오.
관련 읽기
Quality Patches Tool에 대한 자세한 내용은 다음을 참조하세요.