FiscalizaBSB

Contratos e licitações pelo PNCP

Desde a Lei 14.133/2021, o Portal Nacional de Contratações Públicas é onde editais, atas e contratos de todos os entes têm de aparecer — e um contrato que não está lá no prazo não tem eficácia (os prazos). A API de consulta responde a qualquer um, sem chave. É lenta e tem limite de pedidos: o roteiro conta com isso.

Verificado ao vivo em 29 de outubro de 2026. Estado e armadilha resumida em de onde vem o dado.

A primeira chamada

Os contratos de um órgão num período (aqui, a prefeitura de Luziânia, GO, de janeiro a setembro de 2026):

https://pncp.gov.br/api/consulta/v1/contratos?dataInicial=20260101&dataFinal=20260930&cnpjOrgao=01169416000109&pagina=1&tamanhoPagina=10

  • dataInicial e dataFinal — no formato AAAAMMDD, sem hífen.
  • cnpjOrgao — o CNPJ do órgão, só com dígitos. O da prefeitura está na tabela de entes do SICONFI.
  • pagina e tamanhoPagina — a página é obrigatória.

Para as licitações publicadas, o caminho é /api/consulta/v1/contratacoes/publicacao, com o CNPJ no parâmetro cnpj e a modalidade obrigatória em codigoModalidadeContratacao (6 é o pregão eletrônico). A especificação completa está na documentação oficial da API, em pncp.gov.br/api/consulta.

As armadilhas, verificadas

  • Data com hífen dá erro 422. É AAAAMMDD.
  • Período de no máximo 365 dias. Para mais, faça uma chamada por ano.
  • CNPJ com pontuação dá erro. Só dígitos.
  • O nome do parâmetro muda: cnpjOrgao em contratos, cnpj em contratações — e lá a modalidade é obrigatória; para ver todas, percorra as modalidades.
  • Lenta e com limite. A primeira chamada levou de 40 a 50 segundos na verificação, e pedidos seguidos receberam erro 429 (excesso). Use tempo limite de 60 segundos ou mais, pausa entre pedidos e nova tentativa. Lentidão não é ausência de dado.
  • Lista vazia tem dois sentidos. Pode ser que o órgão não contratou no período — ou que não publicou. Como a publicação é condição de eficácia, a segunda hipótese é ela mesma uma pergunta.

O roteiro, passo a passo

  1. Ache o CNPJ do órgão e escolha um período de até um ano.
  2. Puxe uma página e confira totalRegistros e totalPaginas antes de automatizar.
  3. Percorra as páginas com pausa, guardando a URL exata de cada uma.
  4. Monte o CSV: número de controle, objeto, valor global, data de assinatura, fim da vigência e a URL de origem.
  5. Confira em conferir pagamentos, em aditivos ou em fracionamento, conforme a pergunta; para desenhar, barras ou série temporal.

O que este dado não prova

  • Não prova irregularidade. Contrato grande, aditivo, repetição de fornecedor têm explicação comum na maior parte das vezes (sinal não é prova).
  • Não mostra a execução. O contrato diz o combinado; o pago está no portal de transparência do ente e nos relatórios fiscais.
  • Não é sobre pessoas. O roteiro é sobre o órgão e o contrato. Se a resposta trouxer dado de pessoa física, não o reproduza.

Encontrou um comportamento diferente? Escreva: a data da verificação está no topo.