Revised:
1. get_account_info (opseg account.read)
Vraća tvrtku prijavljenog korisnika, njegovu ulogu, pretplatnički plan i omogućene module. Asistenti ga pozivaju na početku kako bi znali čije podatke pregledavaju.
2. list_warehouses (opseg inventory.read)
Ispisuje skladišta i lokacije tvrtke te podatke o tome koje je od njih povezano sa Shopify lokacijom.
3. search_products (opseg catalog.read)
Pretražuje proizvode prema nazivu, SKU-u, crtičnom kodu, marki ili modelu te vraća sažeti redak po proizvodu s cijenom, kategorijom i zalihama. Rezultati su paginirani; za potpuni zapis upotrijebite get_product.
4. get_product (opseg catalog.read)
Vraća podatke pojedinog proizvoda, njegove zalihe po lokaciji i status objave na marketplaceima.
5. get_inventory_summary (opseg inventory.read)
Vraća ukupnu količinu zaliha po lokaciji, omogućujući asistentu da odgovori na pitanje koliko zaliha tvrtka drži u svakom skladištu.
6. find_missing_product_data (opseg catalog.read)
Pronalazi proizvode kojima nedostaju podaci potrebni za prodaju (slika, cijena, kategorija, opis, crtični kod i slično) i navodi što točno nedostaje. Rezultati su paginirani.
7. find_listing_problems (opseg catalog.read)
Pronalazi proizvode koji nisu uvršteni na marketplace ili prodajni kanal i objašnjava pogrešku s jasnim uputama za rješavanje, na primjer nedostajući EAN koji zahtijeva Allegro kategorija.
8. find_unfulfilled_orders (opseg orders.read)
Prikazuje otvorene narudžbe s webshopova, marketplacea i B2B kanala koje još nisu poslane, zajedno s njihovim izvorom, partnerom i statusom.
9. search_categories (opseg catalog.read)
Pretražuje stablo kategorija proizvoda po nazivu i vraća ID-jeve i putanje kategorija; update_product pomoću ID-ja postavlja kategoriju.
10. Kako rade alati za pisanje
Alati za pisanje trebaju opseg catalog.write ili inventory.write i ulogu vlasnika ili administratora. Svaki radi u dva koraka: s confirm=false samo vraća pregled starih i novih vrijednosti; s confirm=true i expected_version (verzija proizvoda iz pregleda ili iz get_product) sprema. Ako se proizvod u međuvremenu promijenio, spremanje se odbija. Jedan poziv mijenja jedan proizvod, svaka se promjena bilježi s podrijetlom mcp i ništa se ne može izbrisati.
11. update_product (opseg catalog.write)
Mijenja naziv, opis, marku, vrstu, kategoriju, barkod, SKU, prodajnu cijenu ili status (aktivan ili skica) jednog proizvoda. Ovdje postavljena cijena smatra se ručnom cijenom koju pozadinski AI nikada ne prepisuje. SKU se mijenja u zasebnom pozivu.
12. adjust_stock (opseg inventory.write)
Postavlja, dodaje ili oduzima zalihu jednog proizvoda na jednoj lokaciji uobičajenim skladišnim kretanjem, pa se ažuriraju i dnevnik kretanja i sinkronizacija zaliha sa Shopifyjem.
13. set_channel_listing (opseg catalog.write)
Uključuje, isključuje ili vraća na pravilo kanala jedan proizvod na jednoj tržnici ili kanalu. Rabljeni, obnovljeni ili oštećeni proizvodi nikada se ne mogu uključiti na kanalima koji primaju samo nove proizvode (eMAG, Árukereső, Árgép, Pepita).
14. create_product (opseg catalog.write)
Stvara novi proizvod prema barkodu ili nazivu, po želji s početnom zalihom na jednoj lokaciji. Pozadinski AI ga prepoznaje i popunjava ostalo unutar uobičajenog ograničenja od najviše 5 AI poziva po proizvodu; postojeći barkod nikada se ne udvostručuje.
