From 6ff18f2fa194c283c3b8cff5a486b4bd7cd52bb2 Mon Sep 17 00:00:00 2001 From: erjer-odoo Date: Fri, 20 Feb 2026 00:11:54 +0000 Subject: [PATCH] [ADD] Inventory: Easypost delivery method closes odoo/documentation#16509 X-original-commit: 28a68f7830875397c07f6d49a2cbd126107a4d90 Signed-off-by: Erin Jerison (erjer) --- .../setup_configuration.rst | 1 + .../setup_configuration/easypost.rst | 121 ++++++++++++++++++ .../easypost/default-package-type-service.png | Bin 0 -> 4363 bytes .../easypost/easypost-api-keys.png | Bin 0 -> 29744 bytes .../load-easypost-carrier-accounts.png | Bin 0 -> 12511 bytes .../third_party_shipper.rst | 2 +- 6 files changed, 123 insertions(+), 1 deletion(-) create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost.rst create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/default-package-type-service.png create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/easypost-api-keys.png create mode 100644 content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/load-easypost-carrier-accounts.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 420fd323fd..72e1834121 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 @@ -102,6 +102,7 @@ supports. setup_configuration/labels setup_configuration/bpost setup_configuration/dhl_credentials + setup_configuration/easypost setup_configuration/envia_shipping setup_configuration/fedex setup_configuration/sendcloud_shipping diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost.rst b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost.rst new file mode 100644 index 0000000000..b15870cd0e --- /dev/null +++ b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost.rst @@ -0,0 +1,121 @@ +==================== +EasyPost integration +==================== + +Set up the EasyPost delivery connector in Odoo to manage EasyPost shipments to clients directly +within Odoo. + +EasyPost is a service that allows users to connect with multiple carriers, like UPS, USPS, FedEx, +DHL, and more. Odoo can then connect to EasyPost to purchase labels from those carriers. + +To configure it, complete these steps: + +#. :ref:`Create an EasyPost account `. +#. :ref:`Integrate carrier accounts if the carrier is not enabled on the EasyPost account + `. +#. :ref:`Obtain Test and Production API keys `. +#. :ref:`Set up the delivery method in Odoo `. + +Upon completion, it is possible to calculate shipping costs based on package size and weight, have +the charges applied directly to an EasyPost business account, and automatically print EasyPost +tracking labels in Odoo. + +.. _inventory/shipping_receiving/easypost-account: + +Account setup +============= + +To begin, go to the `EasyPost `__ website to create or log into the +company's EasyPost business account. + +Follow the website's steps to complete registration and sign up for shipping services. Some shipping +services (like USPS and DHL Express) are automatically enabled. + +.. _inventory/shipping_receiving/integrate-easypost-carrier: + +Integrating other carrier accounts +---------------------------------- + +To use a different carrier, it is possible to `enable Wallet Carrier Accounts +`__ +to purchase labels from EasyPost. Alternatively, if a user has their own carrier account, they can +`enable it on EasyPost +`__. +Then, after these accounts are enabled, Odoo can integrate with the EasyPost account and manage +labels. + +.. _inventory/shipping_receiving/easypost-api-keys: + +Obtain Test and Production API keys +----------------------------------- + +After completing the setup, create Test and Production API keys. On the EasyPost website, click the +:guilabel:`Account Settings` link, then open the :guilabel:`API Keys` page. + +If these API keys have not yet been created, click :guilabel:`Add Additional API Key`. Select either +:guilabel:`Production` or :guilabel:`Test`. The API key is automatically created. Follow the same +process to create both keys. + +.. image:: easypost/easypost-api-keys.png + :alt: Create API keys on the EasyPost API Keys page. + +.. _inventory/shipping_receiving/easypost-method: + +Delivery method configuration +============================= + +With those necessary credentials, configure the EasyPost delivery method in Odoo by going to +:menuselection:`Inventory app --> Configuration --> Delivery Methods`. + +On the *Delivery Methods* page, click :guilabel:`New`. + +In the :guilabel:`Provider` field, select :guilabel:`Easypost` from the drop-down menu. Doing so +reveals the *Easypost Configuration* tab at the bottom of the form, where the EasyPost API keys +should be entered. + +For details on configuring the other fields on the delivery method, such as :guilabel:`Delivery +Product`, refer to the :doc:`new_delivery_method` documentation. + +.. note:: + To generate EasyPost shipping labels through Odoo, ensure the :guilabel:`Integration Level` + option is set to :guilabel:`Get Rate and Create Shipment`. + +In the *Easypost Configuration* tab, complete the following fields: + +- :guilabel:`Test API Key`: the Test API key in the EasyPost Account Settings. +- :guilabel:`Production API Key`: the Production API key in the EasyPost Account Settings. +- :guilabel:`Label Format`: Choose :guilabel:`PNG`, :guilabel:`PDF`, :guilabel:`ZPL`, or + :guilabel:`EPL2` from the drop-down menu. +- :guilabel:`Generate Return Label`: Select to automatically generate a return label when validating + the delivery. + +Save the delivery method by clicking the :icon:`fa-cloud-upload` :guilabel:`(Save manually)` icon. + +Click the :guilabel:`Load your Easypost carrier accounts` link under the API keys. + +.. image:: easypost/load-easypost-carrier-accounts.png + :alt: Load the EasyPost carrier accounts into Odoo. + +The *Select a carrier* pop-up window opens. Select a shipping carrier from the drop-down menu, then +click :guilabel:`Select`. + +After the carrier type has been selected, complete the :guilabel:`Default Package Type` and +:guilabel:`Default Service Level` fields. + +.. image:: easypost/default-package-type-service.png + :alt: Select a package type and service level that should be used for the carrier. + +Turn on the Easypost integration +================================ + +After the EasyPost connection is set up, use the smart buttons at the top of the form to publish, +turn on production mode, or activate debug logging. + +- :guilabel:`Unpublished/Published`: determines if this delivery method is available on the user's + **eCommerce** website. +- :guilabel:`Test Environment/Production Environment`: determines whether label creation is for + testing and cancelled immediately (Test) or generating a real shipping label that is charged to + the EasyPost account (Production). +- :guilabel:`No Debug/Debug Requests`: determines whether API requests and responses are logged in + Odoo (turn on **developer mode** and go to :menuselection:`Settings app --> Technical --> + Logging`). diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/default-package-type-service.png b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/default-package-type-service.png new file mode 100644 index 0000000000000000000000000000000000000000..63dd3d2510ccb79911b80dacaecce3469b8d607c GIT binary patch literal 4363 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 literal 0 HcmV?d00001 diff --git a/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/easypost-api-keys.png b/content/applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/easypost/easypost-api-keys.png new file mode 100644 index 0000000000000000000000000000000000000000..888509984c4464356329fc705c683969d4e93125 GIT binary patch literal 29744 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 - Belgium - * - Easypost + * - :doc:`EasyPost ` - North America * - Shiprocket - India