Author: |
LasLabs |
License: |
AGPL-3 |
Branch: |
10.0 |
Repository: |
Alexandre-Bernardes/odoo-connector-easypost |
Dependencies: |
base_delivery_carrier_label,
base_partner_validate_address,
component,
component_event,
connector,
delivery,
delivery_package_wizard,
l10n_us_product,
l10n_us_uom_profile,
queue_job,
sale_delivery_rate,
and
stock_package_info |
Languages: |
Python (2244, 21.9%),
SVG (1, 0.0%),
XML (703, 6.9%),
YAML (7223, 70.5%),
and
reStructuredText (74, 0.7%) |
Other branches: |
9.0,
and
feature/10.0/LABS-376-upgrade-connector_easypost-to-v10 |
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>Look at <code>oca_dependencies.txt</code> in the root of this repo. Modules from
these repos and branches are required for this module. The specific modules
are listed in <code>__manifest__.py</code>. See <a class="reference external" href="https://github.com/OCA/maintainer-quality-tools/blob/master/sample_files/oca_dependencies.txt">here</a> for
more information regarding the syntax of the <code>oca_dependencies.txt</code> file.</li>
<li>Install Easypost Connector module</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 it with</li>
<li>Restart Odoo (requirement of any new connector to set proper DB triggers)</li>
</ul>
<p>If using multiple stock locations, you must make sure to assign the owner of
all warehouse stock locations (<code>warehouse.lot_stock_id</code>) in order for the
correct outbound address to be used.</p>
<p>Note that the <code>weight</code> and <code>volume</code> fields in your products must be accurrate.
If this is not the case, shipping estimations will be incorrect - particularly during
the sale phase.</p>
<a name="usage"></a>
<h3>Usage</h3>
<a name="predefined-packages"></a>
<h4>Predefined Packages</h4>
<ul class="simple">
<li>Predefined packages will automatically be added to Packaging options upon
module install</li>
</ul>
<a name="address-verification"></a>
<h4>Address Verification</h4>
<ul class="simple">
<li>Navigate to any partner</li>
<li>Click the <code>More</code> or <code>Actions</code> menu (depending on Odoo version)</li>
<li>Click <code>Validate Address</code> to trigger the address validation wizard</li>
</ul>
<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>
<li>Only USPS service types are included by default. Everything else is created
the first time rates are gathered.</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>