Program na evidenciu pre Etsy

Aký tovar možno predávať na Etsy

Etsy povoľuje tovar, ktorý predajca vyrobil, navrhol, osobne vybral alebo dodáva v súlade s pravidlami platformy. Môžu to byť šperky, keramika, dekorácie, oblečenie vlastného dizajnu a materiály na ručné práce. Vintage predmety musia byť staré najmenej 20 rokov. Pri výrobkoch vyrobených externým výrobcom podľa vlastného dizajnu predajcu je potrebné zverejniť informácie o výrobnom partnerovi.

Pred pripojením je vhodné skontrolovať každú skupinu tovaru podľa pravidiel Etsy pre povolený tovar. Prítomnosť tovaru v Torgsofte nepotvrdzuje, že ho možno zverejniť na Etsy.

Ako má výmena fungovať

Na pripojenie je potrebná samostatná výmenná služba — program, ktorý vývojár vytvorí medzi Torgsoftom a Etsy. Číta export Torgsoftu, komunikuje s API Etsy a pripravuje súbory objednávok na načítanie do evidencie.

Množstvo dostupné na predaj sa musí určovať podľa údajov Torgsoftu so zohľadnením rezervácií a objednávok Etsy, ktoré ešte neboli importované. Cenu na zverejnenie možno preberať z Torgsoftu podľa dohodnutého pravidla. V objednávke je potrebné zachovať skutočnú nákupnú cenu na Etsy vrátane použitej zľavy.

Krok 1. Pripraviť tovar a určiť sklad

Pred vývojom výmeny je potrebné skontrolovať skutočnú dostupnosť tovaru a opraviť nezrovnalosti v evidencii. Potom treba určiť evidenčné centrum, z ktorého sa budú vybavovať objednávky Etsy.

Každý výrobok a každý jeho skladový variant potrebuje samostatnú evidenčnú položku. Napríklad biele tričko veľkosti M a biele tričko veľkosti L musia mať vlastné identifikátory a stavy zásob. Kód položky Etsy, čiže SKU, musí jednoznačne odkazovať na príslušnú položku.

Do exportu je vhodné zahrnúť kľúč tovaru GoodID, kód položky, názov, cenu, množstvo, potrebné vlastnosti a fotografie. Pre výmenu je dôležitý stabilný GoodID: názov tovaru sa môže zmeniť, ale väzba na jeho evidenčnú položku musí zostať zachovaná.

Ak sa výrobok vyrába na objednávku, je potrebné samostatne určiť povolený počet objednávok a čas výroby. Množstvo surovín na sklade sa nerovná počtu hotových výrobkov dostupných na okamžité odoslanie.

Krok 2. Nastaviť súborovú výmenu v Torgsofte

Pre opísanú schému je potrebná možnosť «Synchronizácia s internetovým obchodom». Po jej aktivácii je dostupné menu «Sklad → Synchronizácia s internetovým obchodom».

1. Vytvoriť synchronizačný objekt s názvom, podľa ktorého možno identifikovať obchod Etsy.
2. Na karte «Evidenčné centrá» vybrať sklady, ktorých zásoby možno prenášať na predaj, a skontrolovať parameter «Tovar odpisovať z».
3. Nastaviť adresu doručovania informácií pre súborovú výmenu so službou, ktorú pripravil vývojár.
4. V nastaveniach súboru tovaru vybrať potrebné polia a zapnúť vytváranie názvov stĺpcov. Pomôže to službe správne rozpoznávať údaje.
5. Vybrať kódovanie UTF-8 a dohodnúť s vývojárom jeho spracovanie. Dokumentácia Torgsoftu vyžaduje BOM pre textový súbor objednávky v tomto kódovaní.
6. Nastaviť rezervovanie tovaru faktúry a harmonogram synchronizácie.

Torgsoft môže exportovať tovar do súboru TSGoods.trs — CSV s oddeľovačom ;, alebo do formátu YML. Pri prvotnom pripojení je vhodné dohodnúť jeden formát a stabilnú súpravu stĺpcov. Poradie a zloženie polí sa nastavuje v programe.

Služba musí tento súbor preberať, prevádzať záznamy na požiadavky Etsy a vracať objednávky v súboroch .sal. Etsy takéto súbory Torgsoftu samo nespracúva. Všetky prevody vykonáva vytvorená služba.

Neprítomnosť položky v ďalšom exporte nemožno automaticky považovať za príkaz na odstránenie ponuky. Vývojár musí definovať samostatné pravidlá pre nulovú zásobu, vyradenie tovaru z výmeny a chyby pri získavaní súboru.

Krok 3. Získať prístup k Etsy API

Etsy ponúka rôzne úrovne prístupu. Seller App je určená pre vlastný obchod predajcu. Pri službe, ku ktorej sa budú pripájať rôzni predajcovia, začína vývojár s Personal App. Na používanie viacerými obchodmi je potrebné získať Commercial Access; Etsy takéto žiadosti posudzuje manuálne.

Typ aplikácie je potrebné vyberať podľa jej skutočného účelu. Podmienky prístupu sú opísané v dokumentácii Etsy Open API v3.

Majiteľ obchodu povoľuje prístup prostredníctvom OAuth 2.0 s PKCE: otvorí stránku Etsy a potvrdí oprávnenia aplikácie. Služba musí ukladať získané tokeny a obnovovať prístup pomocou refresh tokenu.

Na čítanie ponúk je potrebné oprávnenie listings_r, na ich zmenu — listings_w, na získavanie objednávok — transactions_r. Prenos údajov o odoslaní vyžaduje transactions_w a samostatné povolenie Etsy pre príslušnú metódu.

Každá požiadavka API musí obsahovať x-api-key vo formáte keystring:shared_secret. Pri chránených operáciách je potrebná aj hlavička Authorization: Bearer …. Podrobnosti sú uvedené v pokynoch na autorizáciu. Heslo účtu Etsy nie je potrebné službe poskytovať.

Krok 4. Spárovať tovar Torgsoftu s ponukami Etsy

Pri prvom spustení možno použiť ponuky, ktoré už predajca pripravil na Etsy. Vývojár prepojí ich varianty tovaru s položkami Torgsoftu a skontroluje zhodu kódov položiek.

Jedna ponuka Etsy môže obsahovať niekoľko variantov. Preto je potrebné pre väzbu ukladať obchod shop_id, ponuku listing_id a príslušný variant tovaru Etsy. Každému skladovému variantu Torgsoftu musí zodpovedať konkrétna kombinácia vlastností.

Príklad párovania s podmienenými identifikátormi:

Ak objednávka obsahuje neznáme SKU alebo variant, služba musí zastaviť import tejto objednávky a zobraziť dôvod. Automatické párovanie podľa podobného názvu môže odpísať iný tovar.

Čo je potrebné na automatické vytváranie ponúk

Túto fázu možno pridať po overení zásob a objednávok. Pri fyzickom tovare Etsy vyžaduje názov, opis, cenu, množstvo a vlastné parametre:

Spoločné pravidlá možno uchovávať v nastaveniach služby a rozdiely konkrétnych výrobkov — vo vlastnostiach tovaru alebo tabuľke priradení. Predajca musí pred zverejnením skontrolovať opis a fotografie. Postup vytvorenia je uvedený v dokumentácii ponúk Etsy.

Krok 5. Načítavať objednávky do Torgsoftu

Služba musí pravidelne získavať objednávky prostredníctvom API. Ak sú pre aplikáciu dostupné webhooks — automatické oznámenia Etsy o udalostiach, — možno pridať spracovanie order.paid. Po oznámení je potrebné načítať aktuálne údaje objednávky. Etsy dokumentuje aj udalosti zrušenia, odoslania a doručenia.

Pre webhooks je potrebná verejne dostupná prijímacia adresa a overenie podpisu požiadavky. Ich dostupnosť pre vybranú aplikáciu je potrebné skontrolovať pri registrácii. Pravidelné získavanie objednávok je vhodné zachovať na obnovenie zmeškaných udalostí. Požiadavky sú opísané v dokumentácii webhooks.

Pred vytvorením súboru pre Torgsoft služba kontroluje stav platby, obsah objednávky, zhodu všetkého tovaru, menu a adresu príjemcu. Vlastné číslo objednávky je vhodné vytvárať z shop_id a receipt_id, aby bolo možné rozlišovať objednávky viacerých obchodov.

Príklad súboru objednávky

Nižšie je príklad textového súboru .sal s podmienenými údajmi. Hodnotu GoodID je potrebné nahradiť kľúčom skutočného tovaru. Údaje príjemcu, číslo objednávky, cenu a množstvo získava služba z Etsy.

[Client]
Name=Meno príjemcu z Etsy
Country=Germany
City=Berlin
ZIP=10115
Address=Adresa príjemcu z Etsy

[Options]
OrderNumber=etsy-12345678-987654321
SaleType=5
CurrencyInternationalCode=USD
Comment=Etsy: platba kupujúceho bola potvrdená; zásielka čaká na spracovanie

[1]
GoodID=201
Price=35,00
Count=2

V tomto príklade SaleType=5 vytvorí faktúru. Označenie platby v komentári samo osebe nevykoná finančnú operáciu. Takýto variant je vhodný na úvodnú kontrolu importu, keď platbu a expedíciu ešte spracúva pracovník.

Dokumentovaný formát Torgsoftu podporuje aj ďalšie scenáre:

Na automatickú evidenciu zaplateného nákupu možno po overení finančných nastavení zvážiť SaleType=2. SaleType=3 znamená aj expedíciu tovaru, preto musí byť jeho použitie viazané na dohodnutú skladovú operáciu. Udalosť platby na Etsy nepotvrdzuje odovzdanie zásielky dopravcovi.

Dokumentácia obsahuje upozornenie: scenáre SaleType=2–5 predpokladajú dostupnosť potrebného tovaru; pri jeho neprítomnosti môže dôjsť k predaju do mínusu. Pred importom je potrebné skontrolovať dostupné množstvo. Podpora meny objednávky prostredníctvom CurrencyInternationalCode je dokumentovaná od verzie databázy 493.

Súbor musí byť úplne zapísaný skôr, než bude dostupný na import. Názov súboru musí pozostávať zo znakov ASCII. Pri UTF-8 je potrebné splniť požiadavky Torgsoftu na BOM. Pred spustením vývojár overí import v nainštalovanej verzii programu.

Ako aktualizovať zásoby bez opätovného predaja rezervovaného tovaru

Po vytvorení faktúry je potrebné tovar rezervovať. Torgsoft má na tento účel nastavenie «Rezervovať tovar faktúry». Doba rezervácie musí pokrývať prípravu objednávky; zaplatený výrobok sa po uplynutí tejto doby nesmie opäť dostať do dostupnej zásoby.

Pre výmennú službu je vhodné definovať nasledujúce pravidlo:

Ide o odporúčané pravidlo výpočtu pre integráciu. Najprv je potrebné skontrolovať, či exportované pole množstva už zohľadňuje rezervácie. Jedna rezervácia má znížiť dostupné množstvo iba raz. Po potvrdení importu sa dočasné zníženie na strane služby nahradí rezerváciou alebo odpisom v Torgsofte.

Napríklad z 10 hotových výrobkov sú 2 rezervované a ďalší 1 bol zaplatený na Etsy a čaká na import. Ak je bezpečnostná zásoba 1, na predaj je dostupných 6 výrobkov. Tento príklad predpokladá, že pôvodných 10 predstavuje fyzické množstvo pred odpočítaním rezervácií.

Pred zvýšením množstva na Etsy musí služba spracovať nové objednávky a použiť aktuálny export Torgsoftu. Inak môže zastaraný súbor vrátiť práve zakúpený tovar späť do predaja. Pravidelnou synchronizáciou nemožno úplne vylúčiť súčasné nákupy v rôznych kanáloch; pri nedostatkovom tovare je potrebná bezpečnostná zásoba alebo samostatná zásoba určená pre Etsy.

Varianty Etsy sa aktualizujú prostredníctvom updateListingInventory. Táto metóda vyžaduje úplnú súpravu variantov tovaru v ponuke. Služba musí uchovávať všetky kombinácie a správne pravidlá závislosti ceny, množstva a SKU od vlastností. Podrobnosti sú uvedené v opise aktualizácie zásob Etsy.

Čo robiť pri zrušení a vrátení

Ak je objednávka zrušená pred odoslaním, po overení stavu je potrebné zrušiť príslušnú rezerváciu. Ak už bol tovar odoslaný, jeho skladovú zásobu možno zvýšiť až po skutočnom vrátení a vytvorení príslušného dokladu v Torgsofte.

Načítanie novej objednávky prostredníctvom .sal nepotvrdzuje možnosť automaticky meniť predtým vytvorené doklady. Spracovanie zrušení a vrátení je potrebné vyvinúť samostatne prostredníctvom podporovaného mechanizmu alebo ho ponechať pracovníkovi s oznámením o potrebnej činnosti.

Ako evidovať platbu a odovzdávať sledovacie číslo

V nastaveniach je potrebné samostatne určiť cenu zverejnenia, cenu predaného tovaru, menu objednávky a spôsob evidencie vyúčtovania s Etsy. Zľavy, doprava, dane vyberané platformou a provízie sa musia spracúvať podľa samostatných pravidiel. Do poľa ceny tovaru sa nemá prenášať celková suma objednávky.

Platba kupujúceho na Etsy a vyplatenie prostriedkov predajcovi — sú dve rôzne finančné udalosti. Automatické vytváranie platby vopred v Torgsofte je potrebné nastaviť tak, aby následná výplata nevytvorila duplicitný príjem. Súborový import objednávky tovaru sám o sebe nezabezpečuje odsúhlasenie provízií a výplat.

Po odoslaní môže služba odovzdať Etsy dopravcu a sledovacie číslo prostredníctvom createReceiptShipment. Prístup k tejto metóde Etsy schvaľuje samostatne: Commercial Access a oprávnenie transactions_w nezaručujú jej dostupnosť. Kým nie je povolenie získané, predajca pridáva informácie o odoslaní v účte Etsy.

Nákup Etsy Shipping Labels prostredníctvom Open API v3 nie je podporovaný. Obmedzenie je uvedené v dokumentácii spracovania objednávok.

Čo musí vývojár zabezpečiť pre každodennú prevádzku

• Ochranu pred opakovaným importom podľa dvojice shop_id + receipt_id. Opakovaná udalosť alebo požiadavka nesmie vytvoriť ďalšiu faktúru.
• Evidenciu stavov spracovania: objednávka prijatá, súbor pripravený, odovzdaný na import, vytvorenie dokladu potvrdené. Odovzdanie súboru neznamená úspešný import.
• Odsúhlasenie podľa čísla objednávky po chybe. Ak výsledok importu nie je známy, najprv je potrebné nájsť doklad v Torgsofte a až potom rozhodnúť, či je potrebný ďalší pokus.
• Postupnú aktualizáciu každej ponuky a kontrolu aktuálnosti údajov pred zmenou množstva.
• Denník chýb s číslom objednávky, tovarom, dôvodom a požadovanou činnosťou pracovníka. Heslá a tokeny sa do denníka nesmú zapisovať.
• Kontrolu času posledného úspešného exportu, prijatia objednávok a aktualizácie Etsy. Pri dlhšom oneskorení musí pracovník dostať upozornenie.

Etsy obmedzuje počet požiadaviek API za sekundu a za deň pre kľúč aplikácie. Služba musí zohľadňovať svoje kvóty a spracovať odpoveď 429 s prestávkou podľa retry-after. Hodnoty kvót je potrebné kontrolovať v účte vývojára a v hlavičkách odpovede podľa pravidiel obmedzenia požiadaviek.

Výmena musí fungovať prostredníctvom povoleného API a byť v súlade s podmienkami Etsy. Údaje kupujúcich sa smú používať iba v rozsahu povolenej služby. Ich odovzdávanie reklamným službám a nevyžiadané marketingové správy sú zakázané. Pri komerčnej aplikácii sa prístup k buyer_email žiada samostatne; import nesmie závisieť od povinnej prítomnosti tohto poľa.

Čo skontrolovať pred automatickým spustením

Na objednanie takéhoto vývoja je potrebné pripraviť verziu Torgsoftu, testovací export tovaru, zoznam skladov, príklady ponúk Etsy a pravidlá evidencie platieb. Na tomto základe môže vývojár dohodnúť formát výmeny, implementovať službu a overiť jej fungovanie v konkrétnom obchode.