MicroCompra

API change history

Servicios asociados al modelo "MicroCompra". Permite registrar la información de una compra enviada desde la tienda del proveedor (eCommerce) hacia ChileCompra. La información enviada permiten generar una orden de compra válida (en estado Aceptada Proveeedor) en Mercado Publico

RegistroDeCompra

Servicios que registra la información de compra enviada por el proveedor hacia ChileCompra y permiten generar una orden de compra válida para mercado público

Try it

Solicitud

URL de solicitud

Encabezados de solicitud

  • (opcional)
    string
    Tipo de medio del cuerpo enviado a la API.

Cuerpo de la solicitud

Esquema de una orden de compra

IdTienda: identificador de la tienda externa entregado por MP, del tipo "0457AAADF71-ASDA-4DFC9-FJTA6-EBYULUIO2B6BC".

CodigoCompra: identificación de la compra realizada por la tienda externa.

RutProveedor: Identificador del Proveedor a quien se le está comprando y a quién irá la O.C (con puntos y guión)

RazonSocialProveedor: Razón Social del Proveedor a quien se le está comprando y a quién irá la O.C

DireccionProveedor: dirección particular de la empresa, debe incluir ciudad y región y país, con los código incorporados en el Excel BASE.

RutComprador: Rut de la persona y/u Organismo que está comprando en la Tienda Externa

CodigoUsuario: Código entregado por Mercado Público que identifica al usuario comprador de MP y la unidad de compra por defecto asignada (Campo que será usado para hacer el match y generar la OC).

CodigoUsuarioTienda: identificador del usuario por parte de la Tienda Externa.

FechaCompra: Fecha y hora de la compra realizada, debe incluir la fecha y hora en formato estándar ( año-mes-diaThora:minuto:segundoZ) ISO 8601

MontoTotal: Monto total de la compra realizada en la tienda externa, incluye los impuestos y descuentos aplicados. Con decimales sin separados de miles.

MonedaCompra: Sigla asociada al tipo de moneda de la compra realizada (CLP: pesos, UF: unidad de fomento, USD: dólar)

DireccionDepacho: Dirección indicada por el comprador para el envío del producto(s) adquiridos en la tienda externa, debe incluir ciudad y región y país, con los código incorporados en el Excel BASE.

FechaEntrega: Fecha y hora indicas para la recepción del producto adquirido, debe incluir la fecha y hora en formato estándar ( año-mes-diaThora:minuto:segundoZ) ISO 8601, sino existe dejar vacía.

Productos: Listado de productos adquiridos en la compra. Para cada item tendremos:

TipoCodigoProducto: Tipo de codificación utilizada para la catalogación de los productos, se debe indicar la SIGLA: SKU,PARTNUMBER, ISBN, EAN,PROPIO.

CodigoProducto: Código del producto adquirido, número o texto que identifica el producto adquirido.

NombreProducto: Nombre del producto adquirido, debiese incluir Marca y Modelo.

CantidadProducto: Cantidad del productos adquirido.

PrecioUnitario: Valor unitario del producto adquirido incluye los impuestos y descuentos aplicados. Con decimales sin separados de miles.

Informacion: Descripción adicional sobre el producto adquirido. (ESTA INFORMACIÓN SE REPITE POR CADA PRODUCTO ADQUIRIDO)

{
  "idTienda": "0457AAADF71-ASDA-4DFC9-FJTA6-EBYULUIO2B6BC",
  "CodigoCompra": "codigoXXXXX",
  "RutProveedor": "14.902.900-1",
  "RazonSocialProveedor": "nombreProveedorXXX",
  "DireccionProveedor": "Direccion||ciudad (idCiudad)||región (idRegion)||país (idPais) ",
  "RutComprador": "22.222.222-2",
  "CodigoUsuario": "500977_1013342",
  "CodigoUsuarioTienda": "codigoEXTXXXXX",
  "FechaCompra": "2009-02-15 12:15:45",
  "MontoTotal": 10000,
  "MonedaCompra": "CLP", /* CLP, USD, EUR, UTM */
  "DireccionDespacho": "Direccion||ciudad (idCiudad)||región (idRegion)||país (idPais) ", 
  "FechaEntrega": "2009-02-15 12:15:45",
  "productos": [{
    "TipoCodigoProducto": "SKU", /* SKU, PARTNUMBER, ISBN, EAN, PROPIO */
    "CodigoProducto": "codigoProductoXXXX",
    "NombreProducto": "NombreProductoXXXX",
    "CantidadProducto": 12,
    "PrecioUnitario": 1000,
    "Informacion": "InformacionXXXX DDDDD DDDDDD DFFFFFF"
  }]
}
{
  "example": "{\n  \"idTienda\": \"0457AAADF71-ASDA-4DFC9-FJTA6-EBYULUIO2B6BC\",\n  \"CodigoCompra\": \"codigoXXXXX\",\n  \"RutProveedor\": \"14.902.900-1\",\n  \"RazonSocialProveedor\": \"nombreProveedorXXX\",\n  \"DireccionProveedor\": \"Direccion||ciudad (idCiudad)||región (idRegion)||país (idPais) \",\n  \"RutComprador\": \"22.222.222-2\",\n  \"CodigoUsuario\": \"500977_1013342\",\n  \"CodigoUsuarioTienda\": \"codigoEXTXXXXX\",\n  \"FechaCompra\": \"2009-02-15 12:15:45\",\n  \"MontoTotal\": 10000,\n  \"MonedaCompra\": \"CLP\", /* CLP, USD, EUR, UTM */\n  \"DireccionDespacho\": \"Direccion||ciudad (idCiudad)||región (idRegion)||país (idPais) \", \n  \"FechaEntrega\": \"2009-02-15 12:15:45\",\n  \"productos\": [{\n    \"TipoCodigoProducto\": \"SKU\", /* SKU, PARTNUMBER, ISBN, EAN, PROPIO */\n    \"CodigoProducto\": \"codigoProductoXXXX\",\n    \"NombreProducto\": \"NombreProductoXXXX\",\n    \"CantidadProducto\": 12,\n    \"PrecioUnitario\": 1000,\n    \"Informacion\": \"InformacionXXXX DDDDD DDDDDD DFFFFFF\"\n  }]\n}"
}

Respuestas

200 OK

Si la llamada es correcta se devuelve una estructura con 4 parametros, indicando el código de Orden de Compra generada, enlace a su ficha publica en Mercado Publico y fecha de la respuesta.

Si la llamada es correcta pero con errores se muestra el detalle de error con un código asociado. Los códigos disponibles son los siguientes:

1 - Registro Exitoso

2 - Id de Ticket no válido

3 - Moneda no válida

4 - Tipo Código de Producto no válido

5 - Datos Mal Formateados

6 - Comprador no registrado

7 - Sin productos asociados

Representaciones

{
    "FechaRespuesta": "2017-08-10T09:00:00.000",
    "CodigoRespuesta": 1,
    "Respuesta": "2240-425-MC17",
    "Url": "http://www.mercadopublico.cl/PurchaseOrder/Modules/PO/DetailsPurchaseOrder.aspx?codigooc=2240-425-MC17"
}

Ejemplos de código

@ECHO OFF

curl -v -X POST "https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra"
-H "Content-Type: application/json"

--data-ascii "{body}" 
using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;

namespace CSHttpClientSample
{
    static class Program
    {
        static void Main()
        {
            MakeRequest();
            Console.WriteLine("Hit ENTER to exit...");
            Console.ReadLine();
        }
        
        static async void MakeRequest()
        {
            var client = new HttpClient();
            var queryString = HttpUtility.ParseQueryString(string.Empty);

            // Request headers

            var uri = "https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra?" + queryString;

            HttpResponseMessage response;

            // Request body
            byte[] byteData = Encoding.UTF8.GetBytes("{body}");

            using (var content = new ByteArrayContent(byteData))
            {
               content.Headers.ContentType = new MediaTypeHeaderValue("< your content type, i.e. application/json >");
               response = await client.PostAsync(uri, content);
            }

        }
    }
}	
// // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class JavaSample 
{
    public static void main(String[] args) 
    {
        HttpClient httpclient = HttpClients.createDefault();

        try
        {
            URIBuilder builder = new URIBuilder("https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra");


            URI uri = builder.build();
            HttpPost request = new HttpPost(uri);
            request.setHeader("Content-Type", "application/json");


            // Request body
            StringEntity reqEntity = new StringEntity("{body}");
            request.setEntity(reqEntity);

            HttpResponse response = httpclient.execute(request);
            HttpEntity entity = response.getEntity();

            if (entity != null) 
            {
                System.out.println(EntityUtils.toString(entity));
            }
        }
        catch (Exception e)
        {
            System.out.println(e.getMessage());
        }
    }
}

<!DOCTYPE html>
<html>
<head>
    <title>JSSample</title>
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
</head>
<body>

<script type="text/javascript">
    $(function() {
        var params = {
            // Request parameters
        };
      
        $.ajax({
            url: "https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra?" + $.param(params),
            beforeSend: function(xhrObj){
                // Request headers
                xhrObj.setRequestHeader("Content-Type","application/json");
            },
            type: "POST",
            // Request body
            data: "{body}",
        })
        .done(function(data) {
            alert("success");
        })
        .fail(function() {
            alert("error");
        });
    });
</script>
</body>
</html>
#import <Foundation/Foundation.h>

int main(int argc, const char * argv[])
{
    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
    
    NSString* path = @"https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra";
    NSArray* array = @[
                         // Request parameters
                         @"entities=true",
                      ];
    
    NSString* string = [array componentsJoinedByString:@"&"];
    path = [path stringByAppendingFormat:@"?%@", string];

    NSLog(@"%@", path);

    NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
    [_request setHTTPMethod:@"POST"];
    // Request headers
    [_request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
    // Request body
    [_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
    
    NSURLResponse *response = nil;
    NSError *error = nil;
    NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];

    if (nil != error)
    {
        NSLog(@"Error: %@", error);
    }
    else
    {
        NSError* error = nil;
        NSMutableDictionary* json = nil;
        NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
        NSLog(@"%@", dataString);
        
        if (nil != _connectionData)
        {
            json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
        }
        
        if (error || !json)
        {
            NSLog(@"Could not parse loaded json with error:%@", error);
        }
        
        NSLog(@"%@", json);
        _connectionData = nil;
    }
    
    [pool drain];

    return 0;
}
<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';

$request = new Http_Request2('https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra');
$url = $request->getUrl();

$headers = array(
    // Request headers
    'Content-Type' => 'application/json',
);

$request->setHeader($headers);

$parameters = array(
    // Request parameters
);

$url->setQueryVariables($parameters);

$request->setMethod(HTTP_Request2::METHOD_POST);

// Request body
$request->setBody("{body}");

try
{
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex)
{
    echo $ex;
}

?>
########### Python 2.7 #############
import httplib, urllib, base64

headers = {
    # Request headers
    'Content-Type': 'application/json',
}

params = urllib.urlencode({
})

try:
    conn = httplib.HTTPSConnection('apis.mercadopublico.cl')
    conn.request("POST", "/MicroCompra/RegistroDeCompra?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################

########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64

headers = {
    # Request headers
    'Content-Type': 'application/json',
}

params = urllib.parse.urlencode({
})

try:
    conn = http.client.HTTPSConnection('apis.mercadopublico.cl')
    conn.request("POST", "/MicroCompra/RegistroDeCompra?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################
require 'net/http'

uri = URI('https://apis.mercadopublico.cl/MicroCompra/RegistroDeCompra')


request = Net::HTTP::Post.new(uri.request_uri)
# Request headers
request['Content-Type'] = 'application/json'
# Request body
request.body = "{body}"

response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(request)
end

puts response.body