Author: |
LasLabs |
License: |
AGPL-3 |
Branch: |
feature/10.0/LABS-376-upgrade-connector_easypost-to-v10 |
Repository: |
Alexandre-Bernardes/odoo-connector-easypost |
Dependencies: |
base,
base_delivery_carrier_label,
connector,
stock,
stock_package_info,
and
stock_picking_rate |
Languages: |
Python (2246, 77.0%),
SVG (1, 0.0%),
XML (600, 20.6%),
and
reStructuredText (71, 2.4%) |
Other branches: |
10.0,
and
9.0 |
Other repositories: |
LasLabs/odoo-connector-easypost,
OutillageStEtienne/odoo-connector-easypost,
TimLai125/odoo-connector-easypost,
difra/odoo-connector-easypost,
niulinlnc/odoo-connector-easypost,
sasakuma/odoo-connector-easypost,
sc4you/odoo-connector-easypost,
and
somair/odoo-connector-easypost |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/license-AGPL--3-blue.svg">
</a>
<a name="easypost-connector"></a>
<h2>EasyPost Connector</h2>
<p>This module provides EasyPost connector functionality.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>To install this module, you need to:</p>
<ul class="simple">
<li>Install Python dependencies -
<code>pip install easypost</code></li>
<li>Install OCA Connector module from <a class="reference external" href="https://github.com/OCA/connector">https://github.com/OCA/connector</a></li>
<li>Since we are not using OCA/stock-logistics-workflow/9.0, you must clone
<code>stock-logistics-workflow</code> from <a class="reference external" href="https://github.com/laslabs/stock-logistics-workflow.git">https://github.com/laslabs/stock-logistics-workflow.git</a>
and checkout the <code>feature/9.0/LABS-187-migrate-connectoreasypost-to-oca</code> branch.
You will be able to use OCA stock-logistics-workflow once the following MRs are merged to 9.0:
<a class="reference external" href="https://github.com/OCA/stock-logistics-workflow/pull/247">https://github.com/OCA/stock-logistics-workflow/pull/247</a>
<a class="reference external" href="https://github.com/OCA/stock-logistics-workflow/pull/238">https://github.com/OCA/stock-logistics-workflow/pull/238</a></li>
<li>Clone OCA/carrier-delivery/9.0 from <code>https://github.com/OCA/carrier-delivery.git</code>
and install <code>base_delivery_carrier_label</code></li>
<li>Install Easypost Connector module</li>
<li>Restart Odoo (requirement of any new connector to set proper DB triggers)</li>
</ul>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>To configure this module, you need to:</p>
<ul class="simple">
<li>Go to <code>Connectors => [EasyPost] Backends</code></li>
<li>Configure one EasyPost backend per company you would like to use with</li>
</ul>
<a name="usage"></a>
<h3>Usage</h3>
<a name="predefined-packages"></a>
<h3>Predefined Packages</h3>
<ul class="simple">
<li>Predefined packages will automatically be added to Packaging templates upon</li>
</ul>
<blockquote>
module install</blockquote>
<a name="address-verification"></a>
<h4>Address Verification</h4>
<ul class="simple">
<li>Edit a partner in backend form view</li>
<li>Click <code>Validate</code> button above street address</li>
<li>Click <code>Confirm</code> button to validate address is correct, or <code>Cancel</code> to cancel</li>
</ul>
<p>Note that the address change will be made immediately after hitting <code>Confirm</code>,
regardless of whether you save the partner or not.</p>
<a name="rate-purchases"></a>
<h4>Rate Purchases</h4>
<ul class="simple">
<li>Put products into a package</li>
<li>Assign a packaging template to that package</li>
<li>Click the <code>Additional Info</code> tab under a Stock Picking to view the Rates.</li>
<li>Click the green check button to purchase the rate.</li>
</ul>
<p>Note that you can only purchase a rate after you have moved the picking out of
draft status.</p>
<a name="known-issues-roadmap"></a>
<h3>Known Issues / Roadmap</h3>
<ul class="simple">
<li>Handle validation errors from addresses</li>
<li>Some duplicate calls to EasyPost (Address, Shipment) - seems to be just in the tests though</li>
<li>Add a default EasyPost connection to span all companies</li>
<li>Mass address verification</li>
<li>Label import operates in Shipment context, due to needing selected rate info not within PostageLabel</li>
</ul>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/laslabs/odoo-connector-easypost/issues">GitHub Issues</a>. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
please help us smash it by providing a detailed and welcomed feedback.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="images"></a>
<h4>Images</h4>
<ul class="simple">
<li>LasLabs: <a class="reference external" href="https://repo.laslabs.com/projects/TEM/repos/odoo-module_template/browse/module_name/static/description/icon.svg?raw">Icon</a>.</li>
</ul>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Dave Lasley <<a class="reference external" href="mailto:dave@laslabs.com">dave@laslabs.com</a>></li>
<li>Ted Salmon <<a class="reference external" href="mailto:tsalmon@laslabs.com">tsalmon@laslabs.com</a>></li>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="https://laslabs.com"><img alt="LasLabs Inc." src="https://laslabs.com/logo.png" /></a>
<p>This module is maintained by LasLabs Inc.</p>