Bulk import oglasa

Bulk import omogućava profesionalnom prodavcu da pripremi izmene više postojećih oglasa iz CSV fajla. Trenutno je podržan samo CSV. XLSX, XLS, JSON i ZIP nisu podržani.

Kako izgleda postupak

1. Preuzmite prazan template.
2. Unesite postojeći listing_id i svežu verziju oglasa.
3. U svakom redu navedite jednu vrstu izmene.
4. Pošaljite fajl i sačekajte pregled.
5. Pregledajte validne, nevalidne i konfliktne redove.
6. Potvrdite tačan pregled tek kada ste proverili razlike.
7. Pokrenite izvršenje i sačekajte rezultat po redu.

Pregled sam po sebi ne menja oglase. Izvršenje može biti delimično uspešno, zato proverite završni status i pojedinačne rezultate.

Obavezne kolone

listing_id je ID postojećeg oglasa, a expected_listing_version je verzija koju ste dobili iz svežeg prikaza oglasa. ID je UUIDv7 format.

Podržane kolone su:

listing_id, expected_listing_version, price_minor, quantity, status, shipping_available, shipping_methods, shipping_notes, warranty_type, warranty_until, location_country_code, location_region, location_city, pickup_available, pickup_notes, availability_answer.

Svaki red treba da menja jednu vrstu podatka. Ne pokušavajte da istim redom menjate i cenu i količinu.

Vrednosti

• Cena je pozitivan ceo broj u najmanjim RSD jedinicama.
• Količina je ceo broj nula ili veći.
• Za da/ne koristite true, false, 1, 0, da ili ne.
• Statusi su ACTIVE, PAUSED_BY_SELLER, ARCHIVED i DEACTIVATE.
• Dostupnost je AVAILABLE, RESERVED, SOLD ili OUT_OF_STOCK.
• Garancija je NONE, MANUFACTURER, SELLER ili REMAINING.
• Datum garancije koristi ISO zapis, na primer 2027-03-31T00:00:00Z.
• Metode slanja u jednoj ćeliji razdvajaju se znakom |.

Ograničenja fajla

Fajl može imati najviše 10 MB, do 10.000 redova i do 2.000 znakova po ćeliji. Podržani su UTF-8 BOM i navodnici oko ćelija sa zarezom. NUL i ćelije koje počinju sa =, +, - ili @ se odbijaju. Formule i makroi se ne izvršavaju.

Šta ovaj import ne radi

Ovaj format je namenjen izmenama podataka postojećih oglasa. Ne dodaje slike, ne bira kategoriju ili model umesto Vas i ne izvršava kupoprodaju.

Greške i konflikt verzije

Ako je oglas u međuvremenu izmenjen, napravite novi svež pregled. Ne šaljite stari pregled ponovo. Za objašnjenje grešaka pogledajte Referencu grešaka importa.

Privatnost i primeri

Koristite samo oglase iz svog prodajnog profila. Template primeri sadrže sintetičke ID-jeve i ne treba ih slati protiv produkcije.

Bulk API varijanta

Bulk import služi za pripremu izmena na više postojećih oglasa u okviru Vašeg prodajnog profila. Podržan je samo CSV format. XLSX, XLS, JSON i ZIP nisu podržani.

Brzi postupak

1. Preuzmite prazan CSV template.
2. Unesite ID oglasa i njegovu svežu verziju.
3. U svakom redu navedite samo jednu vrstu izmene.
4. Pošaljite fajl i otvorite pregled.
5. Ispravite nevalidne i konfliktne redove.
6. Potvrdite pregled samo kada su razlike tačne.
7. Pokrenite izvršenje i proverite rezultat svakog reda.

Pregled ne menja oglase. Izvršenje može biti delimično uspešno, zato ne zaključujte da je sve promenjeno dok ne vidite završni rezultat.

Kolone

Prvi red mora sadržati sledeće nazive:

listing_id, expected_listing_version, price_minor, quantity, status, shipping_available, shipping_methods, shipping_notes, warranty_type, warranty_until, location_country_code, location_region, location_city, pickup_available, pickup_notes, availability_answer.

listing_id je ID postojećeg oglasa, a expected_listing_version verzija iz svežeg prikaza oglasa. ID mora biti UUIDv7. Svaki red treba da menja jednu vrstu podatka, na primer cenu ili količinu, ne obe odjednom.

Dozvoljene vrednosti

Fajl i bezbednost

• maksimalna veličina je 10.000.000 bajtova;
• maksimalno je 10.000 redova;
• ćelija može imati najviše 2.000 znakova;
• UTF-8 BOM i navodnici oko ćelija sa zarezom su podržani;
• NUL bajt i vrednosti koje počinju sa =, +, - ili @ se odbijaju;
• formule i makroi se ne izvršavaju.

Import ne dodaje fotografije, ne bira kategoriju ili model umesto Vas i ne obrađuje kupoprodaju. Koristite samo oglase iz svog profila.

Pregled, potvrda i izvršenje

Pre potvrde proverite broj promena, vrednosti, verziju oglasa i svaku grešku. Potvrda pregleda i samo izvršenje su odvojene radnje. Ako je oglas u međuvremenu promenjen, napravite novi pregled umesto ponovnog slanja starog.

Ulazni snapshot se prema trenutnoj sistemskoj politici čuva do 30 dana, a zaštita od ponovljenog efekta traje 24 časa. Ove rokove ne treba tumačiti kao opšti rok čuvanja svih podataka naloga.

Primeri

U paketu su dostupni prazan template, validan sintetički primer i namerno nevalidan primer. Primeri ne treba da se izvršavaju protiv stvarne baze.

Greške importa

Ako import prijavi grešku, ispravite navedeni red i kolonu pa napravite novi pregled. Ne šaljite stari pregled nakon izmene oglasa ili fajla.

Poruka pre izvršenja

Nisu sve izmene spremne za izvršenje. Pregledajte greške po redu. Tek potvrđen plan može promeniti oglase.