InPost Pay - Woocommerce

Dokumentacja techniczna wtyczki InPost Pay dla Woocommerce. Wtyczka dodaje do sklepu
Woocommerce funkcjonalność dokonywania zamówień przez aplikację InPost przez:

• Dodanie tabeli w bazie danych,

• Dodanie przycisku “Utwórz koszyk z InPost Pay” na listingu produktów,

• Dodanie przycisku “Utwórz koszyk z InPost Pay” na karcie produktu,

• Dodanie przycisku “Utwórz koszyk z InPost Pay” na stronie koszyka,

• Dodanie przycisku “Utwórz koszyk z InPost Pay” na stronie zamówienia,

• Akcji wykonywanych na standardowe hook’i,

• Dodaniu pola na stronie zamówienia,

• Dodaniu sekcji administracyjnej,

• Udostępnienia REST API,

• Dołączenia do strony pliku JS serwowanego z webserwera oraz pliku serwowanego z zasobu zewnętrznego.

Wtyczka: (18.07.2023r)

Changelog:

1.0.0:

Wymagania

Do poprawnego działania wtyczka wymaga:

• PHP w wersji nie niższej niż 7.4

• Woocommerce w wersji nie niższej niż 7.3.0

Instalacja

Podczas instalacji wtyczka dodaje do bazy danych tabelę opisaną w https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/132382721/InPost+Pay+-+Woocommerce#Baza-danych.

W celu instalacji wtyczki postępuj zgodnie z poniższymi krokami:

1. Pobierz spakowaną wtyczkę Woocommerce ze strony InPost i nie rozpakowuj jej

2. Zaloguj się do sekcji administracyjnej swojego sklepu

3. Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”

   

4. Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1

   

5. Kliknij “Zainstaluj”

6. W następnym oknie kliknij “Włącz wtyczkę”

Konfiguracja Testowa

W tym rozdziale opisujemy skrócony proces konfiguracji potrzebny do przeprowadzenia testów działania integracji z InPost Pay. W celu wstępnej konfiguracji przejdź dosekcji administracyjnej sklepu i kliknij “InPost Pay” w menu po lewej stronie. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki. Wypełnij pola zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Sandbox” - w ten sposób pieniądze nie będą pobierane z konta podczas testów.
   b. Pokazuj widget ustawa na “Testerom” - w ten sposób widget będzie widoczny tylko dla osób, które mają go zobaczyć. Ustawienie innej opcji wyświetli widget działający bądź nie wszystkim osobom odwiedzającym Twój sklep
   W celu wyświetlenia widgetu w przeglądarce internetowej wpisz adres
   Twojego sklepu z dopiskiem ?showIzi=true
   Przykład: https://mojsklep.pl?showIzi=true

2. Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
   a. Client
   b. Client Secret

3. Pole POS ID wypełnij losowym ciągiem znaków (123abc)

4. Włącz możliwość płatności

5. Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale 6 Pełna konfiguracja

6. Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay

7. Połącz wysyłkę Kurierem z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Kurierem w aplikacji InPost

8. Połącz wysyłkę przez Paczkomat z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Paczkomat w aplikacji InPost

10. Określ gdzie widget powinien być dostępny na Twojej stronie
    Możesz wyświetlać go na karcie produktu oraz w koszyku
    Dla każdego miejsca wyświetlania możesz określić, do której strony przycisk InPost Pay będzie wyrównany
    Dla każdego miejsca możesz osobno wybrać, czy tło na stronie jest jasne czy ciemne co zapewnia poprawne wyświetlanie tekstów. Dla każdego miejsca możesz oddzielnie wybrać wariant wyświetlania. Przycisk może być amarantowy bądź żółty

Konfiguracja Produkcyjna

Po poprawnej konfiguracji testowej i upewnieniu się, że integracja w środowisku Sandbox działa należy udostępnić InPost Pay wszystkim użytkownikom. W celu konfiguracji przejdź do listy modułów i kliknij “Konfiguruj” obok modułu Inpost Pay. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.

Zmień konfigurację zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Produkcyjne” - w ten sposób pieniądze będą pobierane
   z konta podczas testów
   b. Pokazuj widget ustawa na “Wszystkim”

2. Pole POS ID ustaw zgodnie z umową z InPost

Produkty sugerowane

Aplikacja InPost podczas dokonywania zakupów z InPost Pay sugeruje produkty do dodania do koszyka zgodnie z wbudowanym w WooCommerce systemem Produktów Powiązanych.

Jak wyświetlić produkty sugerowane w aplikacji?

W celu pokazania produktów sugerowanych należy uzupełnić sekcję Produktów Powiązanych w konfiguracji produktu WooCommerce.

W tym celu:

1. Przejdź do edycji produktu w Twoim sklepie.

2. W panelu Dane Produktu wybierz sekcję “Powiązane produkty”.

3. Wypełnij sekcje “pu-sell” bądź “cross-sell” - produkty z obu sekcji będą widoczne w aplikacji.

Na stronie widzę produkty sugerowane a w aplikacji nie

Możliwe, że Twój sklep prezentuje produkty powiązane w niestandardowy sposób. Dzieje się tak na przykład przez to jak działa Twój szablon bądź jedna z zainstalowanych wtyczek. Jeśli Twój sklep prezentuje produkty sugerowane a nie widzisz ich w Aplikacji InPost upewnij się, że Produkty Powiązane są skonfigurowane zgodnie z instrukcją zawartą w akapicie powyżej.

Wtyczka logistyczna

InPost dostarcza dedykowaną wtyczkę do integracji z InPost dla Klientów WooCommerce. Wtyczka ta pozwala na w pełni zautomatyzowany przebieg procesu zakupowego łącznie z nadaniem numeru przesyłki i wysłaniem go do Twoich klientów przez aplikację InPost w procesie zakupowym InPost Pay.

Pobierz wtyczkę z: https://wordpress.org/plugins/inpost-for-woocommerce/

Dokumentacja: [PL] WooCommerce

Jak nadać paczkę jeśli mam wtyczkę logistyczną InPost?

Sposób wysyłki, adres oraz identyfikator paczkomatu automatycznie zostaną przekazane do wtyczki logistycznej. Ty nie musisz znać danych klienta. Musisz nadać paczkę zgodnie z instrukcją wtyczki.

Jak nadać paczkę jeśli nie mam wtyczki logistycznej InPost?

Na stronie zamówienia dokonanego przez InPost Pay dostępne są informacje mówiące o sposobie wysyłki oraz numerze paczkomatu w formie okienka. Skopiuj je i postępuj zgodnie z Twoim standardowym procesem nadawania paczek.

Konfiguracja Pełna

Konfiguracja została podzielona na sekcje umożliwiające dostosowanie działania wtyczki do potrzeb sklepu

Po instalacji wtyczki w menu po lewej stronie sekcji administracyjnej zobaczysz nowe menu “InPost Pay”

Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki

Ustawienia API

W tej sekcji ustawia się dane dostępowe do systemu, rodzaje obsługiwanych metod płatności oraz informacja wymieniane mędzy InPost Pay a sklepem

Opis dostępnych opcji:

Środowisko

Pokazuj widget

Client ID

Client Secret

POS ID

Włącz płatności zgodne z podpisaną umową z Aion

Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost

Status zamówienia dla zamówienia opłaconego przez InPost Pay

Status zamówień

Maksymalna liczba produktów sugerowanych

Zgody

Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.

Dodawanie:
Po każdym zapisie formularze będziesz mógł dodać kolejną zgodę.

Usuwanie:
W celu usunięcia zgody pozostaw jej opis pusty i zapisz formularz.

Opis dostępnych opcji:

Adres zgody

Opis wyświetlany w aplikacji

Czy wymagane

Cena transportu netto

Sekcja odpowiedzialna za mapowanie form transportu oraz określenie dostępności i cen opcji dodatkowych transportu

Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji
Poniżej generyczny opis gdzie jako typ wysyłki zostało użyte typ oraz opcja dla opcji wysyłki:

Dolicz VAT do ceny transportu

Ceny i dostępności wysyłki typ mapuj z

Opcje dla PWW oaz COD

Cena

Dostępne od

Dostępne do

Ustawienia GUI

Tu ustawisz czy i gdzie wyświetlać widget InPost Pay. Sekcja została podzielona na podsekcje odpowiadające różnym podstronom Twojego sklepu.

Opis dostępnych opcji:

Wyświetlaj

Umiejscowienie

Wyrównanie

Tło

Wariant

Margines

Wyświetlanie w niestandardowym miejscu

W celu wyświetlenia widgetu w niestandardowym miejscu użyj poniższego kodu w swoim szablonie:

\izi\InPostIzi::render(
  $productId = null,
  $name = '',
  $maskedPhoneNumber = '',
  $inpost_basket_id = '',
  $echo = true,
  $addBasketId = false,
  $variationId = '',
  $count = 0,
  $dark = false,
  $yellow = false,
  $cart = false,
  $float = 'left',
  $bindingPlace = 'BASKET_POPUP'
);

Opis parametrów:

Widok w koszyku

Po konfiguracji wtyczki w koszyku przy produktach pojawi się przycisk Utwórz koszyk z InPost Pay:

Dezinstalacja

Dezinstalacja wtyczki usuwa pliki wtyczki. Baza danych i dane nie zostają zmienione.