ASAAS Bank Statement Sync: Auto Reconcile Payments in Odoo
by Conexão Azul Digital https://conexaoazul.com.br$ 498.79
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 5980 |
| Technical Name |
blue_asaas_financial_sync |
| License | OPL-1 |
| Website | https://conexaoazul.com.br |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 5980 |
| Technical Name |
blue_asaas_financial_sync |
| License | OPL-1 |
| Website | https://conexaoazul.com.br |
ASAAS Bank Statement Sync: Auto Reconcile Payments in Odoo
Automatically import ASAAS financial transactions as Odoo journal entries â fees, transfers, anticipations, chargebacks â with deduplication, multi-company support and detailed sync logs.
Eliminate Manual Bank Reconciliation
Manually entering ASAAS fees, transfer costs, anticipation debits and chargebacks into Odoo is time-consuming and error-prone. This module syncs 32 transaction types from ASAAS financialTransactions API directly into your bank journal â with automatic deduplication and full audit logs.
Auto-Sync with Cron
Daily scheduled job fetches the last 7 days of transactions for every active company. Each run creates a detailed sync log with counts of fetched, created, skipped and errored items.
Deduplication by ID
Every transaction is matched by ASAAS transaction ID (stored in account.move ref field). Duplicates are automatically skipped â never post the same entry twice.
Configurable Mapping
Map each of the 32 ASAAS transaction types to expense, income, anticipation categories or skip it entirely. Assign specific expense accounts per type.
Everything You Can Do
Sync On Demand
- Wizard with configurable date range (start/end)
- Auto-post journal entries or leave as draft
- Pagination (100 per page with 150ms throttle)
- Commit every 50 records for large datasets
4 Entry Categories
- Expense Entry (debit expense, credit bank)
- Anticipation Credit (debit bank, credit income)
- Anticipation Debit (debit expense, credit bank)
- Skip (ignore the transaction type entirely)
Audit Trail & Logs
- Sync log with state (running/done/error) and counts
- Line-level detail: FTN ID, type, amount, status, move link
- Quick link to view all created journal entries
- Error messages preserved per transaction
How It Works
Configure per Company
Set up bank journal, bank account, default income/expense accounts for each company. Map 32 ASAAS transaction types to move categories with custom expense accounts.
Run Sync (Manual or Cron)
Manual sync wizard: pick date range, check auto-post, click sync. Or let the daily cron job run automatically for all active companies with a 7-day rolling window.
Review Journal Entries
Each transaction becomes an account.move entry with proper debit/credit lines. Auto-posted entries are ready for reconciliation. Draft entries await your review.
Audit from Sync Logs
Open any sync log to see exact counts: fetched, created, skipped (duplicates), unknown (new types) or errored. Drill down to line-level detail with direct links to journal entries.
Technical Specifications
| Odoo Version | 19.0 Community + Enterprise |
| API Endpoint | ASAAS financialTransactions (v3) with pagination (limit=100) |
| Transaction Types | 32 predefined types (fees, transfers, anticipations, chargebacks, etc.) |
| Move Categories | expense_entry, anticipation_credit, anticipation_debit, skip |
| Deduplication | By ASAAS transaction ID stored in account.move ref field |
| Cron Schedule | Daily, rolling 7-day window for all active companies |
| Dependencies | blue_payment_asaas, account |
| License | OPL-1 (single deployment, per-tenant license) |
Best For
Ideal If You...
- Process high volume of ASAAS payments and need clean books
- Want to automate bank reconciliation rather than manual entry
- Need to track ASAAS fees, anticipations and chargebacks in accounting
- Operate multiple companies with ASAAS (each with own config)
- Require audit trail of every sync run with line-level detail
May Not Be Ideal If...
- You do not use ASAAS as your payment gateway
- Your transaction volume is too low to justify automation
- You already have a separate ERP integration handling financial sync
Frequently Asked Questions
What if ASAAS adds new transaction types?
Unknown types are logged in the sync log as "unknown" and do not block the sync. You can add new mappings in the transaction type configuration at any time.
Is it safe to run the sync multiple times?
Yes. Every transaction is deduplicated by ASAAS ID stored in the account.move ref field. Running the same date range twice will skip all already-synced transactions.
Can I review entries before they are posted?
Yes. Uncheck "Lançar Automaticamente" in the sync wizard to create draft journal entries. Review and post them manually in the accounting journal.
How does multi-company work?
Each company gets its own ASAAS configuration (bank journal, accounts) and independent transaction type mappings. The cron sync processes all active companies automatically.
Complete Your ASAAS Stack
This module is part of our ASAAS Suite. Maximize your financial automation with these complementary modules:
ASAAS Payments Brazil
Core: Pix, Boleto, Credit Card & NFSe
REQUIREDSubscriptions & Recurring
SaaS metrics, MRR/ARR/LTV, 8 cycles, dunning
UPSELLNFSe Brazil via ASAAS
Advanced fiscal with batch & 5,000+ cities
UPSELLFinancial Dashboard BI
Executive dashboards, cohort analysis, PDF export
CROSS-SELLInvoice Auto-Payment
Cron-based batch invoice reconciliation
CROSS-SELLSupport & Setup
Bug Fix Assistance
30 days of included bug fix support with prompt response
Setup Guidance
Step-by-step help for first configuration, transaction type mapping and journal setup
WhatsApp Priority
Direct WhatsApp line for urgent book closing and reconciliation issues
Automate ASAAS Reconciliation in Odoo Today
Install now and reduce manual bank reconciliation by 90% â fees, transfers and anticipations synced automatically.
devops@conexaoazul.com | conexaoazul.com.br | License: OPL-1
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module