Colômbia · co_cce_secop_procurement_search
OpenAPI

Buscar em cce · secop-procurement

GET https://api.latinfo.dev/co/cce/secop-procurement/search

Busque no índice publicado de search_blob. Os resultados são candidatos, não identidades confirmadas. Confirme país e identificador antes de consultar o perfil. Uma lista vazia não prova ausência. Para uma verificação reproduzível, consulte o exemplo documentado desta fonte e use como q uma palavra completa de pelo menos três letras, separada por espaços, do seu valor de search_blob. Escolha uma palavra apenas com letras; evite texto de origem danificado ou palavras parciais e limite q a 200 caracteres. A busca retorna uma lista limitada de candidatos, não uma exportação exaustiva. Os nomes e o texto de status dos candidatos podem estar truncados. Consulte o registro da fonte para obter os dados completos e interpretar seu vocabulário de status; não classifique uma empresa apenas pelo texto do candidato.

Contrato da fonte

Publicador
Colombia Compra Eficiente
Cobertura
Processos publicados do SECOP II incluídos no snapshot preparado; exclui SECOP I e o conjunto de propostas. Não constitui um histórico completo de contratos.
Significado do registro
Um processo de contratação no espaço de nomes REQ. Os contratos são vinculados pelo identificador de portfólio BDOS; quando vários contratos correspondem, apenas um contrato selecionado é mantido.
Identificador
Use o identificador público do processo, por exemplo CO1.REQ.100001. coSecopProcess o normaliza para o identificador armazenado, com a parte numérica primeiro e zeros à esquerda. Os resultados de busca mostram o identificador armazenado; converta-o para o formato público documentado antes de consultar.
Padrão aceito
^CO\d\.REQ\.\d{1,10}$
Normalização
coSecopProcess
Quantidade de registros
one
Licença
A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

  • A identidade empresarial é determinada por uma regra revisada sobre o formato do NIT; não é confirmação no RUES nem prova da situação jurídica atual.
  • Os nomes e documentos de contratados e adjudicatários pessoas físicas e os endereços desses contratados são ocultados; o texto livre afetado também é limpo. Campos vazios podem representar dados ausentes, não vinculados ou ocultados e não comprovam um resultado negativo.
  • Apenas um contrato é selecionado por portfólio; seus valores não somam todos os contratos relacionados. bidder_count conta NIT distintos com formato empresarial, não todas as propostas ou participantes.
  • As datas dos processos e contratos são registros de tempo do publicador, nunca a data da importação. Os sufixos numéricos das datas de fase são nomes originais de campos, não uma cronologia inferida.
  • Os valores monetários em texto preservam os montantes originais em COP, sem mudança de escala ou conversão. Nenhuma categoria financeira é inferida para o campo truncado valor_pendiente_de.
  • duracion usa a unidad_de_duracion original; duracion_del_contrato é texto do publicador sem interpretação. Os campos de fontes de financiamento são indicadores, não valores monetários.
  • Os campos PPI, PCI, pontos do acordo e pilares do acordo são preservados sem expandir abreviaturas ou categorias não documentadas.
  • Os dados, estados e ocultações por privacidade da fonte não comprovam ausência de impedimentos legais, elegibilidade, propriedade ou cobertura completa de contratações públicas.

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

qstringConsultaobrigatório

Consulta de nome, de 3 a 200 caracteres.

Exemplo de requisição

curl https://api.latinfo.dev/co/cce/secop-procurement/search?q=q \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

200Registros publicados da fonte. Dados ausentes não comprovam ausência de riscos nem um resultado negativo.

Cabeçalhos da resposta

X-Latinfo-Imported-At

Data de importação, diferente da data do dado governamental.

X-Source-Updated-At

Data de atualização do publicador, quando conhecida.

X-Latest-Observation-At

Última data de observação nesta página, quando conhecida. Para o histórico paginado completo, preserve a data de cada página ou use a maior entre todas. Nunca use a data de importação como data do dado.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Créditos efetivamente cobrados por esta solicitação.

X-Source-Generation

Geração opaca e imutável da fonte. Siga o Link protegido da próxima página ao obter um histórico.

Content-Type: application/json

Campos da resposta

[].id string
[].search_blob string

Texto de busca formado pelo título e pela descrição do processo com ocultações e pela entidade contratante, limitado a 2000 caracteres; não é o documento original completo.

[].estado_del_procedimiento string

Estado original do processo; não é um estado de conformidade ou tributário da empresa.

Esquema de resposta
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "search_blob": {
        "type": "string",
        "description": "Search text assembled from redacted process title, description and buying entity, capped at 2000 characters; not the complete original document.",
        "x-latinfo-meaning": "text"
      },
      "estado_del_procedimiento": {
        "type": "string",
        "description": "Original process status; not a company compliance or tax status.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}
400Identificador ou consulta inválidos. Corrija a entrada antes de tentar novamente.
Nenhum corpo de resposta documentado.
401Chave de API ausente ou inválida. Autentique-se antes de tentar novamente.
Nenhum corpo de resposta documentado.
404Sem registro publicado ou identificador fora do escopo de pessoas jurídicas. Não prova que a empresa não existe.
Nenhum corpo de resposta documentado.
429Limite de solicitações ou créditos excedido. Verifique a resposta e os cabeçalhos de limite antes de tentar novamente.
Nenhum corpo de resposta documentado.
503Fonte indisponível. Informe indisponibilidade, não um resultado vazio.
Nenhum corpo de resposta documentado.
Exemplo JSON

Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.

[
  {
    "id": "string",
    "search_blob": "string",
    "estado_del_procedimiento": "string"
  }
]

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.