Author: |
Nitrokey GmbH, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
15.0-mig-carrier_deutsche_post |
Repository: |
Nitrokey/odoo-delivery-carrier |
Dependencies: |
base,
base_delivery_carrier_label,
delivery,
and
stock |
Languages: |
HTML (350, 15.8%),
JavaScript (34, 1.5%),
Python (657, 29.7%),
XML (1108, 50.1%),
and
reStructuredText (64, 2.9%) |
Other branches: |
12.0 |
Other repositories: |
DavidNitro/delivery-carrier,
and
Nitrokey/odoo-modules |
<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/15.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-15-0/odoo-modules-15-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 "products" 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 "Buy Deutsche Post Label" 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 -> Configuration -> 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 -> Configuration -> 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 -> click on a Sales Order -> Delivery -> 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:%2015.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/15.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>