Visão Geral da Localização Brasil CIEL IT¶

Objetivo¶

A localização brasileira desenvolvida pela CIEL IT adapta o Odoo para atender às exigências fiscais, tributárias, contábeis e operacionais do Brasil. O sistema cobre todo o ciclo de vida de documentos fiscais (NF-e, NFS-e, NFC-e), cálculo granular de impostos, obrigações acessórias (SPED, REINF), integrações de pagamento e comércio exterior (Siscomex/DUIMP).

Dados do Projeto¶

Item	Valor
Autor	CIEL IT S/A
Website	ciel-it.com
Licença	Proprietária
Versão atual	`25.3.14`
Plataforma	Odoo Enterprise
Categoria Odoo	Localization
Repositório	`l10n-br-ciel-it`

Módulos do Repositório¶

O repositório contém 14 módulos organizados por domínio funcional:

Módulo Núcleo¶

Módulo	Nome Técnico	Versão	Escopo
Localização Account	`l10n_br_ciel_it_account`	25.3.14	Contabilidade, NF-e/NFS-e/NFC-e, impostos, SPED, REINF, DUIMP, cobrança escritural, relatórios fiscais

Extensões Contábeis¶

Módulo	Nome Técnico	Versão	Escopo
Accountant Enterprise	`l10n_br_ciel_it_account_accountant`	25.3.14	Batch Payment, CIAP, Cash Flow P&R, Follow-up, Reconciliação
Repair (Assistência Técnica)	`l10n_br_ciel_it_account_repair`	25.3.14	Extensão fiscal para ordens de reparo

Módulos de Saída / Entrada Direcionados¶

Módulo	Nome Técnico	Versão	Escopo
Sale Output	`l10n_br_ciel_it_sale_output`	25.3.14	Extensão de saída para vendas
Purchase Output	`l10n_br_ciel_it_purchase_output`	25.3.14	Extensão de saída para compras
Sale Subscription	`l10n_br_ciel_it_sale_subscription`	25.3.14	Assinaturas recorrentes com fiscal BR

E-commerce e PDV¶

Módulo	Nome Técnico	Versão	Escopo
Website Sale	`l10n_br_ciel_it_website`	25.3.14	E-commerce: CEP → cálculo frete, CPF/CNPJ no checkout
POS (PDV)	`l10n_br_ciel_it_pos`	25.3.14	NFC-e no PDV, CPF no cupom, contingência

Integrações de Pagamento¶

Módulo	Nome Técnico	Versão	Escopo
Cielo	`l10n_br_ciel_it_payment_cielo`	25.3.14	Gateway Cielo (crédito, débito, pix)
Rede	`l10n_br_ciel_it_payment_rede`	25.3.14	Gateway Rede e-Rede (crédito, débito)
PagBank	`l10n_br_ciel_it_payment_pag_bank`	25.0.3	Gateway PagBank (pix, boleto, crédito)

Logística¶

Módulo	Nome Técnico	Versão	Escopo
Melhor Envio	`l10n_br_ciel_it_delivery_melhorenvio`	25.3.14	Cotação e rastreio via Melhor Envio

Comunicação¶

Módulo	Nome Técnico	Versão	Escopo
WhatsApp	`wa`	25.0.3	WhatsApp Business: sessões, templates, chatbot, envio de NF

Dependências Externas (Python)¶

Definidas em requirements.txt:

Pacote	Uso
`brazilcep`	Consulta de CEP (ViaCEP e outros)
`pycpfcnpj`	Validação de CPF e CNPJ
`pandas`	Manipulação de dados tabulares (SPED, importações)
`openpyxl`	Leitura de arquivos Excel (.xlsx)

Dependências implícitas (já disponíveis no ambiente Odoo):

Pacote	Uso
`xlsxwriter`	Geração de relatórios Excel
`xlrd`	Leitura de arquivos Excel (.xls legado)
`requests`	Chamadas HTTP para APIs externas
`cryptography`	Certificados digitais (mTLS para Siscomex)
`xmltodict`	Parsing de XML (PagSeguro legado)

Dependências Odoo (Módulos Base)¶

O módulo core (l10n_br_ciel_it_account) depende de:

Módulo Odoo	Motivo
`base`	Framework base
`mail`	Chatter, notificações
`contacts`	Gestão de parceiros
`delivery`	Métodos de entrega, transportadoras
`account`	Contabilidade e faturamento
`purchase`	Pedidos de compra
`purchase_requisition`	Requisições de compra
`uom`	Unidades de medida
`stock`	Estoque
`sale`	Pedidos de venda
`product_expiry`	Validade de produtos (ANVISA)
`payment`	Framework de pagamentos
`sale_stock`	Integração venda ↔ estoque
`analytic`	Contas analíticas (centro de custo)
`stock_delivery`	Integração entrega ↔ estoque
`hr`	Recursos humanos
`hr_contract`	Contratos de trabalho
`stock_account`	Valorização de estoque contábil

Impostos Suportados¶

A localização suporta o cálculo completo dos seguintes impostos brasileiros:

Impostos sobre Mercadorias¶

Imposto	Descrição
ICMS	Imposto sobre Circulação de Mercadorias e Serviços
ICMS ST	ICMS Substituição Tributária
ICMS DIFAL	Diferencial de Alíquota (operações interestaduais p/ consumidor final)
FCP/FECP	Fundo de Combate à Pobreza
IPI	Imposto sobre Produtos Industrializados

Impostos sobre Serviços¶

Imposto	Descrição
ISS	Imposto Sobre Serviços

Contribuições Federais¶

Imposto	Descrição
PIS	Programa de Integração Social
COFINS	Contribuição para Financiamento da Seguridade Social
IRPJ	Imposto de Renda Pessoa Jurídica
CSLL	Contribuição Social sobre o Lucro Líquido
INSS	Instituto Nacional do Seguro Social

Retenções na Fonte¶

Retenção	Descrição
PIS Retido	Retenção na fonte de PIS
COFINS Retido	Retenção na fonte de COFINS
CSLL Retida	Retenção na fonte de CSLL
IR Retido	Retenção na fonte de Imposto de Renda
INSS Retido	Retenção na fonte de INSS
ISS Retido	Retenção na fonte de ISS

Reforma Tributária (IBS/CBS) — Em Produção¶

Classificação	Descrição
IBS/CBS	Classificação Tributária para Imposto sobre Bens e Serviços / Contribuição sobre Bens e Serviços
IS	Classificação Tributária para Imposto Seletivo

Tipos de Documento Fiscal¶

Código	Tipo	Transmissão
`55`	NF-e (Nota Fiscal Eletrônica)	SEFAZ (webservice)
`65`	NFC-e (Nota Fiscal de Consumidor)	SEFAZ (webservice)
`57`	CT-e (Conhecimento de Transporte)	SEFAZ (webservice)
`NFSE` / `NFS`	NFS-e (Nota Fiscal de Serviço)	Prefeitura (webservice)
`FAT`	Fatura (sem emissão fiscal)	Interno
`ND`	Nota de Débito	Interno/SEFAZ
`04`	NF de Produtor Rural	SEFAZ
`06`	NF Complementar	SEFAZ
`21` / `22`	NFS-e variantes de serviço	Prefeitura
`66`	NF-e Complementar de ICMS	SEFAZ

Integrações Externas¶

A localização se comunica com os seguintes serviços externos:

Serviço	Protocolo	Finalidade
SEFAZ (NF-e/NFC-e)	SOAP/REST (via EDI)	Transmissão, consulta status, cancelamento
Prefeituras (NFS-e)	SOAP/REST	Emissão de notas de serviço
CNPJA	REST	Consulta de dados cadastrais por CNPJ
ViaCEP (brazilcep)	REST	Consulta de endereço por CEP
Siscomex/Portal Único	REST + mTLS	DUIMP, CATP (catálogo de produtos), CADA (atributos NCM)
REINF	REST/XML	Eventos de retenções federais
Melhor Envio	REST	Cotação e rastreio de fretes
Cielo	REST	Pagamentos (crédito, débito, pix)
Rede e-Rede	REST	Pagamentos (crédito, débito)
PagBank	REST	Pagamentos (pix, boleto, crédito)
WhatsApp Business	REST	Envio de mensagens, NF, chatbot

Referências Cruzadas¶

Próximo: Arquitetura de Módulos
Índice: Sumário Geral