Advanced Integrated Visibility-webhook instellen
Overzicht
De Advanced Integrated Visibility-webhook maakt het voor FedEx mogelijk om nagenoeg in realtime beveiligde trackinggegevens te verzenden naar een opgegeven bestemmings-URL voor zendingen die zijn gekoppeld aan een of meer FedEx-accountnummers. U kunt een webhookproject aanmaken om toegang te krijgen tot deze functionaliteit via het FedEx Developer Portal.
Navigatiepaden
U kunt de pagina voor het aanmaken van een webhook op een van de volgende manieren openen:
- Via Mijn projecten: Linkernavigatiepaneel → tabblad Webhooks → +EEN WEBHOOKPROJECT AANMAKEN
Via de API-catalogus:
- Linkernavigatiepaneel → API-catalogus
- Zoeken naar of filteren op Advanced Integrated Visibility
- Overzicht → Klik op Documentatie → Klik in Sandbox Console op +EEN PROJECT AANMAKEN
- Docs → Klik op +Een webhook aanmaken
Stappen voor het aanmaken van een webhook
Stap 1: selecteer het bedrijfstype
Klik op +EEN PROJECT AANMAKEN en kies uw bedrijfstype uit de keuzelijst:
- Verzendt met FedEx en moet FedEx-webhook integreren in het bedrijfssysteem.
- Verkoopt of levert een softwareoplossing die FedEx-gegevens gebruikt en geen gecertificeerde FedEx Compatible Provider is.
- Is een gecertificeerde FedEx Compatible Provider.
Opmerking: de Advanced Integrated Visibility-webhookoplossing van FedEx is niet beschikbaar voor deze optie. Als u lid bent van het FedEx Compatible-programma en toegang wilt tot Basic Integrated Visibility of andere integratieoplossingen van FedEx, neemt u contact op met uw kanaalmanager. Als u niet weet wie uw kanaalmanager is, neemt u contact op met uw bedrijfsbeheerder.
Selecteer vervolgens Op accountnummer gebaseerd abonnement voor Advanced Integrated Visibility als uw abonnementstype.
Een op accountnummer gebaseerd abonnement voor Advanced Integrated Visibility aanmaken
Dit proces omvat vier belangrijke stappen:
- Project configureren
- Projectgegevens invoeren
- Verzendaccounts kiezen
- Gegevens bevestigen en voorwaarden accepteren
Stap 1: Project configureren
Op de pagina Webhook configureren:
- Facturatie-accountnummer:
- Bekijk het standaard facturatie-account.
- Het standaard facturatie-account wijzigen:
- Klik op FACTURATIE-ACCOUNT TOEVOEGEN AAN UW ORGANISATIE (als er maar één account bestaat), of
- Klik op EEN ANDER FACTURATIE-ACCOUNT SELECTEREN (indien er meerdere accounts bestaan).
Let op: een facturatie-account gevestigd in de VS is vereist. Voor prijsdetails gaat u naar het prijsoverzicht voor Advanced Integrated Visibility.
Functieselectie:
- Kies de functies die u wilt inschakelen en klik vervolgens op Volgende.
Functiebeschrijvingen
| Veldnaam | Omschrijving |
|---|---|
| Bewijs van aflevering | Bevestigt dat een zending succesvol is afgeleverd. Bewijs van aflevering met foto (PPODA): biedt een foto waarop de exacte afleverlocatie te zien is. Bewijs met handtekening (SPOD): geeft een afbeelding weer van de handtekening, naam, bezorgdatum, tijd en locatie van de ontvanger. |
| Verwachte levering | Helpt ontvangers bij het plannen door het volgende aan te bieden: verwachte leverdatum (EDD) tijdvak verwachte aflevering (EDTW) |
| Trackinggebeurtenissen | Hiermee kunt u één of meer gebeurteniscategorieën selecteren om meldingen te ontvangen: Verzenden Onderweg Levering Afleveruitzonderingen Aangepaste afleveropties |
| Filteren op basis van gebeurtenissen | Filtert webhookreacties om het volgende op te nemen: Inkomende zendingen Uitgaande zendingen Zendingen van derden |
Geef de volgende informatie op de pagina Gegevens invoeren op:
| Veldnaam | Omschrijving |
|---|---|
| Naam webhookproject | Een unieke, niet-lege naam voor uw webhookproject. Een voorgestelde naam wordt automatisch ingevuld, maar kan worden aangepast. Deze naam mag in geen enkele andere webhook worden herhaald. |
| Bestemmings-URL | Het beveiligde HTTPS-eindpunt waarnaar FedEx trackinggegevens zal verzenden. Vereisten: moet geldig zijn en werken Moet gestandaardiseerde syntaxis volgen Mag fedex.com of de subdomeinen ervan niet omvatten Kan hergebruikt worden op meerdere webhooks Raadpleeg de sectie Bedrijfsregels en Best practices voor meer details. |
| Beveiligingstoken | Een gedeeld geheim dat wordt gebruikt om webhook-reacties te authenticeren en valideren via HMAC. Vereisten: 26–100 tekens Moet minstens 1 hoofdletter, 1 kleine letter en 1 numeriek teken bevatten. Kan hergebruikt worden op meerdere webhooks |
| Taal van het laadvermogen (land) | Selecteer de voorkeurstaal voor de vertaling van de traceergegevens in de keuzelijst. |
| Trackingtype | Kies hoe de traceergegevens moeten worden geleverd: Gedetailleerd traceren – Volledige gebeurtenisgeschiedenis Gebeurtenisspecifiek traceren – Alleen de meest recente gebeurtenis |
| E-mailadres | Geef een geldig e-mailadres op om meldingen te ontvangen. |
| Taal van e-mailadres (land) | Selecteer de voorkeurstaal voor e-mailmeldingen. Let op: alleen Amerikaanse taalvarianten worden ondersteund (bijv. en-US, es-US). |
Stap 3: verzendaccounts kiezen
Op de pagina Verzendaccounts kiezen:
- Selecteer één of meer FedEx-accountnummers om aan uw webhook-project te koppelen.
Belangrijke opmerkingen:
- Alleen accounts die niet al aan andere webhooks zijn gekoppeld, worden getoond.
- U moet ten minste één account koppelen om verder te gaan.
- Er kunnen maximaal 100 accounts worden toegevoegd via de webhook-gebruikersinterface.
- Om meer dan 100 accounts te koppelen, gebruikt u de webhook-API.
Neem contact op met de FedEx Klantenservice of helpdesk om API-toegang aan te vragen.
Stap 4: gegevens bevestigen en aanmaken
Op de pagina Gegevens bevestigen:
1. Controleer alle informatie die u voor het webhookproject hebt ingevoerd.
2. Vink het vakje aan om akkoord te gaan met de algemene voorwaarden.
3. Klik op Aanmaken om het instellen van de webhook te voltooien.
Bij een succesvolle indiening wordt de webhook aangemaakt met een door het systeem gegenereerde abonnements-ID en ingesteld op de status Actief.
Validatieregels
Algemene vereisten:
- De naam van de webhook moet uniek zijn.
- De bestemmings-URL moet een gestandaardiseerd syntactische indeling volgen (veilig HTTPS, niet fedex.com of de subdomeinen daarvan).
- Alle verplichte velden moeten worden ingevuld - geen enkel verplicht veld mag leeg blijven.
- Er moet ten minste één geldig FedEx-verzendaccountnummer aan de webhook zijn gekoppeld.
Geslaagde validatie:
Als de webhook met succes is aangemaakt, ontvangt de klant een bevestigingsbericht:
<<Webhook name>> is aangemaakt. Het kan maximaal 10 minuten duren voordat wijzigingen zijn verwerkt.
Niet-geslaagde/mislukte validatie:
Als FedEx een andere reactie ontvangt dan HTTP 200 (OK) of 202 (Geaccepteerd) van de bestemmings-URL, wordt de validatie van de webhook als mislukt beschouwd.
