Author: |
Trey (www.trey.es), FactorLibre, Tecnativa, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0-delivery_carrier_default_tracking_url-sbj |
Repository: |
acsone/delivery-carrier |
Dependencies: |
delivery |
Languages: |
HTML (409, 42.2%),
PO File (127, 13.1%),
Python (214, 22.1%),
XML (94, 9.7%),
and
reStructuredText (125, 12.9%) |
Other branches: |
12.0,
13.0-mig-delivery_auto_refresh,
13.0-mig-delivery_dropoff_site,
13.0-slg_master,
14-delivery_carrier_default_tracking_url-xbo,
14.0-abi_master,
14.0-add-delivery_zone_zip-dro,
14.0-add-partner_delivery_zone_calendar-dro,
14.0-mig-delivery_carrier_category,
14.0-upd-template-dro,
16-mig-delivery-carrier-label-and-split,
16.0-add-delivery_number_package_theoretical-hda,
16.0-add-delivery_package_number_theoretical-hda,
16.0-imp-stock_picking_delivery_link-hda,
16.0-imp-stock_picking_delivry_link-hda,
16.0-mig-delivery_carrier_label_gls-hda,
16.0-mig-delivery_carrier_max_weight_constraint-hda,
16.0-upd-copier-dro,
and
bai_13.0-partner_delivery_zone_trad_fr |
Other repositories: |
Change2improve/delivery-carrier,
Comunitea/delivery-carrier,
Digital5-Odoo/delivery-carrier,
ERPLibre/delivery-carrier,
Gabinete-Digital/delivery-carrier,
Ingeos/delivery-carrier,
NeatNerdPrime/delivery-carrier,
Nitrokey/odoo-delivery-carrier,
OCA-MUK/delivery-carrier,
OCA/delivery-carrier,
PlanetaTIC/delivery-carrier,
SeuMarco/delivery-carrier,
TDu/delivery-carrier,
Tecnativa/delivery-carrier,
TristanMozos/delivery-carrier,
aaltinisik/delivery-carrier,
akretion/delivery-carrier,
anhvu-sg/delivery-carrier,
anodino-dev/carrier-delivery,
aurestic/carrier-delivery,
brain-tec/carrier-delivery,
camptocamp/delivery-carrier,
daramousk/delivery-carrier,
grindtildeath/delivery-carrier,
guewen/carrier-delivery,
gurneyalex/carrier-delivery,
jcoux/delivery-carrier,
lideritjnma/delivery-carrier,
odoospace/delivery-carrier,
rlizana/delivery-carrier,
santostelmo/delivery-carrier,
sebalix/delivery-carrier,
sendalpegat/delivery-carrier,
sunflowerit/delivery-carrier,
sygel-technology/delivery-carrier,
victoralmau/delivery-carrier,
wahello/delivery-carrier,
and
yvaucher/delivery-carrier |
<h1 class="title">Delivery State</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/delivery-carrier/tree/14.0/delivery_state"><img alt="OCA/delivery-carrier" src="https://img.shields.io/badge/github-OCA%2Fdelivery--carrier-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/delivery-carrier-14-0/delivery-carrier-14-0-delivery_state"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/99/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module adds additional functions that will be needed for the carrier
developments. It provides fields to be able to contemplate the tracking states
and also adds a global field so it can have generic states in addition to the
ones carrier gives us.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id4">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id5">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id6">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>A scheduled action for automating the tracking update for these pickings can be
configured going to <em>Settings > Technical > Scheduled Actions</em> and then choosing
<em>Update deliveries states</em>. It will update the pending delivery states for the
pickings with service providers with tracking methods configured, and in pending
state (not delivered or cancelled).</p>
<p>In order to send automatic notifications to the customer when the picking is
confirmed:</p>
<blockquote>
<ol class="arabic simple">
<li>Go to <em>Inventory > Configuration > Settings</em>.</li>
<li>Enable the option <em>Email Confirmation</em>.</li>
<li>Choose the template "Delivery State Notification to Customer".</li>
</ol>
</blockquote>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>Depending on the delivery service provider, the state tracking could be more or
less complete, since it could have or not the necessary API calls implemented.</p>
<p>With regular methods (fixed, based on rules):</p>
<blockquote>
<ol class="arabic simple">
<li>Go to Inventory / Operations and open an outgoing pending picking.</li>
<li>In the <em>Additional Info</em> tab, assign it a delivery carrier which is fixed or
based on rules.</li>
<li>Validate the picking and you'll see in the same tab the delivery state
info with the shipping date and the shipping state.</li>
<li>If enabled, an automatic notification will be sent to the picking customer.</li>
</ol>
</blockquote>
<p>When service provider methods are implemented, we can follow the same steps as
described before, but we'll get additionally:</p>
<blockquote>
<ol class="arabic">
<li><p class="first">In the <em>Additional Info</em> tab, we'll see button <em>Update tracking state</em> to
manually query the provider API for tracking updates for this expedition.</p>
</li>
<li><p class="first">Depending on the stated returned by the provider, we could get these
states (field <em>Carrier State</em>):</p>
<blockquote>
<ul class="simple">
<li>Shipping recorded in carrier</li>
<li>In transit</li>
<li>Canceled shipment (finished)</li>
<li>Incidence</li>
<li>Warehouse delivered</li>
<li>Customer delivered (finished)</li>
</ul>
</blockquote>
</li>
<li><p class="first">In the field <em>Tracking state</em> we'll get the tracking state name given by
the provider (which is mapped to the ones in this module)</p>
</li>
<li><p class="first">In the field <em>Tracking history</em> we'll get the former states log.</p>
</li>
</ol>
</blockquote>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id3">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/delivery-carrier/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/delivery-carrier/issues/new?body=module:%20delivery_state%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id4">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id5">Authors</a></h3>
<ul class="simple">
<li>Trey (www.trey.es)</li>
<li>FactorLibre</li>
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id6">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://www.trey.es">Trey</a>:<ul>
<li>Roberto Lizana <<a class="reference external" href="mailto:roberto@trey.es">roberto@trey.es</a>></li>
</ul>
</li>
<li><a class="reference external" href="https://www.factorlibre.com">FactorLibre</a>:<ul>
<li>Zahra Velasco <<a class="reference external" href="mailto:zahra.velasco@factorlibre.com">zahra.velasco@factorlibre.com</a>></li>
</ul>
</li>
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Pedro M. Baeza</li>
<li>David Vidal</li>
</ul>
</li>
<li>Marçal Isern <<a class="reference external" href="mailto:marsal.isern@qubiq.es">marsal.isern@qubiq.es</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id7">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/delivery-carrier/tree/14.0/delivery_state">OCA/delivery-carrier</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>