Uvod

Ovaj dokument opisuje kako funkcioniše zvanični WooCommerce plugin za integraciju sa Ananas platformom, koje su njegove funkcionalnosti i koji su tehnički zahtevi za uspešnu implementaciju. 

Šta je WooCommerce plugin 

Za prodavce koji koriste WooCommerce platformu (WordPress), Ananas je razvio poseban plugin koji omogućava direktnu i jednostavnu integraciju. 

Plugin omogućava automatsko ažuriranje sledećih podataka: 

• Redovne cene proizvoda 
• Količine proizvoda 

Ekstenziju možete preuzeti putem sledećeg linka: WooCommerce plugin 

Tehnički zahtevi i pravila za uspešnu integraciju 

• Jedinstveni SKU za varijacije 
  • Svaka varijacija proizvoda (npr. različite boje i veličine) mora imati jedinstven SKU. U suprotnom, sinhronizacija neće raditi ispravno. 
• Automatsko ažuriranje količina 
  • Radi samo ako su vrednosti izražene numerički (npr. 5, 10, 0). 
  • Nije moguća integracija statusa „in stock / out of stock“. 
• Promotivne cene 
  • Mogu se sinhronizovati samo ako su na samom proizvodu podešeni datumi početka i kraja promocije. U suprotnom, sinhronizuju se isključivo regularne cene. 
• Tehnički zahtevi hostinga 
  • Hosting mora podržavati podešavanje „Cron Job“-a za WordPress/WooCommerce. 
  • Ovo je neophodno za optimalan rad integracije bez narušavanja korisničkog iskustva na sajtu. 

Zaključak

Detaljno uputstvo za instalaciju i podešavanje WooCommerce Plugina možete pogledati na linku: Ananas Integration – Install and Setup.docx. Za dodatne informacije o korišćenju WooCommerce plugina, možete se obratiti timu integrations@ananas.rs  

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025. 

Uvod

 
Ovaj dokument opisuje kako funkcioniše REST API integracija sa Ananas platformom, koje su njene prednosti i koje funkcionalnosti se mogu automatizovati korišćenjem ovog tipa povezivanja. 

Šta je REST API integracija 

Ako već imate razvijen REST API, Ananas partner integrator može izvršiti povezivanje koje podrazumeva sledeće:

• Preuzimanje informacija sa vašeg API-ja 

• Prilagođavanje podataka formatu potrebnom za Ananas Public API 

Ova integracija omogućava efikasnu i automatsku razmenu podataka između vašeg sistema i Ananas platforme, bez potrebe za dodatnim manuelnim unosom. 

Funkcije koje se mogu automatizovati putem REST API integracije 

• Ažuriranje redovnih cena 
  • Redovne cene se ažuriraju po principu „danas za sutra“ 
  • Cena poslata danas postaje aktivna nakon ponoći 
  • Mogućnost „danas za danas“ postoji samo u periodu 00:00–02:00 

• Ažuriranje količina 
  • Količine se mogu ažurirati više puta dnevno, u skladu sa dinamikom vašeg sistema 
• Upravljanje akcijama 
  • Akcije se mogu planirati unapred ili isti dan 
  • Potrebno je poslati akcijsku cenu, uz datume početka i kraja ako su dostupni 
  • Ako datumi nisu dostupni, partner integrator postavlja trajanje akcije na 1 dan 
  • Trajanje akcije: minimum 1 dan, maksimum 30 dana 
  • Tokom trajanja akcije: 
    • Nije moguće prekinuti akciju 
    • Nije moguće menjati redovnu cenu 
    • Nije moguće menjati datum trajanja 
    • Moguće je samo sniziti akcijsku cenu 

Napomena

ST API integracija je idealna za prodavce koji već imaju sopstvene sisteme i žele da zadrže potpunu kontrolu nad podacima, dok im partner integrator omogućava prilagođavanje i komunikaciju sa Ananas platformom. 

Za uspešnu integraciju, neophodno je da podaci koje API izbacuje sadrže jedinstveni identifikator proizvoda (SKU ili EAN) kao i sve potrebne informacije za sinhronizaciju (količina, redovna cena, akcijska cena). 

Zaključak

Za dodatne informacije o REST API integraciji, možete se obratiti timu integracija na integrations@ananas.rs  

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025. 

Uvod

Ovaj dokument objašnjava kako funkcioniše FTP integracija sa Ananas platformom, koje podatke možete razmenjivati, kao i kako se koristi FTP kao alternativni metod ako nemate dinamički XML feed. 

Šta je FTP integracija 

FTP integracija omogućava razmenu podataka između vašeg sistema i Ananasa putem fajlova u formatima XML, CSV ili XLS. 

Postoje dve mogućnosti: 

• Ananas preuzima fajlove sa vašeg servera 

• Vi upload-ujete fajlove na Ananas server 

Implementaciju ove integracije vrši naš partner integrator. 

Funkcije koje se mogu automatizovati putem FTP integracije 

• Ažuriranje redovnih cena
  • Cene se ažuriraju po principu „danas za sutra“ 
  • Cena poslata danas biće aktivna nakon ponoći 
  • Mogućnost „danas za danas“ dostupna je u periodu 00:00–02:00 
• Ažuriranje količina 
  • Količine je moguće ažurirati više puta dnevno, u skladu sa vašim sistemom 
• Upravljanje akcijama 
  • Akcije se mogu zakazati unapred ili isti dan 
  • Potrebno je poslati akcijsku cenu, uz datume početka i kraja ako ih imate 
  • Ako datumi nisu dostupni, partner integrator postavlja trajanje akcije na 1 dan 
  • Akcija može trajati minimum 1 dan, maksimum 30 dana 
  • Tokom trajanja akcije: 
    • Nije moguće prekinuti akciju 
    • Nije moguće menjati redovnu cenu 
    • Nije moguće menjati datume 
    • Moguće je samo sniziti akcijsku cenu 

Napomena:

FTP integracija koristi istu logiku kao i XML feed kada je reč o formatiranju podataka i obradi informacija. 

Za uspešnu integraciju, neophodno je imati: 

• Jedinstveni identifikator proizvoda (SKU ili EAN) 

• Informacije o količini, redovnoj ceni i eventualno akcijskoj ceni 

Struktura fajla koju poseduje prodavac nije važna. Kada prodavac dostavi šablon koji poseduje, naš integrator počinje sa radom na mapiranju polja.  

Zaključak

Za dodatne informacije o FTP integraciji, možete se obratiti timu integracija na integrations@ananas.rs 

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025. 

Uvod

Ovaj dokument opisuje kako funkcioniše XML integracija sa Ananas platformom, koje funkcije se mogu automatizovati, koji su tehnički i operativni zahtevi, kao i prednosti ovog tipa povezivanja. 

Šta je XML integracija 

XML integraciju podržava eksterni partner integrator. Ovaj tip integracije podrazumeva da prodavac dostavi link ka svom dinamičkom XML feed-u, a partner integrator preuzima podatke, priprema ih i prosleđuje Ananas sistemu. 

Funkcije koje se mogu automatizovati putem XML integracije 

• Ažuriranje redovnih cena 
  • Redovna cena se ažurira po principu „danas za sutra“. 
  • Cena poslata danas postaje aktivna nakon ponoći. 
  • Mogućnost podešavanja cene „danas za danas“ postoji samo između 00:00 i 02:00. 
• Ažuriranje količina 
  • Moguće je višestruko ažuriranje tokom dana, u skladu sa internim sistemom prodavca. 
• Upravljanje akcijama 
  • Akcije se mogu planirati unapred ili isti dan. 
  • Potrebno je slanje akcijske cene i, ukoliko postoji, datuma početka i kraja. 
  • Ukoliko datumi nisu dostupni, integrator će automatski postaviti trajanje akcije na 1 dan. 
  • Trajanje akcije: minimum 1 dan, maksimum 30 dana. 
  • Tokom trajanja akcije nije moguće: 
    • Prekinuti akciju 
    • Menjati redovnu cenu 
    • Menjati datume trajanja
  • Moguće je samo sniziti akcijsku cenu tokom trajanja akcije 

Dodatne informacije

XML fajl može sadržati podatke za ulistavanje proizvoda, ali novi proizvodi se neće automatski ulistati. Za ulistavanje novih proizvoda, kontaktirajte svog account menadžera putem emaila. 

Za validnu integraciju, neophodno je imati bar jedan od sledećih identifikatora:

• SKU ili EAN kod 
• Količina, redovna cena i informacije za akcije (ako se koriste) 

Strukturu poželjnog XML fajla možete preuzeti iz sledećeg dokumenta:link

Vremenski okvir i cena 

• Vreme implementacije: 3 do 7 dana 

• Cena inicijalne integracije: 200 € 

• Mesečno održavanje: 30 € 

• Način plaćanja se dogovara direktno sa partnerom integratorom 

Zaključak

Za dodatne informacije o XML integraciji, možete se obratiti timu integracija na integrations@ananas.rs 

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025. 

Uvod

Ovaj dokument daje pregled Ananas Public API integracije kao najkompletnijeg rešenja za automatizaciju poslovanja na Ananas platformi. 

Šta je Ananas Public API 

Ananas Public API je napredna opcija za integraciju koja omogućava potpunu automatizaciju svih funkcionalnosti dostupnih na platformi. Vaš sistem može direktno komunicirati sa Ananas platformom, što znači da možete lako upravljati proizvodima, akcijama i porudžbinama bez potrebe za ručnim unosom. 

Za tehničke detalje i dokumentaciju, posetite Ananas Developer Portal: https://developer.ananas.rs 

Proces implementacije 

• Implementacija počinje testiranjem funkcionalnosti koje želite da automatizujete. 

• Nakon uspešnog testiranja, Ananas tim vam dostavlja API ključeve za produkciju. 

• Dužina implementacije zavisi od složenosti vašeg sistema i obuhvata funkcionalnosti koje integrišete. 

• Tipičan vremenski okvir: 7 do 30 dana. 

Funkcije koje se mogu automatizovati putem API-ja 

• Slanje kataloga 
  • Možete slati katalog proizvoda direktno. 
  • Obavezna polja za slanje kataloga dostupna su na: 
    https://developer.ananas.rs/developer-portal/bulk-products/ 

• Preuzimanje informacija o ulistanim proizvodima
  • U bilo kom trenutku možete preuzeti informacije o cenama, količinama, skladištu, opisu, ID-u i drugim atributima. 
• Ažuriranje količina 
  • Moguće je višestruko ažuriranje tokom dana, u skladu sa vašim internim sistemima. 
• Ažuriranje redovnih cena
  • Cene se planiraju „danas za sutra“. 
  • Redovna cena poslata danas postaje aktivna nakon ponoći. 
  • Cena „danas za danas“ moguća je samo u periodu 00:00–02:00. 
• Upravljanje akcijama 
  • Akcije se mogu planirati unapred ili isti dan. 
  • Obavezno je slanje datuma početka i kraja. 
  • Trajanje: minimum 1 dan, maksimum 30 dana. 
  • Nakon početka, akciju nije moguće prekinuti. 
  • Tokom trajanja akcije: 
    • Nije moguće menjati redovnu cenu 
    • Nije moguće menjati datum trajanja 
    • Moguće je samo sniziti akcijsku cenu 
• Upravljanje porudžbinama 
  • Moguće je automatizovano upravljanje prijemom i obradom porudžbina. 
• Preuzimanje fiskalnih računa / specifikacija porudžbina 
  • API omogućava preuzimanje fiskalnih dokumenata i svih relevantnih podataka o porudžbinama. 

Zaključak

Za dodatne informacije o Public API integraciji, možete se obratiti timu integracija na integrations@ananas.rs 

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025. 

Uvod

Ovaj dokument ima za cilj da objasni šta su Ananas integracije, koje vrste postoje i koje su glavne prednosti korišćenja istih u svakodnevnom poslovanju prodavaca na platformi. 

Šta su integracije 

Integracije omogućavaju lakše i efikasnije upravljanje proizvodima i porudžbinama na Ananas platformi kroz automatizaciju procesa. One značajno štede vreme, smanjuju mogućnost ljudskih grešaka i poboljšavaju tačnost informacija. 

Korišćenjem integracija, prodavci mogu automatizovati veliki deo svojih operacija i fokusirati se na rast i razvoj poslovanja. 

Vrste integracija na Ananasu 

Trenutno je dostupno više opcija za povezivanje sistema prodavca sa Ananas platformom: 

• Ananas Public API: Kompletno rešenje za napredne korisnike i IT timove koji žele potpunu kontrolu nad svojim podacima. 

• XML dinamički feed: Pogodno za prodavce koji žele redovno i automatizovano osvežavanje podataka o proizvodima. 

• REST API: Moderan i fleksibilan način za povezivanje sistema sa Ananasom. 

• WooCommerce plugin: Idealan za prodavce koji koriste WooCommerce platformu. 

• FTP razmena: Pogodna za prodavce koji imaju statičke fajlove i preferiraju razmenu putem servera. 

Funkcije koje integracije podržavaju 

Uz pomoć integracija, mogu se automatizovati sledeće funkcije: 

• Slanje kataloga proizvoda 

• Preuzimanje informacija o ulistanim proizvodima 

• Ažuriranje količina 

• Ažuriranje redovnih cena 

• Upravljanje akcijama i promocijama 

• Upravljanje porudžbinama 

• Preuzimanje fiskalnih računa i specifikacija porudžbina 

Zaključak 

Za više informacija o integracijama i kako ih implementirati, možete se obratiti timu integracija na integrations@ananas.rs 

Kataloški broj dokumenta:  

Verzija dokumenta: 1.0 

Datum izmene: 26.3.2025.