From fccd4e5d881c69510fd51f412cd4b9a660f8a6fe Mon Sep 17 00:00:00 2001 From: "John Holton (hojo)" Date: Wed, 24 Jul 2024 16:29:56 -0700 Subject: [PATCH] [ADD] Inventory: FedEx integration closes odoo/documentation#10331 Signed-off-by: John Holton (hojo) --- .../setup_configuration.rst | 1 + .../setup_configuration/fedex.rst | 174 ++++++++++++++++++ .../setup_configuration/fedex/fedex-form.png | Bin 0 -> 40834 bytes .../setup_configuration/fedex/fsm-button.png | Bin 0 -> 6242 bytes 4 files changed, 175 insertions(+) create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex.rst create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fedex-form.png create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fsm-button.png diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration.rst b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration.rst index e45ce6f9b..651a94967 100644 --- a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration.rst +++ b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration.rst @@ -12,6 +12,7 @@ Setup and configuration setup_configuration/labels setup_configuration/bpost setup_configuration/dhl_credentials + setup_configuration/fedex setup_configuration/sendcloud_shipping setup_configuration/starshipit_shipping setup_configuration/ups_credentials diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex.rst b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex.rst new file mode 100644 index 000000000..3b98d05ec --- /dev/null +++ b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex.rst @@ -0,0 +1,174 @@ +================= +FedEx integration +================= + +Integrating a FedEx account with Odoo's **Inventory** app makes it possible to :doc:`calculate +shipping rates `, and :doc:`generate shipping labels ` within Odoo. This is +accomplished by enabling the FedEx *shipping connector*, then configuring at least one *shipping +method*. + +.. note:: + This documentation contains configuration details specific to FedEx integration. See the + documentation on :doc:`third-party shippers ` for general shipper + integration instructions. + +Enable shipping connector +========================= + +To enable the shipping connector for FedEx, navigate to :menuselection:`Inventory app --> +Configuration --> Settings`. Scroll down to the :guilabel:`Shipping Connectors` section, and tick +the checkbox next to :guilabel:`FedEx Connector`. + +Finally, click :guilabel:`Save` to save the changes. After doing so, a :icon:`oi-arrow-right` +:guilabel:`FedEx Shipping Methods` button appears below :guilabel:`FedEx Connector`. + +.. image:: fedex/fsm-button.png + :align: center + :alt: The FedEx Shipping Methods button below the FedEx Connector. + +Configure shipping method +========================= + +Once the FedEx shipping connector is enabled, it is necessary to configure at least one shipping +method. After doing so, the shipping method can be included in sales orders (SOs), and used to +compute shipping costs, and print shipping labels. + +To enable a shipping method, navigate to :menuselection:`Inventory app --> Configuration --> +Settings`, and click the :guilabel:`FedEx Shipping Methods` button below the :guilabel:`FedEx +Connector` checkbox. Doing so opens a page that shows all existing FedEx shipping methods. + +.. note:: + To see all shipping methods for every shipper with a connector enabled, navigate to + :menuselection:`Inventory app --> Configuration --> Shipping Methods`. + +Select a shipping method to open its form. Alternatively, click :guilabel:`New` to open a blank +form, and configure a new shipping method. + +.. image:: fedex/fedex-form.png + :align: center + :alt: The form for a FedEx shipping method. + +.. important:: + Enabling the FedEx shipping connector automatically creates two default shipping methods: + :guilabel:`FedEx US` and :guilabel:`FedEx International`. Each of these methods are + pre-configured with test credentials, allowing them to be used for testing purposes. + + Before the shipping method can be used to create actual shipments, the test credentials must be + replaced with credentials from a valid FedEx account. + +General information +------------------- + +At the very top of a shipping method form are fields used to configure the way the method operates +in Odoo. In the :guilabel:`Provider` field, select :guilabel:`FedEx` from the drop-down menu, if it +is not already selected. + +The rest of the fields in this section are general to all shipping providers. For details on how to +fill them out, see the documentation on :doc:`third-party shippers `. + +Fedex Configuration tab +----------------------- + +The options in the :guilabel:`Fedex Configuration` tab of a FedEx shipping method form are used to +connect the method to a FedEx account, and configure the shipping details associated with the method +(drop-off type, package type, etc.). + +A FedEx business account is required to obtain the information needed to fill out the fields in this +tab. To create a new account, navigate to FedEx's `Open Account +`_ page, click on :guilabel:`Create Account`, and +follow the instructions. + +Developer Key and Meter Number fields +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A *developer key* is used to integrate a FedEx account with an external service, like the Odoo +**Inventory** app. A *meter number* is a unique ID number used by FedEx to identify negotiated +shipping rates for each account. + +To get a developer key and meter number, begin by navigating to FedEx's `Developer Resource Center +`_. Then, click on the :guilabel:`FedEx Web +Services` drop-down menu. + +Click :guilabel:`Get Test Key` to start the process of getting a developer key and meter number +which can be used to configure a shipping method for testing purposes. + +Click :guilabel:`Get Production Key` to start the process of getting a developer key and meter +number, which can be used to configure a shipping method that generates real shipments with FedEx. + +After clicking either option, follow the instructions until the :guilabel:`Confirmation` screen is +reached. This screen displays the developer key and meter number. + +Once the developer key and meter number are determined, enter them in the :guilabel:`Developer Key` +and :guilabel:`Meter Number` fields on the :guilabel:`Fedex Configuration` tab of the shipping +method form. + +Password and Account Number fields +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A *password* is used, along with a username, to log into a FedEx account. An *account number* is the +unique number assigned to each FedEx account. + +To find a FedEx account number, log in to a FedEx account at https://www.fedex.com. Click on the +account holder's name in the top-right corner of the screen, and select :menuselection:`My Profile` +from the drop-down menu. + +On the profile page, click :guilabel:`Account Management` on the left side of the screen. The +account number is displayed on this screen. + +Once the password and account number are determined, enter them in the :guilabel:`Password` and +:guilabel:`Account Number` fields on the :guilabel:`Fedex Configuration` tab of the shipping method +form. + +Shipping details +~~~~~~~~~~~~~~~~ + +The main section of the :guilabel:`Fedex Configuration` tab includes a number of additional fields +used provide information about the shipping method: + +- :guilabel:`Fedex Service Type`: The FedEx service used to ship a package. +- :guilabel:`Fedex Drop-Off Type`: The method for getting a package into FedEx's possession. +- :guilabel:`Fedex Package Type`: The type of package used for the shipping method. +- :guilabel:`Package Weight Unit`: The unit of measure used to weigh packages. +- :guilabel:`Package Length Unit`: The unit of measure used to determine the dimensions of packages. +- :guilabel:`Label Type`: The type of shipping label used for packages. +- :guilabel:`Label Format`: The file format used by Odoo to generate shipping labels. +- :guilabel:`Commercial Invoice Type`: The dimensions and type of the paper used to print invoices. + +.. important:: + The options that should be selected on the :guilabel:`Fedex Configuration` tab of a shipping + method depend on the negotiated shipping services of the associated FedEx account. To confirm the + available services for a FedEx account, visit the *Account Management* page after logging in to + the FedEx website, or speak with a customer service representative. + +Options section +~~~~~~~~~~~~~~~ + +The :guilabel:`Options` section of the :guilabel:`Fedex Configuration` tab provides a few additional +options to further configure the shipping method: + +- :guilabel:`Saturday Delivery`: Tick the checkbox to allow packages shipped with the delivery + method to be delivered on Saturdays. +- :guilabel:`Generate Return Label`: Tick the checkbox to automatically generate a return label upon + validation of a delivery order. +- :guilabel:`Duties paid by`: Use the drop-down menu to select whether duty charges should be paid + by the :guilabel:`Sender` or :guilabel:`Recipient`. + +Activate shipping method +======================== + +By default, shipping methods in Odoo are created within a *test environment*. This means they can +only be used for testing purposes, and are unable to generate actual shipping orders. + +To activate a shipping method in a *production environment*, click the :icon:`fa-stop` +:guilabel:`Test Environment` smart button at the top of the shipping method form. After doing so, +the smart buttons changes to read :icon:`fa-play` :guilabel:`Production Environment`. + +With the production environment enabled, validating a delivery order using the shipping method +generates an actual shipping label with FedEx. + +Click the :icon:`fa-play` :guilabel:`Production Environment` smart button to return the shipping +method to a test environment. + +.. warning:: + **Do not** enable the production environment for a shipping method before it is ready to be used + for actual shipping orders. Doing so may lead to the creation of unwanted charges with FedEx. diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fedex-form.png b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fedex-form.png new file mode 100644 index 0000000000000000000000000000000000000000..9b7139c9431d2e7e2767ff68cafbd9e8ffe063e7 GIT binary patch literal 40834 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%0DxotxhRS4 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 V{<)a@u?*yiilVwgwY+)Qe*j)##0>xd literal 0 HcmV?d00001 diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fsm-button.png b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex/fsm-button.png new file mode 100644 index 0000000000000000000000000000000000000000..707be4ae1112df7f327fa92ef145c8197ae05332 GIT binary patch literal 6242 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