Overzicht
De Advanced Integrated Visibility-webhook maakt het voor FedEx mogelijk om nagenoeg in realtime beveiligde traceergegevens 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
Het proces omvat vier belangrijke stappen:
Stap 1: Inschakelen van het op accountnummer gebaseerde abonnement voor Advanced Integrated Visibility
Deze stap wordt beheerd door een FedEx-beheerder of FedEx-medewerker op verzoek van externe klanten.
- MNDA-document: de FedEx-beheerder of FedEx-medewerker verzamelt de Mutual Non-Disclosure Agreement (MNDA) samen met een bulklijst van accountnummers van de eerste partij/afzender.
Opmerking: identieke accountnummers die aan andere organisaties gekoppeld zijn, zijn toegestaan tijdens deze upload.
- Indien van toepassing wordt Aangepaste prijzen op organisatieniveau ingeschakeld.
Opmerking: deze functionaliteit is niet inbegrepen in de July Experience.
Stap 2: + Project aanmaken
Op de pagina Product(en) selecteren:
- Klik op Advanced Integrated Visibility - Accountnummer en klik vervolgens op Volgende.
- Selecteer de facturatie-accounts, accepteer de betalingsvoorwaarden en klik op Volgende.
Minimaal één facturatie-account moet worden toegevoegd.
Op de pagina Gegevens bevestigen:
- Bekijk de projectinformatie.
- Accepteer de Algemene Voorwaarden.
- Als Aangepaste prijzen van toepassing zijn, verschijnt het gerelateerde document automatisch.
Na een succesvolle aanmaak verschijnt een bevestigingsbericht:
"U hebt het product toegevoegd aan 'Mijn project'."
Stap 3: Projectoverzicht – API-sleutelactiveringsproces
- Op de pagina Projectoverzicht, onder het tabblad API-sleutels in de sectie API's, wordt de productiestatus voor het abonnement aanvankelijk weergegeven als 'Uitgeschakeld'.
- Een FedEx-beheerder of -medewerker zal het product op verzoek inschakelen.
- Eenmaal ingeschakeld wordt het tabblad Productiesleutel toegankelijk en wordt de productiestatus bijgewerkt naar 'Wachtend op bevestiging'.
- Na de definitieve activatie door de FedEx-beheerder of -medewerker wordt de productiestatus weergegeven als 'Ingeschakeld.'
Stap 4: Projectoverzicht – webhook configureren
- Ga naar de pagina Projectoverzicht.
- Selecteer het tabblad Webhooks.
- Klik op de knop + Webhook configureren om de configuratie van de webhook te starten. U wordt doorgestuurd naar het tabblad Webhooks.
Functiebeschrijvingen
| Veldnaam | Omschrijving |
|---|---|
| Bewijs van aflevering | Bevestigt dat een zending succesvol is afgeleverd. Bevat: Bewijs van aflevering met foto (PPOD): geeft een foto weer waarop de exacte afleverlocatie staat. 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 |
2. Vul de volgende velden in op de pagina Gegevens invoeren:
| 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. Bekijk alle informatie die u hebt ingevoerd voor het webhookproject.
2. Vink het vakje aan om de Algemene Voorwaarden te accepteren.
3. Klik op Maken om de instellingen voor 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 syntactisch formaat 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.
