Shoper
Zamówienia i ich pozycje, produkty z wariantami i stanami, kategorie, marki oraz dane dostaw i słowniki.
Opis integracjiWidoki danych — Silnik e-commerce
Obecna dokumentacja tych widoków opisuje dane i zasady raportów IdoSell.
Shoper nie ma osobnej tabeli klientów: dane klienta przychodzą razem z zamówieniami.
Jak podłączyć integrację
Integracja Data Octopus z Shoperem wymaga utworzenia w panelu Integracji Zewnętrznej, która zapewnia dostęp do danych za pomocą Tokenu API.
Krok 1: Rozpocznij dodawanie nowej integracji
- 1Z panelu bocznego wybierz Dodatki i integracje (1).
- 2Kliknij Integracje zewnętrzne (2).
- 3W prawym górnym rogu kliknij Dodaj integrację (3).
Krok 2: Uzupełnij ustawienia podstawowe
- 1Narzędzie: wybierz Inne (1).
- 2Nazwa integracji: wpisz DataOctopus Integration (2), żeby łatwo rozpoznać, komu nadano dostęp.
- 3Opis: opcjonalnie (zalecane), np. „Integracja danych DataOctopus <> Shoper” (3).
Krok 3: Nadaj uprawnienia integracji (odczyt)
W sekcji Uprawnienia integracji dodaj uprawnienie typu odczyt dla każdej z tych kategorii danych:
- Zamówienia
- Produkty
- Producenci
- Waluty
- Dostawy
- Kategorie
- Stany dostępności
- Statusy zamówień
- 1W polu Obszar sklepu (1) wybierz jedną z pozycji, np. zamówienia.
- 2W polu Zakres dostępu (2) zawsze wybierz odczyt.
- 3Kliknij Dodaj uprawnienie (3).
- 4Powtarzaj, aż lista zawiera wszystkie 8 pozycji z zakresem odczyt.
Krok 4: Zapisz i utwórz token
Po nadaniu wszystkich uprawnień przewiń na dół i kliknij Zapisz i utwórz token.
Krok 5: Skopiuj i prześlij Token API
Token API skopiuj natychmiast – po zamknięciu strony nie da się go ponownie podejrzeć. Jeśli zamkniesz ją bez kopiowania, trzeba utworzyć nowy token.
- 1Skopiuj Client ID i Token API.
- 2Wklej oba do formularza wdrożeniowego Data Octopus.
- 3Kliknij Rozumiem (1).
Pobierane zasoby
ordersNagłówki zamówień z klientem, adresami, sumami, płatnością i dostawą.
order_productsProdukty w każdym zamówieniu.
productsproduct_stocksKatalog, ceny i stany magazynowe.
categoriesproducersDrzewo kategorii i producenci.
shippingsstatusesavailabilitiescurrenciesMetody wysyłki, statusy zamówień, dostępności, waluty.
Zamówienia
- Id i kod zamówienia, daty utworzenia, potwierdzenia, zmiany statusu i dostawy, status.
- E-mail klienta, adres rozliczeniowy i dostawy (imię i nazwisko, firma, ulica, miasto, kod, kraj, telefon, NIP).
- Sumy: wartość, kwota zapłacona, koszt wysyłki, rabaty (klienta, grupy, kodu, progowe), podatek, koszt lojalnościowy, waluta i kurs.
- Metoda i kod dostawy, punkt odbioru (nazwa, adres, godziny otwarcia), metoda płatności.
- Kod promocyjny, tagi, notatki (publiczne i prywatne), źródło zamówienia, flagi opłacenia i niedopłaty/nadpłaty.
Pozycje zamówień
- Produkt, nazwa, kod, opcja, ilość, jednostka, cena, rabat, podatek, waga, kod magazynu.
Produkty
- Kod, EAN, producent, kategoria i wszystkie kategorie, nazwy i opisy per język, atrybuty, opcje, tagi, kolekcje.
- Ceny: cena, cena promocyjna, cena w punktach, inna cena, oferty specjalne (rabat, daty).
- Stany i warianty, wymiary i waga gabarytowa, podatek, jednostka.
- Flagi: nowość, bestseller, produkt dnia; produkty powiązane, zestawy, zdjęcie główne, daty (dodania, edycji).
Warianty i stany
- Kod wariantu, EAN, typy cen (detaliczna, hurtowa, specjalna), cena zakupu, najniższa cena z ostatniego okresu.
- Stan magazynowy, poziom ostrzegawczy, sprzedana ilość, dostępność, czas dostawy, waga, opakowanie, oferty specjalne.
Kategorie, marki i słowniki
- Kategorie (nazwa, opis, SEO, kategoria nadrzędna, kolejność).
- Producenci (nazwa, strona www, logo, SEO).
- Metody wysyłki (nazwa, koszt, limity wagi i kosztu, próg darmowej wysyłki, płatności).
- Statusy zamówień (nazwa, typ, kolor, e-mail przy zmianie), dostępności, waluty i kursy.