Fedex Logo

Introduktion

Advanced Integrated Visibility-abonnementet efter trackingnummer er designet til abonnenter af Advanced Integrated Visibility, så de kan administrere deres webhook-projekter baseret på trackingnummer og udføre projektrelaterede handlinger såsom at tilføje nye trackingnumre samt redigere eller se joboplysninger via API-slutpunkter.

Bemærk:

  • Du skal have administrator- eller bidragsyderadgang til dit Advanced Integrated Visibility-projekt
  • For flere oplysninger om Advanced Integrated Visibility og dets funktioner kan du se siden Advanced Integrated Visibility-dokumentation.

Fordele ved Avancerede Integrated Visibility Tracking Number-abonnement

Fordelene ved Avancerede Integrated Visibility Tracking Number-abonnement er:

  • Du kan nemt opdatere og administrere trackingnumre i dit Advanced Integrated Visibility-projekt ved brug af API-slutpunkter.
  • Denne API lader dig tilknytte flere trackingnumre til dit projekt i én enkelt API-transaktion, i stedet for at tilknytte et trackingnummer ad gangen.
  • Du kan sende på hinanden følgende API-anmodninger og se vellykkede og mislykkede logdetaljer på disse anmodninger.

Sådan fungerer Avancerede Integrated Visibility Tracking Number-abonnement

Brug nedenstående slutpunkter til at administrere dit Advanced Integrated Visibility-projekt:

Webhook image alt

Denne API kan udelukkende tilgås via din projektoversigt, som vist på skærmbilledet ovenfor.

Trackingnummertilknytning

Brug dette slutpunkt til at igangsætte et asynkront job for at tilknytte ét eller flere trackingnumre til et specifikt Advanced Integrated Visibility-projekt.

De påkrævede indtastningsoplysninger for denne anmodning er:

  • Handling – Præciser handlingen, der skal udføres, når du sender anmodningen. Eksempel: TILFØJ
  • Trackingnummeroplysninger – Præciser trackingnummeret

Du kan tilknytte maks. 1000 trackingnumre i en enkelt anmodning. Det vellykkede svar på denne anmodning vil returnere jobID, aktuel jobstatus og tidsstempel for joboprettelse og jobfærdiggørelse. Dette jobID kan anvendes senere til at tjekke status på det asynkrone job.

Trackingnummerjobstatus

Brug dette slutpunkt til at få status på et asynkront job (en eller flere på hinanden følgende anmodninger i kø) eller statur på alle sendte jobs.

De påkrævede indtastningsoplysninger for denne anmodning er:

  • Job-id – Præciser det job-id, for hvilket du vil hente status.

Bemærk: Job-id er et valgfrit input for dette slutpunkt. Hvis du ikke præciserer et job-id, får du status på alle sendte jobs.

Det vellykkede svar på denne anmodning vil returnere jobID, aktuel jobstatus og tidsstempel for joboprettelse og jobfærdiggørelse. Svaret vil vise aktuel status på valgte jobs. Derudover vil svaret også indeholde vellykkede svar, fejl eller advarsler, så brugere kan se og foretage fejlsøgning, når relevant.

  • Hvis jobstatus vises som GENNEMFØRT, betyder det, at alle trackingnumre er valideret og behandlet korrekt.
    • Statussen GENNEMFØRT indebærer, at trackingnumrene er valideret og behandlet korrekt. Det indebærer ikke, at alle trackingnumrene er blevet tilføjet Advanced Integrated Visibility-projektet.
    • Hvis du forsøger at tilknytte flere trackingnumre, og kun nogle af dem tilknyttes, mens andre ikke gøre det, vil jobstatus stadig opdateres som GENNEMFØRT. For at bekræfte status på hvert trackingnummer i anmodningen om tilknytning skal batch-rapporten downloades.
  • Bemærk:

  • Hvis jobstatus vises som MISLYKKEDES, indebærer det, at anmodningen på grund af flere årsager/alvorlige fejl ikke kunne behandles, og brugeren skal prøve igen.

Følgende viser statusserne og deres tilhørende beskrivelser:

JOBSTATUS BESKRIVELSE

SENDT

    Jobbet er sendt til systemet efter alle grundlæggende valideringer. Det vil blive behandlet asynkront.

ACCEPTERET

    Jobbet er accepteret og vil blive sat i kø.

IKKE ACCEPTERET

    Jobbet er ikke accepteret på grund af interne fejl eller utilgængeligt system. Bruger skal forsøge igen.

SAT I KØ

    Jobbet er sat i kø til behandling, som påbegyndes snarest.

IGANGVÆRENDE

    Jobbet er startet og har status som igangværende.

GENNEMFØRT

    Jobbet er gennemført, og en importrapport eller eksportfil kan downloades af brugeren.

MISLYKKEDES

    Jobbet er ikke lykkedes på grund af flere årsager. Bruger skal forsøge igen.

Trackingnummerjoboplysninger

Brug dette slutpunkt for at downloade en JSON-rapport for et asynkront job med statussen GENNEMFØRT.

De påkrævede indtastningsoplysninger knyttet til denne anmodning er:

  • Job-id – Præciser det job-id, for hvilket du vil hente status.

Bemærk:

  • Job-id er et obligatorisk input for dette slutpunkt.
  • Du kan kun downloade rapporten for ét asynkront job ad gangen.
  • Hvis jobbet ikke er GENNEMFØRT, og du forsøger at downloade rapporten, vil en fejlmeddelelse blive vist.

 

Det vellykkede svar på denne anmodning giver dig jobrapporten i JSON-format.

Forretningsregler

  • Der kan tilknyttes maks. 1.000 forsendelsestrackingnumre med et Advanced Integrated Visibility-projekt i hver anmodning.
  • Der er ingen maksimal grænse for, hvor mange trackingnumre der kan tilknyttes et givent Advanced Integrated Visibility-projekt.
  • Tilknyttede trackingnumre vil blive fjernet 40 dage efter tilknytning til et specifikt Advanced Integrated Visibility-projekt.
  • Oplysninger og status for et oprettet job-id vil ikke være tilgængelige efter 90 dage for et givent Advanced Integrated Visibility-projekt.
  • Sikrede trackingoplysninger såsom modtageradresse og modtagerunderskrift vil ikke være tilgængelige via Advanced Integrated Visibility Tracking Number-abonnement.
CLOSE

Response

Copy