Conexão Azul Digital IXC Sync

Accounting · v19.0.1.0.0 · OPL-1

Conexão Azul Digital - Sincronização IXC Provedor

Dependências

base, contacts, account, mail

Documentação

Sincronização IXC Provedor → Odoo 19

Módulo que conecta o IXC Provedor ao Odoo via API REST, importando clientes e faturas a receber com mapeamento completo de campos financeiros, suporte a paginação, sincronização em background e agendamentos dinâmicos.

Dependências: base, contacts, account, mail

Funcionalidades

Configuração (`ixc.config`)

Campo	Descrição
`url_base`	URL da API do IXC (ex: `https://meuixc.com.br`)
`token`	Token de autenticação da API
`records_per_page`	Registros por página — padrão 500
`sync_page`	0 = todas as páginas; N = somente a página N
`qtype` / `query`	Filtro de consulta (ex: `fn_areceber.data_vencimento` / `2026-01-01`)
`sortname` / `sortorder`	Ordenação dos resultados
`company_id`	Empresa Odoo vinculada à configuração

Sincronização de Parceiros — `action_sync_partners()`

Endpoint: /webservice/v1/cliente
Cria ou atualiza registros res.partner pelo ixc_id
Mapeia 30+ campos ixc_*: ID, status ativo, WhatsApp, grau de satisfação, endereço completo, CPF/CNPJ, etc.
Executa em thread background com barra de progresso em tempo real

Sincronização de Faturas — `action_sync_moves()`

Endpoint: /webservice/v1/fn_areceber
Cria ou atualiza registros account.move (tipo out_invoice) pelo ixc_id
Vincula automaticamente ao res.partner pelo id_cliente IXC
Mapeia 70+ campos ixc_* (veja tabela abaixo)
Executa em thread background com progresso via cursor separado (sql_db.db_connect)

Progresso em Tempo Real

A sincronização usa um cursor independente para gravar o progresso em ixc_sync_current / ixc_sync_total sem aguardar o commit da transação principal — o usuário vê o andamento na tela enquanto a importação ocorre.

Campos Sincronizados

`account.move` — Faturas a Receber (`fn_areceber`)

Campo Odoo	Campo IXC	Descrição
`ixc_id`	`id`	ID único da fatura no IXC
`ixc_status`	`status`	Status do título (`A`=aberto, `R`=recebido, `C`=cancelado)
`ixc_valor`	`valor`	Valor original da fatura (R$)
`ixc_valor_recebido`	`valor_recebido`	Valor já recebido (R$)
`ixc_valor_aberto`	`valor_aberto`	Saldo em aberto (R$)
`ixc_data_emissao`	`data_emissao`	Data de emissão
`ixc_data_vencimento`	`data_vencimento`	Data de vencimento
`ixc_pagamento_data`	`pagamento_data`	Data de pagamento efetivo
`ixc_gateway_link`	`gateway_link`	Link de pagamento online
`ixc_linha_digitavel`	`linha_digitavel`	Linha digitável do boleto
`ixc_pix_txid`	`pix_txid`	TxID para pagamento PIX
`ixc_nn_boleto`	`nn_boleto`	Número do boleto
`ixc_recebido_via_pix`	`recebido_via_pix`	`S` se pago via PIX
`ixc_titulo_protestado`	`titulo_protestado`	Fatura enviada a protesto
`ixc_titulo_renegociado`	`titulo_renegociado`	Fatura renegociada
`ixc_tipo_renegociacao`	`tipo_renegociacao`	Tipo de renegociação
`ixc_id_renegociacao`	`id_renegociacao`	ID da renegociação original
`ixc_filial_id`	`filial_id`	Filial do IXC
`ixc_forma_recebimento`	`forma_recebimento`	Forma de pagamento (boleto, PIX, cartão…)
`ixc_tipo_cobranca`	`tipo_cobranca`	Tipo de cobrança
`ixc_status_cobranca`	`status_cobranca`	Status de cobrança IXC
`ixc_obs`	`obs`	Observações da fatura
(+ ~50 campos adicionais)		Contrato, remessa, carteira, imóvel, etc.

`res.partner` — Clientes (`cliente`)

Campo Odoo	Campo IXC	Descrição
`ixc_id`	`id`	ID único do cliente no IXC
`ixc_ativo`	`ativo`	Cliente ativo no IXC
`ixc_whatsapp`	`whatsapp`	Número WhatsApp
`ixc_grau_satisfacao`	`grau_satisfacao`	Grau de satisfação
`ixc_contrato`	`contrato`	Número do contrato
(+ ~25 campos adicionais)		Endereço, cidade, CEP, complemento, etc.

Agendamentos (`ixc.schedule`)

Configuração de sincronizações periódicas com filtros dinâmicos por data.

Placeholders dinâmicos suportados

{{today}}               → 2026-03-31
{{today + 1}}           → 2026-04-01
{{today - 30}}          → 2026-03-01
{{today:dd/MM/yyyy}}    → 31/03/2026
{{today + 7:dd/MM/yyyy}} → 07/04/2026

Exemplo de uso: sincronizar faturas vencidas nos últimos 30 dias:

qtype: fn_areceber.data_vencimento
query: {{today - 30}}

Logs de Agendamento (`ixc.schedule.log`)

Cada execução de agendamento é registrada com data, status (success/error) e mensagem de erro quando aplicável.

Automação (ir.cron)

Job	Frequência	Método
Sincronização IXC (agendamentos)	Diário	Executa todos os `ixc.schedule` ativos

Estrutura do Módulo

bitconn_ixc_sync/
├── data/
│   └── ixc_cron.xml                 # Cron de sincronização periódica
├── models/
│   ├── ixc_base.py                  # ixc.config: config + sync de parceiros e faturas
│   ├── ixc_schedule.py              # ixc.schedule + ixc.schedule.log
│   ├── account_move.py              # account.move: 70+ campos ixc_*
│   └── res_partner.py               # res.partner: 30+ campos ixc_*
├── views/
│   ├── ixc_base_views.xml           # Formulário de configuração + botões de sync
│   ├── ixc_schedule_views.xml       # Formulário de agendamentos + logs
│   ├── account_move_views.xml       # Herança da fatura com campos IXC
│   └── res_partner_views.xml        # Herança do parceiro com campos IXC
└── security/
    └── ir.model.access.csv

Instalação

./odoo-bin -c odoo.conf -i bitconn_ixc_sync

Após instalar:

Acesse IXC Sync → Configurações → Novo
Preencha URL Base (sem barra final) e Token
Clique em Sincronizar Parceiros
Após concluir, clique em Sincronizar Faturas

Para instalação completa com cobrança e BI, veja o README raiz.

Autores

Diego F. Rodrigues — [email protected] Diego Santos — [email protected] Site: conexaoazul.com Licença: Proprietária (OPL-1)