Je aanvragen
Klik in de zijbalk op Vervoerdersaanvragen. De pagina heeft de titel Vervoerdersaanvragen en toont je aanvragen onder Je aanvragen. Klik bovenaan op Vervoerder aanvragen om een nieuwe te sturen. De lijst heeft deze kolommen: Vervoerder, Status, Inlogmethode, Ingediend en Laatst bijgewerkt. Klik op een rij om de details te zien. Heb je nog geen aanvragen, dan zegt de pagina “Geen vervoerdersaanvragen” en toont hij een knop Vervoerder aanvragen.
De pagina Vervoerdersaanvragen voor je eerste aanvraag
Status
Een aanvraag versturen
1
Het formulier openen
Klik op Vervoerdersaanvragen op Vervoerder aanvragen. Het venster Vervoerder aanvragen gaat open.
2
De vervoerder beschrijven
Vul de Naam van de vervoerder en de Website van de vervoerder in. Voeg een URL van de documentatie en een Swagger-/OpenAPI-URL toe als de vervoerder die voor ontwikkelaars publiceert.
3
De testinloggegevens toevoegen
Kies de Inlogmethode die de vervoerder gebruikt en vul dan de velden voor inloggegevens in die daarbij verschijnen. Gebruik de gegevens voor het testsysteem van de vervoerder, niet je live account.
4
Versturen
Voeg Notities toe als we iets moeten weten en klik op Aanvraag indienen. Je ziet “Vervoerdersaanvraag ingediend” en de aanvraag verschijnt in de lijst als In afwachting.
Het formulier Vervoerder aanvragen met Inlogmethode ingesteld op API-sleutel
Velden
Een ongeldig webadres toont “Voer een geldige URL in”. Een leeg verplicht veld toont “Dit veld is verplicht”.
Inloggegevens per inlogmethode
De velden voor inloggegevens veranderen met de Inlogmethode. Alleen de velden voor het gekozen type worden verstuurd.
De vervoerder vertelt je welk type hij gebruikt. Weet je het niet zeker, vraag het dan de vervoerder, of kies Eigen en voeg elk gegeven toe dat hij je heeft gegeven.
Vul bij OAuth 2.0 Client-ID, Client secret en Token-URL in
Testen op het live systeem van de vervoerder
Laat deze schakelaar in de meeste gevallen uit. Zippendo test de nieuwe koppeling dan op het testsysteem van de vervoerder met de gegevens die je hebt ingevuld. Zet hem alleen aan als de vervoerder geen testsysteem heeft. Het formulier zegt: “Schakel dit alleen in als de vervoerder geen testomgeving heeft. We voeren de tests dan uit op het live systeem van de vervoerder met de inloggegevens hierboven. Laat het uit om in de testomgeving van de vervoerder te testen.” Deze schakelaar heeft alleen invloed op de aanvraag. Het is niet het selectievakje Testmodus bij een gekoppelde vervoerder, zie Testmodus.
Testen op het live systeem van de vervoerder staat standaard uit
Een aanvraag volgen
Klik in de lijst op een aanvraag om de details te openen. Je ziet:- de naam van de vervoerder en de status
- een link naar de website van de vervoerder
- je Notities, als je die hebt toegevoegd
- Voortgang: de stappen van de bouw, zoals Aanvraag ingediend, Vervoerder onderzoeken, Verzendlabels genereren, Track & trace genereren, Afhaalpunten genereren, Verzendproducten genereren, Tests uitvoeren en Vrijgegeven. Elke stap is gemarkeerd als In afwachting, Bouwen, Gebouwd, Mislukt of Overgeslagen.