Daterium System

Buscador referencia

Descripción general

Devuelve información básica de la referencia pasada como parámetro y un listado de referencias similares.

Usos:

Para montar un sistema de agregación directa de referencias a un carrito o a un comparador.
Obtener los refID de una referencia que pueden distribuir distintos proveedores de catálogo

URL de llamada

https://api.dateriumsystem.com/busqueda_referencia_fc_xml.php

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
ref	si	Referencia (código de referencia o código EAN) a buscar.
s	no	Si se indica 1, devolverá resultados de referencias similares a la pasada en el parámetro ref (sólo para código de referencia). Por defecto su valor es 0.
lang	no	Código del idioma en el que se devolverán los datos (por defecto en español, código 'es').

DTD del XML devuelto

< !ELEMENT referencias ( referencia?, multiples?, similares ) >

< !ELEMENT codiart ( #PCDATA ) >
< !ELEMENT denoart ( #PCDATA ) >
< !ELEMENT ean ( #PCDATA ) >
< !ELEMENT multiples ( referencia* ) >
< !ELEMENT nombre ( #PCDATA ) >
< !ELEMENT pID ( #PCDATA ) >
< !ELEMENT ref ( #PCDATA ) >
< !ELEMENT refID ( #PCDATA ) >
< !ELEMENT referencia ( refID, ref, ean, pID, nombre, codiart, denoart ) >
< !ELEMENT similares ( referencia* ) >

Ejemplo/s y descripción de campos

A continuación mostramos ejemplos de ficheros XML con comentarios en el propio XML.

Los identificadores entre paréntesis (por ejemplo, CAT_003) vinculan esa etiqueta al campo definido en la documentación de soporte.

Ejemplo 1: búsqueda de una referencia (1688-BRE PRO36), solicitando resultados similares.
Llamada del ejemplo: https://api.dateriumsystem.com/busqueda_referencia_fc_xml.php?userID=_MI_CODIGO_API_&ref=1688-BRE%20PRO36&s=1

<?xml version='1.0' encoding='UTF-8'?>
<referencias>
	<referencia>
		Un único resultado.
		<refID>2115061</refID>
		Identificador único de la referencia en Daterium.
		<ref>1688-BRE PRO36</ref>
		(ART_002) Código de la referencia.
		<ean>8427310023239</ean>
		(ART_004) Código EAN de la referencia.
		<pID>1051820</pID>
		Identificador único de la viñeta en Daterium.
		<nombre>1688-BRE PRO BOTA MODELO SAGUNTO</nombre>
		(VIN_004) Nombre de la viñeta.
		<codiart/>
		(ART_003) Código interno de la referencia.
		<denoart>BOTA MODELO SAGUNTO 36</denoart>
		(ART_005) Descripción corta de la referencia.
	</referencia>
	<similares>
		Listado de referencias similares (especificado por parámetro en la llamada).
		<referencia>
			<refID>2115062</refID>
			<ref>1688-BRE PRO37</ref>
			<ean>8427310023246</ean>
			<pID>1051820</pID>
			<nombre>1688-BRE PRO BOTA MODELO SAGUNTO</nombre>
			<codiart/>
			<denoart>BOTA MODELO SAGUNTO 37</denoart>
		</referencia>
		<referencia>
			<refID>2115063</refID>
			<ref>1688-BRE PRO38</ref>
			<ean>8427310023253</ean>
			<pID>1051820</pID>
			<nombre>1688-BRE PRO BOTA MODELO SAGUNTO</nombre>
			<codiart/>
			<denoart>BOTA MODELO SAGUNTO 38</denoart>
		</referencia>
		<referencia>
			<refID>2115064</refID>
			<ref>1688-BRE PRO39</ref>
			<ean>8427310023260</ean>
			<pID>1051820</pID>
			<nombre>1688-BRE PRO BOTA MODELO SAGUNTO</nombre>
			<codiart/>
			<denoart>BOTA MODELO SAGUNTO 39</denoart>
		</referencia>
		<referencia>
			<refID>2115071</refID>
			<ref>1688-BRE PRO46</ref>
			<ean>8427310023338</ean>
			<pID>1051820</pID>
			<nombre>1688-BRE PRO BOTA MODELO SAGUNTO</nombre>
			<codiart/>
			<denoart>BOTA MODELO SAGUNTO 46</denoart>
		</referencia>
		<referencia>
			<refID>2115306</refID>
			<ref>1688-ZRE PRO36</ref>
			<ean>8427310024007</ean>
			<pID>1051843</pID>
			<nombre>1688-ZRE PRO ZAPATO MODELO TARRACO</nombre>
			<codiart/>
			<denoart>ZAPATO MODELO TARRACO 36</denoart>
		</referencia>
	</similares>
</referencias>

Ejemplo 2: búsqueda de una referencia por el código EAN y devolución de 2 resultados.
Llamada del ejemplo: https://api.dateriumsystem.com/busqueda_referencia_fc_xml.php?userID=_MI_CODIGO_API_&ref=8421461127969

<?xml version='1.0' encoding='UTF-8'?>
<referencias>
	<multiples>
		La búsqueda ha devuelto 2 resultados.
		<referencia>
			Primera referencia encontrada.
			<refID>2391475</refID>
			Identificador único de la referencia en Daterium.
			<ref>12796</ref>
			(ART_002) Código de la referencia.
			<ean>8421461127969</ean>
			(ART_004) Código EAN de la referencia.
			<pID>1182958</pID>
			Identificador único de la viñeta en Daterium.
			<nombre>IPACKBOX STANDARD - 1 puerta</nombre>
			(VIN_004) Nombre de la viñeta.
			<codiart/>
			(ART_003) Código interno de la referencia.
			<denoart>IPACKBOX BLANCO STANDARD -1 PUERTA</denoart>
			(ART_005) Descripción corta de la referencia.
		</referencia>
		<referencia>
			<refID>2607042</refID>
			Identificador único de la referencia en Daterium.
			<ref>12796</ref>
			(ART_002) Código de la referencia.
			<ean>8421461127969</ean>
			(ART_004) Código EAN de la referencia.
			<pID>1213313</pID>
			Identificador único de la viñeta en Daterium.
			<nombre>BUZÓN IPACKBOX BLANCO 1 PUERTA</nombre>
			(VIN_004) Nombre de la viñeta.
			<codiart/>
			(ART_003) Código interno de la referencia.
			<denoart>BUZÓN IPACKBOX BLANCO 1 PUERTA</denoart>
			(ART_005) Descripción corta de la referencia.
		</referencia>
	</multiples>
	<similares/>
</referencias>