Daterium System

AECOC

Descripción general

Devuelve el listado de AECOC para construir el árbol de navegación por la clasificación normalizada de AECOC.

Usos:

Obtener las categorías AECOC de un nivel.
Obtener los productos de una categoría AECOC.

URL de llamada

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

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
aecocID	no	Identificador de la categoría a mostrar (si no se indica muestra la categoría inicial, '08 Sector de Ferretería y Bricolaje').
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 catalogoAECOC ( aecocID, nombre, imagen, color, picto, nodohoja, ruta, arbol, productos ) >

< !ELEMENT aecocID ( #PCDATA ) >
< !ELEMENT agrupadas( referencia* ) >
< !ELEMENT ampliado ( #PCDATA ) >
< !ELEMENT arbol ( paso* ) >
< !ELEMENT codiart ( #PCDATA ) >
< !ELEMENT color ( #PCDATA ) >
< !ELEMENT descripcion ( #PCDATA ) >
< !ELEMENT descripción_corta ( #PCDATA ) >
< !ELEMENT ean ( #PCDATA ) >
< !ELEMENT imagen ( #PCDATA ) >
< !ELEMENT familia ( #PCDATA ) >
< !ELEMENT imagen ( #PCDATA ) >
< !ELEMENT img280x240 ( #PCDATA ) >
< !ELEMENT marca ( #PCDATA ) >
< !ELEMENT nombre ( #PCDATA ) >
< !ELEMENT paso ( aecocID, nombre, imagen, color, picto, nodohoja*, tieneresultados*, total* ) >
< !ELEMENT picto ( #PCDATA ) >
< !ELEMENT pID ( #PCDATA ) >
< !ELEMENT producto ( pID, nombre, descripcion, descripcion_corta, imagen, img280x240, ampliado, marca, logo_marca, familia, subfamilia, referencias* ) >
< !ELEMENT productos ( producto* ) >
< !ELEMENT pvp ( #PCDATA ) >
< !ELEMENT pvr ( #PCDATA ) >
< !ELEMENT referencias ( referencia* ) >
< !ELEMENT referencia (ref, codiart, pvp, pvr, ean, agrupadas ) >
< !ELEMENT ref ( #PCDATA ) >
< !ELEMENT ruta ( paso* ) >
< !ELEMENT subfamilia ( #PCDATA ) >

< !ATTLIST referencia id CDATA #REQUIRED >
< !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: primer nivel de la clasificación AECOC
Llamada del ejemplo: https://api.dateriumsystem.com/aecoc_fc_xml.php?userID=_MI_CODIGO_API_

<?xml version='1.0' encoding='UTF-8'?>
<catalogoAECOC>
	<aecocID>08</aecocID>
	Identificador de la categoría AECOC solicitada.
	<nombre>SECTOR FERRETERÍA Y BRICOLAJE</nombre>
	Nombre de la categoría AECOC.
	<imagen>https://www.dateriumsystem.com/aecoc/img/general_nodisponible.gif</imagen>
	Campo obsoleto.
	<color>#FFFFFF</color>
	Campo obsoleto.
	<picto/>
	Campo obsoleto.
	<nodohoja>no</nodohoja>
	Indica si es un nodo hoja (no tiene subcategorías).
	<ruta/>
	Muestra los distintos nodos padre a los que pertenece la categoría, ordenadode más genérico a más específico. Una ruta se compone de pasos.
	<arbol>
		Muestra un listado de las distintas subcategorías que pertenecen a la categoría pasada como parámetro (categorías hijas). El árbol de compone de pasos.
		<paso>
			Un paso indica una categoría.
			<aecocID>0801</aecocID>
			Identificador de la categoría.
			<nombre>CONSTRUCCIÓN</nombre>
			Nombre de la categoría.
			<imagen>https://www.dateriumsystem.com/aecoc/img/0801.gif</imagen>
			Campo obsoleto.
			<color>#FCC687</color>
			Campo obsoleto.
			<picto>https://www.dateriumsystem.com/aecoc/picto/0801.png</picto>
			Campo obsoleto.
			<nodohoja>no</nodohoja>
			Indica si es un nodo hoja (no tiene subcategorías).
			<tieneresultados>si</tieneresultados>
			Indica si esta categoría paso tiene productos en este nodo o en cualquier de sus hijos.
			<total>685</total>
			Número total de productos contenido en este paso o en cualquiera de sus hijos.
		</paso>
		<paso>
			<aecocID>0802</aecocID>
			<nombre>MADERA</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0802.gif</imagen>
			<color>#F8A355</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0802.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>51</total>
		</paso>
		<paso>
			<aecocID>0803</aecocID>
			<nombre>ELECTRICIDAD</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0803.gif</imagen>
			<color>#F79455</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0803.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>347</total>
		</paso>
		<paso>
			<aecocID>0804</aecocID>
			<nombre>HERRAMIENTAS</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0804.gif</imagen>
			<color>#F68367</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0804.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>19752</total>
		</paso>
		<paso>
			<aecocID>0805</aecocID>
			<nombre>BAÑO Y FONTANERÍA</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0805.gif</imagen>
			<color>#E77578</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0805.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>190</total>
		</paso>
		<paso>
			<aecocID>0806</aecocID>
			<nombre>COCINA</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0806.gif</imagen>
			<color>#D58390</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0806.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>312</total>
		</paso>
		<paso>
			<aecocID>0807</aecocID>
			<nombre>JARDÍN</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0807.gif</imagen>
			<color>#BF828F</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0807.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>1205</total>
		</paso>
		<paso>
			<aecocID>0808</aecocID>
			<nombre>FERRETERÍA</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0808.gif</imagen>
			<color>#B18590</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0808.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>7227</total>
		</paso>
		<paso>
			<aecocID>0809</aecocID>
			<nombre>PINTURA</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0809.gif</imagen>
			<color>#9E787A</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0809.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>1531</total>
		</paso>
		<paso>
			<aecocID>0810</aecocID>
			<nombre>DECORACIÓN</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0810.gif</imagen>
			<color>#978E97</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0810.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>310</total>
		</paso>
		<paso>
			<aecocID>0811</aecocID>
			<nombre>MOBILIARIO Y ORDENACIÓN</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0811.gif</imagen>
			<color>#949B9F</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0811.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>462</total>
		</paso>
		<paso>
			<aecocID>0812</aecocID>
			<nombre>CLIMATIZACIÓN</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0812.gif</imagen>
			<color>#83B1A2</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0812.png</picto>
			<nodohoja>no</nodohoja>
			<tieneresultados>si</tieneresultados>
			<total>123</total>
		</paso>
	</arbol>
	<productos/>
</catalogoAECOC>

Ejemplo 2: información de la categoría AECOC '08040514' (categoría hoja)
Llamada del ejemplo: https://api.dateriumsystem.com/aecoc_fc_xml.php?userID=_MI_CODIGO_API_&aecocID=08040514

<?xml version='1.0' encoding='UTF-8'?>
<catalogoAECOC>
	<aecocID>08040514</aecocID>
	Identificador de la categoría AECOC solicitada.
	<nombre>MANGOS</nombre>
	Nombre de la categoría AECOC.
	<imagen>https://www.dateriumsystem.com/aecoc/img/08040514.gif</imagen>
	Campo obsoleto.
	<color>#FBCDC2</color>
	Campo obsoleto.
	<picto/>
	Campo obsoleto.
	<nodohoja>si</nodohoja>
	Indica si es un nodo hoja (no tiene subcategorías). En este caso, al ser no, indica que esta categoría son tiene subcategorías.
	<ruta>
		Muestra los distintos nodos padre a los que pertenece la categoría, ordenadode más genérico a más específico. Una ruta se compone de pasos.
		<paso>
			Un paso indica una categoría.
			<aecocID>08</aecocID>
			Identificador de la categoría.
			<nombre>SECTOR FERRETERÍA Y BRICOLAJE</nombre>
			Nombre de la categoría.
			<imagen>https://www.dateriumsystem.com/aecoc/img/general_nodisponible.gif</imagen>
			Campo obsoleto.
			<color>#FFFFFF</color>
			Campo obsoleto.
			<picto/>
			Campo obsoleto.
		</paso>
		<paso>
			<aecocID>0804</aecocID>
			<nombre>HERRAMIENTAS</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/0804.gif</imagen>
			<color>#F68367</color>
			<picto>https://www.dateriumsystem.com/aecoc/picto/0804.png</picto>
		</paso>
		<paso>
			<aecocID>080405</aecocID>
			<nombre>HERRAMIENTA MANUAL</nombre>
			<imagen>https://www.dateriumsystem.com/aecoc/img/080405.gif</imagen>
			<color>#F68367</color>
			<picto/>
		</paso>
	</ruta>
	<arbol/>
	Muestra un listado de las distintas subcategorías que pertenecen a la categoría pasada como parámetro (categorías hijas). Al ser un nodo hoja no tiene subcategorías.
	<productos>
		Listado de productos asignados a la categoría AECOC.
		<producto>
			<pID>1153430</pID>
			Identificador único de la viñeta en Daterium.
			<nombre origen='p'>Mango largo  para horca de 1200 mm / M901LR120SB</nombre>
			(VIN_004) Nombre de la viñeta. El atributo "origen" debe ser ignorado.
			<descripcion>Mango de madera de primera calidad para horca, ligero y agradable al tacto. Su diseño ergonómico se adapta a la geometría de la herramienta.</descripcion>
			(VIN_005) Descripción de la viñeta.
			<descripcion_corta>Mango de madera de primera calidad para horca, ligero y agradable al tacto.</descripcion_corta>
			(VIN_006) Descripción corta de la viñeta.
			<imagen>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr5380bi826_eaa_m901lr120sb_mango_largo_para_horca_de_1200_mm_m901lr120sb_sz1.gif</imagen>
			Primera imagen de la viñeta en baja resolución (140x120px, formato gif).
			<img280x240>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/pr5380bi826_eaa_m901lr120sb_mango_largo_para_horca_de_1200_mm_m901lr120sb_sz1_rf280x240.jpg</img280x240>
			Primera imagen de la viñeta en baja resolución (280x240px, formato jpg).
			<ampliado>https://www.dateriumsystem.com/appfiles/clientes/379/catalogo/PR5380BI826_EAA_M901LR120SB_Mango_largo_para_horca_de_1200_mm_M901LR120SB_SZ1.jpg</ampliado>
			Primera imagen de la viñeta en resolución original (formato jpg).
			<marca>Bellota</marca>
			(VIN_002) Marca de la viñeta.
			<logo_marca>https://www.dateriumsystem.com/appfiles/clientes/379/logos/4bf26-Bellota_logo.jpg</logo_marca>
			Logotipo de la marca (su resolución máxima de 69x43 píxeles).
			<familia/>
			(VIN_012) Familia de la viñeta.
			<subfamilia/>
			(VIN_013) Subfamilia de la viñeta.
			<proveedor>FABRICANTE DEMO</proveedor>
			Nombre del proveedor del catálogo al que pertenece la viñeta.
			<proveedor_cif>Z00000001</proveedor_cif>
			CIF del proveedor del catálogo al que pertenece la viñeta
			<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 viñeta.
		</producto>
	</productos>
</catalogoAECOC>