Configuratie & FAQ (Nederlands)

De producten hebben geen gewicht ingesteld, dus Odoo bouwt geen pakket. Ofwel zet je gewichten op de producten, ofwel val je terug op het Default weight (kg)-veld van de carrier, dat wordt gestuurd wanneer het pakketgewicht 0 is. Merk op dat een onnauwkeurig aangegeven gewicht kan leiden tot een herweging bij DHL en een correctie op de factuur.

Het parceltype is vast bepaald door de verzendmethode. Elke methode staat voor één DHL-parceltype (Brievenbuspakket / Pakket tot 10 kg / ... / Pallet tot 1000 kg), dus het type wordt beslist zodra jij (of de klant) de methode kiest. Maak één verzendmethode per type dat je wil aanbieden. Een gewoon pakket gaat tot 31 kg; boven die grens gebruik je een Pallet-methode.

Voor zendingen die verschillende parceltypes in één levering mixen (zoals het DHL-portaal ondersteunt), maak je een methode met Parcel type = Mixed (MIX). Op deliveries met die methode verschijnt een DHL Parcels-tab waar je één rij per pakket toevoegt en per rij het type kiest. De type-lijst past zich aan op basis van of de ontvanger een particulier of een bedrijf is.

De DHL Parcel-API geeft geen live tarieven, dus de prijs wordt op de carrier zelf ingesteld. Kies Pricing mode = Flat en vul DHL flat price in, of Pricing mode = Weight-based rules en definieer de tiers op de Pricing-tab (gebruik weight als variabele). Het generieke "Fixed Price"-veld van de basis-carrier wordt door deze provider niet gebruikt.

Een verzendmethode wordt gefilterd op company: de Company is overgenomen van het delivery-product, dus je kan die niet direct op de carrier wijzigen. Als het delivery-product een company heeft ingesteld, verschijnt de carrier alleen voor deliveries van die company. Fix: open het delivery-product en maak z'n Company leeg (blank = alle companies), of zet 'm op de company waar je vanuit verzendt. Ook het bestemmingsland telt: de methode toont zich alleen voor landen die op de carrier staan.

De module filtert DHL-carriers in webshop-checkout op basis van de particulier-vs-zakelijk-status van de ontvanger, bovenop Odoo's standaard filters (published, website, land, prijs-beschikbaarheid). De filter spiegelt de backend Add Shipping-wizard zodat overal dezelfde set carriers wordt aangeboden.

Concreet: een carrier rond een consumer-only parceltype (Envelop 50 tot 500 g, Brievenbuspakket) is verborgen voor zakelijke klanten, en een carrier rond een business-only parceltype (Pallet tot 1000 kg) is verborgen voor particuliere klanten. De drie "Pakket tot X kg"-types (10/20/31) hebben geen ontvanger-restrictie en verschijnen voor beide.

Als klanten melden "er verschijnt geen DHL-optie", check dan of je minstens één gepubliceerde DHL-carrier hebt die past bij het ontvanger-type dat ze zijn. De veiligste setup voor een webshop die beide doelgroepen bedient is één carrier met een "Pakket tot X kg"-type (geen ontvanger-restrictie); voeg daarbovenop Envelop / Brievenbus / Pallet varianten toe als je een rijker aanbod wil, wetende dat die automatisch verbergen voor de doelgroep die er niet bij past.

Controleer dat Integration Level op Get Rate and Create Shipment staat. Met alleen "Get Rate" wordt er geen label aangemaakt bij validate.

Voor deze provider: niets. DHL Parcel gebruikt één API-adres voor zowel test als productie. Of je in test of live zit hangt alleen af van welke API-key je invoert.

Zet het Delivery Method-veld op de klant (Contacts → klant → Sales and Purchase tab). Nieuwe orders voor die klant nemen dat over als default. Er is geen enkelvoudige globale default voor alle orders zonder customization. Voor webshop-orders kiest de klant de methode bij checkout.

Odoo maakt een aparte delivery per magazijn, en elk wordt een eigen DHL-shipment met het correcte afzenderadres. Één label kan slechts één afzender bevatten, dus verschillende magazijnen betekenen altijd verschillende shipments.

Op een DHL-delivery is er een Number of parcels-veld. Zet het op het aantal identieke pakketten dat je wil versturen; de module stuurt één DHL-shipment met dat aantal pieces, allemaal van het parceltype van de carrier. DHL geeft één tracker per piece en één gecombineerde multi-page label-PDF. Geen Put in Pack nodig als alle pieces hetzelfde type zijn.

Activeer de Packages-feature: Inventory → Configuration → Settings → Operations → Packages, en bewaar. De knop verschijnt daarna op de delivery.

Odoo pakt op basis van hoeveelheid. In Detailed Operations: zet de hoeveelheid alleen op de regels voor de eerste doos (de andere op 0), klik Put in Pack, en zet dan de resterende regels in en klik opnieuw Put in Pack. Elke Put in Pack bundelt wat op dat moment een hoeveelheid heeft en nog niet gepakt is.

Dat is OK; package type wordt door deze module niet gebruikt. Het DHL-parceltype ligt vast door de verzendmethode.

Gebruik native Put in Pack: splits de hoeveelheden zo dat de items voor doos 1 eerst "Done" zijn, klik Put in Pack, en zet dan de resterende hoeveelheden en klik opnieuw Put in Pack. Elke package wordt één piece in de DHL-shipment, allemaal van het parceltype van de carrier. Elke piece krijgt z'n eigen tracking-code, en alle labels komen terug in één multi-page PDF die aan de delivery hangt. Als het je niet uitmaakt welke items in welke doos zitten, gebruik dan gewoon het Number of parcels-veld (eenvoudiger - één klik).

Alle 31 Europese bestemmingen die DHL eCommerce Benelux dekt. Zie "Welke bestemmingen ondersteunt de module, en hoe wordt het DHL-product gekozen?" hieronder voor de volledige lijst en de product-resolutie-logica.

Nee. De parceltype-catalogus van DHL is dezelfde ongeacht de ontvanger; het verschil tussen zakelijk en particulier wordt geregeld door het product dat DHL automatisch selecteert (een home-delivery-product voor consumenten, een zakelijk product anders).

In het DHL-portaal - er is geen programmatische alternatief. De publieke DHL-API heeft geen cancel-endpoint, alleen een read-only GET /intervention-options die rapporteert of een cancel toegestaan zou zijn. De cancel-actie van de module plaatst een note op de delivery (met de tracking-referentie nog leesbaar zodat je ze kan opzoeken in het portaal).

Nota van DHL: een label dat aangemaakt werd maar waarvan het pakket het DHL-netwerk nooit binnenkwam (dus je annuleerde voor drop-off) wordt niet gefactureerd. Je hoeft enkel in het portaal te annuleren als je de zending uit je MDP shipment-lijst wil verwijderen voor de netheid.

Ja voor productie-keys: shipments die via de API aangemaakt worden verschijnen in het DHL-portaal onder je account, precies alsof je ze manueel had ingevoerd. Sandbox-shipments verschijnen NIET in het productie-portaal (dat is net de bedoeling van sandbox: labels worden gegenereerd en tracker-codes teruggegeven, maar het pakket komt het DHL-netwerk nooit binnen en wordt niet gefactureerd).

Nee, en dat kan ook niet: de publieke DHL Parcel-API heeft geen adresboek- / customer-endpoints. De "save customer"-tickbox in het DHL-portaal is een portaal-interne feature die enkel telt wanneer je zendingen manueel invoert via de portaal-UI. In onze flow zijn Odoo's res.partner-records de klantendatabase: elke delivery stuurt zijn receiver-adres rechtstreeks van de partner naar DHL, dus er is geen tweede kopie van het adres nodig in het DHL-portaal. De tickbox mag genegeerd worden bij gebruik van deze module.

Er zijn twee stappen: eerst moet DHL API-toegang activeren op het account, dan maak je de eigenlijke keys zelf aan in het portaal.

1. DHL kent de API-rol toe aan je account. API-toegang is geen standaardonderdeel van een DHL eCommerce Benelux-contract. Voor je een API Key kan aanmaken in het portaal, moet je DHL-contact (of DHL eCommerce support) de API-rol toekennen aan je account. Dit is een manuele actie aan DHL-kant - je kan het zelf niet triggeren. Mail je DHL-accountmanager met je klantnummer en vraag expliciet om API-toegang op je account te activeren zodat je API keys kan aanmaken via het portaal.

Tot die rol toegekend is, toont het DHL-portaal alleen een "Connections"-pagina en geen API Keys-sectie. Dat is het signaal dat stap 1 nog niet rond is.

2. Maak de keys aan in het portaal. Zodra DHL bevestigt dat de rol actief is: log in op het DHL-portaal en ga naar Settings → API Keys. Kopieer de User ID en API Key die daar staan. Het Account ID is het korte klantnummer dat op facturen en in je account-details te vinden is.

Sinds module-versie 17.0.0.8.8 zijn de drie credential-velden (User ID, API Key, Account ID) beperkt tot een dedicated group DHL Parcel Administrator. Odoo-administrators worden automatisch toegevoegd. Andere users die die velden moeten instellen of lezen moeten manueel aan de group toegevoegd worden: Settings → Users & Companies → Users → [de user] → Access Rights → tab Other → DHL Parcel Administrator. Leden van die group behouden hun gewone toegang tot al de rest; de group ontsluit enkel de credential-velden.

Niet-leden kunnen nog steeds DHL Parcel-carriers aanmaken, bewerken en gebruiken - ze zien de credential-velden gewoon niet op de form en kunnen ze niet lezen via XML-RPC/ORM. Alle interne reads door de module zelf gebruiken sudo(), dus dagelijkse operaties (deliveries valideren, labels printen, Test Connection getriggerd door de admin die de setup deed) werken onafhankelijk van de group-lidmaatschap van de operator.

De module ondersteunt outbound vanuit BE / NL / LU naar 31 Europese bestemmingen. De Countries-dropdown op de carrier is gefilterd op die lijst (en verder ingeperkt door parceltype: Envelop = alleen NL, Brievenbuspakket = alleen BE + NL, andere pakketten + Pallet = alle 31).

Voor elke shipment resolvet de module het juiste DHL-product op basis van het bestemmingsland en het klanttype (zakelijk / consumer):

• Benelux (BE / NL / LU): blanco product-code; DHL resolvet DFY / Europlus / Parcel Connect automatisch aan hun kant.
• Niet-Benelux EU: CON (Parcel Connect) voor particuliere ontvangers, EPL-INT (Europlus International) voor zakelijke ontvangers.
• Buiten EU (post-Brexit UK, Zwitserland, Noorwegen, ...): CON2C (Parcel Connect 2C) voor particulier, EPL-INT voor zakelijk. Een bulk-douaneaangifte wordt automatisch aan de request toegevoegd.
• Palletzendingen (Pallet tot 1000 kg): EPL-PAL (Europlus Pallet).

Gebruik de Verify Contract-knop in de Contract check-sectie van de DHL Parcel-tab op de carrier. Die queryt DHL's /products-endpoint voor elk aangevinkt bestemmingsland + relevant klanttype, en rapporteert of het product dat deze carrier zou gebruiken effectief actief is op je DHL-contract. Landen gemarkeerd als NOT IN CONTRACT zullen falen bij label-aanmaak; vraag DHL om het ontbrekende product te activeren, of vink die landen uit op de carrier. Dit is een read-only call - er wordt niks verzonden en er verschijnt niks in het DHL-portaal.