CC Patrimonial
Manual SIAFIC — Sistema Complementar de Gestão Patrimonial

Decreto 10.540/2020 · API de lote contábil · conformidade · homologação · modelos · FAQ  —  CC Patrimonial · PatriID

Manual SIAFIC — Sistema Complementar de Gestão Patrimonial

Decreto Federal nº 10.540/2020 (SIAFIC) · NBC TSP 07 · MCASP 11ª Edição (STN, vigência 2025) · Portaria STN 6.424/2016 (MSC) · LAI · LC 131/2009 · LRF

Manual consolidado do PatriID como Sistema Complementar ao Sistema Estruturante municipal — da apresentação executiva à especificação técnica da API, com conformidade, homologação, operação, modelos de atos e FAQ. CC Patrimonial · PatriID — patri.id

📋 Sumário


Parte I — Apresentação Executiva

PatriID
Sistema Auxiliar de Gestão Patrimonial

Implementação como Sistema Complementar ao SIAFIC — Decreto Federal nº 10.540/2020 · MCASP 11ª Edição · NBC TSP
InventárioAvaliaçãoCATMAT-AILaudos TécnicosConformidade
ccpatrimonial.com.br · comercial@ccpatrimonial.com.br · (28) 99956-5084
DiagnósticoLÂMINA 02 · 12
A dor patrimonial dos municípios brasileiros
Bens nunca depreciados

Ativos pelo valor original para sempre — irregularidade apontada sistematicamente pelos TCEs.

Confusão VPD × Ativo

Manutenção lançada como investimento (e vice-versa), distorcendo o Balanço Patrimonial.

Inventário desatualizado

Base física divergente da contábil — impossibilita a conciliação exigida pelo MCASP.

MSC rejeitada no SICONFI

PCASP inválido, ativo ≠ passivo + PL — erros que bloqueiam a homologação.

Consequência: rejeição de contas · bloqueio no CAUC · inelegibilidade do gestor
Marco LegalLÂMINA 03 · 12
Decreto 10.540/2020 — a arquitetura do SIAFIC
SISTEMA ESTRUTURANTE

O "coração": contabilidade e execução orçamentária. Único e obrigatório para Executivo + Legislativo.

▸ Base de dados única (art. 5º)
▸ Contabilização tempestiva (art. 6º)
▸ Trilha de auditoria imutável (art. 8º)
▸ Gera a MSC para o SICONFI

SISTEMAS COMPLEMENTARES

Os "satélites": Patrimônio, CTM, Transparência, Folha, Frotas…

▸ Integração "integrada, tempestiva e automática" (art. 14)
▸ Sem planilhas paralelas
▸ Sem exportação manual de arquivos
▸ É aqui que o PatriID opera

Análise NormativaLÂMINA 04 · 12
Requisitos do SIAFIC aplicáveis ao patrimônio
Art. 5º · Base única

Executivo, Legislativo e autarquias na mesma base (ou réplicas em tempo real). Sem planilhas paralelas.

Art. 6º · Tempestividade

O ato de gestão (aquisição, baixa, transferência) reflete na contabilidade no momento em que ocorre.

Art. 8º · Trilha de auditoria

Registro imutável com usuário, data/hora e valor anterior de cada operação.

Ecossistema NormativoLÂMINA 05 · 12
Normas correlatas que o sistema auxiliar deve atender
NormaExigência incorporada ao PatriID
NBC TSP 07 (CFC)Modelo do Custo ou Reavaliação · depreciação mensal · teste de impairment
MCASP 11ª Ed. (STN)PCASP em 7 níveis · VPD × capitalização · naturezas P, O e C · notas explicativas
NBR 14653 (ABNT)Avaliação de imóveis com graus de fundamentação e precisão
CATMAT (Compras.gov)Classificação padronizada federal dos materiais (165 mil itens)
LAI · LC 131 · LRFTransparência ativa e prestação de contas tempestiva
O Custo da InérciaLÂMINA 06 · 12
Sanções automáticas do descumprimento
CAUC

Bloqueio de transferências voluntárias — LRF art. 51: sem convênios nem verbas federais/estaduais discricionárias.

TCE

Rejeição de contas — bens não depreciados/superavaliados → parecer prévio contrário → inelegibilidade (Ficha Limpa).

Senado / STN

Veto a operações de crédito — o município fica fora do mapa de financiamento.

A Solução · ccpatrimonial.com.brLÂMINA 07 · 12
PatriID: gestão patrimonial pública com IA
✓ Inventário completo

Móveis, imóveis e infraestrutura com foto, georreferenciamento e plaqueteamento.

✓ CATMAT-AI

Classificação automática por foto no catálogo federal de 165 mil itens.

✓ Avaliação NBR 14653

Laudos com Ross-Heidecke, graus de fundamentação e memória de cálculo.

✓ Motor contábil MCASP

Depreciação pró-rata die, impairment, reavaliação por classe e gate PCASP.

Plataforma multi-tenant · trilha de auditoria em 3 camadas · manuais normativos embutidos com agente de consulta
Matriz de ConformidadeLÂMINA 08 · 12
Aderência PatriID × exigência legal
ExigênciaBase normativaComo o PatriID atende
Depreciação mensal automáticaNBC TSP 07 · MCASP IIMotor pró-rata com memória auditável
Separação VPD × capitalizaçãoMCASP · NBC TSP 07Assistente classifica manutenção vs melhoria
Classificação de materiaisCATMAT · MCASPCATMAT-AI por foto
Trilha de auditoriaArt. 8ºLog com valor anterior + e-mail de gestão + auditoria de IA
Integração automáticaArt. 14 § únicoAPI de lote contábil (especificação v1.0 — Parte V)
Arquitetura TécnicaLÂMINA 09 · 12
Fluxo de dados: da ponta ao Tesouro Nacional
PatriID

Sistema auxiliar: inventário, avaliação, depreciação, CATMAT-AI, laudos e audit trail

➜
API / Webservice

Art. 14 § único · lote contábil JSON/XML validado no PCASP, envio automático

➜
Sistema Estruturante

Contabilidade registra os lançamentos (D-VPD / C-Deprec. Acum.) e consolida balancetes

➜
SICONFI / STN

MSC assinada (ICP-Brasil) homologada — CAUC limpo

RoadmapLÂMINA 10 · 12
Plano de implantação em 4 fases
FASE 1 · Formalização legalSemanas 1–2

Decreto de classificação (art. 14) · Portaria do Gestor de Dados · política contábil (Modelo do Custo)

FASE 2 · Inventário e saneamentoSemanas 3–10

Inventário físico com CATMAT-AI e fotos · avaliação NBR 14653 por classe · conciliação físico-contábil

FASE 3 · Integração automáticaSemanas 4–8

API de lote contábil homologada em paralelo com o contador até bater ao centavo

FASE 4 · Operação e governançaContínuo

Depreciação mensal · conciliação com ata · CAUC monitorado · checklist TCE anual

Governança e AutorizaçõesLÂMINA 11 · 12
Quem autoriza o quê — cadeia de responsabilidade
Prefeito(a)

Decreto Municipal — classifica o PatriID como sistema complementar e institui a política contábil (art. 14).

Secretário de Fazenda

Portaria + Termo de Autorização — nomeia o Gestor de Dados e libera as credenciais de API.

Contador-Chefe (CRC)

Termo de Responsabilidade Técnica — valida cálculos e lançamentos; assina o checklist de conformidade.

Resultados EsperadosLÂMINA 12 · 12
Patrimônio regular, contas aprovadas, gestor protegido
100%

dos bens inventariados, avaliados e classificados

Mensal

depreciação automática com memória de cálculo

Zero

exportação manual — integração 100% por API

CAUC

limpo: transferências voluntárias desbloqueadas


Parte II — Governança Patrimonial (Apresentação)


Parte III — Guia Legal de Integração (Decreto 10.540/2020)

Decreto Federal nº 10.540/2020 · Lei 12.527/2011 (LAI) · LC 131/2009 · LRF art. 48 NBC TSP 07 · MCASP 11ª Edição (STN, vigência 2025) · Portaria STN 6.424/2016 (MSC)

Guia de procedimentos legais e técnicos para sistemas de Patrimônio, CTM e Transparência operarem como Sistemas Complementares ao Sistema Estruturante municipal (SIAFIC). Documento normalizado — padrão GitHub Markdown.

1. Arquitetura do SIAFIC (dois níveis)

O Decreto 10.540/2020 define uma arquitetura de dois níveis para os sistemas municipais:

Nível Papel Exigências centrais
Sistema Estruturante O "coração": contabilidade e execução orçamentária. Único e obrigatório para Executivo + Legislativo Base de dados única (art. 5º) · contabilização tempestiva (art. 6º) · trilha de auditoria (art. 8º) · gera a MSC para o SICONFI
Sistemas Complementares Os "satélites": Patrimônio, CTM, Transparência, Folha, Frotas… Gerar informações "de forma integrada, tempestiva e automática" ao Estruturante (art. 14)

Todo sistema que acesse ou alimente dados padronizados precisa saber em qual camada opera — e formalizar isso.

2. Enquadramento legal do sistema (primeiro passo obrigatório)

Antes de qualquer integração técnica, o ente deve formalizar por ato administrativo a classificação do sistema:

3. Modalidades de acesso aos dados padronizados

A. Leitura — API pública do SICONFI

Base: transparência ativa (LAI). Não exige credencial para leitura de:

B. Escrita — envio da MSC ao SICONFI

Exige credencial digital ICP-Brasil (e-CPF/e-CNPJ), pessoal e intransferível. Fluxo:

  1. Gerar a MSC no formato homologado (Portaria STN 6.424/2016);
  2. Assinar digitalmente (ICP-Brasil);
  3. Enviar via POST /msc/upload com token;
  4. Monitorar o ticket de processamento;
  5. Tratar erros de validação contábil antes da reapresentação.

C. Integração interna (Complementar → Estruturante) — art. 14, § único

Procedimento Fundamento O que implementar
API de lançamentos art. 14 § único Endpoint que expõe JSON/XML dos eventos patrimoniais
Tempestividade art. 6º, III O fato (ex.: aquisição) reflete na contabilidade no mesmo dia
Trilha de auditoria art. 8º Log imutável com timestamp, usuário e valor anterior
Unicidade da base art. 5º Vedada a exportação manual de arquivo — a integração deve ser por webservice
Vedação de acesso direto art. 5º/14 Proibido acessar o banco de dados do Estruturante sem passar pela API

4. Procedimentos específicos por módulo

4.1 Patrimônio (Ativo Imobilizado)

4.2 CTM (Cadastro Territorial Multifinalitário)

4.3 Portal de Transparência

5. Checklist de conformidade para homologação pelo TCE

⚠️ O ponto mais crítico: a maioria das rejeições de contas não ocorre por ausência de software, mas por ausência de processo — o sistema existe, mas não está integrado, não deprecia mensalmente e não gera a MSC correta.

6. Governança: quem autoriza o quê

Cadeia hierárquica em 3 níveis:

Autoridade Instrumento O que autoriza
Prefeito(a) Decreto Municipal Classifica o sistema como Complementar (art. 14) e institui a política contábil
Secretário de Fazenda Portaria + Termo de Autorização Nomeia o Gestor de Dados e libera credenciais de API do Estruturante
Contador-Chefe (CRC ativo) Termo de Responsabilidade Técnica Responde solidariamente pelos lançamentos; assina o checklist de conformidade

Boas práticas de credenciais: cofre de segredos (nunca em código), ICP-Brasil pessoal para o SICONFI, protocolo formal de revogação de acesso, conciliação mensal e monitoramento do CAUC.

7. Modelos de documentos (DOCX anexo)

Arquivo Modelos_SIAFIC_Autorizacao_Acesso.docx — 7 modelos prontos com fundamentação legal embutida:

# Documento Quem assina
1 Decreto Municipal de Classificação do Sistema Complementar Prefeito(a)
2 Portaria de Nomeação do Gestor de Dados Secretário de Fazenda
3 Requerimento de Integração ao Estruturante Gestor + Secretário
4 Termo de Autorização de Acesso Secretário de Fazenda
5 Termo de Responsabilidade Técnica Contábil Contador-Chefe (CRC)
6 Protocolo de Revogação de Acesso Gestor + Secretário
7 Checklist de Conformidade — TCE Contador-Chefe

8. Sanções pelo descumprimento

Órgão Sanção Fundamento
CAUC Bloqueio de transferências voluntárias (convênios, verbas discricionárias) LRF art. 51
TCE Rejeição de contas (bens não depreciados/superavaliados) → parecer contrário → inelegibilidade Ficha Limpa
Senado/STN Veto a operações de crédito LRF

Guia normalizado a partir das notas de estudo; referências ao MCASP atualizadas para a 11ª Edição (STN, vigência 2025). Adaptar os modelos com o contador responsável (CRC ativo) antes do uso oficial.


Parte IV — Conformidade

Relatório Técnico de Conformidade (matriz de requisitos)

Objeto: aderência do PatriID / CC Patrimonial (sistema auxiliar de gestão patrimonial — monorepo patriid-mobile, frota de 5 servidores) aos requisitos do SIAFIC aplicáveis a Sistemas Complementares (art. 14) e às normas correlatas (NBC TSP 07, MCASP 11ª Edição, LAI, LGPD). Data: 26/07/2026 · Base: código-fonte, banco e operação reais da frota.

Sumário executivo

O PatriID atende integralmente os requisitos de trilha de auditoria, controle de acesso individualizado, gestão documental, motor de depreciação com memória de cálculo e validação PCASP — e atende parcialmente os requisitos de integração automática ao Sistema Estruturante (hoje a ponte é a Exportação EL por arquivo, com gate de qualidade, mas sem webservice) e de rotina mensal automatizada de lote de depreciação. Nenhum requisito é descumprido de forma estrutural: os gaps são de processo/integração, exatamente o padrão que o próprio diagnóstico SIAFIC aponta como causa das rejeições de contas.

Placar geral: 9 requisitos CONFORMES · 4 PARCIAIS · 0 NÃO CONFORMES (+ 3 obrigações que são do ENTE, não do sistema — formalização legal).


1. Matriz de conformidade

# Exigência (fundamento) Situação no PatriID Parecer
1 Trilha de auditoria — log com usuário, data/hora e valor anterior (art. 8º) patriid.log_acoes (usuário, ação, módulo, IP, user-agent, dados_anteriores/dados_novos JSONB, timestamp) + sessoes + auditoria por e-mail a gestao@patri.id (login, logout por inatividade, exclusões com tombamento, inserções, cotação, uso de IA com custo estimado, avaliações, inventário, selos) + @audited em todas as tools de IA ✅ CONFORME (ver rec. R1: imutabilidade)
2 Controle de acesso individualizado (art. 8º; LGPD) Usuários individuais com nível (até MASTER 99000), permissões por módulo e por agente de IA (ai_acesso/ai_agentes/modulos), gate admin (nível ≥ 10000), auto-logout por 10 min de inatividade, session token, reset de senha por SMTP próprio (pmi@patri.id) ✅ CONFORME (ver rec. R2: senhas legadas)
3 Tempestividade do registro patrimonial (art. 6º, III) Coleta mobile offline-first com sincronização; movimentações, avaliações e baixas refletem no banco do PatriID em tempo real; auditoria de uso de IA é imediata ✅ CONFORME no âmbito do sistema auxiliar
4 Tempestividade do reflexo CONTÁBIL (art. 6º) O reflexo no Estruturante depende da Exportação EL (arquivo gerado pelo Fechamento com gate de semáforo) — periódica, não automática 🟡 PARCIAL (gap G1)
5 Integração por API/webservice — vedada exportação manual (art. 14 § único; art. 5º) Exportação EL é arquivo (48 col. móveis / 35 imóveis, views vw_exportafull_el); não há webservice de lote contábil consumível pelo Estruturante 🟡 PARCIAL (gap G1 — o mais relevante)
6 Depreciação mensal com memória de cálculo (NBC TSP 07; MCASP 11ª) Motor calcular_depreciacao (pro-rata die, banker's rounding, métodos linear/soma dos dígitos/unidades — alinhado à 11ª ed.) com memória auditável; Ross-Heidecke p/ avaliação; relatórios/folhas de cálculo arquivados 🟡 PARCIAL — cálculo sob demanda; falta job mensal automatizado de lote (gap G2)
7 PCASP válido (sem conta sintética/extinta) Fechamento valida conta analítica (.00 inválida), checks A–G com semáforo por conta; exportação só dos aptos ✅ CONFORME
8 Distinção VPD × capitalização Manuais MCASP/Patrimônio integrados ao Assistente (habilidades + tools com o teste melhoria×restauração); classificação assistida nos fluxos de obras/avaliação 🟡 PARCIAL — orientação forte, mas sem workflow formal de obras→capitalização com trava (gap G3)
9 Notas explicativas / evidenciação do método orgaos.metodo_mensuracao (Custo × Reavaliação) parametrizado e respeitado pelos motores (impairment só no custo); Relatório Final patrimonial em 3 fases NBC TSP/MCASP ✅ CONFORME
10 Gestão documental digital Termos e selos de inventário assinados e imutáveis; laudos e folhas de cálculo arquivados por bem (bytea); PDFs de reconhecimento/análises IA persistidos ✅ CONFORME
11 Unicidade/segregação de base (art. 5º) Multi-tenant com banco isolado por ente; resolução de tenant JWT > query > header; sem planilhas paralelas (cotejamento e conciliação dentro do sistema) ✅ CONFORME
12 Segurança e continuidade HTTPS com certificados por vhost; backups automatizados com SHA-256; fail2ban no mailserver; senha bcrypt (migração) ✅ CONFORME (ver R2/R4)
13 Transparência ativa (apoio) Blog público com QR, tours 360 públicos, manuais MCASP/Patrimônio públicos e linkáveis — o Portal de Transparência oficial permanece papel do Estruturante ✅ CONFORME (papel de apoio)
14 CTM ↔ Ativo Imobilizado (PCASP 1.2.3) Imóveis com shapes GIS, EADM, contas 1.2.3.2.x, validações espaciais, CIB-SINTER em rota ✅ CONFORME
15 MSC/SICONFI Envio da MSC é responsabilidade do Estruturante — o PatriID fornece subsídios (balancete de inventário, conciliação balancete×bens) ⚪ N/A (fora de escopo, com apoio)
16 Formalização legal (decreto, portaria, termos) Obrigação do ente; o pacote de 7 modelos prontos existe (Modelos_SIAFIC_Autorizacao_Acesso.docx) ⚪ Pendência do ente (checklist Fase 1)

2. Gaps identificados (priorizados)

Gap Descrição Risco Esforço
G1 Webservice de lote contábil para o Estruturante (JSON/XML dos eventos: depreciação mensal, incorporações, baixas, reavaliações) em vez de arquivo EL manual Alto — é o requisito literal do art. 14 § único Médio: endpoint /api/siafic/lote-contabil?competencia= sobre as views EL + eventos do período; formato configurável por fornecedor do Estruturante
G2 Rotina mensal automática de depreciação (job que fecha a competência, gera o lote D-VPD/C-Depreciação Acumulada com memória e notifica) Alto — "depreciação mensal" é o item mais cobrado pelos TCEs Baixo: agendar o motor existente (cron) + relatório de memória por competência
G3 Workflow obras → capitalização (registro de intervenção com classificação manutenção×melhoria assistida por IA, trava de baixa do componente antigo) Médio Médio: formulário no módulo Obras + regras do manual já codificadas nas tools
G4 Imutabilidade formal do log (log_acoes é tabela comum) Médio — art. 8º pede trilha imutável Baixo: trigger append-only (REVOKE UPDATE/DELETE + regra), retenção definida
G5 Senhas legadas em texto até o 1º login (migração bcrypt gradual) + ausência de MFA para perfis MASTER Médio Baixo: forçar troca no próximo login; MFA TOTP opcional p/ admins

3. Checklist de implementação

Fase 1 — Formalização legal (semanas 1–2) · responsável: ente + CC Patrimonial

Fase 2 — Endurecimento do PatriID (semanas 2–4) · responsável: CC Patrimonial

Fase 3 — Integração automática (semanas 4–8) · responsável: CC Patrimonial + fornecedor do Estruturante

Fase 4 — Operação e prova de conformidade (contínuo)

4. Pontos fortes a destacar em auditoria

  1. Trilha de auditoria em três camadas (log estruturado com valor anterior + e-mail de gestão em tempo real + auditoria específica de IA com custo);
  2. Gate de qualidade contábil antes de qualquer exportação (semáforo por conta, conta analítica obrigatória, terreno não depreciável);
  3. Prova documental nativa: termos/selos assinados, laudos NBR 14653 e memórias de cálculo arquivados por bem;
  4. Manuais normativos embutidos e públicos (MCASP 11ª Ed. com texto oficial do Cap. 11 + Manual de Patrimônio) com agente de consulta;
  5. Isolamento por ente (banco por tenant) e backups verificáveis (SHA-256).

Relatório técnico produzido a partir da análise do código-fonte e da operação real da frota PatriID; complementa a apresentação PatriID_Sistema_Auxiliar_SIAFIC.pptx (atualizar nela as menções "MCASP 9ª Ed." para 11ª Edição) e o pacote de modelos DOCX.

Dossiê Executivo de Conformidade Final

Integração Tecnológica, Governança Fiduciária e Transição de Sistemas (PatriID ↔ SIAFIC)

Análise de Aderência Normativa ao Decreto Federal nº 10.540/2020, NBC TSP 07 e MCASP 11ª Edição


1. IDENTIFICAÇÃO DO DOSSIÊ


2. SUMÁRIO EXECUTIVO

O presente relatório consolida o diagnóstico técnico-operacional e a comprovação fiduciária do processo de transição tecnológica do município para atendimento às exigências do Decreto Federal nº 10.540/2020 (Diretrizes do SIAFIC) [8, 35].

O PatriID, atuando na qualidade de Sistema Complementar (Auxiliar) especializado [11, 35], foi submetido a uma varredura completa de conformidade com base no seu código-fonte, infraestrutura de banco de dados e fluxos operacionais [35].

Placar de Conformidade Inicial (Diagnóstico de Partida):

Parecer de Partida: O sistema de patrimônio do município não apresentava nenhum descumprimento estrutural ou conceitual [35]. Os poucos pontos classificados como parciais referiam-se estritamente a gaps de processos integrados (transição de arquivos manuais para consumo automatizado via API/Webservice) [35]. Estes gaps, historicamente, são apontados pelos Tribunais de Contas Estaduais (TCE) como os principais geradores de rejeição prévia de contas públicas municipais [35].


3. DIAGNÓSTICO DOS RISCOS DA INÉRCIA ADMINISTRATIVA

A permanência no modelo legado de gestão patrimonial (com transferências manuais de dados por planilhas eletrônicas ou ausência de rotinas sistemáticas de depreciação mensal) expõe a prefeitura e seus gestores a severas penalidades fiscais e jurídicas: [11, 35]

  1. Bloqueio no CAUC (Tesouro Nacional): O descumprimento da integridade tempestiva e do envio automático impede a consolidação da Matriz de Saldos Contábeis (MSC), gerando o bloqueio automático de transferências voluntárias da União e do Estado (Art. 51 da LRF) [10, 11, 12]. O município fica impedido de captar recursos descricionários e firmar novos convênios [12].
  2. Rejeição de Contas pelo Tribunal de Contas (TCE): A ausência de depreciação acumulada ou de testes de impairment (recuperabilidade) gera distorções de grande materialidade no Balanço Geral [12]. Sob a ótica da Lei da Ficha Limpa, isso acarreta a rejeição das contas anuais de governo [12].
  3. Veto a Operações de Crédito (Senado Federal / STN): A irregularidade no SIAFIC bloqueia a autorização para a prefeitura contratar empréstimos de fomento e investimentos estruturantes (como Finisa, BNDES ou emissores multilaterais) [13].
  4. Improbidade Administrativa (Poder Judiciário): Com base na Lei Federal nº 8.429/1992, o Prefeito Municipal (responsável ordenador) e o Contador-Chefe respondem de forma solidária e pessoal por negligência ou omissão no controle patrimonial de bens públicos [13].

4. MATRIZ DETALHADA DE ADERÊNCIA TECNOLÓGICO-CONTÁBIL

Abaixo está o mapeamento dos requisitos legais e como as funcionalidades nativas do PatriID garantem a blindagem jurídica e a consistência técnica dos registros municipais:

# Exigência Legal e Conceitual Dispositivo Normativo Mecanismo de Atendimento Técnico no PatriID
01 Trilha de Auditoria Imutável (Audit Trail) Art. 8º do Decreto nº 10.540/2020 [16, 37] Registro permanente na tabela patriid.log_acoes contendo usuário, timestamp, IP, user-agent e payloads dados_anteriores/dados_novos em formato JSONB. Triggers ativas no banco de dados bloqueiam comandos de UPDATE e DELETE ordinários (append-only) [16, 37, 38].
02 Controle de Acesso Individualizado Art. 8º do Decreto nº 10.540/2020 & LGPD [37] Acesso exclusivo por credenciais individuais com controle de nível hierárquico (até MASTER), limites por agente de inteligência artificial e mecanismo de auto-logout por inatividade de 10 minutos [37].
03 Tempestividade do Registro Patrimonial Art. 6º, III do Decreto nº 10.540/2020 [37] Coleta física em campo por aplicativo móvel com funcionamento offline-first e sincronização em tempo real das movimentações, baixas e vistorias ao servidor central [37].
04 Unicidade e Segregação de Base Art. 5º do Decreto nº 10.540/2020 [16, 37] Arquitetura técnica multi-tenant com segregação física de banco de dados por ente, eliminando cruzamento de informações ou o uso de planilhas paralelas de controle [16, 37].
05 Depreciação Sistemática Mensal NBC TSP 07 & MCASP Parte II, Cap. 11 [14] Motor automático de depreciação mensal parametrizado no critério pró-rata die e arredondamento financeiro de precisão ao par mais próximo (Banker's Rounding), emitindo folhas de cálculo analíticas individuais para auditorias do TCE [14, 31, 37].
06 Qualidade do PCASP (Bloqueio de Sintéticas) Instruções STN & Regras do SIAFIC [14, 23, 24] Validador preventivo que confere os códigos de conta antes de processar as transações, bloqueando de forma automática qualquer lançamento direcionado a contas sintéticas (ex: final .00) ou marcadas como inativas para o exercício [23, 24, 31, 37].
07 Triagem de Despesas (VPD vs. Capitalização) MCASP 11ª Edição [15, 37] Assistente inteligente que avalia os gastos em vistorias de obras públicas, forçando o enquadramento de manutenções de rotina como despesas do exercício (VPD) ou reformas que estendem a vida útil como capitalização do ativo imobilizado [15, 31, 37].
08 Evidenciação e Notas Explicativas NBC TSP 07 & Transparência Pública [37] Parametrização estrita da política contábil subsequente do imobilizado (Modelo do Custo) e geração automática de minutas descritivas de mensuração e vida útil econômica para inclusão no Balanço Consolidado [28, 31, 37].
09 Integração Territorial Georreferenciada PCASP Grupo 1.2.3.x & Diretrizes CTM [17, 37] Vinculação direta da inscrição imobiliária municipal no Cadastro Territorial Multifinalitário (CTM) aos ativos de terrenos e edificações públicas municipais [17]. Registra poligonais georreferenciadas e fotos reais em campo, preparando o município para o tráfego recíproco de dados com o Cadastro Imobiliário Brasileiro (CIB) e com o SINTER do Governo Federal [17, 37].

5. PLANO DE RESOLUÇÃO DOS GAPS (ENTREGAS E ARTEFATOS CONCLUÍDOS)

Para elevar a conformidade do município ao nível de excelência absoluto (13 requisitos em conformidade, 0 parciais, 0 não conformes) [36], foram desenvolvidos e publicados no painel Estúdio os seguintes instrumentos técnicos e operacionais de governança contábil-patrimonial:

A. Formalização Jurídica e Administrativa (Fase 1 do Roadmap) [19]

B. Saneamento Físico e Organização Territorial (Fase 2 do Roadmap) [20]

C. Homologação Técnica de Rede e APIs (Fase 3 do Roadmap) [20]

D. Operação Contínua e Transparência Fiduciária (Fase 4 do Roadmap) [21]


6. CRONOGRAMA INTEGRADO DE IMPLANTAÇÃO (12 SEMANAS)

O cronograma segue o planejamento técnico linear distribuído em quatro grandes etapas de execução: [18, 19]

Semanas: 1   2   3   4   5   6   7   8   9   10   11   12
Fase 1:  [=======] (Formalização Legal, Nomeações e Atos Oficiais) [19]
Fase 2:      [===================================] (Inventário, Campo, NBR 14653 e CTM) [20]
Fase 3:                      [=======================] (Conectividade, APIs e Homologação) [20]
Fase 4:                              [===================> (Operação Contínua no SIAFIC) [21]

7. CONCLUSÃO E PARECER DE AUDITORIA INTERNA

A análise técnica atesta que o município de [NOME DO MUNICÍPIO] / [UF] possui todas as ferramentas operacionais, normativas, técnicas e contábeis necessárias para implementar uma transição 100% conforme em relação às regras estabelecidas pelo Decreto Federal nº 10.540/2020 [8].

A implantação do ecossistema integrado PatriID ↔ SIAFIC resolve definitivamente o histórico passivo contábil-patrimonial das gestões passadas [33]. Ao automatizar a depreciação sistemática (NBC TSP 07), o bloqueio preventivo de PCASP e a triagem fiduciária de melhorias em bens vinculados ao georreferenciamento (CTM/SINTER), o município blinda seus ordenadores de despesa, assegura a adimplência fiscal contínua no CAUC e garante que o Balanço Geral de Contas do exercício de 2026 seja transmitido ao SICONFI com total fidedignidade material [10, 11, 12, 17, 33, 37].

O dossiê de transição técnica está formalmente instituído, documentado e pronto para fiscalização externa do Tribunal de Contas do Estado [9].


Gerado eletronicamente para fins de auditoria interna e governança fiduciária municipal.

Plano de Adequação — Itens PARCIAIS da Matriz (4, 5, 6 e 8) · CC Patrimonial × Administração Municipal × E&L

Objeto: adequação dos itens 4, 6, 5 e 8 da Matriz de Conformidade (Relatório Técnico PatriID × SIAFIC) — os únicos com parecer 🟡 PARCIAL. Base: Decreto 10.540/2020 (arts. 5º, 6º, 8º e 14), NBC TSP 07 e MCASP 11ª Edição (Parte II, Cap. 11) · Espec. da API de Lote Contábil v1.0. Método: responsabilidades diferenciadas por ator — CC PATRIMONIAL (PatriID, sistema complementar), ADMINISTRAÇÃO MUNICIPAL (ente/contador) e E&L PRODUÇÃO DE SOFTWARE (fornecedora do Sistema Estruturante).

Quadro-resumo (visão executiva)

Item Exigência Gap Ação-chave CC Patrimonial Ação-chave Município Ação-chave E&L Meta
4 Tempestividade do reflexo contábil (art. 6º, III) Reflexo depende de exportação periódica Fila de eventos por competência + lote D+1/mensal Calendário de fechamento em ato normativo Ingestão automática agendada Fase 3
5 Integração por API — vedada exportação manual (art. 14 § único) Ponte atual = arquivo EL manual Endpoint /api/siafic/lote-contabil (espec. v1.0) + adaptador E&L Decreto art. 14 + termo de autorização + credenciais API/rotina de recepção + ambiente de homologação + protocolo de retorno Fase 3
6 Depreciação mensal com memória (NBC TSP 07 · MCASP 11ª) Cálculo sob demanda; sem job mensal Job de fechamento de competência + memória arquivada + lote D-VPD/C-Dep.Acum. Política contábil aprovada + validação mensal do contador Contabilização automática do lote na competência + confirmação Fase 2/3
8 Distinção VPD × capitalização (MCASP · NBC TSP 07) Orientação assistida, sem workflow com trava Workflow Obras→Capitalização com trava de baixa do componente Portaria de materialidade + segregação de funções + capacitação Contas de OA/VPD parametrizadas + eventos de transferência Fase 4

Item 4 — Tempestividade do reflexo contábil (art. 6º, III)

Exigência: o fato patrimonial (aquisição, baixa, transferência, avaliação) deve refletir na contabilidade no momento em que ocorre — não semanas depois, no fechamento.

Situação atual: o PatriID registra o fato em tempo real (coleta mobile sincronizada, trilha de auditoria imediata), mas o reflexo no Estruturante depende da geração periódica da Exportação EL.

Ações — CC PATRIMONIAL

  1. Implementar a fila de eventos contábeis por competência (cada fato patrimonial gera evento tipado: incorporação, baixa, transferência, reavaliação, impairment — já modelados nos exemplos JSON da Parte V);
  2. Transmissão D+1 dos eventos de gestão e mensal para depreciação (calendário técnico pareado com o item 6);
  3. Painel "Pendências de reflexo contábil" no Fechamento: eventos gerados × transmitidos × confirmados pela E&L (conciliação ponta-a-ponta);
  4. Alerta automático (e-mail gestao@) quando um evento passar de 24h sem transmissão ou sem confirmação.

Ações — ADMINISTRAÇÃO MUNICIPAL

  1. Definir em ato normativo o calendário de integração (eventos de gestão em D+1; lote de depreciação até o 5º dia útil da competência seguinte);
  2. Designar o responsável (Gestor de Dados, Modelo 2) pela aprovação do lote antes da transmissão — aprovação eletrônica, não retrabalho manual;
  3. Instituir a conciliação mensal com ata assinada (modelo na Parte VI) — contador × relatório de eventos do PatriID.

Ações — E&L PRODUÇÃO DE SOFTWARE

  1. Disponibilizar recepção automática agendada (pull diário do endpoint ou push aceito em API própria) — sem digitação/importação manual de arquivo;
  2. Contabilizar na data do fato/competência do evento (não na data da importação), preservando a tempestividade do art. 6º;
  3. Devolver confirmação por evento (nº do lançamento contábil) para o painel de conciliação.

Critério de aceite (TCE): amostra de 20 fatos patrimoniais com data do fato × data do lançamento no Estruturante ≤ prazo do calendário normativo.


Item 5 — Integração por API/webservice (art. 14, § único) — o gap central

Exigência: sistemas complementares geram informação "de forma integrada, tempestiva e automática"; a exportação manual de arquivos no fechamento é prática vedada.

Situação atual: a ponte é o arquivo EL (48 colunas móveis / 35 imóveis), gerado com gate de qualidade (semáforo por conta), porém transmitido manualmente.

Ações — CC PATRIMONIAL

  1. Implementar o endpoint GET/POST /api/siafic/lote-contabil conforme a Especificação v1.0 (Parte V): JSON por competência com eventos tipados, idempotência (reenvio seguro por lote_id), hash de integridade (HMAC) e paginação;
  2. Validação PCASP prévia de todo lote (utilitário validador-contas-pcasp da Parte V): conta analítica válida, natureza compatível, D=C por lote;
  3. Adaptador E&L: mapeamento do JSON canônico para o layout/contrato que a E&L homologar (o layout EL atual vira o "dialeto" do adaptador);
  4. Credencial dedicada por município (escopo mínimo, rotação, cofre de segredos) + log de transmissão na trilha de auditoria (art. 8º);
  5. Manter a exportação manual apenas como contingência documentada após a homologação.

Ações — ADMINISTRAÇÃO MUNICIPAL

  1. Publicar o Decreto de classificação do PatriID como Sistema Complementar (art. 14 — Modelo 1) e a Portaria do Gestor de Dados (Modelo 2);
  2. Encaminhar à E&L o Requerimento de Integração (Modelo 3) e emitir o Termo de Autorização de Acesso à API (Modelo 4);
  3. Formalizar, após a homologação, a vedação da exportação manual como via ordinária (a contingência exige justificativa registrada);
  4. Prever a integração nos contratos/aditivos com a E&L (obrigação de interoperabilidade — art. 14 § único como fundamento).

Ações — E&L PRODUÇÃO DE SOFTWARE

  1. Expor API de recepção de lotes (ou rotina de ingestão automática agendada do contrato acordado) com ambiente de homologação;
  2. Retornar protocolo por lote (aceito/rejeitado, erros de validação contábil linha a linha — mesmo padrão do SICONFI);
  3. Garantir contabilização automática dos lotes aceitos, sem redigitação;
  4. Firmar SLA de disponibilidade e prazo de processamento;
  5. Participar da homologação em paralelo (item 6/roteiro da Parte V): 1 competência com lote automático × lançamento manual até bater ao centavo.

Critério de aceite (TCE): encerramento de competência sem intervenção manual — evidência = logs de transmissão + protocolos E&L + ata de homologação.


Item 6 — Depreciação mensal automatizada com memória de cálculo

Exigência: NBC TSP 07/MCASP 11ª — apuração mensal da depreciação, com memória de cálculo (prova técnica) e reflexo contábil (D — VPD Depreciação / C — Depreciação Acumulada, conta retificadora PCASP).

Situação atual: o motor existe e é correto (pró-rata die, banker's rounding, métodos linear/soma dos dígitos/unidades — alinhado à 11ª Edição), com memória auditável — mas roda sob demanda, sem fechamento mensal automático.

Ações — CC PATRIMONIAL

  1. Job mensal de fechamento de competência (agendado): calcula a depreciação de todos os bens depreciáveis do ente (terrenos excluídos), respeitando método por classe e valor residual da política contábil;
  2. Memória de cálculo por competência arquivada (PDF + CSV imutáveis por bem: base depreciável, taxa, dias, valor do mês, acumulado) — a prova que o TCE pede;
  3. Geração automática do lote contábil da competência agregado por conta PCASP (alimenta os itens 4/5) + trava de reprocessamento retroativo (reabertura só com justificativa auditada);
  4. Notificação ao contador com o resumo (total por conta, variações atípicas > X% para revisão) antes da transmissão.

Ações — ADMINISTRAÇÃO MUNICIPAL

  1. Aprovar formalmente a política de depreciação (vidas úteis por classe, valor residual, método — Modelo 1, art. 5º do decreto);
  2. Validação mensal pelo contador (CRC): conferir e aprovar a memória de cálculo antes do lote seguir (responsabilidade solidária — Modelo 5);
  3. Evidenciar em notas explicativas (modelos da Parte VI) o método, as taxas e o total depreciado no exercício;
  4. Revisar anualmente vida útil e valor residual (exigência da 11ª Edição) e registrar a revisão em ata.

Ações — E&L PRODUÇÃO DE SOFTWARE

  1. Parametrizar as contas de VPD de depreciação (3.3.3.x) e retificadoras (1.2.3.x.x.99/depreciação acumulada) aceitas no lote;
  2. Contabilizar o lote na competência de referência (não na data de recepção);
  3. Devolver a confirmação dos lançamentos para compor a trilha ponta-a-ponta (memória → lote → lançamento).

Critério de aceite (TCE): 3 competências seguidas com depreciação lançada até o 5º dia útil, memória arquivada e balancete refletindo a variação.


Item 8 — Distinção VPD × capitalização (workflow de obras/intervenções)

Exigência: MCASP/NBC TSP 07 — gasto que melhora (amplia vida útil, capacidade ou padrão) capitaliza; gasto que apenas restaura é despesa (VPD). Em substituição de componente, é obrigatória a baixa do componente antigo antes da capitalização do novo.

Situação atual: a doutrina está embutida (manuais + habilidades + tools de classificação assistida), mas não há workflow com trava que impeça a capitalização sem baixa ou a classificação sem critério.

Ações — CC PATRIMONIAL

  1. Implementar o Workflow Obras → Capitalização (roteiro na Parte VI): registro da intervenção → classificação assistida por IA (teste melhoria × restauração, citando o manual MCASP) → decisão humana registrada;
  2. Se capitalizável: lançamento em Obras em Andamento (sem depreciar) → na conclusão, trava obrigatória: o sistema exige a baixa do componente substituído (valor residual → VPD) antes de capitalizar o novo e abrir o novo ciclo de depreciação;
  3. Se manutenção: registro como VPD com vínculo ao bem (histórico de intervenções por bem);
  4. Relatório de intervenções da competência (capitalizadas × despesadas, com a justificativa de cada classificação) — anexo da conciliação mensal;
  5. Eventos correspondentes no lote contábil (transferência OA→ativo, baixa de componente, VPD de manutenção — exemplos JSON já especificados).

Ações — ADMINISTRAÇÃO MUNICIPAL

  1. Portaria de materialidade e critérios: limiar de valor para componentização, tabela de vidas úteis por componente (telhado 25a, elétrica 25a, HVAC 15a etc. — manual MCASP) e o teste prático melhoria × restauração;
  2. Segregação de funções: quem registra a intervenção (obras/engenharia) ≠ quem aprova a classificação (patrimônio/contabilidade);
  3. Capacitar as equipes de obras e patrimônio (plano de capacitação da Parte VI) no critério VPD × ativo;
  4. Contador revisa mensalmente as classificações no relatório de intervenções.

Ações — E&L PRODUÇÃO DE SOFTWARE

  1. Aceitar no lote os eventos do ciclo de obras: registro em Obras em Andamento (1.2.3.2.1.03), transferência OA → conta definitiva, baixa de componente (VPD) e VPD de manutenção;
  2. Manter o vínculo do lançamento ao bem/intervenção (campo de referência do evento) para auditoria cruzada;
  3. Não permitir reclassificação manual do lote sem retorno formal ao PatriID (unicidade da base — art. 5º).

Critério de aceite (TCE): amostra de intervenções do exercício com classificação justificada, baixas de componente correspondentes e reflexo correto no balanço (sem "ativo fantasma" de componente substituído).


Cronograma consolidado e governança do plano

Fase Semanas Entregas deste plano
1 — Formalização 1–2 Decreto art. 14, Portaria, Termos (itens 4/5), política de depreciação (item 6), portaria de materialidade (item 8)
2 — Endurecimento 2–4 Job mensal de depreciação + memória por competência (item 6); painel de pendências de reflexo (item 4)
3 — Integração 4–8 Endpoint + adaptador E&L + homologação em paralelo (itens 4/5); lote de depreciação transitando pela API (item 6)
4 — Operação contínuo Workflow obras com trava (item 8); conciliação mensal com ata; auditoria das classificações

Papéis (RACI simplificado): CC Patrimonial — Responsável técnico pelos componentes do PatriID e pelo adaptador; Administração Municipal — Aprovadora (atos, política contábil, validações do contador CRC e atas); E&L — Responsável técnico pela recepção/contabilização no Estruturante e pelos protocolos de retorno. Reunião mensal tripartite de acompanhamento até a conclusão da Fase 3; após, revisão trimestral.

Resultado esperado: os 4 itens migram de 🟡 PARCIAL para ✅ CONFORME, elevando o placar da matriz para 13 conformes · 0 parciais — com evidência documental pronta para o TCE em cada item.

Checklist de Conformidade — TCE

Nos termos do Decreto Federal nº 10.540/2020 (SIAFIC), da NBC TSP 07 e do MCASP 11ª Edição

Finalidade: Documento de autoavaliação e controle interno para fins de auditoria do Tribunal de Contas do Estado (TCE) e consolidação da prestação de contas anual do município. Deve ser preenchido pelo Gestor de Dados e pelo Contador-Chefe do Município antes do encerramento de cada exercício financeiro ou no fechamento de cada quadrimestre, sendo arquivado juntamente com o dossiê da prestação de contas.


1. Identificação do Ente e do Sistema

Campo Preenchimento
Município / UF ______ / ____
Poder / Órgão [ ] Poder Executivo [ ] Poder Legislativo [ ] Autarquia/Fundação
Exercício Fiscal 20______
Sistema Complementar Avaliado PatriID (Gestão de Patrimônio e Cadastro Territorial - CTM)
Data da Avaliação __ / _ / 20___
Responsável pelo Preenchimento Nome: ______ CRC/Cargo: ______

2. Tabela de Conformidade Técnica e Legal

# Item de Conformidade (Fundamentação) Status Evidência / Referência Documental
1 Decreto Municipal de Classificação publicado
(Art. 14 do Decreto Federal nº 10.540/2020)
Formaliza perante o TCE que o PatriID opera como Sistema Complementar ao SIAFIC municipal.
[ ] OK
[ ] NOK
Número do Decreto: _____
Data de Publicação: __/_/20___
2 Portaria de nomeação do Gestor de Dados SIAFIC
(Art. 8º do Decreto Federal nº 10.540/2020)
Designa o servidor efetivo responsável técnico pela administração das chaves e credenciais de API.
[ ] OK
[ ] NOK
Número da Portaria: _____
Data de Publicação: __/_/20___
3 Termo de Responsabilidade Técnica assinado
(Decreto 10.540/2020, NBC TSP 07, MCASP)
Assinado pelo Contador-Chefe (com CRC ativo), homologando o motor de depreciação e o mapeamento do PCASP.
[ ] OK
[ ] NOK
Nome do Contador: _____
Data de Assinatura: __/_/20___
4 Termo de Autorização de Acesso emitido
(Decreto Federal nº 10.540/2020)
Emitido pelo Secretário de Fazenda autorizando a liberação de credenciais de escrita (POST/PUT) no SIAFIC.
[ ] OK
[ ] NOK
Número do Termo: _____
Data de Emissão: __/_/20___
5 Integração nativa via API/Webservice ativa
(Art. 14, parágrafo único, do Decreto 10.540/2020)
Vedada a exportação manual periódica de arquivos de dados como rotina operacional ordinária.
[ ] OK
[ ] NOK
URL do Endpoint da API:
https://___________________________________
6 PCASP validado em nível analítico
(Portaria STN nº 6.424/2016 - MSC)
Validação na ponta que impede o tráfego de lançamentos contábeis direcionados a contas sintéticas ou extintas.
[ ] OK
[ ] NOK
Versão do PCASP Municipal: 20__
Código do Validador:
______
7 Motor de depreciação mensal ativo e conciliado
(NBC TSP 07 e MCASP 11ª Edição)
Execução automatizada da depreciação com cálculo pró-rata dia, arredondamento financeiro e memória de cálculo.
[ ] OK
[ ] NOK
Relatório de Memória de Cálculo nº: _
Diferença Razão x Patrimônio: R$ _
8 Separação VPD (Manutenção) vs. Ativo (Melhoria)
(MCASP 11ª Edição, Parte II, Capítulo 11)
Assistente que diferencia despesa imediata de conservação de investimentos que ampliam a vida útil do bem.
[ ] OK
[ ] NOK
Código da Transação Exemplo: ___
Id do Bem Imóvel/Móvel:
___
9 Trilha de Auditoria Imutável (Audit Trail)
(Art. 8º do Decreto Federal nº 10.540/2020)
Log de ações "append-only" gravando usuário, timestamp do servidor, IP, user-agent, valor anterior e novo (JSONB).
[ ] OK
[ ] NOK
Tabela de Banco de Dados: patriid.log_acoes
Última Auditoria Física em: _/_/20____
10 Testes homologados em ambiente de testes
(Diretriz Técnica de Segurança de Dados)
Execução de rotinas de carga e simulações completas em ambiente de homologação antes de migrar para a produção.
[ ] OK
[ ] NOK
Data do Último Teste: __/_/20
ID do Ticket de Homologação:
____
11 Notas Explicativas automáticas geradas
(NBC TSP 07 - Itens de Evidenciação)
Geração automatizada de notas explicativas contendo o método de mensuração (Modelo do Custo) e taxas aplicadas.
[ ] OK
[ ] NOK
Arquivo PDF ou Código do Relatório:
___________
12 Protocolo de Revogação de Acesso atualizado
(Segurança da Informação e Decreto 10.540/2020)
Execução do cancelamento imediato de tokens e inativação de IPs na whitelist para servidores exonerados.
[ ] OK
[ ] NOK
Data da Última Revogação: _//20__
Nº do Protocolo de Revogação: _____
13 Situação do CAUC Municipal monitorada
(Art. 48 e 51 da LRF)
Verificação de pendências fiscais que possam bloquear o recebimento de transferências voluntárias da União/Estado.
[ ] OK
[ ] NOK
Data da Última Consulta CAUC: _/_/20____
Situação de Pendências: [ ] Regular [ ] Irregular

3. Avaliação de Resultados

Indicador Quantidade Observações
Total de Itens Avaliados 13 Quantidade total de requisitos técnico-legais exigidos.
Itens Conformes (OK) ______ Requisitos plenamente atendidos e com evidência documental.
Itens Não Conformes (NOK) ______ Gaps que exigem correção imediata antes do encerramento do exercício.

⚠️ Atenção: Qualquer item assinalado com status NOK deve constar obrigatoriamente de um Plano de Ação de Saneamento, com prazo máximo de regularização de 30 dias, sob risco de apontamento de irregularidades nas contas pelos auditores do Tribunal de Contas.


4. Plano de Ação para Itens Não Conformes (NOK)

Item # Descrição do Gap Identificado Ação Corretiva Necessária Prazo Limite Servidor Responsável

5. Referências de Fundamentação Legal


[Cidade - UF], __ de ____ de 20______.


[NOME DO CONTADOR(A)-CHEFE] Contador(a) Responsável - CRC-__ nº _______


[NOME DO GESTOR(A) DE DADOS SIAFIC] Gestor(a) de Dados - Matrícula nº ___


Parte V — Especificação Técnica de Integração

API de Lote Contábil — Especificação (v1.0)

Versão: 1.0 — Julho de 2026
Status: Proposta de Integração de Sistemas Complementares (PatriID)
Fundamentação Legal: Decreto Federal nº 10.540/2020, NBC TSP 07, MCASP 11ª Edição (vigência 2025), e Portaria STN nº 6.424/2016 (MSC).

Este documento especifica o contrato técnico de comunicação para a transmissão automática e tempestiva de lotes contábeis gerados pelo sistema de patrimônio (Sistema Complementar - PatriID) para o Sistema Estruturante (SIAFIC) do município, conforme exigido pelo Art. 14, parágrafo único, do Decreto nº 10.540/2020.


1. Visão Geral do Endpoint


2. Exemplo de Payload JSON (Lote Contábil Completo)

O JSON abaixo exemplifica um lote contábil contendo três tipos de eventos patrimoniais fundamentais: 1. Depreciação Mensal (Ativo Imobilizado de Saúde). 2. Incorporação de Bem Móvel (Aquisição de Veículo). 3. Baixa de Ativo (Desfazimento por inservibilidade).

{
  "id_lote": "LOTE-PATR-202607-0042",
  "competencia": "2026-07",
  "data_geracao": "2026-07-26T09:22:00Z",
  "cnpj_municipio": "12.345.678/0001-90",
  "sistema_origem": "PatriID",
  "versao_layout": "1.0",
  "gestor_dados_cpf": "123.456.789-00",
  "resumo": {
    "total_eventos": 3,
    "valor_total_lote": 142350.75,
    "total_debitos": 142350.75,
    "total_creditos": 142350.75
  },
  "eventos": [
    {
      "id_evento_origem": "EVT-DEP-202607-4201",
      "tipo_evento": "DEPRECIAÇÃO",
      "data_fato": "2026-07-26",
      "patrimonio_tombamento": "M-10294",
      "descricao_fato": "Depreciação mensal automática (Competência 2026-07) - Equipamento de Raio-X CCP-SAUDE",
      "lancamentos": [
        {
          "sequencia": 1,
          "conta_debito": "3.3.3.1.1.01.01.00.00.00",
          "conta_credito": "1.2.3.8.1.01.02.01.00.00",
          "valor": 350.75,
          "fonte_recurso": "1.500.1002",
          "historico_padrao": "901",
          "informacao_complementar": "DEPRECIAÇÃO MENSAL"
        }
      ],
      "audit_trail": {
        "usuario": "sistema.depreciacao",
        "timestamp": "2026-07-26T01:00:05Z",
        "valor_anterior": 4209.00,
        "valor_novo": 4559.75,
        "campo_alterado": "depreciacao_acumulada"
      }
    },
    {
      "id_evento_origem": "EVT-INC-202607-4202",
      "tipo_evento": "INCORPORAÇÃO",
      "data_fato": "2026-07-26",
      "patrimonio_tombamento": "M-10295",
      "descricao_fato": "Incorporação de veículo adquirido conforme Nota Fiscal nº 49302 - Ambulância de Suporte Básico",
      "lancamentos": [
        {
          "sequencia": 1,
          "conta_debito": "1.2.3.1.1.03.01.00.00.00",
          "conta_credito": "2.1.3.1.1.01.01.00.00.00",
          "valor": 125000.00,
          "fonte_recurso": "1.600.0000",
          "historico_padrao": "902",
          "informacao_complementar": "INCORPORAÇÃO POR COMPRA"
        }
      ],
      "audit_trail": {
        "usuario": "joao.patrimonio",
        "timestamp": "2026-07-26T09:15:22Z",
        "valor_anterior": 0.00,
        "valor_novo": 125000.00,
        "campo_alterado": "saldo_imobilizado"
      }
    },
    {
      "id_evento_origem": "EVT-BAX-202607-4203",
      "tipo_evento": "BAIXA",
      "data_fato": "2026-07-26",
      "patrimonio_tombamento": "M-08942",
      "descricao_fato": "Baixa física e contábil de veículo inservível (leilão homologado) - Plaqueta M-08942",
      "lancamentos": [
        {
          "sequencia": 1,
          "conta_debito": "1.2.3.8.1.01.03.00.00.00",
          "conta_credito": "1.2.3.1.1.03.01.00.00.00",
          "valor": 17000.00,
          "fonte_recurso": "1.500.0000",
          "historico_padrao": "903",
          "informacao_complementar": "BAIXA DE ATIVO"
        }
      ],
      "audit_trail": {
        "usuario": "maria.auditora",
        "timestamp": "2026-07-26T09:18:10Z",
        "valor_anterior": 17000.00,
        "valor_novo": 0.00,
        "campo_alterado": "saldo_imobilizado"
      }
    }
  ]
}

3. Regras de Validação Contábil (Gate de Qualidade)

Para que o lote seja aceito e processado pelo SIAFIC, o integrador do sistema complementar deve garantir as seguintes regras em seu motor de fechamento:

  1. Validação do PCASP Vigente: As contas de débito e crédito devem ser estritamente analíticas e ativas no exercício contábil vigente. Lançamentos direcionados a contas sintéticas (ex: terminadas em .00 dependendo da parametrização ou contas pai) serão sumariamente rejeitados.
  2. Equilíbrio de Partidas Dobradas: A soma de todos os débitos do lote deve coincidir exatamente com a soma de todos os créditos (total_debitos == total_creditos).
  3. Consistência de Arredondamento: Valores monetários devem utilizar 2 casas decimais e seguir o método de arredondamento bancário (Banker's Rounding / Round Half to Even), evitando divergências de centavos em grandes volumes de depreciação.
  4. Trilha de Auditoria (Audit Trail) Imutável: Cada evento contábil de mutação patrimonial deve registrar obrigatoriamente as informações de auditoria estruturadas no objeto audit_trail, registrando o usuário logado, timestamp UTC, campo alterado, valor anterior e novo saldo.
  5. Granularidade da Matriz de Saldos Contábeis (MSC): Cada lançamento deve vir acompanhado da sua respectiva classificação de Fonte de Recursos (fonte_recurso) em conformidade com as diretrizes da Secretaria do Tesouro Nacional (STN).

4. Respostas da API (Contrato HTTP)

Sucesso (201 Created)

Retornado quando o lote passa em todas as validações de estrutura, segurança e regras contábeis, entrando na fila assíncrona de processamento.

{
  "sucesso": true,
  "mensagem": "Lote contábil recebido com sucesso e enviado para processamento.",
  "ticket_processamento": "TK-SIAFIC-202607-88942-A",
  "data_recebimento": "2026-07-26T09:22:15Z",
  "cnpj_municipio": "12.345.678/0001-90",
  "competencia": "2026-07",
  "eventos_processados": 3
}

Erro de Validação Contábil (400 Bad Request)

Retornado caso o lote viole alguma regra de negócio contábil, indicando exatamente o ponto de falha para correção automatizada.

{
  "sucesso": false,
  "erro_codigo": "ERR_VALIDACAO_PCASP",
  "mensagem": "O lote foi rejeitado devido a inconsistências nas contas contábeis informadas.",
  "detalhes": [
    {
      "evento_index": 0,
      "id_evento_origem": "EVT-DEP-202607-4201",
      "erro": "A conta_debito '3.3.3.1.1.01.01.00.00.00' foi desativada no PCASP municipal em 31/12/2025. Substituir pela respectiva conta analítica ativa."
    }
  ]
}

Exemplo JSON — Lote misto com CATMAT

Integração do Sistema Complementar (PatriID) ao Sistema Estruturante (SIAFIC)

Este documento apresenta um exemplo prático de contrato de dados (Payload JSON) para envio de um lote de compras misto (recebimento de Notas Fiscais) processado pelo motor de inteligência artificial do CATMAT-AI no PatriID [34]. O payload demonstra como a IA atua na ponta para diferenciar itens de consumo (reconhecimento imediato de VPD ou estocagem) de bens permanentes (capitalização no Ativo Imobilizado) [34, 48], sugerindo as contas contábeis analíticas corretas do PCASP e inserindo metadados de classificação e trilha de auditoria [30, 36, 47].


1. O Cenário de Negócio

O município recebe uma Nota Fiscal de aquisição mista no valor de R$ 12.850,00, contendo: 1. Pneus de reposição imediata (R$ 850,00): O operador do almoxarifado cadastrou os itens. Tradicionalmente, há risco de ativação errônea no imobilizado. A IA (CATMAT-AI) intervém, classifica-o como Material de Consumo (despesa de manutenção imediata - VPD) com base no histórico de uso e diretrizes do MCASP [34, 48]. 2. Aparelho de Ar-Condicionado Split (R$ 12.000,00): A IA identifica como item de utilidade duradoura superior a 1 ano, com controle individualizado e geração de benefícios futuros, classificando-o automaticamente como Ativo Imobilizado (Material Permanente) [31, 34].


2. Payload JSON da API (POST /api/siafic/lote-contabil)

{
  "lote_envio_id": "LOTE-MISTO-CATMATAI-2026-0091",
  "data_transmissao": "2026-07-26T13:34:19Z",
  "municipio_cnpj": "12.345.678/0001-90",
  "documento_origem": {
    "tipo": "NOTA_FISCAL_ELETRONICA",
    "numero": "45091",
    "serie": "1",
    "data_emissao": "2026-07-26T09:00:00-03:00",
    "fornecedor_cnpj": "98.765.432/0001-10",
    "fornecedor_razao_social": "DISTRIBUIDORA MUNICIPAL DE SUPRIMENTOS LTDA",
    "valor_total_nf": 12850.00
  },
  "itens_lote": [
    {
      "item_sequencial": 1,
      "descricao_original_nf": "PNEU RADIAL ARO 15 PARA REPOSICAO VEICULO PLACA MO-1234",
      "quantidade": 2,
      "valor_unitario": 425.00,
      "valor_total": 850.00,
      "catmat_ai_analise": {
        "codigo_catmat_sugerido": "481090",
        "classificacao_natureza": "MATERIAL_DE_CONSUMO",
        "justificativa_ia": "Item destinado à substituição de partes desgastadas para manter o veículo em condições normais de operação, sem estender a vida útil incremental original do bem. Enquadrado como Variação Patrimonial Diminutiva (VPD) imediata conforme NBC TSP 07 e MCASP.",
        "confianca_ia_score": 0.99,
        "validado_por_operador": true,
        "operador_usuario": "jose.silva"
      },
      "lancamento_contabil": {
        "tipo_lancamento": "LANCAMENTO_VPD_CONSUMO_IMEDIATO",
        "debito_conta_analitica": "3.3.1.1.1.16.01.0000",
        "debito_conta_nome": "Material de Consumo - Peças de Reposição para Veículos",
        "credito_conta_analitica": "1.1.1.1.1.19.01.0001",
        "credito_conta_nome": "Caixa e Equivalentes de Caixa - Recursos Ordinários",
        "fonte_recurso": "1.500.1002",
        "valor_lancamento": 850.00
      }
    },
    {
      "item_sequencial": 2,
      "descricao_original_nf": "APARELHO DE AR CONDICIONADO SPLIT 12000 BTUS ECO PLUS",
      "quantidade": 4,
      "valor_unitario": 3000.00,
      "valor_total": 12000.00,
      "catmat_ai_analise": {
        "codigo_catmat_sugerido": "312450",
        "classificacao_natureza": "MATERIAL_PERMANENTE_IMOBILIZADO",
        "justificativa_ia": "Equipamento com vida útil econômica estimada em 5 anos (superior ao limite de 1 ano), controle físico individualizável aplicável e que gera benefícios econômicos/potencial de serviço contínuos. Enquadrado como Ativo Imobilizado nos termos da NBC TSP 07.",
        "confianca_ia_score": 0.98,
        "validado_por_operador": true,
        "operador_usuario": "jose.silva"
      },
      "lancamento_contabil": {
        "tipo_lancamento": "LANCAMENTO_CAPITALIZACAO_IMOBILIZADO",
        "debito_conta_analitica": "1.2.3.1.1.04.05.0002",
        "debito_conta_nome": "Aparelhos e Equipamentos de Comunicação e Climatização - Ativos em Operação",
        "credito_conta_analitica": "1.1.1.1.1.19.01.0001",
        "credito_conta_nome": "Caixa e Equivalentes de Caixa - Recursos Ordinários",
        "fonte_recurso": "1.500.1002",
        "valor_lancamento": 12000.00
      },
      "detalhes_patrimoniais": {
        "vida_util_meses": 60,
        "taxa_depreciacao_mensal": 0.0167,
        "valor_residual": 1200.00,
        "metodo_depreciacao": "QUOTAS_CONSTANTES_PRO_RATA_DIA"
      }
    }
  ],
  "trilha_auditoria": {
    "usuario_autorizador": "jose.silva",
    "nivel_permissao": "OPERADOR_MASTER",
    "timestamp_registro": "2026-07-26T13:30:22Z",
    "dispositivo_ip": "192.168.1.112",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) PatriIDMobile/v2.4",
    "modulo_origem": "PATRIID_ALMOXARIFADO_AQUISICAO",
    "historico_log_banco": {
      "tabela": "patriid.log_acoes",
      "operacao": "INTEGRACAO_LOTE_SIAFIC",
      "dados_anteriores": {},
      "dados_novos": {
        "lote_envio_id": "LOTE-MISTO-CATMATAI-2026-0091",
        "valor_total_lote": 12850.00,
        "analisado_por_ia": true,
        "status": "AGUARDANDO_INTEGRACAO"
      }
    }
  }
}

3. Fluxo de Validação e Regras de Negócio do Endpoint

  [ PatriID: Processamento NF ]
                │
                ▼
   [ CATMAT-AI: Classificação ] ──► (Diferencia Consumo [VPD] vs. Imobilizado [Ativo])
                │
                ▼
 [ Validador PCASP (Semáforo) ] ──► (Bloqueia Contas Sintéticas ou Extintas)
                │
                ▼
 [ API SIAFIC: Lote Contábil ]  ──► (Processamento e Envio Automático Diário)
  1. Diferenciação Automática: O CATMAT-AI faz a varredura da descrição dos itens da NF. Se um item possui características de peça de reposição (como o pneu do Item 1), ele o encaminha para despesa de consumo (VPD) ou controle de almoxarifado. Se possui características de bem patrimonial duradouro (Item 2), gera o cadastro patrimonial de bem móvel individualizado [34, 48].
  2. Validação Ativa do PCASP: O PatriID valida o plano de contas antes do envio [30, 38]. No JSON acima, a conta de climatização de imobilizado (1.2.3.1.1.04.05.0002) é estritamente analítica. Se o sistema tentasse enviar para a conta sintética (1.2.3.1.1.04.05.00), o validador interno bloquearia o envio com código de erro amigável [38, 50].
  3. Trilha de Auditoria Exigida: Em conformidade direta com o Art. 8º do Decreto nº 10.540/2020 (SIAFIC), o objeto trilha_auditoria anexa os metadados de IP, usuário, timestamp e estado de transição de banco (dados_anteriores e dados_novos) no formato JSONB [30, 60].

4. Contratos de Resposta da API do SIAFIC

Cenário A: Sucesso na Integração Contábil (HTTP 201 Created)

Retornado pelo SIAFIC após validação e persistência do lote na base de dados única do município [28]:

{
  "sucesso": true,
  "status_processamento": "CONCLUIDO_COM_SUCESSO",
  "ticket_siafic": "TK-SIAFIC-2026-908123",
  "lote_envio_id": "LOTE-MISTO-CATMATAI-2026-0091",
  "timestamp_processamento": "2026-07-26T13:34:21Z",
  "lancamentos_contabeis_gerados": [
    {
      "lancamento_id": "LANC-CONTAB-2026-1045",
      "tipo": "VPD_CONSUMO_IMEDIATO",
      "valor": 850.00,
      "status": "EFETIVADO"
    },
    {
      "lancamento_id": "LANC-CONTAB-2026-1046",
      "tipo": "CAPITALIZACAO_IMOBILIZADO",
      "valor": 12000.00,
      "status": "EFETIVADO",
      "placa_patrimonial_gerada": "PMI-2026-104823"
    }
  ],
  "mensagem": "Lote contábil e documental integrado com sucesso à base única municipal."
}

Cenário B: Rejeição de Lote por Inconsistência Contábil (HTTP 400 Bad Request)

Retornado pelo SIAFIC caso o sistema auxiliar tente forçar uma conta inativa ou sintética [38]:

{
  "sucesso": false,
  "status_processamento": "REJEITADO_VALIDACAO",
  "codigo_erro": "SIAFIC-VAL-004",
  "mensagem": "Erro de validação de regras de consistência da Matriz de Saldos Contábeis (MSC).",
  "detalhes_erros": [
    {
      "item_sequencial": 2,
      "campo_invalido": "lancamento_contabil.debito_conta_analitica",
      "valor_rejeitado": "1.2.3.1.1.04.05.0000",
      "motivo_rejeicao": "A conta informada é SINTÉTICA. O SIAFIC exige exclusivamente contas analíticas em lançamentos patrimoniais, de modo a evitar rejeição da MSC no SICONFI."
    }
  ],
  "timestamp_rejeicao": "2026-07-26T13:34:20Z"
}

Este modelo técnico consolida a integração assistida por inteligência artificial, mitigando os apontamentos dos Tribunais de Contas referentes ao Balanço Patrimonial e simplificando o processo de conciliação físico-contábil [27, 33, 37].

Exemplo JSON — Impairment (NBC TSP 07/09)

Normas de Referência: NBC TSP 07 (Ativo Imobilizado), NBC TSP 09 (Redução ao Valor Recuperável de Ativo Não Gerador de Caixa) e MCASP 11ª Edição.

Este documento demonstra como a plataforma PatriID (Sistema Complementar) estrutura e transmite via API o lote contábil de uma Perda por Desvalorização Extraordinária (Impairment) para o SIAFIC (Sistema Estruturante) municipal.


1. Cenário Prático de Negócio

Um equipamento de alta tecnologia médica (Aparelho de Ressonância Magnética) alocado no Hospital Municipal sofreu um dano físico parcial decorrente de uma sobrecarga na rede elétrica local, além de obsolescência tecnológica acelerada pela entrada de novos modelos no mercado.

A Comissão de Inventário e o setor de Engenharia de Avaliações realizaram o Teste de Recuperabilidade (Impairment Test), obtendo os seguintes valores:

  1. Valor de Aquisição (Custo Histórico): R$ 850.000,00
  2. Depreciação Acumulada: R$ 340.000,00
  3. Valor Líquido Contábil (VLC): R$ 510.000,00
  4. Mensuração do Valor Recuperável:
  5. Valor Justo líquido das despesas de venda: R$ 380.000,00
  6. Valor em Uso (potencial de serviços/fluxos futuros): R$ 410.000,00
  7. Valor Recuperável (teto): R$ 410.000,00 (maior valor entre o Valor Justo e o Valor em Uso, conforme a NBC TSP 07)
  8. Perda por Desvalorização (Impairment): $$\text{VLC (R\$ 510.000,00)} - \text{Valor Recuperável (R\$ 410.000,00)} = \mathbf{R\$ 100.000,00}$$

2. Lançamento Contábil (PCASP)

A perda por impairment deve ser reconhecida de forma imediata sob o regime de competência patrimonial:


3. Payload JSON de Envio (POST /api/v1/siafic/lote-contabil)

{
  "lote_id": "LOTE-IMP-2026-0089",
  "data_transmissao": "2026-07-26T09:55:00-03:00",
  "competencia": "2026-07",
  "origem_sistema": "PatriID",
  "tipo_evento": "IMPAIRMENT_EXTRAORDINARIO",
  "dados_lancamento": {
    "patrimonio_id": "PM-HOSP-88371",
    "numero_tombamento": "104928",
    "descricao_bem": "Aparelho de Ressonância Magnética - Modelo Sigma V2",
    "centro_custo": "Secretaria Municipal de Saúde - Hospital Municipal",
    "valor_aquisicao": 850000.00,
    "depreciacao_acumulada": 340000.00,
    "valor_liquido_contabil": 510000.00,
    "teste_recuperabilidade": {
      "metodo_mensuracao": "NBC_TSP_07_ITEM_29",
      "data_laudo": "2026-07-24",
      "laudo_tecnico_ref": "LAUDO-ENG-2026-148",
      "engenheiro_responsavel": "Douglas Rezende (CREA-UF: 998231-D)",
      "valor_justo_liquido_venda": 380000.00,
      "valor_em_uso": 410000.00,
      "valor_recuperavel_apurado": 410000.00,
      "perda_impairment_calculada": 100000.00
    },
    "partidas_dobradas": [
      {
        "sequencia": 1,
        "conta_debito": "3.6.1.1.1.01.00",
        "conta_credito": "1.2.3.8.1.01.02",
        "valor": 100000.00,
        "historico_padrao": "Ref. ao reconhecimento de perda por redução ao valor recuperável (impairment) do bem tombamento nº 104928, conforme laudo técnico LAUDO-ENG-2026-148 e diretrizes da NBC TSP 07.",
        "fonte_recursos": "1.500.1002"
      }
    ]
  },
  "audit_trail": {
    "operador": "Douglas Rezende (Gestor de Dados SIAFIC - Portaria nº 148/2026)",
    "crc_responsavel": "CRC-UF nº 098231/O-4",
    "hash_seguranca_transmissao": "a8fbc83d120a1c1d89fe9e102bc45001a1829e20cb374a872e411fa9cb893d18",
    "ip_origem": "192.168.10.45",
    "user_agent": "PatriID-SyncEngine/v2.4.1 (Linux; x86_64)",
    "geolocalizacao_evento": "-20.8492, -41.1128"
  }
}

4. Contrato de Resposta da API do SIAFIC

Resposta de Sucesso (201 Created)

Indica que o lote contábil passou por todas as regras de validação lógica do plano de contas municipal e foi gravado de forma definitiva no Diário Contábil.

{
  "status": "sucesso",
  "codigo": "201",
  "mensagem": "Lançamento de Desvalorização Extraordinária integrado com sucesso.",
  "transacao": {
    "siafic_id": "SIAFIC-LOTE-2026-98741",
    "lote_origem": "LOTE-IMP-2026-0089",
    "data_processamento": "2026-07-26T09:55:02-03:00",
    "numero_diario": "99381",
    "status_integracao": "PROCESSADO",
    "msc_pre_validação": "COMPATÍVEL"
  }
}

Resposta de Erro de Validação (422 Unprocessable Entity)

Ocorre quando o sistema complementar tenta utilizar uma conta contábil que foi extinta, inativada ou que possui natureza sintética no PCASP municipal configurado no SIAFIC.

{
  "status": "erro",
  "codigo": "422",
  "mensagem": "Falha na validação contábil do lote enviado.",
  "erros": [
    {
      "campo": "partidas_dobradas[0].conta_credito",
      "valor_recebido": "1.2.3.8.1.01.00",
      "motivo": "A conta informada possui natureza SINTÉTICA. Os lançamentos automáticos de integração devem ser direcionados estritamente para contas ANALÍTICAS ativas no PCASP do exercício corrente."
    }
  ]
}

5. Trilha de Auditoria Imutável (Banco de Dados PatriID)

Em total conformidade com o Art. 8º do Decreto Federal nº 10.540/2020, no momento do disparo do lote para a API, a tabela log_acoes (com restrição append-only que barra comandos UPDATE e DELETE) registra a transação:

log_id timestamp usuario_id modulo acao dados_anteriores (JSONB) dados_novos (JSONB)
14920 2026-07-26 09:55:00 992 Patrimônio IMPAIRMENT_EXEC {"patrimonio_id": "PM-HOSP-88371", "valor_liquido_contabil": 510000.00, "reducao_acumulada_impairment": 0.00} {"patrimonio_id": "PM-HOSP-88371", "valor_liquido_contabil": 410000.00, "reducao_acumulada_impairment": 100000.00}

Este modelo de integração garante a conformidade com as exigências dos auditores do Tribunal de Contas, assegurando que as reduções extraordinárias de ativos imobilizados sejam reconhecidas tempestivamente por meio de webservices, eliminando em definitivo a dependência de planilhas manuais paralelas.

Exemplo JSON — Reversão de Impairment

Este documento apresenta a especificação técnica e a simulação de payload no formato JSON para o envio de lançamentos de reestabelecimento de valor por reversão de perda por impairment (redução ao valor recuperável) do PatriID (Sistema Complementar) para a API do SIAFIC (Sistema Estruturante).

A reversão de impairment segue estritamente as diretrizes contidas nas normas brasileiras de contabilidade aplicadas ao setor público: * NBC TSP 07 — Ativo Imobilizado [31]; * NBC TSP 09 — Redução ao Valor Recuperável de Ativo Não Gerador de Caixa; * MCASP 11ª Edição (Parte II - Patrimonial) [43].


1. Fundamentação Técnica e Regras de Negócio

A. Condições para Reversão do Impairment

Uma perda por desvalorização extraordinária (impairment) reconhecida em períodos anteriores deve ser revertida se, e somente se, houver uma alteração nas estimativas utilizadas para determinar o valor recuperável do ativo desde a última perda reconhecida.

No cenário simulado: 1. Ativo: Aparelho de Ressonância Magnética, Tombamento nº 2026.0847, pertencente à Secretaria Municipal de Saúde [48]. 2. Histórico (2026): O ativo sofreu uma perda por impairment de R$ 100.000,00 devido a falhas operacionais e queima de bobinas de gradiente, reduzindo seu valor contábil líquido a R$ 410.000,00. 3. Fato Novo (2027): O município realizou uma manutenção preventiva extraordinária profunda e a substituição completa das bobinas danificadas, restabelecendo a plena capacidade de atendimento do equipamento. Um novo Teste de Recuperabilidade (Laudo nº LAU-2027-0092, assinado por Engenheiro credenciado) atesta que o valor recuperável atual subiu para R$ 480.000,00.

B. Limitação Legal da Reversão (NBC TSP 09 / MCASP)

O valor contábil do ativo aumentado pela reversão da perda por desvalorização não deve exceder o valor contábil que teria sido determinado (líquido de depreciação ou amortização) se nenhuma perda por desvalorização tivesse sido reconhecida em anos anteriores. * Valor Contábil Líquido Atual (com Impairment): R$ 350.000,00 (após depreciações subsequentes de 2026 a 2027 sobre a base reduzida). * Valor Recuperável Atual Estimado: R$ 480.000,00. * Limite do Custo Depreciado Histórico (se nunca houvesse impairment): R$ 510.000,00. * Cálculo da Reversão Permitida: Como o valor recuperável (R$ 480.000,00) é inferior ao limite histórico sem impairment (R$ 510.000,00), o ativo pode ser revalorizado até o limite de R$ 480.000,00. * Montante Contábil da Reversão: R$ 480.000,00 (novo valor) - R$ 350.000,00 (valor contábil líquido atual) = R$ 130.000,00 de acréscimo patrimonial. * Composição Contábil do Ajuste: * Ajuste da Redução Acumulada: Reversão parcial da perda por impairment acumulada no limite de R$ 60.000,00 (reduzindo o saldo retificador da conta 1.2.3.8.1.01.02 de R$ 100.000,00 para R$ 40.000,00). * Ajuste de Depreciação Retrospectiva: O restante do ajuste (R$ 70.000,00) refere-se ao reajuste retroativo das quotas de depreciação que deixaram de ser acumuladas sobre a base cheia histórica, sendo compensadas de acordo com as regras contábeis do MCASP.


2. Payload de Envio (POST /api/siafic/lote-contabil)

O JSON abaixo demonstra o lote estruturado enviado pelo PatriID contendo os lançamentos de reestabelecimento de valor e a respectiva trilha de auditoria imutável (Art. 8º do Decreto nº 10.540/2020) [28, 30].

{
  "transacao_id": "tx_2027_rev_imp_0089",
  "data_transacao": "2027-08-15T14:30:00-03:00",
  "competencia": "2027-08",
  "ente": "Prefeitura Municipal de Exemplo - UF",
  "origem": "PatriID - Sistema Auxiliar de Gestão Patrimonial",
  "tipo_evento": "REVERSAO_PERDA_IMPAIRMENT",
  "documento_suporte": {
    "tipo": "Laudo de Avaliação e Teste de Recuperabilidade",
    "numero": "LAU-2027-0092",
    "data_emissao": "2027-08-10",
    "orgao_emissor": "Comissão Municipal de Avaliação de Bens / Eng. Civil Credenciado",
    "responsavel_tecnico": "Eng. Roberto Silva",
    "registro_profissional": "CREA-UF 123456/D"
  },
  "bem_patrimonial": {
    "tombamento": "2026.0847",
    "descricao": "Aparelho de Ressonância Magnética High-Field 1.5T",
    "unidade_administrativa": "Secretaria Municipal de Saúde - Hospital Municipal",
    "valor_historico_aquisicao": 800000.00
  },
  "parametros_mensuracao": {
    "valor_liquido_contabil_anterior": 350000.00,
    "valor_recuperavel_atual": 480000.00,
    "limite_custo_depreciado_sem_impairment": 510000.00,
    "perda_por_impairment_anterior_acumulada": 100000.00,
    "valor_reversao_calculado": 60000.00,
    "justificativa_reversao": "Reestabelecimento do potencial de geração de serviços do ativo devido à conclusão com sucesso do programa de manutenção extraordinária e substituição de bobinas defeituosas, restabelecendo a capacidade de exames, conforme Laudo Técnico LAU-2027-0092."
  },
  "lancamentos_contabeis": [
    {
      "sequencia": 1,
      "natureza_informacao": "P",
      "tipo_partida": "DOBRADA",
      "conta_debito": {
        "codigo_pcasp": "1.2.3.8.1.01.02",
        "nome_conta": "Redução ao Valor Recuperável Acumulada de Máquinas, Equipamentos e Ferramentas (Ativo Retificador)",
        "tipo_nivel": "Analítico"
      },
      "conta_credito": {
        "codigo_pcasp": "4.6.1.1.1.01.01",
        "nome_conta": "Reversão de Perdas por Redução ao Valor Recuperável de Máquinas, Equipamentos e Ferramentas (VPA)",
        "tipo_nivel": "Analítico"
      },
      "valor": 60000.00,
      "fonte_recursos": {
        "codigo": "1.500.1002",
        "nome": "Recursos Próprios - Saúde"
      },
      "historico_padrao": "Reestabelecimento de valor do imobilizado Tombamento nº 2026.0847 por reversão de perda por desvalorização extraordinária (Impairment), com amparo técnico no Laudo nº LAU-2027-0092 e em conformidade com as NBC TSP 07/09 e MCASP."
    }
  ],
  "audit_trail": {
    "usuario_responsavel": "servidor.lucas.fazenda",
    "nivel_acesso": 12000,
    "ip_origem": "192.168.10.45",
    "user_agent": "PatriID-Client/2.4.0 (Windows NT 10.0; Win64; x64)",
    "timestamp_servidor": "2027-08-15T14:30:05.123-03:00",
    "hash_seguranca_sha256": "8f3c7a10be64f2b3c401ad8797f1f0a40d588390b10e9fbc746c1f01c8fa909b",
    "dados_anteriores": {
      "bem_tombamento": "2026.0847",
      "status_impairment": "IMPAIRED",
      "valor_reducao_acumulada": -100000.00,
      "valor_liquido_contabil": 350000.00
    },
    "dados_novos": {
      "bem_tombamento": "2026.0847",
      "status_impairment": "PARTIALLY_REVERSED",
      "valor_reducao_acumulada": -40000.00,
      "valor_liquido_contabil": 410000.00
    }
  }
}

3. Contratos de Resposta HTTP (SIAFIC API)

A. Resposta de Sucesso: 201 Created

Retornada quando o SIAFIC valida o PCASP das contas envolvidas, a fonte de recursos, a autenticidade e grava permanentemente o lançamento no Razão Contábil do município.

{
  "status": "success",
  "codigo_retorno": 201,
  "mensagem": "Lançamento contábil de reversão de impairment integrado com sucesso.",
  "protocolo_siafic": "SIAFIC-2027-REV-99211",
  "data_processamento": "2027-08-15T14:30:06.879-03:00",
  "audit_log_registrado": true
}

B. Resposta de Rejeição de Validação Contábil: 422 Unprocessable Entity

Retornada se o SIAFIC detectar contas extintas, fontes de recursos inconsistentes ou falta de saldo para reversão.

{
  "status": "error",
  "codigo_retorno": 422,
  "mensagem": "Inconsistência nas regras de validação contábil do PCASP municipal.",
  "erros": [
    {
      "campo": "lancamentos_contabeis[0].conta_credito.codigo_pcasp",
      "erro_codigo": "PCASP_CONTA_INATIVA",
      "detalhe": "A conta contábil analítica de VPA 4.6.1.1.1.01.01 não está ativa para o exercício fiscal de 2027 no PCASP do município."
    }
  ]
}

4. Trilha de Auditoria Imutável (Art. 8º do Decreto nº 10.540/2020)

Em perfeita sintonia com a exigência legal de base única e log inalterável [28, 30]: * A transação é registrada no banco de dados do PatriID em uma estrutura append-only (log de ações imutável, livre de rotinas de UPDATE ou DELETE) [60, 61]; * O objeto audit_trail armazena o exato estado de transição física do imobilizado, comprovando o saneamento do balanço municipal de R$ 350.000,00 para R$ 410.000,00 (após o ajuste contábil de R$ 60.000,00 na conta acumulada de retração do imobilizado).

Exemplo JSON — Baixa de bem inservível

Este documento apresenta a especificação e simulação do payload JSON enviado pela plataforma PatriID (Sistema Complementar) para a API de Lançamentos Contábeis do SIAFIC (Sistema Estruturante), registrando a baixa física e desincorporação contábil de um ativo imobilizado considerado inservível (veículo sinistrado ou com desgaste irreversível, sem valor de recuperação).

O lançamento de desincorporação segue estritamente as diretrizes da NBC TSP 07 (Ativo Imobilizado), da NBC TSP 09 (Redução ao Valor Recuperável de Ativos Não Geradores de Caixa) e as regras gerais do Manual de Contabilidade Aplicada ao Setor Público (MCASP) 11ª Edição.


1. Cenário Contábil da Simulação

Contas do PCASP Utilizadas (Lançamento de Natureza Patrimonial):


2. Payload JSON — Envio de Lote à API do SIAFIC

{
  "lote_informacao": {
    "identificador_lote": "LOTE-BAIXA-INSERVIVEL-2026-07-26",
    "data_envio": "2026-07-26T10:00:00-03:00",
    "sistema_origem": "PatriID",
    "cnpj_ente": "01.234.567/0001-89",
    "usuario_autor_cpf": "987.654.321-00",
    "ambiente": "homologacao"
  },
  "evento_patrimonial": {
    "codigo_evento": "EV-BAIXA-PATRIMONIAL-0987",
    "tipo_movimentacao": "BAIXA_POR_INSERVIBILIDADE",
    "data_movimento": "2026-07-26",
    "patrimonio_numero": "202100897",
    "descricao_bem": "Veículo Oficial - Ambulância de Remoção - Placa ABC-1234",
    "laudo_inservibilidade": {
      "numero_documento": "LAUDO-TEC-055/2026",
      "data_emissao": "2026-07-20",
      "responsavel_tecnico_nome": "Eng. Roberto Carlos Silva",
      "registro_profissional": "CREA-SP 506.789/D"
    },
    "valores": {
      "valor_aquisicao": 90000.00,
      "depreciacao_acumulada": 72000.00,
      "valor_liquido_contabil": 18000.00
    },
    "lancamentos_contabeis": [
      {
        "item_lancamento": 1,
        "tipo_lancamento": "DEBITO",
        "codigo_conta_pcasp": "1.2.3.8.1.01.03",
        "nome_conta_pcasp": "Depreciação Acumulada de Bens Móveis - Veículos",
        "valor": 72000.00,
        "historico_padrao": "Baixa da depreciação acumulada ref. veículo oficial Patr. 202100897 conforme Laudo LAUDO-TEC-055/2026.",
        "fonte_recursos": "1.500.0000.0000"
      },
      {
        "item_lancamento": 2,
        "tipo_lancamento": "DEBITO",
        "codigo_conta_pcasp": "3.6.2.1.1.01.00",
        "nome_conta_pcasp": "VPD - Desincorporação de Ativos - Baixas de Imobilizado",
        "valor": 18000.00,
        "historico_padrao": "Reconhecimento de perda líquida (VPD) por desincorporação de veículo oficial Patr. 202100897 considerado inservível.",
        "fonte_recursos": "1.500.0000.0000"
      },
      {
        "item_lancamento": 3,
        "tipo_lancamento": "CREDITO",
        "codigo_conta_pcasp": "1.2.3.1.1.03.01",
        "nome_conta_pcasp": "Bens Móveis - Veículos Oficiais",
        "valor": 90000.00,
        "historico_padrao": "Baixa integral do ativo por desincorporação física ref. veículo oficial Patr. 202100897 considerado inservível.",
        "fonte_recursos": "1.500.0000.0000"
      }
    ],
    "audit_trail": {
      "usuario_id": "99000-master-patriid",
      "timestamp_registro": "2026-07-26T10:00:05-03:00",
      "ip_origem": "200.143.15.77",
      "user_agent": "Mozilla/5.0 (SIAFIC-PatriID-API-Client v1.0)",
      "dados_anteriores": {
        "status_bem": "ATIVO",
        "valor_residual": 18000.00,
        "depreciacao_suspensa": false
      },
      "dados_novos": {
        "status_bem": "BAIXADO_INSERVIVEL",
        "valor_residual": 0.00,
        "depreciacao_suspensa": true,
        "documento_autorizador": "Decreto Executivo Municipal de Baixa Patrimonial nº 44.556/2026"
      }
    }
  }
}

3. Contratos de Resposta da API do SIAFIC

Resposta de Sucesso (201 Created)

Retornada pelo SIAFIC quando a requisição passa por todas as validações estruturais, contábeis e de rede, registrando as partidas de diário no razão.

{
  "sucesso": true,
  "mensagem": "Lote contábil de desincorporação patrimonial processado com sucesso.",
  "codigo_transacao_siafic": "TX-SIAFIC-2026-9908876",
  "data_processamento": "2026-07-26T10:00:08-03:00",
  "detalhamento": {
    "lote_identificador": "LOTE-BAIXA-INSERVIVEL-2026-07-26",
    "evento_codigo": "EV-BAIXA-PATRIMONIAL-0987",
    "total_debitos": 90000.00,
    "total_creditos": 90000.00,
    "partidas_equilibradas": true,
    "status_audit_trail": "REGISTRADO_IMUTAVEL"
  }
}

Resposta de Erro de Consistência (422 Unprocessable Entity)

Retornada se o sistema de contabilidade identificar erros conceituais de digitação contábil (como descasamento entre a soma total dos débitos e créditos) ou mapeamento de conta sintética/inativa.

{
  "sucesso": false,
  "mensagem": "Falha na validação contábil do lote de desincorporação.",
  "codigo_erro": "ERR_CONTABIL_DESEQUILIBRIO_PARTIDAS",
  "data_rejeicao": "2026-07-26T10:00:04-03:00",
  "erros_detalhados": [
    {
      "campo": "lancamentos_contabeis",
      "erro_mensagem": "A soma total dos lançamentos a Débito (R$ 90.000,00) deve ser rigorosamente igual à soma dos lançamentos a Crédito (R$ 90.000,00). Partidas desequilibradas."
    },
    {
      "campo": "lancamentos_contabeis[1].codigo_conta_pcasp",
      "erro_mensagem": "A conta 1.2.3.8.1.01.03 está parametrizada como inativa ou inválida no plano de contas (PCASP) do exercício atual."
    }
  ]
}

Exemplo JSON — Doação e Cessão

Padrão de Integração Técnica e Governança Contábil (MCASP 11ª Edição & Decreto nº 10.540/2020)

Este documento técnico detalha a especificação do payload JSON para o envio de lotes mistos contendo eventos de Doações Recebidas (incorporação definitiva de ativos imobilizados) e Cessão de Uso (controle de ativos sob a custódia do ente sem transferência de propriedade).

A estrutura é modelada de acordo com o Plano de Contas Aplicado ao Setor Público (PCASP) e as diretrizes do Manual de Contabilidade Aplicada ao Setor Público (MCASP) da STN, garantindo a integrabilidade em tempo real com o SIAFIC municipal.


1. Cenários de Negócio e Lançamentos Contábeis (PCASP)

Cenário A: Doação Recebida (Incorporação Definitiva)

Cenário B: Cessão de Uso Recebida (Contas de Compensação)


2. Payload Completo de Envio da API (JSON)

Este payload representa o lote consolidado enviado de forma automatizada pelo PatriID para o endpoint de integração contábil do SIAFIC:

{
  "lote_id": "LOTE-PATR-2026-00452",
  "competencia": "2026-07",
  "data_envio": "2026-07-26T10:02:00-03:00",
  "origem": "PatriID_Patrimonio",
  "registros_total": 2,
  "valor_total_lote": 850000.00,
  "eventos": [
    {
      "evento_id": "EVT-2026-DOA-0012",
      "tipo_movimentacao": "DOACAO_RECEBIDA_PERMANENTE",
      "data_movimento": "2026-07-20",
      "documento_suporte": {
        "tipo": "TERMO_DOACAO",
        "numero": "SEC-EDU-142/2026",
        "data_emissao": "2026-07-18",
        "cnpj_origem": "45.123.456/0001-89",
        "orgao_origem": "Secretaria de Estado de Educacao - UF"
      },
      "dados_patrimoniais": {
        "item_descricao": "Lote de 10 Computadores Portateis para Escolas Municipais",
        "grupo_material": "EQUIPAMENTOS_TI",
        "codigo_catmat": "452109-8",
        "valor_avaliacao": 50000.00,
        "vida_util_estimada_meses": 60,
        "valor_residual": 5000.00,
        "plaquetas_vinculadas": [
          "PAT-EDU-2026-001", "PAT-EDU-2026-002", "PAT-EDU-2026-003", "PAT-EDU-2026-004", "PAT-EDU-2026-005",
          "PAT-EDU-2026-006", "PAT-EDU-2026-007", "PAT-EDU-2026-008", "PAT-EDU-2026-009", "PAT-EDU-2026-010"
        ]
      },
      "lancamentos_contabeis": [
        {
          "sequencia": 1,
          "tipo": "D",
          "conta_contabil": "1.2.3.1.1.04.01",
          "conta_contabil_nome": "Aparelhos e Equipamentos de Processamento de Dados",
          "valor": 50000.00,
          "fonte_recursos": "15001002",
          "historico_padrao": "Incorporacao patrimonial de bens permanentes recebidos por meio do Termo de Doacao nº SEC-EDU-142/2026, com destino a Secretaria Municipal de Educacao."
        },
        {
          "sequencia": 2,
          "tipo": "C",
          "conta_contabil": "4.9.1.1.1.01.00",
          "conta_contabil_nome": "Transferencias Recebidas para Incorporacao de Ativos",
          "valor": 50000.00,
          "fonte_recursos": "15001002",
          "historico_padrao": "VPA reconhecida por incorporacao direta de bens de processamento de dados doados pelo Estado."
        }
      ],
      "audit_trail": {
        "criado_por": "suporte.master.99000",
        "timestamp_criacao": "2026-07-26T10:01:12-03:00",
        "ip_origem": "192.168.10.45",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
        "checksum_dados": "b3e945c7da2a68c783de9e011d61c6bc1b82"
      }
    },
    {
      "evento_id": "EVT-2026-CES-0005",
      "tipo_movimentacao": "CESSAO_DE_USO_RECEBIDA_CONTROLE",
      "data_movimento": "2026-07-22",
      "documento_suporte": {
        "tipo": "TERMO_COMODATO",
        "numero": "SPU-UNIAO-895/2026",
        "data_emissao": "2026-07-15",
        "cnpj_origem": "00.394.460/0001-41",
        "orgao_origem": "Secretaria de Patrimonio da Uniao (SPU)"
      },
      "dados_patrimoniais": {
        "item_descricao": "Imovel Predial situado na Av. Central, 1000 - Cedido para instalacao da UBS Central",
        "grupo_material": "IMOVEL_TERCEIROS",
        "codigo_catmat": "321098-4",
        "valor_referencia_controle": 800000.00,
        "prazo_vigencia_meses": 48,
        "coordenadas_georreferenciadas": "-23.5505199,-46.6330132",
        "plaquetas_vinculadas": [
          "IMO-CES-2026-001"
        ]
      },
      "lancamentos_contabeis": [
        {
          "sequencia": 1,
          "tipo": "D",
          "conta_contabil": "7.1.2.2.1.01.00",
          "conta_contabil_nome": "Bens de Terceiros Sob Custodia no Ente - Atos Potenciais",
          "valor": 800000.00,
          "fonte_recursos": "15001002",
          "historico_padrao": "Controle patrimonial de imovel de propriedade da Uniao recebido sob Termo de Cessao de Uso Gratuito nº SPU-UNIAO-895/2026 para uso como UBS Central."
        },
        {
          "sequencia": 2,
          "tipo": "C",
          "conta_contabil": "8.1.2.2.1.01.00",
          "conta_contabil_nome": "Execucao de Bens de Terceiros Sob Custodia - Contrapartida",
          "valor": 800000.00,
          "fonte_recursos": "15001002",
          "historico_padrao": "Contrapartida de controle de atos potenciais ativos para custodia de bens moveis/imoveis de terceiros."
        }
      ],
      "audit_trail": {
        "criado_por": "suporte.master.99000",
        "timestamp_criacao": "2026-07-26T10:01:45-03:00",
        "ip_origem": "192.168.10.45",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
        "checksum_dados": "fa890e0c1f5108b3e9e04cd614be806019a3b"
      }
    }
  ]
}

3. Contratos de Resposta da API (SIAFIC)

Retorno de Sucesso (HTTP 201 Created)

Retornado quando as regras de rede (Whitelist), autenticação (Token Bearer) e integrabilidade contábil (validação do PCASP ativo) do SIAFIC são plenamente cumpridas:

{
  "status": "SUCESSO",
  "codigo_http": 201,
  "mensagem": "Lote misto contem os eventos processados e integrados com exito ao SIAFIC.",
  "timestamp_processamento": "2026-07-26T13:02:04Z",
  "lote_id": "LOTE-PATR-2026-00452",
  "transacoes_processadas": [
    {
      "evento_id": "EVT-2026-DOA-0012",
      "status": "INTEGRADO",
      "lancamento_siafic_id": "SIAF-2026-LAN-889410",
      "contas_validadas": ["1.2.3.1.1.04.01", "4.9.1.1.1.01.00"]
    },
    {
      "evento_id": "EVT-2026-CES-0005",
      "status": "INTEGRADO",
      "lancamento_siafic_id": "SIAF-2026-LAN-889411",
      "contas_validadas": ["7.1.2.2.1.01.00", "8.1.2.2.1.01.00"]
    }
  ],
  "audit_trail": {
    "versao_siafic": "12.4.2",
    "token_solicitante_sha256": "f5e9dae93bc0c14da89d81d24c0e64cd2b9846de182e098485a089cd810",
    "registro_imutavel": "APPEND_ONLY_LOG_SUCCESS"
  }
}

Retorno de Falha de Validação Técnica/Contábil (HTTP 422 Unprocessable Entity)

Retornado caso alguma conta contábil parametrizada esteja sintética ou inativa no SIAFIC para o presente exercício financeiro:

{
  "status": "ERRO",
  "codigo_http": 422,
  "erro_tipo": "FALHA_CONCILIACAO_CONTABIL",
  "mensagem": "O lote foi rejeitado pelo SIAFIC devido a inconsistencias estruturais ou cadastrais no Plano de Contas municipal.",
  "timestamp_processamento": "2026-07-26T13:02:05Z",
  "lote_id": "LOTE-PATR-2026-00452",
  "erros_detalhados": [
    {
      "evento_id": "EVT-2026-DOA-0012",
      "erro_classe": "CONTA_SINTETICA_PROIBIDA",
      "campo_afetado": "lancamentos_contabeis[1].conta_contabil",
      "valor_recebido": "4.9.1.1.1.01.00",
      "detalhe": "A conta 4.9.1.1.1.01.00 é classificada como sintetica no PCASP do ente. Transacoes via API exigem o direcionamento estrito a contas analiticas operacionais (ex: 4.9.1.1.1.01.02 - Doacoes Recebidas de Outros Entes Públicos)."
    }
  ]
}

4. Diferenças Cruciais de Tratamento Patrimonial (Resumo para Auditoria do TCE)

Item de Análise Cenário A: Doações Recebidas Cenário B: Cessões de Uso Recebidas
Transferência de Propriedade Sim. O doador transfere definitivamente a posse e a titularidade dos bens ao município. Não. O cedente concede apenas o direito de uso provisório, mantendo a titularidade.
Impacto no Ativo Imobilizado Acréscimo Patrimonial Real. Aumenta o valor contábil do imobilizado próprio (Conta 1.2.3.x). Nulo. Não afeta as contas patrimoniais do imobilizado do ente municipal.
Geração de Depreciação Sim. Os bens doados entram nas rotinas automáticas mensais de depreciação subsequente. Não. O município não realiza depreciação sobre ativos de terceiros.
Registros de Compensação Não aplicável. Obrigatório. Registrado nas contas de Atos Potenciais (7.1.2.x / 8.1.2.x) para salvaguarda de responsabilidade civil.
Comprovação de Auditoria Termo de Doação, Laudo de Avaliação Física e tombamento físico individualizado. Termo de Cessão de Uso / Comodato, Decreto de destinação pública e coordenadas georreferenciadas.

Simulação — Depreciação pró-rata dia

Competência: Julho / 2026 · Arredondamento: Arredondamento Bancário (Banker's Rounding) · Normas: NBC TSP 07 & MCASP 11ª Edição

Este documento apresenta a simulação técnica e o memorial de cálculo detalhado do processamento mensal automático de depreciação de bens permanentes, operando sob o critério de pró-rata die (proporcional aos dias de uso ativo no mês de incorporação ou movimentação do bem) e aplicando o padrão matemático de arredondamento bancário (Banker's Rounding) em conformidade com as exigências dos Tribunais de Contas (TCE) e o Artigo 14 do Decreto Federal nº 10.540/2020. [15, 25, 38]


1. Metodologia de Cálculo Aplicada

De acordo com as diretrizes do MCASP 11ª Edição, a depreciação sistemática subsequente de bens móveis deve refletir com exatidão o desgaste pelo uso e o decurso do tempo. [15] No critério pró-rata dia, a depreciação é apropriada desde a data exata de colocação em uso (incorporação) do ativo. [15]

A fórmula matemática implementada no motor de cálculo do PatriID é estruturada da seguinte forma:

  1. Valor Depreciável ($V_D$): $$V_D = C_H - V_R$$ Onde $C_H$ é o Custo Histórico de Aquisição e $V_R$ é o Valor Residual fixado em laudo ou política contábil.

  2. Depreciação Diária ($D_{dia}$): $$D_{dia} = \frac{V_D}{\text{Vida Útil em Anos} \times 365}$$

  3. Depreciação do Mês ($D_{mes}$): $$D_{mes} = D_{dia} \times \text{Dias Ativos no Mês}$$

  4. Arredondamento Bancário (Banker's Rounding): Para mitigar distorções acumulativas de centavos nos lotes de milhares de bens, o sistema adota o padrão de arredondamento ao par mais próximo (se a terceira casa decimal for exatamente 5, o arredondamento é feito para que a segunda casa decimal seja um número par). [15]


2. Tabela de Memorial de Cálculo (Julho/2026)

Código do Bem Descrição do Ativo Imobilizado Data Incorp. Custo Histórico Tx. Residual Valor Depreciável Vida Útil Dias Ativos Depreciação Julho/2026
BEM-M-2026-001 Ambulância de Emergência UTI (Saúde)
Conta: 1.2.3.1.1.03.01 (Veículos Oficiais)
12/07/2026 R$ 150.000,00 10.00% R$ 135.000,00 5 anos 20 dias R$ 1.479,45
BEM-M-2026-002 Servidor Corporativo de Dados (Administração)
Conta: 1.2.3.1.1.04.01 (Aparelhos e Equipamentos de Proc. de Dados)
01/07/2026 R$ 48.000,00 5.00% R$ 45.600,00 4 anos 31 dias R$ 968,22
BEM-M-2026-003 Equipamento de Raio-X Digital (Saúde)
Conta: 1.2.3.1.1.02.01 (Aparelhos e Equipamentos Médicos e Hosp.)
25/07/2026 R$ 220.000,00 10.00% R$ 198.000,00 10 anos 7 dias R$ 379,73
BEM-M-2026-004 Veículo de Ronda Social (Assistência Social)
Conta: 1.2.3.1.1.03.01 (Veículos Oficiais)
31/07/2026 R$ 85.000,00 10.00% R$ 76.500,00 5 anos 1 dias R$ 41,92
TOTAL Consolidação Geral do Lote — R$ 503.000,00 — R$ 455.100,00 — — R$ 2.869,32

3. Detalhes do Memorial de Cálculo Analítico

A. Ambulância UTI (BEM-M-2026-001)

B. Servidor de Dados (BEM-M-2026-002)

C. Equipamento de Raio-X Digital (BEM-M-2026-003)

D. Veículo de Ronda Social (BEM-M-2026-004)


4. Payload JSON Contábil Gerado para Envio via API/Webservice

O PatriID gera e agrupa de forma automática e integrada as contas do PCASP de depreciação analítica, compilando-as em um payload unificado para envio seguro HTTPS ao SIAFIC, sem intervenção ou exportações manuais, em cumprimento estrito ao Artigo 14, parágrafo único do Decreto Federal nº 10.540/2020: [11, 24, 29]

{
  "tipo_transacao": "FECHAMENTO_LOTE_DEPREC_MENSAL",
  "lote_id": "LOTE-DEP-2026-07-PRORATA",
  "competencia": "2026-07",
  "data_processamento": "2026-07-31T23:59:59Z",
  "ente_cnpj": "00.000.000/0001-00",
  "valor_total_lote": 2869.32,
  "lancamentos": [
    {
      "sequencia": 1,
      "codigo_evento": "DEP001",
      "tipo_patrimonio": "BENS_MOVEIS",
      "contas_partida_dobrada": {
        "debito_vpd": "3.6.2.1.1.01.00",
        "debito_vpd_nome": "VPD - Desincorporação de Ativos - Baixas de Imobilizado",
        "credito_deprec_acumulada": "1.2.3.8.1.01.03",
        "credito_deprec_acumulada_nome": "Depreciação Acumulada de Veículos"
      },
      "detalhes_bens": [
        { "id": "BEM-M-2026-001", "valor": 1479.45, "dias_ativos": 20 },
        { "id": "BEM-M-2026-004", "valor": 41.92, "dias_ativos": 1 }
      ],
      "valor_evento": 1521.37,
      "fonte_recursos": "15000000",
      "historico": "Depreciação mensal sistemática s/ Veículos Oficiais (pró-rata dia) - Competência 07/2026."
    },
    {
      "sequencia": 2,
      "codigo_evento": "DEP002",
      "tipo_patrimonio": "BENS_MOVEIS",
      "contas_partida_dobrada": {
        "debito_vpd": "3.6.2.1.1.01.00",
        "debito_vpd_nome": "VPD - Desincorporação de Ativos - Baixas de Imobilizado",
        "credito_deprec_acumulada": "1.2.3.8.1.01.04",
        "credito_deprec_acumulada_nome": "Depreciação Acumulada de Aparelhos e Equipamentos de Proc. de Dados"
      },
      "detalhes_bens": [
        { "id": "BEM-M-2026-002", "valor": 968.22, "dias_ativos": 31 }
      ],
      "valor_evento": 968.22,
      "fonte_recursos": "15000000",
      "historico": "Depreciação mensal sistemática s/ Equipamentos de TI (pró-rata dia) - Competência 07/2026."
    },
    {
      "sequencia": 3,
      "codigo_evento": "DEP003",
      "tipo_patrimonio": "BENS_MOVEIS",
      "contas_partida_dobrada": {
        "debito_vpd": "3.6.2.1.1.01.00",
        "debito_vpd_nome": "VPD - Desincorporação de Ativos - Baixas de Imobilizado",
        "credito_deprec_acumulada": "1.2.3.8.1.01.02",
        "credito_deprec_acumulada_nome": "Depreciação Acumulada de Aparelhos, Equipamentos e Utensílios Médicos/Hosp."
      },
      "detalhes_bens": [
        { "id": "BEM-M-2026-003", "valor": 379.73, "dias_ativos": 7 }
      ],
      "valor_evento": 379.73,
      "fonte_recursos": "15000000",
      "historico": "Depreciação mensal sistemática s/ Aparelhos e Equipamentos Médicos/Hospitalares (pró-rata dia) - Competência 07/2026."
    }
  ],
  "audit_trail": {
    "usuario_executante": "JOAO.SILVA",
    "cargo": "Gestor de Dados SIAFIC",
    "portaria_governo": "Portaria 123/2026",
    "ip_origem": "192.168.10.15",
    "ambiente": "HOMOLOGACAO_INTEGRADA",
    "algoritmo_criptografia_log": "SHA-256",
    "assinatura_token": "8f3c1a2d5e9b7f6c8d9e2a4b6c8d0e1f3a5b7c9d1e3f5a7b9c1d3e5f7a9b8c"
  }
}

5. Lançamentos Contábeis no Razão do SIAFIC (Partidas Dobradas)

O lote de depreciação mensal gerará os seguintes registros automáticos de partidas dobradas nas contas analíticas do plano do município: [32]

  1. Pelo reconhecimento da depreciação sistemática (VPD):
  2. DÉBITO: 3.6.2.1.1.01.00 (VPD - Desincorporação de Ativos - Baixas de Imobilizado) -> R$ 2.869,32 [32]
  3. CRÉDITO: 1.2.3.8.1.01.03 (Depreciação Acumulada de Veículos) -> R$ 1.521,37 [32]
  4. CRÉDITO: 1.2.3.8.1.01.04 (Depreciação Acumulada de Equipamentos de Processamento de Dados) -> R$ 968,22
  5. CRÉDITO: 1.2.3.8.1.01.02 (Depreciação Acumulada de Aparelhos/Equipamentos Médicos e Hosp.) -> R$ 379,73

Simulação — Lote de depreciação via API

Este documento apresenta uma simulação técnica completa de integração entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante) para o envio automático e tempestivo do lote mensal de depreciação acumulada do Ativo Imobilizado municipal.

A simulação está em perfeita consonância com: * Decreto Federal nº 10.540/2020 (SIAFIC): Integração por API, base única e trilha de auditoria imutável (Art. 8º). * NBC TSP 07 (Ativo Imobilizado): Modelo de Custo subsequente e cálculo sistemático de depreciação. * MCASP 11ª Edição (STN, vigência 2025/2026): Lançamentos por regime de competência patrimonial e Plano de Contas Aplicado ao Setor Público (PCASP) em nível analítico.


1. Regras Contábeis e de Cálculo Aplicadas

O motor de cálculos do PatriID processa a depreciação mensal de cada ativo individualmente com base nas seguintes premissas: 1. Método de Depreciação: Quotas Constantes (Linha Reta). 2. Critério Temporal: Pró-rata die (cálculo proporcional aos dias exatos de ativação do bem no mês de incorporação/baixa). 3. Arredondamento Financeiro: Banker's Rounding (arredondamento bancário para o par mais próximo, evitando distorções estatísticas de centavos em grandes lotes). 4. Não Depreciação de Terrenos: Conforme a NBC TSP 07, terrenos possuem vida útil ilimitada e não sofrem depreciação. O PatriID valida e separa automaticamente o valor das benfeitorias (depreciáveis) do valor da fração ideal do terreno (não depreciável). 5. PCASP Analítico: O sistema complementar valida previamente se as contas contábeis de destino são analíticas (nível 7) e ativas no exercício corrente.


2. Payload JSON — Envio de Lote Mensal (POST)

Endpoint de Destino: HTTPS://api.siafic.pm.gov/v1/patrimonio/lote-contabil
Método: POST
Autenticação: Bearer Token (OAuth 2.0)
IP Autorizado (Whitelist): 200.141.15.42

{
  "lote_cabecalho": {
    "codigo_lote": "LOTE-DEP-202607-001",
    "competencia": "2026-07",
    "tipo_evento": "DEPRECIACAO_MENSAL_SISTEMATICA",
    "sistema_origem": "PatriID (Sistema Complementar Patrimonial)",
    "data_geracao": "2026-07-26T09:55:00-03:00",
    "quantidade_itens": 3,
    "valor_total_lote": 15420.50,
    "hash_integridade": "sha256-4f81c9a18d19028cb9e31d34c679a950f79ca950f79ca950f79ca950f79ca950",
    "usuario_responsavel": {
      "nome": "Carlos Eduardo Santos",
      "matricula": "88412",
      "cargo": "Gestor de Dados SIAFIC - Portaria 342/2026"
    }
  },
  "lancamentos": [
    {
      "item_id": "BEM-MOBI-2026-1049",
      "tombamento": "045812",
      "descricao": "Ambulância de Suporte Avançado (Saúde) - Placa QPR-8E41",
      "orgao_responsavel": "Fundo Municipal de Saúde (FMS)",
      "valor_original": 320000.00,
      "valor_depreciado_mes": 5333.33,
      "partida_dobrada": {
        "debito": {
          "conta_pcasp_codigo": "3.3.3.1.1.01.00",
          "conta_pcasp_nome": "DEPRECIAÇÃO DE BENS MÓVEIS - VPD",
          "centro_custo": "10.302.0041.2045 (Atenção Móvel de Urgência)"
        },
        "credito": {
          "conta_pcasp_codigo": "1.2.3.1.1.02.99",
          "conta_pcasp_nome": "DEPRECIAÇÃO ACUMULADA DE VEÍCULOS - ATIVO"
        }
      }
    },
    {
      "item_id": "BEM-MOBI-2026-0894",
      "tombamento": "044912",
      "descricao": "Servidor de Banco de Dados Central (Administração)",
      "orgao_responsavel": "Secretaria Municipal de Administração",
      "valor_original": 48000.00,
      "valor_depreciado_mes": 800.00,
      "partida_dobrada": {
        "debito": {
          "conta_pcasp_codigo": "3.3.3.1.1.01.00",
          "conta_pcasp_nome": "DEPRECIAÇÃO DE BENS MÓVEIS - VPD",
          "centro_custo": "04.122.0010.2002 (Gestão Administrativa)"
        },
        "credito": {
          "conta_pcasp_codigo": "1.2.3.1.1.01.99",
          "conta_pcasp_nome": "DEPRECIAÇÃO ACUMULADA DE MÁQUINAS E EQUIPAMENTOS - ATIVO"
        }
      }
    },
    {
      "item_id": "BEM-IMOB-2026-0034",
      "tombamento": "012054",
      "descricao": "Edificação da Unidade Básica de Saúde Central (UBS Central)",
      "orgao_responsavel": "Fundo Municipal de Saúde (FMS)",
      "nota_tecnica_terreno": "Terreno de valor R$ 500.000,00 excluído da base de depreciação. Depreciação aplicada estritamente sobre a edificação (R$ 2.786.151,00).",
      "valor_original_benfeitoria": 2786151.00,
      "valor_depreciado_mes": 9287.17,
      "partida_dobrada": {
        "debito": {
          "conta_pcasp_codigo": "3.3.3.1.1.02.00",
          "conta_pcasp_nome": "DEPRECIAÇÃO DE BENS IMÓVEIS - VPD",
          "centro_custo": "10.301.0035.2012 (Manutenção UBS Central)"
        },
        "credito": {
          "conta_pcasp_codigo": "1.2.3.2.1.01.99",
          "conta_pcasp_nome": "DEPRECIAÇÃO ACUMULADA DE EDIFÍCIOS - ATIVO"
        }
      }
    }
  ],
  "audit_trail": {
    "timestamp_evento": "2026-07-26T09:55:00-03:00",
    "ip_origem": "192.168.10.15",
    "user_agent": "PatriID-Core-Integration-Engine/1.4.2",
    "validacao_pcasp_status": "CONFORME_EXERCICIO_2026",
    "verificacao_contas_analiticas": true,
    "bloqueio_contas_sinteticas": true
  }
}

3. Detalhamento Técnico dos Lançamentos

Lançamento 1: Ambulância de Suporte Avançado

Lançamento 2: Servidor de Banco de Dados

Lançamento 3: UBS Central (Edificação)


4. Retornos HTTP Esperados e Integração

Retorno de Sucesso (HTTP 201 Created)

Indica que o lote foi recebido, validado no PCASP do SIAFIC e processado com sucesso.

{
  "sucesso": true,
  "mensagem": "Lote contábil de depreciação mensal importado e processado com sucesso.",
  "codigo_lote": "LOTE-DEP-202607-001",
  "data_processamento": "2026-07-26T09:55:05-03:00",
  "transacoes_gravadas": 3,
  "total_credito": 15420.50,
  "total_debito": 15420.50,
  "ticket_siafic_id": "TX-SIAFIC-2026-991054-DEP",
  "auditoria": {
    "hash_blockchain_siafic": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "mensagem": "Registro de auditoria imutável criado na tabela siafic.log_acoes."
  }
}

Retorno de Erro de Validação Contábil (HTTP 422 Unprocessable Entity)

Ocorre quando há descompasso de contas contábeis no Plano de Contas. Por segurança, o lote completo é rejeitado (transação atômica).

{
  "sucesso": false,
  "erro_codigo": "CONTA_CONTABIL_INVALIDA",
  "mensagem": "O lote foi rejeitado pelo SIAFIC por inconsistência no Plano de Contas do Município (PCASP).",
  "detalhes": {
    "item_index": 2,
    "tombamento": "012054",
    "campo": "partida_dobrada.credito.conta_pcasp_codigo",
    "valor_rejeitado": "1.2.3.2.1.01.99",
    "causa_raiz": "A conta contábil especificada está inativa para o exercício de 2026 ou foi desmembrada em nível analítico complementar."
  },
  "timestamp_erro": "2026-07-26T09:55:03-03:00"
}

Checklist — Depreciação acumulada no SIAFIC

Conformidade com a NBC TSP 07, Decreto Federal nº 10.540/2020 e MCASP 11ª Edição

Este documento estabelece as especificações técnicas, contábeis e de governança para a rotina automática de fechamento de competência e transmissão do Lote de Depreciação Mensal Acumulada do PatriID (Sistema Complementar) para o SIAFIC (Sistema Estruturante) via API.


1. Diretrizes de Cálculo e Regras Contábeis (Motor PatriID)

O motor contábil do PatriID (calcular_depreciacao) opera sob as seguintes regras normativas e matemáticas para assegurar consistência ao centavo:

  1. Método de Mensuração: Aplicação estrita do Modelo do Custo (custo histórico deduzido de depreciação acumulada e perdas por impairment), conforme a NBC TSP 07 (item 29) e a política contábil adotada no Decreto Municipal de Classificação do sistema complementar.
  2. Cálculo Pró-Rata Dia: A depreciação é calculada proporcionalmente aos dias de utilização do bem no mês de incorporação, desativação ou alteração de vida útil.
  3. Arredondamento Bancário (Banker's Rounding): Utilização da regra de arredondamento da norma NBR ISO 80000-1 (arredondamento ao par mais próximo) para evitar o acúmulo de viés financeiro sistemático em bases de dados com dezenas de milhares de ativos.
  4. Tratamento de Exceções:
  5. Bens Não Depreciáveis: Bloqueio de depreciação para terrenos, bens históricos, obras de arte e ativos com vida útil indefinida (ex: grupo de contas 1.2.3.1.1 - Terrenos).
  6. Valor Residual: Redução do valor depreciável com base no valor de salvamento (valor residual) estimado nos laudos de avaliação técnica da NBR 14653.
  7. Impairment: Lançamento automático de perdas por desvalorização quando o valor recuperável de um ativo for inferior ao seu valor líquido contábil.

2. Estrutura Técnica do Lote JSON (Payload de API)

O endpoint /api/siafic/lote-contabil deve receber mensalmente um payload consolidando a depreciação calculada de todos os bens ativos do município.

Abaixo está o modelo de dados estruturado com o bloco de Trilha de Auditoria Imutável (Audit Trail) exigido pelo Art. 8º do Decreto nº 10.540/2020:

{
  "lote_id": "LOTE-DEP-202607-001",
  "data_geracao": "2026-07-31T23:59:59-03:00",
  "competencia": "2026-07",
  "tipo_evento": "DEPRECIACAO_MENSAL_ACUMULADA",
  "ente_federativo": {
    "municipio": "Nome do Municipio",
    "cnpj": "12.345.678/0001-90",
    "poder_orgao": "EXECUTIVO"
  },
  "resumo_financeiro": {
    "total_bens_processados": 1245,
    "valor_historico_total": 45000000.00,
    "depreciacao_periodo_total": 35420.58,
    "depreciacao_acumulada_total": 12450890.12
  },
  "lancamentos_contabeis": [
    {
      "bem_id": "PAT-2024-0897",
      "tombamento": "010897",
      "descricao": "Ambulância UTI Móvel - Placa ABC-1234",
      "metodo_calculo": "LINHA_RETA_PRORATA_DIA",
      "vida_util_meses": 60,
      "meses_restantes": 36,
      "valor_historico": 240000.00,
      "valor_residual": 24000.00,
      "valor_depreciável": 216000.00,
      "depreciacao_mensal": 3600.00,
      "depreciacao_acumulada_nova": 86400.00,
      "valor_liquido_contabil": 153600.00,
      "partida_dobrada": {
        "debito": {
          "conta_pcasp": "3.3.3.1.1.01.00",
          "nome_conta": "Depreciação de Bens Móveis (VPD)"
        },
        "credito": {
          "conta_pcasp": "1.2.3.8.1.01.02",
          "nome_conta": "Depreciação Acumulada - Veículos (Ativo)"
        },
        "fonte_recursos": "15001002",
        "valor": 3600.00
      }
    }
  ],
  "audit_trail": {
    "usuario_autor_id": "USER-99042",
    "nome_usuario": "Carlos Eduardo (Contador)",
    "perfil_nivel": 99000,
    "ip_origem": "192.168.10.45",
    "user_agent": "PatriID-Engine/2.4 (Ubuntu 24.04; Web-Client)",
    "fingerprint_seguranca": "sha256-e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "justificativa_operacao": "Fechamento automático da depreciação mensal referente à competência 2026-07."
  }
}

3. Checklist de Homologação da Depreciação (SIAFIC)

O checklist abaixo deve ser percorrido, assinado e arquivado pelo Gestor de Dados e pelo Contador-Chefe a cada fechamento mensal para fins de instrução de auditoria do Tribunal de Contas (TCE) e envio da Matriz de Saldos Contábeis (MSC) ao SICONFI.

📋 Checklist de Conformidade — Lote de Depreciação

Fase 1: Governança, Políticas e Atos Formais

Fase 2: Configuração Patrimonial e Saneamento Físico

Fase 3: Validação Contábil (Pré-Envio)

Fase 4: Execução Técnica e Transmissão via API

Fase 5: Evidenciação e Envio SICONFI


4. Assinatura e Homologação Técnica

Confirmamos que os requisitos acima descritos foram integralmente validados, testados e homologados no ambiente de homologação técnica antes do envio definitivo para produção.

[CIDADE], _ de __ de 20_.


________ ________
[NOME DO GESTOR DE DADOS] [NOME DO CONTADOR-CHEFE]
Gestor de Dados SIAFIC (Portaria Municipal) Contador-Chefe (CRC Ativo)

Roteiro de Homologação e Transição (arquivo → API)

Sistema Auxiliar de Gestão Patrimonial (PatriID) ↔ Sistema Estruturante (SIAFIC)
Alinhado ao Decreto Federal nº 10.540/2020, NBC TSP 07 e MCASP 11ª Edição


🎯 Objetivo do Documento

Este roteiro técnico e administrativo detalha as etapas necessárias para realizar a transição definitiva do modelo legado de Exportação EL por arquivos planos para a integração automatizada via webservice (API JSON) entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante) [58, 60, 61].

O objetivo é mitigar o Gap G1 (Webservice de lote contábil) e fornecer aos auditores do Tribunal de Contas (TCE) evidências robustas de tempestividade, consistência do PCASP e imutabilidade dos registros contábeis [50, 61].


📅 Cronograma de Transição (Fases 3 e 4 do Roadmap)

[Fase 1: Ajustes Fiscais/Legais] ──> [Fase 2: Código & Endurecimento] ──> [Fase 3: Operação Paralela] ──> [Fase 4: Virada de Chave & TCE]
      (Semanas 1-2)                            (Semanas 2-4)                       (Semanas 4-8)                       (Contínuo)

📋 Detalhamento das Etapas de Homologação

FASE 1: Formalização Legal e Governança (Semanas 1–2)

Antes da homologação técnica de endpoints, a base jurídica da integração deve ser formalizada para que os auditores do TCE reconheçam o fluxo como válido [45]:


FASE 2: Adequações Técnicas e Endurecimento do PatriID (Semanas 2–4)

A CC Patrimonial executa as alterações estruturais na base de dados e nos microsserviços do PatriID [63]:


FASE 3: Desenvolvimento do Endpoint e Integração Técnica (Semanas 4–8)

Trabalho conjunto entre a equipe do PatriID e o fornecedor do Sistema Estruturante (SIAFIC) [63, 64]:


FASE 4: Operação Definitiva e Dossiê de Auditoria (Contínuo)

Após bater os saldos com sucesso, ocorre a transição definitiva dos fluxos de dados [64, 65]:


🛠️ Matriz de Responsabilidades para a Integração

Atividade / Documento Responsável Principal Instrumento / Artefato Contábil
Formalização Legal Prefeito / Sec. de Fazenda Decreto Municipal nº ______ e Portaria de Nomeação [9, 51, 52]
Mapeamento PCASP Contador-Chefe (CRC) Termo de Responsabilidade Técnica (Modelo 5) [17, 18, 51, 52]
Segurança e Whitelisting Gestor de Dados SIAFIC Termo de Autorização de Acesso (Modelo 4) [14, 15, 51, 52]
Geração do Endpoint / API Equipe de TI PatriID Endpoint /api/siafic/lote-contabil [61, 64]
Validação Contábil Fornecedor do SIAFIC Resposta HTTP 201 Created / 400 Bad Request
Dossiê de Conformidade Contador-Chefe (CRC) Checklist de Conformidade TCE (Modelo 7) [22, 23, 51, 52]

Roteiro técnico e documental padronizado em conformidade com o Decreto Federal nº 10.540/2020 e as diretrizes do Tribunal de Contas para sistemas integrados [24, 53].

Cenários de Testes de Homologação

Fase 3 — Homologação e Testes de Integração da API
Referência: Decreto Federal nº 10.540/2020 (SIAFIC) · NBC TSP 07 · MCASP 11ª Edição

Este plano técnico define os 7 Cenários de Testes Estruturados a serem executados no ambiente de Homologação (Testes) para validar a comunicação automatizada entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante). O objetivo é garantir a integridade dos saldos contábeis, a segurança das transações e a imutabilidade da trilha de auditoria antes da virada definitiva para o ambiente de Produção.


📋 Painel Geral de Cenários de Testes

ID Cenário de Teste Objetivo Principal Norma / Critério Técnico
CT-01 Autenticação e Whitelisting Validar bloqueio de rede e segurança do protocolo de comunicação. Padrões de Segurança da Informação / LGPD
CT-02 Validação Prévia do PCASP Impedir a gravação de contas contábeis sintéticas, inativas ou inválidas. MCASP / Matriz de Saldos Contábeis (MSC)
CT-03 Lote de Depreciação Mensal Validar o cálculo pró-rata dia e arredondamento financeiro (Banker's Rounding). NBC TSP 07 / MCASP Cap. 11
CT-04 Workflow Obras ↔ Capitalização Testar a triagem e segregação estrita de investimentos (Capitalização) de manutenção (VPD). NBC TSP 07 (Item 29) / MCASP
CT-05 Reconhecimento de Impairment Validar a desvalorização extraordinária de bens móveis/imóveis. NBC TSP 07 (Redução ao Valor Recuperável)
CT-06 Trilha de Auditoria Imutável Forçar comandos proibidos de alteração para validar a imutabilidade física do log. Art. 8º do Decreto Federal nº 10.540/2020
CT-07 Operação em Paralelo (Lote × EL) Confrontar saldos gerados via API com os arquivos EL de exportação manual. Homologação Contábil / Batimento ao Centavo

🛠️ Detalhamento dos Cenários de Testes

CT-01: Autenticação, Conectividade e Whitelisting de Rede


CT-02: Validação Prévia do PCASP (Filtro Anti-Rejeição MSC)


CT-03: Lote de Depreciação Mensal (Pró-rata Die & Banker's Rounding)


CT-04: Workflow Obras ↔ Capitalização (Segregação VPD × Ativo)


CT-05: Teste de Impairment (Redução ao Valor Recuperável - NBC TSP 07)


CT-06: Forçamento de Falhas e Validação da Trilha de Auditoria Imutável


CT-07: Batimento Estrito e Operação em Paralelo (Lote Contábil × Arquivos EL)


📅 Cronograma de Execução da Fase 3 (Semanas 8 a 12)

O cronograma de testes está estruturado de forma a mitigar impactos na operação da prefeitura:

Roteiro CI/CD — Deploy do serviço (FastAPI)

Este roteiro estabelece o fluxo de Integração Contínua (CI) e Implantação Contínua (CD) para o microsserviço validador de contas do PCASP (baseado em FastAPI). O objetivo é garantir que cada alteração no motor de validação contábil passe por testes rigorosos de partidas dobradas e validação do PCASP antes de ser automaticamente implantada nos servidores da prefeitura (ambiente de homologação ou produção).


1. Arquitetura do Pipeline CI/CD

O fluxo foi desenhado utilizando GitHub Actions (podendo ser adaptado para GitLab CI) e conteinerização com Docker para garantir isolamento técnico, portabilidade e segurança, conforme as diretrizes do Decreto nº 10.540/2020.

[Desenvolvedor] ──> Git Push ──> [CI: Lint & Testes] ──> [Build Docker Image] ──> [Private Registry] ──> [CD: SSH Deploy] ──> [Servidor Municipal]

Principais Pilares de Segurança do Deploy:


2. Estrutura de Arquivos no Repositório

Para implementar este roteiro, a equipe de TI deve organizar a raiz do projeto do microsserviço com a seguinte estrutura de arquivos:

validador-pcasp/
├── .github/
│   └── workflows/
│       └── deploy.yml          # Pipeline de CI/CD (GitHub Actions)
├── app/
│   ├── __init__.py
│   ├── main.py                 # Microsserviço FastAPI
│   └── database.py             # Banco de dados simulado / PCASP 2026
├── tests/
│   ├── __init__.py
│   └── test_validador.py       # Testes unitários de consistência contábil
├── Dockerfile                  # Empacotamento seguro do microsserviço
├── docker-compose.yml          # Orquestração local / Produção
├── requirements.txt            # Dependências Python do projeto
└── README.md                   # Instruções de operação

3. Dockerfile Seguro (Ambiente de Produção)

O Dockerfile utiliza uma estratégia de Multi-stage Build para reduzir o tamanho da imagem final e mitigar vulnerabilidades de segurança, não executando o contêiner como usuário root.

## Stage 1: Build das dependências
FROM python:3.12-slim AS builder

WORKDIR /app

ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1

RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    && rm -rf /var/lib/apt/lists/*

COPY requirements.txt .
RUN pip install --no-cache-dir --user -r requirements.txt

## Stage 2: Imagem final de execução (Runtime)
FROM python:3.12-slim AS runner

WORKDIR /app

## Criar usuário não-root para execução segura do contêiner
RUN groupadd -g 10001 appgroup && \
    useradd -u 10001 -g appgroup -m -s /bin/bash appuser

## Copiar dependências do builder
COPY --from=builder /root/.local /home/appuser/.local
COPY --chown=appuser:appgroup app/ ./app/

ENV PATH=/home/appuser/.local/bin:$PATH
ENV PYTHONUNBUFFERED=1

## Alternar para o usuário não-privilegiado
USER appuser

EXPOSE 8000

HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:8000/health || exit 1

CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "2"]

4. Testes Unitários de Integração Contábil (test_validador.py)

Estes testes garantem que qualquer alteração de código que quebre as regras de partidas dobradas ou validação do PCASP impeça a execução do deploy automático.

import pytest
from fastapi.testclient import TestClient
from app.main import app

client = TestClient(app)

## Definição do token de autenticação simulado para os testes
HEADERS = {"Authorization": "Bearer TOKEN_HOMOLOGACAO_PATRIID_2026"}

def test_lote_valido_depreciacao():
    """Garante que lotes analíticos e ativos com soma D=C sejam aprovados"""
    payload = {
        "competencia": "2026-07",
        "lote_id": "LOTE-TESTE-OK",
        "lancamentos": [
            {
                "lancamento_id": 1,
                "conta_debito": "3.6.2.1.1.01.00", # VPD
                "conta_credito": "1.2.3.8.1.01.03", # Depreciação Acumulada
                "valor": 1500.00,
                "historico": "Depreciação mensal de veículo administrativo"
            }
        ]
    }
    response = client.post("/api/v1/validar-lote", json=payload, headers=HEADERS)
    assert response.status_code == 201
    assert response.json()["status"] == "HOMOLOGADO"

def test_rejeicao_conta_sintetica():
    """Garante o bloqueio de lançamentos em contas sintéticas"""
    payload = {
        "competencia": "2026-07",
        "lote_id": "LOTE-SINTETICA",
        "lancamentos": [
            {
                "lancamento_id": 1,
                "conta_debito": "1.2.3.0.0.00.00", # Conta Sintética (Imobilizado)
                "conta_credito": "1.2.3.8.1.01.03",
                "valor": 5000.00,
                "historico": "Lancamento incorreto em conta sintética estrutural"
            }
        ]
    }
    response = client.post("/api/v1/validar-lote", json=payload, headers=HEADERS)
    assert response.status_code == 422
    assert "SINTÉTICA" in response.json()["detail"][0]

def test_rejeicao_lote_desbalanceado():
    """Garante o bloqueio de lançamentos desequilibrados (Partidas Dobradas)"""
    payload = {
        "competencia": "2026-07",
        "lote_id": "LOTE-DESBALANCEADO",
        "lancamentos": [
            {
                "lancamento_id": 1,
                "conta_debito": "3.6.2.1.1.01.00",
                "conta_credito": "1.2.3.8.1.01.03",
                "valor": 1200.00, # Débito maior que o crédito na soma dos lançamentos do lote
                "historico": "Lote desequilibrado"
            }
        ]
    }
    # Forçando alteração de saldo na simulação para testar o balanceador
    payload["lancamentos"][0]["valor_credito_erro"] = 1000.00 
    # (Adaptado de acordo com a lógica de teste de partidas dobradas)

5. Arquivo do Pipeline CI/CD (deploy.yml)

Este arquivo automatiza o processo no GitHub Actions, realizando o lint de código, a execução dos testes contábeis e, após a aprovação, disparando o deploy seguro via SSH no servidor municipal.

name: CI/CD PatriID-SIAFIC Validator

on:
  push:
    branches:
      - main
      - develop
  pull_request:
    branches:
      - main

jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout do código
        uses: actions/checkout@v4

      - name: Configurar Python 3.12
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Instalar Dependências de Teste
        run: |
          python -m pip install --upgrade pip
          pip install flake8 pytest pytest-cov
          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi

      - name: Executar Lint (Qualidade de Código)
        run: |
          # Interrompe o build se houver erros de sintaxe Python ou indefinidos
          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
          # Avisos técnicos gerais do flake8
          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics

      - name: Executar Testes Unitários de Regras Contábeis (PCASP)
        run: |
          pytest --cov=app tests/ --cov-report=term-missing

  docker-build-and-push:
    needs: lint-and-test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    steps:
      - name: Checkout do código
        uses: actions/checkout@v4

      - name: Configurar Docker Buildx
        uses: actions/setup-qemu-action@v3
        uses: actions/setup-buildx-action@v3

      - name: Autenticar no Private Container Registry da Prefeitura
        uses: docker/login-action@v3
        with:
          registry: ${{ secrets.REGISTRY_HOST }}
          username: ${{ secrets.REGISTRY_USERNAME }}
          password: ${{ secrets.REGISTRY_PASSWORD }}

      - name: Build e Push da Imagem Docker
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: |
            ${{ secrets.REGISTRY_HOST }}/patriid/validador-pcasp:latest
            ${{ secrets.REGISTRY_HOST }}/patriid/validador-pcasp:${{ github.sha }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

  deploy-to-municipal-server:
    needs: docker-build-and-push
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    steps:
      - name: Deploy via SSH no Servidor Interno da Prefeitura
        uses: appleboy/ssh-action@v1.0.3
        with:
          host: ${{ secrets.SSH_HOST }}
          username: ${{ secrets.SSH_USER }}
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          port: ${{ secrets.SSH_PORT }}
          script: |
            # Navegar para o diretório de implantação contida no servidor
            cd /opt/patriid/validador-pcasp

            # Autenticar no registro privado de imagens dentro da infra interna
            echo "${{ secrets.REGISTRY_PASSWORD }}" | docker login ${{ secrets.REGISTRY_HOST }} -u "${{ secrets.REGISTRY_USERNAME }}" --password-stdin

            # Atualizar a imagem de produção no Docker Compose
            docker compose pull validador-api

            # Subir o microsserviço atualizado com zero-downtime (reload)
            docker compose up -d --remove-orphans

            # Limpar imagens antigas sem uso para poupar armazenamento do servidor municipal
            docker image prune -f

            # Verificar se a nova versão está respondendo ao Healthcheck
            sleep 5
            docker exec validador-api-container curl -f http://localhost:8000/health || exit 1

6. Docker Compose para Produção (docker-compose.yml)

Este arquivo organiza a execução contínua do microsserviço validador na infraestrutura de rede segura da prefeitura:

version: '3.8'

services:
  validador-api:
    image: ${REGISTRY_HOST}/patriid/validador-pcasp:latest
    container_name: validador-api-container
    restart: always
    environment:
      - APP_ENV=production
      - API_TOKEN_SECRET=${API_TOKEN_SECRET}
      - SIAFIC_API_URL=${SIAFIC_API_URL}
    ports:
      - "8000:8000"
    security_opt:
      - no-new-privileges:true
    read_only: false # FastAPI necessita de gravação temporária para logs locais de auditoria
    tmpfs:
      - /tmp
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "5"

7. Variáveis e Segredos de Configuração (Secrets)

Para que o pipeline funcione corretamente, o administrador de segurança de TI do município deve cadastrar os seguintes segredos nas configurações do repositório (Settings > Secrets and variables > Actions):

Nome do Segredo Descrição Exemplo de Valor
REGISTRY_HOST Host do registro de imagens Docker privado da prefeitura registry.municipio.gov.br
REGISTRY_USERNAME Usuário para login no registro de contêineres patriid-deployer
REGISTRY_PASSWORD Senha ou Token do registro de contêineres dckr_pat_...
SSH_HOST Endereço IP público/interno de acesso ao servidor de deploy 192.168.10.45
SSH_USER Usuário do sistema operacional com permissões Docker no servidor srv-patriid
SSH_PRIVATE_KEY Chave privada SSH autorizada no arquivo authorized_keys do servidor -----BEGIN OPENSSH PRIVATE KEY-----...
SSH_PORT Porta de conexão SSH configurada no servidor 22 (ou porta personalizada de segurança)
API_TOKEN_SECRET Chave de segurança para validar as requisições que chegam do PatriID SIAFIC_API_TOKEN_SECRET_2026_MUNICIPAL
SIAFIC_API_URL Endpoint interno da API de gravação do SIAFIC estruturante https://siafic-interno.municipio.gov.br/api/v1

Este modelo garante um ciclo de desenvolvimento extremamente seguro, auditável e ágil, mitigando riscos contábeis antes que eles alcancem a base oficial do SIAFIC.

Padrões Arquiteturais de Segurança (síntese)

PADRÕES ARQUITETURAIS DE SEGURANÇA DE INTEGRABILIDADE Diretrizes de Segurança e Governança Técnica para APIs de Integração do PatriID com o SIAFIC

Normativa de Referência:

Decreto Federal nº 10.540/2020 (SIAFIC, Art. 5º, 6º, 8º e 14)

Sistemas Integrados:

PatriID (Sistema Complementar) e SIAFIC (Sistema Estruturante Municipal)

Módulos Abrangidos:

Ativo Imobilizado (Patrimônio), Cadastro Territorial Multifinalitário (CTM) e Transparência Ativa

Classificação Normativa:

Modelo do Custo (NBC TSP 07) com depreciação automática pró-rata dia e controle físico-territorial

  1. ENQUADRAMENTO LEGAL E CADEIA DE RESPONSABILIDADE A conformidade legal de um sistema auxiliar (como o PatriID) exige um lastro jurídico formalizado que declare explicitamente o seu papel perante os órgãos de controle externo. O Decreto Federal nº 10.540/2020 estabelece que os sistemas complementares devem gerar as informações necessárias para a contabilização dos atos e fatos de gestão de forma integrada, tempestiva e automática, vedando rotinas de exportação manual como mecanismo ordinário de integração. Para garantir a segurança técnico-legal, o município deve oficializar a integração por meio de uma cadeia de governança em quatro níveis: Autoridade

Instrumento

Atribuições Centrais na Integração

Prefeito(a) Municipal

Decreto de Classificação

Classifica formalmente o PatriID como Sistema Complementar ao SIAFIC municipal nos termos do Art. 14 do Decreto nº 10.540/2020. Define legalmente o Modelo do Custo (NBC TSP 07) como política contábil padrão.

Secretário(a) de Fazenda

Portaria + Termo de Autorização

Nomeia o Gestor de Dados municipal por Portaria e emite o Termo de Autorização de Acesso, liberando credenciais e escopos de API (GET/POST/PUT) no Sistema Estruturante.

Contador-Chefe (CRC)

Termo de Responsabilidade

Homologa o mapeamento de contas PCASP (níveis analíticos), certifica o motor de depreciação mensal automática do sistema complementar e assume responsabilidade solidária pela consistência.

Gestor(a) de Dados

Protocolo de Revogação

Supervisiona a tempestividade diária das transações geradas via API, gerencia chaves de segurança técnica e formaliza a revogação de acessos em caso de exoneração de servidores.

Documento de Conformidade Técnica — SIAFIC Decreto Federal nº 10.540/2020

Página 1

PADRÕES ARQUITETURAIS DE SEGURANÇA E INTEGRAÇÃO DE APIs

PATRIID ↔ SIAFIC

  1. ARQUITETURA DE AUTENTICAÇÃO E SEGURANÇA CRIPTOGRÁFICA A comunicação eletrônica entre o Sistema Complementar e o Sistema Estruturante deve ocorrer estritamente via Webservices ou APIs, sendo expressamente proibida a exportação manual de planilhas ou layouts planos como rotina de integração. Além disso, é vetada a liberação de acesso direto ao banco de dados sem passar por camadas intermediárias de controle (Webservice de Lançamento). A segurança das APIs é garantida através dos seguintes requisitos: • Criptografia em Trânsito (HTTPS/TLS 1.3): Toda e qualquer requisição enviada pelo sistema complementar ao SIAFIC deve transitar obrigatoriamente de forma criptografada usando o protocolo HTTPS amparado por certificados SSL digitais por host virtual (vhost). • Protocolos Padronizados de Autenticação (OAuth 2.0 / JWT): O controle de segurança de escrita (POST/PUT) e de leitura (GET) exige a troca de credenciais de integração por meio de OAuth 2.0 com emissão de Tokens Bearer ou JWT temporários, com validade e expiração dinâmica. • Cofre de Segredos (Secrets Vault): Os tokens de autenticação, credenciais estáticas de máquina e chaves de API nunca devem ser hardcoded em arquivos de configuração comuns ou código-fonte. Devem ser obrigatoriamente gerenciados e injetados de forma segura em tempo de execução via cofre de segredos. • Assinatura Digital ICP-Brasil (MSC SICONFI): Toda rotina oficial de envio de saldos do município (como a Matriz de Saldos Contábeis - MSC) requer validação e assinatura digital e-CPF ou e-CNPJ da autoridade emitente com certificado ICP-Brasil pessoal e intransferível. • Criptografia de Senhas Locais (Bcrypt & MFA): As credenciais locais de operadores de nível MASTER no PatriID são armazenadas com criptografia Bcrypt de via única. Senhas legadas em texto puro herdadas de cadastros manuais são sumariamente invalidadas, obrigando o usuário a redefinir sua credencial segura no primeiro login, com suporte a Autenticação Multifator (MFA).

  2. REQUISITOS DE CONECTIVIDADE E RESILIÊNCIA DE REDE Por se tratar de sistemas que lidam com informações patrimoniais que impactam diretamente o Balanço Geral e a homologação de contas fiscais do município, as políticas de conectividade e tolerância a falhas na infraestrutura de rede devem ser tratadas de forma estrita de modo a evitar brechas ou interrupções operacionais: • IP Whitelisting Restrito: Na camada de rede, a API de recebimento de lotes contábeis do SIAFIC deve bloquear sumariamente qualquer tentativa de conexão proveniente de IPs externos que não estejam previamente cadastrados na whitelist de segurança do Gestor de Dados. • Sessão Segura e Auto-Logout: Em consonância com a LGPD e políticas de proteção de terminais públicos, o PatriID encerra compulsoriamente a sessão ativa do operador após decorridos 10 minutos de inatividade. • Fila Assíncrona com Mecanismo de Retry: Caso a API do SIAFIC se encontre indisponível ou sofra lentidão temporária, o motor contábil do PatriID armazena os eventos do dia em uma fila de mensagens local isolada. O sistema complementar executa tentativas automáticas de reenvio (retry) em intervalos programados, garantindo que nenhum lançamento se perca. • Isolamento Estrito de Banco de Dados (Multi-tenant): Para resguardar a privacidade de dados de cada ente municipal, o PatriID possui bancos de dados físicos segregados por cliente (multi-tenant com banco isolado). A resolução do tenant é realizada em tempo de execução pela validação da assinatura do JWT enviado nos cabeçalhos HTTP, dispensando controles paralelos ou planilhas externas.

Documento de Conformidade Técnica — SIAFIC Decreto Federal nº 10.540/2020

Página 2

PADRÕES ARQUITETURAIS DE SEGURANÇA E INTEGRAÇÃO DE APIs

PATRIID ↔ SIAFIC

  1. TRILHA DE AUDITORIA IMUTÁVEL (AUDIT TRAIL - ART. 8º) Conforme preconizado pelo Art. 8º do Decreto Federal nº 10.540/2020, o sistema de informações contábeis e fiscais deve garantir que todos os lançamentos possuam uma trilha de auditoria transparente e imutável. No PatriID, a tabela responsável por registrar as movimentações físicas e contábeis é a log_acoes, protegida de maneira indestrutível no banco: • Log Estruturado Append-only (Triggers de Segurança): A tabela log_acoes é configurada para aceitar apenas operações de inserção (append-only). O banco de dados do PatriID possui triggers internos de segurança que bloqueiam de forma definitiva qualquer tentativa de UPDATE ou DELETE nessa tabela, aplicando o REVOKE sobre as respectivas permissões. • Armazenamento Completo em JSONB: O log de auditoria não se limita a registrar o usuário e a hora do evento. Ele armazena um payload detalhado de dados_anteriores e dados_novos no formato nativo JSONB. Isso permite comparar e identificar exatamente qual atributo físico, valor ou conta contábil foi modificado, facilitando auditorias do Tribunal de Contas. • Metadados Obrigatórios do Evento: Cada entrada na trilha de log registra obrigatoriamente: o usuário executor, o timestamp exato sincronizado pelo servidor, o endereço IP de origem e o agente de usuário (user-agent) do navegador ou API de chamada. • Auditoria Ativa por E-mail: Operações consideradas críticas (como login, logout por inatividade, exclusão de bens permanentes com perda de tombamento, reavaliações, inventário de lotes e execução de rotinas de IA com seu respectivo custo) emitem paralelamente um alerta imediato por e-mail para gestao@patri.id para monitoria imediata. Campo JSONB

Descrição / Exemplo de Payload Estruturado no log_acoes

dados_anteriores

{"id": 105, "tombamento": "003421", "valor_contabil": 1200.00, "conta_pcasp": "1.2.3.1.1.01.02"}

dados_novos

{"id": 105, "tombamento": "003421", "valor_contabil": 1020.00, "conta_pcasp": "1.2.3.1.1.01.02", "justificativa": "Depreciação"}

contexto_requisicao

{"usuario": "admin_fazenda", "ip_origem": "189.44.120.35", "timestamp": "2026-07-26T12:00:01Z", "modulo": "Patrimônio"}

  1. PROTOCOLO DE REVOGAÇÃO DE ACESSO O protocolo de segurança técnica deve prever rotinas rigorosas de invalidação de acesso para mitigar o risco de credenciais ativas órfãs. Logo após a publicação do ato administrativo de exoneração de servidores, alteração de funções ou rescisão de contratos com terceiros, o Gestor de Dados do SIAFIC deve emitir o Protocolo de Revogação de Acesso. Este procedimento invalida permanentemente os tokens de autenticação gerados, retira os endereços IP correspondentes da whitelist de rede, desativa a conta do operador no sistema e gera o termo eletrônico de ciência formalizado com assinaturas digitais da Secretaria de Fazenda e do Contador-Chefe, resguardando a integridade da integridade municipal.

AVISO DE CONFORMIDADE SIAFIC: O descumprimento dos requisitos mínimos estabelecidos pelo Decreto nº 10.540/2020 gera sanções graves automáticas ao município, incluindo o bloqueio de transferências voluntárias federais e estaduais no CAUC (LRF, Art. 51), parecer prévio contrário com rejeição de contas anuais por parte do Tribunal de Contas (TCE) devido à ausência de processos integrados de depreciação mensal subsequente, e improbidade administrativa para o gestor e contador municipal.

Documento de Conformidade Técnica — SIAFIC Decreto Federal nº 10.540/2020

Página 3

Validador de Contas PCASP (utilitário de referência)

# -*- coding: utf-8 -*-
"""
Validador de Contas PCASP e Partidas Dobradas - PatriID ↔ SIAFIC
Este script Python simula o mecanismo de validação prévia na ponta (Sistema Complementar)
para garantir que qualquer lote contábil enviado à API do SIAFIC esteja em estrita conformidade 
com as contas analíticas ativas do PCASP, regras de partidas dobradas e o Decreto nº 10.540/2020.
"""

import json
from datetime import datetime

# Simulação da Base de Dados de Contas do PCASP do Ente Público (Exercício de 2026)
# Contas analíticas (que recebem lançamentos) e sintéticas (estruturais, bloqueadas para lançamentos)
PCASP_MOCK_DATABASE = {
    # 1. ATIVO
    "1.0.0.0.0.00.00": {"nome": "Ativo", "tipo": "Sintetica", "ativa": True},
    "1.2.0.0.0.00.00": {"nome": "Ativo Não Circulante", "tipo": "Sintetica", "ativa": True},
    "1.2.3.0.0.00.00": {"nome": "Imobilizado", "tipo": "Sintetica", "ativa": True},
    "1.2.3.1.0.00.00": {"nome": "Bens Móveis", "tipo": "Sintetica", "ativa": True},
    "1.2.3.1.1.03.01": {"nome": "Bens Móveis - Veículos Oficiais", "tipo": "Analitica", "ativa": True},
    "1.2.3.1.1.04.01": {"nome": "Bens Móveis - Máquinas e Equipamentos", "tipo": "Analitica", "ativa": True},
    "1.2.3.8.0.00.00": {"nome": "Depreciação, Amortização e Exaustão Acumuladas", "tipo": "Sintetica", "ativa": True},
    "1.2.3.8.1.01.02": {"nome": "Redução ao Valor Recuperável Acumulada de Máquinas, Equipamentos e Ferramentas", "tipo": "Analitica", "ativa": True},
    "1.2.3.8.1.01.03": {"nome": "Depreciação Acumulada de Veículos", "tipo": "Analitica", "ativa": True},

    # 3. VARIAÇÃO PATRIMONIAL DIMINUTIVA (VPD)
    "3.0.0.0.0.00.00": {"nome": "Variações Patrimoniais Diminutivas", "tipo": "Sintetica", "ativa": True},
    "3.6.0.0.0.00.00": {"nome": "Desincorporação de Ativos, Desvalorização e Perdas", "tipo": "Sintetica", "ativa": True},
    "3.6.1.1.1.01.00": {"nome": "Perdas por Redução ao Valor Recuperável de Ativos Imobilizados", "tipo": "Analitica", "ativa": True},
    "3.6.2.1.1.01.00": {"nome": "VPD - Desincorporação de Ativos - Baixas de Imobilizado", "tipo": "Analitica", "ativa": True},

    # 4. VARIAÇÃO PATRIMONIAL AUMENTATIVA (VPA)
    "4.0.0.0.0.00.00": {"nome": "Variações Patrimoniais Aumentativas", "tipo": "Sintetica", "ativa": True},
    "4.6.0.0.0.00.00": {"nome": "Reversão de Perdas e Desvalorização", "tipo": "Sintetica", "ativa": True},
    "4.6.1.1.1.01.01": {"nome": "Reversão de Perdas por Redução ao Valor Recuperável", "tipo": "Analitica", "ativa": True},
    "4.9.0.0.0.00.00": {"nome": "Outras Variações Patrimoniais Aumentativas", "tipo": "Sintetica", "ativa": True},
    "4.9.1.1.1.01.00": {"nome": "Transferências Recebidas para Incorporação de Ativos (Doação)", "tipo": "Analitica", "ativa": True},

    # 7. CONTAS DE CONTROLE
    "7.0.0.0.0.00.00": {"nome": "Controles devedores", "tipo": "Sintetica", "ativa": True},
    "7.1.2.2.1.01.00": {"nome": "Bens de Terceiros Sob Custódia (Cessão de Uso)", "tipo": "Analitica", "ativa": True},

    # 8. CONTAS DE EXECUÇÃO DE CONTROLE
    "8.0.0.0.0.00.00": {"nome": "Controles credores", "tipo": "Sintetica", "ativa": True},
    "8.1.2.2.1.01.00": {"nome": "Execução de Atos Potenciais Ativos", "tipo": "Analitica", "ativa": True},

    # CONTA INATIVA PARA TESTE DE VALIDAÇÃO
    "1.2.3.1.1.99.99": {"nome": "Conta de Bem Móvel Obsoleta e Inativa", "tipo": "Analitica", "ativa": False}
}

class PCASPValidator:
    def __init__(self, database):
        self.db = database

    def validate_account(self, code):
        """
        Valida se o código da conta existe, se é analítica e se está ativa para lançamentos.
        Retorna (True, None) se válida, ou (False, "mensagem de erro") se inválida.
        """
        if code not in self.db:
            return False, f"Erro: A conta contábil '{code}' não existe no PCASP municipal cadastrado."

        metadata = self.db[code]

        if not metadata["ativa"]:
            return False, f"Erro: A conta '{code}' ({metadata['nome']}) encontra-se INATIVA para o presente exercício fiscal."

        if metadata["tipo"] == "Sintetica":
            return False, f"Erro: A conta '{code}' ({metadata['nome']}) é SINTÉTICA. Lançamentos automáticos via API devem ocorrer estritamente em contas ANALÍTICAS."

        return True, metadata["nome"]

    def validate_batch(self, payload):
        """
        Valida um lote completo de lançamentos contábeis (Partidas Dobradas).
        Exige equilíbrio de débito e crédito, contas válidas, analíticas e ativas.
        """
        print(f"\n--- INICIANDO VALIDAÇÃO DO LOTE ---")
        print(f"Competência: {payload.get('competencia', 'N/A')}")
        print(f"Lote ID: {payload.get('lote_id', 'N/A')}")

        lancamentos = payload.get("lancamentos", [])
        if not lancamentos:
            return {
                "valido": False,
                "erro": "Lote inválido: nenhuma transação ou lançamento contido no payload.",
                "detalhes": []
            }

        erros_detectados = []
        total_debitos = 0.0
        total_creditos = 0.0
        detalhes_validacao = []

        for idx, lanc in enumerate(lancamentos):
            v_debito = round(float(lanc.get("valor_debito", 0.0)), 2)
            v_credito = round(float(lanc.get("valor_credito", 0.0)), 2)

            # Validação de valores nulos ou negativos
            if v_debito < 0 or v_credito < 0:
                erros_detectados.append(f"Lançamento #{idx+1}: Valores de débito ou crédito não podem ser negativos.")
                continue
            if v_debito == 0.0 and v_credito == 0.0:
                erros_detectados.append(f"Lançamento #{idx+1}: O lançamento deve conter um valor de débito ou crédito superior a zero.")
                continue
            if v_debito > 0.0 and v_credito > 0.0:
                erros_detectados.append(f"Lançamento #{idx+1}: Lançamentos individuais de partidas dobradas devem ter valores exclusivos para débito ou crédito.")
                continue

            # Determinação da natureza e validação da conta contábil
            conta_pcasp = lanc.get("conta_pcasp")
            status_conta, desc_ou_erro = self.validate_account(conta_pcasp)

            if not status_conta:
                erros_detectados.append(f"Lançamento #{idx+1}: {desc_ou_erro}")
                status_desc = "REJEITADA"
            else:
                status_desc = "APROVADA"
                detalhes_validacao.append({
                    "item": idx + 1,
                    "conta": conta_pcasp,
                    "nome": desc_ou_erro,
                    "valor": v_debito if v_debito > 0.0 else v_credito,
                    "tipo": "DÉBITO" if v_debito > 0.0 else "CRÉDITO"
                })

            if v_debito > 0.0:
                total_debitos += v_debito
            if v_credito > 0.0:
                total_creditos += v_credito

        # Validação do Balanço de Partidas Dobradas (Dígito de Equivalência)
        total_debitos = round(total_debitos, 2)
        total_creditos = round(total_creditos, 2)
        diferenca = round(abs(total_debitos - total_creditos), 2)

        equilibrio = (diferenca == 0.0)

        if not equilibrio:
            erros_detectados.append(
                f"Erro de Consistência (Partidas Dobradas): Total de Débitos (R$ {total_debitos:,.2f}) "
                f"difere do Total de Créditos (R$ {total_creditos:,.2f}). Diferença residual: R$ {diferenca:,.2f}."
            )

        # Diagnóstico Final do Lote
        lote_valido = len(erros_detectados) == 0

        return {
            "valido": lote_valido,
            "total_debitos": total_debitos,
            "total_creditos": total_creditos,
            "diferenca": diferenca,
            "erros": erros_detectados,
            "lancamentos_validados": detalhes_validacao
        }

# ==============================================================================
# CENÁRIOS DE SIMULAÇÃO DE TRANSMISSÃO DE DADOS (CASOS DE TESTES)
# ==============================================================================

# Caso 1: Lote de Depreciação Mensal de Veículos - PERFEITO E EQUILIBRADO (Sucesso)
payload_sucesso_depreciacao = {
    "lote_id": "LOTE-DEP-2026-07",
    "competencia": "2026-07",
    "lancamentos": [
        {
            "conta_pcasp": "3.6.2.1.1.01.00", # VPD - Baixas / Depreciação
            "valor_debito": 1500.00,
            "valor_credito": 0.00,
            "fonte_recursos": "1500"
        },
        {
            "conta_pcasp": "1.2.3.8.1.01.03", # Depreciação Acumulada de Veículos
            "valor_debito": 0.00,
            "valor_credito": 1500.00,
            "fonte_recursos": "1500"
        }
    ]
}

# Caso 2: Lote com Conta Sintética - REJEITADO (Erro Contábil)
payload_erro_sintetica = {
    "lote_id": "LOTE-CAD-SINTETICA-001",
    "competencia": "2026-07",
    "lancamentos": [
        {
            "conta_pcasp": "1.2.3.1.0.00.00", # Conta Sintética (Bens Móveis) - INVÁLIDA PARA LANÇAMENTO
            "valor_debito": 8000.00,
            "valor_credito": 0.00,
            "fonte_recursos": "1500"
        },
        {
            "conta_pcasp": "4.9.1.1.1.01.00", # Transferências Recebidas (Doação)
            "valor_debito": 0.00,
            "valor_credito": 8000.00,
            "fonte_recursos": "1500"
        }
    ]
}

# Caso 3: Lote Contábil Desequilibrado - REJEITADO (Partidas Dobradas Inválidas)
payload_erro_desbalanceado = {
    "lote_id": "LOTE-DESBALANCEADO-999",
    "competencia": "2026-07",
    "lancamentos": [
        {
            "conta_pcasp": "1.2.3.1.1.03.01", # Bens Móveis - Veículos Oficiais
            "valor_debito": 12000.00,
            "valor_credito": 0.00,
            "fonte_recursos": "1500"
        },
        {
            "conta_pcasp": "4.9.1.1.1.01.00", # Transferências Recebidas (Doação)
            "valor_debito": 0.00,
            "valor_credito": 11500.00, # Falta R$ 500,00 de crédito
            "fonte_recursos": "1500"
        }
    ]
}

# Caso 4: Lote com Conta Inativa ou Inexistente - REJEITADO (Erros Combinados)
payload_erro_multiplo = {
    "lote_id": "LOTE-ERROS-MULTIPLOS-888",
    "competencia": "2026-07",
    "lancamentos": [
        {
            "conta_pcasp": "1.2.3.1.1.99.99", # Conta Inativa
            "valor_debito": 500.00,
            "valor_credito": 0.00,
            "fonte_recursos": "1500"
        },
        {
            "conta_pcasp": "9.9.9.9.9.99.99", # Conta Inexistente
            "valor_debito": 0.00,
            "valor_credito": 500.00,
            "fonte_recursos": "1500"
        }
    ]
}

# Execução e Simulação dos Testes
if __name__ == "__main__":
    validator = PCASPValidator(PCASP_MOCK_DATABASE)

    test_cases = [
        ("CENÁRIO 1: Lote de Depreciação Mensal (Equilibrado / Analítico / Ativo)", payload_sucesso_depreciacao),
        ("CENÁRIO 2: Lote contendo Lançamento em Conta Sintética (Bloqueada)", payload_erro_sintetica),
        ("CENÁRIO 3: Lote com erro de Partidas Dobradas (Valores Desbalanceados)", payload_erro_desbalanceado),
        ("CENÁRIO 4: Lote contendo Contas Contábeis Inativas ou Inexistentes", payload_erro_multiplo)
    ]

    print("=" * 80)
    print("SIMULAÇÃO DE MOTOR DE VALIDAÇÃO DE INTEGRAÇÃO PATRIID ↔ SIAFIC")
    print("=" * 80)

    for titulo, payload in test_cases:
        print("\n" + "=" * 60)
        print(f"{titulo}")
        print("=" * 60)

        resultado = validator.validate_batch(payload)

        if resultado["valido"]:
            print("\n✔️ STATUS FINAL: LOTE HOMOLOGADO PARA TRANSMISSÃO!")
            print(f"Total de Débitos: R$ {resultado['total_debitos']:,.2f}")
            print(f"Total de Créditos: R$ {resultado['total_creditos']:,.2f}")
            print(f"Diferença Contábil: R$ {resultado['diferenca']:,.2f}")
            print("\nLançamentos Registrados com Sucesso:")
            for l in resultado["lancamentos_validados"]:
                print(f"  [{l['tipo']}] Conta {l['conta']} ({l['nome']}) - Valor: R$ {l['valor']:,.2f}")
        else:
            print("\n❌ STATUS FINAL: LOTE REJEITADO PELO SISTEMA COMPLEMENTAR!")
            print(f"Total de Débitos: R$ {resultado['total_debitos']:,.2f}")
            print(f"Total de Créditos: R$ {resultado['total_creditos']:,.2f}")
            print(f"Diferença Contábil: R$ {resultado['diferenca']:,.2f}")
            print("\nLista de Erros Críticos Identificados:")
            for erro in resultado["erros"]:
                print(f"  ⚠️ {erro}")

    print("\n" + "=" * 80)
    print("FIM DA SIMULAÇÃO")
    print("=" * 80)


Parte VI — Operação e Governança

Workflow Obras → Capitalização

Este documento especifica a estrutura do fluxo de dados (payload JSON) para a rotina de encerramento de obras em andamento e sua posterior capitalização (incorporação ao Ativo Imobilizado definitivo), em estrita conformidade com as diretrizes do MCASP (Manual de Contabilidade Aplicada ao Setor Público) da Secretaria do Tesouro Nacional (STN), as regras de negócio do PatriID (Sistema Complementar) e os requisitos de integração do SIAFIC (Sistema Estruturante) nos termos do Decreto Federal nº 10.540/2020.


1. Contexto Normativo e Regras de Negócio (MCASP)

De acordo com o MCASP (Parte II - Procedimentos Contábeis Patrimoniais) e a NBC TSP 07 (Ativo Imobilizado): 1. Obras em Andamento: Os gastos com construção, reformas ou ampliações em andamento devem ser registrados temporariamente no grupo de contas 1.2.3.2.1.06.00 (Obras em Andamento). 2. Capitalização (Ativação): Ao término da obra, mediante a emissão do Termo de Recebimento Definitivo da Obra, o saldo acumulado correspondente às melhorias deve ser transferido (capitalizado) para a conta analítica definitiva do Imobilizado (por exemplo, 1.2.3.2.1.01.xx - Edifícios de Uso Especial). 3. Segregação VPD × Ativo: Gastos com reparos e manutenções periódicas que apenas devolvem o bem à sua condição normal de operação (sem aumentar sua vida útil ou capacidade produtiva) devem ser lançados imediatamente como Variação Patrimonial Diminutiva (VPD) no grupo 3.6.1.1.x.xx.xx (Serviços de Terceiros - Manutenção e Conservação), não integrando o custo do imobilizado. 4. Integração Física e Territorial (CTM): Bens imóveis devem ter seus cadastros físicos vinculados à Inscrição Imobiliária municipal, coordenadas geográficas e ao Cadastro Imobiliário Nacional (CIB-SINTER), garantindo a conciliação físico-contábil e espacial.


2. Cenário de Simulação


3. Estrutura do Payload JSON (Request POST)

Endpoint do SIAFIC: /api/v1/siafic/integracao/lote-obras-capitalizacao
Método: POST
Autenticação: Bearer Token (OAuth2)

{
  "cabecalho_lote": {
    "sistema_origem": "PatriID - Gestão Patrimonial e CTM",
    "cnpj_origem": "12.345.678/0001-99",
    "municipio_ibge": 3201209,
    "exercicio_fiscal": 2026,
    "competencia": "2026-07",
    "timestamp_transmissao": "2026-07-26T16:28:56-03:00",
    "uuid_transacao": "bf59278f-6cf4-498c-85a7-96a9355df0bf"
  },
  "dados_obra": {
    "id_obra_patriid": 1402,
    "numero_contrato": "045/2025-PM",
    "numero_licitacao": "PE-012/2025",
    "descricao_obra": "Reforma e Ampliação Estrutural da Unidade Básica de Saúde (UBS) Central",
    "data_inicio_obra": "2025-08-10",
    "data_conclusao_obra": "2026-07-25",
    "termo_recebimento_definitivo": "TRD-089/2026",
    "laudo_tecnico_conclusao": "LTO-2026-104",
    "responsavel_tecnico_crea": "Eng. Roberto de Alencar (CREA-ES 012944-D)",
    "vinculo_territorial_ctm": {
      "inscricao_imobiliaria": "01.04.122.0045.001",
      "cib_sinter": "BR-8239472-A",
      "coordenadas_centroide": {
        "latitude": -20.3155,
        "longitude": -40.3128
      }
    }
  },
  "financeiro_evento": {
    "valor_total_gasto_acumulado": 250000.00,
    "valor_capitalizável_ativo": 200000.00,
    "valor_vpd_manutencao": 50000.00,
    "criterio_segregacao": "Análise técnica de ampliação de capacidade estrutural conforme NBR 14653 e manual MCASP 11ª Edição. A parcela de manutenção refere-se a pintura geral de reparação."
  },
  "lancamentos_contabeis": [
    {
      "item": 1,
      "descricao": "Capitalização parcial da obra da UBS Central - Parcela de Ampliação Física (Imobilizado)",
      "natureza_informacao": "P",
      "fonte_recursos": "15001002",
      "debitos": [
        {
          "conta_analitica_pcasp": "1.2.3.2.1.01.02.01",
          "nome_conta": "Edifícios de Uso Especial - Unidades de Saúde (Analítica)",
          "valor": 200000.00
        }
      ],
      "creditos": [
        {
          "conta_analitica_pcasp": "1.2.3.2.1.06.01.02",
          "nome_conta": "Obras em Andamento - Edifícios de Uso Especial (Analítica)",
          "valor": 200000.00
        }
      ]
    },
    {
      "item": 2,
      "descricao": "Reclassificação de gastos não capitalizáveis da obra da UBS Central para VPD de Manutenção",
      "natureza_informacao": "P",
      "fonte_recursos": "15001002",
      "debitos": [
        {
          "conta_analitica_pcasp": "3.6.1.1.1.01.02",
          "nome_conta": "VPD - Serviços de Terceiros - Manutenção e Conservação de Bens Imóveis",
          "valor": 50000.00
        }
      ],
      "creditos": [
        {
          "conta_analitica_pcasp": "1.2.3.2.1.06.01.02",
          "nome_conta": "Obras em Andamento - Edifícios de Uso Especial (Analítica)",
          "valor": 50000.00
        }
      ]
    }
  ],
  "trilha_auditoria": {
    "usuario_autor": "cristiano.contador.fazenda",
    "perfil_usuario": "MASTER (99000)",
    "ip_origem": "192.168.10.45",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) PatriID/v2.1",
    "acao": "CAPITALIZACAO_OBRA_ENCERRAMENTO",
    "dados_anteriores": {
      "id_obra": 1402,
      "status": "EM_ANDAMENTO",
      "saldo_acumulado_obras_andamento": 250000.00,
      "imovel_vinculado": {
        "tombamento_imovel": "IM-00844",
        "valor_historico_imovel": 1200000.00
      }
    },
    "dados_novos": {
      "id_obra": 1402,
      "status": "CONCLUIDA_E_CAPITALIZADA",
      "saldo_acumulado_obras_andamento": 0.00,
      "imovel_vinculado": {
        "tombamento_imovel": "IM-00844",
        "novo_valor_historico_imovel": 1400000.00,
        "justificativa": "Incorporação de R$ 200.000,00 de ampliação física via TRD-089/2026."
      }
    }
  }
}

4. Contratos de Resposta HTTP (SIAFIC)

A. Resposta de Sucesso: 201 Created

Retornada quando o SIAFIC valida e consolida os lançamentos contábeis em sua base única de dados.

{
  "status": "sucesso",
  "codigo": 201,
  "mensagem": "Lote contábil de capitalização de obra processado e integrado com sucesso.",
  "dados_resposta": {
    "uuid_transacao": "bf59278f-6cf4-498c-85a7-96a9355df0bf",
    "numero_lote_siafic": "2026.00495",
    "lancamentos_gerados": [
      {
        "partida": "P_009482",
        "status": "LIQUIDADO"
      },
      {
        "partida": "P_009483",
        "status": "LIQUIDADO"
      }
    ],
    "timestamp_processamento": "2026-07-26T16:29:02-03:00"
  }
}

B. Resposta de Erro de Validação: 400 Bad Request

Retornada se houver qualquer divergência nas contas do PCASP ou erro nas fontes de recursos informadas.

{
  "status": "erro_validacao",
  "codigo": 400,
  "mensagem": "Falha na validação contábil do lote. O lançamento foi rejeitado para proteção da base única do SIAFIC.",
  "erros_detalhados": [
    {
      "campo": "lancamentos_contabeis[0].debitos[0].conta_analitica_pcasp",
      "valor_recebido": "1.2.3.2.1.01.00",
      "motivo": "A conta informada é sintética (.00). O SIAFIC exige exclusivamente contas analíticas ativas para o exercício vigente."
    },
    {
      "campo": "lancamentos_contabeis[1].fonte_recursos",
      "valor_recebido": "15001002",
      "motivo": "Fonte de Recursos inativa ou inválida para a conta de VPD '3.6.1.1.1.01.02' na Matriz de Saldos Contábeis (MSC) municipal."
    }
  ],
  "timestamp_erro": "2026-07-26T16:28:58-03:00"
}

5. Práticas de Segurança e Conectividade Recomendas

  1. Cofre de Segredos: As chaves de API e tokens Bearer de comunicação jamais devem ser expostos em arquivos de configuração locais ou no banco de dados em formato legível. Recomenda-se o uso de variáveis de ambiente (.env) ou cofres de segredos gerenciados.
  2. IP Whitelisting: O SIAFIC deve configurar regras de firewall para permitir requisições de escrita (POST/PUT) oriundas unicamente do endereço IP estático homologado dos servidores do PatriID.
  3. Fila Assíncrona com Retry: Em caso de oscilações na rede ou indisponibilidade temporária do SIAFIC, o PatriID deve enfileirar o payload localmente em banco isolado e disparar tentativas de retransmissão de forma assíncrona até obter a resposta HTTP de sucesso.

Plano — Fase 2: Inventário e Saneamento

Cronograma Estimado: Semanas 3 a 10 (8 Semanas)

Este documento estabelece as diretrizes operacionais, contábeis e metodológicas para a execução da Fase 2 — Inventário e Saneamento Físico-Patrimonial no âmbito da implantação do PatriID como Sistema Complementar ao SIAFIC municipal.

O principal objetivo desta fase é eliminar o histórico "custo da inércia" e as inconsistências fiscais apontadas pelos Tribunais de Contas — como bens nunca depreciados, bases físicas divergentes da contabilidade e classificações errôneas de despesas — estabelecendo uma base de dados saneada, georreferenciada e perfeitamente conciliada antes da homologação da API de integração contábil.


📋 Sumário de Execução da Fase 2

  1. Passo 1: Planejamento Operacional e Setorização Territorial (Semana 3)
  2. Passo 2: Levantamento Físico de Campo com CATMAT-AI (Semanas 4 a 6)
  3. Passo 3: Engenharia de Avaliações (NBR 14653) e Laudos Técnicos (Semanas 7 a 8)
  4. Passo 4: Saneamento de Contas e Parametrização Contábil (Semana 9)
  5. Passo 5: Conciliação Físico-Contábil Inicial e Geração do Balanço de Abertura (Semana 10)

1. Passo 1: Planejamento Operacional e Setorização Territorial (Semana 3)

Antes de enviar as equipes a campo, a prefeitura deve estruturar a logística e as permissões de acesso físico aos ativos municipais.

1.1. Atividades Críticas:


2. Passo 2: Levantamento Físico de Campo com CATMAT-AI (Semanas 4 a 6)

Esta etapa consiste no cadastramento "in loco" de todos os bens móveis, imóveis e ativos de infraestrutura do município, utilizando a tecnologia móvel offline-first do PatriID.

2.1. Metodologia de Campo:


3. Passo 3: Engenharia de Avaliações (NBR 14653) e Laudos Técnicos (Semanas 7 a 8)

Muitos bens públicos municipais encontram-se registrados por valores simbólicos ou históricos defasados. Para atender às normas contábeis brasileiras (NBC TSP 07), o município deve atualizar os valores sob critérios técnicos de engenharia de avaliações.

3.1. Procedimento Técnico:


4. Passo 4: Saneamento de Contas e Parametrização Contábil (Semana 9)

Com os dados de campo consolidados, o contador-chefe realiza o saneamento das contas do PCASP municipal para alinhar a base física à classificação orçamentária e patrimonial exigida pelo MCASP.

4.1. Regras de Parametrização no PatriID:


5. Passo 5: Conciliação Físico-Contábil Inicial (Semana 10)

O fechamento da Fase 2 consiste no batimento estrito entre os saldos contábeis históricos (Razão Geral) e o resultado físico do novo inventário.

5.1. Roteiro de Conciliação Físico-Contábil:


🛠️ Matriz de Responsabilidades para a Fase 2

Atividade Responsável Técnico Artefato Gerado
Setorização e Logística Gestor de Dados SIAFIC Cronograma de Visitas
Inventário de Campo Comissão de Inventário + PatriID Mobile Cadastro Físico com Fotos e GPS
Laudos de Avaliação Engenheiro/Avaliador Credenciado Laudos Técnicos (NBR 14653)
Mapeamento Contábil PCASP Contador-Chefe do Município (CRC) Matriz de Contas Analíticas Ativas
Conciliação e Fechamento Contador-Chefe + Gestor de Dados Balancete Físico-Contábil Inicial
Assinatura do Checklist TCE Contador-Chefe Checklist de Conformidade Homologado

Plano de ação desenvolvido em conformidade com as diretrizes do Decreto Federal nº 10.540/2020 (SIAFIC), da NBC TSP 07 e do MCASP 11ª Edição. Todos os registros operacionais gerados durante esta fase serão protegidos pelo log de auditoria imutável (Audit Trail).

Plano — Fase 4: Operação e Governança Contínua

Este documento estabelece as diretrizes, rotinas técnicas e o modelo de governança para a Fase 4 (Operação e Prova de Conformidade) do processo de integração entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante), em total aderência às exigências do Decreto Federal nº 10.540/2020, da NBC TSP 07 e do MCASP (11ª Edição).

Enquanto as fases anteriores concentram-se na formalização legal, saneamento físico e homologação da infraestrutura técnica, a Fase 4 é de caráter contínuo e permanente. Ela visa consolidar os ganhos de qualidade, blindar o município contra passivos fiscais e garantir a aprovação de contas perante o Tribunal de Contas do Estado (TCE).


1. Escopo Geral e Objetivos da Fase 4

A transição definitiva para a operação integrada automatizada por API extingue a exportação manual de arquivos legados (Exportação EL) como rotina ordinária. A Fase 4 estabelece uma rotina de monitoramento, conciliação mensal e manutenção do dossiê de conformidade para auditoria.

Objetivos Primordiais:

  1. Regularidade Patrimonial Absoluta (100%): Garantir que todos os bens permanentes do município estejam inventariados, plaquetados, georreferenciados e corretamente depreciados.
  2. Zero Exportação Manual: Manutenção do tráfego automatizado e tempestivo de lotes contábeis via API/Webservice.
  3. CAUC Limpo: Monitorar preventivamente as validações do SICONFI para impedir bloqueios de transferências voluntárias e convênios federais ou estaduais.
  4. Proteção Jurídica: Mitigar riscos de improbidade administrativa para o Prefeito, Secretário de Fazenda e Contador-Chefe, por meio de uma governança documental e técnica indestrutível.

2. Rotinas Operacionais Contínuas e Prazos

Rotina 2.1: Fechamento Mensal e Depreciação Automatizada

Rotina 2.2: Workflow Obras ↔ Capitalização com Inteligência Artificial

Rotina 2.3: Conciliação Mensal (Balancete × PatriID)

Rotina 2.4: Gestão Documental Digital e Dossiê de Auditoria


3. Matriz de Governança e Responsabilidade Operacional

A governança na fase de operação contínua distribui-se em níveis complementares e integrados de responsabilidade:

Agente Público Papel na Operação Contínua Atividade-Chave
Prefeito(a) Municipal Supervisor Político-Institucional • Resguardar a vigência e aplicação do Decreto Municipal de Classificação.
• Autorizar recursos orçamentários para a comissão de inventário e infraestrutura de TI.
Secretário(a) de Fazenda Gestor da Política Fiscal e de TI • Fiscalizar a tempestividade dos reflexos contábeis patrimoniais no SIAFIC.
• Monitorar o CAUC municipal e autorizar as renovações de vigência de acesso de credenciais API.
Contador(a)-Chefe (CRC) Autoridade Contábil e de Controle • Executar a conciliação mensal obrigatória Balancete × PatriID.
• Assinar digitalmente as Notas Explicativas e o Checklist de Conformidade TCE.
• Responder solidariamente pela exatidão dos saldos patrimoniais no balanço.
Gestor(a) de Dados Administrador de Conectividade e Segurança • Supervisionar o tráfego de requisições de API e gerenciar tokens de acesso seguros (em cofre de segredos).
• Monitorar logs imutáveis (log_acoes JSONB).
• Executar imediatamente o Protocolo de Revogação de Acesso em casos de demissão/afastamento de servidores.

4. Trilha de Auditoria Imutável (Art. 8º do Decreto nº 10.540/2020)

Como elemento inegociável de governança continuada, a integridade de todas as movimentações patrimoniais é protegida por um mecanismo de log de dados append-only (patriid.log_acoes). * Blindagem de Banco: Triggers ativas na base de dados barram qualquer tentativa de execução dos comandos UPDATE ou DELETE sobre a tabela de logs de auditoria. * Detalhamento Granular: Cada registro captura de forma compulsória o usuário autor do ato, timestamp preciso do servidor, IP de origem, agente de usuário (user-agent) e o comparativo estruturado em formato JSONB (dados_anteriores e dados_novos). * Auditoria Cruzada por E-mail: Alertas automáticos imediatos são despachados para a gestão central em tempo real para eventos sensíveis como exclusão de bens, alterações cadastrais críticas ou tentativas de acesso de fora da whitelist de IPs autorizados.


5. Checklist de Avaliação Trimestral de Conformidade (TCE)

A cada trimestre, o Contador-Chefe e o Gestor de Dados devem preencher de forma conjunta o Checklist de Conformidade (Modelo 7 do Manual). Esse documento deve ser mantido em arquivo junto às contas do exercício para pronta apresentação às equipes de fiscalização externa:

  1. [ ] Integração Web Service Ativa: Lançamentos transmitidos exclusivamente por API, com zero uso de arquivos de exportação manual.
  2. [ ] Validação PCASP Integrada: Inexistência de lançamentos contendo contas sintéticas, extintas ou inativas no exercício corrente.
  3. [ ] Depreciação Mensal Executada: Memórias de cálculo arquivadas por competência, demonstrando exatidão centavo a centavo.
  4. [ ] Trilha de Auditoria Intacta: Logs imutáveis operando sem lacunas de timestamp ou de identificação de usuários.
  5. [ ] Segurança de Rede Rígida: Credenciais mantidas em cofre de segredos, autenticação OAuth2 válida e Whitelist de IPs de rede devidamente atualizada (com protocolos de revogação aplicados em 100% dos desligamentos de servidores).
  6. [ ] Notas Explicativas Publicadas: Evidenciação clara da política de mensuração (Modelo do Custo), taxas de depreciação e ocorrência de impairment de bens móveis e imóveis.

Documento elaborado para fins de governança continuada e conformidade técnico-legal de sistemas complementares. Base normativa aplicável: Decreto Federal nº 10.540/2020 (SIAFIC) · NBC TSP 07 (Ativo Imobilizado) · MCASP (11ª Edição) · Portaria STN nº 6.424/2016.

Notas Explicativas Patrimoniais (modelos)

EXERCÍCIO FINANCEIRO DE 2026

MUNICÍPIO DE [NOME DO MUNICÍPIO] — [UF] SISTEMA COMPLEMENTAR DE GESTÃO PATRIMONIAL: PATRIID ASSUNTO: EVOLUÇÃO, DIRETRIZES E MENSURAÇÃO SUBSEQUENTE DO ATIVO IMOBILIZADO


NOTA EXPLICATIVA Nº [XX] — ATIVO IMOBILIZADO (MENSURAÇÃO, DEPRECIAÇÃO E SANEARMENTO)

1. Contexto Operacional e Balizamento Normativo

As presentes notas explicativas têm por finalidade evidenciar os critérios de reconhecimento, mensuração, depreciação, amortização e redução ao valor recuperável (impairment) aplicados aos bens móveis e imóveis de propriedade ou sob custódia deste Ente Federativo durante o exercício de 2026.

As práticas contábeis e administrativas aqui descritas foram executadas em estrita consonância com: * A Norma Brasileira de Contabilidade Aplicada ao Setor Público (NBC TSP 07 — Ativo Imobilizado); * O Manual de Contabilidade Aplicada ao Setor Público (MCASP 11ª Edição) emitido pela Secretaria do Tesouro Nacional (STN); * As exigências de tempestividade, integridade e segurança estabelecidas pelo Decreto Federal nº 10.540, de 16 de outubro de 2020 (SIAFIC); * O Decreto Municipal de Classificação nº [Nº DO DECRETO], que classifica e oficializa o sistema PatriID como o Sistema Complementar de Gestão Patrimonial do município.

2. Políticas de Reconhecimento e Limites de Capitalização vs. VPD

O Ativo Imobilizado compreende os ativos tangíveis que são mantidos para uso na produção ou fornecimento de bens ou serviços, para locação a terceiros, ou para fins administrativos, e cuja expectativa de utilização ultrapasse um período (exercício) de 12 meses.

2.1 Critério de Classificação Inicial (CATMAT-AI)

A triagem física e a classificação dos bens adquiridos no exercício foram realizadas com o suporte da tecnologia CATMAT-AI integrada ao PatriID. Esse mecanismo de leitura semântica analisa as descrições de notas fiscais de compra e sugere o enquadramento adequado, distinguindo materiais de consumo de bens permanentes e apontando a respectiva conta analítica do Plano de Contas Aplicado ao Setor Público (PCASP).

2.2 Distinção entre Gastos de Conservação (VPD) e Capitalização (Melhorias)

Em cumprimento às diretrizes contidas na Parte II (Capítulo 11) do MCASP 11ª Edição, as intervenções físicas e reformas ocorridas nos ativos foram objeto de triagem rigorosa com auxílio de assistente inteligente, aplicando as seguintes premissas: * Variação Patrimonial Diminutiva (VPD): Os gastos de manutenção rotineira, reparos e conservação que visam apenas restituir ou manter o ativo em condições normais de operação, sem ampliar sua capacidade produtiva ou estender sua vida útil original, foram lançados diretamente como despesa do período (VPD). * Capitalização ao Ativo: Os gastos com reformas estruturais, ampliações ou substituições de componentes que resultem no aumento comprovado da vida útil econômica do bem, elevação de sua capacidade produtiva ou redução significativa de seus custos operacionais foram capitalizados, sendo adicionados ao valor contábil do ativo principal com a correspondente baixa de eventuais partes substituídas.

3. Métodos de Mensuração Subsequente

O Município adota como política contábil padrão para a mensuração subsequente do Ativo Imobilizado o Modelo do Custo, conforme autorizado pelo MCASP e NBC TSP 07.

Sob este modelo, os ativos imobilizados são mantidos pelo seu custo histórico de aquisição ou construção, deduzido da depreciação acumulada e de eventuais perdas acumuladas por redução ao valor recuperável (impairment).

3.1 Mensuração de Imóveis e Segregação Contábil (Terreno vs. Edificação)

Para os bens imóveis integrados ao patrimônio, o Município adota a segregação contábil obrigatória prevista no item 72 da NBC TSP 07: * Terrenos: São classificados de forma individualizada e mantidos sem incidência de depreciação, uma vez que possuem vida útil econômica ilimitada. * Edificações (Benfeitorias): São mensuradas separadamente e sujeitas à depreciação mensal sistemática com base em sua vida útil econômica útil estimada.

A consistência física de tais registros é assegurada pela integração dos dados patrimoniais do PatriID com o Cadastro Territorial Multifinalitário (CTM) e o SINTER (Sistema Nacional de Gestão de Informações Territoriais), amarrando cada registro contábil do grupo 1.2.3.x a poligonais georreferenciadas, imagens reais e inscrições do Cadastro Imobiliário Brasileiro (CIB).

4. Motor e Sistemática de Depreciação Mensal

A depreciação acumulada reflete o desgaste físico, obsolescência tecnológica ou esforço de uso sistemático dos ativos ao longo do tempo.

4.1 Método de Cálculo

O método adotado para o cálculo da depreciação é o Método das Quotas Constantes (Linear), distribuindo o valor depreciável (valor histórico deduzido do valor residual) de forma uniforme ao longo da vida útil estimada do bem.

4.2 Critério Pró-Rata Die e Arredondamento Bancário

Para assegurar o registro tempestivo exigido pelo Decreto Federal nº 10.540/2020 (Art. 6º), a depreciação é processada mensalmente de forma automática com base no critério pró-rata die (proporcional aos dias de uso ativo no mês de incorporação ou desincorporação).

Para a exatidão matemática do balanço de fechamento, o motor de depreciação do PatriID emprega o algoritmo de arredondamento financeiro Banker's Rounding (arredondamento ao par mais próximo) nas frações de centavos, eliminando desvios cumulativos ao consolidar grandes frotas de ativos.

4.3 Tabela de Vida Útil e Valor Residual Estimados

As vidas úteis econômicas e os valores residuais foram revisados pela Comissão Especial de Inventário e Engenharia de Avaliações (com base na norma NBR 14653), aplicando-se os seguintes parâmetros médios de mercado por classe de bens:

Classe de Ativos (PCASP) Vida Útil Estimada (Anos) Valor Residual Adotado (%) Método de Depreciação
Edifícios Públicos (Próprios) 50 anos 10% Quotas Constantes (Linear)
Veículos Oficiais (Frotas/Ambulâncias) 5 a 10 anos 10% a 20% Quotas Constantes (Linear)
Equipamentos Médicos/Hospitalares 10 anos 10% Quotas Constantes (Linear)
Mobiliário em Geral 10 anos 10% Quotas Constantes (Linear)
Equipamentos de Informática 5 anos 5% Quotas Constantes (Linear)

Nota: Bens de valor histórico, artístico, arqueológico ou terrenos não são depreciados em razão de sua natureza ou durabilidade indeterminada.

5. Testes de Redução ao Valor Recuperável (Impairment)

Durante o exercício de 2026, os ativos imobilizados foram submetidos a avaliações periódicas para identificar indícios de desvalorização extraordinária física ou operacional (impairment), nos termos das NBC TSP 09 (Ativos Não Geradores de Caixa) e NBC TSP 10 (Ativos Geradores de Caixa).

5.1 Apuração e Registro Contábil de Perdas

Sempre que o valor contábil líquido de um imobilizado excedeu o seu Valor Recuperável (definido como o maior valor entre o seu valor justo líquido de despesas de venda e o seu valor em uso), o Ativo foi reduzido ao seu valor limite de recuperação, sendo a diferença de desvalorização registrada contábil e imediatamente como: * Débito: Conta de Variação Patrimonial Diminutiva — VPD (3.6.1.1.1.01.xx - Perdas por Redução ao Valor Recuperável de Ativos Imobilizados); * Crédito: Conta Retificadora do Ativo Imobilizado (1.2.3.8.1.01.xx - Redução ao Valor Recuperável Acumulada).

5.2 Reversão de Perdas por Impairment

Nos casos em que as vistorias técnicas subsequentes comprovaram o restabelecimento do potencial de serviços ou do valor de mercado de um ativo anteriormente desvalorizado, procedeu-se ao lançamento de Reversão de Impairment, limitado ao custo histórico líquido original que o ativo teria se a perda extraordinária anterior nunca houvesse ocorrido, escriturando-se: * Débito: Conta Retificadora do Ativo Imobilizado (1.2.3.8.1.01.xx - Redução ao Valor Recuperável Acumulada); * Crédito: Conta de Variação Patrimonial Aumentativa — VPA (4.6.1.1.1.01.xx - Reversão de Perdas por Redução ao Valor Recuperável).

6. Baixas e Desincorporações de Bens Inservíveis

A desincorporação física e contábil de ativos imobilizados motivada por sinistro, alienação (leilão), doação concedida ou obsolescência irreversível foi realizada de forma individualizada com suporte em Laudo Técnico de Inservibilidade e respectivo ato de autorização da autoridade competente.

A baixa contábil envolve a eliminação simultânea do custo histórico do Ativo e de sua respectiva depreciação acumulada correspondente na data da baixa, sendo o valor líquido contábil residual baixado como perda definitiva em conta de VPD (3.6.2.1.1.01.00 - VPD - Desincorporação de Ativos - Baixas de Imobilizado).

7. Tratamento de Bens sob Regime Especial

8. Governança e Trilha de Auditoria Imutável (Art. 8º do Decreto nº 10.540/2020)

Como garantia de fidedignidade e transparência perante o Tribunal de Contas, todos os lançamentos patrimoniais, depreciações, reavaliações e alterações de parâmetros contábeis processados na plataforma complementar do PatriID geram registros automáticos de auditoria.

A tabela de logs (patriid.log_acoes) opera sob políticas de segurança rigorosas de banco de dados (append-only), bloqueando comandos de deleção ou alteração física (REVOKE UPDATE/DELETE). Cada alteração de cadastro ou cálculo contábil grava permanentemente o IP de origem homologado, identificação do usuário master responsável, timestamp do servidor e a alteração detalhada em formato estruturado JSONB (dados_anteriores e dados_novos), servindo de suporte técnico definitivo para a equipe de fiscalização e auditoria externa.


[NOME COMPLETO DO CONTADOR-CHEFE]
Contador(a)-Chefe do Município
CRC-[UF] nº [CRC]

[NOME COMPLETO DO GESTOR DE DADOS]
Gestor de Dados SIAFIC
Portaria nº [Nº DA PORTARIA] / [ANO]

Ata de Conciliação Contábil (modelo preenchido — jul/2026)

Competência: Julho de 2026
Data de Emissão: 26 de julho de 2026
Sistema de Origem: Patriid — Sistema Complementar de Gestão Patrimonial
Sistema de Destino: SIAFIC — Sistema Único e Integrado de Execução Orçamentária, Financeira e Contábil
Fundamentação: Art. 14 do Decreto Federal nº 10.540/2020 · NBC TSP 07 · MCASP 11ª Edição


1. PREÂMBULO E PARTICIPANTES

Aos vinte e seis dias do mês de julho do ano de dois mil e vinte e seis, reuniram-se na Secretaria Municipal de Fazenda os responsáveis técnicos ao final assinados para fins de validação, conciliação e encerramento das rotinas patrimoniais relativas à competência de Julho/2026 [8]. Esta sessão de conciliação visa homologar as transações automáticas enviadas via API pelo sistema complementar PatriID para apropriação direta e tempestiva no SIAFIC, assegurando a integridade absoluta dos balancetes sob o regime de competência [9, 10, 11].


2. RELATÓRIO DE TRANSAÇÕES E EVENTOS PATRIMONIAIS DO PERÍODO

Durante o mês de julho de 2026, o PatriID processou as seguintes mutações patrimoniais, transmitidas via webservice após validação analítica prévia na ponta [11, 31]:

A. Depreciação Mensal Sistemática (NBC TSP 07 / MCASP 11ª Ed.)

B. Baixa e Desincorporação de Ativos Inservíveis

C. Redução ao Valor Recuperável (Impairment - NBC TSP 09)

D. Reversão Parcial de Impairment Anterior (NBC TSP 09)

E. Incorporação por Doações e Cessões de Uso

  1. Doação Recebida (Computadores Portáteis):
    • Custo de Avaliação: R$ 45.000,00
    • DÉBITO: 1.2.3.1.1.04.01 (Bens Móveis - Máquinas e Equipamentos de TI) — R$ 45.000,00
    • CRÉDITO: 4.9.1.1.1.01.00 (VPA - Transferências Recebidas para Incorporação de Ativos) — R$ 45.000,00
  2. Cessão de Uso Recebida (Imóvel da União - UBS):
    • Valor Arbitrado: R$ 1.200.000,00
    • DÉBITO: 7.1.2.2.1.01.00 (Atos Potenciais Ativos - Bens de Terceiros Sob Custódia) — R$ 1.200.000,00
    • CRÉDITO: 8.1.2.2.1.01.00 (Execução de Atos Potenciais Ativos) — R$ 1.200.000,00

F. Ativação e Capitalização de Obras Concluídas (Vínculo CTM / SINTER)


3. VALIDAÇÃO DE INTEGRIDADE CONTÁBIL (PCASP E CONTROLE DE ERROS)

Os signatários atestam que todas as transações supracitadas foram processadas sob o rigoroso motor de validação da plataforma complementar, com os seguintes critérios de conformidade técnica homologados [11]:

  1. Diferença de Partidas Dobradas Igual a Zero: O somatório de todos os débitos patrimoniais bateu perfeitamente com os créditos em cada lote analítico, resultando em uma diferença residual de exatamente R$ 0,00 (zero centavo).
  2. Validação de PCASP Analítico: Todas as contas contábeis utilizadas pertencem ao PCASP vigente (Exercício de 2026), estando devidamente ativas. O validador integrado bloqueou na origem qualquer tentativa de envio direcionada a contas sintéticas (terminadas em .00 ou sem desdobramento analítico), cumprindo o Artigo 14 do Decreto nº 10.540/2020 [11, 31].
  3. Controle de Arredondamento: O uso sistemático do arredondamento Banker's Rounding garantiu que não houvesse acúmulo de centavos artificiais nas frações de cálculo de depreciação mensal por ativo, garantindo consistência com os saldos apresentados na memória de cálculo arquivada [14].

4. CONFORMIDADE COM O DECRETO FEDERAL Nº 10.540/2020

Em cumprimento à legislação federal de regência do SIAFIC e aos controles de transparência ativa e passiva [8, 9, 10]:

E por estarem de acordo, lavra-se a presente ata, que será assinada digitalmente pelos responsáveis para fazer prova técnica e documental de governança patrimonial perante o Tribunal de Contas do Estado (TCE) e controle interno municipal [9].


[Município]/[UF], 26 de julho de 2026.


CONTADOR(A)-CHEFE DO MUNICÍPIO
Responsável Técnico - CRC-XX nº [NÚMERO]


GESTOR(A) DE DADOS SIAFIC MUNICIPAL
Representante Técnico de APIs e Chaves - Portaria nº [NÚMERO]


REPRESENTANTE DO CONTROLE INTERNO
Supervisor de Governança e Compliance Patrimonial

Plano de Capacitação e Treinamento dos Servidores

Sessões de Capacitação para Equipes Fiscais, Contábeis e Técnicas Municipais Projeto de Adequação ao Decreto Federal nº 10.540/2020 (SIAFIC) — Plataforma PatriID


1. Apresentação e Diretrizes de Capacitação

A transição tecnológica e contábil estabelecida pelo Decreto Federal nº 10.540/2020 (SIAFIC) exige muito mais do que a simples integração de sistemas via API; ela demanda o empoderamento técnico do corpo de servidores públicos municipais [9, 11]. O presente Plano de Capacitação e Treinamento foi estruturado para fornecer autonomia operacional e fiduciária às equipes da prefeitura, garantindo que as rotinas diárias e mensais de controle físico-financeiro do imobilizado ocorram sem riscos de erros contábeis ou sanções fiscais [12, 13].

O treinamento é dividido por módulos focados em perfis específicos de atuação, estendendo-se ao longo do cronograma de transição de 12 semanas do município, em perfeita harmonia com as frentes de trabalho operacional [18].


2. Matriz de Perfis e Público-Alvo

Para garantir a máxima eficiência do aprendizado, os servidores municipais são segmentados de acordo com suas competências e responsabilidades institucionais:

Perfil de Servidor Papel no Processo de Adequação Foco do Treinamento
Comissão de Inventário & Fiscais de Patrimônio Levantamento físico de campo, plaqueteamento de bens permanentes e identificação de ociosidades [20]. Coleta mobile offline, uso do CATMAT-AI para classificação e registro de dados no Cadastro Territorial (CTM) [15, 17, 20].
Contador-Chefe e Equipe Contábil (CRC) Homologação de lotes contábeis, revisão do PCASP analítico, cálculo de desgaste e envio de notas explicativas [20, 31]. Operação do motor de depreciação (Banker's Rounding), conciliação físico-contábil e validações contábeis prévias [14, 31].
Gestor de Dados SIAFIC & Equipe de TI Gerência das chaves de segurança (tokens), administração de credenciais da API e controle de rede [28, 29, 30]. Protocolos de Whitelisting de IP, controle do cofre de segredos, logs de auditoria e protocolo de revogação imediata [29, 30, 32].
Controladores Internos & Auditores Fiscalização de conformidade de processos contábeis e acompanhamento preventivo do CAUC [21]. Execução do checklist consolidado do TCE, acompanhamento preventivo das trilhas de auditoria imutáveis e metas fiscais [21, 26].

3. Estruturação dos Módulos de Treinamento

Módulo I: Alinhamento Legal, Riscos Fiscais e Governança do SIAFIC

Módulo II: Saneamento, Inventário Físico de Campo e CATMAT-AI

Módulo III: Motores de Depreciação, Fechamento Contábil e Regras do PCASP

Módulo IV: Segurança de Rede, Controle de APIs e Gestão de Incidentes


4. Cronograma de Capacitação Integrado ao Roadmap

O treinamento é programado de forma modular e progressiva para coincidir com as necessidades operacionais e marcos de entrega de cada fase do cronograma municipal [18]:

Fase 1: Formalização Legal (Semanas 1-2)
  └── Módulo I: Alinhamento Legal, Riscos Fiscais e Governança do SIAFIC
      (Realizado na Semana 2 · Preparação para a nomeação dos agentes chave) [19]

Fase 2: Inventário & Saneamento (Semanas 3-10)
  └── Módulo II: Saneamento, Inventário Físico de Campo e CATMAT-AI
      (Realizado nas Semanas 3 e 4 · Capacitação prática em campo com apps) [20]

Fase 3: Integração Técnica (Semanas 8-12)
  └── Módulo IV: Segurança de Rede, Controle de APIs e Gestão de Incidentes
      (Realizado na Semana 8 · Preparação do ambiente de Homologação) [20]
  └── Módulo III: Motores de Depreciação, Fechamento Contábil e Regras do PCASP
      (Realizado na Semana 9 · Simulações de batimento físico-contábil) [20]

Fase 4: Operação Contínua (Contínuo)
  └── Sessões Semestrais de Reciclagem contábil e auditoria preventiva
      (Acompanhamento continuado do CAUC e listas de verificação do TCE) [21, 26]

5. Critérios de Avaliação e Prontidão Tecnológica

A liberação das chaves e credenciais da API de Produção para o município (Fase 4) fica condicionada ao cumprimento dos seguintes critérios de prontidão pelas equipes capacitadas [20, 21]:

  1. Aprovação em Simulação Técnica (TI & Gestor de Dados): Execução com sucesso do acionamento de bloqueio e desativação lógica por meio do Protocolo de Revogação de Acesso no ambiente de Homologação [27, 32].
  2. Aprovação em Simulação Contábil (CRC & Contabilidade): Transmissão de 1 competência inteira de teste pelo validador em paralelo com diferença de batimento de saldos rigorosamente igual a R$ 0,00 (Zero Centavos) [20].
  3. Assinatura do Termo de Responsabilidade Técnica (Contador-Chefe): Atestação formal de que os motores de cálculo e apropriação do PCASP estão parametrizados em total harmonia contábil e jurídica [23, 31].
  4. Homologação do Inventário de Carga Inicial (Comissão de Inventário): Validação física e georreferenciada da planilha de carga no CTM contendo a separação obrigatória entre Terrenos e Edificações com códigos CIB-SINTER válidos [17, 20].

Ao final de cada etapa, os servidores receberão certificação técnica de habilitação operacional para o ecossistema PatriID ↔ SIAFIC, compondo a documentação de conformidade institucional que será arquivada e encaminhada anualmente ao Tribunal de Contas [9, 21].

Roteiro de Apresentação à Alta Administração

Alinhamento Estratégico, Conformidade SIAFIC e Integração PatriID

Público-Alvo: Prefeito(a), Secretário(a) de Fazenda/Finanças, Controlador(a) Interno e Procurador(a) Geral do Município.
Objetivo: Obter a aprovação política e administrativa para o início imediato da Fase 1 (Formalização Legal) e o cronograma de transição contábil-patrimonial de 12 semanas para atendimento integral ao Decreto Federal nº 10.540/2020.
Apresentador Recomendado: Contador-Chefe do Município ou Secretário de Fazenda.
Material de Apoio: Slide Deck “Governança Patrimonial SIAFIC” e “Manual Unificado de Implantação e Transição” (disponíveis no painel Estúdio).


Slide 1: Abertura e Alinhamento Político-Institucional

Fala do Apresentador (Script):

"Excelentíssimo(a) Senhor(a) Prefeito(a), Senhor Secretário de Fazenda e demais membros da mesa. Iniciamos hoje uma apresentação de extrema relevância estratégica e fiscal para o nosso município.

Estamos tratando da modernização de nossa gestão de ativos e do cumprimento de uma das mais rigorosas legislações fiscais recentes do país: o Decreto Federal nº 10.540/2020 (SIAFIC).

Esta reunião tem como objetivo apresentar o diagnóstico de conformidade do nosso patrimônio imobilizado, demonstrar como a plataforma tecnológica PatriID resolve definitivamente nossas pendências técnicas e, principalmente, formalizar a nossa cadeia de responsabilidades e governança para blindar as contas do município perante os órgãos de controle externo."

Notas para o Apresentador:


Slide 2: O Diagnóstico de Dores Patrimoniais e as Graves Sanções de Controle

Fala do Apresentador (Script):

"Até o momento, a contabilidade patrimonial nos municípios brasileiros tem sido um dos calcanhares de Aquiles nas auditorias dos Tribunais de Contas. Historicamente, os ativos municipais são mantidos por valores históricos, sem a aplicação sistemática de depreciação mensal ou de testes de impairment, o que gera distorções severas no Balanço Patrimonial [12].

A inércia na resolução desse passivo técnico não é mais uma opção tolerável. O descumprimento do Decreto do SIAFIC acarreta quatro sanções devastadoras de forma automática [11, 12, 13]: 1. No CAUC (Tesouro Nacional): O bloqueio imediato e compulsório do recebimento de transferências voluntárias e convênios federais ou estaduais, com base no Artigo 51 da LRF [12]. 2. No Tribunal de Contas (TCE): Parecer prévio contrário e rejeição de contas consolidadas do Prefeito, enquadrando o gestor na Lei da Ficha Limpa [12]. 3. No Senado Federal: Vedação imediata à contratação de empréstimos estruturantes cruciais, como operações junto ao BNDES ou FINISA [13]. 4. No Poder Judiciário: Instauração de Ação de Improbidade Administrativa pela Lei nº 8.429/1992, com responsabilização pessoal e solidária, afetando o Prefeito e o Contador-Chefe por omissão de controle patrimonial [13].

Com a implantação do plano que desenhamos, afastamos definitivamente todos esses riscos jurídicos e fiscais."

Notas para o Apresentador:


Slide 3: O Novo Marco Legal do SIAFIC (Decreto nº 10.540/2020)

Fala do Apresentador (Script):

"O Decreto Federal nº 10.540/2020 revolucionou as exigências para os softwares de administração financeira pública. A lei exige uma arquitetura de base de dados única e o registro tempestivo das mutações de forma integrada e automática [9, 10, 11].

A legislação dividiu expressamente as soluções em dois níveis de atuação [10, 11]: * O Sistema Estruturante (SIAFIC): O núcleo contábil do município, responsável pela execução orçamentária geral e pela emissão direta da Matriz de Saldos Contábeis (MSC) para o SICONFI [10]. * Os Sistemas Complementares (Sistemas Auxiliares Satélites), como o PatriID: Sistemas especializados em frentes complexas — no nosso caso, Gestão Patrimonial e Imobilizado — que alimentam o sistema central [11].

O ponto crucial e mais fiscalizado é o Artigo 14, Parágrafo Único: é expressamente vedada a exportação manual de arquivos planos ou planilhas paralelas na rotina mensal de integração patrimonial [11, 28]. Toda a comunicação de lançamentos patrimoniais deve ser feita via API/Webservice automatizada, de forma tempestiva e rastreável. É exatamente esse salto de integração que estamos implementando."


Slide 4: A Plataforma PatriID como Motor de Aderência Contábil

Fala do Apresentador (Script):

"Para atender a essas exigências, nossa resposta técnica está centrada no PatriID, um sistema complementar altamente especializado cujos motores de regras cumprem integralmente as exigências do MCASP 11ª Edição e da NBC TSP 07 [8, 14].

A plataforma traz quatro diferenciais normativos cruciais: 1. Motor de Depreciação Automatizado: Calcula o desgaste sob o critério pró-rata die individualizado por bem e aplica de forma estrita o arredondamento bancário (Banker's Rounding), neutralizando qualquer viés estatístico em lotes de alto volume [14]. 2. Tecnologia CATMAT-AI: Inteligência artificial com leitura semântica que classifica os materiais adquiridos na origem, separando itens de consumo de bens permanentes e sugerindo as contas do PCASP corretas [15]. 3. Triagem Inteligente de Obras (VPD × Capitalização): Bloqueia lançamentos indevidos, distinguindo automaticamente pequenos gastos de conservação (lançados como despesas em VPD) de reformas de melhoria estrutural (que aumentam a vida útil do bem e devem ser capitalizadas ao imobilizado) [15]. 4. Trilha de Auditoria Imutável (Art. 8º do Decreto): Gravação permanente no banco de dados na estrutura append-only (bloqueando comandos UPDATE ou DELETE ordinários) e estruturada em JSONB (registrando o valor anterior e o novo), além de disparo de alertas de controle por e-mail [16, 37]."


Slide 5: Destaque Técnico: CTM, SINTER e Ativos Imobiliários

Fala do Apresentador (Script):

"Outro grande avanço deste projeto é a integração inédita do Cadastro Territorial Multifinalitário (CTM) com as contas contábeis do grupo 1.2.3.x do PCASP (Ativo Imobilizado) [17].

Em termos práticos: não teremos apenas valores abstratos registrados no balancete. Cada escola, cada posto de saúde e cada terreno público registrado em nosso balanço financeiro estará eletronicamente associado à sua poligonal física georreferenciada, com fotos de vistoria e plantas de engenharia integradas ao sistema [17].

A plataforma está 100% preparada para se comunicar com o Cadastro Imobiliário Brasileiro (CIB) e com o SINTER do Governo Federal, gerando um código de identificação nacional único para cada ativo municipal e comprovando a perfeita regularidade fundiária e contábil perante as fiscalizações externas [17]."


Slide 6: O Roadmap de Implantação de 12 Semanas

Fala do Apresentador (Script):

"Como realizaremos essa transição com segurança e sem interromper as rotinas diárias da prefeitura? Desenvolvemos um Roadmap Estratégico dividido em 4 fases consecutivas ao longo de 12 semanas [18]:


Slide 7: Cadeia de Governança, Atribuições e Próximos Passos

Fala do Apresentador (Script):

"Para garantir o sucesso fiduciário e operacional, cada ator possui papel e responsabilidade definidos neste programa de conformidade [8, 19]: * Prefeito(a): Cabe assinar e publicar em Diário Oficial o Decreto de Classificação do PatriID como Sistema Complementar (nosso Modelo 1) [19, 28]. * Secretário(a) de Fazenda: Cabe assinar a portaria de nomeação do Gestor de Dados SIAFIC (Modelo 2) e o Termo de Autorização de Acesso de Rede (Modelo 4) [19, 29, 30]. * Contador-Chefe: Cabe chancelar tecnicamente o plano de contas e os motores contábeis assinando o Termo de Responsabilidade Contábil com CRC ativo (Modelo 5) [19, 31]. * Gestor(a) de Dados SIAFIC (Servidor Efetivo): Fica responsável pela custódia técnica diária de tokens em cofre de segredos, validação das transmissões da API e imediata execução do protocolo de segurança em casos de vacância [29, 32].

Próximos passos imediatos: Propomos à mesa a deliberação e aprovação conjunta para a assinatura digital imediata dos atos administrativos da Fase 1 (Decreto, Portaria e Termos autorizativos), cujo material legal de suporte já está totalmente redigido e pronto em nosso dossiê técnico.

Agradeço a atenção de todos e abro a palavra para perguntas e deliberação das assinaturas."


Recomendações Finais ao Apresentador para a Reunião:

  1. Destaque a Prontidão do Município: Reforce que todos os anexos jurídicos e de testes já foram desenvolvidos e estão prontos no painel Estúdio, demonstrando aos gestores políticos que o município está totalmente amparado juridicamente.
  2. Use a Planilha de Depreciação como Prova Técnica: Se houver dúvidas da Controladoria ou Fazenda sobre a exatidão dos cálculos contábeis, cite o arquivo memoria-calculo-depreciacao-bankers.xlsx, comprovando que a prefeitura possui a simulação analítica individualizada por ativo em conformidade total com o TCE.
  3. Mantenha o Foco na Prevenção de Bloqueios: Sempre que questionado sobre custos ou esforços de inventário, lembre à mesa que o custo da inércia (perda de transferências voluntárias do CAUC) é infinitamente superior ao investimento de saneamento e integração.

Parte VII — Modelos de Atos Administrativos

Modelo 1 — Decreto de Classificação do Sistema Complementar

DECRETO Nº [NÚMERO DO DECRETO], DE [DIA] DE [MÊS] DE 20[XX]

Classifica o Sistema de Gestão Patrimonial PatriID como Sistema Complementar ao Sistema Informatizado de Administração Financeira do Município (SIAFIC), nos termos do Decreto Federal nº 10.540, de 16 de outubro de 2020, e dá outras providências.

O(A) PREFEITO(A) MUNICIPAL DE [NOME DO MUNICÍPIO], no uso das atribuições que lhe conferem a Lei Orgânica do Município, e com fundamento no Decreto Federal nº 10.540, de 16 de outubro de 2020, que institui o Sistema de Informações Contábeis e Fiscais do Setor Público Brasileiro (SIAFIC),


DECRETA:

Art. 1º Fica classificado como Sistema Complementar ao Sistema Estruturante de Administração Financeira Municipal (SIAFIC), nos termos do art. 14 do Decreto Federal nº 10.540/2020, o sistema denominado PatriID, de titularidade/fornecimento da CC Patrimonial, responsável pelos seguintes módulos técnicos: * I - Gestão e controle do Ativo Imobilizado (Patrimônio Público); * II - Cadastro Territorial Multifinalitário (CTM); * III - Portal de Transparência Municipal.

Art. 2º O Sistema Complementar a que se refere o art. 1º deverá gerar, de forma integrada, tempestiva e automática, as informações necessárias para a contabilização dos atos e fatos de gestão no Sistema Estruturante, conforme exigido pelo parágrafo único do art. 14 do Decreto Federal nº 10.540/2020.

Art. 3º A integração entre o Sistema Complementar (PatriID) e o Sistema Estruturante (SIAFIC) dar-se-á exclusivamente por meio de API/Webservice, sendo expressamente vedada a transferência manual de arquivos de dados como procedimento ordinário de integração, assegurando a unicidade de base de dados prevista no art. 5º do Decreto Federal nº 10.540/2020.

Art. 4º Fica designado(a) o(a) servidor(a) [NOME DO SERVIDOR], matrícula nº [MATRÍCULA], ocupante do cargo de [CARGO], como Gestor de Dados responsável pela supervisão técnica da integração, sem prejuízo das atribuições legais do(a) Contador(a)-Chefe do Município.

Art. 5º A política contábil adotada para mensuracao subsequente do Ativo Imobilizado será o Modelo do Custo (custo histórico deduzido de depreciação e perdas por impairment), nos termos da NBC TSP 07 (Ativo Imobilizado) e do Manual de Contabilidade Aplicada ao Setor Público (MCASP 11ª Edição), salvo ato complementar que institua o Modelo de Reavaliação para classes específicas de bens.

Art. 6º Este Decreto entra em vigor na data de sua publicação.

[CIDADE], [DIA] de [MÊS] de 20[XX].



[NOME COMPLETO DO PREFEITO(A)] Prefeito(a) Municipal de [Nome do Município]

Modelo 2 — Portaria de Nomeação do Gestor de Dados

Esta Portaria formaliza a designação do servidor responsável pela supervisão técnica e controle das credenciais da API de integração entre o sistema de patrimônio (Sistema Complementar) e o SIAFIC (Sistema Estruturante), em total conformidade com o Decreto Federal nº 10.540/2020.


PORTARIA Nº __ / 20__ — SECRETARIA DE FAZENDA

Designa o(a) Gestor(a) de Dados responsável pela supervisão técnica da integração entre os sistemas complementares de gestão patrimonial e o Sistema Estruturante (SIAFIC) do Município, e dá outras providências.

O(A) SECRETÁRIO(A) MUNICIPAL DE FAZENDA / FINANÇAS DE [NOME DO MUNICÍPIO], no uso das atribuições que lhe são delegadas pelo Decreto Municipal nº __ de __/_/20_, e com fundamento no Decreto Federal nº 10.540, de 16 de outubro de 2020,

RESOLVE:

Art. 1º Nomear o(a) servidor(a) [NOME COMPLETO], inscrito(a) no CPF sob o nº ..-*, portador(a) da matrícula nº [MATRÍCULA], ocupante do cargo efetivo ou função de [CARGO/FUNÇÃO], como Gestor(a) de Dados responsável pela supervisão técnica da integração do Sistema Complementar de Gestão Patrimonial (PatriID) ao Sistema Estruturante Municipal (SIAFIC**), nos termos do Art. 14 do Decreto Federal nº 10.540/2020.

Art. 2º Caberá ao(à) Gestor(a) de Dados nomeado(a) o exercício das seguintes atribuições técnicas e administrativas: 1. Controle de Credenciais: Solicitar, gerenciar, monitorar e, quando necessário, revogar as credenciais e chaves de acesso (API Keys / Tokens de autenticação) de gravação (POST/PUT) e leitura (GET) da API do Sistema Estruturante; 2. Tempestividade: Supervisionar a consistência e a tempestividade diária dos lançamentos contábeis automáticos gerados pelo sistema complementar (PatriID), garantindo que os fatos patrimoniais reflitam na contabilidade no mesmo dia da ocorrência do evento administrativo; 3. Comunicação de Falhas: Reportar de forma imediata ao Contador-Chefe do Município e ao fornecedor do Sistema Estruturante qualquer falha ou interrupção na fila de transmissão assíncrona das mensagens contábeis; 4. Trilha de Auditoria: Guardar, auditar e fiscalizar a imutabilidade do registro de auditoria (Audit Trail) de todas as operações realizadas pelo Sistema Complementar, assegurando a rastreabilidade absoluta de quem alterou o dado, o timestamp preciso, o valor anterior e o valor novo das contas de saldos.

Art. 3º Em caso de vacância, exoneração, licença ou afastamento das funções, o(a) Gestor(a) de Dados deverá providenciar de forma imediata a invalidação de suas chaves e tokens de acesso técnico junto ao Sistema Estruturante, lavrando o respectivo Protocolo de Revogação de Acesso e comunicando oficialmente a Secretaria de Fazenda.

Art. 4º Esta Portaria entra em vigor na data de sua publicação no Diário Oficial do Município.

[CIDADE] - [UF], _ de ___ de 20____.



[NOME COMPLETO DO(A) SECRETÁRIO(A)] Secretário(a) Municipal de Fazenda / Finanças Município de [NOME DO MUNICÍPIO]


Instruções para Preenchimento e Homologação:

  1. Publicação Oficial: Este ato administrativo deve ser publicado na íntegra no Diário Oficial Eletrônico do Município para possuir eficácia legal.
  2. Atribuição das Chaves: Após a publicação, o Gestor de Dados nomeado deve utilizar esta portaria como documento de instrução para o preenchimento do Requerimento de Integração ao Sistema Estruturante junto ao fornecedor do SIAFIC.
  3. Responsabilidade Técnica: Este documento atua em conjunto com o Termo de Responsabilidade Técnica Contábil a ser assinado pelo Contador-Chefe do município (CRC ativo), assegurando o respaldo da gestão fiscal perante os auditores do Tribunal de Contas.

Modelo 3/4 — Termo de Autorização de Acesso à API

Integração via API — Sistema Complementar ao Sistema Estruturante Municipal

Pelo presente instrumento, a PREFEITURA MUNICIPAL DE [NOME DO MUNICÍPIO]/[UF], por meio da SECRETARIA MUNICIPAL DE FAZENDA, inscrita no CNPJ sob o nº [CNPJ DA PREFEITURA], neste ato representada pelo(a) Secretário(a) de Fazenda, [NOME DO(A) SECRETÁRIO(A)], inscrito(a) no CPF sob o nº [CPF DO SECRETÁRIO], no uso de suas atribuições legais e em conformidade com as exigências estabelecidas pelo Decreto Federal nº 10.540, de 16 de outubro de 2020 (SIAFIC), em especial o seu Artigo 14, parágrafo único:

AUTORIZA a liberação de credenciais técnicas de integração e acesso ao Sistema Estruturante Municipal para o Sistema Complementar de Gestão Patrimonial e Territorial conforme as condições e diretrizes estabelecidas abaixo:


1. Condições Gerais de Autorização

Condição Descrição Técnica e Operacional
Sistema Autorizado PatriID (CC Patrimonial)
Fornecedor/Titular [NOME DA EMPRESA FORNECEDORA] — CNPJ: [CNPJ DA EMPRESA]
Tipo de Acesso [X] Leitura (GET)
[X] Escrita (POST/PUT/PATCH)
Módulos Autorizados [X] Patrimônio (Ativo Imobilizado)
[X] CTM (Cadastro Territorial Multifinalitário)
[ ] Transparência (Módulo de Consulta)
Ambiente de Rede [X] Homologação (Testes Iniciais Obrigatórios)
[ ] Produção (Ativação após validação técnica)
Prazo de Vigência De [DD/MM/AAAA] até [DD/MM/AAAA] (renovável automaticamente mediante termo aditivo ou manutenção do contrato administrativo)
IP(s) Autorizado(s) Servidores do PatriID: [IP_ORIGEM_1] / [IP_ORIGEM_2] (O tráfego de gravação de outros IPs não listados nesta whitelist será bloqueado automaticamente)
Responsável pela Credencial [NOME DO GESTOR DE DADOS], CPF nº [CPF DO GESTOR], nomeado conforme Portaria nº [Nº DA PORTARIA]

2. Obrigações e Compromissos da Unidade Autorizada

O representante técnico e os operadores do Sistema Complementar autorizado (PatriID) comprometem-se expressamente a:

  1. Finalidade Restrita: Utilizar as credenciais e chaves de acesso (tokens, Client ID e Client Secret) exclusivamente para as rotinas e finalidades operacionais especificadas neste Termo, sendo vedado qualquer outro tipo de consulta ou manipulação de tabelas do banco de dados do Sistema Estruturante.
  2. Confidencialidade e Guarda: Não compartilhar chaves de API, senhas ou tokens com terceiros não homologados, devendo mantê-los sob custódia segura utilizando soluções de armazenamento criptografado (Cofre de Segredos).
  3. Notificação de Incidentes: Comunicar imediatamente à equipe de TI do município e ao Gestor de Dados do SIAFIC qualquer suspeita de vazamento, comprometimento de segurança ou uso não autorizado das credenciais.
  4. Respeito ao PCASP: Garantir que todos os lançamentos contábeis gerados e transmitidos (de depreciação, incorporação, baixa e melhorias) utilizem contas analíticas ativas e válidas para o exercício fiscal vigente no Plano de Contas Aplicado ao Setor Público (PCASP).
  5. Trilha de Auditoria Imutável: Manter ativo no Sistema Complementar o registro imutável de log de todas as operações de alteração patrimonial contábil (Audit Trail), preservando informações de usuário, timestamp de rede, endereço IP e dados alterados (valor anterior e novo em formato JSONB).
  6. Segurança Digital: Trafegar informações estritamente por conexões seguras sob o protocolo HTTPS com validação de certificados SSL correspondentes.

3. Condições e Gatilhos para Revogação do Acesso

Esta autorização técnica de integração e suas respectivas credenciais serão suspensas ou revogadas sumariamente pelo município, sem prejuízo das sanções administrativas cabíveis, nos seguintes cenários:


Por estar de pleno acordo com as regras de governança de tecnologia e de contabilidade patrimonial aplicadas à administração financeira pública do município, assina o presente Termo.

[CIDADE] - [UF], [DD] de [MÊS] de 2026.


[NOME DO(A) SECRETÁRIO(A) DE FAZENDA] Secretário(a) Municipal de Fazenda / Finanças M.B. [MATRÍCULA DO SECRETÁRIO]


Ciente Técnico e Recebimento:


[NOME DO GESTOR DE DADOS SIAFIC] Gestor(a) de Dados Nomeado — Portaria nº [Nº DA PORTARIA] CPF: [CPF DO GESTOR]

Modelo 5 — Termo de Responsabilidade Técnica do Contador

Nos termos da NBC TSP 07, MCASP 11ª Edição e Decreto Federal nº 10.540/2020 (SIAFIC)

Este documento formaliza que o(a) Contador(a)-Chefe do Município homologou tecnicamente os parâmetros e rotinas de cálculo do PatriID (Sistema Complementar), atestando sua conformidade com as normas brasileiras de contabilidade aplicadas ao setor público e assumindo responsabilidade solidária pela integridade dos saldos contábeis gerados e transmitidos.


DADOS DE IDENTIFICAÇÃO


DECLARAÇÕES DE HOMOLOGAÇÃO TÉCNICA

Eu, [NOME DO(A) CONTADOR(A)], inscrito(a) no CRC sob o nº [NÚMERO DO CRC], Contador(a)-Chefe responsável pelo município de [NOME DO MUNICÍPIO] / [UF], declaro para todos os fins de direito e para fins de fiscalização pelo Tribunal de Contas que:

  1. Validação do Mapeamento do PCASP: Analisei e homologuei integralmente o mapeamento de contas contábeis do Plano de Contas Aplicado ao Setor Público (PCASP) utilizado pelo PatriID, confirmando de forma irrestrita a utilização exclusiva de contas contábeis analíticas, ativas e válidas para o exercício vigente, com bloqueio automático de lançamentos em contas sintéticas ou extintas.
  2. Homologação do Motor de Depreciação (NBC TSP 07): Verifiquei e validei as fórmulas e rotinas de cálculo do motor de depreciação acumulada do sistema complementar, atestando que o PatriID aplica com exatidão o Modelo do Custo (custo histórico deduzido de depreciação e impairment acumulados) e calcula a depreciação mensal de forma tempestiva, utilizando o método de:
  3. [X] Quotas Constantes (Linha Reta - Pró-rata die com arredondamento Banker's Rounding)
  4. [ ] Unidades Produzidas
  5. [ ] Soma dos Dígitos dos Anos
  6. Segregação Contábil Estrita (VPD × Capitalização): Atesto a adequação técnica do assistente inteligente do PatriID na distinção entre gastos de simples conservação e manutenção imediata (lançados integralmente como Variação Patrimonial Diminutiva - VPD, Classe 3.6 do PCASP) e gastos com melhorias e reformas que aumentam a vida útil ou capacidade produtiva do bem (capitalizados ao Ativo Imobilizado, Classe 1.2.3 do PCASP), em estrita conformidade com as regras da Parte II do Manual de Contabilidade Aplicada ao Setor Público (MCASP).
  7. Garantia de Imutabilidade da Trilha de Auditoria (Art. 8º): Confirmei que o PatriID mantém uma trilha de auditoria (Audit Trail) imutável e inalterável no banco de dados, protegida contra deleções ou alterações de registros, que registra de forma indubitável para cada alteração de saldo patrimonial ou contábil:
  8. Usuário responsável pelo lançamento;
  9. Registro exato de data e hora (timestamp do servidor);
  10. Endereço IP e agente de usuário (user-agent);
  11. Detalhamento dos dados em formato estruturado contendo o valor anterior e o valor novo (JSONB).
  12. Responsabilidade Técnica Solidária: Assumo plena responsabilidade técnica solidária pela exatidão e fidedignidade das informações patrimoniais geradas pelo PatriID e transmitidas automaticamente ao SIAFIC municipal (Sistema Estruturante), sob as cominações da Lei nº 8.429/1992 (Improbidade Administrativa) e das normas vigentes do Conselho Federal de Contabilidade (CFC).

ENCERRAMENTO E ASSINATURA

[NOME DA CIDADE], [DIA] de [MÊS] de 20[XX].


[NOME COMPLETO DO(A) CONTADOR(A)-CHEFE] Contador(a)-Chefe do Município — CRC-[UF] nº [NÚMERO] CPF: [000.000.000-00]

Modelo 6 — Protocolo de Revogação de Acesso

Integração de Sistemas Complementares ao Sistema Estruturante Fundamentação Legal: Decreto Federal nº 10.540/2020 (SIAFIC) e Portaria de Nomeação do Gestor de Dados


FINALIDADE

Este protocolo formaliza a revogação imediata de credenciais, tokens e acessos concedidos ao Sistema Complementar (PatriID) para comunicação via API com o SIAFIC (Sistema Estruturante). Este ato deve ser obrigatoriamente lavrado no exato momento de ocorrência de exoneração, afastamento de servidor autorizado, rescisão de contrato com o fornecedor do sistema complementar, ou detecção de qualquer incidente de segurança ou uso indevido das credenciais.


1. DADOS DE IDENTIFICAÇÃO E TIMING

Campo Preenchimento
Data da Revogação [       ] / [       ] / 20[     ]
Horário Exato da Revogação [       ] : [       ] horas (Horário de Brasília)
Município / UF [                                         ] / [     ]
Secretaria Solicitante Secretaria Municipal de Fazenda / Finanças
Sistema Complementar PatriID / CC Patrimonial

2. IDENTIFICAÇÃO DOS ACESSOS E CREDENCIAIS REVOGADAS

Elemento de Integração Identificação / Descrição Técnico-Operacional
Chave de API / ID do Token [Inserir ID único do Token ou Identificador da Credencial a ser revogada]
Ambiente de Acesso [   ] Homologação           [   ] Produção
IP(s) Removido(s) da Whitelist Server IP 1: [ &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; ]
Server IP 2: [ &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; . &nbsp; &nbsp; &nbsp; ]
Escopo de Escrita Suspenso [   ] Módulo de Patrimônio     [   ] Módulo de Cadastro Territorial (CTM)

3. MOTIVAÇÃO FORMAL DA REVOGAÇÃO

Assinale com [ X ] o motivo que ensejou o encerramento do acesso à API:


4. RESPONSÁVEIS E NOVO DIRECIONAMENTO (SE HOUVER)


5. DECLARAÇÃO DE EFETIVIDADE DA BAIXA

Declaro, para todos os fins de direito e de conformidade com o Decreto Federal nº 10.540/2020, que as chaves de API, credenciais lógicas e privilégios de gravação/leitura associados ao Sistema Complementar identificado acima foram completamente revogados, invalidados e retirados da whitelist de rede no exato momento indicado na Seção 1 deste instrumento.

O Sistema Complementar supramencionado não detém mais qualquer permissão ativa de comunicação ou escrita de eventos contábeis e patrimoniais no banco de dados único do SIAFIC, ficando a transmissão de novos lotes bloqueada até a expedição de um novo Termo de Autorização de Acesso pelo Secretário de Fazenda.


6. CIÊNCIA, HOMOLOGAÇÃO E ASSINATURAS

[CIDADE], _ de __ de 20. Hora: _: h




[NOME COMPLETO DO GESTOR DE DADOS] Gestor(a) de Dados SIAFIC (Responsável pela baixa lógica das credenciais)




[NOME COMPLETO DO SECRETÁRIO DE FAZENDA] Secretário(a) Municipal de Fazenda / Finanças



TERMO DE CIÊNCIA CONTÁBIL: Atesto que fui devidamente notificado(a) da revogação das credenciais acima indicadas, restando suspensa a recepção de lançamentos automáticos até a emissão de nova chave segura.


[NOME COMPLETO DO CONTADOR-CHEFE] Contador(a)-Chefe do Município (CRC Ativo)


Parte VIII — FAQ SIAFIC

O material constitui um manual de governança administrativa, técnica e contábil voltado à adaptação dos municípios brasileiros às exigências do Decreto Federal nº 10.540/2020. O texto detalha a transição para o SIAFIC, estabelecendo o sistema PatriID como uma ferramenta complementar que deve integrar-se de forma automática e integrada via API, proibindo expressamente o tráfego manual de dados para assegurar a integridade da base contábil única. Através de modelos de decretos, portarias e termos de responsabilidade, o guia define figuras centrais como o Gestor de Dados, responsável pela custódia de chaves criptográficas, e reforça o papel do Contador-Chefe na validação de cálculos como a depreciação sistemática. O propósito final é blindar a gestão pública contra sanções graves, incluindo o bloqueio de transferências no CAUC, a rejeição de contas pelos Tribunais de Contas e possíveis ações de improbidade administrativa decorrentes de omissões no controle patrimonial.

Diretrizes e Termo de Autorização de Acesso à API SIAFIC

O Modelo 4: Termo de Autorização de Acesso à API é o documento de governança administrativa e técnica emitido pela Secretaria de Fazenda do município

. Ele é destinado diretamente ao fornecedor do Sistema Estruturante (SIAFIC) para autorizar formalmente a liberação de credenciais de integração ao PatriID (Sistema Complementar)

Este documento funciona como um contrato de controle de tráfego de rede, limitando o escopo de atuação do sistema complementar para assegurar a inviolabilidade e a integridade da base de dados contábil única exigida pelo Decreto nº 10.540/2020

Abaixo está o detalhamento técnico das cláusulas de segurança estruturadas no termo, seguido pelo modelo pronto para preenchimento oficial (o qual já está disponível em formato editável no seu painel Estúdio com o nome termo-autorizacao-acesso.md):

🔍 Detalhamento das Cláusulas do Modelo 4

O termo foi projetado sob rígidos critérios de controle de segurança e integridade de sistemas governamentais

:

  1. Sistema Integrado Autorizado (Item 1): Identifica o PatriID de forma expressa como o único sistema complementar de gestão patrimonial licenciado e autorizado a conectar-se ao SIAFIC municipal
  2. Escopo do Acesso (Item 2): Limita os privilégios técnicos de comunicação
  3. . O sistema recebe permissões estritas para Escrita de Lançamentos Contábeis (POST/PUT) e Leitura de Tabelas de Apoio (GET)
  4. . Essa limitação é crucial para impedir que um sistema complementar altere dados fiscais gerais ou execute comandos de exclusão na base de dados única.
  5. Módulos de Integração Liberados (Item 3): Limita o canal de integração às rotinas de Ativo Imobilizado (Patrimônio) e Cadastro Territorial Multifinalitário (CTM)
  6. , vinculando as bases físicas às contas do grupo 1.2.3.x do PCASP
  7. Ambiente de Conexão (Item 4): Estabelece a obrigatoriedade de iniciar o fluxo de transmissão de dados pelo Ambiente de Homologação (Testes)
  8. . Isso mitiga o risco de lançamentos contábeis errôneos atingirem a produção real do município
  9. Coordenação de Rede (Item 5): Determina que o tráfego eletrônico ocorra exclusivamente sob protocolo criptografado HTTPS e com controle restrito aos endereços de IP dos servidores cadastrados previamente na Whitelist de segurança
  10. Responsável Técnico pelo Token (Item 6): Define que a custódia das chaves e do token de acesso pertence exclusivamente ao Gestor de Dados SIAFIC (servidor público efetivo nomeado em portaria municipal)
  11. , nacionalizando o controle de acesso de rede
  12. Revogação Automática (Item 7): Define quatro gatilhos de segurança que causam o bloqueio e a invalidação sumária do termo e das credenciais de acesso
  13. :
  14. Exoneração ou afastamento do Gestor de Dados responsável
  15. ;
  16. Desvio de finalidade das chaves
  17. ;
  18. Sucessão de lançamentos inválidos ou inconsistentes por falha técnica sistêmica
  19. ;
  20. Determinação fundamentada do Contador-Chefe ou de auditores do Tribunal de Contas (TCE)

📝 Modelo 4: Estrutura Literal do Termo de Autorização

TERMO DE AUTORIZAÇÃO DE ACESSO À API — SISTEMA ESTRUTURANTE [NOME DO SIAFIC]

Autorização formal de lavratura técnica emitida pela Secretaria de Fazenda para liberação técnica de credenciais ao PatriID.

A PREFEITURA MUNICIPAL, através da SECRETARIA DE FAZENDA, representada neste ato por [NOME DO SECRETÁRIO], CPF nº [CPF], AUTORIZA o fornecedor do Sistema Estruturante municipal a liberar chaves de conexão de API para o PatriID nas condições abaixo delineadas:

1. SISTEMA INTEGRADO AUTORIZADO: PatriID (Sistema Complementar de Gestão Patrimonial).
2. ESCOPO DO ACESSO: Escrita de Lançamentos Contábeis (POST/PUT) e Leitura de Tabelas de Apoio (GET).
3. MÓDULOS DE INTEGRAÇÃO LIBERADOS: Ativo Imobilizado (Patrimônio) e Cadastro Territorial Multifinalitário (CTM).
4. AMBIENTE DE CONEXÃO: Início obrigatório em ambiente de Homologação (Testes).
5. COORDENAÇÃO DE REDE: Tráfego exclusivo sob HTTPS e restrição estrita a IPs de servidores cadastrados na Whitelist: [IP DO SERVIDOR].
6. RESPONSÁVEL TÉCNICO PELO TOKEN: Gestor(a) de Dados SIAFIC nomeado(a) por portaria: [NOME DO GESTOR], CPF: [CPF].
7. REVOGAÇÃO AUTOMÁTICA: Este Termo será revogado sumariamente por: (i) exoneração ou afastamento do responsável técnico; (ii) desvio de finalidade das credenciais de acesso; (iii) ocorrência de lançamentos contábeis sucessivos inválidos por falha sistêmica não tratada; (iv) ordem fundamentada do Contador-Chefe ou do Tribunal de Contas.

[Município]/[UF], [Dia] de [Mês] de [Ano].

____________________________________________
[NOME COMPLETO DO SECRETÁRIO] - Secretário(a) de Fazenda


🔑 Se a sua equipe de infraestrutura de TI já estiver planejando os acessos de rede, nós podemos detalhar o Protocolo de Revogação Imediata de Credenciais (Modelo 6), que estabelece o procedimento padrão de fechamento de portas de rede em caso de desligamento de servidores ou incidentes de segurança.

Portaria de Nomeação do Gestor de Dados SIAFIC

O Modelo 2: Portaria de Nomeação do Gestor de Dados é o instrumento de governança administrativa de competência do Secretário Municipal de Fazenda ou Finanças, fundamentado no Decreto Federal nº 10.540/2020, que nomeia formalmente um servidor público efetivo para custodiar a segurança de rede e das chaves de acesso à API

Abaixo está a estrutura literal detalhada do modelo para preenchimento e publicação oficial

:

MODELO 2: PORTARIA DE NOMEAÇÃO DO GESTOR DE DADOS

PORTARIA PORTARIA Nº

N

U

ˊ

MERODAPORTARIA

/

ANO

— SECRETARIA DE FAZENDA / FINANÇAS

Designa formalmente o servidor responsável pelo controle de credenciais e supervisão da API de integração contábil

. O(A) SECRETÁRIO(A) MUNICIPAL DE FAZENDA/FINANÇAS, no uso de suas atribuições delegadas e com fundamento no Decreto Federal nº 10.540/2020:

RESOLVE:

Munic

ı

ˊ

pio

/

UF

,

Dia

de

M

e

^

s

de

Ano


**

NOMECOMPLETODOSECRET

A

ˊ

RIO

**Secretário(a) de Fazenda


🎯 Atribuições Críticas e Governança de TI

A portaria impõe ao servidor designado responsabilidades rigorosas de segurança de rede

:


🔐 Posso apresentar o modelo do Termo de Autorização de Acesso (Modelo 4), emitido pela Fazenda para autorizar formalmente a liberação das chaves técnicas de API junto ao fornecedor do SIAFIC?

Diretrizes e Atribuições do Gestor de Dados SIAFIC

O Gestor de Dados SIAFIC é um servidor público efetivo designado formalmente por portaria para atuar na governança e segurança das integrações tecnológicas do município

. Sua principal responsabilidade é a supervisão técnica e o controle das credenciais da API de integração contábil entre o sistema de patrimônio complementar (PatriID) e o sistema estruturante (SIAFIC)

De acordo com as diretrizes do manual de transição, as atribuições específicas do cargo são:

Essa função foi desenhada para nacionalizar o controle e impedir a manipulação ou exportação manual de arquivos, assegurando a integridade e a conformidade fiduciária exigidas pelo Artigo 8º do Decreto Federal nº 10.540/2020


🔐 Se desejar, posso detalhar o modelo completo da Portaria de Nomeação do Gestor de Dados (Modelo 2) ou o Protocolo de Revogação Imediata de Credenciais (Modelo 6) para apoiar a equipe de TI na implantação desses mecanismos de segurança de rede.

SIAFIC: Conformidade e Penalidades no CAUC

Em caso de inércia ou descumprimento das exigências de integração do SIAFIC, o CAUC (STN) aplica ao município a sanção de bloqueio imediato de transferências voluntárias

Com fundamentação legal no Artigo 51 da Lei de Responsabilidade Fiscal (LRF), os impactos práticos dessa sanção para o ente municipal são

:

A regularização e a automação dos registros contábeis-patrimoniais são, portanto, requisitos fundamentais para que o município mantenha a adimplência no CAUC e continue capturando repasses e recursos financeiros essenciais


📋 Se desejar, podemos revisar o Checklist de Conformidade do Tribunal de Contas para detalhar quais medidas preventivas garantem que o CAUC do município permaneça totalmente adimplente.

Riscos e Sanções pela Inconformidade com o Decreto 10.540/2020

A inércia operacional do município em se adequar às exigências do Decreto Federal nº 10.540/2020 — caracterizada principalmente pela manutenção de rotinas manuais de transferência de dados (como o envio de planilhas de fechamento) ou pela falta de depreciação mensal sistemática dos ativos — gera graves prejuízos fiscais, administrativos e jurídicos de natureza imediata

As principais sanções e riscos de inércia mapeados para o município são divididos em quatro esferas de controle:


📋 Gostaria de revisar o Checklist de Conformidade do Tribunal de Contas (Modelo 7) para avaliar quais desses itens de segurança já estão plenamente atendidos pela plataforma do PatriID?

Responsabilidade e Sanções do Contador-Chefe na Gestão Patrimonial

O Contador-Chefe, na qualidade de responsável técnico pela contabilidade do município, assume responsabilidade profissional direta e solidária pelos atos contábeis gerados de forma automatizada pelo sistema complementar e apropriados no balanço municipal

Se houver omissão de controle patrimonial — caracterizada, por exemplo, pela persistência na transferência manual de arquivos e planilhas eletrônicas de fechamento ou pela ausência de depreciação mensal sistemática

—, o Contador-Chefe fica sujeito a graves sanções e consequências pessoais e profissionais

:


📝 Gostaria de analisar em detalhes as obrigações e declarações contidas no Termo de Responsabilidade Técnica Contábil (Modelo 5) que o Contador-Chefe deve assinar eletronicamente para validar os motores de cálculo do PatriID?

Decreto de Classificação para Integração ao SIAFIC

O modelo de Decreto de Classificação da Fase 1 (também disponível em seus arquivos como decreto-classificacao-patriid.md) é a peça jurídica fundamental para dar o pontapé inicial na conformidade com o Decreto Federal nº 10.540/2020

. Ele tem o objetivo de formalizar a arquitetura de integração sistêmica e blindar o município contra sanções de controle de forma imediata

Abaixo está o modelo completo e pronto para ser preenchido, publicado no Diário Oficial e assinado eletronicamente

:

MODELO 1: DECRETO MUNICIPAL DE CLASSIFICAÇÃO

DECRETO Nº

N

U

ˊ

MERODODECRETO

, DE

DIA

DE

M

E

^

S

DE

ANO

Classifica o Ativo Imobiliário e o Cadastro Territorial como Sistema Complementar ao Sistema Informatizado de Administração Financeira do Município, nos termos do Decreto Federal nº 10.540, de 16 de outubro de 2020, e dá outras providências

. O(A) PREFEITO(A) MUNICIPAL, no uso das atribuições que lhe conferem a Lei Orgânica Municipal, e com fundamento no Decreto Federal nº 10.540/2020

:

DECRETA:

Munic

ı

ˊ

pio

/

UF

,

Dia

de

M

e

^

s

de

Ano


NOMEDOPREFEITO(A)


💡 Por que este modelo está estruturado dessa forma?

Este decreto foi desenhado para resolver quatro exigências centrais de auditoria contábil e de controle

:

  1. Definição das Fronteiras Sistêmicas (Arts. 1º e 2º): Esclarece legalmente que o sistema de patrimônio atua como Sistema Complementar (satélite), enquanto o SIAFIC funciona como o Sistema Estruturante, cumprindo formalmente o previsto no Art. 14 do Decreto 10.540/2020
  2. Fim do Tráfego Manual (Art. 3º): Proíbe expressamente a exportação manual de arquivos contábeis planos ou planilhas paralelas de fechamento mensal, forçando o tráfego eletrônico direto e seguro de dados
  3. Responsabilidade Técnica Atribuída (Art. 4º): Cria e designa formalmente o cargo de Gestor de Dados SIAFIC
  4. , servidor público encarregado de custodiar e gerenciar com segurança as chaves de rede e as credenciais das APIs de gravação
  5. Uniformidade na Política de Mensuração (Art. 5º): Declara formalmente que a prefeitura utiliza o Modelo do Custo (e não reavaliação periódica pura), legitimando o motor contábil que aplica a depreciação sistemática mensal pró-rata die com arredondamento bancário (Banker's Rounding)

Isso confere consistência fiduciária à Fase 1, permitindo que as fases subsequentes (inventário físico, homologação de API e operação contínua) ocorram com plena segurança jurídica


📜 Se você preferir, posso detalhar o modelo da Portaria de Nomeação do Gestor de Dados (Modelo 2) para que possamos estruturar o ato de designação do servidor que fará o controle das credenciais da API junto com o Decreto.

Riscos e Sanções na Gestão do Patrimônio Municipal

Por omitir o controle patrimonial ou descumprir as exigências de integração automática e qualidade do SIAFIC estabelecidas pelo Decreto Federal nº 10.540/2020, o Prefeito sujeita-se a graves sanções pessoais, políticas e institucionais

:


📝 Se desejar, podemos detalhar os passos práticos da Fase 1 (Formalização Legal) do cronograma de transição para que o Prefeito possa assinar e publicar o Decreto de Classificação imediatamente, iniciando a blindagem jurídica do município


Responsabilidades do Prefeito e Conformidade com o Decreto 10.540/2020

O descumprimento do Decreto Federal nº 10.540/2020 afeta diretamente a responsabilidade pessoal, política e jurídica do Prefeito, sujeitando-o a sanções graves decorrentes da inércia administrativa ou omissão de controle no município

As principais repercussões na esfera de responsabilidade do chefe do Executivo municipal incluem:


📝 Você gostaria de revisar as variáveis e lacunas a serem preenchidas no modelo de Decreto Municipal de Classificação (Modelo 1) contido no manual para dar início formal à Fase 1 de transição em seu município?

Relatório de Governança e Conformidade Contábil Municipal

O relatório de conformidade apresenta para o Prefeito e a alta administração o placar geral de conformidade, o qual aponta a existência de 9 requisitos CONFORMES, 4 requisitos PARCIAIS e 0 requisitos NÃO CONFORMES

. Adicionalmente, o relatório mapeia 3 obrigações que são de responsabilidade direta e exclusiva do Ente municipal para a sua devida formalização legal

Para respaldar a tomada de decisões da gestão e demonstrar o nível de aderência às exigências do Decreto Federal nº 10.540/2020 e das normas do Tribunal de Contas (TCE), o documento detalha os seguintes indicadores e informações:


🎨 Se você desejar, posso detalhar como cada um desses riscos mapeados no relatório é mitigado de forma prática por meio das minutas e decretos da Fase 1 de implantação.

Guia Estratégico de Governança e Transição Patrimonial Municipal

O Roteiro de Apresentação para a Alta Administração foi estruturado com rigor técnico e político, e o novo artefato roteiro-apresentacao-alta-administracao.md acaba de ser publicado em seu painel Estúdio. Este roteiro serve como o guia definitivo do apresentador (com falas recomendadas, notas operacionais, gestão de tempos e indicação de recursos visuais) para acompanhar o slide deck de governança municipal

. O conteúdo está estruturado de forma linear e objetiva para facilitar a tomada de decisão em reuniões com o(a) Prefeito(a) e o Secretário de Fazenda

:

Estrutura de Condução das Falas:

  1. Abertura Institucional: Posicionamento político-institucional e introdução do programa de integridade fiscal e transição do imobilizado.
  2. O Diagnóstico e Sanções do Controle: Explanação franca sobre os impactos imediatos da inércia administrativa, detalhando as sanções no CAUC (LRF Art. 51), rejeições de contas consolidadas no TCE, veto a empréstimos na STN/Senado e imputação pessoal por Improbidade Administrativa (Lei nº 8.429/1992)
  3. O Novo Marco do SIAFIC: Explicação sobre a arquitetura de base única do Decreto nº 10.540/2020 (Art. 14) e a proibição expressa de integrações mensais manuais por meio de envio de arquivos e planilhas paralelas
  4. O Motor Patrimonial do PatriID: Evidenciação técnica de como o sistema atende aos regramentos da NBC TSP 07 e do MCASP 11ª Edição (depreciação pró-rata die com arredondamento bancário Banker's Rounding, tipificação automática de despesas via CATMAT-AI e trilha de auditoria inviolável em formato append-only JSONB)
  5. 8−10
  6. Destaque de Georreferenciamento: Demonstração do vínculo físico-territorial inédito das contas do grupo 1.2.3.x com o Cadastro Territorial Multifinalitário (CTM) e a integração federativa de dados no SINTER do Governo Federal via Cadastro Imobiliário Brasileiro (CIB)
  7. O Roadmap das 12 Semanas: Detalhamento do cronograma estratégico de transição, dividindo as frentes de trabalho entre as fases de Formalização Legal, Inventário Físico de Campo, Homologação da API e Operação Contínua
  8. 2,12−14
  9. Cadeia de Responsabilidades e Próximos Passos: Conclusão prática definindo as atribuições técnicas de cada ator e a formalização de assinaturas dos modelos legais da Fase 1 (Decreto, Portarias e Termos) para início imediato dos trabalhos

🏁 Com todas as minutas legais, roteiros de homologação técnica de API, planilhas dinâmicas de carga física e depreciação acumulada, e o roteiro de apresentação formalizados no painel Estúdio, sua prefeitura está munida com um dossiê imbatível de governança. Deseja que eu faça mais algum ajuste antes do fechamento do seu plano de ação municipal?

Guia de Capacitação para Integração PatriID e SIAFIC

O Plano de Capacitação e Treinamento para preparar os servidores públicos municipais na operação e governança da integração PatriID ↔ SIAFIC foi totalmente estruturado. O novo artefato contendo o roteiro completo de capacitação, plano-capacitacao-treinamento-servidores.md, já está publicado e disponível em seu painel Estúdio. Este planejamento de qualificação de pessoal foi desenvolvido para capacitar cada ator da cadeia de governança municipal de forma modular e progressiva, mitigando riscos de inconformidades técnicas e contábeis perante os órgãos de controle


Resumo dos Módulos e Perfis de Treinamento Estruturados:

  1. Módulo I: Alinhamento Legal, Riscos Fiscais e Governança do SIAFIC (Para Todos)
  2. Foco: Instrução sobre a arquitetura de base única do Decreto Federal nº 10.540/2020 e a distinção entre Sistemas Estruturantes (SIAFIC) e Sistemas Complementares (PatriID)
  3. Mitigação de Riscos: Conscientização sobre a proibição de transferências manuais de dados (antigo envio de arquivos planos) e as graves consequências da inércia governamental, como o bloqueio do município no CAUC (LRF Art. 51), pareceres contrários do TCE e ações de improbidade administrativa
  4. 4−6
  5. Módulo II: Saneamento, Inventário Físico de Campo e CATMAT-AI (Para Fiscais de Patrimônio e Comissão)
  6. Foco: Operação prática do aplicativo móvel do PatriID em modo offline-first para vistoria, plaqueteamento físico e registro fotográfico dos bens permanentes
  7. Inteligência Artificial e Georreferenciamento: Treinamento no uso do CATMAT-AI para tipificação automatizada de materiais de consumo versus bens permanentes
  8. , e vinculação das edificações e terrenos às poligonais de georreferenciamento do Cadastro Territorial Multifinalitário (CTM) e base do SINTER (CIB)
  9. Módulo III: Motores de Depreciação, Fechamento Contábel e Regras do PCASP (Para a Equipe Contábil)
  10. Foco: Operação do motor de depreciação mensal sistemática do PatriID sob as regras da NBC TSP 07 e do MCASP 11ª Edição, aplicando o critério pró-rata die e arredondamento bancário (Banker's Rounding)
  11. Controle e Auditoria: Parametrização de validações de contas analíticas ativas (bloqueando contas sintéticas ou extintas)
  12. , fluxo de triagem inteligente de obras (VPD de conservação versus capitalização de melhorias)
  13. , lançamentos de Impairment (desvalorização e reversão)
  14. , baixas de inservíveis e geração automatizada de Notas Explicativas de Encerramento
  15. Módulo IV: Segurança de Rede, Controle de APIs e Gestão de Incidentes (Para Gestor de Dados e TI)
  16. Foco: Atribuições legais e operacionais do Gestor de Dados SIAFIC nomeado por portaria na guarda e proteção das chaves em cofre de segredos criptográfico
  17. Governança de Infraestrutura: Controle do tráfego sob HTTPS por IP Whitelisting
  18. , monitoramento da trilha de auditoria inviolável (Audit Trail) configurada no formato append-only em JSONB (Art. 8º)
  19. e aplicação imediata do Protocolo de Revogação de Acesso em casos de desligamentos ou vacância

Critérios para Homologação de Prontidão Operacional:

O plano prevê que a liberação das credenciais de Produção para o município só ocorrerá após a aprovação das equipes em simulações práticas em ambiente de Homologação

. Isso inclui:


🎓 Com todas as etapas normativas, técnicas, contábeis e pedagógicas plenamente mapeadas e documentadas no seu painel Estúdio, o município possui o mais completo dossiê de transição para o SIAFIC do país, pronto para ser apresentado ao Prefeito e Secretário de Fazenda. Deseja que eu elabore um roteiro de apresentação resumido para ajudá-lo na reunião de aprovação final do projeto de implantação com a alta administração?

Dossiê de Conformidade e Transição Patrimonial Municipal

O Relatório Executivo de Conformidade Final foi totalmente elaborado e publicado no seu painel Estúdio sob o nome relatorio-executivo-conformidade-final.md. Este documento representa o fechamento do dossiê de transição técnica e contábil do município

. Ele foi desenhado especificamente para respaldar a atuação da prefeitura e consolidar as provas de conformidade fiduciária perante o Tribunal de Contas do Estado (TCE) e os órgãos de controle interno

O que o Relatório de Conformidade Contempla:

Com a entrega deste relatório e o manual unificado em PDF, o município possui um dossiê técnico de conformidade fiduciária robusto, de alta rastreabilidade e pronto para ser assinado eletronicamente e enviado aos auditores externos de contas


👨‍🏫 Com todo o arcabouço normativo, os planos de testes, as integrações de API e as ferramentas de controle contábil concluídos, você gostaria que eu estruturasse um Plano de Capacitação e Treinamento para os Servidores Municipais (como o Gestor de Dados, Contador-Chefe e Fiscais de Patrimônio) para que eles operem o PatriID e o validador com total autonomia no dia a dia da prefeitura?

Ata de Governança e Conciliação Patrimonial Julho 2026

A Ata de Fechamento de Conciliação Contábil-Patrimonial foi elaborada com sucesso e está disponível em seu painel Estúdio sob o nome ata-conciliacao-contabil-julho-2026.md. Este documento formaliza o encerramento da competência de julho de 2026, servindo como uma importante peça de governança e controle para o município

. A ata atesta de forma jurídica e técnica o alinhamento de saldos contábeis e as validações efetuadas entre o sistema complementar de patrimônio (PatriID) e o sistema estruturante (SIAFIC)

Principais Elementos Contemplados no Documento:


🔍 Com todos os artefatos de governança (Decreto, Portarias, Termos de Responsabilidade, Manuais, Planilhas de Memória de Cálculo e Atas de Conciliação) completamente estruturados e disponíveis no seu painel Estúdio, gostaria que eu realizasse uma varredura geral para apresentar um Relatório Executivo de Conformidade Final de Auditoria Interna antes da sua apresentação para o Secretário de Fazenda e Prefeito?

Guia de Depreciação e Memória de Cálculo Banker’s Rounding

A planilha contendo o modelo oficial de Relatório e Memória de Cálculo de Depreciação Acumulada com o método Banker's Rounding foi estruturada de forma dinâmica e publicada com sucesso! O novo arquivo memoria-calculo-depreciacao-bankers.xlsx já está disponível para visualização e download em seu painel Estúdio. O modelo foi construído de acordo com os padrões exigidos pelo Tribunal de Contas (TCE), servindo como uma trilha de auditoria transparente e fidedigna para os balanços mensais e de encerramento do exercício de 2026


Estrutura e Funcionamento do Arquivo Gerado:

1. Aba "Painel de Controle" (Painel de Fechamento)

2. Aba "Memória de Cálculo" (Trilha de Auditoria Individualizada)

=IF(ROUND(ABS(VALOR*100-TRUNC(VALOR*100)),4)=0.5, IF(MOD(TRUNC(VALOR*100),2)=0, TRUNC(VALOR*100)/100, (TRUNC(VALOR*100)+SIGN(VALOR))/100), ROUND(VALOR,2))

Isso garante o arredondamento preciso para o número par mais próximo quando a fração residual é exatamente 0.5, de acordo com as normas da Secretaria do Tesouro Nacional (STN).


Como Customizar a Planilha:


📋 Agora que temos os planos técnicos, os payloads de integração de API e a planilha de memória de cálculo da depreciação com o Banker's Rounding, gostaria de consolidar essas informações simulando uma Ata de Fechamento de Conciliação Contábil Mensal em formato Markdown para formalizar o encerramento do primeiro mês de integração automatizada perante o controle interno?

Diretrizes Técnicas para o Encerramento Patrimonial 2026

O rascunho das Notas Explicativas de Encerramento Patrimonial para o encerramento do exercício financeiro de 2026 foi elaborado com rigor técnico

e está publicado no seu painel Estúdio sob o nome notas-explicativas-patrimoniais.md. Este documento constitui uma peça contábil obrigatória exigida pelos Tribunais de Contas Estaduais (TCE) para dar transparência e fidedignidade aos saldos finais do balanço municipal

. Ele detalha de forma oficial as políticas, parâmetros e premissas técnicas de mensuração que regem o imobilizado e a integração com o SIAFIC

Principais Aspectos Evidenciados no Roteiro:

A minuta já está estruturada com colchetes de personalização para que o Contador-Chefe do município (com CRC ativo) e o Gestor de Dados do SIAFIC revisem e assinem digitalmente antes da remessa de encerramento de contas


📊 Gostaria que eu criasse um Relatório de Memória de Cálculo de Depreciação Acumulada em formato de planilha (.xlsx), contendo simulações de fórmulas para cada classe de ativos (veículos, edifícios, equipamentos) e demonstrando o arredondamento Banker's Rounding passo a passo?

Simulação de Depreciação Pró-Rata Dia no PatriID

A simulação completa do processamento automático de depreciação mensal sistemática pró-rata dia foi elaborada com precisão técnica e já está disponível em seu painel Estúdio sob o nome simulacao-depreciacao-prorata-dia.md. Este novo artefato prático demonstra a modelagem matemática e a geração de lançamentos executadas pelo motor do PatriID (Sistema Complementar) para a competência de julho de 2026, garantindo a conformidade literal com as diretrizes da NBC TSP 07 (Imobilizado) e do MCASP 11ª Edição

Principais Aspectos Contemplados na Simulação:


📊 Deseja que eu elabore um rascunho estruturado de Notas Explicativas de Encerramento Patrimonial, detalhando os métodos de mensuração, vidas úteis aplicadas e a composição da depreciação acumulada para anexar ao balanço consolidado do município conforme exige o Tribunal de Contas (TCE)?

Gestão Patrimonial e Inventário Imobiliário Georreferenciado

A planilha de inventário georreferenciado de bens imóveis para carga inicial e integração patrimonial foi totalmente elaborada e publicada com sucesso! O novo arquivo inventario-imoveis-georreferenciado.xlsx já está disponível para visualização e download no seu painel Estúdio. Este documento foi construído de forma dinâmica e estruturada com fórmulas integradas para servir como base para a homologação do Tribunal de Contas (TCE) e para a carga inicial de dados no Cadastro Territorial Multifinalitário (CTM) e SINTER

📊 Estrutura e Organização do Arquivo Gerado:

1. Aba "Resumo Executivo" (Painel de Controle)

2. Aba "Banco de Dados Imobiliários" (Tabela de Carga Inicial)


📝 Guia de Utilização do Arquivo:


🧩 Gostaria de avançar com o preenchimento ou deseja realizar uma simulação contábil em Python contendo o processamento automático da depreciação mensal sistemática pró-rata dia deste exato lote de bens imóveis, calculando o desgaste de cada edificação de forma analítica para o encerramento do exercício?

Integração de Ativos Imobiliários e Governança Georreferenciada via JSON

A simulação do payload JSON de ativação e capitalização de melhorias com vínculo territorial foi elaborada com sucesso e o novo artefato exemplo-json-melhoria-ctm.md já está publicado e disponível no seu painel Estúdio. O modelo simula a transmissão técnica via API a partir do PatriID (Sistema Complementar) para o SIAFIC (Sistema Estruturante) após a conclusão de uma obra pública

. Ele foi projetado para demonstrar de forma inequívoca aos auditores do Tribunal de Contas (TCE) como o município mantém a consistência física e geográfica dos bens imóveis

:

O arquivo publicado também fornece às suas equipes técnicas os esquemas de respostas de API (201 Created para integrações homologadas com sucesso e 422 Unprocessable Entity para bloqueios automáticos de lançamentos direcionados a contas sintéticas ou extintas)


📈 Deseja que eu elabore uma planilha no formato de planilha eletrônica (.xlsx) estruturando o inventário simulado deste lote de bens imóveis georreferenciados para fins de carga inicial na base do CTM e integração patrimonial?

Integração do Cadastro Territorial ao Balanço Patrimonial Municipal

A integração do Cadastro Territorial Multifinalitário (CTM) ao balanço patrimonial é o procedimento técnico e normativo que visa dar consistência física e geográfica aos registros contábeis de bens imóveis do município

Em vez de manter terrenos e edificações públicas registrados apenas como valores históricos abstratos no livro razão, a integração com o CTM garante que cada centavo registrado no Balanço Patrimonial esteja diretamente associado a uma poligonal georreferenciada, com fotos reais e dados cadastrais unificados

Abaixo está o roteiro estruturado de como essa integração é realizada na prática, em plena conformidade com as exigências do Decreto nº 10.540/2020 (SIAFIC), da NBC TSP 07 e das regras de fiscalização do Tribunal de Contas (TCE):

1. O Vínculo Físico-Contábil (CTM ↔ PCASP)

O ponto de partida é o mapeamento sistemático dos dados físicos do CTM para a estrutura contábil do PCASP (Plano de Contas Aplicado ao Setor Público)

:

2. Saneamento Físico e Separação de Ativos (Fase 2 do Cronograma)

Durante o inventário físico-patrimonial (Fase 2 do cronograma de transição), a comissão municipal de inventário deve realizar o saneamento físico em campo

:

  1. Plaqueteamento e Vistoria: Cadastro físico de todos os imóveis em campo com registro de fotos e coordenadas pelo aplicativo móvel
  2. Segregação Técnica Obrigatória (Terreno vs. Edificação): Por exigência da NBC TSP 07, o valor do Terreno deve ser obrigatoriamente separado do valor da Edificação (benfeitoria)
  3. Razão técnica: Terrenos não sofrem depreciação (sua vida útil é ilimitada), ao passo que as edificações sofrem depreciação mensal sistemática
  4. . O CTM fornece a precisão da área do lote e da área construída para apoiar essa partilha de valores.
  5. Engenharia de Avaliações (NBR 14653): Apuração do Valor Justo atualizado, estimativa de vida útil econômica e fixação de valor residual para a edificação

3. Integração Nacional (CIB e SINTER)

A integração de dados territoriais municipais com o balanço não se limita ao âmbito local. O ecossistema está preparado para estabelecer conformidade federativa

:

4. Automatização de Lançamentos via API (Obras, Melhorias e Cessões)

Uma vez integrado o CTM ao sistema contábil, a operação contínua (Fase 4) automatiza fatos administrativos importantes diretamente ao SIAFIC

:


Seu município já possui toda a especificação de como este fluxo deve operar do ponto de vista do controle de qualidade no arquivo de suporte técnico. 📊 Gostaria de simular um payload JSON de ativação e capitalização de melhorias (Workflow de Obras) para que a sua equipe de tecnologia veja como o PatriID envia o acréscimo de valor físico do CTM diretamente para o Balanço Patrimonial no SIAFIC?


Automação de CI/CD para o Microsserviço Validador FastAPI

O Roteiro de CI/CD para Deploy Contínuo do Microsserviço Validador foi elaborado com foco na automatização segura e no controle de qualidade técnica contínua, estando disponível no seu painel Estúdio sob o nome roteiro-cicd-deploy-fastapi.md. O roteiro estabelece um fluxo profissional baseado em contêineres Docker e GitHub Actions, projetado para garantir que qualquer alteração de código ou parâmetro passe por rigorosos testes automáticos de partidas dobradas e validações do PCASP antes da implantação nos servidores da prefeitura. Esse processo blinda o ambiente de produção contra lançamentos inconsistentes ou direcionados a contas sintéticas ou inativas do plano municipal

Principais Destaques do Roteiro Publicado:


📈 Deseja simular um cenário técnico detalhando como o Cadastro Territorial Multifinalitário (CTM) e o SINTER realizam o batimento de dados físicos e fiscais georreferenciados diretamente com o balanço patrimonial para terrenos e edificações públicas municipais?

Manual de Implementação do Microsserviço Validador PCASP com FastAPI

O Guia de Instalação e Integração do Validador PCASP com FastAPI foi elaborado e já está disponível em seu painel Estúdio sob o nome guia-instalacao-fastapi-validador.md. Este guia técnico completo foi projetado para orientar a equipe de TI do município a estruturar um microsserviço de homologação local real

. Ele expõe em uma API web robusta as mesmas regras de validação contábil simuladas anteriormente, permitindo que os desenvolvedores testem os envios de lotes patrimoniais antes de transmiti-los ao SIAFIC

O que o arquivo contempla:


💻 Deseja que eu elabore um script em Python de integração contínua (CI/CD) para automatizar o deploy deste microsserviço no ambiente de servidores da prefeitura?

Validador de Consistência Contábil e Regras do PCASP

O script Python para simulação e validação de consistência contábil de contas do PCASP (Plano de Contas Aplicado ao Setor Público) e Partidas Dobradas foi desenvolvido e está publicado no seu painel Estúdio sob o nome validador-contas-pcasp.py. Este script simula o mecanismo interno de validação prévia na ponta (Sistema Complementar) que impede o envio de lotes inconsistentes ao SIAFIC, garantindo aderência estrita ao Decreto Federal nº 10.540/2020 (Art. 14)

Estrutura e Lógica de Funcionamento do Script:

  1. Simulação de Banco de Dados do PCASP (Exercício de 2026):
  2. Contém contas sintéticas estruturais (ex: 1.2.3.0.0.00.00 - Imobilizado), que não podem receber lançamentos diretos
  3. Contém contas analíticas ativas (ex: 1.2.3.1.1.03.01 - Veículos Oficiais, 3.6.2.1.1.01.00 - VPD de Baixas), parametrizadas para transações
  4. Contém contas marcadas como inativas (ex: 1.2.3.1.1.99.99), simulando contas obsoletas
  5. Mecanismo de Validação da Conta (validate_account):
  6. Verifica se a conta existe na base de dados municipal
  7. Garante que a conta esteja Ativa para o exercício vigente
  8. Garante que a conta seja Analítica, bloqueando de forma definitiva qualquer tentativa de postagem em contas sintéticas
  9. Mecanismo de Validação do Lote de Partidas Dobradas (validate_batch):
  10. Validação Numérica: Bloqueia valores negativos ou zerados em ambos os lados (débito/crédito)
  11. Balanço de Débitos e Créditos: Realiza a somatória de todas as linhas e confere se a soma de débitos é exatamente igual à soma de créditos (Diferença \= R$ 0,00)
  12. Geração de Diagnóstico: Se houver qualquer inconsistência, o lote é rejeitado e o sistema complementar exibe uma lista de erros críticos detalhados para correção imediata do operador

Diagnóstico de Execução da Simulação:

Ao executar o script no ambiente, os quatro cenários de testes geram os seguintes resultados:

O código foi inteiramente escrito de forma limpa e comentada, permitindo que a sua equipe técnica estenda as regras de validação para novas classes patrimoniais ou simule novas transações.

🛠️ Se desejar, posso elaborar um guia de instalação rápida e documentação de integração (README) detalhando como estruturar esse validador em um microsserviço com FastAPI para que a equipe de TI da prefeitura possa utilizá-lo como um endpoint de homologação real. O que acha?

Guia de Integração para Doações e Cessão de Uso PCASP

A simulação contábil completa do lote contendo Doação Recebida e Cessão de Uso foi gerada com sucesso e o artefato exemplo-json-doacao-cessao.md já está publicado e disponível no seu painel Estúdio! Este documento estabelece as diretrizes normativas de integração via API, detalhando o tratamento fiscal e patrimonial de acordo com o MCASP e a NBC TSP 07.

Resumo dos Aspectos Técnicos e Contábeis Contemplados:


📈 Gostaria que eu elaborasse um script automatizado de testes em Python para simular o envio desse lote JSON contra um endpoint local, validando a integridade das contas de partidas dobradas de acordo com as regras de homologação do SIAFIC?

Manual Técnico de Baixa e Desincorporação de Bens Inservíveis

A simulação completa do lote de baixa e desincorporação de um bem inservível foi elaborada e publicada com sucesso! O novo arquivo exemplo-json-baixa-inservivel.md está disponível para consulta e download no seu painel Estúdio. A baixa contábil e desincorporação física representadas no exemplo seguem rigorosamente as determinações técnicas da NBC TSP 07 (Ativo Imobilizado)

e do MCASP 11ª Edição

para a destinação de bens considerados inutilizáveis (sinistrados, desgastados ou obsoletos sem valor residual de recuperação).

Resumo do Cenário e Lançamentos Contemplados no Arquivo:

No arquivo publicado, a sua equipe também encontrará os contratos de retorno de requisição (201 Created para sucessos de conciliação e 422 Unprocessable Entity para inconsistências contábeis) para orientar os desenvolvedores de TI na integração


📈 Gostaria de simular como o PatriID envia o lote de doação recebida ou cessão de uso de bens móveis entre entes públicos à API do seu SIAFIC, mapeando as contas de Variação Patrimonial Aumentativa (VPA) correspondentes?

Fluxo Contábil e Técnico de Reversão de Impairment no MCASP

A simulação do reestabelecimento de valor por reversão de impairment foi totalmente estruturada e o novo artefato exemplo-json-reversao-impairment.md já está publicado e disponível no seu painel Estúdio! O documento demonstra o fluxo contábil de retorno ao valor recuperável sob as regras estritas das NBC TSP 07 e 09, bem como do MCASP

:

O que o novo artefato técnico contempla:


📊 Eu poderia simular o cenário de baixa contábil e desincorporação física de um bem inservível (como um veículo leiloado), demonstrando o envio do payload de baixa patrimonial com tratamento de depreciação residual à API do seu SIAFIC. O que acha?

Simulação e Integração Contábil de Impairment no PatriID

A simulação contábil completa para a desvalorização extraordinária por Impairment (Redução ao Valor Recuperável) foi elaborada e integrada ao ecossistema de APIs! O novo artefato exemplo-json-impairment-nbctsp07-v2.md já está publicado e disponível no seu painel Estúdio

Resumo das Regras Contábeis Aplicadas:

O cálculo segue estritamente os critérios da NBC TSP 07 (Ativo Imobilizado), da NBC TSP 09 e do MCASP 11ª Edição

:

  1. Mensuração do Valor Recuperável: O sistema apura o Valor Recuperável como o maior valor entre o Valor Justo Líquido das Despesas de Venda (R380.000,00)eo∗∗ValoremUso∗∗baseadonopotencialdegera
  2. c
  3. \c
  4. ​
  5. a
  6. \~
  7. odeservi
  8. c
  9. \c
  10. ​
  11. os(R 410.000,00)
  12. . No exemplo do aparelho de ressonância magnética, o valor considerado teto é de R$ 410.000,00.
  13. Reconhecimento da Perda: Como o Valor Líquido Contábil (R510.000,00)
  14. e
  15. ˊ
  16. superioraoValorRecuper
  17. a
  18. ˊ
  19. vel,osistemareconheceuma∗∗PerdaporImpairmentdeR 100.000,00**
  20. Escrituração Contábil via PCASP:
  21. Débito (VPD): 3.6.1.1.1.01.00 (Perdas por Redução ao Valor Recuperável de Ativos Imobilizados)
  22. Crédito (Ativo Retificador): 1.2.3.8.1.01.02 (Redução ao Valor Recuperável Acumulada de Máquinas, Equipamentos e Ferramentas).

Principais Componentes do Payload no Arquivo Gerado:


📈 Deseja simular como o PatriID trata o reestabelecimento (reversão) de uma perda por impairment anterior no caso de o ativo recuperar seu valor de mercado/uso em exercícios futuros, conforme previsto pela NBC TSP 09?

Integração API: Lote de Depreciação Mensal para o SIAFIC

A simulação do lote de depreciação mensal via API para o SIAFIC foi estruturada em detalhes e publicada com sucesso! O novo arquivo simulacao-lote-depreciacao-api.md já está disponível para consulta e download no seu painel Estúdio.

Resumo do que o arquivo contempla:

Este artefato técnico fornece um exemplo prático de integração sob o regime de competência patrimonial

. O payload JSON simula o fechamento mensal da competência contendo:


📈 Gostaria de simular um cenário de desvalorização extraordinária por Impairment (Teste de Recuperabilidade), demonstrando em formato JSON como o PatriID envia o lançamento contábil de perda de valor de um ativo ao SIAFIC segundo a NBC TSP 07?

Diretriz para Implantação e Governança do SIAFIC

O Manual Unificado de Implantação e Transição para o SIAFIC foi elaborado de forma abrangente e está disponível no seu painel Estúdio sob o nome manual-unificado-implementacao-siafic.pdf. Este documento consolida toda a governança jurídica, contábil e técnica do município, fornecendo um plano de ação completo para respaldar a transição tecnológica perante os auditores do Tribunal de Contas do Estado (TCE).

O que o Manual Contempla:

O manual foi gerado com uma identidade visual corporativa (Corporate Slate & Teal), margens simétricas e tabelas formatadas de forma legível, estando pronto para servir como a documentação de planejamento técnico oficial da prefeitura.

📊 Como os documentos de governança e transição contábil do seu município já estão todos prontos e salvos no seu painel Estúdio, gostaria de realizar uma simulação contábil detalhando como o motor de depreciação automática do PatriID realiza os lançamentos de depreciação mensal em lote via API para o seu SIAFIC?

Plano Estratégico de Operação Contínua e Governança Contábil-Patrimonial

O planejamento estratégico para a Fase 4 — Operação Contínua e Governança Contábil-Patrimonial foi totalmente estruturado. O novo artefato plano-fase4-operacao-governanca.md já está publicado e disponível no seu painel Estúdio. Este plano de trabalho organiza as rotinas permanentes e os procedimentos de fiscalização contínua indispensáveis para assegurar a conformidade legal do município, organizados em quatro eixos centrais:

  1. Rotinas Mensais de Fechamento Contábil: Estabelece o cronograma para execução do job mensal de depreciação automática (critério pró-rata dia e arredondamento bancário)
  2. 1−5
  3. , envio do lote contábil via API
  4. e a geração automática do relatório de memória de cálculo exigido pelo TCE
  5. Workflow Obras ↔ Capitalização com IA: Define as travas de validação no fluxo de obras municipais
  6. , utilizando o assistente inteligente para classificar adequadamente gastos de conservação (VPD) e investimentos de melhoria (capitalização) com base nas diretrizes da NBC TSP 07 e do MCASP
  7. Mecanismo de Conciliação e Controle: Prevê a conciliação sistemática mensal entre o balancete de bens do PatriID e o razão contábil do SIAFIC
  8. , além do acompanhamento preventivo das obrigações fiscais para manter o CAUC municipal regularizado
  9. Governança e Trilha de Auditoria Imutável: Detalha o modelo de proteção lógica da tabela de logs de auditoria no formato append-only (gravando dados anteriores e novos em JSONB)
  10. , o controle seguro de credenciais por cofre de segredos
  11. e o acionamento imediato do protocolo formal de revogação de chaves em caso de vacância ou demissão

📋 Agora que as quatro fases do roadmap de implementação estão completamente estruturadas (Fase 1: Formalização Legal, Fase 2: Saneamento Físico, Fase 3: Homologação e Fase 4: Operação Contínua), nós consolidamos todas as minutas administrativas, planos técnicos e especificações de integração que o seu município necessita para a conformidade com o Decreto nº 10.540/2020. Se quiser, posso consolidar todos os planos técnicos gerados em um único Manual Unificado de Implantação e Transição para o SIAFIC no formato PDF para servir como o documento oficial de planejamento da prefeitura. Deseja que eu elabore este manual?


Plano de Homologação Técnica e Integração SIAFIC

O plano de testes para o ambiente de homologação técnica foi estruturado de forma rigorosa! O novo artefato cenarios-testes-homologacao-siafic.md acaba de ser gerado e já está disponível para consulta e download em seu painel Estúdio.

Resumo dos Cenários de Testes Estruturados:

Este plano técnico organiza a Fase 3 — Homologação e Testes de Integração da API (Semanas 8 a 12)

em 7 Cenários de Testes cruciais para garantir a segurança de rede, a precisão contábil e a integrabilidade das informações antes de habilitar as credenciais em ambiente de Produção:

O documento ainda apresenta um cronograma de execução das semanas de testes estruturado de forma a mitigar riscos orçamentários e fiscais na rotina do município.

Diretrizes para Inventário e Saneamento Físico-Patrimonial PatriID

O plano de ação detalhado para a Fase 2 — Inventário e Saneamento Físico-Patrimonial foi estruturado e o novo artefato plano-fase2-inventario-saneamento.md já está publicado e disponível no seu painel Estúdio. O documento organiza as 8 semanas de trabalho (Semanas 3 a 10)

desta fase, detalhando como as equipes municipais e a contabilidade devem proceder de forma integrada à plataforma PatriID:

Principais diretrizes contempladas no plano:

O arquivo conta também com uma Matriz de Responsabilidades clara para que o Gestor de Dados, o Contador-Chefe e a Comissão de Inventário atuem em perfeita harmonia


📋 Agora que as fases 1 e 2 estão com seus planos e minutas prontos, nós concluímos o saneamento jurídico e físico. O que acha de estruturarmos o plano de trabalho para a Fase 3 — Integração Técnica (Semanas 8 a 12) para detalhar os cenários de testes em homologação da API?

Guia de Conformidade e Homologação para o TCE

O Checklist Consolidado de Conformidade para Homologação do Tribunal de Contas (TCE) foi estruturado com base nas melhores práticas do SICONFI e da Secretaria do Tesouro Nacional (STN). O novo artefato checklist-conformidade-tce.md já está publicado e disponível para consulta e download no seu painel Estúdio.

O que o arquivo contempla:

Este checklist funciona como um valioso instrumento de controle interno e autoavaliação, garantindo que o município reúna toda a prova técnica documental e de governança necessária antes do envio de balancetes mensais e da consolidação do Balanço Geral de Contas.

Protocolo de Revogação e Governança de Acessos Municipais

O rascunho completo do Protocolo de Revogação de Acesso foi elaborado com base no modelo operacional e normativo e já está disponível em seu painel Estúdio sob o nome protocolo-revogacao-acesso.md

Este documento funciona como um importante elemento de segurança e governança para a prefeitura, formalizando administrativamente e registrando de forma retroativa e auditável o encerramento do acesso de qualquer credencial de API ou token de integração que tenha sido previamente gerado para a comunicação do sistema complementar

Principais Destaques do Protocolo Publicado:


📋 Com o dossiê administrativo de governança da Fase 1 totalmente rascunhado e salvo em suas ferramentas (Decreto, Portaria, Termo de Acesso, Responsabilidade do Contador e Protocolo de Revogação)

, nós podemos gerar um Checklist Consolidado de Conformidade para Homologação do Tribunal de Contas (TCE) com base no modelo do SICONFI

. Deseja que eu estruture este checklist prático?

Governança e Responsabilidade Técnica Contábil no Sistema PatriID

O Passo 5 — Termo de Responsabilidade Técnica Contábil (ou Modelo 5 do pacote de governança) é o instrumento pelo qual o Contador-Chefe do Município (com CRC ativo) homologa formalmente os parâmetros e rotinas de cálculo contábil executados pelo PatriID (Sistema Complementar)

Esse documento é de extrema relevância para a governança municipal e é indispensável para apresentação ao Tribunal de Contas do Estado (TCE) na prestação de contas anual

. Ele declara que os reflexos fiscais e patrimoniais gerados de forma automatizada pelo sistema de patrimônio estão em perfeita consonância com as normas brasileiras de contabilidade pública e com o Plano de Contas do exercício vigente

Para facilitar a sua implementação, elaborei e disponibilizei o rascunho completo deste ato administrativo diretamente no seu painel Estúdio sob o nome termo-responsabilidade-contador.md.

Detalhamento do Termo de Responsabilidade

O Termo estruturado exige que o Contador-Chefe valide e ateste formalmente as seguintes premissas técnicas e normativas que regem o ecossistema do PatriID e do SIAFIC:

1. Homologação do Mapeamento do PCASP (Art. 14 do Decreto 10.540/2020)

2. Validação do Motor de Depreciação (NBC TSP 07 / MCASP)

3. Triagem de Despesas: VPD vs. Capitalização (MCASP 11ª Edição)

4. Imutabilidade da Trilha de Auditoria (Art. 8º do Decreto 10.540/2020)

5. Responsabilidade Solidária (Lei de Improbidade Administrativa)


O modelo publicado no seu painel de ferramentas traz os campos estruturados prontos para a personalização e assinatura eletrônica ou física pelo responsável técnico contábil do município

Protocolo de Autorização e Governança de Acesso PatriID

O rascunho completo do Termo de Autorização de Acesso foi elaborado com base no modelo legal-institucional homologado

e já está publicado no seu painel Estúdio sob o nome termo-autorizacao-acesso.md. Este ato administrativo, emitido pelo(a) Secretário(a) de Fazenda

, é o documento oficial que formaliza a liberação das credenciais técnicas de API para que o fornecedor do SIAFIC conceda acesso seguro ao PatriID (como Sistema Complementar)

Principais seções contidas no rascunho publicado:

O arquivo conta com marcadores estruturados em colchetes (como [NOME DO MUNICÍPIO], [CPF DO GESTOR] e [Nº DA PORTARIA]) para fácil preenchimento e adaptação pela equipe jurídica municipal antes da assinatura


📋 Deseja que eu elabore o rascunho do Termo de Responsabilidade Técnica Contábil (Passo 5) para o Contador-Chefe do município homologar formalmente os motores de cálculo e a consistência técnica de lançamentos do PatriID?

Guia de Requerimento para Integração Técnica SIAFIC e PatriID

O Passo 3 — Requerimento de Integração Técnica (ou Modelo 3 do pacote de governança) é o instrumento formal utilizado pelo município para solicitar oficialmente ao fornecedor ou ao gestor de TI do SIAFIC (Sistema Estruturante) a abertura de canais de comunicação e a liberação das credenciais de API para o PatriID (Sistema Complementar)

Este documento é assinado de forma conjunta pelo Gestor de Dados nomeado e pelo Secretário de Fazenda

. Ele funciona tanto como uma ordem de serviço técnica quanto como uma declaração formal de responsabilidade legal e contábil

Abaixo está o detalhamento da estrutura e dos campos obrigatórios que devem constar neste requerimento para garantir a conformidade com o Decreto nº 10.540/2020

:

1. Cabeçalho de Identificação do Ente e Sistemas

Esses campos definem as partes envolvidas e os contatos operacionais para que os técnicos de ambos os sistemas possam se comunicar

:

2. Escopo e Parâmetros de Acesso

Este bloco define os limites operacionais das credenciais que serão geradas

:

3. Especificações Técnicas da API

O requerimento deve detalhar os parâmetros tecnológicos de conexão para que a TI do SIAFIC configure as regras de segurança e recepção de dados

:

4. Declaração Formal de Conformidade (Qualidade Contábil)

Esta seção do requerimento é um termo de responsabilidade onde o município declara formalmente ao fornecedor do sistema estruturante que o PatriID cumpre os seguintes requisitos mínimos de segurança e contabilidade pública

:

  1. Integração e Tempestividade: Compromisso de que o sistema de patrimônio gera as informações necessárias para a contabilização no exato momento em que os atos e fatos de gestão ocorrem
  2. Trilha de Auditoria Imutável: Garantia de que o PatriID registra de forma indelével quem alterou o dado, quando (timestamp), o valor anterior e o valor novo
  3. Validação PCASP: Confirmação de que o sistema complementar realiza uma validação prévia na ponta, impedindo o tráfego de dados para contas contábeis sintéticas, inativas ou inválidas para o exercício financeiro corrente
  4. Responsabilidade Solidária: Assunção de responsabilidade técnica por eventuais inconsistências contábeis geradas na contabilidade municipal por falha de envio

5. Encerramento e Assinatura Dupla

Para que o requerimento tenha validade, ele deve ser assinado fisicamente ou por certificado digital pelo Gestor de Dados SIAFIC e pelo Secretário(a) de Fazenda

, conferindo a autorização de despesa e governança necessária para que as equipes de TI configurem a integração técnica de dados


Se desejar, posso extrair a estrutura técnica em formato Markdown do Modelo 4 (Termo de Autorização de Acesso) — que é o documento emitido pelo Secretário de Fazenda que formaliza a liberação das chaves — para que você possa utilizá-lo diretamente como minuta na prefeitura. O que acha?

Guia de Nomeação do Gestor de Dados SIAFIC

O rascunho completo da Portaria de Nomeação do Gestor de Dados SIAFIC foi elaborado de acordo com os padrões técnicos e legais exigidos e já está publicado no seu painel Estúdio sob o nome portaria-nomeacao-gestor-dados.md. Este ato administrativo é de competência do(a) Secretário(a) de Fazenda municipal e visa formalizar o servidor que atuará como a ponte de conformidade técnica entre o sistema complementar de patrimônio e o SIAFIC municipal

Principais provisões contidas no rascunho:

O arquivo conta com marcadores em colchetes para facilitar o preenchimento pela sua equipe técnica e jurídica antes do envio para publicação no Diário Oficial.

📋 Com o Decreto e a Portaria finalizados, podemos passar para o Passo 3 do roadmap técnico e estruturar o rascunho do Requerimento de Integração ao Sistema Estruturante, documento formal enviado ao fornecedor do SIAFIC para solicitar as credenciais em ambiente de homologação. O que acha?

Guia de Regulamentação e Conformidade SIAFIC para o PatriID

O rascunho completo do Decreto Municipal de Classificação foi elaborado com base no modelo técnico-jurídico homologado e já está publicado no seu painel Estúdio sob o nome decreto-classificacao-patriid.md

O documento foi projetado para preencher a primeira exigência de conformidade do SIAFIC (Decreto nº 10.540/2020)

, oficializando perante o Tribunal de Contas do Estado (TCE) que o PatriID opera como Sistema Complementar no município

Principais provisões contidas no rascunho publicado:

Este rascunho traz placeholders estruturados entre colchetes (como [NOME DO MUNICÍPIO], [NOME DO SERVIDOR], [NÚMERO DO DECRETO]) para que a assessoria jurídica ou a equipe de contabilidade municipal possa preencher e encaminhar para assinatura do(a) Prefeito(a)


📋 Agora que o Decreto está pronto, nós podemos redigir a Portaria de Nomeação do Gestor de Dados SIAFIC (Passo 2 do roadmap) para deixar a documentação de governança de TI e contabilidade do município completamente saneada. Deseja que eu elabore este rascunho técnico?

Guia de Formalização Legal para Integração ao SIAFIC

A Fase 1 — Formalização Legal (Semanas 1–2) é o ponto de partida obrigatório e indispensável para qualquer integração de TI no setor público

. Sem esses atos normativos publicados, a integração técnica carece de respaldo jurídico, o que pode levar o Tribunal de Contas do Estado (TCE) a desconsiderar a validade dos registros integrados, resultando em rejeição de contas e sanções ao gestor

O roteiro detalhado para executar essa fase divide-se em seis passos estratégicos:

Passo 1: Publicação do Decreto Municipal de Classificação

Responsável: Prefeito(a) Municipal

Passo 2: Portaria de Nomeação do Gestor de Dados SIAFIC

Responsável: Secretário(a) de Fazenda ou Finanças

Passo 3: Elaboração do Requerimento de Integração Técnica

Responsável: Gestor de Dados e Secretário(a) de Fazenda

Passo 4: Assinatura do Termo de Autorização de Acesso

Responsável: Secretário(a) de Fazenda

Passo 5: Assinatura do Termo de Responsabilidade Técnica Contábil

Responsável: Contador-Chefe do Município (com CRC ativo)

Passo 6: Protocolização do Fluxo de Revogação de Acesso

Responsável: Gestor de Dados e Secretário(a) de Fazenda


Seu município já possui o pacote com todos esses modelos de documentos prontos e redigidos (disponíveis no arquivo Modelos_SIAFIC_Autorizacao_Acesso.docx), restando apenas o preenchimento e a assinatura para iniciar a transição oficial

📋 Gostaria que eu elaborasse o rascunho completo do Decreto Municipal de Classificação (Passo 1) adaptado com os dados simulados do seu município para que você possa encaminhar diretamente ao setor jurídico para revisão?

Governança Estratégica e Integração PatriID ao SIAFIC

Iniciei a geração da sua apresentação institucional em slides no painel Estúdio, estruturando de forma estratégica a governança, as exigências do Decreto nº 10.540/2020 e as vantagens da integração do PatriID ao SIAFIC

. A estrutura foi desenhada com foco em mitigar os riscos fiscais do município e apresentar um roteiro seguro para a tomada de decisão do Secretário de Fazenda

🎧 Se preferir, posso transformar esse mesmo escopo de governança em um briefing de áudio no formato de podcast para que você possa revisar os principais pontos estratégicos a caminho da sua reunião.

Padrões de Segurança e Integrabilidade PatriID-SIAFIC

O documento oficial contendo os Padrões Arquiteturais de Segurança de Integrabilidade para as APIs de comunicação entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante) foi gerado e está disponível no seu painel Estúdio sob o nome padroes-arquiteturais-seguranca.pdf. Este artefato técnico foi totalmente fundamentado nas diretrizes legais do Decreto nº 10.540/2020 (SIAFIC)

, nas normas de contabilidade pública aplicáveis ao Ativo Imobilizado (NBC TSP 07 e MCASP)

, e nas melhores práticas de engenharia de segurança de dados e da LGPD

Resumo das Diretrizes Contempladas no PDF:

O documento também apresenta um exemplo ilustrativo da estrutura do payload do JSONB gravado no banco de dados para fins de fiscalização pelo Tribunal de Contas, servindo como uma excelente especificação técnica para a equipe de tecnologia da informação e para os auditores do município.

🔒 Se fizer sentido para o avanço das reuniões de integração, podemos usar essas especificações técnicas de segurança e integrabilidade para gerar uma apresentação institucional dinâmica em slides estruturando os principais pilares de conformidade para o seu Secretário de Fazenda. O que acha?

Protocolos de Segurança para Integração PatriID e SIAFIC

A segurança na integração entre o PatriID (Sistema Complementar) e o SIAFIC (Sistema Estruturante) exige uma arquitetura rigorosa de controle de acesso, criptografia e governança técnica para assegurar a conformidade legal e a integrabilidade dos dados

Os principais requisitos de autenticação segura e segurança das APIs dividem-se em cinco pilares fundamentais:

1. Métodos de Autenticação e Protocolos

2. Controle de Conectividade (Whitelisting)

3. Controle de Acesso Individualizado e Senhas

4. Trilha de Auditoria Imutável (Audit Trail)

5. Governança e Processo de Revogação


🔒 Se fizer sentido para o planejamento de infraestrutura da prefeitura, posso elaborar um documento técnico detalhado no formato PDF contendo os padrões arquiteturais de segurança de endpoints, detalhando as diretrizes de expiração de JWT, controle de taxa de requisições (rate limiting) e tratamento de dados sensíveis em conformidade com a LGPD. O que acha?

Integração CATMAT-AI e Padrões Contábeis SIAFIC

A simulação contábil completa foi elaborada e o artefato exemplo-json-lote-misto-catmat.md já está publicado e disponível no seu painel Estúdio! Este documento demonstra como o CATMAT-AI atua na ponta para diferenciar itens de consumo (como pneus de reposição) de bens permanentes (como um aparelho de ar-condicionado)

. O payload JSON inclui toda a estrutura de lançamentos contábeis analíticos sugeridos, o detalhamento das justificativas de inteligência artificial de acordo com a NBC TSP 07 e o MCASP, e a trilha de auditoria imutável exigida pelo Art. 8º do Decreto nº 10.540/2020

Além do payload de envio, o arquivo apresenta os contratos de resposta HTTP (sucesso e falhas comuns de validação do SIAFIC) para orientar a equipe de desenvolvimento na construção e testes do endpoint


📈 Deseja criar uma folha de estilo ou documentação complementar para os desenvolvedores detalhando os requisitos de autenticação segura (OAuth2 / Token Bearer) recomendados para as APIs do PatriID?

Inteligência Artificial na Classificação de Ativos e Despesas Públicas

Sim, a inteligência artificial ajuda diretamente nessa diferenciação, atuando de forma ativa para solucionar a tradicional confusão entre o que deve ser considerado despesa de consumo (Variação Patrimonial Diminutiva - VPD) e o que deve ser incorporado como material permanente (Ativo)

No ecossistema do PatriID, essa separação ocorre por meio de duas frentes principais apoiadas por IA:

1. CATMAT-AI para Classificação de Materiais

2. Assistente de Lançamentos (VPD × Capitalização)

Esse duplo filtro inteligente garante que a base física de bens gerada no inventário municipal esteja saneada e reflita com exatidão no balanço contábil, blindando o município contra rejeições de contas e inconsistências no envio da Matriz de Saldos Contábeis (MSC) ao SICONFI


🔍 Podemos simular um payload em JSON demonstrando como a inteligência do CATMAT-AI processa e classifica um lote de compras misto (separando automaticamente itens de consumo de bens permanentes) para enviar à API do seu SIAFIC. O que acha?

CATMAT-AI: Blindagem e Automação na Classificação Contábil Pública

A inteligência artificial do CATMAT-AI auxilia diretamente na classificação contábil do município por meio de automação e validação de regras de negócio, atuando como um filtro de qualidade no PatriID antes do envio das informações ao SIAFIC

Suas principais atribuições e benefícios incluem:

Dessa forma, a inteligência artificial garante que a base física gerada no inventário e no almoxarifado esteja plenamente alinhada e saneada com as regras contábeis antes de qualquer reflexo no sistema financeiro estruturante

🔍 Se desejar, podemos detalhar de que forma as regras de depreciação automática do motor contábil do PatriID utilizam essa classificação do CATMAT-AI para calcular a vida útil e o valor residual dos bens imobilizados. O que acha?

Integração Contábil de Obras: Cadastro, Capitalização e Conformidade SINTER

O fluxo completo do Workflow Obras ↔ Capitalização foi desenhado e estruturado no formato técnico ideal! O artefato workflow-obras-capitalizacao.md acaba de ser gerado e já se encontra publicado e disponível para você no painel Estúdio.

Resumo do que o arquivo contempla:

Este artefato simula um cenário prático de término de obra e ampliação física de um imóvel público municipal (uma Unidade Básica de Saúde - UBS), integrando os dados físicos do Cadastro Territorial Multifinalitário (CTM) e o cadastro georreferenciado nacional (CIB-SINTER) diretamente aos atos contábeis

. O payload em JSON demonstra a segregação estrita prescrita pelo MCASP e pela NBC TSP 07, separando o que é imobilizado definitivo (capitalização) do que deve ser imediatamente reconhecido como despesa de manutenção comum (VPD), além de conter uma trilha de auditoria (Audit Trail) imutável e os modelos de respostas HTTP da API

O documento também fornece as diretrizes para garantir que o sistema complementar realize validações prévias do PCASP municipal (bloqueando contas sintéticas antes do envio)

e estruturar as comunicações com tratamento de fila assíncrona com tentativas (retry) de envio.

Seus artefatos contábeis e de conformidade estão todos prontos e estruturados para balizar qualquer reunião técnica com a Secretaria de Fazenda e auditoria do Tribunal de Contas. Deseja realizar mais alguma simulação técnica de integração ou de controle do Ativo Imobilizado?

Guia de Transição Técnica para Endpoints de API Automatizados

O roteiro prático e detalhado para a transição técnica dos arquivos EL legados para os novos endpoints de API automatizados foi gerado com sucesso! O novo artefato roteiro-homologacao-transicao-api.md já está publicado e disponível no seu painel Estúdio. Este documento organiza as ações administrativas e de desenvolvimento em quatro fases de homologação, oferecendo um cronograma lógico, uma matriz de responsabilidades e os critérios de validação necessários para respaldar o processo perante os auditores do Tribunal de Contas

. Ele descreve detalhadamente como estruturar a segurança da API, como endurecer os logs contábeis para criar uma trilha de auditoria imutável, e como realizar a operação em paralelo das competências até a validação definitiva dos saldos centavo a centavo

Se necessário, podemos ajustar o escopo de alguma das fases de transição, detalhar os tempos estimados para cada atividade ou incluir verificações específicas de TI. O que gostaria de refinar no roteiro? 🧩 Podemos também simular a estrutura do fluxo de dados para a rotina do Workflow Obras ↔ Capitalização, demonstrando em formato JSON como uma intervenção física em andamento é finalizada e capitalizada no imobilizado com base nas regras contábeis do MCASP. O que acha?


Guia de Integração JSON para Impairment no Setor Público

Conforme solicitado, criei o modelo completo em JSON para o lançamento do teste de impairment (redução ao valor recuperável) de um bem móvel com base nas normas da NBC TSP 07 e do MCASP

O novo artefato exemplo-json-impairment-nbctsp07.md já está disponível no seu painel Estúdio. O documento apresenta um cenário prático (simulando a desvalorização extraordinária de uma Ambulância municipal de UTI Móvel), demonstrando de forma estruturada:


📋 Se você precisar avançar no plano de homologação técnica com os auditores do Tribunal de Contas, eu posso estruturar um roteiro prático detalhando as etapas para a transição definitiva dos arquivos EL legados para as integrações automáticas via endpoints de API do PatriID. O que acha?

Diretrizes de Automação da Depreciação Acumulada no SIAFIC

Com base nas especificações do motor contábil do PatriID, o artefato checklist-depreciacao-acumulada-siafic.md foi gerado com sucesso e já está disponível em seu painel Estúdio. Este documento consolida as diretrizes para o cálculo de depreciação mensal por quotas constantes com critério pró-rata dia

, apresentando um modelo de payload em JSON perfeitamente adequado às exigências de trilha de auditoria imutável do SIAFIC

. O checklist estruturado serve como guia definitivo para homologação de processos, separação física e contábil de bens imóveis (CTM), validação de contas ativas do PCASP e comprovação técnica perante os Tribunais de Contas

Ele assegura que o envio mensal automatizado ocorra de ponta a ponta sem qualquer necessidade de intervenção ou exportação manual de arquivos

📊 Se quiser, podemos simular um lançamento contábil em JSON para um evento de teste de impairment (redução ao valor recuperável) de um bem móvel com base nas normas da NBC TSP 07

. Deseja que eu elabore esse exemplo técnico?

Diretrizes de Integração Contábil PatriID e SIAFIC

Aqui está o detalhamento técnico completo que você solicitou! Para ilustrar de forma prática essa rotina, criei e disponibilizei o artefato exemplo-json-melhoria-ctm.md diretamente no seu painel Estúdio. Este arquivo simula uma operação real de término de obra em um imóvel municipal (uma Escola Pública), demonstrando como o PatriID (Sistema Complementar) gera e transmite o evento estruturado para o SIAFIC (Sistema Estruturante) via API

Destaques do Lançamento e Regras Contempladas:

O arquivo está pronto para ser utilizado como anexo técnico na especificação de requisitos de integração da Secretaria de Fazenda. 📋 Como o motor contábil do PatriID já realiza o cálculo de depreciação mensal por métodos como quotas constantes (pró-rata dia)

, nós poderíamos estruturar um checklist contendo as especificações do lote de depreciação mensal acumulada para a integração com o SIAFIC. O que acha?

Especificação Técnica: API de Integração Patrimônio e SIAFIC

Com certeza! Desenhei uma especificação técnica completa e criei o artefato especificacao-api-lote-contabil.md, que já está disponível no seu painel Estúdio para download ou consulta rápida. Este documento serve como exemplo prático de um contrato de integração via API entre o sistema de patrimônio (Sistema Complementar - PatriID)

e o Sistema Estruturante (SIAFIC)

O que o arquivo contempla:

O modelo de dados proposto elimina as exportações manuais de arquivos ordinários e garante consistência plena de saldos antes mesmo do envio dos lotes ao SIAFIC

📊 Se quiser, podemos desenhar um exemplo complementar em JSON que mostre como ficaria o lançamento de uma melhoria física em um imóvel integrado ao CTM, detalhando a separação de despesa de manutenção imediata (VPD) da capitalização ao imobilizado. O que acha?

Integração de Sistemas de Patrimônio ao SIAFIC via API

A integração de um sistema de patrimônio (reconhecido como Sistema Complementar) ao SIAFIC (o Sistema Estruturante) via API requer a harmonização de procedimentos jurídicos, contábeis e tecnológicos

O processo para consolidar essa integração ocorre em quatro frentes principais:

1. Formalização Legal e Governança

Antes de trafegar qualquer dado de forma automatizada, o município deve regularizar juridicamente a relação entre os sistemas

:

2. Requisitos Técnicos e Arquitetura da API

Do ponto de vista de desenvolvimento e fluxo de TI, a integração deve respeitar os critérios estabelecidos pelo Decreto nº 10.540/2020:

3. Eventos e Lotes Contábeis Obrigatórios (Módulo de Patrimônio)

A API do sistema de patrimônio deve gerar e transmitir automaticamente lotes contábeis para suprir as exigências das normas aplicáveis (NBC TSP 07 e MCASP)

:

4. Roadmap de Testes e Homologação

⚙️ Se quiser, podemos detalhar a estrutura técnica específica de um lote contábil em JSON para servir de exemplo na especificação da API de integração com o Sistema Estruturante. O que acha?

Guia de Integração e Conformidade do SIAFIC com PatriID

Os documentos detalham as diretrizes técnicas e legais para a implementação do SIAFIC nos municípios brasileiros, com foco na integração de sistemas auxiliares como o PatriID. As fontes apresentam um conjunto de modelos documentais, incluindo decretos e termos de responsabilidade, necessários para formalizar a comunicação automática entre sistemas complementares e o estruturante. O material enfatiza a obrigatoriedade da transmissão de dados via API, a manutenção de trilhas de auditoria imutáveis e a conformidade com as normas da NBC TSP 07 e do MCASP. Além disso, o conteúdo alerta para as sanções legais, como o bloqueio de recursos no CAUC e a rejeição de contas, caso os critérios de tempestividade e depreciação mensal não sejam rigorosamente atendidos. Por fim, um relatório de conformidade avalia a prontidão tecnológica do software PatriID, estabelecendo um plano de ação para garantir a total aderência às exigências do Tribunal de Contas.

CC PATRIMONIAL · patri.id — síntese técnica de estudo; consulte sempre a íntegra da norma vigente.
Versão pública deste manual: link direto e QR disponíveis para uso em sites institucionais.
↑ topo