Asaas Financial Sync - Extrato Bancario

Accounting · v19.0.1.0.0 · OPL-1

Dependências

blue_payment_asaas, account

Documentação

Modulo profissional para sincronizacao automatica do extrato financeiro Asaas (taxas, transferencias, antecipacoes, chargebacks) como lancamentos contabeis no Odoo 19.

Visao Geral

O Asaas Financial Sync integra sua conta Asaas ao Odoo, importando automaticamente todas as transacoes financeiras do seu extrato bancario Asaas como lancamentos contabeis organizados e categorizados.

Elimine a digitacao manual de taxas, transferencias, antecipacoes e chargebacks. Tenha seu extrato Asaas sincronizado com o Odoo em tempo real.

Funcionalidades

Recurso	Descricao
Sincronizacao Incremental	Traz apenas transacoes novas com deduplicacao automatica por ID
Mapeamento Inteligente	32 tipos de transacao mapeaveis para contas contabeis especificas
Multi-Empresa	Configuracao independente por empresa no Odoo
Cron Diario	Sincronizacao automatica diaria dos ultimos 7 dias
Wizard Manual	Sincronizacao sob demanda com intervalo de datas customizavel
Log Completo	Registro detalhado de cada execucao com sucesso/erro/ignorados
Lancamentos Postados	Contabiliza automaticamente os lancamentos criados
Deduplicacao	Impede duplicidade verificando o ID da transacao Asaas
Odoo 19 Ready	Totalmente compativel com Odoo 19 (views `list`, atributos inline, constraints modernas)

Tipos de Transacao Suportados

Taxas e Despesas

Taxa de Pagamento (PAYMENT_FEE)
Taxa de Nota Fiscal (INVOICE_FEE)
Taxa de Transferencia (TRANSFER_FEE)
Taxa de Antecipacao (RECEIVABLE_ANTICIPATION_FEE)
Taxa de Mensagem (INSTANT_TEXT_MESSAGE_FEE)
Taxa de Mensageria (PAYMENT_MESSAGING_NOTIFICATION_FEE)
Taxa PIX (PIX_TRANSACTION_DEBIT_REFUND)
KYC Batch Fee (CHILD_ACCOUNT_KNOWN_YOUR_CUSTOMER_BATCH_FEE)

Transferencias e Saques

Transferencia / Saque (TRANSFER)
Transferencia Interna (INTERNAL_TRANSFER_DEBIT)
Pagamento de Conta (BILL_PAYMENT)
Transacao Cartao Asaas (ASAAS_CARD_TRANSACTION)
Recarga Cartao Asaas (ASAAS_CARD_RECHARGE)
Pagamento Fatura Cartao (ASAAS_CARD_BILL_PAYMENT)

Antecipacao de Recebiveis

Debito de Antecipacao (RECEIVABLE_ANTICIPATION_DEBIT)
Credito Bruto de Antecipacao (RECEIVABLE_ANTICIPATION_GROSS_CREDIT)

Chargebacks e Estornos

Chargeback (CHARGEBACK)
Reversao de Chargeback (CHARGEBACK_REVERSAL)
Estorno de Pagamento (PAYMENT_REVERSAL)
Reversao de Taxa (PAYMENT_FEE_REVERSAL)
Reversao Generica (REVERSAL)

Creditos e Reembolsos

Credito Generico (CREDIT)
Credito Promocional (PROMOTIONAL_CODE_CREDIT)
Reembolso Saldo Cartao (ASAAS_CARD_BALANCE_REFUND)
Reembolso Parcial Cartao (ASAAS_CARD_TRANSACTION_PARTIAL_REFUND)
Reembolso Total Cartao (ASAAS_CARD_TRANSACTION_REFUND)
Debito Generico (DEBIT)

Ignorados (por design)

Pagamento Recebido (PAYMENT_RECEIVED) — ja registrado pelo modulo de pagamentos
Pagamento Parcial (PARTIAL_PAYMENT) — aguarda finalizacao
Bloqueios Judiciais BACEN (BACEN_JUDICIAL_LOCK, BACEN_JUDICIAL_TRANSFER, BACEN_JUDICIAL_UNLOCK)

Instalacao

Pre-requisitos

Odoo 19 (Community ou Enterprise)
Modulo blue_payment_asaas instalado e configurado
Conta Asaas ativa com API Key configurada no provider de pagamentos

Passos

Instale o modulo blue_payment_asaas e configure o provider Asaas com a API Key
Instale este modulo (blue_asaas_financial_sync)
Acesse Asaas Sync > Configuracao e configure:
- Diario Bancario: diario do tipo bank para os lancamentos
- Conta Bancaria: conta contabil do tipo asset_cash
- Conta de Receita Padrao (opcional): para creditos genericos
- Conta de Despesa Padrao (opcional): para taxas sem mapeamento especifico
Acesse Asaas Sync > Tipos de Transacao e mapeie cada tipo para a conta contabil correspondente
Execute o wizard Asaas Sync > Executar Sincronizacao para testar

Uso

Sincronizacao Manual

Acesse Asaas Sync > Executar Sincronizacao
Selecione a empresa
Defina o intervalo de datas
Clique em Sincronizar
Visualize o log de execucao com detalhes de cada transacao

Sincronizacao Automatica (Cron)

Acesse Configuracoes > Tecnico > Acoes Planejadas
Localize Asaas: Sincronizar Transacoes Financeiras
Ative o cron e ajuste o intervalo conforme necessidade
Por padrao executa diariamente, sincronizando os ultimos 7 dias

Configuracao Multi-Empresa

Cada empresa no Odoo possui configuracao independente:

Configuracao de diario e contas bancarias
Mapeamento de tipos de transacao proprio
Logs de sincronizacao separados
Deduplicacao por empresa (mesmo ID em empresas diferentes e valido)

Arquitetura Tecnica

Asaas API v3
    |
    v
[asaas.sync.wizard] --(acao manual)--> [_run_sync()]
    |
    v
[ir.cron] --(diario)--> [_run_cron_sync()]
    |
    v
[_get_api_key()] --(payment.provider)--> API Key
    |
    v
[API /v3/financialTransactions] --(paginacao)--> Transacoes
    |
    v
[Deduplicacao] --(account.move.ref)--> Ja existe?
    |
    v
[Mapeamento] --(asaas.transaction.type)--> Conta contabil
    |
    v
[account.move.create()] --(auto_post)--> Lancamento Postado
    |
    v
[asaas.sync.log] --(registro)--> Evidencia de execucao

Screenshots

Adicione screenshots da interface do modulo aqui

Suporte

Conexao Azul Digital

Website: conexaoazul.com
Email: [email protected]

Changelog

1.0.0 (2026-05-23)

Lançamento inicial
Sincronizacao incremental com deduplicacao
32 tipos de transacao suportados
Multi-empresa
Odoo 19 compativel

Licenca

Este modulo esta licenciado sob LGPL-3.

Feito com maestria pela Conexao Azul Digital