WooCommerce

Integracja z WooCommerce pobiera do Ritevo zamówienia z Twojego sklepu na WordPressie. Podłączasz ją kluczami REST API wygenerowanymi w panelu WooCommerce. Ponieważ sklepy na WooCommerce różnią się wtyczkami, sam ustawiasz, jak statusy, metody płatności i pola dodane przez wtyczki (NIP, punkt odbioru) mają być czytane w Ritevo.

Ten sam sklep WooCommerce podłączysz tylko raz. Gdy dodasz go ponownie, Ritevo odświeży istniejącą integrację i włączy ją z powrotem, nawet jeśli była usunięta.

Jak wygenerować klucz API

Klucze tworzysz w panelu WordPress swojego sklepu. Skopiuj oba od razu - wkleisz je w Ritevo przy dodawaniu integracji.

1. Zaloguj się do panelu WordPress i w menu po lewej wybierz WooCommerce, potem Ustawienia.
2. Otwórz zakładkę Zaawansowane, a w niej REST API. Kliknij Dodaj klucz.
3. W polu Opis wpisz dowolną nazwę, na przykład „Ritevo". W polu Użytkownik wybierz konto administratora sklepu.
4. W polu Uprawnienia wybierz Odczyt/Zapis - najwyższe dostępne - i kliknij Wygeneruj klucz API.
5. Skopiuj Klucz klienta (Consumer Key) i Sekret klienta (Consumer Secret).

Podłączenie konta

Zacznij w Ritevo:

1. Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
2. W sekcji Sklepy internetowe wybierz kafelek WooCommerce.
3. W polu Nazwa konta wpisz własną nazwę integracji, na przykład nazwę sklepu.
4. W polu Adres sklepu wpisz pełny adres sklepu razem z https://, bez końcowego ukośnika i bez /wp-admin - na przykład https://mojsklep.pl.
5. W polach Consumer Key i Consumer Secret wklej klucze z panelu WooCommerce.
6. Kliknij Dodaj integrację. Ritevo od razu łączy się ze sklepem i sprawdza dane: jeśli są poprawne, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd zwrócony przez sklep i nic nie zostanie zapisane.

Ustawienia integracji

Po podłączeniu integracja jest Aktywna, ale pobieranie zamówień jest wyłączone - włączasz je sam. Na stronie integracji znajdziesz:

• Nazwa konta - Twoja własna nazwa tej integracji, na przykład nazwa sklepu. Możesz ją zmienić w każdej chwili.
• Adres sklepu - adres podany przy dodawaniu. Tutaj nie da się go zmienić; nowy adres lub nowe klucze podajesz przez Zaktualizuj dane logowania.
• Pobieranie zamówień - po włączeniu Ritevo sprawdza nowe i zmienione zamówienia mniej więcej co 10 minut. Zasady wspólne dla wszystkich kanałów: Pobieranie zamówień.
• Mapowanie statusów zamówień, Mapowanie metod płatności i Zaawansowane mapowanie - opisane niżej.

Mapowanie statusów i płatności

Każdy sklep nazywa statusy zamówień i metody płatności po swojemu, dlatego przy sklepach internetowych sam decydujesz, jak mają być tłumaczone na statusy i metody Ritevo. Mapowanie ustawiasz raz, na stronie integracji, i dotyczy ono każdego zamówienia pobieranego od tej chwili.

Mapowanie statusów zamówień

Listę statusów Ritevo pobiera z Twojego sklepu, razem ze statusami dodanymi przez wtyczki, więc widzisz je pod takimi nazwami jak w panelu WooCommerce. Na start przypisane są standardowe statusy WooCommerce. Sam przypisujesz statusy dodane przez wtyczki. Przypisanie startowe:

• Potwierdzono - W trakcie realizacji, Zrealizowane, Zwrócone. Zwrócone zamówienie było prawdziwą sprzedażą, dlatego zostaje potwierdzone - zwrot rozliczasz osobno.
• Anulowano - Anulowano.
• Ocz. na płatność - Oczekujące na płatność, Nieudane.
• Ocz. na potwierdzenie - Wstrzymane (oczekujące na płatność).

Jeden status Ritevo może mieć przypisanych kilka statusów sklepu, ale jeden status sklepu tylko jeden status Ritevo. Zamówienie ze statusem, którego nigdzie nie przypisałeś, trafia jako Ocz. na potwierdzenie - zobaczysz je i zdecydujesz, co dalej.

Mapowanie metod płatności

Listę metod Ritevo pobiera z bramek płatności włączonych w Twoim sklepie. Na start przypisane są metody wbudowane w WooCommerce. Sam przypisujesz bramki z wtyczek (PayU, Przelewy24, Stripe i inne), bo każdy sklep ma inne. Przypisanie startowe:

• Przelew - Przelew bankowy, Płatność czekiem.
• Płatność przy odbiorze - Za pobraniem.

Płatność metodą, której nigdzie nie przypisałeś, trafia jako Inne.

Zaawansowane mapowanie - pola z wtyczek

WooCommerce nie ma standardowych pól na NIP, prośbę o fakturę ani punkt odbioru - dodają je wtyczki, każda pod własną nazwą pola. W tej karcie wskazujesz, z którego pola zamówienia Ritevo ma czytać każdą z tych danych. Na start wpisane są nazwy pól popularnych wtyczek. Sam dopisujesz nazwy pól innych wtyczek, a niepotrzebne usuwasz.

• NIP / numer VAT - pole z numerem podatkowym kupującego. Gdy ma wartość, zamówienie dostaje dane firmy i numer do faktury.
• Żądanie faktury - pole, z którego Ritevo odczytuje, czy kupujący chce fakturę. Liczy się sama wartość w polu: jeśli jest tam „0", „nie", „no", „false" albo „off", prośby o fakturę nie ma; każda inna wartość (na przykład „1", „tak", „yes") to prośba o fakturę. Gdy pole jest puste, prośba o fakturę jest wtedy, gdy kupujący podał NIP.
• Identyfikator punktu odbioru - pole z kodem paczkomatu lub punktu (na przykład WAW123).
• Nazwa punktu odbioru i Opis punktu odbioru - pola z nazwą i adresem punktu, jeśli wtyczka je zapisuje.
• Kraj punktu odbioru - zwykle zostaje puste; wtedy Ritevo bierze kraj z adresu dostawy.

Nazwę pola znajdziesz w ustawieniach wtyczki albo w szczegółach zamówienia testowego. Wpisz ją dokładnie - wielkość liter i podkreślenie na początku mają znaczenie. W jednym polu możesz podać kilka nazw (na przykład po zmianie wtyczki): Ritevo użyje pierwszej, która w zamówieniu ma wartość.

Co daje ta integracja

• Zamówienia - nowe i zmienione zamówienia z WooCommerce trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą (także punktem odbioru z wtyczki) i pozycjami ze zdjęciami produktów.

Zamówienia z WooCommerce

Ritevo pobiera z WooCommerce całe zamówienie: kupującego, adres rozliczeniowy i dostawy, metodę dostawy, płatność, pozycje z cenami brutto i zdjęciami produktów. Zamówienie zmienione w sklepie (na przykład nowy status) jest pobierane ponownie.

• Statusy i płatności - tłumaczone według Twojego mapowania, opisanego wyżej.
• Faktura - dane firmy i NIP są czytane z pól wskazanych w sekcji Zaawansowane mapowanie; bez nazwy firmy i bez NIP-u zamówienie nie ma danych do faktury. Prośba o fakturę wynika z pola Żądanie faktury i daje oznaczenie Klient prosi o fakturę.
• Punkt odbioru - kod i nazwa punktu są czytane z pól wskazanych w sekcji Zaawansowane mapowanie; bez nich zamówienie ma tylko adres dostawy.
• Uwagi kupującego - uwaga do zamówienia wpisana w koszyku trafia do zamówienia jako wiadomość od kupującego.
• Usługi dodatkowe - obsługiwane. Opłaty doliczone w sklepie do zamówienia, na przykład za pakowanie na prezent albo wniesienie, zobaczysz jako osobne pozycje dla całego zamówienia. Rabat dodany jako opłata pojawi się z kwotą na minusie. Więcej o usługach dodatkowych.
• Zakup bez konta - zamówienie gościa pobiera się normalnie; kupujący nie ma wtedy identyfikatora klienta sklepu.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy sklep przestał akceptować dane logowania - klucz został usunięty w panelu sklepu, stracił uprawnienia albo zmienił się adres sklepu. Do czasu podania nowych danych Ritevo nie pobiera ani nie wysyła żadnych danych z tego sklepu.

1. W panelu sklepu wygeneruj nowe klucze - tak samo jak przy pierwszym podłączeniu.
2. Na stronie integracji w Ritevo kliknij Zaktualizuj dane logowania, podaj adres sklepu i nowe klucze i zatwierdź. Ritevo sprawdza je w sklepie tak samo jak przy dodawaniu - błędne dane zwrócą błąd, poprawne odświeżą połączenie. Mapowania, ustawienia pobierania i historia zostają bez zmian.

Usunięcie integracji

Usuń integrację wyłącza integrację w Ritevo: przestaje pobierać i wysyłać dane, ale to, co pobrała wcześniej, zostaje. Przywróć integrację włącza ją z powrotem.

Czego integracja nie robi

• Nie zarządza ofertami: nie wystawia, nie zmienia cen ani stanów magazynowych w WooCommerce.
• Nie pobiera wiadomości - WooCommerce nie ma skrzynki wiadomości od kupujących. Klienci piszą e-mailem, więc dodaj integrację e-mail dla skrzynki sklepu.
• Nie przesyła nic z powrotem do WooCommerce: gdy w Ritevo zmienisz status zamówienia, nadasz przesyłkę albo wystawisz fakturę, zamówienie w WooCommerce zostaje bez zmian.