Author: |
Tecnativa, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
13.0 |
Repository: |
Change2improve/delivery-carrier |
Dependencies: |
base,
phone_validation,
product,
resource,
and
stock |
Languages: |
HTML (414, 18.4%),
PO File (360, 16.0%),
Python (927, 41.1%),
XML (420, 18.6%),
and
reStructuredText (135, 6.0%) |
Other branches: |
15.0 |
Other repositories: |
Gabinete-Digital/delivery-carrier,
Ingeos/delivery-carrier,
Nitrokey/odoo-delivery-carrier,
OCA/delivery-carrier,
Tecnativa/delivery-carrier,
brain-tec/carrier-delivery,
camptocamp/delivery-carrier,
and
sunflowerit/delivery-carrier |
<h1 class="title">Routific Connector</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Production/Stable" src="https://img.shields.io/badge/maturity-Production%2FStable-green.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/13.0/connector_routific"><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-13-0/delivery-carrier-13-0-connector_routific"><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/13.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module is a connector between Odoo and Routific Platform for allow the
optimization of routes.</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><ul>
<li><a class="reference internal" href="#project-creation" id="id3">Project Creation</a></li>
<li><a class="reference internal" href="#sending-information" id="id4">Sending Information</a></li>
<li><a class="reference internal" href="#getting-solution" id="id5">Getting Solution</a></li>
</ul>
</li>
<li><a class="reference internal" href="#bug-tracker" id="id6">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id7">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id8">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id9">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id10">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>To make the connection with Routific we need to create new entries of the Settings model
on Routific. To make this we have to follow the next steps:</p>
<blockquote>
<ol class="arabic simple">
<li>Go to <em>Routific > Settings</em></li>
<li>Create a new entry</li>
<li>Set a name</li>
<li>Set your Token Key for establish the connection</li>
<li>Select the allowed operation type for filter the pickings</li>
</ol>
</blockquote>
<p>The default URLs and address format are correct for Routific Platform connection and
geolocatization, but can be changed if they change sometime.</p>
<p>The options on <em>Project</em> section are the default settings for all the projects created
with this Settings.</p>
<p>We need to define drivers on our instance. We can follow next steps:</p>
<blockquote>
<ol class="arabic simple">
<li>Go to <em>Contacts</em></li>
<li>Create a new one</li>
<li>Check the option <strong>Is driver</strong> at <em>Routific</em> section</li>
<li>Check the option <strong>Driver active</strong></li>
</ol>
</blockquote>
<p>If we want to divide the charge filtering by types of products, we can check at
<em>Inventory > Configuration > Attributes</em> what attribute defines the type by checking the
field <strong>Is routific type</strong>. Doing this, now you can select the types allowed by a
driver at Driver's sheet.</p>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<a name="project-creation"></a>
<h3><a class="toc-backref" href="#id3">Project Creation</a></h3>
<p>For create a project, we can do it by 2 ways:</p>
<p>The fist one is by going to <em>Inventory > Operations > Transfers</em>:</p>
<blockquote>
<ol class="arabic simple">
<li>Select the pickings that has to be served</li>
<li>On <em>Action</em> menu select <em>Create Routific Project</em></li>
<li>Configure what you want</li>
<li>Press <em>Create</em></li>
</ol>
</blockquote>
<p>(Note) By default all active drivers are selected but you can delete the drivers that
you don't need for the delivery.</p>
<p>The second one is by going to <em>Routific > Projects</em>:</p>
<blockquote>
<ol class="arabic simple">
<li>Press <em>Create</em></li>
<li>Select the affected pickings</li>
<li>You can delete the non-needed drivers</li>
<li><em>Save</em> the project</li>
</ol>
</blockquote>
<a name="sending-information"></a>
<h3><a class="toc-backref" href="#id4">Sending Information</a></h3>
<p>Now you can send the information to Routific by pressing the button
<strong>Send information to Routific</strong>.</p>
<p>Once the info is sent to routific, you should optimice the route at
<a class="reference external" href="https://routific.com/">Routific Platform</a></p>
<p>You can add new stops to the route by adding new pickings and clicking to
<em>Send new stops</em></p>
<a name="getting-solution"></a>
<h3><a class="toc-backref" href="#id5">Getting Solution</a></h3>
<p>Now you can get the solution by clicking at <strong>Process solution</strong></p>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id6">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:%20connector_routific%0Aversion:%2013.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="#id7">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id8">Authors</a></h3>
<ul class="simple">
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id9">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Carlos Roca</li>
<li>Sergio Teruel</li>
</ul>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id10">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>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external" href="https://github.com/CarlosRoca13"><img alt="CarlosRoca13" src="https://github.com/CarlosRoca13.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/delivery-carrier/tree/13.0/connector_routific">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>