Cum configurezi webhook-urile în easySales: trimite comenzile, AWB-urile și stocul către sistemele tale
Trimite evenimentele din easySales, precum comenzile noi, AWB-urile, facturile și modificările de stoc, către sistemele tale chiar în momentul în care au loc și ține abonările în funcțiune.
La ce folosesc webhook-urile
Un webhook anunță un alt sistem în clipa în care se întâmplă ceva în easySales. Când intră o comandă, se generează un AWB sau se schimbă stocul unui produs, easySales trimite detaliile la o adresă aleasă de tine, iar ERP-ul, programul de contabilitate sau magazinul tău online pot reacționa imediat, fără să mai verifice easySales la fiecare câteva minute.
Deschide pagina easy-sales.com/webhooks cât timp ești autentificat în cont. Fiecare rând de pe ea este o abonare: un eveniment, trimis către o singură adresă.
Trei lucruri de știut de la început:
- Adresa care primește datele o construiești tu sau programatorul tău. easySales trimite datele, iar sistemul de la adresa respectivă decide ce face cu ele.
- O abonare care tot eșuează se oprește singură. După 100 de încercări eșuate, easySales nu mai trimite nimic și te anunță pe e-mail. Abonarea nu repornește singură.
- Cât timp abonarea e oprită, evenimentele nu se păstrează. Când o pornești din nou, trimiterea se reia din acel moment.
Cum te abonezi la un eveniment
- Apasă Subscribe to webhook.
- La Url, introdu adresa care va primi datele. Folosește o adresă https.
- Lasă HTTP method pe POST.
- La Webhook, alege evenimentul.
- La Secret, introdu o cheie de cel puțin 24 de caractere. Sistemul tău o folosește ca să verifice că datele vin într-adevăr de la easySales.
- Apasă Save.
Abonarea apare sub numele evenimentului ei. Ca să trimiți același eveniment și către un al doilea sistem, abonează-te din nou, cu cealaltă adresă. O adresă poate fi adăugată o singură dată pentru fiecare eveniment.
| Eveniment | Se trimite când |
|---|---|
| Order created | Intră o comandă nouă, din orice canal, sau o adaugi manual. |
| Order updated | Se schimbă ceva pe o comandă, de exemplu statusul, produsele sau adresa. Evenimentul acesta se trimite des. |
| Awb created | Se generează un AWB pentru o comandă, printr-un curier din easySales. |
| Delivery status updated | Curierul raportează un status nou de livrare pentru un colet. |
| Invoice created, Storno invoice created | Se emite o factură sau o factură storno pentru o comandă. |
| Return created, Return updated | Se creează un retur sau i se schimbă statusul, produsele, notele, expedierile ori facturile. |
| Product created, Product updated | Se adaugă sau se modifică un produs, inclusiv prețul lui. |
| Product stock updated | Se schimbă stocul unui produs. |
| Category created / updated, Characteristic created / updated | Se adaugă sau se modifică o categorie ori o caracteristică. |
| Products refresh requested, Stock refresh requested | Se cere o actualizare a produselor sau a stocului pentru un magazin online. |
| Ticket created, Ticket updated | Începe o conversație cu un cumpărător în Clienți → Tichete sau se modifică una existentă. |
| Account suspended, Account activated | Contul easySales este suspendat sau reactivat. |
Verifică ce s-a trimis
Fiecare abonare arată Success sau Failed pentru ultimul eveniment trimis și momentul în care a plecat. Apasă More details... ca să vezi acel eveniment:
- Payload sunt datele trimise de easySales.
- Response este răspunsul primit de la adresa ta, cu tot cu codul de stare.
- Attempt 2 of 3 | Next attempt: … înseamnă că trimiterea a eșuat și evenimentul va fi retrimis. Final attempt has been made înseamnă că pentru acel eveniment nu mai urmează nicio încercare.
Aici vezi doar ultimul eveniment al fiecărei abonări.
Cum modifici, oprești sau ștergi o abonare
- Edit schimbă adresa, metoda HTTP sau cheia secretă. Ca să trimiți alt eveniment, abonează-te la acel eveniment și șterge abonarea veche.
- Disable oprește temporar abonarea, iar Enable o pornește din nou. Cât timp e oprită nu se trimite nimic, iar evenimentele din perioada respectivă nu se mai trimit nici ulterior.
- Unsubscribe șterge abonarea pe loc.
Ce trebuie să facă sistemul tău
| Detalii | |
|---|---|
| Format | JSON, cu datele evenimentului în payload, iar id-ul abonării și numele evenimentului în webhook. |
| Semnătură | Headerul Signature conține un HMAC-SHA256 al conținutului cererii, calculat cu cheia ta secretă. Calculează-l pe conținut exact așa cum l-ai primit. |
| Răspuns | Orice status 2xx, în cel mult 3 secunde. Răspunde întâi și procesează datele după aceea. |
| Certificat | Adresele https trebuie să aibă un certificat valid. |
| Reîncercări | Trei încercări pentru fiecare eveniment: a doua la circa 10 secunde după prima, a treia la circa 100 de secunde după aceea. |
| Ordinea în care sosesc | Din cauza reîncercărilor, evenimentele pot sosi în altă ordine. Bazează-te pe datele din payload, nu pe momentul în care au sosit. |
Când o abonare se oprește singură
Contează orice încercare eșuată: un răspuns cu eroare, niciun răspuns în 3 secunde sau o problemă de certificat. După 100 de încercări eșuate, abonarea se oprește și primești e-mailul „Webhook-ul a fost dezactivat”. Butonul Vezi webhook-uri din e-mail te duce pe această pagină.
- Rezolvă problema de la adresa care primește datele.
- Apasă Enable pe abonare.
- Preia prin API-ul easySales modificările pe care le-ai ratat, de exemplu comenzile modificate în acea perioadă.
Accesul echipei la webhook-uri
Un membru al echipei are nevoie de permisiunea Accesare webhooks ca să deschidă pagina. Cu ea poate adăuga, modifica, opri și șterge abonări.
Când ceva nu merge cum trebuie
| Ce vezi | Ce faci |
|---|---|
| Nu mai sosește nimic, iar abonarea arată Enable | Abonarea s-a oprit după eșecuri repetate. Repară adresa, apasă Enable, apoi preia prin API modificările ratate. |
| Ultimul eveniment arată Failed | Deschide More details... și verifică codul de stare și răspunsul adresei tale. |
| „The secret must be at least 24 characters.” | Introdu o cheie secretă de cel puțin 24 de caractere. |
| „The url has already been taken.” | Adresa primește deja acest eveniment. Modifică abonarea existentă în loc să adaugi una nouă. |
| Nu primești facturile storno | Abonează-te la Storno invoice created; Invoice created acoperă doar facturile obișnuite. |
| Sistemul care primește datele e copleșit de actualizări de comenzi | Order updated se trimite la fiecare modificare. Răspunde repede și procesează datele în fundal. |