Integracja: Pobierz plik

Import Twoich danych za pomocą integracji: Pobierz plik pozwala Ci w prosty sposób dodać do Berryboo informacje, których nie da się pobrać z innych źródeł (np. sklepu internetowego, marketplace’ów, Google Analytics czy Google Ads). Dzięki temu masz pełniejszy obraz swojej sprzedaży i możesz analizować dane w jednym miejscu.

Upewnij się, że jesteś w stanie wybrane dane przygotować w formacie JSON lub XML.

Przygotuj odpowiedzi na te pytania, a my damy Ci znać czy będziemy w stanie pobrać od Ciebie dane. Możemy je pobrać w dwóch formatach: plikiem JSON lub XML.

• Jakiego rodzaju dane chcesz zaimportować do Berryboo?
• Czy dane pochodzą z Twoich bezpośrednich baz danych (może to być więcej niż jedna baza)?
• W którym dokładnie miejscu w Berryboo mają zostać wyświetlone te dane?
• Do czego chcesz wykorzystać te dane w Berryboo?

Odpowiedzi na Twoje możliwe pytania:

W jakim formacie przygotować plik?

• Obsługujemy pliki JSON praz XML; rekomendujemy jednak JSON, ponieważ ten format jest elastyczny i nie ma sztywno zdefiniowanej struktury.

Jakie dane możesz zaimportować?

• Najczęściej importowane są dwa typy danych:
  • • ceny minimalne,
    • ceny zakupu.

Jak często aktualizowane są dane z pliku?

• To kwestia indywidualna: ustalamy częstotliwość aktualizacji zgodnie z Twoimi potrzebami.

Czy mogę dodać inne dane przez integrację z plikiem?

• Technicznie tak, jednak wymaga to wcześniejszego uzgodnienia z Twoim opiekunem klienta.Pobranie danych z pliku to jedno, ale dodanie ich do aplikacji i odpowiednie wyświetlenie to osobny proces, który może wymagać dodatkowych prac programistycznych i wyceny.

Instrukcja krok po kroku:

1. Przygotuj plik w formacie JSON lub XML (rekomendujemy użycie formatu JSON), w którym znajdują się wpisy dla każdej oferty, dla której chcemy ustawić cenę minimalną/cenę zakupu.

Bardzo ważnym elementem integracji są dane zawarte w pliku: muszą one dawać możliwość przypisania ich do konkretnych ofert w Berryboo.

Dla każdej oferty niezbędne jest by dostępny był jeden z poniższych identyfikatorów:

• SKU,
• EAN,
• ID z Berryboo,
• ID w kanale sprzedaży.

Każda oferta powinna też posiadać ceny, które mają zostać ustawione.

2. Następnie dodaj nową integrację: Ustawienia >> Integracje >> Dodaj nową integracje (prawy górny róg) >> Typ integracji >> Pobierz plik

Na podstawie danych z pliku odpowiednio skonfiguruj użycie ID oraz odpowiednich pól do nadpisania cen.

3. Udostępnij plik w chmurze – nasz system będzie pobierał go bezpośrednio przez protokół HTTP/HTTPS.

4. To Ty konfigurujesz dostęp do pliku, więc to Ty wybierasz metodę uwierzytelnienia, która zostanie użyta podczas próby pobrania pliku przez Berryboo.

Zaznacz “użyj pobranych danych do aktualizacji oferty”, a pojawią się pola, które umożliwiają ustawienie mapowania.

Wypełnij pola, które chcesz wykorzystać w Berryboo np “cena zakupu oferty”, nazwami pól z Twojego pliku, w którym znajduje się cena zakupu oferty.

Dane w integracji Pobierz plik

1. Adres pliku 

Adres URL, z którego będzie pobierany plik JSON.

Jeśli plik jest udostępniony w chmurze, system pobiera go bezpośrednio przez protokół HTTP (obecnie obsługiwane jest wyłącznie pobieranie przez HTTP/HTTPS).

2. Typ uwierzytelnienia 

Ponieważ jako klient konfigurujesz dostęp do pliku, wiesz, w jaki sposób jest on zabezpieczony. W tym miejscu należy wskazać metodę uwierzytelniania, która zostanie użyta podczas próby pobrania pliku.

Dostępne metody różnią się sposobem przekazania danych uwierzytelniających:

• Token w nagłówku: token dostępowy przekazywany w nagłówku zapytania HTTP (np. Authorization: Bearer …).
• Basic HTTP: standardowa metoda uwierzytelniania w protokole HTTP, wykorzystująca login i hasło przesyłane w nagłówku zapytania.

3. Nazwa pola z ID oferty 

Należy podać nazwę pola w pliku JSON, które zawiera identyfikator oferty. To pole będzie wykorzystywane do identyfikowania ofert w systemie Berryboo.

4. Typ ID

Wybierz typ identyfikatora, którym będziemy się posługiwać:

SKU, EAN, ID w Berryboo oraz ID z kanału sprzedaży

Wybrany typ musi odpowiadać wartości znajdującej się w wskazanym wcześniej polu z ID oferty.

5. Pole z listą 

Obsługiwane są wyłącznie pliki JSON, które:

• zawierają listę elementów (tablicę), lub
• są obiektem, który na najwyższym poziomie zawiera listę pod wskazanym kluczem.

W tym miejscu należy podać nazwę klucza, pod którym znajduje się lista ofert (jeśli plik nie jest bezpośrednio tablicą).

6. Pola do pobrania

W tej sekcji wskazujesz, które pola z pliku JSON mają zostać pobrane i udostępnione do dalszego wykorzystania w systemie, np. do:

• ustawiania ceny zakupu,
• ustawiania ceny minimalnej,
• określania stawki VAT,
• grupowania ofert.

Tylko zadeklarowane pola będą dostępne w pozostałych mechanizmach systemu.