Webhooki

Webhook ob vsaki spremembi zaloge pošlje novo stanje artikla vašemu sistemu, npr. lastni spletni trgovini, skladiščnemu programu ali portalu za partnerje. Pošilja se ne glede na to, ali je zalogo spremenil dokument, brisanje, storno, inventura, prenos med skladišči, uvoz ali blagajna.

Webhooki delujejo le ob aktivni naročnini in v paketu z zunanjim API-jem. Ko naročnina poteče, se pošiljanje ustavi; po podaljšanju se samodejno pošljejo stanja, ki so se medtem spremenila.

Tehnična navodila za razvijalca, ki bo sprejemal podatke, so v razdelku Za razvijalce → Webhooki.

1. Odprite Nastavitve → Webhooki (ali Nastavitve → Zunanje povezave → Webhooki).
2. Kliknite Dodaj.
3. Vnesite:
   • Naziv, npr. “Spletna trgovina”.
   • URL naslov, ki vam ga da razvijalec. Naslov se mora začeti s https://.
   • Skladišča, katerih zalogo želite pošiljati.
   • Obseg:
     • Vsako skladišče posebej: pošlje se stanje vsakega skladišča.
     • Seštevek izbranih skladišč: pošlje se ena skupna količina.
   • Poslano količino:
     • Razpoložljiva zaloga: zaloga minus rezervirano z odprtimi naročili kupcev.
     • Zaloga na skladišču.
4. Shranite. Quibi enkrat prikaže skrivnost (whsec_...). Kopirajte jo in jo varno predajte razvijalcu. Po tem je ne prikaže več.
5. Kliknite Testna dostava in preverite, da je dostava uspela. Testna dostava zaloge ne spremeni.
6. Če želite poslati trenutno stanje vseh artiklov, kliknite Pošlji celotno stanje. Nov webhook sicer pošilja le prihodnje spremembe.

V seznamu webhookov vidite zadnji uspeh, zadnjo napako, število čakajočih in neuspešnih dostav ter čas naslednjega poskusa.

Ob kliku na Dostave se odpre seznam posameznih dostav:

• Čaka: dostava bo poslana oziroma ponovljena. Neuspešne poskuse Quibi samodejno ponavlja približno 24 ur.
• Uspešna: prejemnik je potrdil prejem.
• Neuspešna: prejemnik je zavrnil podatke ali pa so se poskusi iztekli. Ko razvijalec odpravi vzrok, kliknite Ponovi.
• Preklicana: nastavitve webhooka so se spremenile, zato stari podatki niso bili poslani.
• Nadomeščena z novejšo: medtem je bilo poslano novejše stanje istega artikla.

• Ko spremenite URL, skladišča, obseg ali vrsto količine ali ustvarite novo skrivnost, se še neposlane dostave prekličejo. Tako ne odidejo na nov naslov. Po spremembi po potrebi kliknite Pošlji celotno stanje.
• Ko webhook izklopite ali izbrišete, se neposlane dostave prekličejo.

• “Dovoljen je le HTTPS naslov” ali “Naslov prejemnika ni javen”: naslov mora biti javno dosegljiv https:// naslov na standardnih vratih. Lokalni in notranji naslovi niso dovoljeni.
• Neuspešna dostava s kodo 401: razvijalec uporablja napačno skrivnost. Ustvarite novo in mu jo predajte.
• Ni dostav, čeprav se zaloga spreminja: preverite, ali je naročnina aktivna, ali je webhook aktiven in ali so izbrana prava skladišča.