diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials.rst b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials.rst index 40b9419a23..f6d5b27b7a 100644 --- a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials.rst +++ b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials.rst @@ -16,14 +16,15 @@ least one *shipping method*, the process of :doc:`calculating shipping rates Enable DHL shipping connector ============================= -Before creating a DHL shipping method, it is necessary to enable the carrier's shipping connector. -To do so, navigate to :menuselection:`Inventory app --> Configuration --> Settings`. +Before creating a DHL shipping method, enable the carrier's shipping connector. To do so, navigate +to :menuselection:`Inventory app --> Configuration --> Settings`. Scroll down to the :guilabel:`Shipping Connectors` section, and tick the checkbox next to :guilabel:`DHL Express Connector`. Finally, click :guilabel:`Save` to apply the changes. -Once the connector has been enabled, a :icon:`oi-arrow-right` :guilabel:`DHL Shipping Methods` link -appears below. Click the link to open a page showing all shipping methods configured for DHL. +Once the connector has been enabled, a :icon:`fa-arrow-right` :guilabel:`DHL Shipping Methods` link +appears below the setting. Click the link to open a page showing all shipping methods configured for +DHL. Configure DHL shipping method ============================= @@ -44,7 +45,6 @@ Click :guilabel:`New` to open a blank shipping method form. If a shipping method created, it can be selected from this screen. .. image:: dhl_credentials/dhl-form.png - :align: center :alt: The form for a DHL shipping method. General information @@ -70,28 +70,21 @@ DHL SiteID, password, and account number ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A DHL SiteID, password, and account number are used to link a DHL account with third-party services, -like Odoo's **Inventory** app. The SiteID and password are different credentials than the ones used -to log in to a DHL account. +like Odoo's **Inventory** app. -To obtain a DHL SiteID, password, and account number, it is necessary to register on the `DHL API -Developer Portal `_, by filling out the following -information: - -- :guilabel:`First name` -- :guilabel:`Last name` -- :guilabel:`Email address` -- :guilabel:`Username` -- :guilabel:`Company Name` -- :guilabel:`Country` - -After filling out all of the fields, tick the :guilabel:`I have read and accept the terms of use and -the privacy policy` checkbox, and click :guilabel:`Send` to register. +.. important:: + The SiteID and password are different credentials than the ones used to log in to a DHL account. -After registering, a confirmation email is sent to verify the application. Click the link inside the -email to activate the developer portal account, and set a password. +Here are two ways to obtain these DHL account credentials: -This email also includes the account number for the developer portal account. Enter the number in -the :guilabel:`DHL Account Number` field on the shipping method form. +- **If a DHL Express account is available**: Log into the `DHL Developer portal + `_, and then `request a DHL API account number `_. +- **If a DHL Express account is unavailable**: Follow DHL's steps to `obtain a DHL Express account + `_, and then follow the steps in + the previous bullet. Once the developer portal account has been confirmed, log in to the portal using the username and password. Click on the user avatar in the top-right corner of the screen to open the user dashboard. @@ -131,3 +124,13 @@ Additional settings are available in the :guilabel:`Options` section at the bott after validating a delivery order. - :guilabel:`Dutiable Material`: Enable this option if the shipping method is liable to customs or other duties. + +Turn on the DHL Connection +========================== + +Once the DHL connection is set up, use the buttons at the top of the form to turn on or debug the +connection. + +- **Unpublished/Published**: turns the connection on or off. +- **Test Environment/Production Environment**: sets whether requests actually get sent to DHL. +- **No Debug/Debug Requests**: determines whether error logging occurs for requests to DHL.