From 1a325f24e0d1aad1d59f02eb8a3604fd290f82ae Mon Sep 17 00:00:00 2001 From: Felicious Date: Tue, 20 May 2025 16:17:59 -0700 Subject: [PATCH] [IMP] inventory: dhl dev portal fixes closes odoo/documentation#13452 Signed-off-by: Felicia Kuan (feku) --- .../setup_configuration/dhl_credentials.rst | 76 +++++++++++------- .../dhl_credentials/create-dhl-app.png | Bin 0 -> 31937 bytes 2 files changed, 47 insertions(+), 29 deletions(-) create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials/create-dhl-app.png 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 f6d5b27b7..1d6b7ead6 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 @@ -22,9 +22,8 @@ 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:`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. +Then, click the :icon:`fa-arrow-right` :guilabel:`DHL Shipping Methods` link to open a page showing +all shipping methods with the *Provider* set to DHL. Configure DHL shipping method ============================= @@ -66,35 +65,48 @@ DHL Configuration The :guilabel:`DHL Configuration` tab on the shipping method form is used to connect the user's DHL account to Odoo, and configure the shipping method's details. -DHL SiteID, password, and account number -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +DHL developer credentials +~~~~~~~~~~~~~~~~~~~~~~~~~ -A DHL SiteID, password, and account number are used to link a DHL account with third-party services, -like Odoo's **Inventory** app. +To integrate DHL with Odoo, developer credentials must be retrieved from DHL's Developer Portal. +These credentials are used to link the user's DHL account to Odoo's **Inventory** app. .. important:: - The SiteID and password are different credentials than the ones used to log in to a DHL account. + The *SiteID* and *Password* are different credentials than the ones used to log in to a DHL + account. -Here are two ways to obtain these DHL account credentials: +With DHL Express Account +************************ -- **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. +If a DHL Express account is available, log into the `DHL Developer portal +`_ and `request a DHL API account number `_. -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. +Then, in Odoo, on the shipping method form, enter the *DHL API Key* in the :guilabel:`DHL SiteID` +field, and the *API Secret* in the :guilabel:`DHL Password` field. -On the dashboard, click on the :guilabel:`Apps` tab, and select an app. In the -:guilabel:`Credentials` section, click the :guilabel:`Show key` button below the :guilabel:`API Key` -and :guilabel:`API Secret` fields. +Without DHL Express Account +*************************** -Return to the shipping method form in the Odoo database. Enter the *DHL API Key* in the -:guilabel:`DHL SiteID` field, and the *API Secret* in the :guilabel:`DHL Password` field. +If a DHL Express account is **not** available: + +#. Begin by opening a `DHL Express account + `_. +#. Once the developer portal account has been confirmed, log in to the portal using the username and + password. Click the user avatar in the top-right corner of the screen to open the user dashboard. +#. On the dashboard, open the :guilabel:`Apps` tab, and create an app. Follow the four steps in the + app creation flow (app name, needed apps, app status, confirmation) to complete the setup. + + .. image:: dhl_credentials/create-dhl-app.png + :alt: Setup to create DHL account. + +#. After setting up the DHL Express account, go `here + `_ to get the *DHL + API Key* and *API Secret* credentials. + +Then, in Odoo, on the shipping method form, enter the *DHL API Key* in the :guilabel:`DHL SiteID` +field, and the *API Secret* in the :guilabel:`DHL Password` field. Shipping details ~~~~~~~~~~~~~~~~ @@ -128,9 +140,15 @@ Additional settings are available in the :guilabel:`Options` section at the bott 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. +Once the DHL connection is set up, use the smart buttons at the top of the form to publish, turn on +production mode or activate debug logging. -- **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. +- :guilabel:`Unpublished`/:guilabel:`Published`: determines if this shipping method is available + on the user's **eCommerce** website. + +- :guilabel:`Test Environment`/:guilabel:`Production Environment`: determines whether label creation + is for testing and cancelled immediately (Test) or generate real shipping label that is charged + to DHL account (Production). +- :guilabel:`No Debug`/:guilabel:`Debug Requests`: determines whether API requests and responses are + logged in Odoo (turn on :ref:`developer mode ` and go to :menuselection:`Settings + app --> Technical --> Logging`). diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials/create-dhl-app.png b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials/create-dhl-app.png new file mode 100644 index 0000000000000000000000000000000000000000..7e450bc29bdf50551d98c96d2122417f5cecd0c7 GIT binary patch literal 31937 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 e00000;MEoX-(1E|Yk>d&0000