1. softkom
  2. baza znanja
  3. instalacija i podešavanje
  4. sors woo commerce plug-in

SORS WOO COMMERCE PLUG-IN

Sors WooCommerce plug-in je rešenje otvorenog koda i koristi se za sinhronizaciju između web prodavnice koja je razvijena pomoću WooCommerce i baze podataka programa Sors.

Iz baze podataka Sors u bazu podataka WooCommerce plug-in prenosi sledeće podatke:

  1. Šifarnik artikala
  2. Cene
  3. Stanje zaliha
  4. Slike artikala

Iz baze podataka WooCommerce u bazu podataka Sors plug-in prenosi sledeće podatke:

  1. Narudžbine
  2. Kupce

Sinhronizacija podataka može da se vrši automatski ili ručno.

SADRŽAJ

Uslovi korišćenja
Kompatibilnost i ograničenja
Instalacija
Povezivanje sa bazom podataka programa Sors
Sinhronizacija artikala
Sinhronizacija cena i stanja zaliha
Sinhronizacija narudžbina i kupaca
Sinhronizacija slika artikala

USLOVI KORIŠĆENJA

Plug-in je besplatan i dostupan korisnicima koji imaju zakupljenu bazu podataka u Softkom serveru i pretplatu na API.

Plug-in je rešenje otvorenog koda. Izvorni kod je dostupan i može se pregledati, menjati i prilagođavati sopstvenim potrebama.

Softkom ne vrši prilagođavanje plug-ina specifičnim potrebama korisnika i ne pruža podršku za izmene izvornog koda. Eventualne izmene izvornog koda korisnici mogu izvršiti samostalno ili angažovanjem treće strane. Softkom ne snosi odgovornost za eventualne probleme koji mogu da nastanu kao posledica izmene izvornog koda.

Izvorni kod plug-ina nalazi se na GitHub na adresi: https://github.com/softkom-rs/sors-api-for-woocommerce

KOMPATIBILNOSTI I OGRANIČENJA

PHP verzija: 7.4 ili veća
Word press - minimalna verzija: 6.0
Word press - testirano do verzije: 6.9.4

Plug-in je razvijen za rad u podrazumevanom WooCommerce okruženju. To znači da funkcioniše ispravno kada se koriste standardna WooCommerce podešavanja, bez dodatnih prilagođavanja ili izmena.

U slučaju da su u WooCommerce okruženju vršene izmene (u bazi podataka ili drugim komponentama), plug-in će možda morati dodatno da se prilagodi tim izmenama. Takva prilagođavanja nisu u nadležnosti Softkom-a i obavlja ih treća strana, u skladu sa uslovima korišćenja.

INSTALACIJA

Instalacija može da se izvrši iz WordPress Plugin Directory. Plug-in možete da pronađete ako u polje za pretragu upišete Sors (slika ispod).

Instalacija iz WordPress Plugin Directory

POVEZIVANJE SA BAZOM PODATAKA PROGRAMA SORS

Plug-inu možete da pristupite preko WordPress admin panela tako što u levom navigacionom meniju kliknete na stavku Sors API (broj 1 na slici).

Povezivanje plug-ina sa bazom podataka Sors

U kartici Izbor baze (broj 2 na slici) potrebno je da izvršite upis API ključa i izbor baze podataka.

U polje API ključ (broj 3 na slici) unesite API ključ koji ste dobili od Softkoma i kliknite na dugme Sačuvaj (broj 4 na slici).

Nakon toga prikazaće se meni sa spiskom baza podataka (broj 1 na slici ispod). U ovom meniju izaberite bazu podataka sa kojom želite da sinhronizujete WooCommerce prodavnicu i kliknite na dugme Sačuvaj (broj 2 na slici ispod).

Povezivanje plug-ina sa bazom podataka Sors

SINHRONIZACIJA ARTIKALA

Pod sinhronizacijom artikala podrazumeva se preuzimanje kompletnog šifarnika artikala iz baze podataka programa Sors i upis u bazu podataka WooCommerce.

Sinhronizacija artikala može da se izvršava automatski, u određenim vremenskim intervalima, ili ručnim izdavanjem komande.

RAD PLUG-INA BEZ SINHRONIZACIJE ARTIKALA

Preuzimanje šifarnika artikala iz baze programa Sors nije obavezno da bi se vršile ostale sinhronizacije (cena, zaliha, narudžbina i slika artikala).

Međutim, da bi ove sinhronizacije mogle da se izvrše, neophodno je da šifra artikla (SKU) bude identična u bazama WooCommerce i Sors, jer se sve ostale sinhronizacije vrše upravo na osnovu šifre artikla (SKU).

PODEŠAVANJE SINHRONIZACIJE ARTIKALA

Podešavanja vezana za sinhronizaciju artikala nalaze se u kartici Podešavanja (broj 1 na slici ispod), u sekciji Šifarnik artikala (broj 2 na slici ispod).

Podešavanje sinhronizacije artikala

Automatska sinhronizacija artikala vrši se u intervalu izraženom u satima, koji se unosi u polje Period sinhronizacije (broj 4 na slici). Na primer, ako je u polje Period sinhronizacije uneta vrednost 24, sinhronizacija će se vršiti na svakih 24 sata.

Postoje dva načina na koji artikli mogu biti upisani u bazu podataka WooCommerce:

  • Ažuriranjem postojećih artikala. Primenjuje se ako opcija Obriši sve artikle preuzete iz programa Sors pre sinhronizacije (broj 3 na slici) nije čekirana i podrazumeva sledeće:
    • za svaki artikal preuzet iz baze podataka Sors proverava se da li već postoji u WooCommerce. Provera se vrši na osnovu šifre artikla (SKU).
    • Ako artikal postoji u bazi podataka WooCommerce, ažuriraju se podaci o artiklu (naziv, robna grupa ...).
    • Ako artikal ne postoji u bazi podataka WooCommerce, upisuje se kao novi artikal.
  • Ponovnim upisom artikala. Primenjuje se ako je čekirana opcija Obriši sve artikle preuzete iz programa Sors pre sinhronizacije (broj 3 na slici).
    Ovaj način podrazumeva da se prvo obrišu svi artikli u WooCommerce koji su prethodno uvezeni iz baze podataka Sors i da se zatim ponovo upišu. U ovom slučaju biće obrisani samo artikli koji su prethodno uvezeni iz baze podataka Sors - artikli koji su u WooCommerce upisani na drugi način neće biti obrisani.

Pošto završite sa podešavanjem kliknite na dugme Sačuvaj koje je na slici označeno brojem 5.

POSTUPAK SINHRONIZACIJE ARIKALA

Sinhronizacija artikala pokreće se u kartici Sinhronizacija (broj 1 na slici ispod), u sekciji Šifarnik artikala (broj 2 na slici ispod).

Sinhronizacija  artikala

U delu koji je na slici označen brojem 4, klikom na odgovarajuće dugme, vrši se pokretanje ili zaustavljanje automatske sinhronizacije. Automatska sinhronizacija se vrši u pozadini, u intervalu koji je upisan u kartici Podešavanja.

Ručna sinhronizacija pokreće se klikom na dugme Sinhronizuj šifarnik artikala (deo označen brojem 5 na slici).

U delu koji je na slici označen brojem 3, prikazuje se status sinhronizacije artikala i informacije vezane za poslednju sinhronizaciju artikala.

SINHRONIZACIJA CENA I STANJA ZALIHA

Pod sinhronizacijom cena i stanja zaliha podrazumeva se preuzimanje cena i stanja zaliha iz baze podataka programa Sors i upis u bazu podataka WooCommerce.

Sinhronizacija cena i stanja zaliha može da se izvršava automatski, u određenim vremenskim intervalima, ili ručnim izdavanjem komande.

Prilikom sinhronizacije cena i stanja zaliha primenjuje se sledeća procedura:

  1. Preuzimaju se prodajne cene i stanje zaliha iz baze podataka Sors.
  2. Na osnovu šifre artikla (SKU) u bazi podataka WooCommerce pronalazi se odgovarajući artikal i ažuriraju se njegova cena i stanje zaliha.

RAD PLUG-INA BEZ SINHRONIZACIJE CENA I STANJA ZALIHA

Sinhronizacija cena i stanja zaliha nije obavezna da bi se vršile ostale sinhronizacije (artikala, slika i narudžbina).

PODEŠAVANJE SINHRONIZACIJE CENA I STANJA ZALIHA

Podešavanja vezana za sinhronizaciju cena i stanja zaliha vrše se u kartici Podešavanja (broj 1 na slici ispod), u sekciji Stanje zaliha i cene (broj 2 na slici ispod).

Podešavanje sinhronizacije cena i stanja zaliha

Automatska sinhronizacija stanja zaliha i cena vrši se u intervalu koji je izražen u satima i koji treba da bude upisan u polje Period sinhronizacije (broj 4 na slici). Na primer, ako je u polje Period sinhronizacije uneta vrednost 24, sinhronizacija će se vršiti na svakih 24 sata.

U poslovnom softveru Sors isti artikal može da ima različite cene u različitim poslovnim jedinicama. U meniju Poslovna jedinica iz koje se preuzimaju cene (deo označen brojem 3 na slici ) treba da izaberete poslovnu jedinicu iz koje će cene biti preuzete.

U meniju Tip cene koja se prikazuje u WooCommerce (deo označen brojem 3 na slici ) treba da izaberete vrstu cene koja će biti upisana u WooCommerce - cena sa PDV ili cena bez PDV.

U sekciji Poslovne jedinice iz kojih se preuzima stanje zaliha (deo označen brojem 3 an slici) nalaze se tri opcije za izbor poslovne jedinice iz koje će biti preuzeto stanje zaliha:

  1. Koristi se ista poslovna jedinica kao za cene - preuzima se stanje zaliha iz iste poslovne jedinice iz koje se preuzimaju cene.
  2. Suma stanja zaliha iz svih poslovnih jedinica - preuzima se stanje zaliha iz svih poslovnih jedinica zbirno.
  3. Samo izabrane poslovne jedinice. Ako izaberete ovu opciju prikazaće spisak svih poslovnih jedinica (slika ispod) i biće preuzeto zbirno stanje zaliha iz selektovanih poslovnih jedinica.
Izbor poslovnih jedinica iz kojih se preuzima stanje zaliha

Pošto završite sa podešavanjem kliknite na dugme Sačuvaj koje je na slici označeno brojem 5.

POSTUPAK SINHRONIZACIJE CENA I STANJA ZALIHA

Sinhronizacija cena i stanja zaliha pokreće se u kartici Sinhronizacija (broj 1 na slici ispod), u sekciji Stanje zaliha i cene (broj 2 na slici ispod).

Sinhronizacija cena i stanja zaliha

U delu koji je na slici označen brojem 4, klikom na odgovarajuće dugme, vrši se pokretanje ili zaustavljanje automatske sinhronizacije. Automatska sinhronizacija se vrši u pozadini, u intervalu koji je upisan u kartici Podešavanja.

Ručnu sinhronizaciju možete da pokrenete ako kliknete na dugme Sinhronizuj stanje zaliha i cene (deo koji je na slici označen brojem 5).

U delu koji je na slici označen brojem 3, prikazuje se status sinhronizacije cena i stanja zaliha kao i informacije vezane za poslednju sinhronizaciju.

SINHRONIZACIJA NARUDŽBINA I KUPACA

Pod sinhronizacijom narudžbina i kupaca podrazumeva se preuzimanje narudžbina i kupaca koji su izvršili narudžbinu iz WooCommerce baze podataka i upis u bazu podataka Sors.

Upis u bazu programa Sors vrši se automatski, odmah pošto kupac izvrši narudžbinu u web prodavnici.

Da bi narudžbine mogle da budu upisane u bazu podataka Sors neophodno je da šifre naručenih artikala (SKU) budu identične u bazama podataka Sors i WooCommerce.

RAD PLUG-INA BEZ SINHRONIZACIJE NARUDŽBINA

Sinhronizacija narudžbina nije obavezna da bi se vršile ostale sinhronizacije (artikala, stanja zaliha, cena i slika).

PODEŠAVANJE SINHRONIZACIJE NARUDŽBINA

Podešavanja vezana za upis narudžbina nalaze se u kartici Podešavanja (broj 1 na slici ispod), u sekciji Narudžbine (broj 2 na slici ispod).

Podešavanje sinhronizacije narudžbina i kupaca

Da bi se narudžbine prosleđivale u bazu programa Sors, potrebno je da čekirate opciju Narudžbine se automatski prosleđuju u program Sors (deo označen brojem 3 na slici). Ako ova opcija nije čekirana, narudžbine se neće prosleđivati, a sve ostale opcije u sekciji Narudžbine biće nedostupne.

Ako koristite verziju WooCommerce 3.5 i veću, preporučujemo da čekirate opciju Narudžbine se prosleđuju asinhrono (preporuka) (deo označen brojem 3 na slici). Ova opcija omogućava da kupac ne mora da čeka potvrdu da je narudžbina upisana u bazu podataka Sors - u nekim situacijama čekanje na potvrdu može da pogorša korisničko iskustvo.

U meniju Tip dokumenta u Sorsu (deo označen brojem 3 na slici) bira se vrsta dokumenta u programu Sors u kome će narudžbine biti prikazane. Narudžbine u programu Sors mogu da budu prikazane u formi jednog od sledećih dokumenata:

  1. Rezervacija
  2. Otpremnica
  3. Otpremnica PF
  4. Račun-otpremnica
  5. Račun
  6. Revers

PODEŠAVANJE SINHRONIZACIJE KUPACA

Dokument koji se u programu Sors formira na osnovu narudžbine mora da bude povezan sa kupcem, a kupac sa kojim se dokument povezuje mora da bude upisan u šifarnik kupaca programa Sors.

U delu koji je na slici označen brojem 4 postoje dve opcije vezane za povezivanje kupaca i narudžbina:

  1. Svi dokumenti se povezuju sa istim kupcem - svi dokumenti koji se u programu Sors formiraju na osnovu narudžbina biće povezani sa istim kupcem. Naziv kupca mora da bude upisan u polje ispod ove opcije i mora da bude isti kao u šifarniku kupaca programa Sors.
  2. Dokument se povezuje sa kupcem koji je izvršio narudžbinu - kupac koji je izvršio narudžbinu će biti upisan u šifarnik kupaca programa Sors a zatim povezan sa dokumentom. Ako kupac već postoji u šifarniku kupaca, neće biti ponovo upisan. Provera postojanja kupca vrši se na sledeći način:
    • za fizička lica na osnovu e-mail adrese
    • za pravna lica na osnovu PIB-a.

Kada je izabrana opcija Dokument se povezuje sa kupcem koji je izvršio narudžbinu, u retkim slučajevima, može da nastane greška prilikom upisa kupca ili prilikom povezivanja kupca sa dokumentom. U takvoj situaciji dokument će biti povezan sa kupcem čiji je naziv upisan u polje koje se nalazi ispod ove opcije. Naziv kupca mora biti isti kao u šifarniku kupaca programa Sors.

SNIMANJE PODEŠAVANJA SINHRONIZACIJE NARUDŽBINA I KUPACA

Pošto završite sa podešavanjem kliknite na dugme Sačuvaj koje je na slici označeno brojem 5.

SINHRONIZACIJA SLIKA ARTIKALA

Pod sinhronizacijom slika artikala podrazumeva se preuzimanje slika artikala iz šifarnika artikala programa Sors i upis u bazu podataka WooCommerce.

Sinhronizacija slika artikala ne može da se izvršava automatski već isključivo ručnim izdavanjem komande.

Slike artikala se sinhronizuju na sledeći način:

  1. Iz baze podataka Sors preuzima se spisak svih artikala koji sadrže slike
  2. Preuzimaju se slike svakog artikla iz spiska
  3. Na osnovu šifre artikla (SKU) u bazi podataka WooCommerce pronalazi se odgovarajući artikal iz spiska a zatim se postupa na sledeći način:
    • Iz baze podataka WooCommerce se brišu slike artikla koje su prethodno uvezene iz baze podataka Sors. Biće obrisane samo slike koje su prethodno uvezene iz baze podataka Sors - slike koje su upisane na drugi način neće biti obrisane.
    • U bazu podataka WooCommerce se upisuju slike preuzete u koraku 2.

Zbog optimizacije opterećenja Softkom servera preuzimanje slika je ograničeno na 50 artikala na sat.

POSTUPAK SINHRONIZACIJE

Postupak sinhronizacije možete da započnete u kartici Sinhronizacija (broj 1 na slici ispod) u sekciji Slike artikala (broj 2 na slici ispod).

Sinhronizacija slika artikala

Sinhronizaciju slika svih artikala možete da pokrenete ili zaustavite klikom na odgovarajuće dugme koje se nalazi u delu koji je na slici označen brojem 4.

Sinhronizaciju slika za jedan artikal možete da izvršite tako što šifru artikla (SKU) upišete u polje koje je na slici označeno brojem 5 a zatim kliknete na dugme Sinhronizuj.

U delu koji je na slici označen brojem 3 prikazuje se status sinhronizacije.

Datum poslednje izmene članka: 06.03.2026