8000 [IMP] Inventory: DHL Developer Portal · odoo/documentation@8a3dab0 · GitHub
[go: up one dir, main page]
Skip to content

Commit 8a3dab0

Browse files
justinmallettejero-odoo
authored and
samueljlieber
committed
[IMP] Inventory: DHL Developer Portal
closes #13135 X-original-commit: 23f5c37 Signed-off-by: Samuel Lieber (sali) <sali@odoo.com> Co-authored-by: Jess Rogers <104637850+jero-odoo@users.noreply.github.com>
1 parent f31322d commit 8a3dab0

File tree

1 file changed

+27
-24
lines changed
  • content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration

1 file changed

+27
-24
lines changed

‎content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials.rst

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,15 @@ least one *shipping method*, the process of :doc:`calculating shipping rates
1616
Enable DHL shipping connector
1717
=============================
1818

19-
Before creating a DHL shipping method, it is necessary to enable the carrier's shipping connector.
20-
To do so, navigate to :menuselection:`Inventory app --> Configuration --> Settings`.
19+
Before creating a DHL shipping method, enable the carrier's shipping connector. To do so, navigate
20+
to :menuselection:`Inventory app --> Configuration --> Settings`.
2121

2222
Scroll down to the :guilabel:`Shipping Connectors` section, and tick the checkbox next to
2323
:guilabel:`DHL Express Connector`. Finally, click :guilabel:`Save` to apply the changes.
2424

25-
Once the connector has been enabled, a :icon:`oi-arrow-right` :guilabel:`DHL Shipping Methods` link
26-
appears below. Click the link to open a page showing all shipping methods configured for DHL.
25+
Once the connector has been enabled, a :icon:`fa-arrow-right` :guilabel:`DHL Shipping Methods` link
26+
appears below the setting. Click the link to open a page showing all shipping methods configured for
27+
DHL.
2728

2829
Configure DHL shipping method
2930
=============================
@@ -44,7 +45,6 @@ Click :guilabel:`New` to open a blank shipping method form. If a shipping method
4445
created, it can be selected from this screen.
4546

4647
.. image:: dhl_credentials/dhl-form.png
47-
:align: center
4848
:alt: The form for a DHL shipping method.
4949

5050
General information
@@ -70,28 +70,21 @@ DHL SiteID, password, and account number
7070
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7171

7272
A DHL SiteID, password, and account number are used to link a DHL account with third-party services,
73-
like Odoo's **Inventory** app. The SiteID and password are different credentials than the ones used
74-
to log in to a DHL account.
73+
like Odoo's **Inventory** app.
7574

76-
To obtain a DHL SiteID, password, and account number, it is necessary to register on the `DHL API
77-
Developer Portal <https://developer.dhl.com/user/register>`_, by filling out the following
78-
information:
79-
80-
- :guilabel:`First name`
81-
- :guilabel:`Last name`
82-
- :guilabel:`Email address`
83-
- :guilabel:`Username`
84-
- :guilabel:`Company Name`
85-
- :guilabel:`Country`
86-
87-
After filling out all of the fields, tick the :guilabel:`I have read and accept the terms of use and
88-
the privacy policy` checkbox, and click :guilabel:`Send` to register.
75+
.. important::
76+
The SiteID and password are different credentials than the ones used to log in to a DHL account.
8977

90-
After registering, a confirmation email is sent to verify the application. Click the link inside the
91-
email to activate the developer portal account, and set a password.
78+
Here are two ways to obtain these DHL account credentials:
9279

93-
This email also includes the account number for the developer portal account. Enter the number in
94-
the :guilabel:`DHL Account Number` field on the shipping method form.
80+
- **If a DHL Express account is available**: Log into the `DHL Developer portal
81+
<https://developer.dhl.com/api-reference/dhl-express-mydhl-api#get-started-section/
82+
user-guide%get-access>`_, and then `request a DHL API account number <https://developer.dhl.
83+
com/form/dhl-express-onboarding>`_.
84+
- **If a DHL Express account is unavailable**: Follow DHL's steps to `obtain a DHL Express account
85+
<https://developer.dhl.com/api-reference/dhl-express-mydhl-api#get-started-section/user-guide%get-
86+
access:~:text=around%20the%20world.-,User%20Guide,-Get%20Access>`_, and then follow the steps in
87+
the previous bullet.
9588

9689
Once the developer portal account has been confirmed, log in to the portal using the username and
9790
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
131124
after validating a delivery order.
132125
- :guilabel:`Dutiable Material`: Enable this option if the shipping method is liable to customs or
133126
other duties.
127+
128+
Turn on the DHL Connection
129+
==========================
130+
131+
Once the DHL connection is set up, use the buttons at the top of the form to turn on or debug the
132+
connection.
133+
134+
- **Unpublished/Published**: turns the connection on or off.
135+
- **Test Environment/Production Environment**: sets whether requests actually get sent to DHL.
136+
- **No Debug/Debug Requests**: determines whether error logging occurs for requests to DHL.

0 commit comments

Comments
 (0)
0