odoo-addon-fraud-service-disconnection-somconnexio 16.0.1.0.1

Automation of service disconnection due to first invoice defaults (fraud circuit) within the SomConnexió ERP.

Module to automate the fraud circuit for first invoice defaults in Som Connexió.

Table of contents

• Configuration

• Usage

  • 1. Scenario: Receipt of Bank Return (Non-Payment)

  • 2. Scenario: Service Disconnection

  • 3. Scenario: Payment and Reactivation

• Contributors

Configuration

Credential configuration is performed strictly through Environment Variables (standard library mm_proxy_python_client):

• MM_PROXY_BASEURL

• MM_PROXY_USER

• MM_PROXY_PASSWORD

No additional configuration is required in the Odoo dashboard.

Usage

This module proactively detects fraud or early payment defaults (first invoice) and streamline operational actions (service disconnection) and administrative tasks (task generation) without manual intervention.

1. Scenario: Receipt of Bank Return (Non-Payment)

• When the finance department confirms a return (payment.return), the system verifies the customer’s history. If it is their first invoice, it automatically creates a Task in the Fraud project linked to their Contract. This task creation also triggers a mail notification to the insolvent partner, warning them to pay their debt.

2. Scenario: Service Disconnection

• When a cron job detects that the task has been inactive (no payment recieved) for a certain period of time, it triggers an action to disconnect the service. Odoo invokes the ProxyMM Python client. If the API responds correctly, the task status changes to “Disconnected”. This disconnection action can also be triggered manually by the operator through a button in the task form view.

3. Scenario: Payment and Reactivation

• When the customer pays the outstanding debt (invoice reconciliation), the billing team can then trigger the “Reactivate” signal (via Python client) and update the task to “Reactivated”. This allows for quick service restoration when the situation is regularized, improving customer experience.

Contributors

• Som IT Cooperatiu SCCL <https://somit.coop//>

  • Nicolás Ramos [e-mail]

• Som Connexió SCCL <https://somconnexio.coop/>

  • Gerard Funonsas [e-mail]

  • Borja Gimeno [e-mail]