Português
EspañolEnglishFilipinoPortuguês
Criar chave grátis
Peru — licitações · getTenderByOcid
OpenAPI

Consultar uma contratação por OCID

GET https://api.latinfo.dev/pe/oece/tenders/ocid/{ocid}

Retorna um registro compiledRelease do OCDS do OECE/SEACE por identificador OCID.

Contrato da fonte

Publicador
OECE, Peru
Cobertura
Processos OCDS de contratação publicados na cópia oficial importada.
Significado do registro
Processo OCDS completo por OCID; os sete campos do índice são uma projeção de busca, não o esquema da resposta HTTP.
Identificador
Consulte por ocid como texto, preservando zeros iniciais. O contrato abaixo define a sintaxe e normalização aceitas.
Padrão aceito
^ocds-dgv273-seacev[23]-
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 API remove as partes que são pessoas físicas; os documentos permanecem como links externos do publicador.
  • Use o esquema de resposta OCDS do OpenAPI. Os valores de processo ou orçamento não são automaticamente valores de contratos do fornecedor.
  • amount no índice de busca não tem moeda declarada independentemente. Os objetos amount/currency do OCDS completo são a referência autorizada.

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

ocidstringCaminhoobrigatório

Identificador de contratação aberta (OCID)

Example: ocds-dgv273-seacev3-2026-273-3

Exemplo de requisição

curl https://api.latinfo.dev/pe/oece/tenders/ocid/ocds-dgv273-seacev3-2026-273-3 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

200Registro compiledRelease do OCDS 1.1
Content-Type: application/json

Campos da resposta

ocid string

Identificador de contratação aberta (OCID)

date string

Data de compilação

date-time

url string

Link para o portal oficial do OECE

uri

buyer object
Campos internos
buyer.id string
buyer.name string
tender object
Campos internos
tender.title string

Título curto da licitação

tender.description string

Descrição completa da licitação

tender.datePublished string

date-time

tender.value object
Campos internos
tender.value.amount number
tender.value.currency string
tender.mainProcurementCategory string

goods · services · works

tender.procurementMethodDetails string
tender.tenderPeriod object
Campos internos
tender.tenderPeriod.startDate string

date-time

tender.tenderPeriod.endDate string

date-time

tender.items array
Campos internos
tender.items[].description string
tender.items[].statusDetails string

Estado por item do OECE/SEACE, preservado conforme publicado. É um vocabulário aberto da fonte, não o estado geral do contrato nem uma enumeração fechada.

tender.documents array
Campos internos
tender.documents[].title string
tender.documents[].url string

uri

awards array
Campos internos
awards[].status string
awards[].value object
Campos internos
awards[].value.amount number
awards[].value.currency string
awards[].suppliers array
Campos internos
awards[].suppliers[].name string
awards[].suppliers[].id string
contracts array
Campos internos
contracts[].status string
contracts[].value object
Campos internos
contracts[].value.amount number
contracts[].period object
Campos internos
contracts[].period.startDate string

date-time

contracts[].period.endDate string

date-time

planning object
Campos internos
planning.budget object
Campos internos
planning.budget.amount object
Campos internos
planning.budget.amount.amount number
planning.budget.amount.currency string
Esquema de resposta
{
  "type": "object",
  "description": "OCDS 1.1 compiledRelease record with Latinfo-added url field",
  "properties": {
    "ocid": {
      "type": "string",
      "description": "Open Contracting ID",
      "example": "ocds-dgv273-seacev3-2026-273-3"
    },
    "date": {
      "type": "string",
      "format": "date-time",
      "description": "Compilation date"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Link to official OECE portal",
      "example": "https://contratacionesabiertas.oece.gob.pe/proceso/ocds-dgv273-seacev3-2026-273-3"
    },
    "buyer": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "PE-CONSUCODE-273"
        },
        "name": {
          "type": "string",
          "example": "MUNICIPALIDAD DISTRITAL DE MORO"
        }
      }
    },
    "tender": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Short tender title"
        },
        "description": {
          "type": "string",
          "description": "Full tender description"
        },
        "datePublished": {
          "type": "string",
          "format": "date-time"
        },
        "value": {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "example": 64815.55
            },
            "currency": {
              "type": "string",
              "example": "PEN"
            }
          }
        },
        "mainProcurementCategory": {
          "type": "string",
          "enum": [
            "goods",
            "services",
            "works"
          ]
        },
        "procurementMethodDetails": {
          "type": "string",
          "example": "Concurso Público Abreviado"
        },
        "tenderPeriod": {
          "type": "object",
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date-time"
            },
            "endDate": {
              "type": "string",
              "format": "date-time"
            }
          }
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "type": "string"
              },
              "statusDetails": {
                "type": "string",
                "description": "OECE/SEACE item-level status text, preserved as published. This is an open publisher vocabulary, not an overall contract status or a closed enum.",
                "examples": [
                  "CONVOCADO",
                  "CONTRATADO",
                  "DESIERTO",
                  "NULO",
                  "CONSENTIDO"
                ]
              }
            }
          }
        },
        "documents": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      }
    },
    "awards": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "value": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "number"
              },
              "currency": {
                "type": "string"
              }
            }
          },
          "suppliers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "contracts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "value": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "number"
              }
            }
          },
          "period": {
            "type": "object",
            "properties": {
              "startDate": {
                "type": "string",
                "format": "date-time"
              },
              "endDate": {
                "type": "string",
                "format": "date-time"
              }
            }
          }
        }
      }
    },
    "planning": {
      "type": "object",
      "properties": {
        "budget": {
          "type": "object",
          "properties": {
            "amount": {
              "type": "object",
              "properties": {
                "amount": {
                  "type": "number"
                },
                "currency": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
400OCID inválido
Nenhum corpo de resposta documentado.
401Chave de api ausente ou inválida
Nenhum corpo de resposta documentado.
404OCID não encontrado
Nenhum corpo de resposta documentado.
429Limite de requisições excedido
Nenhum corpo de resposta documentado.
503Índice de contratação indisponível
Nenhum corpo de resposta documentado.
Exemplo JSON

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

{
  "ocid": "ocds-dgv273-seacev3-2026-273-3",
  "date": "2026-08-14T00:00:00Z",
  "url": "https://contratacionesabiertas.oece.gob.pe/proceso/ocds-dgv273-seacev3-2026-273-3",
  "buyer": {
    "id": "PE-CONSUCODE-273",
    "name": "MUNICIPALIDAD DISTRITAL DE MORO"
  },
  "tender": {
    "title": "string",
    "description": "string",
    "datePublished": "2026-08-14T00:00:00Z",
    "value": {
      "amount": 64815.55,
      "currency": "PEN"
    },
    "mainProcurementCategory": "goods",
    "procurementMethodDetails": "Concurso Público Abreviado",
    "tenderPeriod": {
      "startDate": "2026-08-14T00:00:00Z",
      "endDate": "2026-08-14T00:00:00Z"
    },
    "items": [
      {
        "description": "string",
        "statusDetails": "CONVOCADO"
      }
    ],
    "documents": [
      {
        "title": "string",
        "url": "https://example.gov/record"
      }
    ]
  },
  "awards": [
    {
      "status": "string",
      "value": {
        "amount": 1,
        "currency": "string"
      },
      "suppliers": [
        {
          "name": null,
          "id": null
        }
      ]
    }
  ],
  "contracts": [
    {
      "status": "string",
      "value": {
        "amount": 1
      },
      "period": {
        "startDate": "2026-08-14T00:00:00Z",
        "endDate": "2026-08-14T00:00:00Z"
      }
    }
  ],
  "planning": {
    "budget": {
      "amount": {
        "amount": 1,
        "currency": "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.

Esc