Wprowadzenie
Witamy w PunchOut Rocket!
Ten przewodnik zawiera kompleksowy opis konfiguracji konta, aby umożliwić płynną integrację PunchOut między Twoim sklepem e-commerce a systemami e-zaopatrzenia Twoich klientów.
Co to jest PunchOut Rocket?
PunchOut Rocket to oprogramowanie pośredniczące SaaS, które łączy Twoją platformę e-commerce (WooCommerce, Magento, NopCommerce lub niestandardowe rozwiązanie) z dowolnym systemem e-zaopatrzenia, wykorzystując protokoły cXML lub OCI (takie jak SAP Ariba, Coupa, Jaggaer). Umożliwia to Twoim klientom biznesowym „przejście” z ich systemu zaopatrzenia, zakupy w Twoim aktywnym sklepie e-commerce z ich cenami kontraktowymi i przeniesienie koszyka z powrotem do ich systemu w celu utworzenia zapotrzebowania na zakup — wszystko w jednym płynnym procesie.
Ten przewodnik obejmuje:
1. Zarządzanie kontem: Rejestracja i zarządzanie profilem.
2. Konfiguracja witryny e-commerce: Podłączanie sklepu i aktywacja subskrypcji.
3. Konfiguracja klienta końcowego: Ustawianie konkretnego połączenia PunchOut dla każdego z Twoich klientów.
4. Konfiguracja wtyczki platformy e-commerce: Finalizacja połączenia w Twoim sklepie.
5. Monitorowanie: Przeglądanie dzienników komunikacji.
Zarządzanie kontem
1.1. Rejestracja i pierwsze logowanie
Pierwszym krokiem jest utworzenie konta na platformie PunchOut Rocket.
1. Przejdź do https://platform.punchoutrocket.com.
2. Kliknij link „Zarejestruj się”.
3. Wypełnij formularz rejestracyjny, podając swoje imię i nazwisko, dane firmy, adres e-mail i bezpieczne hasło.
4. Kliknij „Utwórz konto”.
5. Po zarejestrowaniu zaloguj się przy użyciu swoich danych uwierzytelniających. Zostaniesz przekierowany do głównego Panelu kontrolnego.
1.2. Panel kontrolny
Panel kontrolny to Twoje centrum zarządzania. Po pierwszym zalogowaniu zobaczysz:
Kluczowe wskaźniki: Na górze zobaczysz liczniki dla skonfigurowanych „Witryn e-commerce” i „Klientów końcowych”.
Przegląd systemu: Panel powitalny, który przeprowadzi Cię przez początkowe kroki konfiguracji.
Informacje o systemie: Panel po prawej stronie podsumowujący obsługiwane środowiska, protokoły i platformy.
1.3. Zarządzanie profilem
Możesz zaktualizować swoje dane osobowe i firmowe w dowolnym momencie.
- Kliknij „Moje konto” w lewym pasku bocznym.
- Tutaj możesz modyfikować:
Informacje o użytkowniku: Imię, nazwisko i hasło. Pamiętaj, że Twój adres e-mail (nazwa użytkownika) nie może zostać zmieniony.
Informacje o firmie: Nazwa firmy i numer VAT. - Kliknij „Zapisz”, aby zastosować zmiany.
Konfiguracja witryny e-commerce
Ta sekcja obejmuje łączenie Twojego sklepu e-commerce z PunchOut Rocket.
2.1. Dodaj swoją witrynę e-commerce
Z panelu „ Rozpocznij” na głównym pulpicie nawigacyjnym:
- Kliknij przycisk „+ Dodaj swoją pierwszą witrynę e-commerce”.
- Na stronie konfiguracji wypełnij następujące dane:
Nazwa witryny: Opisowa nazwa Twojego sklepu (np. „Mój sklep B2B firmy”). Jest to dla Twojej wewnętrznej referencji.
Adres URL witryny: Pełny, poprawny adres URL Twojego sklepu e-commerce (np. „https://www.examplestore.com”).
Platforma: Wybierz platformę swojego sklepu z rozwijanego menu (np. WooCommerce). - Kliknij „Zapisz”.
2.2. Aktywuj subskrypcję
Po zapisaniu Twoja witryna jest utworzona, ale usługa nie jest jeszcze aktywna. Musisz aktywować subskrypcję, aby odblokować funkcjonalność PunchOut.
- Zostaniesz przekierowany na stronę „Edytuj witrynę e-commerce”. Status będzie wyświetlany jako Nieaktywny.
- Pojawi się komunikat informujący, że musisz „Subskrybować, aby odblokować zaawansowane opcje konfiguracji”. Kliknij zielony przycisk „+ Subskrybuj”.
- Zostaniesz bezpiecznie przekierowany do naszego operatora płatności (Stripe). Wprowadź swoje dane rozliczeniowe, aby rozpocząć subskrypcję.
- Po pomyślnej płatności zobaczysz komunikat „Płatność potwierdzona!”. Kliknij przycisk „Wróć do ustawień witryny”, aby powrócić do platformy PunchOut Rocket.
2.3. Finalizuj konfigurację witryny
WordPress – WooCommerce:
Nazwa użytkownika API:
Nazwa użytkownika API to nazwa użytkownika dla aplikacji WordPress, która jest używana do REST API. Ta nazwa użytkownika jest wymagana do uwierzytelniania żądań API między Twoją witryną e-commerce a integracją PunchOut Rocket. Wprowadź odpowiednią nazwę użytkownika, która odpowiada aplikacji WordPress (https://developer.wordpress.org/rest-api/reference/application-passwords/) skonfigurowanej do dostępu API.
Hasło API:
Hasło API to hasło powiązane z aplikacją WordPress (https://developer.wordpress.org/rest-api/reference/application-passwords/) używaną do REST API.
- Jeśli pozostawisz to pole puste, bieżące hasło pozostanie niezmienione.
- Aby zaktualizować hasło, wprowadź nowe hasło składające się z co najmniej 10 znaków.
To hasło jest kluczowe dla utrzymania bezpieczeństwa połączenia API.
Po zapisaniu hasło API zostanie zaszyfrowane ze względów bezpieczeństwa, a system pokaże jego ostatnie 4 znaki
- Numer DUNS i ANID (Ariba Network ID): Są to identyfikatory używane w protokole cXML, często wymagane przez systemy zaopatrzenia, takie jak SAP Ariba.
- Numer DUNS: Numer Data Universal Numbering System Twojej firmy.
- ANID: Twój identyfikator Ariba Network ID.
Wprowadź te wartości, jeśli Twój klient końcowy ich wymaga. Zostaną one odesłane do systemu zaopatrzenia klienta wraz z danymi koszyka.
Magento:
Nazwa użytkownika API:
Nazwa użytkownika API to nazwa użytkownika powiązana z administratorem Magento używanym dla interfejsu API REST. Ta nazwa użytkownika jest wymagana do uwierzytelniania żądań API między Twoją witryną e-commerce a integracją PunchOut Rocket.
Hasło API:
Hasło API to hasło powiązane z administratorem Magento używanym dla interfejsu API REST.
- Jeśli pozostawisz to pole puste, obecne hasło pozostanie niezmienione.
- Aby zaktualizować hasło, wprowadź nowe hasło składające się z co najmniej 10 znaków.
To hasło ma kluczowe znaczenie dla zachowania bezpieczeństwa połączenia API.
Po zapisaniu hasło API zostanie zaszyfrowane ze względów bezpieczeństwa, a system wyświetli jego ostatnie 4 znaki.
- Numer DUNS i ANID (Ariba Network ID): są to identyfikatory używane w protokole cXML, często wymagane przez systemy zamówieniowe, takie jak SAP Ariba.
- Numer DUNS: numer Data Universal Numbering System Twojej firmy.
- ANID: Twój identyfikator Ariba Network ID.
Wprowadź te wartości, jeśli Twój klient końcowy ich wymaga. Zostaną one przesłane z powrotem do systemu zamówieniowego klienta wraz z danymi koszyka.
NopCommerce:
- Klucz API: Jest to tajny klucz, który uwierzytelnia połączenie między Twoją witryną e-commerce a PunchOut Rocket.
– Kliknij przycisk „Generuj”, aby utworzyć silny, unikalny klucz.
– Musisz skopiować ten klucz i wkleić go do ustawień wtyczki PunchOut Rocket na swojej platformie e-commerce.
Po zapisaniu klucz API zostanie zaszyfrowany ze względów bezpieczeństwa, a system pokaże jego ostatnie 4 znaki. - Numer DUNS i ANID (Ariba Network ID): Są to identyfikatory używane w protokole cXML, często wymagane przez systemy zaopatrzenia, takie jak SAP Ariba.
- Numer DUNS: Numer Data Universal Numbering System Twojej firmy.
- ANID: Twój identyfikator Ariba Network ID.
Wprowadź te wartości, jeśli Twój klient końcowy ich wymaga. Zostaną one odesłane do systemu zaopatrzenia klienta wraz z danymi koszyka.
Niestandardowa platforma e-commerce:
- Klucz API: Jest to tajny klucz, który uwierzytelnia połączenie między Twoją witryną e-commerce a PunchOut Rocket.
– Kliknij przycisk „Generuj”, aby utworzyć silny, unikalny klucz.
– Musisz skopiować ten klucz i wkleić go do ustawień wtyczki PunchOut Rocket na swojej platformie e-commerce.
Po zapisaniu klucz API zostanie zaszyfrowany ze względów bezpieczeństwa, a system pokaże jego ostatnie 4 znaki. - Numer DUNS i ANID (Ariba Network ID): Są to identyfikatory używane w protokole cXML, często wymagane przez systemy zaopatrzenia, takie jak SAP Ariba.
- Numer DUNS: Numer Data Universal Numbering System Twojej firmy.
- ANID: Twój identyfikator Ariba Network ID.
Wprowadź te wartości, jeśli Twój klient końcowy ich wymaga. Zostaną one odesłane do systemu zaopatrzenia klienta wraz z danymi koszyka.
Konfiguracja klienta końcowego
„Klient końcowy” reprezentuje jedną z firm Twoich klientów łączących się za pośrednictwem PunchOut. Każdy klient końcowy ma własne unikalne ustawienia.
4.1. Utwórz nowego klienta końcowego
- Na stronie edycji swojej witryny przewiń w dół do „Powiązanych klientów końcowych”.
- Kliknij przycisk „+ Dodaj klienta końcowego”.
4.2. Ogólne ustawienia klienta końcowego
- Nazwa: Opisowa nazwa firmy Twojego klienta (np. „Global Corp Inc.”).
- Użytkownik e-commerce do sklonowania: To jest kluczowe ustawienie.
Jak to działa: Utwórz dedykowane konto użytkownika w swoim sklepie e-commerce (np. konkretną rolę użytkownika w WooCommerce). Ten użytkownik musi mieć odpowiednie uprawnienia, aby widzieć katalog produktów i ceny, do których ten konkretny klient końcowy powinien mieć dostęp. Wprowadź adres e-mail lub nazwę użytkownika tego użytkownika tutaj. Podczas sesji PunchOut dla tego klienta końcowego, PunchOut Rocket sklonuje sesję tego użytkownika, zapewniając, że dokonuje on zakupów z odpowiednimi uprawnieniami. - Protokół: Wybierz protokół używany przez ich system: cXML lub OCI.
- Domyślny UNSPSC: Standardowy kod produktów i usług ONZ. Ten kod będzie używany dla każdego produktu, który nie ma poniżej przypisanej konkretnej kategorii.
- Domyślny czas realizacji: Szacowana liczba dni na wysyłkę produktów, wysyłana dla wszystkich pozycji w koszyku.
Nadpisanie EA i nadpisanie BX: Niektóre systemy wymagają określonych jednostek miary (UOM). „EA” (Each – sztuka) i „BX” (Box – pudełko) są powszechne. Jeśli system Twojego klienta wymaga innych kodów (np. „PCE” dla „Piece” – sztuka), wprowadź wartości nadpisania tutaj.
4.3. Konfiguracja protokołu (cXML i OCI)
Wprowadź dane uwierzytelniające dostarczone przez zespół zaopatrzenia Twojego klienta. Muszą one dokładnie odpowiadać konfiguracji w ich systemie.
Dla cXML: „FormIdentity”, „SenderIdentity”, „SharedSecret” oraz zwrotny „cXML Url”.
Dla OCI: Wymagane parametry klucz-wartość OCI, w tym `Username` i `Password` oraz opcjonalne pola, które mają zostać zwrócone z koszykiem do systemu zaopatrzenia Twojego klienta.
4.4. Mapowanie kategorii
Połącz kategorie swojego sklepu ze standardowymi kodami UNSPSC.
- Kliknij „Aktualizuj z e-commerce”, aby pobrać drzewo kategorii.
- Dla każdej kategorii wprowadź, jeśli to możliwe, odpowiadający jej kod UNSPSC. Zapewnia to bogatsze dane dla systemu zaopatrzenia Twojego klienta.
Konfiguracja wtyczki platformy e-commerce
Ostatnim krokiem jest zainstalowanie i skonfigurowanie wtyczki PunchOut Rocket w Twoim sklepie.
- Pobierz i zainstaluj wtyczkę PunchOut Rocket dla swojej platformy (WooCommerce, NopCommerce, Magento lub Custom w przypadku niestandardowych integracji).
- Przejdź do strony ustawień wtyczki w panelu administracyjnym Twojego e-commerce.
- Skopiuj Klucz API wygenerowany w PunchOut Rocket (Sekcja 3.3) i wklej go w odpowiednie pole w ustawieniach wtyczki.
- Zapisz ustawienia. Twój sklep jest teraz gotowy do odbierania żądań PunchOut.
Monitorowanie: Dzienniki komunikacji
PunchOut Rocket rejestruje wszystkie transakcje w celu łatwego rozwiązywania problemów.
- Na stronie konfiguracji klienta końcowego kliknij przycisk „Sprawdź dzienniki”.
- Przeglądarka dzienników pokazuje wszystkie żądania PunchOut, transmisje koszyka i wszelkie błędy. Możesz sprawdzić pełny XML/dane dla każdej transakcji, co ułatwia debugowanie problemów z połączeniem.