# Baza wiedzy - Dokumentacja
Tutaj poznasz możliwości instalacji, konfiguracji i korzystania z integracji Rovens. Poradnik krok po kroku przeprowadzi Cię przez najważniejsze etapy i pozwoli samodzielnie skonfigurować system.
# Jak zacząć
Aby korzystać z naszego systemu, najpierw zarejestruj się aby otrzymać swoje konto firmowe.
{% embed url="" %}
# Rejestracja na stronie
### 1**. Wprowadź dane**
W formularzu logowania wpisz:
* **Imię**
* **Nazwisko**
* **Numer NIP firmy**
* **Adres e-mail**
Kliknij przycisk **„Zarejestruj się”**.
### **2. Wiadomość potwierdzająca**
Otrzymasz od nas wiadomość potwierdzającą rejestracje. Kliknij aby potwierdzić.
### **3. Dostęp do panelu administracyjnego**
Otrzymasz kolejną wiadomość z dostępem zalogowania się do panelu
# Logowanie do panelu
### **1. Wejdź na stronę logowania**
👉 [**https://panel.rovens.pl/**](https://panel.rovens.pl/)
### **2. Wprowadź dane**
Wpisz login i hasło otrzymane w wiadomości e-mail.
# Instalacja Connectora
Connector służy do komunikacji pomiędzy Twoją bazą danych Wapro a wszystkimi integracjami dostępnymi w panelu Rovens. Należy pobrać instalator, zainstalować w miejscu w którym znajduje się baza danych Wapro.
{% embed url="" %}
# Pobieranie instalatora
### Kliknij w zakładkę
W panelu administracyjnym przejdź do zakładki "Pobierz connector"
### Kliknij link pobierania
Na stronie znajduje się link aby pobrać instalator
### Uruchom pobrany instalator
**Uwaga: Pamiętaj że pobrany instalator musi znajdować się na komputerze/serwerze w którym obecnie znajduje się baza danych programu Wapro.**
Rozpocznij proces instalacji
Kliknij instaluj
# Uruchomienie Connectora
### Otwórz skrót na pulpicie
Kliknij aby uruchomić skrót na pulpicie
### Wprowadź dane połączenia
W panelu, zakładka pobierz connector wyświetlane są dane dostępowe, adres e-mail połączenia oraz identyfikator połączenia. Dane należy wprowadzić do aplikacji Connector.
Po wprowadzeniu adresu e-mail oraz ID połączenia, wybierz bazę danych z którą aplikacja będzie się łączyć. Zapisz dane a następnie uruchom połączenie.
# Wybór magazynu i cennika
**Wybór magazynu oraz cennika to pierwszy, obowiązkowy krok po zainstalowaniu connectora.**\
Na tej podstawie pobierane są stany magazynowe z wybranego magazynu oraz ceny, które będą wykorzystywane we wszystkich dostępnych integracjach.\
W przypadku braku konfiguracji magazynu i cennika synchronizacja danych nie będzie możliwa.
{% embed url="" %}
# Ustawienie magazynu
### Kliknij w menu
W panelu administracyjnym przejdź do zakładki "Ustawienia" -> "Magazyn wybór"
### Wybierz magazyn docelowy
Kliknij w listę rozwijalną i wybierz magazyn. Kliknij zapisz.
# Ustawienie cennika
### Kliknij w menu
W panelu administracyjnym przejdź do zakładki "Ustawienia" -> "Cennik wybór"
### Wybierz cennik docelowy
Kliknij w listę rozwijalną i wybierz cennik. Kliknij zapisz.
# Integracje
**Rovens integracje i automatyzacje dla Wapro** oferuje szeroki wachlarz integracji zewnętrznych, które rozszerzają możliwości systemu Wapro Mag. Dzięki gotowym rozwiązaniom integracyjnym możesz w prosty sposób połączyć swój system z popularnymi platformami e-commerce, usługami kurierskimi, systemami księgowymi oraz narzędziami wspierającymi sprzedaż i zarządzanie magazynem.
Integracje te zostały zaprojektowane z myślą o automatyzacji powtarzalnych procesów, eliminacji błędów ludzkich oraz oszczędności czasu. W efekcie pozwalają jeszcze bardziej zwiększyć efektywność codziennej pracy oraz lepiej wykorzystać potencjał Twojej firmy.
Dzięki Rovens:
* zyskujesz pełną synchronizację danych między Wapro Mag a zewnętrznymi systemami,
* automatyzujesz procesy sprzedażowe i logistyczne,
* unikasz ręcznego wprowadzania danych i minimalizujesz ryzyko pomyłek,
* oszczędzasz czas i zwiększasz produktywność zespołu.
# Integracja WooCommerce z Wapro Mag
Integracja WooCommerce z Wapro Mag za pomocą systemu Rovens pozwala na pełną synchronizację danych pomiędzy sklepem internetowym a systemem ERP. Dzięki temu rozwiązaniu możliwa jest automatyczna wymiana informacji o produktach, stanach magazynowych, cenach, zamówieniach i klientach – bez potrzeby ręcznego przepisywania danych.
To połączenie znacząco usprawnia zarządzanie sprzedażą online i umożliwia pełną automatyzację procesów pomiędzy sklepem a magazynem, co przekłada się na oszczędność czasu, redukcję błędów oraz lepszą obsługę klienta.
W poniższej instrukcji krok po kroku przedstawiamy, jak poprawnie skonfigurować połączenie WooCommerce z Wapro Mag za pomocą programu Rovens.
### Kliknij w menu
W panelu administracyjnym przejdź do zakładki "Ustawienia" -> "Integracja WooCommerce"
### Wprowadź dane połączenia
**Integracja z WooCommerce opiera się na dostępie przez API.** W panelu sklepu przejdź do zakładki: WooCommerce -> Ustawienia -> Zaawansowane -> REST API Dodaj klucz wybierając uprawnienia: Zapis/Odczyt. Wygeneruj klucz API. Po utworzeniu tokenu i sekretnego klucza wprowadź odpowiednio w panelu administracyjnym Rovens.
**Uruchom synchronizacje** - Parametr oznacza czy zamówienia, stany magazynowe i ceny będą synchronizowane. Jeżeli wybierzesz NIE, dane nie będą synchronizowane.
**Domena sklepu** - domena Twojego sklepu bez http i https
**Token API** - Token wygenerowany w WooCommerce
**Sekretny klucz API** - Klucz wygenerowany w WooCommerce
**Testuj połączenie** - Testuje prawidłową komunikację z API WooCommerce.
**Zapisz ustawienia.**
Od tego momentu stany magazynowe i ceny będą automatycznie synchronizowane z Wapro Mag do WooCommerce. Dane powiązane są za pomocą Indeksu katalogowego w Wapro Mag a SKU w WooCommerce.
{% embed url="" %}
# Integracja PrestaShop z Wapro Mag
Integracja PrestaShop z Wapro Mag za pomocą systemu Rovens pozwala na pełną synchronizację danych pomiędzy sklepem internetowym a systemem ERP. Dzięki temu rozwiązaniu możliwa jest automatyczna wymiana informacji o produktach, stanach magazynowych, cenach, zamówieniach i klientach – bez potrzeby ręcznego przepisywania danych.
To połączenie znacząco usprawnia zarządzanie sprzedażą online i umożliwia pełną automatyzację procesów pomiędzy sklepem a magazynem, co przekłada się na oszczędność czasu, redukcję błędów oraz lepszą obsługę klienta.
W poniższej instrukcji krok po kroku przedstawiamy, jak poprawnie skonfigurować połączenie PrestaShop z Wapro Mag za pomocą programu Rovens.
### Kliknij w menu
W panelu administracyjnym przejdź do zakładki "Ustawienia" -> "Integracja PrestaShop"
### Wprowadź dane połączenia
**Integracja z PrestaShop opiera się na dostępie przez API.** W panelu sklepu przejdź do zakładki:
W panelu sklepu przejdź do zakładki: Zaawansowane -> API Dodaj nowy klucz API wybierając uprawnienia: GET, PUT, POST, HEAD. Wygeneruj klucz API. Po utworzeniu klucza wprowadź odpowiednio w panelu administracyjnym Rovens.
**Uruchom synchronizacje** - Parametr oznacza czy zamówienia, stany magazynowe i ceny będą synchronizowane. Jeżeli wybierzesz NIE, dane nie będą synchronizowane.
**Domena sklepu** - domena Twojego sklepu bez http i https
**Klucz API** - Klucz wygenerowany w PrestaShop
**Testuj połączenie** - Testuje prawidłową komunikację z API PrestaShop.
**Zapisz ustawienia.**
Od tego momentu stany magazynowe i ceny będą automatycznie synchronizowane z Wapro Mag do PrestaShop. Dane powiązane są za pomocą Indeksu katalogowego w Wapro Mag a SKU w PrestaShop.
# Jak włączyć Wapro API dla Wapro Mag
W celu umożliwienia zewnętrznej integracji z systemem **Wapro Mag** poprzez interfejs API, konieczne jest aktywowanie i skonfigurowanie modułu [**Wapro API**](/baza-wiedzy-dokumentacja/wapro-api), dostarczanego przez **Rovens**.
API Wapro może zostać wykorzystane do integracji z różnymi zewnętrznymi aplikacjami. Dzięki API możesz pobierać dane o produktach z Wapro i wysyłać zamówienia do Wapro.
### Kliknij w menu
W panelu administracyjnym przejdź do zakładki "Ustawienia" -> "Wapro API"
### Wygeneruj klucz API
Wprowadź nazwę oraz kliknij "Generuj klucz".
Wygenerowany klucz będzie w postaci ( ABC-ABC-XXX ). Kolejnym etapem jest implementacja Twojego systemu z Wapro Api. Lista metod dostępnych jest [tutaj](/baza-wiedzy-dokumentacja/wapro-api/lista-metod).
# Wapro API
API umożliwia wymianę informacji między systemem zewnętrznym a Wapro Mag.\
Komunikacja wykorzystuje dane w formacie JSON. Aby wysłać żądanie do API, wyślij odpowiednie żądanie POST na adres:
```
https://waproapi.rovens.pl/connect.php
```
Aby wysłać żądanie dla każdej metody wymagany jest token. Token jest przypisany bezpośrednio do konta użytkownika [Rovens](https://rovens.pl) - Wapro Linker. Użytkownik może wygenerować token API w panelu w sekcji Wapro API.\
Zalecana jest autoryzacja z nagłówkiem http (X-Rovens).
Przykład użycia:
```
curl 'https://waproapi.rovens.pl/connect.php' -H 'X-Rovens: ABC-ABC-XXX' --data-raw 'method=getProductsList&pages=1'
```
**Limit żądań**\
Limit żądań API wynosi **100 żądań na minutę**.
{% embed url="" %}
# Lista metod
# getCountProducts
Metoda zwraca łączną ilość produktów. Ta liczba może zostać wykorzystana do obliczenia paginacji.
Dane wejściowe:
```
{
"method":"getCountProducts"
}
```
* **method** varchar(100)
Dane wyjściowe:
```
{"count":2660}
```
* **count** int
# getProductsList
Metoda zwraca listę produktów. 1000 produktów na jedną stronę.
Dane wejściowe:
```
{
"method":"getProductsList",
"page": 1
}
```
* **method** varchar(100)
* **page** int
Dane wyjściowe:
```
{
"NR":1,
"ID_ARTYKULU":1,
"NAZWA":"Taśma do opakowania",
"STAN":29,
"INDEKS_KATALOGOWY":"KAT00001",
"RODZAJ":"Towar",
"KOD_KRESKOWY":"0000600003000",
"WAGA":0.3,
"JED_WAGI":"kg",
"WYMIAR_W":45,
"WYMIAR_S":145,
"WYMIAR_G":110,
"JED_WYMIARU":"mm",
"PRODUCENT":"EcoPack"
}
```
* **NR** int - Numer porządkowy
* **ID\_ARTYKULU** int - Identyfikator artykułu
* **NAZWA** varchar(800) - Nazwa artykułu
* **STAN** float - Ilość dostępnego towaru
* **INDEKS\_KATALOGWY** varchar(100) - Numer katalogowy artykułu
* **RODZAJ** varchar(10) - Rodzaj artykułu
* **KOD\_KRESKOWY** varchar(20) - EAN Artykułu
* **WAGA** float - Waga artykułu
* **JED\_WAGI** varchar(10) - Jednostka wagi artykułu
* **WYMIAR\_W** float - Wymiar wysokość artykułu
* **WYMIAR\_S** float - Wymiar szerokość artykułu
* **WYMIAR\_G** float - Wymiar głębokość artykułu
* **JED\_WYMIARU** varchar(10) - Jednostka wymiaru artykułu
* **PRODUCENT** varchar(100) - Nazwa producenta artykułu
# getProductId
Metoda zwraca jeden produkt dla wyznaczonego identyfikatora.
Dane wejściowe:
```
{
"method":"getProductId",
"id_artykulu": 1
}
```
* **method** varchar(100)
* **id\_artykulu** int
Dane wyjściowe:
```
{
"ID_ARTYKULU":1,
"NAZWA":"Taśma do opakowania",
"STAN":29,
"INDEKS_KATALOGOWY":"KAT00001",
"RODZAJ":"Towar",
"KOD_KRESKOWY":"0000600003000",
"WAGA":0.3,
"JED_WAGI":"kg",
"WYMIAR_W":45,
"WYMIAR_S":145,
"WYMIAR_G":110,
"JED_WYMIARU":"mm",
"PRODUCENT":"EcoPack"
}
```
* **ID\_ARTYKULU** int - Identyfikator artykułu
* **NAZWA** varchar(800) - Nazwa artykułu
* **STAN** float - Ilość dostępnego towaru
* **INDEKS\_KATALOGWY** varchar(100) - Numer katalogowy artykułu
* **RODZAJ** varchar(10) - Rodzaj artykułu
* **KOD\_KRESKOWY** varchar(20) - EAN Artykułu
* **WAGA** float - Waga artykułu
* **JED\_WAGI** varchar(10) - Jednostka wagi artykułu
* **WYMIAR\_W** float - Wymiar wysokość artykułu
* **WYMIAR\_S** float - Wymiar szerokość artykułu
* **WYMIAR\_G** float - Wymiar głębokość artykułu
* **JED\_WYMIARU** varchar(10) - Jednostka wymiaru artykułu
* **PRODUCENT** varchar(100) - Nazwa producenta artykułu
# getProductPrice
Metoda zwraca cenę produkt dla wyznaczonego identyfikatora.
Dane wejściowe:
```
{
"method":"getProductPrice",
"id_artykulu": 1
}
```
* **method** varchar(100)
* **id\_artykulu** int
Dane wyjściowe:
```
{
"ID_ARTYKULU":1,
"CENA_NETTO":489.43,
"CENA_BRUTTO":602
}
```
* **ID\_ARTYKULU** int - Identyfikator artykułu
* **CENA\_NETTO** float - Cena netto artykułu
* **CENA\_BRUTTO** float - Cena brutto artykułu
# addOrder
Metoda dodaje zamówienia.
Dane wejściowe:
```
{
"method":"addOrder",
"order": {
"zewnetrzne_id": "6625",
"zamowienie_status": "Do realizacji",
"metoda_platnosci": "PayPal",
"metoda_dostawy": "InPost",
"koszt_dostawy": "20",
"waluta_zamowienia": "PLN",
"email": "test@test.pl",
"telefon": "000999333",
"dostawa_imie": "Jan",
"dostawa_nazwisko": "Kowalski",
"dostawa_firma": "ABC Sp.z.o.o",
"dostawa_ulica": "Wspólna 23",
"dostawa_miasto": "Poznań",
"dostawa_kod": "00-333",
"dostawa_kraj": "PL",
"dostawa_telefon": "000999333",
"faktura_imie": "Jan",
"faktura_nazwisko": "Kowalski",
"faktura_firma": "ABC Sp.z.o.o",
"faktura_nip": "9994560099",
"faktura_ulica": "Wspólna 23",
"faktura_miasto": "Poznań",
"faktura_kod": "00-333",
"faktura_kraj": "PL",
"faktura_telefon": "000999333",
"extra_pole_1": "pole 1",
"extra_pole_2": "",
"produkty": [
{
"id_artykulu": 5434,
"nazwa": "Taśma do opakowania",
"indeks_katalogowy": "KAT00001",
"kod_kreskowy": "0000600003000",
"cena_brutto": 20.53,
"ilosc": 2
},
{
"id_artykulu": 5435,
"nazwa": "Taśma do opakowania",
"indeks_katalogowy": "KAT00002",
"kod_kreskowy": "0000600003000",
"cena_brutto": 10,
"ilosc": 4
}
]
}
}
```
* **method** varchar(100)
* **zewnetrzne\_id** varchar(50) - identyfikator zamówienia w systemie zewnętrznym
* **zamowienie\_status** varchar(100) - status zamówienia w systemie zewnętrznym
* **metoda\_platnosci** varchar(100) - metoda płatności w systemie zewnętrznym
* **metoda\_dostawy** varchar(100) - metoda dostawy w systemie zewnętrznym
* **koszt\_dostawy** varchar(20) - koszt dostawy zamówienia
* **waluta\_zamowienia** varchar(20) - waluta zamówienia
* **email** varchar(100) - e-mail kontrahenta
* **telefon** varchar(100) - telefon kontrahenta
* **dostawa\_imie** varchar(100) - imię kontrahenta do wysyłki
* **dostawa\_nazwisko** varchar(100) - nazwisko kontrahenta do wysyłki
* **dostawa\_firma** varchar(100) - firma kontrahenta do wysyłki
* **dostawa\_ulica** varchar(100) - ulica kontrahenta do wysyłki
* **dostawa\_miasto** varchar(100) - miasto kontrahenta do wysyłki
* **dostawa\_kod** varchar(10) - kod pocztowy kontrahenta do wysyłki
* **dostawa\_kraj** varchar(10) - kod kraju kontrahenta do wysyłki
* **dostawa\_telefon** varchar(20) - telefon kontrahenta do wysyłki
* **faktura\_imie** varchar(100) - imię kontrahenta do faktury
* **faktura\_nazwisko** varchar(100) - nazwisko kontrahenta do faktury
* **faktura\_firma** varchar(100) - nazwa firmy kontrahenta do faktury
* **faktura\_nip** varchar(20) - nip kontrahenta do faktury
* **faktura\_ulica** varchar(100) - ulica kontrahenta do faktury
* **faktura\_miasto** varchar(100) - miasto kontrahenta do faktury
* **faktura\_kod** varchar(10) - kod pocztowy kontrahenta do faktury
* **faktura\_kraj** varchar(10) - kod kraju kontrahenta do faktury
* **faktura\_telefon** varchar(20) - telefon kontrahenta do faktury
* **extra\_pole\_1** varchar(100) - pole dla dodatkowych informacji
* **extra\_pole\_2** varchar(100) - pole dla dodatkowych informacji
* **produkty** Array
* **id\_artykulu** int - ID artykułu z systemu Wapro Mag
* **nazwa** varchar(250) - nazwa artykułu
* **indeks\_katalogowy** varchar(50) - indeks katalogowy artykułu
* **kod\_kreskowy** varchar(20) - EAN artykułu
* **cena\_brutto** float - cena artykułu
* **ilosc** int - ilość artykułu
Dane wyjściowe:
```
{
"status":"ok",
"id_zamowienia":85
}
```
* **status** varchar - informacja o dodaniu zamówienia
* **id\_zamowienia** int - identyfikator zamówienia
