Documentación de Compras Transparentes API

Compras Transparentes es un repositorio de datos de Mercadopublico. La API REST de Compras Transparentes permite explorar y extraer información de este repositorio.

Licitación

GET /licitacion

Obtiene informacion de todas las licitaciones.

Permite filtrar y paginar los resultados. El paginamiento es de 10 elementos por pagina y es obligatorio.

Nota: Para usar un mismo filtro con diferentes valores, se debe usar el parametro tantas veces como sea necesario. e.g.: ?organismo=6&organismo=8. El filtro se aplicara usando la disyuncion de los valores. i.e.: ... organismo = 6 OR organismo = 8. El filtro q no puede ser usado de esta forma.

Nota: El paginamiento es obligatorio para evitar que una consulta retorne tantos reultados que puedan perjudicar el rendimiento del sistema.

Los parametros aceptados son:

Filtros

Parámetro Ejemplo Descripción
q clavos y martillos Busqueda de texto
categoria_producto 1 Por categorias de sus items
producto 1 Por productos en sus items
estado 1 Por su estado
monto 1000|2000 Por el monto adjudicado
fecha_publicacion 20140101|20141231 Por fecha de publicacion
fecha_cierre 20140101|20141231 Por fecha de cierre
fecha_adjudicacion 20140101|20141231 Por fecha de adjudicacion
organismo 1 Por organismo emisor
proveedor 1 Por proveedor adjudicado

Modificadores

Parámetro Ejemplo Descripción
orden fecha_publicacion Ordenar los resultados
pagina 1 Paginar y entregar la pagina solicitada
Parameters:
  • req – Falcon request object
  • resp – Falcon response object
Return:

Example Request:

GET /licitacion/
Host: example.com

Example Response:

{
    "licitaciones": [
        {
          "id": 353559,
          "codigo": "2216-2-LP14",

          "nombre": "AIT EXPLOTACION CENTRO METROPOLITANO DE VEHICULOS ",
          "descripcion": "El presente contrato de asesoría está diseñado para prestar el apoyo necesario con que debe contar el Inspector Fiscal del contrato de concesión, para dar cumplimiento a las pertinentes labores de supervisión y control del contrato de concesión Asesoría de Inspección Técnica a la Explotación de la Obra Centro Metropolitano de Vehículos Retirados de Circulación.",

          "organismo": {
            "categoria": "Ministerio de Obras Públicas",
            "id": 1,
            "nombre": "Administración Sistema de Concesiones"
          }

          "fecha_publicacion": "2014-05-13T17:02:00",
          "fecha_cierre": "2014-07-21T15:00:00",
          "fecha_adjudicacion": "2014-09-25T10:51:40.603",

          "estado": 8,
          "fecha_cambio_estado": "2014-09-25",

          "n_items": 1,

          "adjudicacion": {
            "acta": "http://www.mercadopublico.cl/Procurement/Modules/RFB/StepsProcessAward/PreviewAwardAct.aspx?qs=HsgAuqRzknYHyGc0FNmZdu2Wah4RoSQqKlwvCxeZv7c=",
            "monto": 1503000000,
            "n_items": 1
          },
        },
        [...]
    ],
    "n_licitaciones": 104
}
GET /licitacion/<licitacion_id>

Obtiene la informacion sobre una licitacion en particular

Parámetro de URL Ejemplo Descripción
licitacion_id 353559 ID de licitación

Example Request:

GET /licitacion/353559
Host: example.com

Example Response:

{
    "id": 353559,
    "codigo": "2216-2-LP14",

    "nombre": "AIT EXPLOTACION CENTRO METROPOLITANO DE VEHICULOS ",
    "descripcion": "El presente contrato de asesoría está diseñado para prestar el apoyo necesario con que debe contar el Inspector Fiscal del contrato de concesión, para dar cumplimiento a las pertinentes labores de supervisión y control del contrato de concesión Asesoría de Inspección Técnica a la Explotación de la Obra Centro Metropolitano de Vehículos Retirados de Circulación.",

    "organismo": {
      "id": 1,
      "categoria": "Ministerio de Obras Públicas",
      "nombre": "Administración Sistema de Concesiones"
    },

    "unidad": {
      "nombre": "MOP Administración Sistema de Concesiones",
      "rut": "61.202.000-0",
      "region": "Región Metropolitana de Santiago",
      "comuna": "Santiago Centro",
      "direccion": "Morande 71, Piso 1, Ventanilla Unica DCyF"
    },

    "usuario": {
      "cargo": "Jefe Unidad de Abastecimiento",
      "nombre": "Pablo Ubeda Alarcón",
      "rut": "13.555.350-6"
    },

    "responsable_contrato": {
      "nombre": "Juan Carlos Gonzalez Vidaurrazaga",
      "telefono": "56-02-4496860-6860",
      "email": "juan.gonzalez.v@mop.gov.cl"
    },

    "responsable_pago": {
      "nombre": "Juan Carlos Gonzalez Vidaurrazaga",
      "email": "juan.gonzalez.v@mop.gov.cl",
    },

    "estado": 8,
    "fecha_cambio_estado": "2014-09-25",

    "fecha_creacion": "2014-04-22T12:53:27.463",
    "fecha_publicacion": "2014-05-13T17:02:00",
    "fecha_inicio": "2014-05-13T18:00:00",
    "fecha_final": "2014-06-20T16:00:00",
    "fecha_cierre": "2014-07-21T15:00:00",
    "fecha_adjudicacion": "2014-09-25T10:51:40.603",

    "n_items": 1,

    "adjudicacion": {
      "n_items": 1,
      "monto": 1503000000,
      "acta": "http://www.mercadopublico.cl/Procurement/Modules/RFB/StepsProcessAward/PreviewAwardAct.aspx?qs=HsgAuqRzknYHyGc0FNmZdu2Wah4RoSQqKlwvCxeZv7c=",
    },

    "categorias": [
      {
        "id": 53,
        "nombre": "Servicios profesionales, administrativos y consultorías de gestión empresarial"
      }
    ],
}
GET /licitacion/<licitacion_id>/item

Obtiene todos los items para una licitacion en particular.

Parámetro de URL Ejemplo Descripción
licitacion_id 353559 ID de licitación

Example Request:

GET /licitacion/353559/item
Host: example.com

Example Response:

{
    "n_items": 1,
    "items": [
      {
        "adjudicacion": {
          "cantidad": 1,
          "monto_unitario": 1503000000,
          "monto_total": 1503000000,

          "fecha": "2014-09-25T10:51:40.603",

          "proveedor": {
            "id": 4074,
            "nombre": "Zañartu Ingenieros Consultores Limitada",
            "rut": "79.511.210-3"
          }
        },

        "codigo_categoria": 80101600,
        "nombre_categoria": "Servicios profesionales, administrativos y consultorías de gestión empresarial / Consultorías o asesorías en gestión empresarial / Gestión de proyectos",

        "codigo_producto": 80101604,
        "nombre_producto": "Asesorías en gestión de proyectos",

        "descripcion": "AIT Explotación de la Obra Centro Metropolitano de Vehículos Retirados de Circulación.",

        "unidad": "Unidad"
        "cantidad": 1,
      },
      [...]
    ]
}

Organismo

GET /organismo

Obtiene informacion de todos los organismos.

Permite filtrar y paginar los resultados.

El paginamiento es de 10 elementos por pagina y es opcional.

Nota: Para usar un mismo filtro con diferentes valores, se debe usar el parametro tantas veces como sea necesario. e.g.: ?organismo=6&organismo=8. El filtro se aplicara usando la disyuncion de los valores. i.e: ... organismo = 6 OR organismo = 8. El filtro q no puede ser usado de esta forma.

Nota: El campo monto_adjudicado de la respuesta solo tiene un valor si se ha usado el filtro monto_adjudicado en el request, si no, es null.

Los parametros aceptados son:

Filtros

Parámetro Ejemplo Descripción
q clavos y martillos Busqueda de texto
organismo 1 Por ID de organismo
fecha_adjudicacion 20140101|20141231 Por fecha de adjudicacion de licitaciones
proveedor_adjudicado 1 Por ID de proveedores que han sido adjudicados en sus licitaciones
n_licitaciones_adjudicadas 10|20 Por cantidad de licitaciones adjudicadas
monto_adjudicado 10000|1000000 Por monto adjudicado en sus licitaciones

Modificadores

Parámetro Ejemplo Descripción
orden monto_adjudicado Ordenar los resultados
pagina 1 Paginar y entregar la pagina solicitada

Example Request:

GET /organismo
Host: example.com

Example Response:

{
  "n_organismos": 5,
  "organismos": [
    {
      "id": 5,
      "categoria": "Ministerio de Defensa Nacional",
      "nombre": "Armada de Chile"
      "monto_adjudicado": 45539582,
    },
    [...]
  ]
}
GET /organismo/<organismo_id>

Obtiene la informacion de un organismo en particular

Parámetro de URL Ejemplo Descripción
organismo_id 5 ID de organismo

Example Request:

GET /organismo/5
Host: example.com

Example Response:

{
  "id": 5,
  "categoria": "Ministerio de Defensa Nacional",
  "nombre": "Armada de Chile"
}
GET /organismo/<organismo_id>/licitacion

Obtiene la lista de licitaciones de un organismo en particular.

Permite paginar el resultado.

Modificadores

Parámetro Ejemplo Descripción
pagina 1 Paginar y entregar la pagina solicitada

Example Request:

GET /organismo/5/licitacion
Host: example.com

Example Response:

{
    "n_licitaciones": 13603,
    "licitaciones": [
        {
            "id": 154586,
            "codigo": "3084-15-L115",

            "nombre": "ADQUISICION PLANTA AIRE ACONDICIONADO",
            "descripcion": "NECESIDADES DE ESTA DIRECCION TECNICA.",

            "fecha_publicacion": "2015-07-09T16:17:06.497",
            "fecha_cierre": "2015-07-24T17:00:00",
            "fecha_adjudicacion": "2015-07-31T11:04:42.137",

            "estado": 8,
            "fecha_cambio_estado": "2015-07-31",

            "n_items": 1,

            "adjudicacion": {
                "acta": "http://www.mercadopublico.cl/Procurement/Modules/RFB/StepsProcessAward/PreviewAwardAct.aspx?qs=YgiADKwHPbuZUJQe+lyvls8XcOhFocIUA1RDXdbkWY0=",
                "monto": 588235,
                "n_items": 1
            }
        },
       [...]
    ]
}

Proveedor

GET /proveedor

Obtiene informacion de todos los proveedores.

Permite filtrar y paginar los resultados.

El paginamiento es de 10 elementos por pagina y es opcional.

Nota: Para usar un mismo filtro con diferentes valores, se debe usar el parametro tantas veces como sea necesario. e.g.: ?proveedor=6&proveedor=8. El filtro se aplicara usando la disyuncion de los valores. i.e: ... proveedor = 6 OR proveedor = 8. El filtro q no puede ser usado de esta forma.

Nota: El campo monto_adjudicado de la respuesta solo tiene un valor si se ha usado el filtro monto_adjudicado en el request, si no, es null.

Los parametros aceptados son:

Filtros

Parámetro Ejemplo Descripción
q clavos y martillos Busqueda de texto
proveedor 1 Por ID de proveedor
fecha_adjudicacion 20140101|20141231 Por fecha de adjudicacion de licitaciones
organismo_adjudicador 1 Por ID de organismos que han les concedido licitaciones
n_licitaciones_adjudicadas 10|20 Por cantidad de licitaciones adjudicadas
monto_adjudicado 10000|1000000 Por monto adjudicado en licitaciones

Modificadores

Parámetro Ejemplo Descripción
orden monto_adjudicado Ordenar los resultados
pagina 1 Paginar y entregar la pagina solicitada

Example Request:

GET /proveedor
Host: example.com

Example Response:

{
  "n_proveedores": 120,
  "proveedores": [
    {
      "id": 5,
      "nombre": "TITO DEL CARMEN NAVARRO NAVARRO",
      "rut": "5.280.062-5",
      "monto_adjudicado": 55843146
    },
    [...]
  ]
}
GET /proveedor/<proveedor_id>

Obtiene la informacion de un proveedor en particular

Parámetro de URL Ejemplo Descripción
proveedor_id 5 ID de proveedor

Example Request:

GET /proveedor/5
Host: example.com

Example Response:

{
  "id": 5,
  "nombre": "TITO DEL CARMEN NAVARRO NAVARRO",
  "rut": "5.280.062-5"
}
GET /proveedor/<proveedor_id>/licitacion

Obtiene la lista de licitaciones de un proveedor en particular.

Permite paginar el resultado.

Permite paginar el resultado.

Modificadores

Parámetro Ejemplo Descripción
pagina 1 Paginar y entregar la pagina solicitada

Example Request:

GET /proveedor/5/licitacion
Host: example.com

Example Response:

{
  "n_licitaciones": 26,
  "licitaciones": [
    {
      "id": 11,
      "codigo": "1037-24-L115",

      "nombre": "Servicio de instalación de portón metálico de corr",
      "descripcion": "Servicio de instalación de portón metálico de corredera en Centro de Acopio de Plantas Chin Chin, CONAF  Región de Los Lagos",

      "organismo": {
        "categoria": "Ministerio de Agricultura",
        "id": 58,
        "nombre": "Corporación Nacional Forestal"
      },

      "fecha_adjudicacion": "2015-08-10T16:39:48.993",
      "fecha_cierre": "2015-08-03T15:30:00",
      "fecha_publicacion": "2015-07-27T14:48:53.663",

      "estado": 8,
      "fecha_cambio_estado": "2015-08-10",

      "n_items": 1,

      "adjudicacion": {
        "n_items": 1
        "monto": 898336,
        "acta": "http://www.mercadopublico.cl/Procurement/Modules/RFB/StepsProcessAward/PreviewAwardAct.aspx?qs=777qvIf9crWklR5ZKx61vChI9x6UqF8mhgoiWY+N3uE=",
      }
    },
    [...]
  ]
}