Skip to main content
HjemBloggVeiledningerSlik velger du et API for sporing av forsendelser for leveranser i Frankrike

Slik velger du et API for sporing av forsendelser for leveranser i Frankrike

17TRACK

Velg et API for sporing av forsendelser til leveranser i Frankrike ved å teste de faktiske transportørene, franske leveringsflyter og grensekryssende overleveringer – ikke ved å sammenligne overskrifter om antall transportører. Det riktige API-et bør returnere brukbare sporingshendelser, skille mellom tilgjengelighet ved utleveringssted og fullført levering, og passe til dine tekniske krav og krav til databeskyttelse. Før du forplikter deg, bør du gjennomføre en pilot med representative forsendelser og bli enige om målbare akseptansekriterier.

Slik velger du et API for sporing av forsendelser til leveranser i

Denne veiledningen er beregnet på team for netthandelsdrift, utviklere og innkjøpsansvarlige som kobler forsendelsesinnsikt til en nettbutikk, et ordrebehandlingssystem, en kundeserviceplattform eller et internt dashbord. Målet er å velge en pålitelig kilde til leveringsinformasjon, ikke bare et endepunkt som godtar sporingsnumre.

Ta utgangspunkt i leveransene virksomheten faktisk gjennomfører

«Dekning i Frankrike» er for bredt til å fungere som et innkjøpskrav. En virksomhet som sender innenlandske pakker til hjemmeadresser, har andre behov enn en forhandler som importerer varer til Frankrike og leverer dem til utleveringssteder. Definer forsendelsesprofilen før du ber om demonstrasjoner eller tilbud.

  • Leveringsgeografi: Identifiser det franske fastlandet, Korsika og eventuelle franske oversjøiske destinasjoner separat. Be leverandørene bekrefte de relevante tjenestene i stedet for å anta at én geografisk betegnelse dekker alle ruter.
  • Leveringsmetode: Skill mellom hjemmelevering, bemannede utleveringssteder, pakkeskap og andre tjenester du faktisk tilbyr.
  • Transportør og tjeneste: Registrer den opererende transportøren og tjenestenavnet, ikke bare fraktplattformen du kjøpte etiketten gjennom.
  • Forsendelsesretning: Skill mellom innenlandsleveranser, innkommende internasjonale forsendelser, utgående bestillinger og returer.
  • Operativ bruk: Bestem om sporing skal brukes til kundemeldinger, håndtering av avvik, supportundersøkelser eller alle tre.

Lag en transportørmatrise basert på nylige bestillinger. Avhengig av virksomheten kan den omfatte tjenester knyttet til Colissimo, Chronopost eller Mondial Relay. Dette er eksempler som bør kontrolleres mot dine egne fraktregistre, ikke en påstand om at et bestemt API støtter alle tjenestene de tilbyr.

Ta med forventet volum per transportør og tjeneste. En leverandør som håndterer den travleste leveringsflyten din pålitelig, kan passe bedre enn en leverandør med en større global katalog, men uprøvd støtte for hovedrutene dine.

Velg mellom direkte transportørintegrasjoner og et flertransportør-API

En direkte integrasjon med en transportør er verdt å vurdere når én transportør står for de fleste forsendelsene, og teamet ditt trenger tilgang til transportørspesifikk informasjon. Du må fortsatt kontrollere kontokvalifisering, dokumentasjon, tilgjengelige hendelser og integrasjonsvilkår med transportøren.

Et API for sporing på tvers av flere transportører er verdt å vurdere når virksomheten bruker flere transportører eller regelmessig håndterer internasjonale overleveringer. Den mulige verdien er å redusere antallet integrasjoner teamet vedlikeholder og presentere ulike sporingsformater gjennom et felles grensesnitt. Om det faktisk gir denne verdien, avhenger av transportørene og arbeidsflytene du tester.

Ingen av tilnærmingene garanterer automatisk raskere oppdateringer eller mer detaljerte hendelser. Sammenlign de faktiske resultatene og vedlikeholdskravene i stedet for å anta at direkte tilgang alltid er rikere, eller at aggregering alltid er enklere.

For en kortliste over flertransportør-løsninger er 17TRACK’s Tracking API et relevant alternativ å undersøke. Bruk den offisielle API-dokumentasjonen og en teknisk gjennomgang for å kontrollere de nødvendige transportørtjenestene, integrasjonsflyten, hendelsesleveringen og de kommersielle vilkårene. Egnetheten for leveranser i Frankrike bør fastslås med ditt eget utvalg av forsendelser, ikke utledes fra tilgjengeligheten av forbrukertjenesten for sporing.

Test tjenestedekning, ikke bare gjenkjenning av transportører

Et vellykket oppslag av et sporingsnummer er bare den første testen. Applikasjonen din trenger nok informasjon til å forklare hva som skjedde og støtte neste handling.

EvalueringsområdeHva som skal bekreftesHvorfor det er viktig
Identifisering av transportørGjenkjenning av de faktiske numrene dine og en måte å korrigere tvetydige treff påEt sannsynlig, men feilaktig treff kan gi misvisende resultater.
TjenestedekningHendelser for de nøyaktige innenlandske og internasjonale tjenestene du kjøperEt transportørnavn alene dokumenterer ikke dekning på tjenestenivå.
Hendelser ved utleveringsstedSeparat håndtering av ankomst, tilgjengelighet for henting og kundens hentingEn pakke som venter på å bli hentet, skal ikke utløse en melding om fullført levering.
Internasjonale overleveringerKontinuitet mellom opprinnelsestransportøren og leveringsnettverket på destinasjonenKundene trenger innsyn etter at pakken skifter nettverk.
HendelsesdetaljerOpprinnelige beskrivelser, standardiserte statuser, steder og tidsstempler når tilgjengeligSupportteam trenger kontekst utover en generell statusetikett.

Ikke betrakt et manglende felt som bevis på en feil i API-et uten først å kontrollere de underliggende transportørdataene. Enkelte opplysninger publiseres kanskje ikke av transportøren, kan avhenge av tjenesten eller være tilgjengelige bare gjennom bestemte tilgangsavtaler. Be leverandøren forklare grensene.

Kontroller om franske leveringshendelser fører til riktig handling

Utleveringssteder og pakkeskap

For leveranser som hentes på et utleveringssted, er tilgjengelighet og fullføring ulike forretningshendelser. Test om API-et opprettholder dette skillet, og om applikasjonen din mapper det riktig. Hvis dataene inneholder henteinstruksjoner eller en frist, må du kontrollere kilden og betydningen før du viser dem. Ikke beregn en universell hentefrist basert på en antatt transportørpolicy.

En nyttig akseptansetest er enkel: Når en pakke blir tilgjengelig for henting, skal systemet sende henteveiledning i stedet for en melding om at den er «levert til deg». Når mottakeren henter den, skal ordrelinjen gjenspeile den endelige hendelsen uten å sende den tidligere meldingen på nytt.

Leveringsforsøk og avvik

En bred avvikskategori kan skjule svært ulike situasjoner, blant annet et mislykket leveringsforsøk, et adresseproblem eller en tollrelatert forsinkelse. Gjør den opprinnelige hendelsesbeskrivelsen tilgjengelig for supportmedarbeidere, selv om kundene ser en forenklet etikett.

Bestem hvilke hendelser som krever tiltak. Et adresseproblem kan kreve en supportsak, mens en vanlig behandlingsskanning som regel ikke gjør det. Disse reglene hører hjemme i den operative utformingen din, og bør ikke godtas automatisk fra leverandørens statustaksonomi.

Språk og tid

Spør om hendelsesbeskrivelsene er den opprinnelige teksten fra transportøren, oversatt tekst eller standardiserte etiketter. Nettbutikken din kan bruke konsekvent norsk ordlyd, men bør ikke tilføre større sikkerhet enn kildehendelsen inneholder.

Bevar tidsstempelenes tidssoneforskyvninger, og skill mellom tidspunktet en hendelse fant sted og tidspunktet systemet ditt mottok den. For det franske fastlandet bør du bruke en tidssonebevisst implementering som Europe/Paris når du viser lokale klokkeslett, i stedet for en fast UTC-forskyvning. Håndter andre destinasjoners tidssoner separat når det er relevant.

Vurder levering av oppdateringer og gjenopprettingsatferd

Webhooks kan redusere behovet for gjentatte statusforespørsler, men mottak av en webhook betyr ikke at en hendelse ble fanget opp umiddelbart etter en fysisk skanning. Det kan være separate intervaller mellom skanningen, transportørens publisering, sporingsleverandørens henting og applikasjonens behandling.

Be leverandørene forklare disse trinnene og eventuelle dokumenterte tjenesteforpliktelser. Unngå å sammenligne påstander om «sporing i sanntid» uten en felles definisjon.

  • Autentisering: Hvordan autentiseres innkommende varsler, og hvordan roteres legitimasjonen?
  • Nye forsøk: Hva skjer når endepunktet ditt får tidsavbrudd eller returnerer en feil?
  • Duplikater: Kan den samme hendelsen komme mer enn én gang, og hvordan skal den identifiseres?
  • Rekkefølge: Kan tidligere hendelser komme etter senere hendelser?
  • Gjenoppretting: Kan du hente forsendelseshistorikk eller gjenopprette oppdateringer etter et driftsavbrudd?
  • Grenser: Hvilke grenser gjelder for forespørsler, registrering, samtidighet eller nyttelast?

Utform integrasjonen slik at den tåler nye forsøk og sene hendelser. Lagre hendelser permanent, hindre dupliserte kundemeldinger og unngå å erstatte en status for fullført levering med en eldre status for underveis bare fordi den kom senere.

Test også feil ved registrering av forsendelser. Et ugyldig nummer, en tjeneste som ikke støttes eller et tvetydig transportørtreff bør havne i en synlig avvikskø i stedet for å forsvinne fra sporingsdekningen.

Vurder databeskyttelse før du sender reell kundeinformasjon

Sporingsdata kan være personopplysninger når de gjelder en identifiserbar person. I henhold til GDPR kan relevante forpliktelser omfatte dataminimering, lagringsbegrensning, passende sikkerhet, databehandleravtaler og sikkerhetstiltak for internasjonale overføringer. Det nøyaktige ansvaret avhenger av hvordan tjenesten er konfigurert og av partenes roller.

Den offisielle GDPR-teksten er den juridiske referansen, inkludert artikkel 5, 28 og 32 samt kapittel V. Betrakt leverandørens forsikringer som et utgangspunkt for vurderingen, ikke som en erstatning for å kontrollere den foreslåtte behandlingsordningen.

  • Identifiser hvilke felt integrasjonen krever, og unngå å sende navn, adresser eller kontaktopplysninger med mindre det er nødvendig for den tiltenkte funksjonen.
  • Be om den gjeldende databehandleravtalen, og avklar rollene som behandlingsansvarlig og databehandler.
  • Kontroller vertsplasseringer, underleverandører og eventuelle relevante ordninger for internasjonale overføringer.
  • Bekreft prosedyrer for lagringstid, sletting, tilgangskontroll og varsling av hendelser.
  • Hold API-legitimasjon og unødvendige personopplysninger ute av applikasjonsloggene.

Ikke anta at et krav om levering i Frankrike automatisk betyr at all databehandling må skje i Frankrike. Ikke anta heller at en påstand om EU-hosting løser alle spørsmål om etterlevelse. Involver personvern- eller juridisk team før godkjenning.

Sammenlign den fakturerbare enheten med forsendelseslivssyklusen

Be om et tilbud basert på det faktiske trafikkmønsteret ditt. En avgift som beskrives som «per sporing», er ikke presis nok før leverandøren forklarer hva som regnes som en fakturerbar enhet.

Spør hvordan avtalen behandler registreringer, gjentatte oppslag, dupliserte innsendinger, mislykkede registreringer, returer og forsendelser som forblir aktive lenge. Bekreft om varsler, historisk tilgang, support eller ekstra miljøer påvirker prisen. Dette er innkjøpsspørsmål, ikke antakelser om en bestemt leverandørs prismodell.

Modeller både vanlig etterspørsel og forventede topper. Ta med teknisk vedlikehold og supportarbeid i tillegg til abonnements- eller bruksavgifter. En lavere oppgitt pris gir kanskje ikke lavere driftskostnad hvis teamet ditt må løse hyppige avvik manuelt.

Få de avtalte grensene og definisjonene av fakturering skriftlig. Når offentlig dokumentasjon ikke avklarer et krav, skal det registreres som noe som må bekreftes, i stedet for å behandles som en funksjon som ikke støttes.

Gjennomfør en pilot som kan gi en tydelig beslutning

Bruk et representativt utvalg av reelle forsendelser, underlagt kontrollene dine for databeskyttelse. Ta med både vanlige vellykkede leveranser og krevende forløp: forsinkede skanninger, levering til utleveringssted, mislykkede forsøk, internasjonale overleveringer, returer og nylig opprettede etiketter uten fysisk mottaksskanning.

  1. Lag en referansepost. Lagre relevant sporingshistorikk fra transportøren og observasjonstidspunkter. En transportørside er en nyttig referanse, selv om publiseringstidspunktet kan avvike fra andre kanaler.
  2. Koble til den tiltenkte arbeidsflyten. Test registrering, inntak av hendelser, lagring, statusmapping og varsler – ikke bare eksempelsvar i en konsoll.
  3. Mål definerte resultater. Følg med på brukbare sporingsresultater, nøyaktighet i statusmapping, observert oppdateringsforsinkelse og manuelle inngrep. Definer nevneren for hvert mål.
  4. Simuler feil. Avbryt mottakeren midlertidig, spill av en hendelse på nytt, send inn et ugyldig nummer og test en kontrollert trafikkøkning innenfor avtalte grenser.
  5. Vurder avvik. Skill mellom manglende publisering fra transportøren, problemer med leverandørens innhenting og egne behandlingsfeil.
  6. Godkjenn mot skriftlige kriterier. La ansvarlige for utvikling, drift og personvern godkjenne sine respektive krav.

Fastsett numeriske terskler før piloten i henhold til tjenestebehovene dine. Det finnes ingen universell akseptabel forsinkelse eller suksessrate for alle forhandlere. Et supportdashbord og en tidskritisk påminnelse om henting kan kreve ulike standarder.

Velg API-et som håndterer arbeidsflytene med høyest volum og høyest risiko, til akseptable kostnader og med akseptabelt vedlikeholdsbehov. Hvis ingen alternativer består, bør du begrense utrullingen til verifiserte tjenester eller beholde en separat integrasjon for en problematisk transportør. En kontrollert delvis lansering er bedre enn å presentere upålitelig leveringsinformasjon som full dekning.

Vanlige spørsmål

Kan ett sporings-API håndtere alle leveranser til Frankrike?

Ikke anta det. Bekreft de nøyaktige transportørene, tjenestene, destinasjonene og overleveringsmønstrene du bruker. Selv når en transportør er oppført, må du teste hendelsesdetaljene som kreves for kunde- og supportflytene dine.

Kjøper et sporings-API etiketter eller organiserer levering?

Ikke nødvendigvis. Sporing, oppretting av etiketter, bestilling av forsendelser, adressevalidering og prediksjon av leveringsdato er separate funksjoner. Ta dem bare med i kravene hvis de trengs, og verifiser hver funksjon separat.

Bør vi bruke webhooks i stedet for polling?

Webhooks kan være nyttige for å motta oppdateringer uten å be om hver forsendelse gjentatte ganger. Implementasjonen trenger fortsatt autentisering, håndtering av duplikater, nye forsøk og en gjenopprettingsmekanisme. Bekreft om et oppslagsendepunkt eller en annen mekanisme kan fylle hull etter et avbrudd.

Kan vi love en leveringsdato basert på sporingshendelser?

Bare hvis du har en egnet kilde for datoen og forstår betydningen av den. En beregnet leveringsdato er ikke automatisk en garantert forpliktelse. Skill mellom transportørens estimater, leverandørgenererte prognoser og datoer som beregnes av din egen applikasjon.

Hva bør vi gjøre når API-et og transportørens nettsted er uenige?

Sammenlign hendelsesteksten, hendelsestidspunktet, innhentingstidspunktet, transportørens identitet og sporingsnummeret. Bevar begge postene og undersøk om forskjellen skyldes publiseringstidspunkt, statusmapping, en overlevering eller et feilaktig treff. Unngå å trekke en konklusjon om hele leverandøren basert på ett avvik.

Kilder