Naar hoofdinhoud
Advanced Shipping Carrier

Advanced Shipping Carrier Integration: wat niemand je vertelt bij de ingebruikname

Om Advanced Shipping Carrier Integration in gebruik te nemen, maak je elke vervoerder aan met Carrier Name, Carrier Type, Company en het vakje Enabled, samen met de gegevens van je account bij die vervoerder: API Key, API Secret en Account Number. Houd in de eerste week Connection Status, Last Sync Time en Last API Response van elke vervoerder in de gaten en lees bij een mislukt verzoek de HTTP Status Code en de Error Message. Hieronder vind je de praktische details die je beter kent voordat je begint.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
6 min

Voordat je de eerste vervoerder aanmaakt

De ingebruikname draait om een paar plekken: de kaart van elke vervoerder, het logboek van elk verzoek en de statusvelden die je in de lijsten ziet. Dit zijn de details die je voor je aan iets begint duidelijk moet hebben. Zoek je het totaalbeeld van menu's en werkstroom, dan vind je dat in hoe de module van binnen werkt.

De gegevens zijn die van je account bij elke vervoerder

Bij het aanmaken van een vervoerder horen Carrier Name, Carrier Type (een keuzeveld), Enabled en Company. Daarnaast komen de inloggegevens. De module zelf omschrijft API Key als «API key of the carrier account» en API Secret als «API secret of the carrier account». Account Number is het eigen rekeningnummer bij elke vervoerder, en het veld noemt als voorbeelden «FedEx account, UPS account, etc.».

In de praktijk: die drie gegevens zijn die van je account bij elke vervoerder, dus leg ze klaar voordat je gaat configureren. En omdat elke vervoerder zijn eigen Company krijgt, controleer je bij meerdere bedrijven in dezelfde database aan welk bedrijf elke vervoerder is toegewezen.

Custom Endpoint URL is optioneel en heeft één specifiek geval

Tussen de velden van de vervoerder staat Custom Endpoint URL. De omschrijving noemt het een aangepaste, optionele API-URL voor «non-standard carriers». Valt jouw vervoerder daar niet onder, dan hoef je het niet in te vullen.

Enabled en Connection Status bekijk je los van elkaar

Enabled is een vakje; Connection Status is een apart keuzeveld. Het zijn twee verschillende gegevens en je controleert ze het best afzonderlijk. Ernaast staan Last Sync Time, met datum en tijd van de laatste synchronisatie, en Last API Response, met het laatste antwoord van de API. Op dezelfde kaart staan ook Created en Created By, met de aanmaakdatum en de gebruiker die de vervoerder heeft aangemaakt.

Lijst van Hazmat Categories van de module Shipping met zes records, elk met code, categorienaam en toeslag op nul, met zoekbalk en paginering
Nog een lijst van de module: Hazmat Categories, met zes categorieën en hun toeslag op nul.

Elk verzoek wordt veld voor veld bewaard

De module bewaart een record met deze velden: Carrier, Request Type, Status, Timestamp, HTTP Status Code, Response Snippet, Error Message, Request Payload en Company. Als er iets niet klopt, kijk je daar:

  • Request Type: welk soort verzoek het was.
  • Request Payload: wat er is verstuurd.
  • HTTP Status Code: de HTTP-code van het antwoord.
  • Response Snippet: een fragment van het antwoord.
  • Error Message: de tekst van de fout.
  • Timestamp: wanneer het gebeurde.

Met Carrier en Timestamp bepaal je snel om welke vervoerder en welk moment het gaat. Voor de duiding van elke afzonderlijke melding heb je de gids met fouten en waarschuwingen van de module.

Er zijn meerdere statusvelden en ze betekenen niet hetzelfde

In de module vind je meerdere velden met de naam status of state, elk met een eigen set waarden:

  • status met Success, Failed en Timeout.
  • status met Success, Error en Label Exists.
  • status met Draft, Generated, Printed en Failed.
  • status met Active, Degraded en Down.
  • status met Draft, In Progress, Completed, Failed en Paused.
  • status met Draft, Completed, Failed en Partial.
  • state met Open, Submitted, Approved, Rejected en Paid.
  • state met Draft en Done.
  • status_filter met Draft, Ready-to-Ship en All.

Let op: Failed en Draft komen in meerdere van deze velden voor. Als je filtert of als iemand van het team zegt dat iets op Failed staat, vraag dan eerst in welke lijst diegene het zag voordat je de oorzaak zoekt.

Het langste state-veld loopt van Draft tot Cancelled

Eén van de state-velden van de module doorloopt deze waarden: Draft, Blocked, Cost Quoted, Ready to Ship, In Transit, Out for Delivery, Delivered, Attempted Delivery, Returned to Sender, Lost, Damaged en Cancelled. Daarnaast zijn er twee velden, status en current_status, met Pre-Label, In-Transit, Out-for-Delivery, Delivered, Exception en Returned.

Let op de schrijfwijze: in het ene geval is het Out for Delivery en in het andere Out-for-Delivery; hetzelfde geldt voor Ready to Ship en het Ready-to-Ship van status_filter. Houd daar rekening mee bij het zoeken of het aanmaken van opgeslagen filters.

Wizard Export Intrastat met maand en jaar, uitleg over de CSV en knoppen Export en Cancel, geopend boven de lijst met DHL Express-zendingen in de statussen Ready to Ship en Delivered
De wizard Export Intrastat boven de lijst met zendingen (Shipping › Shipments), met DHL Express-zendingen in Ready to Ship en Delivered.
Wizard Bulk Print Labels geopend boven de lijst met zendingen met twee geselecteerde DHL Express-zendingen, knoppen Download Labels en Cancel en tekst over één PDF of een ZIP
Bulk Print Labels met twee geselecteerde DHL Express-zendingen; de tekst van de wizard spreekt over één PDF of een ZIP.
Verloop van de wizard Bulk Print Labels met twee geselecteerde zendingen, het dialoogvenster Create Return voor een zending in de status Delivered en het dialoogvenster Record Carrier Invoice met DHL Express
Van het massaal afdrukken van labels naar het dialoogvenster Create Return (met oorspronkelijke zending, vervoerder, type dienst, Email Customer en retouropmerkingen) en naar het registreren van de factuur van de vervoerder met Record Carrier Invoice.

last_health_check_status heeft drie waarden

Het veld last_health_check_status neemt Success, Failed of Unknown aan. Noteer in de eerste week elke dag welke van de drie wordt getoond en vergelijk dat met Last Sync Time en Last API Response van de vervoerder.

Wat je in de eerste week controleert

Met het bovenstaande komt de controle van de eerste dagen hierop neer:

  • Elke vervoerder heeft API Key, API Secret en Account Number van zijn account, en de juiste Company.
  • Custom Endpoint URL is alleen ingevuld waar het geval van «non-standard carriers» van toepassing is.
  • Enabled en Connection Status van elke vervoerder, apart bekeken.
  • Last Sync Time en Last API Response, dagelijks.
  • De waarde van last_health_check_status.
  • Bij elk mislukt verzoek: HTTP Status Code, Error Message, Response Snippet en Request Payload.
  • Welke records in Blocked, Exception of Attempted Delivery staan.

Wat het kost en hoe FlexigoTech je helpt

De module kost € 9 excl. btw per Odoo-versie, als eenmalige betaling, voor 17, 18, 19 en 20; in Odoo 19 en 20 heb je bovendien het abonnement op FlexigoTech Cloud nodig, waarvan het plan Conector € 49 per maand of € 490 per jaar excl. btw kost (Pro: € 98 per maand of € 980 per jaar), met maximaal 3 accounts van het platform (Pro: 10). Die verbinding via FlexigoTech Cloud bewaart de inloggegevens versleuteld, bewaakt de synchronisatie en waarschuwt per e-mail als die mislukt; zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert en blijven de gegevens in je Odoo.

De details vind je op de pagina van Odoo Apps en op de modulepagina op flexigotech.com.

Bij FlexigoTech voeren we Odoo 17, 18, 19 en 20 in en ontwikkelen we connectoren en integraties op maat. Heb je hulp nodig bij het aanmaken van je vervoerders, het nakijken van de eerste fouten of het afstemmen van de verzendstroom op jouw werkwijze, vertel ons dan over jouw situatie.

Lees verder

Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen