Buscar em cce · secop-procurement
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.
Parâmetros
qstringConsultaobrigatórioConsulta 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-AtData de importação, diferente da data do dado governamental.
X-Source-Updated-AtData 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-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Credits-CostCréditos efetivamente cobrados por esta solicitação.
X-Source-GenerationGeração opaca e imutável da fonte. Siga o Link protegido da próxima página ao obter um histórico.
application/jsonCampos da resposta
[].id string[].search_blob stringTexto 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 stringEstado 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.
401Chave de API ausente ou inválida. Autentique-se antes de tentar novamente.
404Sem registro publicado ou identificador fora do escopo de pessoas jurídicas. Não prova que a empresa não existe.
429Limite de solicitações ou créditos excedido. Verifique a resposta e os cabeçalhos de limite antes de tentar novamente.
503Fonte indisponível. Informe indisponibilidade, não um resultado vazio.
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.