Shopify

Integracja z Shopify pobiera do Ritevo zamówienia z Twojego sklepu. Podłączasz ją, zatwierdzając aplikację Ritevo w panelu Shopify - bez kopiowania kluczy. Statusy płatności, metody płatności i dodatkowe pola zamówienia (NIP, punkt odbioru) tłumaczysz na dane Ritevo w mapowaniu. Wiadomości od kupujących Shopify wysyła e-mailem - obsługujesz je w Ritevo przez integrację e-mail.

Ten sam sklep Shopify 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.

Podłączenie konta

Zacznij w Ritevo:

Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
W sekcji Sklepy internetowe wybierz kafelek Shopify i kliknij Dodaj integrację.
Ritevo przeniesie Cię do Shopify - zaloguj się, jeśli trzeba, wybierz sklep i zainstaluj aplikację Ritevo.
Shopify od razu poprosi o zgodę na dostęp do sklepu - zatwierdź ją.
Wróć do Ritevo i chwilę poczekaj - nie zamykaj okna. Gdy dodawanie się zakończy, otworzą się ustawienia nowej integracji.

Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu

Ekran dodawania integracji Shopify z przyciskiem Dodaj integrację, który prowadzi do instalacji w Shopify

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 - nazwa sklepu z Shopify. Ritevo pobiera ją z Shopify, nie da się jej tu zmienić; odświeża się przy ponownym połączeniu.
Adres sklepu - adres .myshopify.com sklepu, w którym zainstalowałeś aplikację. Nie da się go zmienić.
Pobieranie zamówień - po włączeniu Ritevo sprawdza nowe i zmienione zamówienia mniej więcej co 10 minut. Najnowsze zamówienia mogą pojawić się z kilkuminutowym opóźnieniem. Zasady wspólne dla wszystkich kanałów: Pobieranie zamówień.
Pobieranie wiadomości - zamiast przełącznika jest tu informacja, że wiadomości z Shopify obsługujemy przez integrację e-mail, i przycisk Dodaj integrację, który prowadzi do jej dodania.
Mapowanie statusów zamówień, Mapowanie metod płatności i Zaawansowane mapowanie - opisane niżej.

Szczegóły integracji Shopify: nazwa konta, adres sklepu, przełącznik Pobieranie zamówień i karta wiadomości odsyłająca do integracji e-mail

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ń

Status zamówienia w Ritevo wynika ze statusu płatności zamówienia w Shopify. Te statusy są takie same w każdym sklepie, więc na start przypisane są wszystkie - na liście widzisz je pod nazwami z Shopify. Przypisanie startowe:

Potwierdzono - PAID (opłacone), PARTIALLY_REFUNDED (częściowo zwrócone), REFUNDED (zwrócone). Zwrócone zamówienie było prawdziwą sprzedażą, dlatego zostaje potwierdzone - zwrot rozliczasz osobno.
Anulowano - VOIDED (płatność unieważniona), EXPIRED (płatność wygasła).
Ocz. na płatność - PENDING (czeka na płatność), PARTIALLY_PAID (opłacone częściowo).
Ocz. na potwierdzenie - AUTHORIZED (płatność zatwierdzona, ale pieniądze nie zostały jeszcze pobrane).

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.

Karta Mapowanie statusów zamówień integracji Shopify z domyślnie przypisanymi statusami płatności Shopify

Mapowanie metod płatności

Shopify nie udostępnia listy metod płatności sklepu, dlatego nazwy metod wpisujesz ręcznie - tak, jak Shopify zapisuje je w zamówieniu. Nazwę znajdziesz w panelu Shopify w szczegółach zamówienia. Na start wpisane są Shopify Payments, PayPal i metody ręczne wbudowane w Shopify. Sam dopisujesz metody z aplikacji płatniczych, a niepotrzebne usuwasz. Przypisanie startowe:

Karta płatnicza - shopify_payments.
PayPal - paypal.
Płatność przy odbiorze - Cash on Delivery (COD).
Przelew - Bank Deposit, Money Order.

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

Zaawansowane mapowanie - dodatkowe pola zamówienia

Shopify nie ma standardowych pól na NIP, prośbę o fakturę ani punkt odbioru - dodają je aplikacje, każda pod własną nazwą, jako dodatkowe informacje zamówienia. W tej karcie wskazujesz, z którego pola Ritevo ma czytać każdą z tych danych. Na start pola są puste. Sam wpisujesz nazwy pól aplikacji, z których korzysta Twój sklep.

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", „no", „false" albo „off", prośby o fakturę nie ma; każda inna wartość (na przykład „1", „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 aplikacja je zapisuje.
Kraj punktu odbioru - zwykle zostaje puste; wtedy Ritevo bierze kraj z adresu dostawy.

Nazwę pola znajdziesz w panelu Shopify w szczegółach zamówienia testowego, w sekcji z dodatkowymi informacjami. Wpisz ją dokładnie - wielkość liter ma znaczenie. W jednym polu możesz podać kilka nazw (na przykład po zmianie aplikacji): Ritevo użyje pierwszej, która w zamówieniu ma wartość.

Karta Zaawansowane mapowanie integracji Shopify z przykładowymi nazwami pól NIP, Faktura, paczkomat_id i paczkomat_nazwa

Co daje ta integracja

Zamówienia - nowe i zmienione zamówienia z Shopify trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą i pozycjami ze zdjęciami produktów.
Wiadomości - przez integrację e-mail, patrz niżej.

Zamówienia z Shopify

Ritevo pobiera z Shopify całe zamówienie: kupującego, adres rozliczeniowy i dostawy, sposób dostawy, płatność oraz pozycje ze zdjęciami produktów. Zamówienie zmienione w sklepie (na przykład po opłaceniu) jest pobierane ponownie. Pobierane są wszystkie zamówienia - także ze sprzedaży stacjonarnej (Shopify POS) i zamówienia testowe.

Statusy i płatności - tłumaczone według Twojego mapowania, opisanego wyżej. Numer płatności i data opłacenia pochodzą z ostatniej udanej transakcji pobrania pieniędzy, a kwota zapłacona to to, co kupujący faktycznie wpłacił.
Kwoty i VAT - kwoty są w walucie, w której płacił kupujący. Stawki VAT pochodzą z podatków, które Shopify naliczył przy każdej pozycji; pozycja bez podatku ma VAT 0%.
Napiwek - jest pozycją zamówienia, bo tak przesyła go Shopify, ze stawką VAT z Shopify.
Usługi dodatkowe - obsługiwane. Dodatkowe opłaty doliczone do zamówienia w Shopify zobaczysz jako osobne pozycje dla całego zamówienia, pod nazwą ze sklepu. Cło, jeśli nie jest wliczone w ceny, trafia jako pozycja Duties - osobna dla każdej stawki VAT naliczonej przez Shopify. Więcej o usługach dodatkowych.
Dostawa - gdy zamówienie ma kilka sposobów dostawy, ich nazwy są połączone przecinkiem, a koszty zsumowane. Termin wysyłki i szacowany termin dostawy trafiają do zamówienia, jeśli Shopify je podaje.
Kupujący - dane kupującego pochodzą z adresu rozliczeniowego, a gdy go brak - z adresu dostawy.
Faktura - nazwa firmy pochodzi z adresu rozliczeniowego, a NIP z pola wskazanego 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.
Kraj pochodzenia - wynika z języka i regionu, w którym kupujący składał zamówienie (na przykład de-DE to Niemcy). Gdy Shopify nie poda regionu, Ritevo bierze kraj sklepu. Kraj kupującego jest osobno, w jego adresie.
Uwagi kupującego - uwaga do zamówienia wpisana w koszyku trafia do zamówienia jako wiadomość od kupującego.

Wiadomości od kupujących z Shopify

Shopify nie udostępnia skrzynki wiadomości (Shopify Inbox) przez API - kupujący piszą do Ciebie e-mailem na adres sklepu. Żeby te wiadomości widzieć i odpowiadać na nie w Ritevo, dodaj integrację e-mail dla tej skrzynki. Wiadomości pojawią się wtedy w Ritevo jak zwykłe e-maile; nie są powiązane z integracją Shopify ani z jej zamówieniami.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy aplikacja Ritevo została odinstalowana w panelu Shopify albo połączenie wygasło - na przykład gdy integracja przez ponad 90 dni nie łączyła się ze sklepem, bo pobieranie zamówień było wyłączone. Do czasu ponownego połączenia Ritevo nie pobiera ani nie wysyła żadnych danych z tego sklepu.

Wejdź w Integracje, kliknij Dodaj integrację i wybierz kafelek Shopify.
Wybierz w Shopify ten sam sklep i zatwierdź aplikację Ritevo - tak samo jak przy pierwszym podłączeniu.
Ritevo rozpozna sklep po adresie i odświeży połączenie w istniejącej integracji. Mapowania, ustawienia pobierania i historia zostają bez zmian - druga integracja nie powstaje.

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 Shopify.
Nie pobiera wiadomości - Shopify nie udostępnia ich przez API.
Nie przenosi anulowania ani zwrotu zrobionego w Shopify po potwierdzeniu zamówienia - zamówienie w Ritevo zostaje bez zmian.
Nie przesyła nic z powrotem do Shopify: gdy w Ritevo zmienisz status zamówienia, nadasz przesyłkę albo wystawisz fakturę, zamówienie w Shopify zostaje bez zmian.