Program de gestiune pentru Etsy

Ce produse pot fi vândute pe Etsy

Etsy permite produsele pe care vânzătorul le-a realizat, proiectat, selectat personal sau le furnizează în conformitate cu regulile platformei. Acestea pot fi bijuterii, ceramică, obiecte decorative, îmbrăcăminte cu design propriu și materiale pentru lucru manual. Articolele vintage trebuie să aibă o vechime de cel puțin 20 de ani. Pentru produsele fabricate de un terț pe baza designului propriu al vânzătorului trebuie prezentate informații despre partenerul de producție.

Înainte de conectare, fiecare categorie de produse trebuie verificată conform regulilor Etsy privind produsele permise. Prezența unui produs în Torgsoft nu confirmă faptul că acesta poate fi listat pe Etsy.

Cum trebuie să funcționeze schimbul

Pentru conectare este necesar un serviciu separat de schimb — un program pe care dezvoltatorul îl creează între Torgsoft și Etsy. Acesta citește exportul Torgsoft, apelează API-ul Etsy și pregătește fișierele comenzilor pentru încărcarea în sistemul de evidență.

Cantitatea disponibilă pentru vânzare trebuie stabilită pe baza datelor din Torgsoft, ținând cont de rezervări și de comenzile Etsy care nu au fost încă importate. Prețul pentru publicare poate fi preluat din Torgsoft conform unei reguli convenite. În comandă trebuie păstrat prețul efectiv de cumpărare de pe Etsy, inclusiv reducerea aplicată.

Pasul 1. Pregătirea produselor și stabilirea depozitului

Înainte de dezvoltarea schimbului trebuie verificată disponibilitatea efectivă a produselor și corectate diferențele din evidență. Apoi trebuie stabilit centrul de evidență din care vor fi procesate comenzile Etsy.

Pentru fiecare produs și fiecare variantă de stoc este necesară o poziție de evidență separată. De exemplu, un tricou alb mărimea M și un tricou alb mărimea L trebuie să aibă identificatori și stocuri proprii. Codul articolului Etsy, sau SKU, trebuie să indice fără ambiguitate poziția corespunzătoare.

În export este recomandat să fie incluse cheia produsului GoodID, codul articolului, denumirea, prețul, cantitatea, caracteristicile necesare și fotografiile. Pentru schimb este important un GoodID stabil: denumirea produsului se poate modifica, însă legătura cu poziția sa de evidență trebuie păstrată.

Dacă produsul este realizat la comandă, trebuie stabilite separat numărul permis de comenzi și termenul de producție. Cantitatea de materie primă din depozit nu este egală cu numărul produselor finite disponibile pentru expediere imediată.

Pasul 2. Configurarea schimbului de fișiere în Torgsoft

Pentru schema descrisă este necesară opțiunea «Sincronizare cu magazinul online». După activarea acesteia devine disponibil meniul «Depozit → Sincronizare cu magazinul online».

1. Creați un obiect de sincronizare cu o denumire prin care magazinul Etsy să poată fi identificat.
2. În fila «Centre de evidență» selectați depozitele ale căror stocuri pot fi transmise pentru vânzare și verificați parametrul «Produsul se scade din».
3. Configurați adresa de transmitere a informațiilor pentru schimbul de fișiere cu serviciul pregătit de dezvoltator.
4. În setările fișierului de produse selectați câmpurile necesare și activați generarea denumirilor coloanelor. Acest lucru va ajuta serviciul să recunoască corect datele.
5. Selectați codificarea UTF-8 și conveniți cu dezvoltatorul modul de procesare a acesteia. Documentația Torgsoft impune BOM pentru fișierul text al comenzii în această codificare.
6. Configurați rezervarea produselor din factură și programul de sincronizare.

Torgsoft poate exporta produsele în fișierul TSGoods.trs — CSV cu separatorul ;, sau în format YML. Pentru conectarea inițială este convenabil să fie stabilite un singur format și un set fix de coloane. Ordinea și componența câmpurilor se configurează în program.

Serviciul trebuie să preia acest fișier, să transforme înregistrările în solicitări către Etsy și să returneze comenzile în fișiere .sal. Etsy nu procesează în mod direct astfel de fișiere Torgsoft. Toate transformările sunt realizate de serviciul dezvoltat.

Absența unei poziții din următorul export nu trebuie interpretată automat ca o comandă de ștergere a anunțului. Dezvoltatorul trebuie să definească reguli separate pentru stoc zero, excluderea produsului din schimb și erorile de preluare a fișierului.

Pasul 3. Obținerea accesului la API-ul Etsy

Etsy oferă diferite niveluri de acces. Seller App este destinat magazinului propriu al vânzătorului. Pentru un serviciu la care se vor conecta vânzători diferiți, dezvoltatorul începe cu Personal App. Pentru utilizarea de către mai multe magazine trebuie obținut Commercial Access; Etsy examinează manual astfel de solicitări.

Tipul aplicației trebuie ales în funcție de scopul său real. Condițiile de acces sunt descrise în documentația Etsy Open API v3.

Proprietarul magazinului autorizează accesul prin OAuth 2.0 cu PKCE: deschide pagina Etsy și confirmă permisiunile aplicației. Serviciul trebuie să păstreze tokenurile obținute și să reînnoiască accesul prin refresh token.

Pentru citirea anunțurilor este necesară permisiunea listings_r, pentru modificarea lor — listings_w, iar pentru primirea comenzilor — transactions_r. Transmiterea datelor despre expediere necesită transactions_w și o aprobare separată din partea Etsy pentru metoda corespunzătoare.

Fiecare solicitare API trebuie să conțină x-api-key în formatul keystring:shared_secret. Pentru operațiunile protejate este necesar și antetul Authorization: Bearer …. Detaliile sunt prezentate în instrucțiunile de autorizare. Parola contului Etsy nu trebuie transmisă serviciului.

Pasul 4. Asocierea produselor Torgsoft cu anunțurile Etsy

Pentru prima lansare pot fi utilizate anunțurile pe care vânzătorul le-a pregătit deja pe Etsy. Dezvoltatorul asociază variantele de produse ale acestora cu pozițiile din Torgsoft și verifică dacă articolele corespund.

Un anunț Etsy poate conține mai multe variante. De aceea, pentru asociere trebuie păstrate magazinul shop_id, anunțul listing_id și varianta de produs Etsy corespunzătoare. Fiecărei variante de stoc din Torgsoft trebuie să îi corespundă o combinație concretă de caracteristici.

Exemplu de asociere cu identificatori convenționali:

Dacă într-o comandă este primit un SKU sau o variantă necunoscută, serviciul trebuie să oprească importul acelei comenzi și să afișeze motivul. Asocierea automată după o denumire similară poate determina scăderea unui alt produs din stoc.

Ce este necesar pentru crearea automată a anunțurilor

Această etapă poate fi adăugată după verificarea stocurilor și a comenzilor. Pentru un produs fizic, Etsy necesită denumire, descriere, preț, cantitate și parametrii proprii:

Regulile comune pot fi păstrate în setările serviciului, iar diferențele dintre produsele concrete — în caracteristicile produsului sau într-un tabel de corespondențe. Vânzătorul trebuie să verifice descrierea și fotografiile înainte de publicare. Procedura de creare este prezentată în documentația privind anunțurile Etsy.

Pasul 5. Încărcarea comenzilor în Torgsoft

Serviciul trebuie să primească periodic comenzile prin API. Dacă pentru aplicație sunt disponibile webhooks — notificări automate Etsy despre evenimente, — poate fi adăugată procesarea order.paid. După notificare trebuie încărcate datele actualizate ale comenzii. Etsy documentează, de asemenea, evenimentele de anulare, expediere și livrare.

Pentru webhooks este necesară o adresă publică de recepție și verificarea semnăturii solicitării. Disponibilitatea acestora pentru aplicația selectată trebuie verificată în timpul înregistrării. Preluarea periodică a comenzilor trebuie păstrată pentru recuperarea evenimentelor omise. Cerințele sunt descrise în documentația webhooks.

Înainte de crearea fișierului pentru Torgsoft, serviciul verifică starea plății, componența comenzii, corespondența tuturor produselor, moneda și adresa destinatarului. Numărul propriu al comenzii este recomandat să fie format din shop_id și receipt_id, pentru a diferenția comenzile mai multor magazine.

Exemplu de fișier al comenzii

Mai jos este prezentat un exemplu de fișier text .sal cu date convenționale. Valoarea GoodID trebuie înlocuită cu cheia produsului real. Serviciul preia din Etsy datele destinatarului, numărul comenzii, prețul și cantitatea.

[Client]
Name=Numele destinatarului din Etsy
Country=Germany
City=Berlin
ZIP=10115
Address=Adresa destinatarului din Etsy

[Options]
OrderNumber=etsy-12345678-987654321
SaleType=5
CurrencyInternationalCode=USD
Comment=Etsy: plata cumpărătorului a fost confirmată; expedierea așteaptă procesarea

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

În acest exemplu, SaleType=5 creează o factură. Indicarea plății în comentariu nu efectuează în sine o operațiune financiară. Această variantă este potrivită pentru verificarea inițială a importului, atunci când plata și expedierea sunt încă procesate de un angajat.

Formatul Torgsoft documentat acceptă și alte scenarii:

Pentru evidența automată a unei achiziții plătite poate fi utilizat SaleType=2 după verificarea setărilor financiare. SaleType=3 înseamnă și expedierea produsului, de aceea utilizarea acestuia trebuie legată de o operațiune de depozit convenită. Evenimentul de plată pe Etsy nu confirmă predarea coletului transportatorului.

Documentația conține un avertisment: scenariile SaleType=2–5 presupun existența produsului necesar; în lipsa acestuia este posibilă vânzarea cu stoc negativ. Înainte de import trebuie verificată cantitatea disponibilă. Suportul pentru moneda comenzii prin CurrencyInternationalCode este documentat începând cu versiunea 493 a bazei de date.

Fișierul trebuie scris complet înainte de a deveni disponibil pentru import. Numele fișierului trebuie să fie alcătuit din caractere ASCII. Pentru UTF-8 trebuie respectate cerințele Torgsoft privind BOM. Înainte de lansare, dezvoltatorul verifică importul pe versiunea instalată a programului.

Cum se actualizează stocurile fără revânzarea produselor rezervate

După crearea facturii, produsul trebuie rezervat. În Torgsoft există pentru aceasta setarea «Rezervarea produselor din factură». Durata rezervării trebuie să acopere pregătirea comenzii; un produs plătit nu trebuie să redevină disponibil din cauza expirării acestui termen.

Pentru serviciul de schimb este recomandat să fie definită următoarea regulă:

Aceasta este regula de calcul recomandată pentru integrare. Mai întâi trebuie verificat dacă în câmpul cantității exportate sunt deja luate în calcul rezervările. O rezervare trebuie să reducă o singură dată cantitatea disponibilă. După confirmarea importului, reducerea temporară din serviciu este înlocuită de rezervarea sau scăderea din Torgsoft.

De exemplu, din 10 produse finite, 2 sunt rezervate, iar încă 1 a fost plătit pe Etsy și așteaptă importul. Dacă stocul de siguranță este 1, pentru vânzare sunt disponibile 6 produse. Acest exemplu presupune că valoarea inițială de 10 reprezintă cantitatea fizică înainte de scăderea rezervărilor.

Înainte de creșterea cantității pe Etsy, serviciul trebuie să proceseze comenzile noi și să utilizeze exportul actual din Torgsoft. În caz contrar, un fișier învechit poate readuce la vânzare un produs tocmai cumpărat. Sincronizarea periodică nu poate exclude complet achizițiile simultane prin canale diferite; pentru produsele deficitare este necesar un stoc de siguranță sau un stoc separat pentru Etsy.

Actualizarea variantelor Etsy se efectuează prin updateListingInventory. Această metodă necesită setul complet de variante ale produsului din anunț. Serviciul trebuie să păstreze toate combinațiile și regulile corecte privind dependența prețului, cantității și SKU-ului de caracteristici. Detaliile sunt prezentate în descrierea actualizării stocurilor Etsy.

Ce trebuie făcut în cazul anulării și returnării

Dacă o comandă este anulată înainte de expediere, rezervarea corespunzătoare trebuie eliminată după verificarea stării. Dacă produsul a fost deja expediat, stocul din depozit poate fi mărit numai după returnarea efectivă și întocmirea documentului în Torgsoft.

Încărcarea unei comenzi noi prin .sal nu confirmă posibilitatea modificării automate a documentelor create anterior. Procesarea anulărilor și returnărilor trebuie dezvoltată separat printr-un mecanism acceptat sau lăsată în sarcina angajatului, cu o notificare privind acțiunea necesară.

Cum se evidențiază plata și se transmite numărul de urmărire

În setări trebuie definite separat prețul de publicare, prețul produsului vândut, moneda comenzii și modul de evidență a decontărilor cu Etsy. Reducerile, livrarea, taxele percepute de platformă și comisioanele trebuie procesate după reguli separate. Suma totală a comenzii nu trebuie transmisă în câmpul prețului produsului.

Plata cumpărătorului pe Etsy și plata fondurilor către vânzător — sunt evenimente financiare diferite. Crearea automată a plății anticipate în Torgsoft trebuie configurată astfel încât plata ulterioară să nu creeze venit dublu. Importul prin fișier al comenzii de produse nu asigură de unul singur reconcilierea comisioanelor și plăților.

După expediere, serviciul poate transmite către Etsy transportatorul și numărul de urmărire prin createReceiptShipment. Etsy aprobă separat accesul la această metodă: Commercial Access și permisiunea transactions_w nu garantează disponibilitatea acesteia. Până la obținerea aprobării, vânzătorul adaugă expedierea în contul Etsy.

Cumpărarea Etsy Shipping Labels prin Open API v3 nu este acceptată. Limitarea este prezentată în documentația privind procesarea comenzilor.

Ce trebuie să prevadă dezvoltatorul pentru activitatea zilnică

• Protecție împotriva importului repetat pe baza perechii shop_id + receipt_id. Un eveniment sau o solicitare repetată nu trebuie să creeze încă o factură.
• Evidența stărilor de procesare: comandă primită, fișier pregătit, transmis pentru import, crearea documentului confirmată. Transmiterea fișierului nu înseamnă un import reușit.
• Reconciliere după numărul comenzii în urma unei erori. Dacă rezultatul importului este necunoscut, mai întâi trebuie găsit documentul în Torgsoft, apoi trebuie decis dacă este necesară o nouă încercare.
• Actualizarea succesivă a fiecărui anunț și verificarea actualității datelor înainte de modificarea cantității.
• Un jurnal de erori cu numărul comenzii, produsul, cauza și acțiunea necesară din partea angajatului. Parolele și tokenurile nu trebuie să ajungă în jurnal.
• Controlul momentului ultimului export reușit, al primirii comenzilor și al actualizării Etsy. În cazul unei întârzieri prelungite, angajatul trebuie să primească o notificare.

Etsy limitează numărul de solicitări API pe secundă și pe zi pentru cheia aplicației. Serviciul trebuie să țină cont de cotele sale și să proceseze răspunsul 429 cu o pauză conform retry-after. Valorile cotelor trebuie verificate în contul dezvoltatorului și în anteturile răspunsului, conform regulilor privind limitarea solicitărilor.

Schimbul trebuie să funcționeze printr-un API autorizat și să respecte condițiile Etsy. Datele cumpărătorilor trebuie utilizate numai în limitele serviciului permis. Transmiterea acestora către servicii de publicitate și mesajele de marketing nesolicitate sunt interzise. Pentru o aplicație comercială, accesul la buyer_email este solicitat separat; importul nu trebuie să depindă de prezența obligatorie a acestui câmp.

Ce trebuie verificat înainte de lansarea automată

Pentru comandarea unei astfel de dezvoltări trebuie pregătite versiunea Torgsoft, un export de test al produselor, lista depozitelor, exemple de anunțuri Etsy și regulile de evidență a plăților. Pe această bază, dezvoltatorul poate conveni formatul schimbului, implementa serviciul și verifica funcționarea acestuia pentru magazinul concret.