<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/16.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-16-0/delivery-carrier-16-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/16.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 &gt; Technical &gt; 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 customer_delivered:</p> <blockquote> <ol class="arabic simple"> <li>Go to <em>Inventory &gt; Configuration &gt; Settings</em>.</li> <li>Enable the option <em>Email Confirmation (customer delivered)</em>.</li> <li>Choose the template &quot;Delivery: Picking delivered by Email&quot;.</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>Incident</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:%2016.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 &lt;<a class="reference external" href="mailto:roberto&#64;trey.es">roberto&#64;trey.es</a>&gt;</li> </ul> </li> <li><a class="reference external" href="https://www.factorlibre.com">FactorLibre</a>:<ul> <li>Zahra Velasco &lt;<a class="reference external" href="mailto:zahra.velasco&#64;factorlibre.com">zahra.velasco&#64;factorlibre.com</a>&gt;</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> <li>Víctor Martínez</li> </ul> </li> <li>Marçal Isern &lt;<a class="reference external" href="mailto:marsal.isern&#64;qubiq.es">marsal.isern&#64;qubiq.es</a>&gt;</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/16.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>