MercadoPublico Chile — CompraAgil Procurements

Access Chilean CompraAgil quick-purchase procurement data from MercadoPublico.cl. Extract procurements by status, filter by organization, and retrieve attached documents.

What is CompraAgil?

CompraAgil is Chile's fast-track public procurement mechanism for low-value purchases. Buying organizations publish purchase orders directly to registered suppliers, bypassing the full tender process. Each procurement is identified by a XXXX-X-COT26 code.

Actions

This Actor supports three actions:

Action	Description	Required inputs
list-compraagil	Paginated list of procurements filtered by status	status
get-compraagil	Single procurement by COT code	entityId
list-files	Attached documents for a procurement	entityId

---

Input Parameters

Parameter	Type	Required	Description
action	string	Yes	One of list-compraagil, get-compraagil, list-files
entityId	string	Conditional	CompraAgil code, e.g. COT-12345. Required for get-compraagil and list-files
status	string	Conditional	Procurement status. Required for list-compraagil
organization	string	No	Filter by organization name (partial match)
maxItems	integer	No	Maximum records to return. Default: 100, max: 10000

Status values

Value	Description
Publicada	Open — accepting quotes from suppliers
Cerrada	Closed — no longer accepting quotes
Adjudicada	Awarded — supplier selected
Cancelada	Cancelled by the buying organization
Anulada	Annulled

---

Usage Examples

List open procurements

{
  "action": "list-compraagil",
  "status": "Publicada",
  "maxItems": 200
}

List awarded procurements from a specific organization

{
  "action": "list-compraagil",
  "status": "Adjudicada",
  "organization": "Municipalidad",
  "maxItems": 500
}

Get a single procurement by COT code

{
  "action": "get-compraagil",
  "entityId": "3888-244-COT26"
}

List attached files for a procurement

{
  "action": "list-files",
  "entityId": "3888-244-COT26"
}

---

Output

Results are stored in the Actor's default dataset. Each record type has its own shape.

CompraAgil record (list-compraagil, get-compraagil)

{
  "id": 5261174,
  "codigo": "3888-244-COT26",
  "nombre": "Arreglo Carpa Chica",
  "organismo": "Ilustre Municipalidad de San Juan de la Costa",
  "unidad": "Administración y Finanzas",
  "fecha_apertura": "2026-03-12 16:27:18.087",
  "fecha_publicacion": "2026-03-12 16:27:18.087",
  "fecha_cierre": "2026-05-12 16:30:00.0",
  "fecha_cierre_primer_llamado": "2026-05-12T20:30:00.000+00:00",
  "fecha_cierre_segundo_llamado": "2026-07-12T20:32:41.913+00:00",
  "id_estado": 2,
  "estado": "Publicada",
  "estado_convocatoria": "Primer Llamado",
  "monto_disponible": 650000,
  "moneda": "CLP",
  "ofertas_recibidas": 0,
  "descripcion": "servicio de Arreglo de Carpa Municipal segun documento adjunto",
  "direccion": "a Convenir, San Juan de La Costa, Región de los Lagos",
  "monto_moneda": "650,000",
  "monto_total_estimado": "9",
  "plazo_entrega": 5,
  "es_multa_sancion": 1,
  "institucion_empresa": "Ilustre Municipalidad de San Juan de la Costa",
  "institucion_organizacion": "Administración y Finanzas",
  "institucion_rut": "69.251.800-4",
  "convocatoria": "Primer Llamado",
  "segundo_automatico": "Activo",
  "segundo_manual": "No Activo",
  "priorizado": "EMPRESA NO PRIORIZADA - PRIMER LLAMADO",
  "requisitos_medioambientales": 0,
  "requisitos_impacto_social": 0,
  "productos": [
    {
      "id": 37534978,
      "codigoProducto": 30221001,
      "idCategoria": 30221000,
      "cantidad": 1,
      "descripcion": "servicio de Arreglo de Carpa Municipal segun documento adjunto",
      "unidad": {
        "codigo": "EA",
        "nombre": "Unidad"
      },
      "nombre": "Carpas"
    }
  ],
  "region": "Región de los Lagos",
  "comuna": "San Juan de La Costa",
  "region_id": 10,
  "comuna_id": 10207,
  "motivo_cancelacion": null,
  "tipo_cancelacion": null,
  "created_at": "2026-03-12 19:27:46",
  "updated_at": "2026-03-12 19:28:51"
}

File record (list-files)

{
  "compraagil_codigo": "COT-12345678",
  "file_name": "especificaciones.pdf",
  "file_url": "https://...",
  "file_type": "pdf",
  "created_at": "2025-03-01T10:05:00Z"
}

---

Notes

• list-compraagil requires a status filter — open-ended queries without a status are not supported.
• organization is a case-insensitive partial match (e.g. "Municipalidad" will match any organization whose name contains that string).
• The Actor paginates automatically and will keep fetching until maxItems is reached or there are no more records.
• All monetary amounts (monto_disponible) are in Chilean Pesos (CLP).
• Dates follow the format returned by MercadoPublico (mixed ISO 8601 and YYYY-MM-DD HH:MM:SS).