Etsy үшін есеп бағдарламасы

Etsy-де қандай тауарларды сатуға болады

Etsy сатушы өзі жасаған, әзірлеген, жеке таңдаған немесе платформа ережелеріне сәйкес жеткізетін тауарларға рұқсат береді. Оларға әшекейлер, керамика, декор, өзіндік дизайндағы киімдер және қолөнер материалдары жатады. Винтаж заттарының жасы кемінде 20 жыл болуы тиіс. Сатушының өзіндік дизайны бойынша бөгде өндіруші жасаған тауарлар үшін өндірістік серіктес туралы ақпаратты көрсету қажет.

Қосылмас бұрын әрбір тауар тобын Etsy рұқсат ететін тауарлар ережелері бойынша тексерген жөн. Тауардың Torgsoft жүйесінде болуы оны Etsy-де орналастыруға рұқсат етілгенін білдірмейді.

Деректер алмасу қалай жұмыс істеуі керек

Қосылу үшін жеке алмасу сервисі қажет — бұл әзірлеуші Torgsoft пен Etsy арасында жұмыс істеу үшін жасайтын бағдарлама. Ол Torgsoft экспортын оқиды, Etsy API-іне жүгінеді және тапсырыс файлдарын есеп жүйесіне жүктеуге дайындайды.

Сатуға қолжетімді сан Torgsoft деректері бойынша резервтер мен әлі импортталмаған Etsy тапсырыстарын ескере отырып анықталуы тиіс. Жариялау бағасын келісілген ереже бойынша Torgsoft жүйесінен алуға болады. Тапсырыста Etsy-дегі нақты сатып алу бағасы, соның ішінде қолданылған жеңілдік сақталуы тиіс.

1-қадам. Тауарларды дайындау және қойманы анықтау

Алмасуды әзірлемес бұрын тауарлардың нақты бар-жоғын тексеріп, есептегі сәйкессіздіктерді түзету қажет. Содан кейін Etsy тапсырыстары орындалатын есеп орталығын анықтау керек.

Әрбір бұйым мен оның әрбір қоймалық нұсқасы үшін жеке есеп позициясы қажет. Мысалы, M өлшемді ақ футболка мен L өлшемді ақ футболканың өз идентификаторлары мен қалдықтары болуы тиіс. Etsy артикулы немесе SKU тиісті позицияны бірмәнді көрсетуі керек.

Экспортқа тауар кілтін GoodID, артикулды, атауды, бағаны, санды, қажетті сипаттамалар мен фотосуреттерді қосқан жөн. Алмасу үшін тұрақты GoodID маңызды: тауар атауы өзгеруі мүмкін, бірақ оның есеп позициясымен байланысы сақталуы тиіс.

Егер бұйым тапсырыс бойынша жасалса, рұқсат етілетін тапсырыс санын және дайындау мерзімін бөлек анықтау қажет. Қоймадағы шикізат саны дереу жөнелтуге қолжетімді дайын бұйымдар санына тең емес.

2-қадам. Torgsoft жүйесінде файлдық алмасуды баптау

Сипатталған схема үшін «Интернет-дүкенмен синхрондау» опциясы қажет. Оны белсендіргеннен кейін «Қойма → Интернет-дүкенмен синхрондау» мәзірі қолжетімді болады.

1. Etsy дүкенін тануға болатын атаумен синхрондау объектісін жасаңыз.
2. «Есеп орталықтары» қойындысында қалдықтарын сатуға жіберуге рұқсат етілген қоймаларды таңдап, «Тауарды есептен шығару орны» параметрін тексеріңіз.
3. Әзірлеуші дайындаған сервиспен файлдық алмасу үшін ақпаратты жеткізу мекенжайын баптаңыз.
4. Тауар файлының баптауларында қажетті өрістерді таңдап, баған атауларын қалыптастыруды қосыңыз. Бұл сервиске деректерді дұрыс тануға көмектеседі.
5. UTF-8 кодтауын таңдап, оны өңдеу тәртібін әзірлеушімен келісіңіз. Torgsoft құжаттамасы осы кодтаудағы тапсырыс мәтіндік файлы үшін BOM талап етеді.
6. Шот тауарларын резервке қоюды және синхрондау кестесін баптаңыз.

Torgsoft тауарларды TSGoods.trs файлына — бөлгіші ; болатын CSV түрінде немесе YML форматында экспорттай алады. Алғашқы қосылу кезінде бір формат пен тұрақты бағандар жиынтығын келіскен ыңғайлы. Өрістердің реті мен құрамы бағдарламада бапталады.

Сервис осы файлды алып, жазбаларды Etsy сұрауларына түрлендіріп, тапсырыстарды .sal файлдары түрінде қайтаруы тиіс. Etsy мұндай Torgsoft файлдарын өзі өңдемейді. Барлық түрлендіруді әзірленген сервис орындайды.

Кезекті экспортта позицияның болмауын хабарландыруды жою пәрмені ретінде автоматты түрде қабылдауға болмайды. Әзірлеуші нөлдік қалдыққа, тауарды алмасудан шығаруға және файлды алу қатесіне арналған жеке ережелерді анықтауы тиіс.

3-қадам. Etsy API жүйесіне қолжетімділік алу

Etsy әртүрлі қолжетімділік деңгейлерін ұсынады. Seller App сатушының өз дүкеніне арналған. Әртүрлі сатушылар қосылатын сервис үшін әзірлеуші Personal App қолданбасынан бастайды. Бірнеше дүкен пайдалануы үшін Commercial Access алу қажет; Etsy мұндай өтінімдерді қолмен қарайды.

Қолданба түрін оның нақты мақсатына қарай таңдау қажет. Қолжетімділік шарттары Etsy Open API v3 құжаттамасында сипатталған.

Дүкен иесі OAuth 2.0 және PKCE арқылы қолжетімділікке рұқсат береді: Etsy бетін ашып, қолданба құқықтарын растайды. Сервис алынған токендерді сақтап, refresh token арқылы қолжетімділікті жаңартып отыруы тиіс.

Хабарландыруларды оқу үшін listings_r, оларды өзгерту үшін — listings_w, тапсырыстарды алу үшін — transactions_r рұқсаты қажет. Жөнелту деректерін беру үшін transactions_w және тиісті әдіске Etsy-дің жеке рұқсаты қажет.

Әрбір API сұрауында x-api-key keystring:shared_secret форматында болуы тиіс. Қорғалған операциялар үшін Authorization: Bearer … тақырыбы да қажет. Толық ақпарат авторизация нұсқаулығында берілген. Etsy есептік жазбасының құпиясөзін сервиске берудің қажеті жоқ.

4-қадам. Torgsoft тауарларын Etsy хабарландыруларымен сәйкестендіру

Алғашқы іске қосу үшін сатушы Etsy-де алдын ала дайындаған хабарландыруларды пайдалануға болады. Әзірлеуші олардың тауар нұсқаларын Torgsoft позицияларымен байланыстырып, артикулдардың сәйкестігін тексереді.

Бір Etsy хабарландыруында бірнеше нұсқа болуы мүмкін. Сондықтан байланыстыру үшін дүкеннің shop_id, хабарландырудың listing_id және тиісті Etsy тауар нұсқасын сақтау қажет. Torgsoft жүйесіндегі әрбір қоймалық нұсқаға сипаттамалардың нақты комбинациясы сәйкес келуі тиіс.

Шартты идентификаторлармен сәйкестендіру мысалы:

Егер тапсырыста белгісіз SKU немесе нұсқа келсе, сервис осы тапсырыстың импортын тоқтатып, себебін көрсетуі тиіс. Ұқсас атау бойынша автоматты сәйкестендіру басқа тауардың есептен шығарылуына әкелуі мүмкін.

Хабарландыруларды автоматты түрде жасау үшін не қажет

Бұл кезеңді қалдықтар мен тапсырыстар тексерілгеннен кейін қосуға болады. Физикалық тауар үшін Etsy атауды, сипаттаманы, бағаны, санды және өзінің параметрлерін талап етеді:

Ортақ ережелерді сервис баптауларында, ал нақты бұйымдардың айырмашылықтарын — тауар сипаттамаларында немесе сәйкестік кестесінде сақтауға болады. Сатушы сипаттама мен фотосуреттерді жарияламас бұрын тексеруі тиіс. Жасау тәртібі Etsy хабарландыруларының құжаттамасында берілген.

5-қадам. Тапсырыстарды Torgsoft жүйесіне жүктеу

Сервис API арқылы тапсырыстарды тұрақты түрде алуы тиіс. Егер қолданба үшін webhooks — Etsy оқиғалары туралы автоматты хабарламалар — қолжетімді болса, order.paid өңдеуін қосуға болады. Хабарлама алынғаннан кейін тапсырыстың өзекті деректерін жүктеу қажет. Etsy сондай-ақ бас тарту, жөнелту және жеткізу оқиғаларын құжаттайды.

Webhooks үшін жалпыға қолжетімді қабылдау мекенжайы және сұрау қолтаңбасын тексеру қажет. Олардың таңдалған қолданба үшін қолжетімділігін тіркелу кезінде тексеру керек. Өткізіп алынған оқиғаларды қалпына келтіру үшін тапсырыстарды мерзімді түрде алуды сақтаған жөн. Талаптар webhooks құжаттамасында сипатталған.

Torgsoft үшін файл жасамас бұрын сервис төлем мәртебесін, тапсырыс құрамын, барлық тауарлардың сәйкестігін, валютаны және алушының мекенжайын тексереді. Бірнеше дүкеннің тапсырыстарын ажырату үшін өзіндік тапсырыс нөмірін shop_id және receipt_id негізінде қалыптастырған жөн.

Тапсырыс файлының мысалы

Төменде шартты деректері бар .sal мәтіндік файлының мысалы берілген. GoodID мәнін нақты тауардың кілтімен ауыстыру қажет. Алушының деректерін, тапсырыс нөмірін, баға мен санды сервис Etsy-ден алады.

[Client]
Name=Etsy-дегі алушының аты
Country=Germany
City=Berlin
ZIP=10115
Address=Etsy-дегі алушының мекенжайы

[Options]
OrderNumber=etsy-12345678-987654321
SaleType=5
CurrencyInternationalCode=USD
Comment=Etsy: сатып алушының төлемі расталды; жөнелту өңдеуді күтуде

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

Бұл мысалда SaleType=5 шот жасайды. Төлемді түсініктемеде белгілеу өздігінен қаржылық операция жүргізбейді. Бұл нұсқа төлем мен жөнелтуді әлі де қызметкер өңдейтін бастапқы импортты тексеруге қолайлы.

Torgsoft құжатталған форматы басқа сценарийлерді де қолдайды:

Төленген сатып алуды автоматты түрде есепке алу үшін қаржылық баптаулар тексерілгеннен кейін SaleType=2 қолдануды қарастыруға болады. SaleType=3 тауарды жөнелтуді де білдіреді, сондықтан оны пайдалану келісілген қоймалық операциямен байланыстырылуы тиіс. Etsy-дегі төлем оқиғасы сәлемдеменің тасымалдаушыға берілгенін растамайды.

Құжаттамада ескерту бар: SaleType=2–5 сценарийлері қажетті тауардың бар болуын көздейді; ол болмаған жағдайда теріс қалдықпен сату орын алуы мүмкін. Импорт алдында қолжетімді санды тексеру қажет. Тапсырыс валютасын CurrencyInternationalCode арқылы қолдау дерекқордың 493-нұсқасынан бастап құжатталған.

Файл импортқа қолжетімді болғанға дейін толық жазылуы тиіс. Файл атауы ASCII таңбаларынан тұруы керек. UTF-8 үшін Torgsoft жүйесінің BOM талаптарын орындау қажет. Іске қосар алдында әзірлеуші импортты бағдарламаның орнатылған нұсқасында тексереді.

Резервтелген тауарды қайта сатпай қалдықтарды қалай жаңарту керек

Шот жасалғаннан кейін тауарды резервке қою қажет. Torgsoft жүйесінде бұл үшін «Шот тауарларын резервке қою» баптауы бар. Резерв мерзімі тапсырысты дайындау уақытын қамтуы тиіс; төленген бұйым осы мерзім аяқталғаннан кейін қайтадан қолжетімді қалдыққа түспеуі керек.

Алмасу сервисі үшін мынадай ережені анықтаған жөн:

Бұл интеграция үшін ұсынылатын есептеу ережесі. Алдымен экспортталған сан өрісі резервтерді қазірдің өзінде ескеретінін немесе ескермейтінін тексеру қажет. Бір резерв қолжетімді санды бір рет қана азайтуы тиіс. Импорт расталғаннан кейін сервис жағындағы уақытша азайту Torgsoft жүйесіндегі резервпен немесе есептен шығарумен ауыстырылады.

Мысалы, 10 дайын бұйымның 2-еуі резервтелген, тағы 1-еуі Etsy-де төленген және импортты күтіп тұр. Егер сақтандыру қоры 1 болса, сатуға 6 бұйым қолжетімді. Бұл мысалда бастапқы 10 саны резервтерді шегергенге дейінгі физикалық сан деп есептеледі.

Etsy-дегі санды көбейтпес бұрын сервис жаңа тапсырыстарды өңдеп, Torgsoft жүйесінің өзекті экспортын пайдалануы тиіс. Әйтпесе ескірген файл жаңа ғана сатып алынған тауарды қайтадан сатуға шығарып жіберуі мүмкін. Мерзімді синхрондау арқылы әртүрлі арналардағы бір мезгілдегі сатып алуларды толық болдырмау мүмкін емес; тапшылығы бар позициялар үшін сақтандыру қоры немесе Etsy-ге арналған бөлек тауар қоры қажет.

Etsy нұсқаларын жаңарту updateListingInventory арқылы орындалады. Бұл әдіс хабарландырудағы тауар нұсқаларының толық жиынтығын талап етеді. Сервис барлық комбинацияларды және бағаның, санның және SKU-дың сипаттамаларға тәуелділігінің дұрыс ережелерін сақтауы тиіс. Толық ақпарат Etsy қалдықтарын жаңарту сипаттамасында берілген.

Бас тарту және қайтару кезінде не істеу керек

Егер тапсырыс жөнелтілгенге дейін тоқтатылса, мәртебесі тексерілгеннен кейін тиісті резервті алып тастау қажет. Егер тауар жөнелтіліп қойған болса, оның қоймадағы қалдығын нақты қайтарылғаннан және Torgsoft жүйесінде құжат рәсімделгеннен кейін ғана көбейтуге болады.

Жаңа тапсырысты .sal арқылы жүктеу бұрын жасалған құжаттарды автоматты түрде өзгерту мүмкіндігін растамайды. Бас тартулар мен қайтаруларды өңдеуді қолдау көрсетілетін тетік арқылы бөлек әзірлеу немесе қажетті әрекет туралы хабарламамен қызметкерге қалдыру қажет.

Төлемді қалай есепке алу және трек-нөмірді қалай беру керек

Баптауларда жариялау бағасын, сатылған тауардың бағасын, тапсырыс валютасын және Etsy-мен есеп айырысуды есепке алу тәртібін бөлек анықтау қажет. Жеңілдіктер, жеткізу, платформа алатын салықтар мен комиссиялар жеке ережелер бойынша өңделуі тиіс. Тауар бағасы өрісіне тапсырыстың жалпы сомасын беруге болмайды.

Etsy-де сатып алушының төлемі мен сатушыға қаражаттың төленуі — әртүрлі қаржылық оқиғалар. Torgsoft жүйесінде алдын ала төлемді автоматты түрде жасау кейінгі төлем қайталама табыс қалыптастырмайтындай етіп бапталуы тиіс. Тауар тапсырысын файл арқылы импорттау өздігінен комиссиялар мен төлемдерді салыстыруды қамтамасыз етпейді.

Жөнелткеннен кейін сервис createReceiptShipment арқылы Etsy-ге тасымалдаушы мен трек-нөмірді бере алады. Etsy бұл әдіске қолжетімділікті бөлек мақұлдайды: Commercial Access және transactions_w рұқсаты оның қолжетімді болуына кепілдік бермейді. Рұқсат алынғанға дейін сатушы жөнелту ақпаратын Etsy кабинеті арқылы қосады.

Etsy Shipping Labels жапсырмаларын Open API v3 арқылы сатып алуға қолдау көрсетілмейді. Шектеу тапсырыстарды орындау құжаттамасында көрсетілген.

Әзірлеуші күнделікті жұмыс үшін нені қарастыруы керек

• shop_id + receipt_id жұбы бойынша қайталама импорттан қорғау. Қайталанған оқиға немесе сұрау тағы бір шот жасамауы тиіс.
• Өңдеу күйлерін есепке алу: тапсырыс алынды, файл дайындалды, импортқа берілді, құжаттың жасалғаны расталды. Файлды беру импорттың сәтті аяқталғанын білдірмейді.
• Ақаудан кейін тапсырыс нөмірі бойынша салыстыру. Егер импорт нәтижесі белгісіз болса, алдымен Torgsoft жүйесіндегі құжатты тауып, содан кейін қайталап көру қажет пе екенін шешу керек.
• Әр хабарландыруды ретімен жаңарту және санды өзгертпес бұрын деректердің өзектілігін тексеру.
• Тапсырыс нөмірі, тауар, себеп және қызметкер орындайтын қажетті әрекет көрсетілген қателер журналы. Құпиясөздер мен токендер журналға түспеуі тиіс.
• Соңғы сәтті экспорт, тапсырыстарды алу және Etsy жаңартуы уақытын бақылау. Ұзақ кідіріс болған жағдайда қызметкер хабарлама алуы тиіс.

Etsy қолданба кілті үшін секундына және тәулігіне API сұрауларының санын шектейді. Сервис өз квоталарын ескеріп, 429 жауабын retry-after бойынша үзіліспен өңдеуі тиіс. Квота мәндерін әзірлеуші кабинетінде және жауап тақырыптарында сұрауларды шектеу ережелерінде сипатталғандай тексеру қажет.

Алмасу рұқсат етілген API арқылы жұмыс істеп, Etsy шарттарына сәйкес болуы тиіс. Сатып алушылардың деректерін тек рұқсат етілген қызмет көрсету шегінде пайдалану қажет. Оларды жарнамалық сервистерге беру және сұралмаған маркетингтік хабарламалар жіберуге тыйым салынады. Коммерциялық қолданба үшін buyer_email қолжетімділігі бөлек сұралады; импорт осы өрістің міндетті түрде болуына тәуелді болмауы тиіс.

Автоматты іске қосу алдында нені тексеру керек

Осындай әзірлемеге тапсырыс беру үшін Torgsoft нұсқасын, тауарлардың сынақ экспортын, қоймалар тізімін, Etsy хабарландыруларының мысалдарын және төлемдерді есепке алу ережелерін дайындау қажет. Осы негізде әзірлеуші алмасу форматын келісіп, сервисті іске асырып, оның нақты дүкенде жұмысын тексере алады.