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:
1. Via Mijn projecten:
- Linkernavigatiepaneel → tabblad Webhooks → +EEN WEBHOOKPROJECT AANMAKEN
2. Via API-catalogus:
Linkernavigatiepaneel → API-catalogus
Zoek naar of filter op Advanced Integrated Visibility
Kies:
- Overzicht → Klik op Documentatie → Klik in Sandbox Console op +EEN PROJECT AANMAKEN
- Documenten → 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:
1. Verzendt met FedEx en moet FedEx-webhook integreren in het bedrijfssysteem.
2. Verkoopt of levert een softwareoplossing die FedEx-gegevens gebruikt en geen gecertificeerde FedEx Compatible Provider is.
3. 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 worden 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:
1. Klik op Advanced Integrated Visibility - Accountnummer en klik vervolgens op Volgende.
2. Selecteer de facturatie-accounts, accepteer de betalingsvoorwaarden en klik op Volgende.
Minimaal één facturatie-account moet worden toegevoegd.
3. Op de pagina Gegevens bevestigen:
- Bekijk de projectinformatie.
- Accepteer de Algemene voorwaarden.
- Als Aangepaste prijzen van toepassing zijn, verschijnt het gerelateerde document automatisch.
4. Na een succesvolle aanmaak verschijnt een bevestigingsbericht:
"U hebt het product toegevoegd aan 'Mijn project'."
5. 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 3: Projectoverzicht – webhook configureren
1. Ga naar de pagina Projectoverzicht.
2. Selecteer het tabblad Webhooks.
3. Klik op de knop + Webhooks configureren om de configuratie van de webhook te starten. Deze wordt doorgestuurd naar het tabblad Webhooks
Functiebeschrijvingen
| Veldnaam | Omschrijving |
|---|---|
| Bewijs van aflevering | Bevestigt dat een zending succesvol is afgeleverd. Omvat:
|
| Verwachte levering | Helpt ontvangers plannen door te voorzien in:
|
| Trackinggebeurtenissen | Hiermee kunt u één of meer gebeurteniscategorieën selecteren om meldingen te ontvangen:
|
| Filteren op basis van gebeurtenissen | Filtert webhook-reacties om het volgende op te nemen:
|
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:
|
| Beveiligingstoken | Een gedeeld geheim dat wordt gebruikt om webhook-reacties te authenticeren en valideren via HMAC. Vereisten:
|
| Taal van het laadvermogen (land) | Selecteer de voorkeurstaal voor de vertaling van de traceergegevens in de keuzelijst. |
| Trackingtype | Kies hoe traceergegevens geleverd moeten worden:
|
| 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.
