Kako brendovi pretplatničke e-trgovine mogu da prate ponavljajuće pošiljke pomoću API-ja za praćenje
Da biste pratili ponovljene pošiljke pomoću API-ja za praćenje, kreirajte zapis o pošiljci za svaki fizički paket, povežite ga sa porudžbinom za ispunjenje za taj ciklus pretplate i registrujte njegov broj za praćenje kada vam ga dostavi vaše skladište ili partner za ispunjenje. Koristite ažuriranja praćenja API-ja da biste kupcima prikazali gde se paket nalazi i označili izuzetke u isporuci za svoj tim. ID pretplate koristite kao vezu između ciklusa, a ne kao identifikator paketa.

Pratite paket, a ne pretplatu
Pretplata vam govori šta je kupcu planirano za isporuku tokom vremena. Porudžbina za ispunjenje govori šta treba poslati u jednom ciklusu. Broj za praćenje govori o konkretnom paketu. Razdvajanje ovih zapisa sprečava da se zakašnjela pošiljka iz jednog ciklusa pojavi na stranici za praćenje narednog ciklusa.
Na primer, pretpostavimo da je pretplatnička kutija za maj podeljena u dva paketa, a da je kutija za jun poslata dok je jedan majski paket još u transportu. Kupac treba da vidi dva paketa pod majskom porudžbinom i zaseban paket pod junskom porudžbinom. Kasno ažuriranje za maj treba da promeni samo podatke o majskom paketu. Ako pošaljete zamenu, kreirajte novi zapis o pošiljci i povežite ga sa originalnim kako bi podrška mogla da vidi zašto oba zapisa postoje.
- Pretplata: Sačuvajte ID pretplate kako bi podrška mogla da pronađe istoriju pošiljki kupca.
- Ciklus i porudžbina: Zabeležite identifikator ciklusa ili planirani datum ispunjenja, ID porudžbine i sve ID-jeve ispunjenja potrebne za povezivanje paketa sa odgovarajućom porudžbinom. Nemojte zaključivati ciklus na osnovu datuma prijema događaja praćenja.
- Pošiljka: Dodelite svakom paketu interni ID pošiljke. Sačuvajte prevoznika i broj za praćenje, relevantnu referencu ispunjenja i svaki ID registracije praćenja koji dobavljač vrati. Otkazane nalepnice i zamenjene brojeve za praćenje sklonite iz aktivnog prikaza za kupca, ali zadržite istoriju za podršku.
Na stranici porudžbine prikažite napredak na nivou paketa zajedno sa sažetkom porudžbine. Ako je jedan paket isporučen, a drugi je u transportu, jasno to navedite. Celokupnu porudžbinu prikažite kao isporučenu tek kada stignu svi paketi potrebni za njeno kompletiranje, uzimajući u obzir otkazane pošiljke i zamene.
Povežite ispunjenje sa API-jem za praćenje
- Registrujte na osnovu događaja ispunjenja. Pokrenite registraciju kada sistem za ispunjenje, skladište ili partner za logistiku treće strane pošalje podatke o prevozniku i broju za praćenje. Obnova plaćanja je prerana: porudžbina možda još čeka slanje, a broj za praćenje možda ne postoji.
- Sačuvajte pošiljku pre pozivanja API-ja. Trajno sačuvajte interni zapis o pošiljci i stavite zahtev za registraciju u red čekanja. Ako ista poruka o ispunjenju stigne dvaput, ponovo upotrebite taj zapis umesto da kreirate drugi paket. Ako poziv API-ja istekne, proverite da li je prvobitni zahtev uspeo pre ponovnog pokušaja, kada vam dobavljač za to pruži mogućnost.
- Povežite ažuriranja sa registrovanim paketom. Koristite identifikator registracije dobavljača ako se vraća u ažuriranjima. U suprotnom, koristite identifikatore navedene u njegovoj dokumentaciji i proverite rezultat u odnosu na zapise o pošiljkama. Ako bi ažuriranje moglo da pripada više od jednog zapisa, pošaljite ga na proveru umesto da ga primenite na najnoviju porudžbinu.
- Odvojite kreiranje nalepnice od kretanja kod prevoznika. Broj za praćenje može da postoji pre nego što prevoznik evidentira preuzimanje. Koristite poruku poput „Priprema za preuzimanje od strane prevoznika“ kada imate samo nalepnicu. Status „U transportu“ koristite samo kada ga podržavaju informacije prevoznika.
17TRACK Tracking API je jedna od opcija za ovakvo podešavanje. Njegova dokumentacija za programere predstavlja referencu za registraciju brojeva za praćenje i prijem ažuriranja praćenja. Koristite ta ažuriranja za održavanje zapisa o paketu u svom sistemu; pravila za dodelu ciklusa, završetak porudžbine i obaveštavanje kupaca zadržite u svojoj aplikaciji za e-trgovinu. Pre uvođenja, testirajte pakete sa stvarnih ruta svojih prevoznika i partnera za ispunjenje, umesto da se oslonite samo na listu prevoznika.
Učinite ažuriranja bezbednim za obradu dva puta
Ako vaš dobavljač podržava webhook-ove, koristite ih za prijem ažuriranja bez neprekidnog anketiranja svakog paketa. Webhook je HTTP zahtev koji dobavljač šalje vašoj aplikaciji. Pratite zahteve dobavljača za verifikaciju, trajno čuvajte prihvaćene podatke i potvrđujte zahteve u skladu sa njegovim dokumentovanim pravilima odgovora. Sporiji posao, kao što je ažuriranje prikaza porudžbine ili slanje e-pošte, izvršavajte izvan rukovaoca zahteva.
Projektujte putanju obrade tako da ponovljeno ažuriranje nema dodatni efekat. Ako dobavljač šalje stabilne ID-jeve događaja, koristite ih za prepoznavanje ponavljanja. Ako šalje snimke stanja praćenja umesto pojedinačnih događaja, pre preduzimanja radnje uporedite pristiglo stanje i istoriju skeniranja sa podacima koje već imate. Duplirane poruke kupcima obrađujte zasebno: obaveštenje o isporuci koje je već poslato ne treba ponovo slati samo zato što su isti podaci o pošiljci obrađeni dvaput.
Vreme kada je skeniranje obavljeno držite odvojeno od vremena kada ga je vaša aplikacija primila. Skeniranje „u transportu“ koje kasno stigne može pripadati istoriji paketa, a da ne zameni noviji status „isporučeno“. Ipak, nemojte pretpostaviti da svaka legitimna promena pomera paket napred. Ispravka prevoznika ili ažuriranje o vraćanju pošiljaocu mogu zahtevati promenu prikaza. Ako su novi podaci u sukobu sa sačuvanim stanjem i ne možete utvrditi koji su tačni, stavite pošiljku u red za proveru.
Periodično proveravajte otvorene pošiljke kojima je možda potrebna pažnja: registracije koje su još na čekanju, pakete bez prvog skeniranja nakon očekivane predaje i pošiljke čije je praćenje utihnulo. Ako API podržava upit ili osvežavanje, koristite ga selektivno u okviru ograničenja dobavljača. Pre eskalacije proverite obrazac kod različitih prevoznika i skladišta. Ako ažuriranja istovremeno prestanu za više nepovezanih pošiljki, istražite integraciju pre otvaranja pojedinačnih slučajeva isporuke.
Pretvorite podatke o praćenju u korisne poruke za kupce
Kupcima retko treba e-poruka za svako skeniranje. Počnite porukama povezanim sa nečim što treba da znaju ili urade: paket je ušao u mrežu prevoznika, pokušaj isporuke zahteva reakciju ili je prevoznik prijavio isporuku. Prikažite referencu porudžbine i relevantnu kutiju ili ciklus kako bi pretplatnici znali na koju se pošiljku poruka odnosi. Kod podeljene porudžbine navedite paket i jasno naznačite da li je ostatak porudžbine još na putu.
- Nalepnica kreirana, nema skeniranja: Uporedite očekivanu predaju sa evidencijom skladišta. Ako je rok za predaju prošao, zatražite od ispunjenja da potvrdi da li je paket napustio objekat pre nego što kupcu kažete da kasni u transportu.
- Praćenje je prestalo da se pomera: Koristite pragove koji odražavaju rutu i uslugu, umesto jednog tajmera za svaki paket. Kod prekograničnih pošiljki pregledajte poslednji događaj prevoznika pre nego što odlučite da kontaktirate kupca ili eskalirate slučaj.
- Neuspešan pokušaj ili potrebno preuzimanje: Recite kupcu koja je radnja potrebna ako prevoznik pruži jasna uputstva. Ako je događaj nejasan, prosledite slučaj podršci umesto da nagađate datum ponovne isporuke ili lokaciju preuzimanja.
- Označeno kao isporučeno, ali nije primljeno: Zadržite status koji je prijavio prevoznik i otvorite zaseban slučaj podrške. Vaš tok rada podrške treba da razlikuje prijavu kupca od ispravke prevoznika.
Omogućite osoblju podrške jedinstven prikaz ciklusa, porudžbine, istorije paketa i već poslatih poruka. Za svaki izuzetak dodelite odgovornu osobu i sledeći korak. Ispunjenje može istražiti propuštenu predaju, logistika može pratiti izuzetak prevoznika, a podrška može voditi komunikaciju sa kupcem. Status praćenja opisuje paket; on ne odlučuje da li je potrebna zamena ili povraćaj novca.
Testirajte preklapanje pre uvođenja
Počnite sa jednim partnerom za ispunjenje i skupom pošiljki koji odražava način na koji on stvarno šalje porudžbine. Uključite ciklus sa više paketa, poništenu nalepnicu, zamenu i stariju pošiljku koja je još otvorena kada se pošalje naredni ciklus. Zatim namerno ponovite duplirani webhook i isporučite stariji događaj nakon novijeg. Proverite zapis o paketu, stranicu porudžbine kupca, prikaz za podršku i dnevnik obaveštenja. Test koji proverava samo uspešan odgovor API-ja može da propusti najskuplju grešku: ažuriranje pogrešne porudžbine ili slanje poruke pogrešnom kupcu.
Pratite neuspešne registracije, udeo kvalifikovanih paketa koji su uspešno registrovani, prva skeniranja koja kasne u odnosu na očekivanje i nepovezana ažuriranja. Ako pratite kašnjenje ažuriranja, razlikujte vreme između događaja prevoznika i prijema od vremena koje vašem sistemu treba za obradu. To vam pomaže da odlučite da li treba istražiti izvor podataka prevoznika, vašu webhook krajnju tačku ili red čekanja unutar aplikacije.
Proširite se na više ruta kada za svaki paket možete odgovoriti na tri pitanja: Kom ciklusu pripada? Šta je prevoznik poslednje prijavio? Ko reaguje ako ažuriranje nedostaje ili je pogrešno? Ako je bilo koji odgovor nejasan, popravite mapiranje zapisa ili tok rada za izuzetke pre dodavanja novih pravila za obaveštavanje.
Česta pitanja
Može li API za praćenje da kaže kupcima kada će njihova sledeća pretplatnička kutija biti poslata?
Za sledeći planirani datum slanja koristite raspored pretplate i sistem za ispunjenje. API za praćenje namenjen je konkretnom paketu kada informacije za praćenje postoje. Planirani datum slanja, procena isporuke prevoznika i potvrđena isporuka različite su činjenice i treba ih zasebno označiti.
Šta ako skladište zameni broj za praćenje nakon slanja e-poruke?
Označite staru nalepnicu kao zamenjenu i povežite novi broj za praćenje sa istom porudžbinom. Ako e-poruka vodi na stranicu za praćenje na nivou porudžbine, ažurirajte tu stranicu kako bi kupac mogao da pronađe aktivni paket bez prvobitne veze prevoznika. Pošaljite ispravku kada promena utiče na informacije na osnovu kojih kupac treba da preduzme radnju.
Šta ako partner za ispunjenje pošalje brojeve za praćenje bez kodova prevoznika?
Zatražite od partnera dosledno polje za prevoznika ili mapiranje njegovih kodova usluga slanja. Ako vaš API nudi prepoznavanje prevoznika, proverite kako funkcioniše sa nalepnicama partnera pre nego što se oslonite na njega. Nejasna poklapanja prosledite na proveru umesto da birate prevoznika samo na osnovu broja za praćenje.
Da li su za pauzirane ili preskočene pretplate potrebni zapisi o praćenju?
Za ciklus koji se nikada ne šalje nije potreban zapis o paketu. Ako je prethodna pošiljka još otvorena, nastavite da je pratite čak i kada je pretplata pauzirana, preskočena ili otkazana. Status pretplate kontroliše buduće ispunjenje; on vam ne govori šta se dogodilo paketu koji je već napustio skladište.
Izvori
- 17TRACK Tracking API — pregled proizvoda za integraciju praćenja paketa u poslovne sisteme.
- Dokumentacija za 17TRACK Tracking API — referenca za implementaciju registracije brojeva za praćenje i prijem podataka o praćenju.
- Stripe dokumentacija za webhook-ove — referenca za opšte prakse webhook-ova, kao što su obrada dupliranih događaja i izbegavanje pretpostavki o redosledu isporuke. Pridržavajte se sopstvenih pravila dobavljača praćenja za verifikaciju i potvrde.


