Automatizări

Cum configurezi webhook-urile în easySales: trimite comenzile, AWB-urile și stocul către sistemele tale

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

Pagina Webhooks (Panou de control > Webhooks): butonul Subscribe to webhook și patru abonări grupate pe evenimente: Order created și Order updated către erp.magazindemo.ro/hooks/easysales/orders, cu Success; Invoice created către contabilitate.magazindemo.ro/webhook, cu Failed; Product stock updated către www.magazindemo.ro/easysales/stoc, cu Failed și butonul Enable. Fiecare arată URL-ul, cheia secretă, metoda și More details.
O abonare pentru fiecare eveniment și adresă.
  1. Apasă Subscribe to webhook.
  2. La Url, introdu adresa care va primi datele. Folosește o adresă https.
  3. Lasă HTTP method pe POST.
  4. La Webhook, alege evenimentul.
  5. 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.
  6. 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.
Evenimentele la care te poți abona

Verifică ce s-a trimis

Abonarea Invoice created către contabilitate.magazindemo.ro/webhook, cu More details deschis: datele facturii trimise ca payload și răspunsul Service Unavailable, cu marcajele Attempt 2 of 3, ora următoarei încercări și codul de stare 503.
Ultimul eveniment trimis și ce a răspuns adresa ta.

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

Formularul de abonare cu Url, HTTP method POST, Webhook Invoice created, Secret și Save.
Adresa, metoda, evenimentul și cheia secretă.
  • 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.
Ce trimite easySales și ce așteaptă înapoi

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ă.

  1. Rezolvă problema de la adresa care primește datele.
  2. Apasă Enable pe abonare.
  3. Preia prin API-ul easySales modificările pe care le-ai ratat, de exemplu comenzile modificate în acea perioadă.
📖
Citește în continuare
Cum te conectezi la API-ul easySales: clienți OAuth și tokenuri de acces personale
Creează clienți OAuth și tokenuri de acces personale pentru API-ul easySales, alege tipul de grant și scopurile potrivite și evită ca o conexiune să o deconecteze pe alta.
→
📖
Citește în continuare
Cum conectezi un magazin personalizat la easySales prin API
Conectează prin API orice magazin personalizat sau platformă fără integrare: cele două credențiale necesare, trimiterea produselor și a stocului, comenzile și primirea modificărilor înapoi.
→

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.
Probleme frecvente

Întrebări frecvente

Deschide easy-sales.com/webhooks cât timp ești autentificat. Ajungi acolo și din e-mailul „Webhook-ul a fost dezactivat”.

După 100 de încercări eșuate, easySales oprește abonarea și te anunță pe e-mail. Repară adresa care primește datele și apasă Enable.

Nu. Preia modificările din acea perioadă prin API-ul easySales.

Calculează un HMAC-SHA256 al conținutului cererii cu cheia ta secretă și compară-l cu headerul Signature.

În cel mult 3 secunde, cu un status 2xx. Altfel încercarea contează ca eșuată și se reia.

Da, dacă are permisiunea Accesare webhooks.

A fost util acest ghid?