<a class="reference external image-reference" 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.svg"> </a> <a name="integration-with-pingen-com"></a> <h2>Integration with pingen.com</h2> <a name="what-is-pingen-com"></a> <h3>What is pingen.com</h3> <p>Pingen.com is a paid online service. It sends uploaded documents by letter post.</p> <a name="scope-of-the-integration"></a> <h3>Scope of the integration</h3> <p>One can decide, per document / attachment, if it should be pushed to pingen.com. The documents are pushed asynchronously.</p> <p>A second cron updates the informations of the documents from pingen.com, so we know which of them have been sent.</p> <a name="configuration"></a> <h3>Configuration</h3> <p>The authentication token is configured on the company's view. You can also tick a checkbox if the staging environment (<a class="reference external" href="https://stage-api.pingen.com">https://stage-api.pingen.com</a>) should be used.</p> <p>The setup of the 2 crons can be changed as well:</p> <blockquote> <ul class="simple"> <li>Run Pingen Document Push</li> <li>Run Pingen Document Update</li> </ul> </blockquote> <a name="usage"></a> <h3>Usage</h3> <p>On the attachment view, a new pingen.com tab has been added. You can tick a box to push the document to pingen.com.</p> <p>There is 3 additional options:</p> <blockquote> <ul class="simple"> <li>Send: the document will not be only uploaded, but will be also be sent</li> <li>Speed: priority or economy</li> <li>Type of print: color or black and white</li> </ul> </blockquote> <p>Once the configuration is done and the attachment saved, a Pingen Document is created. You can directly access to the latter on the Link on the right on the attachment view.</p> <p>You can find them in <cite>Settings &gt; Customization &gt; Low Level Objets &gt; Pingen Documents</cite> or in the more convenient <cite>Documents</cite> menu if you have installed the <cite>document</cite> module.</p> <a name="errors"></a> <h3>Errors</h3> <p>Sometimes, pingen.com will refuse to send a document because it does not meet its requirements. In such case, the document's state becomes &quot;Pingen Error&quot; and you will need to manually handle the case, either from the pingen.com backend, or by changing the document on OpenERP and resolving the error on the Pingen Document.</p> <p>When a connection error occurs, the action will be retried on the next scheduler run.</p> <a name="dependencies"></a> <h3>Dependencies</h3> <blockquote> <ul class="simple"> <li>Require the Python library <a class="reference external" href="http://docs.python-requests.org/">requests</a></li> <li>The PDF files sent to pingen.com have to respect some <a class="reference external" href="https://stage-app.pingen.com/resources/pingen_requirements_v1_en.pdf">formatting rules</a>.</li> <li>The address must be in a format accepted by pingen.com: the last line is the country in English or German.</li> </ul> </blockquote> <a name="bug-tracker"></a> <h3>Bug Tracker</h3> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/report-print-send/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 feedback.</p> <a name="credits"></a> <h3>Credits</h3> <a name="contributors"></a> <h3>Contributors</h3> <ul class="simple"> <li>Guewen Baconnier &lt;<a class="reference external" href="mailto:guewen.baconnier&#64;camptocamp.com">guewen.baconnier&#64;camptocamp.com</a>&gt;</li> <li>Anar Baghirli &lt;<a class="reference external" href="mailto:a.baghirli&#64;mobilunity.com">a.baghirli&#64;mobilunity.com</a>&gt;</li> <li>Akim Juillerat &lt;<a class="reference external" href="mailto:akim.juillerat&#64;camptocamp.com">akim.juillerat&#64;camptocamp.com</a>&gt;</li> </ul> <a name="maintainer"></a> <h3>Maintainer</h3> <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>This module is maintained by the OCA.</p> <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>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>