Daterium System

Categorías

Descripción general

Devuelve el listado de categorías del fabricante para construir su árbol de navegación.

Usos:

Obtener el listado de catálogos.
Obtener información de una categoría.
Obtener los productos de una categoría.

URL de llamada

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

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
catID	no	Identificador de la categoría a mostrar (si no se indica muestra el listado de catálogos).
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 catalogo ( catID, nombre, descripcion, imagen, img280x240, img500x500, ampliado, proveedor, proveedor_cif, logo_proveedor, ruta, adjuntos, arbol, productos ) >

< !ELEMENT adjuntos ( adjunto* ) >
< !ELEMENT adjunto ( nombre, formato, fichero ) >
< !ELEMENT ampliado ( #PCDATA ) >
< !ELEMENT arbol ( paso*, adjuntos ) >
< !ELEMENT catID ( #PCDATA ) >
< !ELEMENT codiart ( #PCDATA ) >
< !ELEMENT descripcion ( #PCDATA ) >
< !ELEMENT descripción_corta ( #PCDATA ) >
< !ELEMENT ean( #PCDATA ) >
< !ELEMENT eshoja ( #PCDATA ) >
< !ELEMENT estado ( #PCDATA ) >
< !ELEMENT estado_articulo ( estado, estado_fecha, fecha_fin_novedad ) >
< !ELEMENT estado_fecha ( #PCDATA ) >
< !ELEMENT familia ( #PCDATA ) >
< !ELEMENT fecha_fin_novedad ( #PCDATA ) >
< !ELEMENT fichero ( #PCDATA ) >
< !ELEMENT formato ( #PCDATA ) >
< !ELEMENT imagen ( #PCDATA ) >
< !ELEMENT img280x240 ( #PCDATA ) >
< !ELEMENT img500x500 ( #PCDATA ) >
< !ELEMENT logo_proveedor ( #PCDATA ) >
< !ELEMENT marca ( #PCDATA ) >
< !ELEMENT nombre ( #PCDATA ) >
< !ELEMENT paso ( catID, nombre, descripcion, imagen, img280x240, img500x500, ampliado, eshoja?, vinyetas?, proveedor?, proveedor_cif?, logo_proveedor?, adjuntos? ) >
< !ELEMENT pID ( #PCDATA ) >
< !ELEMENT producto ( pID, nombre, descripcion, descripcion_corta, imagen, img280x240, img500x500, ampliado, marca, logo_marca, familia, subfamilia, referencias? ) >
< !ELEMENT productos ( producto* ) >
< !ELEMENT proveedor ( #PCDATA ) >
< !ELEMENT proveedor_cif ( #PCDATA ) >
< !ELEMENT pvp ( #PCDATA ) >
< !ELEMENT pvr ( #PCDATA ) >
< !ELEMENT referencias ( referencia* ) >
< !ELEMENT referencia ( ref, codiart, ean, pvp, pvr, estado_articulo ) >
< !ELEMENT ref ( #PCDATA ) >
< !ELEMENT ruta ( paso* ) >
< !ELEMENT subfamilia ( #PCDATA ) >
< !ELEMENT vinyetas ( #PCDATA ) >

< !ATTLIST referencia id CDATA #REQUIRED >

DTD de campos obsoletos

El siguiente DTD muestra una serie de campos que aparecen en el fichero XML pero que han quedado obsoletos, por lo que no deben ser usados. Se mantienen en el fichero XML por compatibilidad, pero en un futuro desaparecerán.

< !ELEMENT catalogo ( productos ) >

< !ELEMENT agrupadas( referencia* ) >
< !ELEMENT producto ( referencias? ) >
< !ELEMENT productos ( producto* ) >
< !ELEMENT referencias ( referencia* ) >
< !ELEMENT referencia ( agrupadas ) >

< !ATTLIST referencia idagrupador 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 1: llamada a una categoría que contiene subcategorías pero no viñetas
Llamada del ejemplo: https://api.dateriumsystem.com/catalogo_fc_xml.php?userID=_MI_CODIGO_API_&catID=1029789

<?xml version='1.0' encoding='UTF-8'?>
<catalogo>

	* Información de la categoría indicada en la llamada
	<catID>1029789</catID>
	Identificador único de la categoría en Daterium
	<nombre>Herramienta Manual</nombre>
	(CAT_003) Nombre de la categoría
	<descripcion>Selección de herramientas para el campo y el taller</descripcion>
	(CAT_004) Descripción de categoría
	<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales.gif</imagen>
	Imagen / thumbnail de la categoría en resolución 140x120 píxeles
	<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales_rf280x240.jpg</img280x240>
	Imagen / thumbnail de la categoría en resolución 280x240 píxeles
	<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/herramientas-manuales.jpg</img500x500>
	Imagen / thumbnail de la categoría en resolución 500x500 píxeles
	<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales.jpg</ampliado>
	(CAT_005) Imagen de la categoría proporcionada por el proveedor en su resolución original
	<proveedor>FABRICANTE DEMO</proveedor>
	Nombre del proveedor del catálogo al que pertenece la categoría
	<proveedor_cif>Z00000001</proveedor_cif>
	CIF del proveedor del catálogo al que pertenece la categoría
	<logo_proveedor>https://www.dateriumsystem.com/appfiles/clientes/379/logos/cdea5-Logo.jpg</logo_proveedor>
	Logo del proveedor del catálogo al que pertenece la categoría
	<meta_title>Herramienta manual</meta_title>
	(CAT_008) Meta title
	<meta_description>Selección de herramientas para el campo y el taller</meta_description>
	(CAT_009) Meta description
	<meta_keywords>herramienta manual campo taller</meta_keywords>
	(CAT_010) Meta keywords

	<ruta>
	Muestra los distintos nodos padre a los que pertenece la categoría dentro de la estructura propia del proveedor del catálogo,
	mostrandose primero el primer nivel y continuando hasta el nodo padre. Una ruta se compone de pasos:
		<paso>
			<catID>1</catID>
			Este sería el primer nivel, el que corresponde al listado de catálogos
			<nombre>Catálogos</nombre>
			<descripcion></descripcion>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_500x500.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_amp.jpg</ampliado>
		</paso>
		<paso>
			Este sería el segundo nivel, que cuelga del "paso" anterior
			<catID>1029787</catID>
			<nombre>CATÁLOGO DEMO</nombre>
			<descripcion>Catálogo de demostración</descripcion>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/portadademo01.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/portadademo01_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/portadademo01.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/PortadaDemo01.jpg</ampliado>
		</paso>
	</ruta>
	
	<adjuntos>
		Listado de documentos vinculados a la categoría
		<adjunto>
			(CAT_007) Información del documento
			<nombre>Catálogo Bellota 2021</nombre>
			Nombre del documento
			<formato tipo='catalogo'>pdf</formato>
			Formato del documento. Los distintos formatos y sus tipos pueden consultarse en la llamada a la API "Tipos documento"
			<fichero>http://d7rh5s3nxmpy4.cloudfront.net/CMP4506/files/Cat%C3%A1logo_Bellota_2021.pdf</fichero>
			URL del documento
		</adjunto>
	</adjuntos>
	
	<arbol>
	Muestra un listado de las distintas categorías que pertenecen a la categoría pasada como parámetro, es decir, las categorías hijas.
	El árbol se compone de pasos.
		<paso>
		Primera categoría hija
			<catID>1029797</catID>
			<nombre>Agricultura</nombre>
			<descripcion/>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/agricultura-herramientas.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas.jpg</ampliado>
			<eshoja>si</eshoja>
			Indica que esta categoría ya no tiene subcategorías propias, es decir, es un nodo hoja del árbol de navegación
			<vinyetas>5</vinyetas>
			Indica el número de productos que cuelgan de la categoría y sus categorías hijas
			<proveedor>FABRICANTE DEMO</proveedor>
			<proveedor_cif>Z00000001</proveedor_cif>
			<logo_proveedor>https://www.dateriumsystem.com/appfiles/clientes/379/logos/cdea5-Logo.jpg</logo_proveedor>
			<adjuntos/>
		</paso>
		<paso>
		Segunda categoría hija
			<catID>1029798</catID>
			<nombre>Taller</nombre>
			<descripcion/>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/taller-herramientas.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/taller-herramientas_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/taller-herramientas.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/taller-herramientas.jpg</ampliado>
			<eshoja>si</eshoja>
			<vinyetas>2</vinyetas>
			<proveedor>FABRICANTE DEMO</proveedor>
			<proveedor_cif>Z00000001</proveedor_cif>
			<logo_proveedor>https://www.dateriumsystem.com/appfiles/clientes/379/logos/cdea5-Logo.jpg</logo_proveedor>
			<adjuntos/>
		</paso>
	</arbol>
	<productos/>
</catalogo>

Ejemplo 2: llamada a una categoría "hoja" que contiene varias viñetas y con información básica de las referencias
Llamada del ejemplo: https://api.dateriumsystem.com/catalogo_fc_xml.php?userID=_MI_CODIGO_API_&catID=1029797&ref=1

<?xml version='1.0' encoding='UTF-8'?>
<catalogo>

	* Información de la categoría indicada en la llamada
	<catID>1029797</catID>
	Identificador único de la categoría en Daterium
	<nombre>Agricultura</nombre>
	(CAT_003) Nombre de la categoría
	<descripcion/>
	(CAT_004) Descripción de categoría
	<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas.gif</imagen>
	Imagen / thumbnail de la categoría en resolución 140x120 píxeles
	<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas_rf280x240.jpg</img280x240>
	Imagen / thumbnail de la categoría en resolución 280x240 píxeles
	<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/agricultura-herramientas.jpg</img500x500>
	Imagen / thumbnail de la categoría en resolución 500x500 píxeles
	<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/agricultura-herramientas.jpg</ampliado>
	(CAT_005) Imagen de la categoría proporcionada por el proveedor en su resolución original
	<proveedor>FABRICANTE DEMO</proveedor>
	Nombre del proveedor del catálogo al que pertenece la categoría
	<proveedor_cif>Z00000001</proveedor_cif>
	CIF del proveedor del catálogo al que pertenece la categoría
	<logo_proveedor>https://www.dateriumsystem.com/appfiles/clientes/379/logos/cdea5-Logo.jpg</logo_proveedor>
	Logo del proveedor del catálogo al que pertenece la categoría
	
	<ruta>
	Muestra los distintos nodos padre a los que pertenece la categoría dentro de la estructura propia del proveedor del catálogo,
	mostrandose primero el primer nivel y continuando hasta el nodo padre. Una ruta se compone de pasos:
		<paso>
			Este sería el primer nivel, el que corresponde al listado de catálogos
			<catID>1</catID>
			<nombre>Catálogos</nombre>
			<descripcion/>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_500x500.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/general_nodisponible_amp.jpg</ampliado>
		</paso>
		<paso>
			Este sería el segundo nivel, que cuelga del "paso" anterior
			<catID>1029787</catID>
			<nombre>CATÁLOGO DEMO</nombre>
			<descripcion/>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/portadademo01.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/portadademo01_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/portadademo01.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/PortadaDemo01.jpg</ampliado>
		</paso>
		<paso>
			Este sería el tercer nivel, que cuelga del "paso" anterior
			<catID>1029789</catID>
			<nombre>Herramienta Manual</nombre>
			<descripcion>Selección de herramientas para el campo y el taller</descripcion>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/herramientas-manuales.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/herramientas-manuales.jpg</ampliado>
		</paso>
	</ruta>
	
	<adjuntos/>
	
	<arbol/>
	No tiene subcategorías
	
	<productos>
		Muestra el listado de productos que cuelgan de esta categoría
		
		<producto>
			Primer producto
			<pID>1153410</pID>
			Identificador único del producto en Daterium
			<nombre>Palote Forjado de uso intensivo y en terrenos pedregosos / 5604A</nombre>
			(VIN_004) Nombre del producto
			<descripcion>&lt;strong&gt;Palote Forjado&lt;/strong&gt; en una sola pieza para una gran durabilidad está tratado y templado. Apto para uso intensivo y en terrenos pedregosos. Es una herramienta irrompible. Mango muleta de madera de haya certificada PEFC.&lt;/strong&gt;</descripcion>
			(VIN_005) Descripción del producto
			<descripcion_corta>Palote Forjado de uso intensivo con mango Anilla de madera certificada PEFC</descripcion_corta>
			(VIN_006) Descripción corta del producto
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr4636bi82_eaa_5604a_palote_forjado_de_uso_intensivo_y_en_terrenos_pedregosos_5604_sz1.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr4636bi82_eaa_5604a_palote_forjado_de_uso_intensivo_y_en_terrenos_pedregosos_5604_sz1_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/pr4636bi82_eaa_5604a_palote_forjado_de_uso_intensivo_y_en_terrenos_pedregosos_5604_sz1.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/PR4636BI82_EAA_5604A_Palote_Forjado_de_uso_intensivo_y_en_terrenos_pedregosos_5604_SZ1.jpg</ampliado>
			<marca>Bellota</marca>
			(VIN_002) Marca del producto
			<logo_marca>https://www.dateriumsystem.com/appfiles/clientes/379/logos/4bf26-Bellota_logo.jpg</logo_marca>
			Logotipo de la marca del producto
			<familia>Herramientas Agricultura</familia>
			(VIN_012) Familia a la que pertenece el producto
			<subfamilia>Palas</subfamilia>
			(VIN_013) Subfamilia a la que pertenece el producto
			<referencias>
				Muestra el listado de referencias del producto (sólo si se ha indicado la opción en el parámetro de llamada)
				<referencia id='2312393'>
					Información de la referencia. Tiene como atributo el identificador único de la referencia en Daterium.
					<ref>5604-24 MA</ref>
					(ART_002) Código de referencia
					<codiart>560424MA</codiart>
					(ART_003) Código ERP
					<ean>8414299125306</ean>
					(ART_004) Código EAN
					<pvp>55.0000</pvp>
					(ART_035) Precio de tarifa
					<pvr>59.6200</pvr>
					(ART_036) Precio recomendado
					<estado_articulo>
						<estado>activo</estado>
						(ART_061) Estado del artículo (activo / obsoleto)
						<estado_fecha>26/09/2019</estado_fecha>
						(ART_062) Fecha en la que se establece el estado
						<fecha_fin_novedad>31/07/2022</fecha_fin_novedad>
						(ART_063) Fecha de fin de novedad (el producto es novedad hasta esta fecha)
					</estado_articulo>
					<agrupadas/>
					Etiqueta obsoleta. Ignorar
				</referencia>
				<referencia id='2312394'>
					Información de la referencia. Tiene como atributo el identificador único de la referencia en Daterium.
					<ref>5604-26 MA</ref>
					(ART_002) Código de referencia
					<codiart>560426MA</codiart>
					(ART_003) Código ERP
					<ean>8414299125702</ean>
					(ART_004) Código EAN
					<pvp>56.8000</pvp>
					(ART_035) Precio de tarifa
					<pvr>61.5900</pvr>
					(ART_036) Precio recomendado
					<estado_articulo>
						<estado>activo</estado>
						(ART_061) Estado del artículo (activo / obsoleto)
						<estado_fecha>26/09/2019</estado_fecha>
						(ART_062) Fecha en la que se establece el estado
						<fecha_fin_novedad>01/01/1970</fecha_fin_novedad>
						(ART_063) Fecha de fin de novedad (el producto es novedad hasta esta fecha)
					</estado_articulo>
					<agrupadas/>
				</referencia>
			</referencias>
		</producto>
		
		<producto>
			Segundo producto
			<pID>1153411</pID>
			<nombre>Horca forjada 4 púas con mango para remover la tierra / 9114L</nombre>
			<descripcion>Horca de jardín, con cuatro dientes forjados y planos con mango largo para remover y cavar la tierra, desenterrar cultivos, airear y soltar el terreno muy compacto. Los dientes están afilados y templados en toda su longitud. Su pintura es muy resistente a la oxidación. La cabeza se une perfectamente con el mango mediante una virola metálica y se adapte de forma muy cómoda a la mano del usuario.</descripcion>
			<descripcion_corta>Horca de jardín, con cuatro dientes forjados y planos con mango largo para remover y cavar la tierra, desenterrar cultivos, airear y soltar el terreno muy compacto. La cabeza se une perfectamente con </descripcion_corta>
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr4671bi117_eaa_9114l_horca_forjada_4_puas_con_mango_para_remover_la_tierra_9114l_sz1.gif</imagen>
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr4671bi117_eaa_9114l_horca_forjada_4_puas_con_mango_para_remover_la_tierra_9114l_sz1_rf280x240.jpg</img280x240>
			<img500x500>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/500x500/pr4671bi117_eaa_9114l_horca_forjada_4_puas_con_mango_para_remover_la_tierra_9114l_sz1.jpg</img500x500>
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/PR4671BI117_EAA_9114L_Horca_forjada_4_puas_con_mango_para_remover_la_tierra_9114L_SZ1.jpg</ampliado>
			<marca>Bellota</marca>
			<logo_marca>https://www.dateriumsystem.com/appfiles/clientes/379/logos/4bf26-Bellota_logo.jpg</logo_marca>
			<familia/>
			<subfamilia/>
			<referencias>
				Muestra el listado de referencias del producto (sólo si se ha indicado la opción en el parámetro de llamada)
				<referencia id='2312395'>
					<ref>911-4 ML</ref>
					<codiart>9114L</codiart>
					<ean>8414299375428</ean>
					<pvp>33.0000</pvp>
					<pvr>38.1600</pvr>
					<estado_articulo>
						<estado>activo</estado>
						<estado_fecha>26/09/2019</estado_fecha>
						<fecha_fin_novedad>01/01/1970</fecha_fin_novedad>
					</estado_articulo>
					<agrupadas/>
				</referencia>
			</referencias>
		</producto>
		

	</productos>
</catalogo>