Integracja Dropshipping

Wstęp

Aplikacja umożliwia integrację przez pliki XML ze sklepem internetowym na zasadach dropshippingu*.
W przypadku naszej integracji to "my" generujemy plik z Symfonia Handel, z towarami do sprzedaży i udostępniamy go naszym klientom, którzy chcą sprzedawać nasz towar (lub my chcemy, aby oni sprzedawali 🙂) w ich sklepach internetowych.

*Dropshipping - to model sprzedaży, w którym realizacja zamówień, proces magazynowania, pakowania, wysyłki i dostarczania produktów do klientów końcowych, jest zlecana podmiotowi trzeciemu, nazywanemu „dropshipperem”.

---

Specyfikacja i założenia

Założenia:

Na skonfigurawany serwer FTP są generowane/aktualizowane pliki .xml.
Każdy kontrahent ma utworzony indywidualny katalog, którego nazwa to jego GUID z Symfonii, a w tym katalogu znajduje się plik 'towary.xml'

Dodatkowo, w katalogu lokalnym (Dokumenty\Symfonia.Pro\DropShipping) są automatycznie generowane katalogi kontrahentów, a w nich są generowane/aktualizowane pliki.xml

• nazwa katalogu to: '<kod kontrahenta>___<GUID kontrahenta>'
• nazwa pliku to: 'towary.xml'
• znajduje się tam również podkatalog 'archwiwum' w którym przechowywane są wszystkie historyczne wersje pliku .xml dla danego kontrahenta.

Katalog lokalny służy zapisywaniu historii generowanych plików .xml oraz sprawdzaniu czy już wygenerowane pliki na FTP wymagają aktualizacji.

Obsługujemy następujące formaty integracji:

• Ceneo

Istnieje możliwość opracowania nowych / modyfikacji już obsłużonych formatów w zależności od Państwa potrzeb.
Każdemu kontrahentowi, który ma mieć generowany plik z ofertą, należy wybrać w jakim formacie ma ona być.

 

Do ustawienia:

Słownik na integracje, każdy element to nazwa integracji, którą mamy obsłużoną

Na kontrahencie:

• wymiar 'Oferta XML' typu słownikowego (słownik na integracje)

  • Jeśli jest wybrana jakakolwiek integracja to kontrahentowi będzie się generował plik xml w odpowiednim formacie (jeśli nie ma on wybranej żadnej grupy towarów to będzie on pusty)
  • Jeśli niewybrana integracja to plik nie będzie generowany, jeśli plik był wcześniej wygenerowany to zostanie skasowany z FTP (Przypadek odłączenia odłączenia klienta od oferty towrów w XML).

• wymiary 'grup towarowych'
  Muszą się zaczynać na 'EXML_' i być typu prawda/fałsz. Jeśli zaznaczony to danemu kontrahentowi zostaną wyeksportowane wszystkie towary z zaznaczonym tym samym wymiarem. Te same wymiary mają być przypisane do kartoteki towarów.

• wymiary 'magazynów grup towarowych'
  Muszą mieć skrót identyczny jak wymiar grupy towarowej, ale na końcu muszą mieć dopisane '_MAGAZYNY'.
  Muszą być typu tekstowego.
  Uzupełniamy w nich symbole magazynów (jednego lub wielu), z których ma być odczytany stan handlowy towarów z danej grupy towarowej.
  Tych wymiarów nie musimy dodawać na towarach, są one potrzebne tylko na kontrahentach.
  Nieuzupełnienie tego wymiaru spowoduje, że dla danej grupy towarowej stany handlowe będą odczytane z magazynów domyślnych, ustawionych w konfiguracji dodatku.

Na towarze:

• wymiar 'maksymalny pokazywany stan w xml'

• wymiar 'umowny stan zerowy'

• wymiary 'grup towarowych' Muszą się zaczynać na 'EXML_' i być typu prawda/fałsz.
  Jeśli zaznaczony, to dany towar jest eksportowany do każdego kontrahenta, który ma zaznaczony ten sam wymiar.
  Te same wymiary mają być przypisane do kartoteki kontrahentów.

• (opcjonalnie) wymiar słownikowy na kategorie Ceneo (tylko dla formatu Ceneo)

 

Konfiguracja w rozwiązaniu dodatkowym

• dane dostępowe do FTP (adres, login, hasło, port)

• katalog główny na FTP
  W nim są generowane katalogi dla kontrahentów, a w katalogach będzie znajdować się plik xml.
  Nazwą katalogu jest '<GUID kontrahenta>'
  Nazwa pliku to 'towary.xml'

• która cena towaru ma być eksportowana (A/B/C/D/...)

 

Funkcje rozwiązania

Podgląd listy eksportowanych towarów ('lista towarów')

Wyświetla się okno z listą:

• wiersze zgrupowane, głównym węzłem jest kontrahent a jego pozycjami są towary, które są do niego eksportowane
• lista jest tylko do podglądu "jakie towary idą do jakiego kontrahenta"

 

Uruchomienie automatyczne

Możliwość uruchomienia automatycznego (cyklicznego) eksportu np. przy użyciu Windowsowego harmonogramu zadań lub na Symfoniowej procedurze OnTimer.

Co jest wykonywane podczas jednego uruchomienia:

• sprawdzamy w katalogu lokalnym eksportowanych plików wszystkich kontrahentów, którzy mają aktualnie wyeksportowany plik i czy któryś z nich nie ma wybranego formatu oferty
  Jeśli tak to plik kasujemy z FTP

• wyszukujemy dla każdego kontrahenta (który ma wybrany format oferty) wszystkie towary które mają ptaszek w wymiarze zaczynającym się od 'EXML_', jeśli w tym samym wymiarze dany kontrahent również ma ptaszek

• jeśli końcowy wynik różni się od już wygenerowanego pliku to go aktualizujemy i wysyłamy nowy plik na ftp

 

Dane przesyłane w pliku XML

• kod towaru
• nazwa towaru
• kod EAN
• stan handlowy
  Wartość jest zmieniana, gdy jest 'za duża' lub 'za mała' (względem wymiarów na towarze)
  'Od góry' (od maksymalnej wartości) górny stan jest zmniejszany do wartości 'maksymalny pokazywany stan w xml' o ile jest ona wprowadzona dla towaru, jeżeli nie jest to wysyłamy tyle ile jest na stanie
  'Od dołu' - w przypadku gdy stan handlowy będzie mniejszy niż 'umowny stan zerowy' dla towaru to podawana jest wartość 0
• cena (wg konfiguracji)
• stawka VAT
• zdjęcia (z załączników Symfoniowych)
• opis (z notatki Towaru)
• kategoria (z wymiaru towaru)

 

Instalacja

Funkcjonalność wymaga zainstalowanej aplikacji HPP oraz wgrania raportów uruchomieniowych do programu Symfonia Handel

Wymagane raporty:

• hpp_runtime -> NET Runtime (BLOT)
• hpp_eitg_ds00.sc -> Integracja DropShipping - Ustawienia NET (BLOT)
• hpp_eitg_ds01.sc -> Integracja DropShipping - ręczny eksport (BLOT)
• hpp_eitg_ds02.sc -> Integracja DropShipping - link kontrahenta (BLOT)
• hpp_eitg_ds03.sc -> Integracja DropShipping - lista towarów (BLOT)
• hpp_eitg_ds04.sc -> Integracja DropShipping - kategorie Ceneo (BLOT)

 

Konfiguracja

Wymiary

Wspólne

Wymiary typu 'Prawda\Fałsz' na 'grupy towarowe'

Każdy wymiar musi mieć w skrócie na początku 'EXML_'
Każdy z tych wymiarów musi być podpięty zarówno do wymiarów kontrahentów jak i towarów

 

 

Kontrahentów

• Należy dla kontrahentów utworzyć nowy wymiar analityczny 'Oferta XML' z podpiętym słownikiem integracji (można zaimportować plik ze słownikiem).

• Wymiary typu tekstowego na 'magazyny grup towarowych'
  Każdy wymiar musi mieć w skrócie symbol grupy towarowej do której się odnosi i na końcu '_MAGAZYNY'.
  Każdy z tych wymiarów musi być podpięty do wymiarów kontrahentów

 

Towarów

Dla towarów tworzymy wymiary:

• wymiar na maksymalny stan pokazywany w XML typu zmiennoprzecinkowego

• wymiar na umowny stan zerowy typu zmiennoprzecinkowego

• wymiar dla kategorii (ceneo) typu słownikowego

 

Ustawienia integracji

Dla użytkownika Admin -> Kartoteki -> Raporty -> Symfonia.Pro -> HPP -> Integracja DropShipping - Ustawienia NET (BLOT) spod PPM ^? Prawy Przycisk Myszy wybieramy 'Wykonaj'

 

Okno pokaże się, jeżeli będą dodane wymiary (patrz wyżej).

[1] Wymiar kontrahentów

 

 

[2] Wymiary towarów

 

 

[3] Parametry FTP

 

[4] Parametry eksportu

 

Możemy również określić, czy usuwać nieużywane zdjęcia zaznaczając

W polu Domyślne magazyny możemy wskazać z których magazynów ma być odczytywany stan handlowy, jeśli w wymiarach kontrahenta nie ma wskazanego żadnego magazyny dla danej grupy towarowej.

Ustawienia wymiarów dla kontrahentów i towarów

Mając podefiniowne wymiary należy je ustawić dla kontrahentów i towarów.

Dla Kontrahentów

 

Kontrahentom należy przypisać odpowiednią ofertę XML (tylko kontrahenci z wybranym jakimkolwiek elementem w tym wymiarze słownikowym będą mieli generowane linki do plików xml).

Dla Towarów

 

Jak grupowo zmienić wymiary? - szczegóły w FAQ

Dodatkowo

W katalogu Dokumenty\Symfonia.Pro zostanie wygenerowany podkatalog 'Dropshipping' a w nim podkatalogi kontrahentów nazwane '<kod kontrahenta>___<guid kontrahenta>'.
W każdym takim katalogu będzie ostatnia wysłana na FTP wersja pliku xml oraz podkatalog archiwum, w którym są przechowywane poprzednie wersje plików xml.
W katalogu Dokumenty\Symfonia.Pro\Logs zostanie wygenerowany podkatalog DropShipping, w nim tworzone będą pliki .txt z dziennymi logami.
Każda iteracja eksportu zaczyna i kończy się poprzez '====================='
Będą w nich informacje o:

• momencie startu eksportu
• ilości usuniętych kontrahentów (z wypisaniem ich guidów i kodów)
• ilości usuniętych zdjęć (jeśli zaznaczymy w konfiguracji parametr żeby usuwać nieużywane zdjęcia)
• ilość nowych zdjęć
• ilość nowych/zaktualizowanych kontrahentów (z wypisaniem ich guidów, kodów i ilości towarów w pliku xml)
• momencie końca eksportu

 

---

Uruchomienie funkcjonalności

Z założenia generowanie plików działa automatycznie po ustawieniu w harmonogramie zadań.

Poniżej opisano ręczne opcje.

 

Link do pliku xml kontrahenta można uzyskać na dwa sposoby:

[1] spod PPM ^? Prawy Przycisk Myszy na liście kontrahentów wybierając -> Integracja DropShipping - link kontrahenta

[2] spod PPM ^? Prawy Przycisk Myszy na liście kontrahentów wybierając -> Integracja DropShipping - lista towarów -> dwuklik na wierszu grupującym danego KH

Po skopiowaniu linku do przeglądarki powinien otworzyć się nam plik .xml

 

Integracja DropShipping - link kontrahenta

Pokaże nam się okno z linkiem do naszego FTP.

 

Należy go przesłać do klienta, aby użył go w konektorze swojego sklepu internetowego.

Link możemy skopiować do przeglądarki. Będziemy mieli pogląd pliku kontrahenta.

 

Integracja DropShipping - lista towarów

Po wybraniu '...- lista towarów' otworzy nam się okno z podglądem towarów.

 

Dwuklik na kodzie kontrahenta pokaże nam okno z linkiem do pliku na FTP.

 

Na oknie "Podgląd towarów do integracji ze sklepami" wyświetlamy listę towarów zgrupowaną dla każdego kontrahenta, a ich zgrupowanych per integracje.

• daje to nam szybki podgląd jakie będą/są wygenerowane dane w plikach XML.

• dwuklik na wierszu grupującym kontrahenta otworzy nam okno z linkiem do pliku xml kontrahenta

• w szczególnym przypadku, gdy kontrahent ma wybrany format integracji ale nie ma przypiętej żadnej grupy towarowej (lub przypięte do niego grupy towarowe nie zawierają żadnego towaru) na powyższym oknie zostanie wyświetlony pod tym kontrahentem jeden wiersz z napisem '<BRAK>'

 

Integracja DropShipping - ręczny eksport

Po wybraniu '... - ręczny eksport' program wygeneruje nowe pliki / zaktualizuje istniejące dla wszystkich kontrahentów z wybraną ofertą XML.
Funkcjonalność identyczna jak podczas automatycznego eksportu.

Eksport zakończy się komunikatem.

 

Integracja DropShipping - kategorie Ceneo

Na oknie "Kategorie Ceneo" wyświetlane są aktualnie kategorie dostępne na Ceneo.

Po zaznaczeniu pola wyboru w kolumnie 'Czy używać' dana kategoria zostanie dodana do słownika podpiętego do wymiaru na towarze.
Analogicznie, odznaczenie tego pola spowoduje skasowanie wybranej kategorii ze słownika.

 

Pod prawym przyciskiem myszy dostępne są opcje do zbiorczej zaznaczania/odznaczania kategorii.

 

Jeśli kategoria jest już używana na towarach to przy próbie jej odznaczenia pojawi się odpowiedni komunikat.
W takim wypadku należy odłączyć te kategorię od towarów i spróbować ponownie.

 

---

Opis towaru

Opis towaru pobierany jest z jego notatki.
Wg specyfikacji Ceneo opis produktu może mieć atrybuty HTML/CSS do stylowania opisu.