Checkout dla Miva

W ciągu 24 godzin od rejestracji skontaktuje się z Tobą dedykowany przedstawiciel ds. wdrażania, aby rozpocząć dostosowany proces integracji.

Ważne: Kroki wymienione poniżej są dla Twojej informacji i będziesz przez nich przeprowadzony/-a przez reprezentanta wdrażania.

1. Pobierz moduł ze sklepu Miva App Store lub poproś Zonos bezpośrednio o plik zonos.mvc.
2. W panelu administracyjnym Miva przejdź do Ustawienia domeny -> Moduły -> Dodaj moduł, prześlij plik zonos.mvc i kliknij Dodaj.

3. Przejdź do Ustawienia -> Moduły, znajdź Zonos i kliknij Zainstaluj. Sprawdź, czy widnieje status Zainstalowano.

W Miva przejdź do Użytkownicy -> Tokeny API i kliknij Dodaj token API. Skonfiguruj go w następujący sposób:

• Nazwa: Zonos Checkout
• Dozwolone adresy IP: 0.0.0.0/0, ::/0
• Podpis: Wymagaj podpisu z kluczem -- kliknij Generuj, aby utworzyć klucz podpisujący
• Znacznik czasu: Wymagaj znacznika czasu w ciągu 30 sekund

Na następnym ekranie włącz opcję Customer Service & Sales, aby zezwolić tokenowi na tworzenie i modyfikowanie zamówień. Kliknij Zapisz.

Przejdź do modułu Checkout w Miva, klikając Miva -> Ustawienia narzędziowe -> Zonos, a następnie wypełnij następujące pola:

1. ID sklepu: Skopiuj swój numer konta Zonos z Dashboard -> Ustawienia -> Konto -> Integracje.
2. Klucz API Zonos: Twój tajny klucz API (nigdy go nie udostępniaj).
3. Klucz publiczny Zonos: Twój klucz publiczny.
4. Waluta sklepu: Waluta bazowa Twojego sklepu (np. USD).
5. Środowisko: Wybierz Live dla środowiska produkcyjnego lub Test do celów testowych.
6. Selektor przycisku Checkout: Selektor CSS dla przycisku Checkout (przykład: a[href*="checkout.html"]).
7. Ukryte selektory: Do ukrywania krajowych opcji płatności i innych szczegółów, które mogą nie dotyczyć klientów międzynarodowych.
8. Importuj zamówienia: Zaznacz, aby automatycznie importować zrealizowane zamówienia Zonos do panelu administracyjnego Miva. Wymaga to zarejestrowania webhooków w następnym kroku.

Kliknij Aktualizuj w prawym górnym rogu, aby zapisać przed kontynuowaniem.

Zamówienia są importowane za pomocą webhooka w module 10.x. Poprzednie wersje modułu korzystały zamiast tego z adresu URL/punktu końcowego powodzenia zamówienia.

Po zapisaniu ustawień kliknij Zarejestruj webhooki. Dzięki temu Twój sklep zostanie połączony z Zonos, dzięki czemu zrealizowane zamówienia będą automatycznie importowane, anulowania będą synchronizowane, a aktualizacje wysyłki będą przekazywane z powrotem do Miva.

Webhooki muszą zostać zarejestrowane, zanim zadziała import zamówień, synchronizacja anulowań oraz aktualizacje wysyłki. Pole wyboru Importuj zamówienia wymaga zarejestrowania webhooków.

Przewiń w dół, aby uzupełnić pozostałe pola:

1. Miva API Token: Access Token z tokenu API utworzonego w kroku Utwórz token API.
2. Miva API Signature: Signing Key z tego samego wpisu tokenu API.
3. Typ obrazu: Określa, jaki rozmiar obrazu produktu jest wyświetlany w Zonos Checkout (dla większości sklepów sprawdza się Główny).
4. Dodatkowe mapowania pól: Opcjonalnie mapuj niestandardowe pola Miva na atrybuty/metadane Zonos (kolor, materiał, rozmiar itd.). Zalecamy mapowanie kodu HS, jeśli ustawiłeś kody HS specyficzne dla produktu w swoich listach produktów Miva. Nie jest to wymagane do wygenerowania wyceny obowiązków i podatków, ponieważ możemy używać kodów HS specyficznych dla produktu, które wpisałeś w Catalog, lub Twojego domyślnego kodu HS. Jest to jednak zalecane -- dokładność obliczeń Landed Cost znacznie wzrośnie przy prawidłowo sklasyfikowanych produktach. Aby zmapować pole w Miva, utwórz niestandardowe pole dla kodu HS, a następnie zmapuj je w Ustawieniach narzędziowych -> Zonos.

Kliknij Aktualizuj, aby zapisać wszystkie ustawienia.

Teraz, gdy skonfigurowałeś swoje konto i moduł, możesz przetestować, wykonując następujące czynności:

• Testuj wyceny wysyłki
• Złóż testowe zamówienie na Twojej witrynie
• Testuj przepływ zamówień w Twoich systemach
• Testuj swoją witrynę

Dowiedz się, jak przeprowadzić te testy. Podczas testowania musisz ustawić pole Środowisko modułu na Test.

Po zakończeniu testowania jesteś teraz gotów do uruchomienia na żywo! Ustaw Środowisko na Live, potwierdź, że Twoje dane uwierzytelniające Zonos są prawidłowe, i upewnij się, że webhooki są zarejestrowane na Twoim sklepie produkcyjnym.

1. Przejdź do dashboard.zonos.com -> Hello -> Hello Settings.
2. Włącz opcję Currency behavior.
3. Wprowadź selektor CSS, który wskazuje elementy cen produktów (np. .price).

Gdy ta opcja jest włączona, Zonos Hello automatycznie przelicza i wyświetla ceny w lokalnej walucie kupującego.

Wymiary wysyłkowe, kraj pochodzenia i kod HS ustawione w katalogu Miva są automatycznie mapowane do Zonos i wykorzystywane do wyceny Landed Cost / wysyłki, jeśli zostały uzupełnione. Nie jest wymagane dodatkowe mapowanie do skonfigurowania.

Jeśli Twój sklep sprzedaje produkty konfigurowalne, w których wszystkie warianty współdzielą jeden SKU, standardowe Product Shipping Rules Miva przechowują jeden zestaw wymiarów na produkt, więc każda konfiguracja jest traktowana jako ten sam rozmiar niezależnie od tego, co wybrał klient.

Miva i Zonos obsługują wymiary na poziomie wariantu, ale wymaga to skonfigurowania każdego wariantu osobno. Może to być niepraktyczne w przypadku sklepów z setkami lub tysiącami konfiguracji, które nie odpowiadają odrębnym wariantom.

Ta funkcja rozwiązuje ten problem, odczytując wymiary dla każdej konfiguracji bezpośrednio z koszyka podczas checkoutu, wykorzystując dowolną niestandardową logikę, którą Twój sklep już posiada do ich obliczania -- na przykład analizując wymiary z opisu produktu.

Wymagania

• Twój sklep musi już wypełniać niestandardowe kolumny wymiarów w pozycjach koszyka podczas dodawania produktów do koszyka (obsługiwane po stronie Miva, poza zakresem modułu Zonos).
• Musisz znać dokładne nazwy używanych kolumn.

Konfiguracja

Wprowadź te nazwy kolumn w trzech odpowiednich polach w panelu administracyjnym modułu Zonos. Pozostaw je puste, aby korzystać ze standardowych Product Shipping Rules -- funkcja jest w pełni opcjonalna i nie wpływa na sklepy, które z niej nie korzystają.

Gdy w Zonos Dashboard zostanie utworzona etykieta wysyłkowa lub wprowadzony numer śledzenia, numer śledzenia i status przesyłki są automatycznie przekazywane do odpowiadającego zamówienia w panelu administracyjnym Miva. Wymaga to zarejestrowania webhooków (zobacz krok Zarejestruj webhooki powyżej).

Śledzenie można również wprowadzić bezpośrednio w Miva. Użyj okna dialogowego Enter Tracking Number przy dowolnym zamówieniu Zonos -- numer śledzenia i status przesyłki zsynchronizują się automatycznie z powrotem do Zonos Dashboard.

Dziennik debugowania jest dostępny wewnątrz panelu administracyjnego Miva, w ustawieniach modułu Zonos. Rejestruje pełny cykl życia każdego zdarzenia zamówienia przetwarzanego przez moduł -- importy, synchronizacje śledzenia, anulowania oraz wychodzące żądania anulowania do Zonos -- w tym zarówno sukcesy, jak i błędy w jednym miejscu.

Każdy wpis zawiera identyfikator zamówienia Zonos, identyfikator zamówienia Miva oraz, w stosownych przypadkach, szczegóły na poziomie klienta, takie jak odpowiedź błędu z API Miva lub Zonos. Dzięki temu jest to najpełniejsze źródło informacji do diagnozowania problemów.

Dziennik przechowuje tylko 500 najnowszych wierszy. Starsze wpisy nie są archiwizowane, dlatego sprawdź go niezwłocznie po wystąpieniu problemu -- wcześniejsze zdarzenia mogły już zostać nadpisane.

Publiczny dziennik błędów (bez wymaganego logowania) 

Dostępny jest również drugi, publiczny dziennik pod bezpośrednim adresem URL -- bez konieczności logowania do panelu administracyjnego Miva. Rejestruje on wyłącznie błędy (bez sukcesów) i nie zawiera danych osobowych klientów ani innych danych wrażliwych. Każdy wpis jest poprzedzony wersją modułu (np. [v10.09]) dla szybkiej identyfikacji.

Format adresu URL:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Przykład:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Kod sklepu: Wartość miva_store_code jest zwracana w tablicy metadanych w odpowiedzi API dla wszystkich zamówień z Dashboard.

Wszystkie zwroty płatności muszą być przetwarzane bezpośrednio w Zonos Dashboard. Przyciski Refund, Capture i Void w Miva są celowo niedostępne dla zamówień zaimportowanych z Zonos. Żadne zwroty przetworzone w Zonos nie zaktualizują automatycznie kwot płatności na odpowiadającym zamówieniu Miva -- zamówienie Miva zachowuje pierwotnie pobrane kwoty i nie jest synchronizowane z działaniami zwrotowymi w Zonos.

W przypadku anulowania zamówień zachowanie zależy od bieżącego statusu zamówienia:

• Open (jeszcze nie wysłane): Anulowanie w Miva spowoduje również anulowanie w Zonos oraz unieważnienie autoryzacji płatności. Ponieważ Zonos nie pobiera płatności do momentu wysyłki zamówienia, klient nigdy nie zostaje faktycznie obciążony i nie jest wymagany osobny zwrot.
• Shipped lub Completed: Anulowanie w Miva oznaczy zamówienie Miva jako anulowane, ale Zonos odrzuci anulowanie, ponieważ zamówienie zostało już zrealizowane i nie kwalifikuje się już do automatycznego anulowania. W takim przypadku do zamówienia Miva dodawana jest notatka widoczna wyłącznie dla administratora -- widoczna tylko dla pracowników sklepu i nigdy dla klienta -- wyjaśniająca, że zamówienie musi zostać obsłużone w Zonos. Wysyłane jest również powiadomienie e-mail na główny adres e-mail konta sklepu, informujące sprzedawcę o konieczności podjęcia działania w Zonos Dashboard, gdzie może ręcznie przetworzyć odpowiedni zwrot.

Objaw: Zamówienia kończą się powodzeniem w Zonos Checkout i pojawiają się w Zonos Dashboard, ale nic nie pojawia się w panelu administracyjnym Miva.

Przyczyna: Zonos wysyła webhook ORDER_CREATED (HTTP POST) do punktu końcowego /mm5/json.mvc Twojego sklepu. Na witrynach deweloperskich zabezpieczenia na poziomie serwera często blokują to żądanie, zanim dotrze ono do Miva. Najczęstsze przyczyny:

• HTTP Basic Auth -- Jeśli witryna deweloperska wyświetla monit o hasło (Plesk, cPanel, .htaccess itp.), webhook zostaje odrzucony z błędem 401 Unauthorized. Dodaj adresy IP Zonos do białej listy w konfiguracji .htaccess lub Plesk, aby ominęły monit uwierzytelniania.
• Cloudflare WAF / IP Access Rules -- Jeśli witryna korzysta z proxy Cloudflare, jej reguły zabezpieczeń mogą blokować żądanie POST, zanim dotrze ono do Twojego serwera. Dodaj regułę WAF zezwalającą na żądania POST, w których ścieżka URL zawiera /mm5/json.mvc, lub dodaj adresy IP Zonos bezpośrednio do białej listy w Cloudflare IP Access Rules.
• Lista dozwolonych adresów IP na poziomie serwera -- Jeśli witryna deweloperska ogranicza ruch tylko do określonych adresów IP (typowe dla środowisk staging zablokowanych do adresów IP biura lub platformy), żądania webhook Zonos są po cichu odrzucane bez odpowiedzi. Dodaj wszystkie adresy IP dostarczania webhooków Zonos do białej listy Twojego serwera (Plesk IP Access Restriction Manager, cPanel IP Blocker lub reguły zabezpieczeń zapory/panelu hostingowego).

Adresy IP dostarczania webhooków Zonos

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Zwykle dotyczy to tylko witryn dev/staging -- produkcyjne witryny Miva są zazwyczaj publiczne i nie wymagają dodawania adresów IP do białej listy. Jeśli nie masz pewności, jak to skonfigurować, skontaktuj się z dostawcą hostingu lub wsparciem Miva.

Informacje o produkcie mogą wpłynąć na wysokość obowiązków i podatków oraz koszt wysyłki. Im więcej informacji o produkcie podasz Zonos, tym bardziej precyzyjna będzie zwrócona wycena. Zonos może wygenerować wycenę nawet, gdy informacje te są niedostępne, ale zaleca podanie następujących kluczowych szczegółów produktu w celu poprawy dokładności:

• Waga: Waga wpływa na koszt wysyłki, co może wpłynąć na obowiązki lub podatki. Wagi w listach produktów Miva są automatycznie używane przez Zonos, gdy są obecne.
• Wymiary: Wymiary mogą wpłynąć na koszt wysyłki, co może wpłynąć na obowiązki lub podatki. Zonos może wykorzystać wymiary produktu (długość, szerokość i wysokość) ustawione dla każdego produktu w Miva, ale musisz go mapować w aplikacji Zonos w celu prawidłowej integracji.
• Kody HS: Kody HS wpływają na stawki obowiązków i czasami mogą wpłynąć na podatki. Zonos może używać kodów HS ustawionych w listach produktów w Miva, ale musisz mapować pole kodu HS w aplikacji Zonos.
• Kraj pochodzenia: Kraj pochodzenia produktu wpływa na stawki obowiązków i może wpłynąć na podatki. Miva nie może wysyłać kraju pochodzenia dla Twoich produktów do Zonos, dlatego należy je dodać za pomocą Zonos Catalog.

Szczegóły produktu przekazane do Zonos przez Miva 

Uwaga: Alternatywnie możesz wprowadzić dowolne z powyższych informacji do Catalog, zastępując informacje przechowywane i przekazywane z Miva.

Dowiedz się więcej na temat informacji o produkcie według platformy.