Documentación de Ordenes de Compra

Diccionario de Datos - Órdenes de Compra
Api.Mercadopublico.cl
1. INTRODUCCION
Api.mercadopublico.cl permite consumir información de Licitaciones y Órdenes de
Compra generadas en la plataforma de compras públicas de ChileCompra,
www.mercadopublico.cl, donde 850 organismos del Estado chileno compran bienes y
servicios a más de 118.000 proveedores del Estado, el 91% de los cuales son micro y
pequeñas empresas
Para conocer los datos de una Ordenes de Compra a través de este servicio, ya sea
enviada a proveedor, aceptada, cancelada, Recepcion Conforme, pendiente de
recepcionar, recepcionada parciamente, recepcion conforme imcompleta, se debe
acceder a api.mercadopublico.cl el cual fue implementada para que las URLs puedan ser
utilizadas mediante parámetros GET, con el objetivo de indicar las características de la
petición que se ejecuta con los siguientes formatos disponibles;
- Formato XML
http://api.mercadopublico.cl/servicios/v1/publico/OrdenCompra.xml?codigo=[Codigo
orden de Compra]&ticket=[Ticket de Acceso]
- Formato JSON
http://api.mercadopublico.cl/servicios/v1/publico/OrdenCompra.json?codigo=[Codigo
orden de Compra]&ticket=[Ticket de Acceso]
- Formato JSONP
http://api.mercadopublico.cl/servicios/v1/publico/OrdenCompra.jsonp?codigo=[Codigo
orden de Compra]&ticket=[Ticket de Acceso]
Por defecto, si no se especifica formato, la respuesta sera en JSON.
2. INFORMACION DE CAMPOS DISPONIBLES EN Órdenes de Compra.
#
Campo
Tipo
11 Listado/TipoMoneda
Descripción
Cantidad de Licitaciones
consultadas
Fecha de consulta
Versión del API de Mercado
Público
Código de la Orden de compra de
Mercado Publico
Nombre de la Orden de Compra
Código del estado en el que se
encuentra la Orden de compra
Código de la Licitación asociada a
la Orden de Compra
Descripción de la Orden de
Compra.
Código del tipo de Orden de
Compra
Tipo de Orden de compra
Tipo Moneda de la Orden de
Compra.
12 Listado/CodigoEstadoProveedor
Código estado del Proveedor.
Int
13 Listado/EstadoProveedor
Estado del Proveedor.
Fecha de creación de la Orden de
compra.
Fecha de envió de la Orden de
compra.
Fecha de aceptación Orden de
compra
Fecha cancelación de orden de
compra.
Fecha de Ultima Modificación de
la Orden de compra.
Indica si tiene Items. 1 = SI, 0 =
NO
Promedio de calificación del
proveedor
Evaluación del proveedor
Descuento aplicado a la Orden de
compra
Cargos aplicados a la Orden de
compra
Total neto de la Orden de compra
Porcentaje del IVA aplicado a la
Orden de compra
Impuesto aplicado a la Orden de
compra
Total de la Orden de compra
Fuente de Financiamiento
País al que pertenece la Orden de
compra
Código que identifica el Tipo de
Despacho. Anexo 3.3
Código que identifica la forma de
pago. Anexo 3.4
Código que identifica al
organismo comprador
Nombre del organismo del
comprador
Rut de la Unidad
Nvarchar
1 Cantidad
2 FechaCreacion
3 Version
4 Listado/Codigo
5 Listado/Nombre
6 Listado/CodigoEstado
7 Listado/CodigoLicitacion
8 Listado/Descripcion
9 Listado/CodigoTipo
10 Listado/Tipo
14 Listado/Fechas/FechaCreacion
15 Listado/Fechas/FechaEnvio
16 Listado/Fechas/FechaAceptacion
17 Listado/Fechas/FechaCancelacion
18 Listado/Fechas/FechaUltimaModificacion
19 Listado/TieneItems
20 Listado/PromedioCalificacion
21 Listado/CantidadEvaluacion
22 Listado/Descuentos
23 Listado/Cargos
24 Listado/TotalNeto
25 Listado/PorcentajeIva
26 Listado/Impuestos
27 Listado/Total
28 Listado/Financiamiento
29 Listado/Pais
30 Listado/TipoDespacho
31 Listado/FormaPago
32 Listado/Comprador/CodigoOrganismo
33 Listado/Comprador/NombreOrganismo
34 Listado/Comprador/RutUnidad
Largo
Int
DateTime
texto
Nvarchar
Nvarchar
Int
50
255
4
Nvarchar
50
Nvarchar
2000
Nvarchar
Nvarchar
80
2
Nvarchar
255
255
DateTime
DateTime
DateTime
DateTime
DateTime
Nvarchar
255
Float
Int
Float
Float
Float
Float
Float
Float
Nvarchar
255
Nvarchar
255
Nvarchar
255
Nvarchar
255
Nvarchar
20
Nvarchar
Nvarchar
255
20
35 Listado/Comprador/CodigoUnidad
36 Listado/Comprador/NombreUnidad
37 Listado/Comprador/Actividad
Código de Unidad
Nombre de Unidad
Actividad del Comprador
Dirección de la unidad
38 Listado/Comprador/DireccionUnidad
compradora
Comuna de la unidad
39 Listado/Comprador/ComunaUnidad
compradora
40 Listado/Comprador/RegionUnidad
Región de la unidad compradora
41 Listado/Comprador/Pais
País de la unidad compradora
42 Listado/Comprador/NombreContacto
Nombre contacto
43 Listado/Comprador/CargoContacto
Cargo del contacto
44 Listado/Comprador/FonoContacto
Teléfono del Contacto
45 Listado/Comprador/MailContacto
E Mail del contacto
46 Listado/Proveedor/Codigo
Código del proveedor
47 Listado/Proveedor/Nombre
Nombre del proveedor
48 Listado/Proveedor/Actividad
Actividad del Proveedor
Código de la sucursal del
49 Listado/Proveedor/CodigoSucursal
proveedor
Nombre de la sucursal del
50 Listado/Proveedor/NombreSucursal
proveedor
51 Listado/Proveedor/RutSucursal
Rut del Proveedor
52 Listado/Proveedor/Direccion
Dirección del proveedor
53 Listado/Proveedor/Comuna
Comuna del proveedor
54 Listado/Proveedor/Region
Región del proveedor
55 Listado/Proveedor/Pais
País del proveedor
56 Listado/Proveedor/NombreContacto
Nombre contacto del proveedor
57 Listado/Proveedor/CargoContacto
Cargo del contacto del proveedor
Teléfono del contacto del
58 Listado/Proveedor/FonoContacto
proveedor
59 Listado/Proveedor/MailContacto
E Mail del contacto del proveedor
Cantidad de Items (Productos) de
60 Listado/Items/Cantidad
la orden de compra
61 Listado/Items/Listado
Listado de Items
62 Listado/Items/Listado/Correlativo
Correlativo de Items
Código de categoría a la que
63 Listado/Items/Listado/CodigoCategoria
pertenece el producto
Categoría a la que pertenece el
64 Listado/Items/Listado/Categoria
producto
65 Listado/Items/Listado/CodigoProducto
Codigo del producto
Listado/Items/Listado/EspecificacionCom Especificaciones del producto que
66 prador
necesita el comprador.
Listado/Items/Listado/EspecificacionProv Especificaciones del producto
67 eedor
proveído por el proveedor.
Nvarchar
Nvarchar
Nvarchar
20
255
255
Nvarchar
255
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
255
255
255
255
255
100
50
20
255
255
Nvarchar
20
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
Nvarchar
255
20
255
255
255
255
255
255
Nvarchar
Nvarchar
255
255
68 Listado/Items/Listado/Cantidad
69 Listado/Items/Listado/Moneda
70 Listado/Items/Listado/PrecioNeto
71 Listado/Items/Listado/TotalCargos
72 Listado/Items/Listado/TotalDescuentos
73 Listado/Items/Listado/TotalImpuestos
74 Listado/Items/Listado /Total
Cantidad de productos
Tipo de moneda del producto.
Precio neto o precio unitario del
producto
Total cargos asociados a la
multiplicación del Precioneto *
Cantidad
Total Descuentos asociados a la
multiplicación del Precioneto *
Cantidad
Total de impuesto asociados a la
multiplicación del Precioneto *
Cantidad
Total final de precios de los
productos.
Int
BitInt
Int
Varchar
Int
400
Nvarchar
-1
Nvarchar
510
Float
Nvarchar
100
Float
Float
Float
Float
Float
3. INFORMACION DE PARÁMETROS EN ETIQUETAS DE ORDENES DE COMPRA.
3.1 Tipo de orden de compra.
Ruta
Descripción
Codigo
8
9
<Ordenes>/<Listado>/<OrdenCompra>/<Tipo>
ID del tipo de Orden de compra de Mercado Publico
Abreviación
Descripción
SE
Sin emisión automática.
CM
Convenio Marco.
3.2 Unidad Monetaria
Ruta
Descripción
Valor
CLP
CLF
USD
UTM
EUR
<Ordenes>/<Listado>/<OrdenCompra>/<TipoMoneda>
Código de la moneda en la Orden de compra.
Descripción
Peso Chileno
Unidad de Fomento
Dólar Americano
Unidad Tributaria Mensual
Euro
3.3 Tipo de despacho.
Ruta
Descripción
Valor
7
9
12
14
20
21
22
<Ordenes>/<Listado>/<OrdenCompra>/<TipoDespacho>
Tipo de despacho.
Descripción
Despachar a Dirección de envío.
Despachar según programa adjuntado.
Otra Forma de Despacho, Ver Instruc.
Retiramos de su bodega.
Despacho por courier o encomienda aérea.
Despacho por courier o encomienda terrestre.
A convenir.
3.4 Forma de Pago
Ruta
Descripción
Valor
1
2
39
46
47
<Ordenes>/<Listado>/<OrdenCompra>/<FormaPago>
Forma de pago
Descripción
15 días contra la recepción de la factura.
30 días contra la recepción de la factura.
Otra forma de pago.
50 días contra la recepción de la factura.
60 días contra la recepción de la factura.