Centro de Ayuda de comercialibre


Indice


 Generalidades

 Comprar y Vender

 Desarrolladores


API de Publicación


comercialibre le brinda la posibilidad de publicar articulos en nuestro portal de forma totalmente automatizada mediante el envio de un
archivo XML con los detalles de la publicacion.

Este es un ejemplo de archivo XML:

Puede descargarlo desde Aquí

<?xml version='1.0'?>
<publicar usuario="usuario" clave="c4025c123121aasfasfasad23d23" dias="180" tipo="V" 
	estado="U" cantidad="1" categoria="138-Software" moneda="$" precio="50">
	<titulo><![CDATA[SoftWare ABM Quick para balanzas Kretz]]></titulo>
	<subtitulo><![CDATA[Cd de transmision de datos desde pc]]></subtitulo>
	<descripcion><![CDATA[<h2>Cd de transmision de datos desde pc</h2><br/>
	                                Para balanzas kretz]]></descripcion>
	<garantia><![CDATA[sin garantia]]></garantia>
	<fotos>
		<foto archivo="kretz_logo.gif"><![CDATA[]]></foto>
	</fotos>
	<envios>
		<envio>A Convenir</envio>
		<envio>Otro</envio>
	</envios>
	<pagos>
		<pago>A Convenir</pago>
		<pago>Efectivo</pago>
	</pagos>
</publicar>


Envio del Archivo a comercialibre

El archivo debera ser enviado mediante un request HTTP POST a la direccion: http://comercialibre.com/ar/api/xml/publicar

Codigos de Resultado

En respuesta a una publicacion, comercialibre genera y devuelve otro archivo XML con el siguiente formato:
Si la publicacion fue correcta:
<?xml version='1.0'?>
<result code="OK"><![CDATA[URL_DE_LA_PUBLICACION]]></result>

Si hubo un error:
<?xml version='1.0'?>
<result code="ERR"><![CDATA[MENSAJE_DE_ERROR]]></result>


Detalle de Campos

TipoTipo de datoDescripcion
publicarnodoNodo raiz del archivo xml.
usuariopropiedad del nodo publicarEs el nombre de usuario, debe estar previamente registrado en el sistema y habilitar la opcion de publicacion remota.
clavepropiedad del nodo publicarEs la clave del usuario para login, debe ser codificada mediante el algoritmo MD5.
diaspropiedad del nodo publicarEs la cantidad de dias que estara activa la publicacion, en el rango desde [1 a 180].
tipopropiedad del nodo publicarEs el tipo de publicacion, puede ser "V" para venta inmediata o "S" para subasta.
estadopropiedad del nodo publicarEs el estado fisico del articulo que se venta, puede ser "U" para usado o "N" para nuevo.
cantidadpropiedad del nodo publicarEs la cantidad de articulos que se dispone a vender (su stock del articulo a la venta).
categoriapropiedad del nodo publicarEs la categoria donde se desea realizar la publicacion, puede ser consultada en la url al navegar el sistema, algunos ejemplos: categoria software en argentina | categoria computacion en Mexico debe tener el format "numero-descripcion". Cada Pais, tiene su conjunto de categorias.
monedapropiedad del nodo publicarEs la divisa en la cual se realiza la publicacion, los codigos, pueden consultarse navegando las publicaciones en el sistema para cada pais, por ejemplo en mexico los codigos validos son ( "U$D" para Dolares U.S.A. y "$" para peso mexicano).
preciopropiedad del nodo publicarEs el precio de venta del articulo en caso de venta inmediata, y el precio de reserva en caso de subasta. Debe estar indicado en formato americano (sin separador de miles y utilizando punto como separador decimal, por ejemplo: 1.50 o 0.90 1950.50).
titulonodo de tituloEs el titulo de la publicacion, y debe ser una seccion ![CDATA[ ]].
subtitulonodo de subtituloEs el subtitulo de la publicacion, y debe ser una seccion ![CDATA[ ]].
descripcionnodo de descripcionEs la descripcion de la publicacion, y debe ser una seccion ![CDATA[ ]], puede contener tags html.
garantianodo de garantiaEs la garantia de la publicacion, y debe ser una seccion ![CDATA[ ]], puede estar vacio.
fotosnodo de fotosCada foto debera tener una seccion ![CDATA[ ]], con el contenido del archivo de la imagen codificado en base 64. El nodo tambien debe tener una propiedad "archivo" indicando cual es el nombre del archivo y su extension.(sin paths).Se pueden incluir hasta 6 fotos por cada publicacion, (tomandose la primera como imagen principal).
enviosnodo de formas de envioCada forma de envio debe expresarse exactamente como se encuentra en las publicaciones, pudiendose consultar en estas mismas las opciones disponibles.
pagosnodo de formas de pagoCada forma de pago debe expresarse exactamente como se encuentra en las publicaciones, pudiendose consultar en estas mismas las opciones disponibles.


Codigo de ejemplo PHP

Este codigo de ejemplo en PHP utiliza la libreria CURL y el archivo PUB.XML indicado arriba.
<?php

	$xmlStr=file_get_contents("pub.xml");

	$c=base64_encode(file_get_contents("kretz_logo.gif"));
	$XPost = str_replace("", $c ,$xmlStr);

	$url = "http://comercialibre.com/ar/api/xml/publicar";
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_VERBOSE, 1);
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_HTTPHEADER, Array("Content-Type: text/xml")); 
	curl_setopt($ch, CURLOPT_HEADER, 1); 
	curl_setopt($ch, CURLOPT_TIMEOUT, 40);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $XPost);
	curl_setopt($ch, CURLOPT_POST, 1); 
	$result = curl_exec($ch);
	if (empty($result)) { 
		die(curl_error($ch)); 
		curl_close($ch);
	} else { 
		$info = curl_getinfo($ch);
		curl_close($ch); // close cURL handler 
		if (empty($info['http_code'])) {
			die("No HTTP code was returned"); 
		} 
	} 
	echo $result;
?>


Notas

Cabe destacar que se debe habilitar la cuenta para el envio remoto de publicaciones, ya que por default esta opcion no esta permitida.
Si se intenta realizar una publicacion sin este permiso; el sistema dara el error y el correspondiente mensaje notificando de la situacion.
Para habilitar la cuenta para publicacion remota, se debe ir al Panel de control y luego a Datos del usuario En la parte inferior de la pantalla,
se encuentra la opcion para habilitar esta caracteristica.

Esta caracteristica esta bajo desarrollo y prueba, si tienes algun problema; envianos un mensaje desde aqui: Enviar mensaje


 

 Necesita Ayuda?

   Envienos un mensaje desde Aquí, le contestaremos dentro de las 24 hs.

   Le resulto util esta pantalla de ayuda ?