Rascunho em revisão — esta página ainda não é indexada pelos buscadores.

Integração do ERP com o PNCP por conectores ETL

A integração do ERP com o PNCP no MeuPNCP é feita por conectores ETL: o sistema lê os dados do banco do ERP (PostgreSQL, SQL Server, MySQL ou Firebird, via JDBC) ou de uma API REST, aplica o mapeamento e as transformações de cada campo para o formato do PNCP e cria os registros prontos para validação e envio.

Atualizado em · Escrito por Mário Dias · Revisado por [PREENCHER: nome do revisor técnico], [PREENCHER: cargo — ex.: responsável técnico pela integração com o PNCP]

Por que integrar o ERP ao PNCP?

Os dados que o PNCP pede já existem no sistema administrativo do órgão: número do processo, objeto, itens, valores, fornecedor, datas de assinatura e de vigência. Redigitar essas informações em outra tela custa tempo e cria divergências entre o processo e o que foi publicado. Como a publicação do contrato tem prazo e condiciona a eficácia (prazos de publicação no PNCP), automatizar a extração reduz o risco de atraso.

Como funciona o fluxo ETL do MeuPNCP?

  1. Conexão: o administrador cadastra a origem, seja um banco de dados (URL JDBC, driver, usuário e senha) ou uma API REST (URL base e autenticação), e testa a conexão.
  2. Consulta: para bancos, informa a consulta SQL que devolve os dados; o MeuPNCP detecta as colunas automaticamente. Para APIs, informa o endpoint e visualiza uma prévia da resposta.
  3. Mapeamento: liga cada coluna de origem ao campo de destino do formulário do PNCP (contratação, contrato, ata, PCA ou seus filhos).
  4. Transformação: aplica regras por campo, como formatar data, converter para inteiro ou decimal, maiúsculas, minúsculas, remover espaços e acrescentar prefixo ou sufixo.
  5. Importação: executa sob demanda, ignora registros já importados (deduplicação) e grava o histórico com totais e erros.
  6. Validação e envio: os registros criados seguem para a validação e o envio pela API oficial, como os digitados.

Quais bancos de dados e transformações são suportados?

Drivers incluídos no backend do MeuPNCP (novembro de 2026).
OrigemComo conectaObservação
PostgreSQLJDBCdriver nativo
Microsoft SQL ServerJDBCdriver mssql-jdbc
MySQLJDBCdriver mysql-connector-j
FirebirdJDBCdriver Jaybird
API REST do ERPHTTPURL base, endpoint e autenticação configuráveis
TransformaçãoUso típico
FORMAT_DATEconverter datas do ERP para o formato exigido pelo PNCP
TO_INT / TO_DECIMALconverter códigos e valores armazenados como texto
UPPER / LOWER / TRIMpadronizar textos e remover espaços
CONCAT_PREFIX / CONCAT_SUFFIXmontar números de processo ou códigos compostos

O ERP precisa ser alterado?

Não. O conector só lê os dados, por uma consulta definida pelo administrador. A recomendação é usar um usuário de banco com permissão apenas de leitura e, quando possível, uma visão (view) com as colunas necessárias. Nada é gravado no banco de origem.

E a segurança dos dados?

O conector acessa somente o que a consulta seleciona, e cada importação fica registrada com data e totais. As credenciais de acesso ao PNCP pertencem à plataforma e são de sua responsabilidade exclusiva, como diz a página oficial Integre-se ao PNCP.

[PREENCHER: dado interno — descrever, com autorização do cliente, um caso real de integração (ERP de origem, volume importado, tempo economizado) e um print anonimizado da tela de mapeamento]

O módulo Conectores detalha as telas. Para os requisitos técnicos da API do PNCP, veja API do PNCP.

Perguntas frequentes

O MeuPNCP integra com qualquer ERP?

Integra com ERPs cujos dados estejam em PostgreSQL, SQL Server, MySQL ou Firebird, acessíveis por JDBC, ou que ofereçam uma API REST. Outras fontes podem ser avaliadas caso a caso.

Preciso de programador para configurar o conector?

É preciso conhecer a estrutura do banco do ERP para escrever a consulta SQL. O mapeamento e as transformações são configurados em telas, sem programação.

O conector grava no banco do ERP?

Não. Ele apenas lê os dados retornados pela consulta configurada e cria os registros no MeuPNCP.

E se o mesmo contrato for importado duas vezes?

A importação faz deduplicação: registros já importados são ignorados e contados como tal no histórico da execução.

Os dados importados vão direto para o PNCP?

Não. Eles viram registros no MeuPNCP e passam pela validação antes do envio, como os registros digitados.

Fontes

  1. Integre-se ao PNCP (gov.br/pncp) (conferido em 03/11/2026)
  2. Manual de Integração PNCP, versão 2.4 (abril/2026) — seção 4.2 (conferido em 03/11/2026)

Conteúdo informativo; não substitui orientação jurídica.