설명서

SOAP에서 RESTful API로 UPS 배송 방법 통합 마이그레이션

Last update: Tue Aug 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

참고: 2024년 6월 6일 이전에 이 문서에서 세 개의 패치를 업로드한 경우: 지표 시스템/SI 측정(킬로그램 및 센티미터)을 사용하지 않아 이 문제가 발생하는 경우 관리 구성 의 UPS 배송 방법에서 킬로그램 및 센티미터 의 지표 시스템/SI 측정을 선택할 수 없으므로 Adobe Commerce/Magento Open Source의 2.4.4+/2.4.5+/2.4.6+ 버전에 대해 이 문서에 게시된 새로 업데이트된 패치 중 하나를 다시 적용해야 합니다. 이러한 새 패치는 이전에 릴리스된 패치와 호환됩니다. 이 문제는 2024년 6월 11일 에 예정된 Adobe Commerce 버전 2.4.7-p1 릴리스의 범위에서 영구적으로 수정됩니다.

참고: 2023년 10월 10일 전에 이 문서에서 세 개의 패치를 업로드한 경우, 이제 이 문서에 게시된 패치 중 하나를 Adobe Commerce/Magento Open Source의 2.4.4+/2.4.5+/2.4.6+ 버전에 대해 다시 적용해야 합니다. 그렇지 않으면 관리자 구성 에서 특정 UPS 배송 방법을 선택하고 구성할 수 없으므로 이러한 패치를 모두 활성화해야 합니다. 이러한 새 패치는 이전에 릴리스된 패치와 호환됩니다.

이 문서에서는 Adobe Commerce 2.4.4 - 2.4.6-pX용 SOAP에서 RESTful API로의 United Parcel Service(UPS) 배송 방법 통합 마이그레이션으로 문제를 해결하는 패치를 제공합니다.

2024년 6월부터 에서는 Adobe Commerce 판매자가 현재 UPS 통합과 거래할 수 없으므로 Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ 판매자가 최신 UPS REST API로 마이그레이션할 수 있는 이 핫픽스를 출시합니다.

이 문제는 Adobe Commerce/Magento Open Source 버전 2.4.7에서 수정되며, 이 수정 사항은 2023년 10월 2.4.7-beta2 릴리스에도 포함될 예정입니다.

설명 description

영향을 받는 제품 및 버전

Adobe Commerce on cloud infrastructure and on-premise 및 Magento Open Source:

  • 2.4.4
  • 2.4.4-pX
  • 2.4.5
  • 2.4.5-pX
  • 2.4.6
  • 2.4.6-pX

원인

UPS에서 API에 대한 보안 업데이트를 릴리스했습니다.

유럽 연합 (다른 출처가 동일한 문제를 경험할 수 있음)이 선적 출처와 동일한 경우 UPS REST 요청에 오류가 발생합니다.
"배송 시 측정 단위로는 KGS/IN 또는 LBS/CM 또는 OZS/CM를 포함할 수 없습니다."

해결 방법 resolution

UPS API 보안 모델에 대한 최신 업데이트에 따르면 UPS는 모든 API에 대해 OAuth 2.0 보안 모델을 구현했습니다(UPS 개발자 포털 액세스 키 마이그레이션 안내서에서 제공하는 자세한 내용).

이 변경 사항은 Adobe Commerce의 현재 UPS 배송 방법 통합 구현에 영향을 미치며, 현재 구현을 수정하고 OAuth 2.0 인증 프로토콜을 지원할 수 있도록 SOAP API에서 RESTful API로 마이그레이션해야 합니다.

솔루션

Adobe Commerce/Magento Open Source 버전에 따라 다음과 같이 첨부된 패치를 사용하십시오.

2.4.4+, 2.4.5+ 및 2.4.6+ 버전에서 문제를 해결하려면 아래 Adobe Commerce/Magento Open Source 버전에 해당 패치를 적용해야 합니다.

패치

Adobe Commerce/Magento Open Source 버전에 따라 다음과 같이 첨부된 패치를 사용하십시오.

2.4.4, 2.4.4-pX 버전의 경우:

2.4.5, 2.4.5-pX 버전의 경우:

2.4.6, 2.4.6-pX 버전의 경우:

패치 적용 방법

파일의 압축을 풀고 지침이 필요하면 지원 기술 자료에서 Adobe에서 제공하는 작성기 패치를 적용하는 방법을 참조하십시오.

패치가 적용되었는지 확인하는 방법

문제가 패치되었는지 쉽게 확인할 수 없는 점을 고려하면 패치가 정상적으로 적용되었는지 확인할 수 있습니다. 확인할 패치로 (예: AC-9363) 를 사용합니다.

다음 단계를 수행하여 이 작업을 수행할 수 있습니다.

  1. 품질 패치 도구를 설치하십시오.

  2. 명령 실행: vendor/bin/magento-patches -n status |grep "9363|Status"

  3. 다음과 유사한 출력이 표시되어야 합니다. 여기서 AC-9363은 적용됨 상태를 반환합니다.

    code language-none 
    ║ Id│ Title│ Category │ Origin│ Status│ Details║    ║ N/A │ ../m2-hotfixes/AC-9363_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.patch │ Other│ Local│ Applied│ Patch type: Custom

패치 적용 후

1단계: UPS 개발자 포털에서 UPS 앱 만들기

UPS REST API를 사용하려면 UPS 개발자 포털에서 앱을 만들어 필요한 자격 증명(클라이언트 ID 및 클라이언트 암호)을 생성해야 합니다. 다음 단계를 수행하십시오.

  1. UPS 개발자 포털에 로그인

    • https://developer.ups.com/.​(으)로 이동
    • UPS 계정 자격 증명을 사용하여 로그인하십시오. 계정이 없는 경우 등록 단추를 클릭하여 계정을 만드십시오.

  2. 새 응용 프로그램 만들기

    • 로그인한 후 대시보드로 이동하여 응용 프로그램 만들기 를 클릭합니다.
    • 애플리케이션의 이름을 입력합니다(예: Adobe Commerce UPS 통합).

  3. 필요한 API 선택

    • 앱 생성 프로세스 중에 메시지가 표시되면 앱에서 사용할 API를 선택합니다. 다음을 포함해야 합니다.

      • 속도 API: 배송 속도를 가져옵니다.
      • 전송 중 시간 API: 배달 예상 시간입니다.
      • 배송 요구 사항과 관련된 다른 모든 API(예: 추적 API(해당하는 경우).

  4. 권한 설정

    • 앱에 선택한 API에 대해 필요한 권한이 활성화되어 있는지 확인합니다.
    • 이 작업은 일반적으로 앱 생성 중에 수행되지만 나중에 앱 설정에서 권한을 검토하고 업데이트할 수 있습니다.

  5. 자격 증명 생성

    • 앱을 만든 후 자격 증명 섹션으로 이동합니다.
    • 클라이언트 ID 및 클라이언트 암호 를 복사합니다. Adobe Commerce에서 UPS REST 통합을 구성하는 데 사용됩니다.
    • 참고: 이러한 자격 증명을 안전하게 유지하고 공개적으로 공유하지 마십시오.

  6. 앱 테스트

    • UPS 개발자 포털의 테스트 도구를 사용하여 앱이 올바르게 작동하는지 확인하고 선택한 API에서 데이터를 가져올 수 있습니다.

2단계: Adobe Commerce에서 UPS REST 구성

클라이언트 ID와 클라이언트 암호가 있으면 Adobe Commerce에서 UPS REST 통합 구성을 계속 진행하십시오.

UPS 유형 = "United Parcel Service REST"를 선택하십시오.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f