Seerbit Odoo Point of Sale

An Odoo Integration for Seerbit POS Terminal

Version: 0.1.5

Note: As of v0.1.5, this module is compatible with Odoo 16.0, 17.0, and 18.0. It uses Firebase Realtime Database for payment requests and reconciliation, replacing the previous webhook-based approach.

How to Use

A user guide is available here

Compatibility

• Odoo 16.0
• Odoo 17.0
• Odoo 18.0

Features

• ✅ Compatible with Odoo 16.0, 17.0, and 18.0
• ✅ Enhanced UI and payment flow for Odoo 18.0
• ✅ Firebase-based payment reconciliation
• ✅ Environment variable configuration
• ✅ Complete payment record creation
• ✅ Comprehensive error handling
• ✅ Test suite (16 tests)
• ✅ Odoo.sh compatible

Version History

[0.1.5] 21/07/2025

Impacted Versions:

• Odoo 16.0, 17.0, 18.0

Changes:

• Odoo 18.0 UI and payment flow enhancements
• Documentation and manifest updated for Odoo 18.0 compatibility

[0.1.3] 07/07/2025

Impacted Versions:

• Odoo16 - 18/04/2023
• Odoo15 - 18/04/2023

Changes:

• Firebase replaces webhooks now for payment reconciliation

[0.1.2] 18/04/2023

Impacted Versions:

• Odoo16 - 18/04/2023
• Odoo15 - 18/04/2023

Changes:

• Elimination of the need of Seerbit account SECRET KEY
• Code refactoring

[0.1.1] 17/04/2023

Impacted Versions:

• Odoo16 - 17/04/2023
• Odoo15 - 17/04/2023

Changes:

• Moved payment matching logic to python layer
• Ensures that latest response gets deleted after consumption

[0.0.1] 30/03/2023

Impacted Versions:

• Odoo16 - 30/03/2023

Changes:

• creates the Seerbit bank journal at installation.
• creates a manual Seerbit payment method at installation.
• listens for Seerbit's notification at your_odoo_url/pos_seerbit/notification.
• requires Seerbit's public key for automatic confirmation.
• introduced waitingSeerbit payment status
• introduced a sensitive action button CSS class named dangerous.
• Cashiers can force payment confirmation while waiting for automatic confirmation.

Seerbit Odoo POS Integration

Firebase-based payment reconciliation for Odoo Point of Sale with Seerbit payment terminals.

🚀 Configuration

After installing the module, you need to configure it from the Odoo settings.

1. Go to Settings > General Settings > Seerbit.
2. Enable the Seerbit Payment Terminal.
3. Obtain your Firebase credentials from Seerbit Seerbit will provide:
   • Firebase Service Account JSON
   • Firebase API Key
   • Firebase Project ID
4. Enter these credentials in the corresponding fields.
5. Click Save.

Important: Only use the credentials provided by Seerbit for your merchant account. Do not attempt to generate your own Firebase credentials.

Seerbit Setup

1. Get your public key from the Seerbit dashboard.
2. Go to Point of Sale > Configuration > Payment Methods and select your Seerbit payment method.
3. Paste the public key in the Seerbit Public Key field.
4. Test the payment flow.

Development

Local Development

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest tests/ -v

# Run development tools
python dev-tools.py

Odoo.sh Development

1. Make changes in your local repository
2. Push to Odoo.sh branch
3. Test in Odoo.sh environment
4. Merge to production when ready

Troubleshooting

Common Issues

1. Firebase connection failed: Check service account and database URL
2. Payment not reconciling: Verify Firebase security rules
3. Module not installing: Check Odoo.sh logs for errors

Logs

• Check Odoo.sh logs in Settings > Technical > Logging
• Look for Seerbit-related errors
• Verify Firebase configuration

Support

For issues and questions:

• Check the logs in Odoo.sh
• Review Firebase configuration
• Verify Seerbit integration settings