Pular para o texto
lets-work Docs

Entrar

Operação

Coleta do PNCP

A coleta é o processo que busca no PNCP as contratações com proposta aberta e guarda no banco do lets-work.

O que é

O PNCP (Portal Nacional de Contratações Públicas) é o portal do governo federal onde os órgãos públicos publicam as contratações. O lets-work lê a consulta pública de contratações com proposta aberta.

As oportunidades e os itens do PNCP são compartilhados: uma coleta serve a todas as empresas do lets-work. O que muda de uma empresa para outra são os perfis, as notas e as análises.

Quando roda

  • Todo dia às 04:00, no horário de Campo Grande, de forma automática.
  • Quando alguém pede, na página Coleta.

Como funciona

  1. A coleta junta as UFs e as modalidades de todos os perfis ativos, de todas as empresas.
  2. Ela passa UF por UF, começando por MS e PR, e modalidade por modalidade, página por página, com 50 contratações por página.
  3. Ela guarda cada contratação nova e atualiza as que já existiam.
  4. No fim, ela consulta os itens das oportunidades que casaram com algum perfil e ainda não tinham os itens. É assim que o lets-work sabe se há participação exclusiva, cota ou subcontratação para ME/EPP.

A consulta nacional do PNCP devolve erro, por isso a coleta vai UF por UF.

Coleta educada

O PNCP é um serviço público. O lets-work consulta devagar para não pesar:

  • uma consulta a cada 1,5 segundo;
  • uma consulta por vez, nunca em paralelo;
  • quando o PNCP responde 429 (muitas consultas), espera 60 segundos e dobra o intervalo, até 12 segundos;
  • quando o PNCP responde com erro do servidor, tenta de novo algumas vezes, com espera.

A análise de um edital baixa os documentos no mesmo ritmo, e a cada 3 segundos quando há uma coleta rodando.

Por causa desse ritmo, uma coleta do Brasil inteiro demora: o tempo depende de quantas contratações estão abertas.

Rodar uma coleta agora

  1. Abra Coleta na barra.
  2. Em Onde, escolha UFs dos perfis ativos ou uma UF só.
  3. Clique em Iniciar coleta.
  4. Acompanhe o progresso. A tela se atualiza a cada 3 segundos e mostra páginas, registros, consultas e erros.

Só roda uma coleta por vez. Se já existe uma em andamento, a página mostra o progresso dela em vez do botão.

O histórico de coletas

A página Coleta lista as coletas recentes, com início, fim, estado (em andamento, concluída ou falhou), registros e erros. Quando há erros, a mensagem aparece junto.

O que esperar

  • Depois de uma coleta, a lista de Oportunidades já mostra o que chegou.
  • Uma página com erro não para a coleta: ela segue para a próxima e conta o erro.
  • Se o processo da coleta parar no meio, ela aparece como "falhou", com a mensagem "Processo da coleta parou sem concluir".
  • Uma UF ou modalidade que você acabou de pôr num perfil só traz contratações depois da próxima coleta.