설명서Commerce도구

ACP2E-4156: REST API 배송 주소 유효성 검사가 관리자 특성 구성을 무시합니다.

마지막 업데이트: 2026년 6월 23일

작성 대상:

  • Experienced
  • Admin
  • Developer

ACP2E-4156 패치는 REST API의 배송 주소 유효성 검사가 Admin에 정의된 특성 구성을 준수하지 않는 문제를 해결합니다. 이 패치는 Quality Patches Tool (QPT) 1.1.80이 설치된 경우에 사용할 수 있습니다. 패치 ID는 ACP2E-4156입니다. 이 문제는 Adobe Commerce 2.4.9에서 수정됩니다.

영향을 받는 제품 및 버전

Adobe Commerce 버전에 대한 패치가 만들어졌습니다.

  • Adobe Commerce(모든 배포 방법) 2.4.8-p4

Adobe Commerce 버전과 호환:

  • Adobe Commerce(모든 배포 방법) 2.4.8 - 2.4.8-p5
NOTE
새 Quality Patches Tool 릴리스가 있는 다른 버전에 패치를 적용할 수 있습니다. 패치가 Adobe Commerce 버전과 호환되는지 확인하려면 magento/quality-patches 패키지를 최신 버전으로 업데이트하고 Quality Patches Tool에서 호환성을 확인합니다. 패치 검색 페이지. 패치 ID를 검색 키워드로 사용하여 패치를 찾습니다.

문제

REST API에서 배송 주소 유효성 검사가 Admin에 구성된 고객 주소 특성 설정을 준수하지 않습니다.

재현 단계:

  1. 관리 패널에서 Stores > Attributes > Customer Address(으)로 이동합니다.

  2. 특성 코드 firstname(으)로 특성을 엽니다.

  3. Attribute Properties​에서 다음을 설정합니다.

    1. Input Validation: 길이만.
    2. Minimum Text Length: 1.
    3. Maximum Text Length: 20.

  4. 상점으로 이동하여 테스트 제품을 장바구니에 추가합니다.

  5. 20자를 초과하는 firstname 값으로 배송 정보를 추가하거나 업데이트하려면 REST API 요청을 /rest/default/V1/guest-carts/cartId/shipping-information에 보내십시오.

예상 결과:

firstname 값이 구성된 길이 제한을 초과함을 나타내는 오류가 반환됩니다.

실제 결과:

장바구니 배송 정보가 REST API 요청에서 보낸 firstname 값으로 업데이트되었습니다.

패치 적용

개별 패치를 적용하려면 배포 방법에 따라 다음 링크를 사용합니다.

관련 읽기

Quality Patches Tool에 대한 자세한 내용은 다음을 참조하세요.

recommendation-more-help
commerce-operations-help-tools