WooCommerce integracija

Prenosi proizvode iz tvoje WordPress prodavnice koja koristi WooCommerce. Povezivanje ide preko WooCommerce REST API ključa koji sam napraviš i možeš ga opozvati u bilo kojem trenutku.

Poveži WooCommerce

Šta ti treba

WooCommerce prodavnicu dostupnu na javnoj adresi preko HTTPS-a (npr. https://mojaprodavnica.ba).
Pristup WordPress administraciji kao Administrator ili Shop Manager.
Trajne veze (Permalinks) koje nisu postavljene na „Plain“ — inače WooCommerce API nije dostupan.

Kako povezati

Sedam koraka, svaki sa slikom ekrana — klikni sliku da je otvoriš u punoj veličini.

1. dio — napravi API ključ u WordPressu

1. Otvori REST API postavke
U WordPress administraciji idi na WooCommerce → Settings i otvori posljednju karticu Advanced. Ispod kartica se pojavi red manjih linkova (Page setup, REST API, Webhooks…) — klikni REST API, pa „Add key“ (ili „Create an API key“ ako još nemaš nijedan ključ). Ako je WordPress na lokalnom jeziku, nazivi menija su prevedeni, ali je raspored isti.
2. Popuni podatke o ključu
- Description: npr. „OnlinePijaca.ba“, da kasnije znaš čemu ključ služi.
- User: korisnik sa ulogom Administrator ili Shop Manager.
- Permissions: Read (samo čitanje) — više nam ne treba, jer u tvojoj prodavnici ništa ne mijenjamo.
3. Generiši i kopiraj ključeve
Klikni „Generate API key“ i kopiraj Consumer key (počinje sa ck_) i Consumer secret (počinje sa cs_). WooCommerce prikazuje secret samo jednom — ako ga izgubiš, napravi novi ključ.

2. dio — poveži prodavnicu na OnlinePijaca.ba

4. Otvori WooCommerce integraciju
Prijavi se, u glavnom meniju klikni Integracije, pa na kartici WooCommerce „Poveži WooCommerce“ (ili otvori WooCommerce integraciju direktno).
5. Unesi podatke prodavnice
Upiši URL dućana sa https:// na početku, pa zalijepi Consumer Key i Consumer Secret iz 1. dijela i klikni „Poveži dućan“.
6. Provjeri vezu
Vezu provjeravamo odmah: poruka „Uspješno ste se povezali s WooCommerce dućanom.“ znači da je sve u redu. Ključeve čuvamo enkriptovane.
7. Pokreni uvoz
Po želji uključi automatsku dnevnu sinkronizaciju (svaki dan oko 02:00), pa klikni „Pokrenite uvoz sada“. Prenose se svi objavljeni proizvodi koji su na zalihama (do 5.000 po jednom uvozu).

Rezultat

Za nekoliko sekundi proizvodi su na tvom profilu, sa slikama, cijenama i kategorijama.

Fotografije proizvoda u testnoj prodavnici: Wikimedia Commons — 茅野ふたば, Maksdroider, Osh33m, Ganesh Mohan T i KKPCW (Kyu3) pod licencom CC BY-SA 4.0; ostale CC0.

Šta se prenosi

Samo proizvodi sa statusom Published (objavljeni). Skice, privatni i proizvodi na čekanju se preskaču.
Naslov i opis (ili kratki opis, ako opis nije unesen), bez formatiranja.
Cijena, zaokružena na cijeli iznos. Ako je proizvod na akciji, prikazuje se redovna cijena sa popustom. Proizvod bez cijene (ili ispod 1 KM) uvozi se kao „po dogovoru“, nikad kao besplatan.
Do 10 fotografija po proizvodu.
Kategorija — biramo je prema svim kategorijama proizvoda u WooCommerce-u, zajedno sa nadređenim kategorijama (npr. „Televizori › 55”“), i prema nazivu proizvoda. Ako ne nađemo odgovarajuću, proizvod ide u kategoriju „Sve ostalo“.
Proizvodi sa varijantama (npr. veličine ili boje) uvoze se kao jedan oglas sa osnovnom cijenom.
Zalihe se prate: proizvodi kojih nema na zalihama („Out of stock“) ne uvoze se. Ako uvezeni proizvod ostane bez zaliha, oglas se označava kao prodan i ponovo postaje aktivan pri prvom uvozu nakon što ga vratiš na zalihe. Proizvodi koji se mogu naručiti unaprijed („On backorder“) ostaju aktivni.
Stanje se postavlja na novo, osim ako naziv ili kategorija kažu drugačije („korišteno“, „polovno“, „refurbished“…). Ako ga promijeniš, ta izmjena ostaje i nakon sljedećih uvoza.

Ponovni uvoz i automatska sinkronizacija

Izmjene radi na izvoru, ne ovdje

Svaki ponovni uvoz prepisuje naslov, opis, cijenu, kategoriju i fotografije podacima sa OLX.ba ili iz WooCommerce-a. Izmjene koje napraviš na uvezenom oglasu ovdje bit će zamijenjene pri sljedećem uvozu. Isto tako, oglas koji ovdje obrišeš ili označiš kao prodan ponovo će se pojaviti ako je na izvoru i dalje aktivan.

Dnevna sinkronizacija — u postavkama integracije možeš uključiti automatski uvoz koji se pokreće svaki dan oko 02:00 (po sarajevskom vremenu). Tako cijene i novi oglasi stižu bez tvoje intervencije.
Označi kao prodano — ako je opcija uključena, oglasi koji su nestali sa izvora (prodani ili uklonjeni na OLX-u, odnosno više nisu objavljeni u WooCommerce-u) automatski se označavaju kao prodani. Ne brišemo ih.
Zaustavljanje uvoza — uvoz koji je u toku možeš zaustaviti. Novi uvoz tada možeš pokrenuti nakon 10 minuta.
Istovremeno može raditi samo jedan uvoz po integraciji.

Česti problemi

›„URL trgovine mora biti javna web adresa“

Prodavnica mora biti dostupna sa interneta na standardnoj adresi (npr. https://mojaprodavnica.ba). Lokalne adrese, IP adrese interne mreže i nestandardni portovi nisu podržani.

›„WooCommerce API podaci nisu validni“

Consumer Key ili Consumer Secret nije tačan ili je ključ opozvan. Najlakše je napraviti novi ključ (vidi korake iznad) i pažljivo kopirati obje vrijednosti, bez razmaka na početku ili kraju. Provjeri i da adresa prodavnice počinje sa https://.

›Greška sa „status code 404“ pri povezivanju

WooCommerce API nije dostupan na toj adresi. Provjeri da je WooCommerce aktivan i da trajne veze nisu „Plain“: u WordPressu otvori Settings → Permalinks i odaberi npr. „Post name“, pa sačuvaj.

›Sinkronizacija je „blokirana“

To znači da OLX token ili WooCommerce ključ više ne važi (npr. promijenjena lozinka ili opozvan API ključ). Ponovo se prijavi OLX računom, odnosno napravi novi WooCommerce ključ i ponovo poveži prodavnicu. Dok se to ne uradi, dnevna sinkronizacija se ne pokreće.

›Oglas je u pogrešnoj kategoriji

Otvori oglas u Mojim oglasima i promijeni kategoriju. Pri izmjeni ćemo možda tražiti da popuniš obavezne karakteristike za tu kategoriju. Da ne bi ponovni uvoz vratio staru kategoriju, uskladi kategoriju i na izvoru.

›Neki oglasi nisu uvezeni

Broj grešaka vidiš u historiji uvoza. Najčešći razlozi su nedostupne fotografije ili privremeni problem na izvoru — pokreni uvoz ponovo, već uvezeni oglasi se neće duplirati.

Prodaješ na OLX.ba? Vodič za OLX →

Treba ti pomoć?

Piši nam na podrska@onlinepijaca.ba i navedi koju integraciju koristiš i tekst greške koji vidiš. Ostala pitanja pokrivamo u FAQ odjeljku.

Učitavanje…

WooCommerce integracija

Prenosi proizvode iz tvoje WordPress prodavnice koja koristi WooCommerce. Povezivanje ide preko WooCommerce REST API ključa koji sam napraviš i možeš ga opozvati u bilo kojem trenutku.

Poveži WooCommerce

Šta ti treba

WooCommerce prodavnicu dostupnu na javnoj adresi preko HTTPS-a (npr. https://mojaprodavnica.ba).
Pristup WordPress administraciji kao Administrator ili Shop Manager.
Trajne veze (Permalinks) koje nisu postavljene na „Plain“ — inače WooCommerce API nije dostupan.

Kako povezati

Sedam koraka, svaki sa slikom ekrana — klikni sliku da je otvoriš u punoj veličini.

1. dio — napravi API ključ u WordPressu

1. Otvori REST API postavke
U WordPress administraciji idi na WooCommerce → Settings i otvori posljednju karticu Advanced. Ispod kartica se pojavi red manjih linkova (Page setup, REST API, Webhooks…) — klikni REST API, pa „Add key“ (ili „Create an API key“ ako još nemaš nijedan ključ). Ako je WordPress na lokalnom jeziku, nazivi menija su prevedeni, ali je raspored isti.
2. Popuni podatke o ključu
- Description: npr. „OnlinePijaca.ba“, da kasnije znaš čemu ključ služi.
- User: korisnik sa ulogom Administrator ili Shop Manager.
- Permissions: Read (samo čitanje) — više nam ne treba, jer u tvojoj prodavnici ništa ne mijenjamo.
3. Generiši i kopiraj ključeve
Klikni „Generate API key“ i kopiraj Consumer key (počinje sa ck_) i Consumer secret (počinje sa cs_). WooCommerce prikazuje secret samo jednom — ako ga izgubiš, napravi novi ključ.

2. dio — poveži prodavnicu na OnlinePijaca.ba

4. Otvori WooCommerce integraciju
Prijavi se, u glavnom meniju klikni Integracije, pa na kartici WooCommerce „Poveži WooCommerce“ (ili otvori WooCommerce integraciju direktno).
5. Unesi podatke prodavnice
Upiši URL dućana sa https:// na početku, pa zalijepi Consumer Key i Consumer Secret iz 1. dijela i klikni „Poveži dućan“.
6. Provjeri vezu
Vezu provjeravamo odmah: poruka „Uspješno ste se povezali s WooCommerce dućanom.“ znači da je sve u redu. Ključeve čuvamo enkriptovane.
7. Pokreni uvoz
Po želji uključi automatsku dnevnu sinkronizaciju (svaki dan oko 02:00), pa klikni „Pokrenite uvoz sada“. Prenose se svi objavljeni proizvodi koji su na zalihama (do 5.000 po jednom uvozu).

Rezultat

Za nekoliko sekundi proizvodi su na tvom profilu, sa slikama, cijenama i kategorijama.

Fotografije proizvoda u testnoj prodavnici: Wikimedia Commons — 茅野ふたば, Maksdroider, Osh33m, Ganesh Mohan T i KKPCW (Kyu3) pod licencom CC BY-SA 4.0; ostale CC0.

Šta se prenosi

Samo proizvodi sa statusom Published (objavljeni). Skice, privatni i proizvodi na čekanju se preskaču.
Naslov i opis (ili kratki opis, ako opis nije unesen), bez formatiranja.
Cijena, zaokružena na cijeli iznos. Ako je proizvod na akciji, prikazuje se redovna cijena sa popustom. Proizvod bez cijene (ili ispod 1 KM) uvozi se kao „po dogovoru“, nikad kao besplatan.
Do 10 fotografija po proizvodu.
Kategorija — biramo je prema svim kategorijama proizvoda u WooCommerce-u, zajedno sa nadređenim kategorijama (npr. „Televizori › 55”“), i prema nazivu proizvoda. Ako ne nađemo odgovarajuću, proizvod ide u kategoriju „Sve ostalo“.
Proizvodi sa varijantama (npr. veličine ili boje) uvoze se kao jedan oglas sa osnovnom cijenom.
Zalihe se prate: proizvodi kojih nema na zalihama („Out of stock“) ne uvoze se. Ako uvezeni proizvod ostane bez zaliha, oglas se označava kao prodan i ponovo postaje aktivan pri prvom uvozu nakon što ga vratiš na zalihe. Proizvodi koji se mogu naručiti unaprijed („On backorder“) ostaju aktivni.
Stanje se postavlja na novo, osim ako naziv ili kategorija kažu drugačije („korišteno“, „polovno“, „refurbished“…). Ako ga promijeniš, ta izmjena ostaje i nakon sljedećih uvoza.

Ponovni uvoz i automatska sinkronizacija

Izmjene radi na izvoru, ne ovdje

Dnevna sinkronizacija — u postavkama integracije možeš uključiti automatski uvoz koji se pokreće svaki dan oko 02:00 (po sarajevskom vremenu). Tako cijene i novi oglasi stižu bez tvoje intervencije.
Označi kao prodano — ako je opcija uključena, oglasi koji su nestali sa izvora (prodani ili uklonjeni na OLX-u, odnosno više nisu objavljeni u WooCommerce-u) automatski se označavaju kao prodani. Ne brišemo ih.
Zaustavljanje uvoza — uvoz koji je u toku možeš zaustaviti. Novi uvoz tada možeš pokrenuti nakon 10 minuta.
Istovremeno može raditi samo jedan uvoz po integraciji.

Česti problemi

›„URL trgovine mora biti javna web adresa“

Prodavnica mora biti dostupna sa interneta na standardnoj adresi (npr. https://mojaprodavnica.ba). Lokalne adrese, IP adrese interne mreže i nestandardni portovi nisu podržani.

›„WooCommerce API podaci nisu validni“

›Greška sa „status code 404“ pri povezivanju

›Sinkronizacija je „blokirana“

›Oglas je u pogrešnoj kategoriji

›Neki oglasi nisu uvezeni

Broj grešaka vidiš u historiji uvoza. Najčešći razlozi su nedostupne fotografije ili privremeni problem na izvoru — pokreni uvoz ponovo, već uvezeni oglasi se neće duplirati.

Prodaješ na OLX.ba? Vodič za OLX →

Treba ti pomoć?

Piši nam na podrska@onlinepijaca.ba i navedi koju integraciju koristiš i tekst greške koji vidiš. Ostala pitanja pokrivamo u FAQ odjeljku.

WooCommerce integracija

Šta ti treba

Kako povezati

1. dio — napravi API ključ u WordPressu

1. Otvori REST API postavke

2. Popuni podatke o ključu

3. Generiši i kopiraj ključeve

2. dio — poveži prodavnicu na OnlinePijaca.ba

4. Otvori WooCommerce integraciju

5. Unesi podatke prodavnice

6. Provjeri vezu

7. Pokreni uvoz

Rezultat

Šta se prenosi

Ponovni uvoz i automatska sinkronizacija

Izmjene radi na izvoru, ne ovdje

Česti problemi

Treba ti pomoć?

WooCommerce integracija

Šta ti treba

Kako povezati

1. dio — napravi API ključ u WordPressu

1. Otvori REST API postavke

2. Popuni podatke o ključu

3. Generiši i kopiraj ključeve

2. dio — poveži prodavnicu na OnlinePijaca.ba

4. Otvori WooCommerce integraciju

5. Unesi podatke prodavnice

6. Provjeri vezu

7. Pokreni uvoz

Rezultat

Šta se prenosi

Ponovni uvoz i automatska sinkronizacija

Izmjene radi na izvoru, ne ovdje

Česti problemi

Treba ti pomoć?