Search 1.9 billion lines of Odoo code on GitHub
delivery_carrier_label_postlogistics
<h1 class="title">PostLogistics Labels WebService</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/12.0/delivery_carrier_label_postlogistics"><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-12-0/delivery-carrier-12-0-delivery_carrier_label_postlogistics"><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/12.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module uses <a class="reference external" href="https://www.post.ch/en/business/a-z-of-subjects/dropping-off-mail-items/business-sending-letters/sending-consignments-web-service-barcode">PostLogistics BarCodes WebService</a> to generate labels
for your Delivery Orders.</p>
<p>It adds a <cite>Create label</cite> button on Delivery Orders.
A generated label will be an attachement of your Delivery Order.</p>
<p>To see it, please install documents module.</p>
<p>You can create multiple delivery method to match your diffent package types.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#installation" id="id1">Installation</a></li>
<li><a class="reference internal" href="#configuration" id="id2">Configuration</a><ul>
<li><a class="reference internal" href="#technical-references" id="id3">Technical references</a></li>
</ul>
</li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id4">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id5">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id6">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id7">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id8">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id9">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="installation"></a>
<h2><a class="toc-backref" href="#id1">Installation</a></h2>
<p>As a requirement you need to install <cite>suds-jurko</cite> library. It will fail with the
latest and outdated version of <cite>suds</cite>.
<a class="reference external" href="https://pypi.python.org/pypi/suds-jurko/0.6">https://pypi.python.org/pypi/suds-jurko/0.6</a></p>
<p>Furthermore, if you want to use the integration server of Postlogistics
you will have to patch this library with the following patch:</p>
<p><a class="reference external" href="https://fedorahosted.org/suds/attachment/ticket/239/suds_recursion.patch">https://fedorahosted.org/suds/attachment/ticket/239/suds_recursion.patch</a></p>
<p>A copy of this patch is available in <cite>patches</cite> folder of this module.</p>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id2">Configuration</a></h2>
<div class="admonition important">
<p class="first admonition-title">Important</p>
<p>A "Swiss Post Business customer" account is required to use this module.</p>
<p class="last">See <a class="reference external" href="https://account.post.ch/selfadmin/?login&lang=en">Log in</a></p>
</div>
<p>To configure:</p>
<ul class="simple">
<li>Go to <cite>Configurations -> Settings -> Postlogistics</cite></li>
<li>Set your login informations</li>
<li>launch the Update PostLogistics Services</li>
</ul>
<p>This will load available services and generate carrier options.</p>
<p>Now you can create a carrier method for PostLogistics WebService:</p>
<ul class="simple">
<li>First choose a Service group and save</li>
<li>Add a Mandatory Carrier option using a Basic Service</li>
<li>Save Carrier Method (this will update filters to show you only
compatible services)</li>
<li>Then add other <cite>Optional as default</cite> and <cite>Optional</cite> carrier option
from listed</li>
<li>Add additional Service and Delivery instructions</li>
</ul>
<a name="technical-references"></a>
<h3><a class="toc-backref" href="#id3">Technical references</a></h3>
<p><a class="reference external" href="https://www.post.ch/en/business/a-z-of-subjects/dropping-off-mail-items/business-sending-letters/barcode-support">"Barcode" web service documentation</a></p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id4">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Integration of price webservice :
<a class="reference external" href="https://www.post.ch/en/customer-center/all-online-services/preise-berechnen/info">https://www.post.ch/en/customer-center/all-online-services/preise-berechnen/info</a></li>
<li>Not sure if the recursive patch of suds is still needed as there's no need
to use the integration WS anymore. However we still want to patch open to
get meaningful error messages.</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id5">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_carrier_label_postlogistics%0Aversion:%2012.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="#id6">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id7">Authors</a></h3>
<ul class="simple">
<li>Camptocamp</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id8">Contributors</a></h3>
<ul class="simple">
<li>Yannick Vaucher <<a class="reference external" href="mailto:yannick.vaucher@camptocamp.com">yannick.vaucher@camptocamp.com</a>></li>
<li>Guewen Baconnier <<a class="reference external" href="mailto:guewen.baconnier@camptocamp.com">guewen.baconnier@camptocamp.com</a>></li>
<li>Akim Juillerat <<a class="reference external" href="mailto:akim.juillerat@camptocamp.com">akim.juillerat@camptocamp.com</a>></li>
<li>Julien Coux <<a class="reference external" href="mailto:julien.coux@camptocamp.com">julien.coux@camptocamp.com</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id9">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/12.0/delivery_carrier_label_postlogistics">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>