Daterium System

Productos de categoría

Descripción general

Devuelve un listado de productos pertenecientes a la categoría indicada y todas sus subcategorías.

Usos:

Obtener información de varios productos con una única llamada.

URL de llamada

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

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
catID	si	Identificador de la categoría de la que obtener los productos.
ref	no	Si se establece con valor 1 se mostrarán las referencias de las viñetas. En caso contrario no se mostrarán las referencias.
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 productosdecategoria( categoría*, productos* ) >

< !ELEMENT amp( #PCDATA ) >
< !ELEMENT catID( #PCDATA ) >
< !ELEMENT categoría( catID, nombre, descripcion, thumb, img280x240, img500x500, amp, proveedor, proveedor_cif, logo_proveedor)
< !ELEMENT codiart( #PCDATA ) >
< !ELEMENT descripcion( #PCDATA ) >
< !ELEMENT descripción_corta( #PCDATA ) >
< !ELEMENT ean( #PCDATA ) >
< !ELEMENT imagenes( imagen+ )
< !ELEMENT imagen( thumb, amp, img280x240, img500x500, titulo )
< !ELEMENT img280x240( #PCDATA ) >
< !ELEMENT img500x500( #PCDATA ) >
< !ELEMENT logo_proveedor( #PCDATA ) >
< !ELEMENT nombre( #PCDATA ) >
< !ELEMENT pID( #PCDATA ) >
< !ELEMENT productos( producto+)
< !ELEMENT producto( pID, nombre, descripcion, descripcion_corta, imagenes, referencias )
< !ELEMENT proveedor( #PCDATA ) >
< !ELEMENT proveedor_cif( #PCDATA ) >
< !ELEMENT ref ( #PCDATA ) >
< !ELEMENT referencias( referencia* )
< !ELEMENT referencia( ref, codiart, ean ) >
< !ELEMENT thumb( #PCDATA ) >
< !ELEMENT titulo( #PCDATA ) >

< !ATTLIST referencia refID CDATA #REQUIRED >

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
Llamada del ejemplo: https://api.dateriumsystem.com/productosdecategoria_xml.php?userID=_MI_CODIGO_API_&catID=1029792&ref=1

<?xml version='1.0' encoding='UTF-8'?>
<productosdecategoria>
	<categoria>
		* Información de la categoría indicada en la llamada.
		<catID>1029792</catID>
		Identificador único de la categoría en Daterium.
		<nombre>Sierras</nombre>
		(CAT_003) Nombre de la categoría.
		<descripcion/>
		<thumb>https://www.dateriumsystem.com/appfiles/clientes/379/379/catalogo/dcs572n_1.gif</thumb>
		<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/379/catalogo/dcs572n_1_rf280x240.jpg</img280x240>
		<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/379/catalogo/500x500/dcs572n_1.jpg</img500x500>
		<amp>https://www.dateriumsystem.com/appfiles/clientes/379/379/catalogo/DCS572N_1.jpg</amp>
		<proveedor>FABRICANTE DEMO</proveedor>
		<proveedor_cif>Z00000001</proveedor_cif>
		<logo_proveedor>https://www.dateriumsystem.com/appfiles/clientes/379/logos/cdea5-Logo.jpg</logo_proveedor>
	</categoria>
	<productos>
		* Listado de productos con información simple.
		<producto>
			<pID>1153402</pID>
			Identificador único de la viñeta en Daterium.
			<nombre>DCS572NT-XJ - Sierra Circular sin escobillas XR 18V Ø184mm sin cargador/batería</nombre>
			<descripcion>SIERRA CIRCULAR SIN ESCOBILLAS XR 18V Ø184mm con base compatible para raíl guía. SIN CARGADOR/BATERÍA. Con maletín TSTAK VI</descripcion>
			<descripcion_corta/>
			<marca>DEWALT</marca>
			<logo_marca>https://www.dateriumsystem.com/appfiles/clientes/379/logos/378ac-dewalt.jpg</logo_marca>
			<imagenes>
				<imagen>
					<thumb>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/dcs572n_1.gif</thumb>
					<amp>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/DCS572N_1.jpg</amp>
					<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/dcs572n_1_rf280x240.jpg</img280x240>
					<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/dcs572n_1.jpg</img500x500>
					<titulo>DCS572NT-XJ - Sierra Circular sin escobillas XR 18V Ø184mm sin cargador/batería</titulo>
				</imagen>
				<imagen>
					<thumb>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/dcs572nt_10.gif</thumb>
					<amp>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/DCS572NT_10.jpg</amp>
					<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/dcs572nt_10_rf280x240.jpg</img280x240>
					<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/dcs572nt_10.jpg</img500x500>
					<titulo>DCS572NT-XJ - Sierra Circular sin escobillas XR 18V Ø184mm sin cargador/batería</titulo>
				</imagen>
			</imagenes>
			<referencias>
				<referencia refID='2312350'>
					<ref>DCS572NT-XJ</ref>
					<codiart/>
					<ean>5035048729175</ean>
					<descripcion>Sierra Circular sin escobillas XR 18V Ø184mm y 58mm prof.  sin cargador/batería con maletín TSTAK VI (con base para rail)</descripcion>
				</referencia>
			</referencias>
		</producto>
		<producto>
			<pID>1153403</pID>
			<nombre>SKIL 5255 AA Sierra circular</nombre>
			<descripcion>Potencia, duración y comodidad. La sierra circular SKIL 5255 es muy potente gracias a su motor de 1150 W, más que suficiente para la mayoría de los trabajos domésticos de aserrado. Su capacidad de aserrado de 55 mm es más que suficiente para la mayoría de los materiales habituales en bricolaje, como tablones, travesaños, etc. Esta sierra circular cuenta además con numerosas funciones prácticas, por ejemplo el visor de línea de aserrado, que ayuda a conseguir unos resultados perfectos. Esta sierra circular se suministra con una hoja de acero templado de 24 dientes y una guía paralela que facilita el aserrado en línea recta.</descripcion>
			<descripcion_corta/>
			<marca>SKIL</marca>
			<logo_marca>https://www.dateriumsystem.com/appfiles/clientes/379/logos/314ad-skill_logo.jpg</logo_marca>
			<imagenes>
				<imagen>
					<thumb>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/f0155255aa_d.gif</thumb>
					<amp>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/F0155255AA_D.jpg</amp>
					<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/f0155255aa_d_rf280x240.jpg</img280x240>
					<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/f0155255aa_d.jpg</img500x500>
					<titulo>SKIL 5255 AA Sierra circular</titulo>
				</imagen>
			</imagenes>
			<referencias>
				<referencia refID='2312351'>
					<ref>F0155255AA</ref>
					<codiart/>
					<ean>8710364068050</ean>
					<descripcion>SKIL 5255 AA Sierra circular</descripcion>
				</referencia>
			</referencias>
		</producto>
	</productos>
</productosdecategoria>