Integration with pingen.com
What is pingen.com
Pingen.com is a paid online service. It sends uploaded documents by letter post.
Scope of the integration
One can decide, per document / attachment, if it should be pushed to pingen.com. The documents are pushed asynchronously.
A second cron updates the informations of the documents from pingen.com, so we know which of them have been sent.
The authentication token is configured on the company's view. You can also tick a checkbox if the staging environment (https://stage-api.pingen.com) should be used.
The setup of the 2 crons can be changed as well:
- Run Pingen Document Push
- Run Pingen Document Update
On the attachment view, a new pingen.com tab has been added. You can tick a box to push the document to pingen.com.
There is 3 additional options:
- Send: the document will not be only uploaded, but will be also be sent
- Speed: priority or economy
- Type of print: color or black and white
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.
You can find them in Settings > Customization > Low Level Objets > Pingen Documents or in the more convenient Documents menu if you have installed the document module.
Sometimes, pingen.com will refuse to send a document because it does not meet its requirements. In such case, the document's state becomes "Pingen Error" 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.
When a connection error occurs, the action will be retried on the next scheduler run.