Integratie van UPS-verzendmethoden van SOAP naar RESTful API
Nota : Als u om het even welke drie flarden van dit artikel voorafgaand aan Juni 6, 2024 uploadde: als u dit probleem wegens Metrische metingen System/SI (kilo en centimeters) wegens niet wordt gebruikt onder ogen ziet, zou u één van deze nieuwe, bijgewerkte die flarden opnieuw moeten toepassen nu in dit artikel voor uw 2.4.4.4.4+/2.4 5+/2.4.6+ versie van Adobe Commerce/Magento Open Source opnieuw, omdat anders u niet de Metrische metingen van het Systeem/SI van kilo en centimeters in de UPS verschepende methodes in de configuratie Admin kunt selecteren. Deze nieuwe patches zijn compatibel met de eerder vrijgegeven patches. Deze kwestie zal permanent in werkingsgebied van aanstaande versie van Adobe Commerce 2.4.7-p1 gepland voor Juni 11, 2024 worden bevestigd.
Nota : Als u om het even welke drie flarden van dit artikel voorafgaand aan 10 oktober, 2023 uploadde, zou u één van deze die flarden opnieuw moeten toepassen nu in dit artikel voor uw 2.4.4+/2.4.5+/2.4.6+ versie van Adobe Commerce/Magento Open Source worden gepubliceerd, omdat anders u niet zult kunnen selecteren en vormen specifieke UPS die methodes in de Admin configuratie verschepen, en u zult alle toegelaten moeten hebben. Deze nieuwe patches zijn compatibel met de eerder vrijgegeven patches.
Dit artikel bevat een patch voor het oplossen van problemen met de integratie van de verzendmethode van United Parcel Service (UPS) van SOAP naar RESTful API voor Adobe Commerce 2.4.4 - 2.4.6-pX.
Beginnend in Juni 2024 , zullen de handelaars van Adobe Commerce niet met onze huidige integratie van UPS kunnen communiceren, zodat geven wij deze hotfix vrij, die Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ verkopers toestaat om aan recentste UPS REST APIs te migreren.
Dit probleem wordt opgelost in Adobe Commerce/Magento Open Source versie 2.4.7 en de oplossing wordt ook opgenomen in de 2.4.7-bèta2-release in oktober 2023.
Beschrijving description
Betrokken producten en versies
Adobe Commerce op cloudinfrastructuur en op locatie, en Magento Open Source:
- 2.4.4.
- 2.4.4-pX
- 2.4.5.
- 2.4.5-pX
- 2.4.6.
- 2.4.6-pX
Oorzaken
UPS vrijgegeven a veiligheidsupdate voor hun API.
Als u de Europese Unie hebt (andere oorsprong kan hetzelfde probleem ervaren) als de oorsprong van de verzending, zal dit een fout veroorzaken in het UPS REST-verzoek:
"Een zending kan geen KGS/IN of LBS/CM of OZS/CM als maateenheid hebben."
Resolutie resolution
Volgens de recentste updates aan het Model van de Veiligheid van UPS API, heeft UPS een OAuth 2.0 veiligheidsmodel voor alle APIs (Meer details beschikbaar in de Belangrijkste Gids van de Migratie van de Toegang van het Portaal van de Ontwikkelaar van UPS) uitgevoerd om de algemene veiligheid te verbeteren om fraude te verminderen en verbeterde API mogelijkheden te verstrekken.
Deze wijziging is van invloed op onze huidige implementatie van de UPS-integratie in Adobe Commerce en vereist dat we onze huidige implementatie herstellen en van SOAP API naar de RESTful-API migreren om OAuth 2.0-verificatieprotocollen te kunnen ondersteunen.
Oplossing
Gebruik de volgende bijgevoegde patches, afhankelijk van uw Adobe Commerce/Magento Open Source-versie:
Als u het probleem wilt verhelpen in de 2.4.4±, 2.4.5± en 2.4.6±versies, moet u de corresponderende patch toepassen op de onderstaande versie van Adobe Commerce/Magento Open Source.
Reparatie
Gebruik de volgende bijgevoegde patches, afhankelijk van uw Adobe Commerce/Magento Open Source-versie:
Voor versies 2.4.4, 2.4.4-pX:
Voor versies 2.4.5, 2.4.5-pX:
Voor versies 2.4.6, 2.4.6-pX:
Hoe de pleister aanbrengen
Pak het dossier uit en zie hoe te om een componentenflard toe te passen die door Adobein onze basis van steunkennis voor instructies wordt verstrekt.
Hoe te om te bepalen of de pleisters zijn aangebracht
Aangezien het niet mogelijk is om gemakkelijk te controleren of de kwestie werd gepatenteerd, zou u kunnen willen controleren of de flard met succes is toegepast. Dit gebruikt (bijvoorbeeld: AC-9363) als de patch die moet worden gecontroleerd.
u kunt dit doen door de volgende stappen te nemen:
-
Installeer het Hulpmiddel van de Patches van de Kwaliteit.
-
Voer de opdracht uit:
vendor/bin/magento-patches -n status |grep "9363|Status" -
U zou output gelijkend op dit moeten zien, waar AC-9363 de Toegepaste status terugkeert:
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
Na aanbrengen van de pleister
Stap 1: Creeer een App van UPS in het Portaal van de Ontwikkelaar van UPS
Als u de UPS REST-API wilt gebruiken, moet u een app maken in het UPS Developer Portal om de vereiste referenties te genereren (client-id en clientgeheim). Voer de volgende stappen uit:
-
Login aan het Portaal van de Ontwikkelaar van UPS
- Navigeer aan https://developer.ups.com/.
- U kunt zich aanmelden met uw UPS-accountgegevens. Als u geen rekening hebt, klik Teken omhoog knoop om tot één te leiden.
-
creeer een Nieuwe Toepassing
- Zodra het programma geopend, ga naar het dashboard en klik creeer Toepassing .
- Geef een naam op voor uw toepassing (bijvoorbeeld Adobe Commerce UPS Integration).
-
selecteer Vereiste APIs
-
Selecteer tijdens het maken van de app de API's die uw app zal gebruiken wanneer hierom wordt gevraagd. Zorg ervoor dat u het volgende opgeeft:
- Tarief API : Voor het halen van het verschepen tarieven.
- Tijd in Doorvoer API : Voor de ramingen van de leveringstijd.
- Om het even welke andere APIs relevant voor uw het verschepen behoeften (bijvoorbeeld, het Volgen API , als toepasselijk).
-
-
vastgestelde Toestemmingen
- Zorg ervoor dat de vereiste machtigingen voor de geselecteerde API's zijn ingeschakeld voor de toepassing.
- Dit gebeurt gewoonlijk tijdens het maken van apps, maar u kunt machtigingen later in de app-instellingen bekijken en bijwerken.
-
produceer Referenties
- Nadat app wordt gecreeerd, navigeer aan de sectie van Referenties .
- Kopieer identiteitskaart van de Cliënt en Geheime Cliënt . Deze worden gebruikt om de UPS REST-integratie in Adobe Commerce te configureren.
- Nota: houd deze geloofsbrieven veilig en deel hen niet openbaar.
-
Test App
- Gebruik de testprogramma's van de UPS Developer Portal om te controleren of uw app correct werkt en om gegevens van de geselecteerde API's op te halen.
Stap 2: Vorm UPS REST in Adobe Commerce
Als u de client-id en het clientgeheim hebt, gaat u verder met het configureren van de UPS REST-integratie in Adobe Commerce.
Zorg ervoor om Type van UPS te selecteren = "Verenigde REST van de Dienst van het Pakket".