Banking / Bank Details

Module: spp_banking

Overview

The OpenSPP Banking module extends Odoo's standard bank account management to support IBAN generation for registrants. It enables social protection programs to capture and validate beneficiary bank details for payment disbursement.

Purpose

This module is designed to:

• Capture bank details: Store bank account information for individuals and groups

• Generate IBANs: Automatically compute International Bank Account Numbers

• Validate accounts: Ensure bank details are properly formatted

• Support payments: Enable payment disbursement to beneficiary accounts

Module Dependencies

Dependency	Purpose
spp_security	Central security definitions for OpenSPP modules
base	Odoo core framework
mail	Communication and activity tracking
contacts	Base contact model extension
spp_registry	Consolidated registry management for individuals, groups,...

External Dependencies

Package	Purpose
schwifty

Key Features

IBAN Generation

The module automatically generates IBANs based on:

Input	Description
Country Code	From the linked bank's country
Bank Code (BIC)	Bank Identifier Code
Account Number	Local account number

The computation uses the schwifty library to generate valid IBANs following international standards.

Bank Account Fields

The module extends res.partner.bank with:

Field	Description
Account Number	Standard account number
Bank	Linked bank record
IBAN	Computed International Bank Account Number

Automatic Computation

The IBAN is automatically recomputed when:

• Account number changes

• Bank reference changes

• Bank's country or BIC is updated

Integration

With spp_registry

Bank accounts can be associated with:

• Individual registrants

• Group/household registrants

• Any partner record in the system

With Payment Systems

The module provides the foundation for:

• Cash transfer programs

• Direct deposit disbursements

• Payment reconciliation

Configuration

Adding Bank Details to a Registrant

Navigate to the registrant's form and add bank account details:

Field	Required	Description
Bank	Yes	Select or create bank
Account Number	Yes	Local account number
Account Holder	Auto	Links to the registrant

The IBAN is computed automatically if:

1. The bank has a country assigned

2. The bank has a BIC code

3. The account number is provided

Bank Configuration

Each bank record needs:

Field	Description
Name	Bank name
BIC/SWIFT	Bank Identifier Code
Country	Bank's country

Views

The module adds bank details views for:

• Individual registrants

• Group registrants

These views integrate with the standard registrant forms.