> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # SECOP > Contratação pública colombiana (SECOP II): processos, adjudicações, contratos com suas adições, garantias e plano de entregas, além de sanções a contratistas. Resolve registros de contratação pública colombiana do SECOP II (Sistema Electrónico de Contratación Pública), administrado pela Colombia Compra Eficiente. Dado o `noticeUID` de um processo, retorna o cabeçalho do processo, a lista de adjudicações por fornecedor e cada contrato adjudicado sob ele. Endpoints complementares buscam por fornecedor ou entidade, aprofundam em um contrato (com suas adições, garantias e plano de entregas) e listam as multas e sanções contra um contratista. Os dados provêm da publicação oficial dos registros do SECOP II da Colombia Compra Eficiente. Os contratos adjudicados são obtidos dos registros oficiais de contratos, que são a fonte autorizada de quem realmente ganhou (os campos de adjudicação do próprio registro do processo são atualizados com atraso). ## Processo por noticeUID `POST /co/secop/process/v1` | Campo | Tipo | Notas | | ------------ | ------ | -------------------------------------------------------------- | | `notice_uid` | string | **Obrigatório.** noticeUID do SECOP, p. ex. `CO1.NTC.9458505`. | ```bash theme={"dark"} curl https://api.croma.run/co/secop/process/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "notice_uid": "CO1.NTC.9458505" }' ``` O `noticeUID` é o identificador do aviso do processo, com o formato `CO1.NTC.` (p. ex. `CO1.NTC.9458505`). ## Contratos por fornecedor `POST /co/secop/contracts-by-provider/v1` Lista os contratos adjudicados a um fornecedor (cédula ou NIT) através de cada entidade contratante: o perfil do contratista. | Campo | Tipo | Notas | | ----------------- | ------ | ---------------------------------------------------------------------------------------------- | | `document_number` | string | **Obrigatório.** Cédula ou NIT do fornecedor (entre 4 e 20 caracteres alfanuméricos). | | `entity_nit` | string | Opcional. Apenas contratos com esta entidade contratante (dígitos, sem dígito de verificação). | | `from_date` | string | Opcional. Limite inferior da data de assinatura (`yyyy-mm-dd`, inclusive). | | `to_date` | string | Opcional. Limite superior da data de assinatura (`yyyy-mm-dd`, inclusive). | | `page` | number | Opcional. Página de 500, base 1 (por padrão 1). | ```bash theme={"dark"} curl https://api.croma.run/co/secop/contracts-by-provider/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "document_number": "79372917" }' ``` Retorna `document_number`, os filtros aplicados (`entity_nit`, `from_date`, `to_date`), `count`, `capped`, `contracts[]` (a mesma estrutura de contrato que abaixo) e um objeto `pagination` (`total`, `page_size`, `total_pages`, `page`). Páginas de 500, os mais recentes primeiro; quando `capped` é `true` a página está cheia, então solicite a próxima `page` ou restrinja a busca. ## Processos por entidade `POST /co/secop/processes-by-entity/v1` Lista os processos de contratação publicados por uma entidade contratante (por NIT), opcionalmente dentro de uma janela de data de publicação: a população a auditar de uma entidade. Retorna resumos leves; aprofunde em um deles com a consulta por noticeUID acima. | Campo | Tipo | Notas | | ----------------- | ------ | ---------------------------------------------------------------------------------- | | `document_number` | string | **Obrigatório.** NIT da entidade contratante (dígitos, sem dígito de verificação). | | `from_date` | string | Opcional. Limite inferior da data de publicação (`yyyy-mm-dd`, inclusive). | | `to_date` | string | Opcional. Limite superior da data de publicação (`yyyy-mm-dd`, inclusive). | | `page` | number | Opcional. Página de 500, base 1 (por padrão 1). | ```bash theme={"dark"} curl https://api.croma.run/co/secop/processes-by-entity/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "document_number": "899999061", "from_date": "2026-01-01" }' ``` Retorna `document_number`, `from_date`, `to_date`, `count`, `capped`, `processes[]` (cada um com `notice_uid`, `process_id`, `name`, `entity`, `entity_nit`, `modality`, `contract_type`, `base_price`, `phase`, `procedure_status`, `published_date` e `url`) e um objeto `pagination` (`total`, `page_size`, `total_pages`, `page`). Páginas de 500, os mais recentes primeiro; quando `capped` é `true` a página está cheia, então solicite a próxima `page`. ## Contrato por id `POST /co/secop/contract/v1` Resolve um contrato eletrônico pelo seu id e anexa seu histórico satélite: adições/modificações registradas, apólices de garantia e o plano de entregas com avanço planejado vs real. | Campo | Tipo | Notas | | ------------- | ------ | ---------------------------------------------------------------------- | | `contract_id` | string | **Obrigatório.** Id de contrato do SECOP, p. ex. `CO1.PCCNTR.6794799`. | ```bash theme={"dark"} curl https://api.croma.run/co/secop/contract/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "contract_id": "CO1.PCCNTR.6794799" }' ``` Retorna `found`, `contract_id`, `contract` (a mesma estrutura que `contracts[]` abaixo) e três listas, cada uma limitada a 200 com seu indicador `*_capped`: | Lista | Campos | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `additions[]` | `addition_id`, `type`, `description`, `registered_date`. | | `guarantees[]` | `insurer`, `policy_number`, `insured`, `beneficiary`, `policy_created_date`, `policy_sent_date`, `policy_end_date`, `policy_side`, `status`, `policy_type`, `policy_subtype`, `value`, `created_date`. | | `execution_items[]` | `execution_type`, `plan_name`, `expected_delivery_date`, `expected_progress_percent`, `actual_delivery_date`, `actual_progress_percent`, `contract_status`, `item_reference`, `description`, `unit`, `awarded_quantity`, `planned_quantity`, `received_quantity`, `pending_quantity`, `created_date`. | ## Sanções por fornecedor `POST /co/secop/sanctions-by-provider/v1` Lista as multas e sanções registradas contra um contratista do Estado. Os registros cobrem desde 2010 até o presente. | Campo | Tipo | Notas | | ----------------- | ------ | -------------------------------------------------------------------------------------- | | `document_number` | string | **Obrigatório.** Cédula ou NIT do contratista (entre 4 e 20 caracteres alfanuméricos). | ```bash theme={"dark"} curl https://api.croma.run/co/secop/sanctions-by-provider/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "document_number": "1067811412" }' ``` Retorna `document_number`, `count`, `capped` e `sanctions[]`, cada uma com `entity`, `entity_nit`, `entity_level`, `entity_order`, `municipality`, `resolution_number`, `provider`, `contract_number`, `sanction_value`, `published_date`, `final_date` (data de firmeza) e `url`. ## Resposta | Campo | Notas | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | `found` | `true` quando um processo coincide com o noticeUID; `false` deixa `process` em null e `contracts` vazio. | | `notice_uid` | O noticeUID consultado. | | `process` | O cabeçalho do processo (ver abaixo). | | `awards` | Linhas de adjudicação por fornecedor (ver abaixo), limitadas a 500. | | `awards_capped` | `true` quando a lista de adjudicações atingiu seu limite; `process.awarded_value`/`award_count` continuam sendo a fonte autorizada. | | `contract_count` | Número de contratos adjudicados associados. | | `contracts_capped` | `true` quando a lista de contratos atingiu seu limite e pode estar incompleta. | | `contracts` | Os contratos adjudicados (ver abaixo). | ### `process` | Campo | Notas | | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `process_id`, `portfolio_id` | Ids do SECOP (`CO1.REQ.*`, `CO1.BDOS.*`). | | `reference` | Número do processo (referência interna da entidade). | | `name`, `description` | Nome e descrição do procedimento. | | `entity`, `entity_nit`, `entity_department`, `entity_city`, `entity_order` | Entidade contratante. | | `procurement_unit`, `procurement_unit_city` | Unidade de contratação. | | `modality`, `modality_justification` | Modalidade de contratação. | | `contract_type`, `contract_subtype` | Tipo / subtipo de contrato. | | `unspsc_code`, `additional_categories` | Códigos de categoria UNSPSC. | | `duration`, `duration_unit`, `lots` | Duração e número de lotes. | | `base_price` | Preço base estimado (COP). | | `phase`, `status_summary`, `procedure_status`, `opening_status` | Fase e estados. | | `published_date`, `last_published_date` | Datas de publicação (`yyyy-mm-dd`). | | `bid_deadline` | Data limite de recebimento de ofertas. | | `awarded`, `awarded_value`, `award_count`, `award_date` | Indicador de adjudicação, valor total adjudicado entre todas as adjudicações, quantas são e a data de adjudicação (atualizado com atraso; `contracts` é a fonte autorizada). | | `invited_providers`, `directly_invited_providers`, `interested_providers` | Métricas do funil de fornecedores. | | `responses`, `external_responses`, `offer_responses`, `unique_responding_providers`, `views` | Métricas de participação. | | `url` | A página OpportunityDetail. | ### `awards[]` Uma linha por fornecedor adjudicado (os acordos-quadro adjudicam a muitos): | Campo | Notas | | ------------------------------------------- | ------------------------------------------------------------ | | `provider`, `provider_nit`, `provider_code` | O fornecedor adjudicado. | | `provider_department`, `provider_city` | Localização do fornecedor. | | `awarded_value` | A parcela deste fornecedor na adjudicação do processo (COP). | | `award_date` | Data de adjudicação. | ### `contracts[]` | Campo | Notas | | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | `contract_id`, `reference` | Id de contrato do SECOP (`CO1.PCCNTR.*`) e referência. | | `entity`, `entity_nit`, `centralized_entity` | Entidade contratante (`Centralizada`/`Descentralizada`). | | `provider`, `provider_document`, `provider_document_type`, `provider_code` | O fornecedor adjudicado. | | `is_sme`, `is_group` | É PME / estrutura plural (unión temporal, consórcio). | | `legal_rep_name`, `legal_rep_document_type`, `legal_rep_document` | Representante legal e seu documento de identidade. | | `status`, `contract_type`, `object` | Estado, tipo e objeto do contrato. | | `modality`, `modality_justification` | Modalidade de contratação do contrato (contratação direta vs licitação). | | `unspsc_code` | Código de categoria UNSPSC. | | `delivery_conditions` | Condições de entrega. | | `value` | Valor do contrato (COP). | | `invoiced_value`, `paid_value`, `pending_execution_value`, `pending_payment_value` | Montantes de execução. | | `advance_payment_enabled`, `advance_payment_value`, `amortized_value`, `pending_amortization_value` | Pagamento antecipado e sua amortização. | | `sign_date`, `start_date`, `end_date`, `added_days`, `duration` | Cronograma do contrato. | | `can_be_extended`, `extension_notice_date` | Prorrogação e sua data de notificação. | | `requires_liquidation`, `liquidation_start_date`, `liquidation_end_date` | Etapa de liquidação e sua janela. | | `has_environmental_obligation`, `has_post_consumption_obligations`, `has_reversion` | Indicadores de obrigações contratuais. | | `location` | Localização. | | `supervisor`, `expense_orderer`, `funding_origin`, `expense_destination` | Supervisão, origem dos recursos, destino do gasto (`Inversión`/`Funcionamiento`). | | `sector`, `branch`, `updated_date` | Setor, ramo, última atualização. | Os valores vazios ou de preenchimento são normalizados para `null`. Os campos monetários e de contagem são números; as datas são `yyyy-mm-dd`. Um processo também tem seções disponíveis apenas no próprio site do SECOP (Documentos Tipo, Cuestionario, Observaciones, downloads de documentos) ou em outros registros do SECOP (plano anual de aquisições, detalhe do orçamento). Essas não fazem parte destas respostas. Esquemas, campos de resposta e um playground interativo.