odoo-addon-ebill-postfinance 16.0.1.0.0.3__py3-none-any.whl

odoo/addons/ebill_postfinance/models/ebill_postfinance_service.py

@@ -0,0 +1,154 @@
+# Copyright 2022 Camptocamp SA
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+import logging
+import logging.config
+
+from ebilling_postfinance import ebilling_postfinance
+
+from odoo import api, fields, models
+from odoo.exceptions import UserError
+
+_logger = logging.getLogger(__name__)
+
+
+class EbillPostfinanceService(models.Model):
+    _name = "ebill.postfinance.service"
+    _description = "Postfinance eBill service configuration"
+
+    name = fields.Char(required=True)
+    username = fields.Char()
+    password = fields.Char()
+    biller_id = fields.Char(string="Biller ID", size=17, required=True)
+    use_test_service = fields.Boolean(string="Testing", help="Target the test service")
+    partner_bank_id = fields.Many2one(
+        comodel_name="res.partner.bank", string="Bank account", ondelete="restrict"
+    )
+    invoice_message_ids = fields.One2many(
+        comodel_name="ebill.postfinance.invoice.message",
+        inverse_name="service_id",
+        string="Invoice Messages",
+        readonly=True,
+    )
+    ebill_payment_contract_ids = fields.One2many(
+        comodel_name="ebill.payment.contract",
+        inverse_name="postfinance_service_id",
+        string="Contracts",
+        readonly=True,
+    )
+    active = fields.Boolean(default=True)
+    file_type_to_use = fields.Selection(
+        string="Invoice Format",
+        default="XML",
+        required=True,
+        selection=[
+            ("XML", "XML Yellow Bill"),
+            ("EAI.XML", "Custom XML (SAPiDoc)"),
+            # ("eai.edi", "Custom EDIFACT"),
+            ("struct.pdf", "Factur X"),
+        ],
+    )
+    use_file_type_xml_paynet = fields.Boolean(
+        string="Use Paynet/SIX format",
+        help="Enable use of legacy SIX/Paynet invoice format.",
+    )
+    operation_timeout = fields.Integer(
+        string="HTTP Timeout",
+        default="600",
+        help="Timeout for each HTTP (GET, POST) request in seconds.",
+    )
+
+    def _get_service(self):
+        return ebilling_postfinance.WebService(
+            self.use_test_service,
+            self.username,
+            self.password,
+            self.biller_id,
+            self.operation_timeout,
+        )
+
+    def test_ping(self):
+        """Test the service from the UI."""
+        self.ensure_one()
+        msg = ["Test connection to service"]
+        res = self.ping_service()
+        if res:
+            msg.append("Success pinging service \n  Receive :{}".format(res))
+        else:
+            msg.append(" - Failed pinging service")
+        raise UserError("\n".join(msg))
+
+    def ping_service(self, test_error=False, test_exception=False):
+        """Ping the service, uses the authentication.
+
+        test_error: will create an unhandled error in the repsonse
+        test_exception: will create a FaultException
+
+        """
+        service = self._get_service()
+        return service.ping()
+
+    def search_invoice(self, transaction_id=None):
+        """Get invoice status from the server.
+
+        transaction_id:
+        """
+        service = self._get_service()
+        res = service.search_invoices(transaction_id)
+        if res.InvoiceCount == 0:
+            _logger.info("Search invoice returned no invoice")
+            return res
+        if res.InvoiceCount < res.TotalInvoiceCount:
+            # TODO handle the case where there is more to download ?
+            _logger.info("Search invoice has more to download")
+        for message in res.InvoiceList.SearchInvoice:
+            _logger.info(f"Found record for message {message}")
+            record = self.invoice_message_ids.search(
+                [("transaction_id", "=", message.TransactionId)],
+                limit=1,
+                order="create_date desc",
+            )
+            if record:
+                record.update_message_from_server_data(message)
+            else:
+                _logger.warning(f"Could not find record for message {message}")
+        return res
+
+    def upload_file(self, transaction_id, file_type, data):
+        service = self._get_service()
+        res = service.upload_files(transaction_id, file_type, data)
+        return res
+
+    def get_invoice_list(self, archive_data=False):
+        service = self._get_service()
+        res = service.get_invoice_list(archive_data)
+        return res
+
+    def get_process_protocol_list(self, archive_data=False):
+        # Is this the processing result of an invoice ?
+        service = self._get_service()
+        res = service.get_process_protocol_list(archive_data)
+        return res
+
+    def get_ebill_recipient_subscription_status(self, recipient_id):
+        service = self._get_service()
+        res = service.get_ebill_recipient_subscription_status(recipient_id)
+        return res
+
+    def get_registration_protocol_list(self, archive_data=False):
+        service = self._get_service()
+        res = service.get_registration_protocol_list(archive_data)
+        for registration_protocol in res or {}:
+            self.get_registration_protocol(registration_protocol.CreateDate)
+        return res
+
+    def get_registration_protocol(self, create_date, archive_data=False):
+        service = self._get_service()
+        res = service.get_registration_protocol(create_date, archive_data)
+        return res
+
+    @api.model
+    def cron_update_invoices(self):
+        services = self.search([])
+        for service in services:
+            service.search_invoice()

odoo/addons/ebill_postfinance/models/sale_order.py

@@ -0,0 +1,19 @@
+# Copyright 2021 Camptocamp SA
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from odoo import api, fields, models
+
+
+class SaleOrder(models.Model):
+
+    _inherit = "sale.order"
+
+    postfinance_ebill_client_order_ref = fields.Char(
+        compute="_compute_postfinance_ebill_client_order_ref"
+    )
+
+    @api.depends("client_order_ref")
+    def _compute_postfinance_ebill_client_order_ref(self):
+        """Compute the customer reference order to allow for glue module."""
+        for order in self:
+            order.postfinance_ebill_client_order_ref = order.client_order_ref

odoo/addons/ebill_postfinance/readme/CONFIGURE.rst

@@ -0,0 +1,13 @@
+Create a service
+================
+
+First you need to be registred on 'Postfinance eBill service <https://www.postfinance.ch/en/business/products/accounts-receivable-solutions/e-bill-invoice-issuer.html>'
+To create a service go to `Accounting - Configuration - Payments - Postfinance eBill Service`
+
+Configure a customer and create his contract
+============================================
+
+The contracts specific to Postfinance e-billing are located in `Accounting - Customers - eBill Postfinance Contract`
+Create a contract for a customer with his PayerId and make sure that the contract is active by being in `Open` state with valid start/end dates.
+
+Set `Customer Invoice Transmission Method` on the customer to Postfinance.

odoo/addons/ebill_postfinance/readme/CONTRIBUTORS.rst

@@ -0,0 +1 @@
+* Thierry Ducrest <thierry.ducrest@camptocamp.com>

odoo/addons/ebill_postfinance/readme/DESCRIPTION.rst

@@ -0,0 +1 @@
+This module implements the exchange of electronic invoices with the Postfinance web service.

odoo/addons/ebill_postfinance/readme/INSTALL.rst

@@ -0,0 +1,2 @@
+This module needs the Python library `ebilling_postfiance` which can be installed from Pypi.
+More information can be found at `<repository https://github.com/camptocamp/ebilling-postfinance>`_.

odoo/addons/ebill_postfinance/readme/ROADMAP.rst

@@ -0,0 +1,10 @@
+ToDo
+
+* Add option to import the contract subscription (csv)
+* Add the download of this csv from web service, but what is the endpoint ?
+
+
+Nice to have
+
+* Add a link to the failed job in the chatter message.
+* Add an action on partner to create a ebilling contract.

odoo/addons/ebill_postfinance/readme/USAGE.rst

@@ -0,0 +1,5 @@
+To use this module, you need to:
+
+#. Configure the service, customers and contracts as described in the CONFIGURATION section.
+#. Create an invoice for a customer with an open Postfinance contract.
+#. Validate the invoice, and click the Send eBill button.

odoo/addons/ebill_postfinance/security/ir.model.access.csv

@@ -0,0 +1,5 @@
+id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_ebill_postfinance_service_user,access.ebill.postfinance.service.user,model_ebill_postfinance_service,base.group_user,1,0,0,0
+access_ebill_postfinance_service_manager,access.postfinance.service.manager,model_ebill_postfinance_service,account.group_account_manager,1,1,1,1
+access_ebill_postfinance_invoice_message_user,access.ebill.postfinance.invoice.message.user,model_ebill_postfinance_invoice_message,base.group_user,1,0,0,0
+access_ebill_postfinance_invoice_message_manager,access.ebill.postfinance.invoice.message.manager,model_ebill_postfinance_invoice_message,account.group_account_manager,1,1,1,1