Skip to main content
DomovBlogPríručkyAko si vybrať API na sledovanie zásielok pre doručovanie vo Francúzsku

Ako si vybrať API na sledovanie zásielok pre doručovanie vo Francúzsku

17TRACK

Vyberte si API na sledovanie zásielok pre doručovanie vo Francúzsku testovaním svojich skutočných prepravcov, francúzskych doručovacích procesov a cezhraničných odovzdaní — nie porovnávaním titulkov o počte prepravcov. Správne API by malo vracať použiteľné udalosti sledovania, rozlišovať dostupnosť na vyzdvihnutie na odbernom mieste od dokončeného doručenia a vyhovovať vašim technickým požiadavkám a požiadavkám na ochranu údajov. Pred prijatím záväzku vykonajte pilotnú prevádzku s reprezentatívnymi zásielkami a dohodnite si merateľné akceptačné kritériá.

Ako si vybrať API na sledovanie zásielok pre doručovanie v

Táto príručka je určená tímom prevádzky elektronického obchodu, vývojárom a pracovníkom zodpovedným za obstarávanie, ktorí pripájajú viditeľnosť zásielok k internetovému obchodu, systému správy objednávok, platforme zákazníckych služieb alebo internému panelu. Cieľom je vybrať spoľahlivý zdroj informácií o doručení, nie jednoducho koncový bod, ktorý prijíma sledovacie čísla.

Začnite zásielkami, ktoré vaša firma skutočne odosiela

„Pokrytie vo Francúzsku“ je príliš široké na to, aby slúžilo ako požiadavka pri nákupe. Firma, ktorá odosiela domáce balíky na domáce adresy, má iné potreby než predajca, ktorý dováža tovar do Francúzska a doručuje ho na odberné miesta. Pred vyžiadaním ukážok alebo cenových ponúk definujte profil zásielok.

  • Geografia doručenia: Samostatne identifikujte kontinentálne Francúzsko, Korziku a všetky francúzske zámorské destinácie. Požiadajte poskytovateľov o potvrdenie príslušných služieb namiesto predpokladu, že jedno geografické označenie pokrýva každú trasu.
  • Spôsob doručenia: Rozlišujte doručenie domov, obsluhované odberné miesta, balíkomaty a ďalšie služby, ktoré skutočne ponúkate.
  • Prepravca a služba: Zaznamenajte prevádzkujúceho prepravcu a názov služby, nielen prepravnú platformu, cez ktorú ste zakúpili štítok.
  • Smer zásielky: Rozlišujte domáce doručenia, prichádzajúce medzinárodné zásielky, odchádzajúce objednávky a vratky.
  • Prevádzkové využitie: Rozhodnite, či bude sledovanie slúžiť na upozornenia zákazníkov, správu výnimiek, preverovanie požiadaviek podpory alebo na všetky tri účely.

Na základe nedávnych objednávok vytvorte maticu prepravcov. V závislosti od vašej firmy môže zahŕňať služby spojené so spoločnosťami Colissimo, Chronopost alebo Mondial Relay. Ide o príklady, ktoré treba porovnať s vašimi vlastnými záznamami o preprave, nie o tvrdenie, že konkrétne API podporuje každú službu, ktorú tieto spoločnosti ponúkajú.

Uveďte očakávaný objem podľa prepravcu a služby. Poskytovateľ, ktorý spoľahlivo zvláda váš najvyťaženejší tok doručenia, môže byť vhodnejší než poskytovateľ s väčším globálnym zoznamom, ale bez overenej podpory vašich hlavných trás.

Vyberte si medzi priamymi integráciami prepravcov a API pre viacerých prepravcov

O priamej integrácii prepravcu sa oplatí uvažovať, keď jeden prepravca predstavuje väčšinu zásielok a váš tím potrebuje prístup k informáciám špecifickým pre daného prepravcu. Aj tak budete musieť overiť oprávnenosť účtu, dokumentáciu, dostupnosť udalostí a podmienky integrácie s týmto prepravcom.

O API na sledovanie zásielok od viacerých prepravcov sa oplatí uvažovať, keď vaša firma využíva viacerých prepravcov alebo pravidelne spracúva medzinárodné odovzdania. Jeho potenciálna hodnota spočíva v znížení počtu integrácií, ktoré váš tím udržiava, a v prezentovaní rôznych formátov sledovania prostredníctvom spoločného rozhrania. To, či túto hodnotu skutočne poskytne, závisí od prepravcov a procesov, ktoré otestujete.

Žiadny z týchto prístupov automaticky nezaručuje rýchlejšie aktualizácie ani podrobnejšie udalosti. Porovnávajte skutočné výstupy a požiadavky na údržbu namiesto predpokladu, že priamy prístup je vždy podrobnejší alebo agregácia vždy jednoduchšia.

V užšom výbere API pre viacerých prepravcov je relevantnou možnosťou na preskúmanie Tracking API od 17TRACK. Pomocou jeho oficiálnej dokumentácie API a technickej diskusie overte požadované služby prepravcov, pracovný postup integrácie, doručovanie udalostí a obchodné podmienky. Vhodnosť pre doručovanie vo Francúzsku by ste mali určiť na základe vlastnej vzorky zásielok, nie odvodiť z dostupnosti spotrebiteľskej služby sledovania.

Testujte pokrytie služieb, nielen rozpoznanie prepravcu

Úspešné vyhľadanie podľa sledovacieho čísla je iba prvým testom. Vaša aplikácia potrebuje dostatok informácií na vysvetlenie toho, čo sa stalo, a na podporu ďalšieho kroku.

Oblasť hodnoteniaČo overiťPrečo je to dôležité
Identifikácia prepravcuRozpoznanie vašich skutočných čísel a spôsob opravy nejednoznačných zhôdPlausibilná, ale nesprávna zhoda môže viesť k zavádzajúcim výsledkom.
Pokrytie služiebUdalosti pre presné domáce a medzinárodné služby, ktoré nakupujeteSamotný názov prepravcu nepotvrdzuje pokrytie na úrovni služby.
Udalosti na odbernom miesteSamostatné spracovanie príchodu, dostupnosti na vyzdvihnutie a vyzdvihnutia zákazníkomBalík čakajúci na vyzdvihnutie by nemal spustiť správu o dokončenom doručení.
Medzinárodné odovzdaniaNadväznosť medzi pôvodným prepravcom a doručovacou sieťou v cieľovej krajineZákazníci potrebujú viditeľnosť aj po zmene siete, cez ktorú balík putuje.
Podrobnosti udalostíPôvodné opisy, normalizované stavy, miesta a časové pečiatky, ak sú k dispozíciiTímy podpory potrebujú kontext presahujúci všeobecný štítok stavu.

Neprítomnosť poľa nepovažujte za dôkaz chyby API bez overenia podkladových údajov prepravcu. Niektoré informácie prepravca nemusí zverejňovať, môžu závisieť od služby alebo byť dostupné iba za určitých podmienok prístupu. Požiadajte poskytovateľa o vysvetlenie hraníc.

Overte, či udalosti doručenia vo Francúzsku vedú k správnej akcii

Odberné miesta a balíkomaty

Pri doručení založenom na vyzdvihnutí sú dostupnosť a dokončenie dve odlišné obchodné udalosti. Otestujte, či API toto rozlíšenie zachováva a či ho vaša aplikácia správne mapuje. Ak údaje obsahujú pokyny na vyzdvihnutie alebo lehotu, pred ich zobrazením overte ich zdroj a význam. Nevypočítavajte univerzálnu lehotu na vyzdvihnutie na základe predpokladanej politiky prepravcu.

Užitočný akceptačný test je jednoduchý: keď je balík pripravený na vyzdvihnutie, váš systém by mal odoslať pokyny na vyzdvihnutie, nie správu „doručené vám“. Keď ho príjemca vyzdvihne, časová os objednávky by mala odrážať konečnú udalosť bez opätovného odoslania skoršieho upozornenia.

Pokusy o doručenie a výnimky

Široká kategória výnimiek môže skrývať veľmi odlišné situácie vrátane neúspešného pokusu o doručenie, problému s adresou alebo oneskorenia súvisiaceho s colným konaním. Pôvodný opis udalosti ponechajte dostupný pracovníkom podpory, aj keď zákazníci uvidia zjednodušený štítok.

Rozhodnite, ktoré udalosti vyžadujú zásah. Problém s adresou môže vyžadovať tiket podpory; bežné spracovateľské skenovanie zvyčajne nie. Tieto pravidlá patria do vášho prevádzkového návrhu a nemali by sa automaticky preberať z taxonómie stavov poskytovateľa.

Jazyk a čas

Opýtajte sa, či sú opisy udalostí pôvodným textom prepravcu, preloženým textom alebo štandardizovanými štítkami. Váš internetový obchod môže poskytovať jednotné francúzske znenie, nemal by však pridávať istotu, ktorú zdrojová udalosť neobsahuje.

Zachovajte posuny časových pečiatok a rozlišujte čas, keď udalosť nastala, od času, keď ju prijal váš systém. Pri prezentovaní miestnych časov pre kontinentálne Francúzsko používajte implementáciu zohľadňujúcu časové pásmo, napríklad Europe/Paris, a nie pevný posun UTC. Ďalšie časové pásma cieľových miest riešte samostatne, ak je to relevantné.

Vyhodnoťte doručovanie aktualizácií a správanie pri obnove

Webhooky môžu znížiť potrebu opakovaných požiadaviek na stav, ale prijatie webhooku neznamená, že udalosť bola zachytená bezprostredne po fyzickom skenovaní. Medzi skenovaním, zverejnením údajov prepravcom, ich získaním poskytovateľom sledovania a spracovaním vašou aplikáciou môžu byť samostatné časové intervaly.

Požiadajte poskytovateľov o vysvetlenie týchto fáz a všetkých zdokumentovaných záväzkov týkajúcich sa úrovne služieb. Vyhnite sa porovnávaniu tvrdení o „sledovaní v reálnom čase“ bez spoločnej definície.

  • Overenie: Ako sa overujú prichádzajúce upozornenia a ako sa obmieňajú prihlasovacie údaje?
  • Opakovanie: Čo sa stane, keď váš koncový bod prekročí časový limit alebo vráti chybu?
  • Duplikáty: Môže tá istá udalosť prísť viackrát a ako ju máte identifikovať?
  • Poradie: Môžu skoršie udalosti prísť po neskorších?
  • Obnova: Môžete načítať históriu zásielky alebo obnoviť aktualizácie po výpadku?
  • Limity: Aké limity požiadaviek, registrácie, súbežnosti alebo veľkosti dát platia?

Navrhnite integráciu tak, aby tolerovala opakovania a oneskorené udalosti. Ukladajte udalosti trvalo, zabráňte duplicitným správam zákazníkom a nenahrádzajte stav dokončeného doručenia staršou udalosťou „na ceste“ len preto, že prišla neskôr.

Otestujte aj zlyhania registrácie zásielok. Neplatné číslo, nepodporovaná služba alebo nejednoznačná zhoda prepravcu by mali vstúpiť do viditeľného frontu výnimiek, nie zmiznúť z pokrytia sledovania.

Pred odoslaním živých údajov o zákazníkoch preskúmajte ochranu údajov

Údaje o sledovaní môžu byť osobnými údajmi, ak súvisia s identifikovateľnou osobou. Podľa GDPR môžu relevantné povinnosti zahŕňať minimalizáciu údajov, obmedzenie uchovávania, primerané zabezpečenie, dojednania so sprostredkovateľom a záruky pri medzinárodných prenosoch. Konkrétne zodpovednosti závisia od konfigurácie služby a úloh jednotlivých strán.

Oficiálne znenie GDPR poskytuje právnu referenciu vrátane článkov 5, 28 a 32 a kapitoly V. Ubezpečenia dodávateľa považujte za východisko preskúmania, nie za náhradu kontroly navrhovaného spracovateľského usporiadania.

  • Identifikujte, ktoré polia integrácia vyžaduje, a neposielajte mená, adresy ani kontaktné údaje, pokiaľ nie sú nevyhnutné na zamýšľanú funkciu.
  • Vyžiadajte si príslušnú dohodu o spracúvaní údajov a objasnite úlohy prevádzkovateľa a sprostredkovateľa.
  • Overte miesta hostingu, subdodávateľov a všetky relevantné dojednania o medzinárodných prenosoch.
  • Potvrďte postupy uchovávania, vymazania, riadenia prístupu a oznamovania incidentov.
  • Uchovávajte poverenia API a nepotrebné osobné údaje mimo aplikačných protokolov.

Nepredpokladajte, že požiadavka na doručenie vo Francúzsku automaticky znamená, že každá činnosť spracúvania údajov musí prebiehať vo Francúzsku. Rovnako nepredpokladajte, že tvrdenie o hostingu v EÚ vyrieši všetky otázky súladu. Pred schválením zapojte tím ochrany súkromia alebo právny tím.

Porovnajte fakturovanú jednotku so životným cyklom vašich zásielok

Vyžiadajte si cenovú ponuku založenú na skutočnom modeli vašej prevádzky. Poplatok označený ako „za sledovanie“ nie je dostatočne presný, kým poskytovateľ nevysvetlí, čo sa počíta ako fakturovaná jednotka.

Opýtajte sa, ako zmluva rieši registrácie, opakované vyhľadávania, duplicitné odoslania, neúspešné registrácie, vratky a zásielky, ktoré zostávajú aktívne dlhý čas. Potvrďte, či cenu ovplyvňujú upozornenia, historický prístup, podpora alebo ďalšie prostredia. Ide o otázky obstarávania, nie o predpoklady týkajúce sa modelu účtovania konkrétneho poskytovateľa.

Modelujte bežný dopyt aj očakávanú špičku. Zahrňte údržbu a podporu zo strany vývojárov spolu s poplatkami za predplatné alebo využitie. Nižšia uvádzaná cena nemusí znamenať nižšie prevádzkové náklady, ak musí váš tím manuálne riešiť časté nezhody.

Dohodnuté limity a definície účtovania si vyžiadajte písomne. Ak verejná dokumentácia neobjasňuje určitú požiadavku, zaznamenajte ju ako požiadavku na potvrdenie, nie ako nepodporovanú funkciu.

Vykonajte pilotnú prevádzku, ktorá umožní jasné rozhodnutie

Použite reprezentatívnu množinu skutočných zásielok v súlade s vašimi kontrolami ochrany údajov. Zahrňte bežné úspešné prípady aj náročné cesty: oneskorené skenovania, doručenie na odberné miesto, neúspešné pokusy, medzinárodné odovzdania, vratky a nedávno vytvorené štítky bez fyzického skenovania pri prevzatí.

  1. Vytvorte referenčný záznam. Uložte relevantnú históriu sledovania prepravcu a časy pozorovania. Stránka prepravcu je užitočnou referenciou, hoci čas zverejnenia na nej sa môže líšiť od iných kanálov.
  2. Pripojte zamýšľaný pracovný postup. Testujte registráciu, prijímanie udalostí, ukladanie, mapovanie stavov a upozornenia — nielen vzorové odpovede v konzole.
  3. Merajte definované výsledky. Sledujte použiteľné výsledky sledovania, presnosť mapovania stavov, pozorované oneskorenie aktualizácií a manuálne zásahy. Pri každej metrike definujte menovateľa.
  4. Simulujte zlyhania. Dočasne prerušte prijímač, zopakujte udalosť, odošlite neplatné číslo a otestujte riadený nárast prevádzky v rámci dohodnutých limitov.
  5. Preskúmajte nezrovnalosti. Rozlišujte medzi medzerami v zverejňovaní údajov prepravcom, problémami so získavaním údajov poskytovateľom a vlastnými chybami spracovania.
  6. Schváľte riešenie podľa písomných kritérií. Zabezpečte, aby technický tím, prevádzka a zodpovední pracovníci za ochranu súkromia schválili príslušné požiadavky.

Číselné prahové hodnoty stanovte pred pilotnou prevádzkou podľa potrieb vašej služby. Pre každého obchodníka neexistuje univerzálne prijateľné oneskorenie ani miera úspešnosti. Panel podpory a časovo citlivé upozornenie na vyzdvihnutie môžu vyžadovať odlišné štandardy.

Vyberte API, ktoré zvládne vaše najobjemnejšie a najrizikovejšie pracovné postupy pri prijateľných nákladoch a nárokoch na údržbu. Ak žiadna možnosť neprejde, obmedzte spustenie na overené služby alebo ponechajte samostatnú integráciu pre problémového prepravcu. Kontrolované čiastočné spustenie je lepšie než prezentovať nespoľahlivé informácie o doručení ako úplné pokrytie.

Často kladené otázky

Dokáže jedno API na sledovanie zásielok spracovať každé doručenie do Francúzska?

Nepredpokladajte to. Potvrďte presných prepravcov, služby, destinácie a vzory odovzdania, ktoré používate. Aj keď je prepravca uvedený v zozname, otestujte podrobnosti udalostí potrebné pre vaše pracovné postupy zákazníkov a podpory.

Nakupuje API na sledovanie zásielok štítky alebo zabezpečuje doručenie?

Nie nevyhnutne. Sledovanie, vytváranie štítkov, objednanie prepravy, overovanie adries a predpovedanie dátumu doručenia sú odlišné funkcie. Zahrňte ich do požiadaviek iba vtedy, ak sú potrebné, a každú overte samostatne.

Mali by sme namiesto pollingového zisťovania používať webhooky?

Webhooky môžu byť užitočné na prijímanie aktualizácií bez opakovaného vyžiadania každej zásielky. Vaša implementácia však stále potrebuje overovanie, spracovanie duplikátov, opakovanie a mechanizmus obnovy. Overte, či môže koncový bod na vyhľadávanie alebo iný mechanizmus doplniť chýbajúce údaje po prerušení.

Môžeme na základe udalostí sledovania sľúbiť dátum doručenia?

Iba ak máte vhodný zdroj tohto dátumu a rozumiete jeho významu. Odhadovaný dátum doručenia nie je automaticky garantovaným záväzkom. Rozlišujte odhady prepravcu, predpovede vytvorené poskytovateľom a dátumy vypočítané vašou vlastnou aplikáciou.

Čo máme robiť, keď sa API a webová stránka prepravcu nezhodujú?

Porovnajte text udalosti, čas udalosti, čas získania, identitu prepravcu a sledovacie číslo. Zachovajte oba záznamy a preskúmajte, či rozdiel odráža čas zverejnenia, mapovanie stavu, odovzdanie alebo nesprávnu zhodu. Z jednej nezrovnalosti nevyvodzujte záver o celom poskytovateľovi.

Zdroje