<h1 class="title">Delivery Carrier Deutsche Post</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/odoo-modules/tree/12.0/carrier_deutsche_post"><img alt="OCA/odoo-modules" src="https://img.shields.io/badge/github-OCA%2Fodoo--modules-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/odoo-modules-12-0/odoo-modules-12-0-carrier_deutsche_post"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a></p> <p>This custom module carrier_deutsche_post allows to purchase shipping label from Deutsche Post (German Post) directly in Odoo. Several &quot;products&quot; of Deutsche Post can be configured.</p> <p>Appropriate delivery orders (in module Warehouse) show a Buy Deutsche Post Label button. When clicking that button, a shipping label from Deutsche Post is bought online. It is presented to the user as PDF and also attached to the delivery order. For international shipments this PDF can contain a 2nd page with an automatic generated CN 22 form. The CN 22 form is filled by carrier_deutsche_post automatically, depending on the products being shipped.</p> <p>The Buy Deutsche Post Label button is also displayed in Barcode view.</p> <p>Required settings: Button &quot;Buy Deutsche Post Label&quot; is being invisible when carrier_type field is False. carrier_type is a related field so make sure that you set the Default Carrier in picking and Type in that Carrier (Delivery Method).</p> <p>To setup carrier accounts go to Inventory -&gt; Configuration -&gt; Carrier Accounts</p> <img alt="images/1_carrier_accounts.png" src="images/1_carrier_accounts.png" /> <p>Click on Create to create carrier accounts</p> <img alt="images/2_settings_carrier_accounts.png" src="images/2_settings_carrier_accounts.png" /> <p>If you want to edit the delivery methods go to Inventory -&gt; Configuration -&gt; Delivery Methods</p> <img alt="images/3_delivery_methods.png" src="images/3_delivery_methods.png" /> <p>Click on Create to create delivery methods</p> <img alt="images/4_settings_delivery_methods.png" src="images/4_settings_delivery_methods.png" /> <p>To purchase a Deutsche Post label go to Sales -&gt; click on a Sales Order -&gt; Delivery -&gt; Buy Deutsche Post label</p> <img alt="images/5_buy_label.png" src="images/5_buy_label.png" /> <p>Bought Deutsche Post labels are attached to delivery orders in tab Additional Info</p> <img alt="images/6_attachment.png" src="images/6_attachment.png" /> <p>PDF label germany</p> <img alt="images/7_germany.png" src="images/7_germany.png" /> <p>PDF label international</p> <img alt="images/8_international.png" src="images/8_international.png" /> <p><strong>Operations</strong></p> <p>The API of Deutsche Post requires to provide prices within requests. Deutsche Post changes their prices every few months. Prices are not gathered dynamically but are hard coded in <a class="reference external" href="https://pypi.org/project/inema/">inema library</a>. Inema supports multiple price lists in parallel but (Python) requires a restart to take those new price lists into account. In consequence, this means for operation:</p> <ol class="arabic simple"> <li>Monitor price changes of Deutsche Post. Usually when being a Portokasse customer, you should receive an email a few weeks in advance with a new price list (CSV) attached.</li> <li>Make sure the new prices are added to inema and that inema version is ideally released. Usually inema's maintainers are helpful in updating those promptly.</li> <li>Update your Odoo system with the required inema version.</li> <li>At the day when new prices come into affect, restart your Odoo system.</li> </ol> <p>If you receive an unknown error, there is a high chance that it's related to an invalid price.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#bug-tracker" id="id1">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id2">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id3">Authors</a></li> <li><a class="reference internal" href="#maintainers" id="id4">Maintainers</a></li> </ul> </li> </ul> </div> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id1">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/odoo-modules/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/odoo-modules/issues/new?body=module:%20carrier_deutsche_post%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="#id2">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id3">Authors</a></h3> <ul class="simple"> <li>Nitrokey GmbH</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id4">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/odoo-modules/tree/12.0/carrier_deutsche_post">OCA/odoo-modules</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>