Wprowadzenie
Marże produktów w aplikacji Data Octopus to kluczowe dane finansowe określające zysk ze sprzedaży każdego produktu. Dodanie marż umożliwia:
Dokładne obliczanie zyskowności produktów
Generowanie raportów finansowych z rzeczywistymi danymi
Analizę rentowności poszczególnych kategorii produktów
Podejmowanie świadomych decyzji cenowych
Bez zdefiniowanych marż, system używa domyślnych wartości procentowych, co może prowadzić do niedokładnych analiz finansowych. Domyślne ustawienie wartości marży to 25%.
Wymagania wstępne
⚠️ WAŻNE: Przed dodaniem marż musisz spełnić następujące warunki:
Obowiązkowe wymagania
Zaimportowany plik produktowy: Marże można dodać tylko wtedy, gdy plik produktowy został już pomyślnie zaimportowany do systemu
Status importu: Plik produktowy musi mieć status "zaimportowany sukcesem" i świecić się na zielono
Jak sprawdzić status pliku produktowego
Przejdź do głównego panelu roboczego
Wybierz swój sklep
Przejdź do sekcji Import
Sprawdź status Product Feed - musi być oznaczony jako zaimportowany sukcesem (zielony kolor)
📖 Potrzebujesz pomocy z plikiem produktowym? Zobacz instrukcję dodawania pliku produktowego.
Instrukcja krok po kroku
Rozpoczęcie procesu dodawania marż
Przejdź do głównego panelu roboczego Data Octopus
Wybierz sklep, dla którego chcesz dodać marże
Kliknij sekcję Import w menu bocznym
W części Add Data wybierz opcję Margins
Pobranie szablonu marż
W górnej części okna znajdź plik do pobrania - jest to oficjalny szablon marż
Kliknij na link pobierania aby zapisać szablon na swoim komputerze
Zapisz plik w łatwo dostępnej lokalizacji (np. Pulpit, folder Pobrane)
Przygotowanie pliku marż
Otwórz pobrany szablon w programie do edycji arkuszy kalkulacyjnych (Excel, Google Sheets, LibreOffice Calc)
Uzupełnij dane marż zgodnie ze strukturą szablonu
Marże muszą być uzupełnione w formacie dziesiętnym - gdy nasza marża wynosi 30% to wpisujemy w pliku 0.3. Jako separator w liczbie dziesiętnej wykorzystujemy kropkę.
Zapisz plik zachowując oryginalne formatowanie
Import pliku marż
Wróć do aplikacji Data Octopus (okno z opcją Margins)
Kliknij przycisk Choose a File
Wybierz uzupełniony plik marż z dysku komputera
Kliknij przycisk Import File aby rozpocząć proces importu
Poczekaj na potwierdzenie pomyślnego importu
Praca z szablonem
Czym jest szablon marż?
Szablon marż to przygotowany przez system plik CSV zawierający:
Właściwą strukturę kolumn wymaganą przez aplikację
Nagłówki kolumn w odpowiednim formacie
Jak wypełnić szablon?
Zasady wypełniania:
Nie zmieniaj struktury pliku - nagłówków kolumn, ich kolejności ani formatowania
Wypełniaj tylko wiersze z danymi - nie modyfikuj wiersza nagłówków
Używaj spójnego formatowania dla wartości liczbowych - format dziesiętny
Sprawdź poprawność ID produktów - muszą odpowiadać tym z pliku produktowego
Przykład poprawnego wypełnienia:
Najlepsze praktyki:
✅ Sprawdź dane dwukrotnie przed importem
✅ Używaj poprawnych separatorów (przecinek)
✅ Utrzymuj spójne kodowanie (UTF-8)
Aktualizacja marż
Dodawanie kolejnych marż
Gdy chcesz dodać nowe marże lub zaktualizować istniejące:
Nie musisz ponownie pobierać szablonu - możesz użyć wcześniej pobranego
Uzupełnij plik o nowe dane marż lub zaktualizuj istniejące
Wykonaj standardowy proces importu (Choose a File → Import File)
System automatycznie przetworzy zmiany
Kiedy pobrać szablon ponownie?
Pobierz szablon ponownie, gdy:
Zgubiłeś oryginalny plik szablonu
Struktura produktów się zmieniła i potrzebujesz nowego szablonu
Zarządzanie duplikatami
Automatyczne usuwanie duplikatów
🔄 Nie martw się o duplikaty! System Data Octopus automatycznie:
Wykrywa zduplikowane pozycje podczas importu
Usuwa duplikaty zachowując najnowsze dane
Aktualizuje istniejące marże zamiast tworzyć duplikaty
Jak działa deduplikacja?
Gdy importujesz plik zawierający produkty już istniejące w systemie:
System porównuje ID produktów
Najnowsze dane zastąpią stare wartości marż
Otrzymasz potwierdzenie liczby zaktualizowanych pozycji
Zalety automatycznej deduplikacji:
✅ Bezpieczeństwo danych - brak ryzyka duplikowania
✅ Łatwość aktualizacji - możesz importować plik wielokrotnie
✅ Oszczędność czasu - nie musisz ręcznie sprawdzać duplikatów
Wymagania techniczne
Checklist formatowania pliku:
Format pliku:
[ ] Rozszerzenie: .csv
[ ] Separator: przecinkowy (,)
[ ] Kodowanie: UTF-8
[ ] Struktura: bez zmian względem szablonu
Zawartość danych:
[ ] ID produktów: zgodne z plikiem produktowym
[ ] Wartości numeryczne: używają kropki jako separatora dziesiętnego
[ ] Brak pustych wierszy w środku danych
[ ] Kompletne dane w każdym wierszu
Przed importem sprawdź:
[ ] Plik produktowy zaimportowany (status zielony)
[ ] Szablon nie został zmodyfikowany strukturalnie
[ ] Dane zostały sprawdzone pod kątem błędów
[ ] Plik zapisany w formacie CSV z prawidłowym kodowaniem
Sekcja Q&A
Co się stanie, jeśli zaimportuję marże bez wcześniejszego importu produktów?
System nie pozwoli na import marż bez wcześniejszego zaimportowania pliku produktowego. Otrzymasz komunikat błędu. Upewnij się, że plik produktowy ma status "zaimportowany sukcesem" (zielony kolor) przed próbą dodania marż.
Czy mogę edytować szablon marż?
Nie zmieniaj struktury szablonu - nagłówków kolumn, ich kolejności ani formatowania. Możesz tylko wypełniać wiersze danymi. Modyfikacja struktury może prowadzić do błędów importu.
Co zrobić, jeśli import marż się nie powiódł?
Sprawdź następujące elementy:
Status pliku produktowego - czy jest zaimportowany pomyślnie?
Format pliku - czy to CSV z separatorem przecinkowym?
Kodowanie - czy plik jest zapisany w UTF-8?
Struktura danych - czy nie zmieniałeś nagłówków szablonu?
ID produktów - czy odpowiadają tym z pliku produktowego?
Jak często mogę aktualizować marże?
Możesz aktualizować marże tak często, jak potrzebujesz. System automatycznie usuwa duplikaty i aktualizuje istniejące dane nowymi wartościami.
Czy mogę importować częściowe dane marż?
Tak, możesz importować marże tylko dla części produktów. Nie musisz wypełniać marż dla wszystkich produktów naraz. Produkty bez zdefiniowanych marż będą używać domyślnych wartości systemowych.
Co się stanie z moimi starymi danymi marż przy ponownym imporcie?
Stare dane marż dla produktów zawartych w nowym pliku zostaną zastąpione nowymi wartościami. Marże produktów nieobecnych w nowym pliku pozostaną bez zmian.
Ile czasu zajmuje przetworzenie pliku marż?
Nowo dodane marże przetworzą się w zależności od częstotliwości przetwarzania pliku produktowego w systemie Data Octopus, ale nie dłużej niż do 6 rano dnia kolejnego.
Czy mogę używać tego samego szablonu dla różnych sklepów?
Nie, każdy sklep ma własny szablon marż dostosowany do jego struktury produktowej. Zawsze pobieraj szablon z konta tego sklepu, dla którego chcesz dodać marże.
Rozwiązywanie problemów
Najczęstsze przyczyny problemów:
Brak zaimportowanego pliku produktowego
Modyfikacja struktury szablonu
Niewłaściwe kodowanie pliku
Błędne ID produktów
Niewłaściwy format liczb (używanie przecinka zamiast kropki)
💡 Potrzebujesz dodatkowej pomocy? Skontaktuj się z zespołem wsparcia Data Octopus.