[IMP] pingen: tie up everything with crons

pingen/__openerp__.py

@@ -43,6 +43,53 @@ 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.
+
+Configuration
+-------------
+
+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
+
+Usage
+-----
+
+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 send
+ * 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.
+
+Errors
+------
+
+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.
+
 Dependencies
 ------------
 
@@ -50,16 +97,17 @@ Dependencies
  * The PDF files sent to pingen.com have to respect some `formatting rules
    <https://stage-app.pingen.com/resources/pingen_requirements_v1_en.pdf>`_.
  * The address must be in a format accepted by pingen.com: the last line
-   is the country.
+   is the country in English or German.
 
 """,
  'website': 'http://www.camptocamp.com',
- 'init_xml': [],
- 'update_xml': [
+ 'data': [
      'ir_attachment_view.xml',
      'pingen_document_view.xml',
+     'pingen_data.xml',
+     'res_company_view.xml',
+     'security/ir.model.access.csv',
      ],
- 'demo_xml': [],
  'tests': [],
  'installable': True,
  'auto_install': False,