FedEx Integrator Provider
Vereiste
U moet een FedEx-gebruikersnaam hebben om u aan te melden bij FedEx Developer Portal en een organisatie te creëren.
Word lid van de organisatie van uw bedrijf om samen te werken met uw team. Als uw bedrijf geen organisatie heeft, kunt u er een aanmaken.
Lid worden van een bestaande organisatie
1. Een uitnodiging aanvragen
Vraag de beheerder van uw organisatie om u een uitnodiging te sturen. U hebt 24 uur de tijd om die te accepteren. Als de uitnodiging is verlopen, vraag de beheerder dan om deze opnieuw te versturen.
2. De uitnodiging accepteren
Log in met uw bestaande gebruikersnaam en wachtwoord. Als uw gebruikersnaam aan een andere organisatie gekoppeld is, maak dan een nieuwe aan.
Een nieuwe organisatie aanmaken
Wanneer u een organisatie maakt, wordt u de beheerder. Als beheerder kunt u gebruikers uitnodigen om lid te worden van de organisatie, projecten en gebruikersrollen toewijzen, en facturatie-accounts beheren.
Ga voor meer informatie over gebruikersrollen naar Richtlijnen voor organisatiebeheer.
1. Selecteer Organisatie aanmaken of lid worden van een organisatie in de navigatiebalk.
2. Voer de volgende gegevens in:
- Voor Ik werk voor een bedrijf dat, selecteert u Een softwareoplossing verkoopt of levert die gebruikmaakt van FedEx-technologie en zich wil registreren als een gevalideerde FedEx Integrator Provider
- Voer uw bedrijfsnaam, bedrijfswebsite en een organisatienaam in die uw team zal herkennen, zoals uw bedrijfsnaam, afdeling, divisie of regio.
- Voer een officieel e-mailadres in met daarop het domein van uw bedrijf, het land of de regio waar uw bedrijf is gevestigd en de landen en gebieden waar u uw softwareoplossing verkoopt of distribueert.
3. Selecteer Volgende.
U kunt gegevens later bijwerken of toevoegen onder Organisatie beheren in het menu.
Een facturatie-account toevoegen
1. Selecteer het tabblad Facturatie-accounts. Als u nog geen FedEx facturatie-account hebt, selecteer dan Facturatie-account openen om een nieuwe te openen of neem contact op met de ondersteuning van FedEx.
Let op: gebruik uw accountnummer; het kan niet het FedEx-accountnummer van een klant zijn.
2. Selecteer Facturatie-account toevoegen.
3. Voer uw FedEx-accountnummer, een accountbijnaam en het Amerikaanse factuuradres in dat u tijdens het aanmaken van uw account hebt gebruikt.
Let op: het factuuradres moet overeenkomen met het adres dat u tijdens het instellen van het account hebt gebruikt. Dit account wordt het standaard facturatie-account van uw organisatie.
4. Kies een authenticatieoptie.
- Telefoongesprekken zijn alleen beschikbaar voor integrators in de Verenigde Staten en Canada.
5. Voer de authenticatiecode in die u hebt ontvangen en selecteer Indienen.
6. Lees en accepteer de FedEx-integratorovereenkomst.
Gebruikers uitnodigen als beheerder
1. Ga naar Organisatie beheren en selecteer het tabblad Gebruikers.
2. Selecteer + Gebruikers toevoegen.
3. Voer de volgende gegevens in:
- Het land of gebied
- De voorkeurstaal
4. Selecteer een gebruikersrol (kijker, bijdrager of beheerder).
5. (Optioneel) Wijs de gebruiker toe aan een project.
- U kunt op elk moment een gebruiker toewijzen vanaf de overzichtspagina van het project.
6. Voer de e-mailadressen van de gebruikers in en klik op Uitnodigen.
- U kunt maximaal 20 gebruikers tegelijk uitnodigen, waarbij elk e-mailadres wordt gescheiden door een komma. De uitnodiging is 24 uur geldig.
Een project aanmaken
1. Ga naar Mijn Projecten in het menu en selecteer + Project aanmaken.
2. Voer een projectnaam in.
- De aanbevolen naamindeling is Projectnaam_applicatienaam. Selecteer Volgende als u klaar bent.
3. Selecteer de API's en producten voor Advanced Integrated Visibility die u in uw project wilt opnemen.
- Producten voor Advanced Integrated Visibility zijn alleen beschikbaar voor Amerikaanse FedEx-integratorproviders.
- Als u betaalde producten selecteert, wordt u gevraagd een facturatie-account aan het project toe te wijzen en de vereiste voorwaarden te accepteren.
Een facturatie-account toewijzen
Let op: dit is alleen vereist als u een betaald product kiest.
1. Wijs een facturatie-account toe uit de lijst van accounts die aan de organisatie zijn toegevoegd. Facturatie-accounts moeten gevestigd zijn in de Verenigde Staten.
2. Accepteer de licentieovereenkomst en het bestelformulier van de FedEx Developer Portal en selecteer Maken.
Advanced Integrated Visibility configureren in een project
Vereisten
- Prijzen bekijken: abonnees ontvangen maandelijks een rekening op basis van het aantal tracking-nummers. Ga naar het Bestelformulier voor meer informatie over prijzen.
- Accounts instellen: voor de Zichtbaarheid van zendingen-webhook is een facturatie-account uit de VS en minstens één verzendaccount vereist; deze twee accounttypes sluiten elkaar uit. Alleen beheerders kunnen facturatie- en verzendaccounts toevoegen op de pagina Organisatie beheren.
1. Maak een bestemmings-URL aan in uw applicatie of platform om callbacks te ontvangen. De URL moet:
- HTTPS gebruiken
- RFC1918 IP-ruimte, fedex.com en de subdomeinen daarvan en IP-adressen zoals localhost of 127.0.0.1 uitsluiten.
2. Genereer een beveiligingstoken voor authenticatie. Het token moet:
- 26-100 tekens, minstens één hoofdletter, minstens één kleine letter en minstens één cijfer bevatten
3. Ga in het menu naar Mijn projecten en selecteer vervolgens het tabblad Advanced Integrated Visibility.
4. Selecteer Een Advanced Integrated Visibility-project maken.
5. Selecteer het gebruikerstype:
- FedEx-afzender: verzendt met FedEx en moet de FedEx-API's in hun eigen applicaties integreren
- FedEx Compatible Provider: is een gecertificeerde FedEx Compatible Provider
- FedEx Integrator Provider: verkoopt of levert een softwareoplossing die FedEx-technologie gebruikt en is een gevalideerde FedEx Integrator Provider
6. Selecteer het abonnementstype. U kunt zich abonneren op gebeurtenissen via accountnummers of tracking-nummers.
7. Bevestig het facturatie-account en selecteer de functies die u wilt, zoals bewijs van aflevering, verwachte levering, traceergebeurtenissen of filteren op basis van gebeurtenissen.
8. Projectgegevens invoeren.
- Voer een unieke en herkenbare projectnaam in.
- Voer de bestemmings-URL en het beveiligingstoken in dat u heeft aangemaakt.
- Voer een e-mailadres en voorkeurstaal in voor meldingen over updates en onderbrekingen voor Advanced Integrated Visibility.
9. Accepteer de FedEx Developer Portal-licentieovereenkomst en het bestelformulier en selecteer Maken.
Let op: afhankelijk van het door u gekozen abonnementstype gelden mogelijk aanvullende stappen. Ga voor meer informatie naar onze Webhook-documentatie.
Gebruik deze stappen om uw API-integratie te verifiëren en te bevestigen dat uw applicatie testgegevens kan verzenden en ontvangen.
1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.
2. Op het tabblad API-sleutels, onder Testsleutel, vindt u uw testgegevens.
3. Log in en download de JSON API-verzameling via de knop JSON-schema downloaden bovenaan de documentatiepagina. Bekijk voorbeeldaanvragen voor de eindpunten die uw integratie gebruikt.
4. Vraag een OAuth-toegangstoken aan voor gebruik bij elke API-transactie. Het token is één uur geldig en u kunt uw applicatie zo instellen dat deze wordt vernieuwd voordat het verloopt. Ga voor meer informatie naar de Documentatie voor API Authorization.
5. Selecteer in het menu API-catalogus, kies de API waarmee u wilt werken en selecteer Documentatie.
6. Selecteer in het menu het eindpunt.
7. Verzend voorbeeldaanvragen met uw testgegevens en de FedEx-test-URL en bevestig vervolgens dat de antwoorden overeenkomen met de documentatievoorbeelden. Ga voor meer informatie naar de Sandbox-virtualisatiegids.
8. Voer tests uit met Advanced Integrated Visibility om voorbeeldgegevens te genereren en te bevestigen dat uw applicatie de traceringsinformatie correct verwerkt.
Let op: tijdens het testen wordt uw callback-URL niet geverifieerd. Ga voor meer informatie naar de Documentatie over Advanced Integrated Visibility.
De validatiestappen verschillen per regio
De volgende stappen zijn alleen van toepassing op klanten in de VS en Canada. Als u buiten deze landen woont, ga dan naar de pagina API-validatie voor ondersteuning.
Om uw API's naar productie te verplaatsen, moeten ze worden gevalideerd. Het validatieniveau verschilt per API. Bekijk de API-validatievereisten voordat u begint.
1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.
2. Op het tabblad API-sleutels, onder Testsleutel, vindt u uw testgegevens.
3. Identificeer testgevallen voor de regio's of gebieden waar u uw oplossing wilt inzetten. Ga voor informatie naar Integrator-testcasebasislijn.
4. Voltooi registratietransacties met behulp van de testaccountnummers voordat u testcases uitvoert.
5. Voltooi alle vereiste testcases.
6. Vul het productinformatieformulier (PIW) in met uw contactgegevens en uw keuze voor FedEx-services.
7. Voltooi het Integrator-validatieoverzichtsblad.
De te leveren documenten indienen
Stuur alle benodigde documenten naar validationmtp@fedex.com.
1. Bereid de volgende te leveren documenten voor:
- Ingevulde PIW (PDF)
- Ingevuld Validatieoverzichtsblad (PDF)
- Eindklantregistratietransacties met multifactorauthenticatie (JSON)
- Gescande verzendlabels voor alle toepasselijke testcases (PDF of PNG)
- Verzendtransacties voor drie labelformaten (PDF, PNG en ZPL (JSON)), voor toepasselijke verzend- en beoordelings-API's
- Screenshots (PDF) tonen:
- Klantgerichte oplossing die FedEx-services en speciale afhandeling weergeeft
- Disclaimer
- Licentieovereenkomst voor eindgebruikers (EULA)
- Eindklantregistratieflow
2. Comprimeer alle bestanden tot één .zip-bestand om beperkingen van e-mailadresproviders te omzeilen.
3. E-mail het .zip-bestand naar het validatieteam.
Best practices om vertragingen te voorkomen
Volg deze richtlijnen om de beoordelingstijd te verkorten:
- Print en scan labels met minimaal 600 DPI. Dien geen bestanden in die rechtstreeks via API's zijn gegenereerd.
- Vraag voor thermische printers het afbeeldingstype aan dat overeenkomt met uw printer, bijvoorbeeld ZPLII voor Zebra-printers.
- Voeg voor FedEx International Express® de aanvullende (secundaire) luchtvrachtbrief (AWB) toe.
- Voeg bij zendingen die uit meerdere pakketten bestaan (MPS) een label toe aan elk pakket.
Labelbeoordeling
Het validatieteam beoordeelt uw inzending.
- Verwerk bij een afwijzing de feedback en dien de te leveren documenten opnieuw in.
- Indien goedgekeurd, ontvangt u een bevestigings-e-mail. Na goedkeuring worden uw productiereferenties geautoriseerd voor transacties met verzendlabels.
1. Selecteer Mijn Projecten in het menu en selecteer vervolgens de Projectnaam.
2. Kopieer en bewaar uw productie-API-sleutel en geheime sleutel in het gedeelte API's.
Let op: bewaar uw geheime sleutel op een veilige locatie, omdat deze slechts één keer voorkomt. Als u de productiesleutel kwijtraakt, kunt u later een nieuwe aanmaken.
